创建自定义报表项设计时组件

可以使用 CustomData 类传递自定义报表项的用户指定属性。实现 CustomReportItemDesigner 类时应重写 InitializeNewComponent 方法以创建相应组件的 CustomData 类的新实例，并将其设置为默认值。

下面的代码示例显示的是自定义报表项设计时组件类重写 CustomReportItemDesigner.InitializeNewComponent 方法以初始化该组件的 CustomData 类的示例：

public override void InitializeNewComponent()
        {
            CustomData = new CustomData();
            CustomData.DataRowHierarchy = new DataHierarchy();

            // Shape grouping
            CustomData.DataRowHierarchy.DataMembers.Add(new DataMember());
            CustomData.DataRowHierarchy.DataMembers[0].Group = new Group();
            CustomData.DataRowHierarchy.DataMembers[0].Group.Name = Name + "_Shape";
            CustomData.DataRowHierarchy.DataMembers[0].Group.GroupExpressions.Add(new ReportExpression());

            // Point grouping
            CustomData.DataRowHierarchy.DataMembers[0].DataMembers.Add(new DataMember());
            CustomData.DataRowHierarchy.DataMembers[0].DataMembers[0].Group = new Group();
            CustomData.DataRowHierarchy.DataMembers[0].DataMembers[0].Group.Name = Name + "_Point";
            CustomData.DataRowHierarchy.DataMembers[0].DataMembers[0].Group.GroupExpressions.Add(new ReportExpression());

            // Static column
            CustomData.DataColumnHierarchy = new DataHierarchy();
            CustomData.DataColumnHierarchy.DataMembers.Add(new DataMember());

            // Points
            IList<IList<DataValue>> dataValues = new List<IList<DataValue>>();
            CustomData.DataRows.Add(dataValues);
            CustomData.DataRows[0].Add(new List<DataValue>());
            CustomData.DataRows[0][0].Add(NewDataValue("X", ""));
            CustomData.DataRows[0][0].Add(NewDataValue("Y", ""));
        }

可以通过多种方式在设计环境下修改 CustomData 属性。可以使用 Visual Studio 属性浏览器修改任何由设计时组件公开且以 BrowsableAttribute 属性标记的特性。另外，还可通过以下方式修改属性：将相应项拖动到自定义报表项的设计图面，或者在设计环境下右键单击该控件，然后在快捷菜单上选择**“属性”**以显示自定义属性窗口。

以下代码示例显示的是已应用 BrowsableAttribute 属性的 Microsoft.ReportDesigner.CustomReportItemDesigner.CustomData 特性：

[Browsable(true), Category("Data")]
public string DataSetName
{
      get
      {
         return CustomData.DataSetName;
      }
      set
      {
         CustomData.DataSetName = value;
      }
   }

可以为您的设计时组件提供自定义属性编辑器对话框。自定义属性编辑器实现应继承自 ComponentEditor 类，并应创建可用于属性编辑的对话框实例。

下面的示例显示了继承自 ComponentEditor 的类的实现，并显示了自定义属性编辑对话框：

internal sealed class CustomEditor : ComponentEditor
{
   public override bool EditComponent(
      ITypeDescriptorContext context, object component)
    {
     PolygonsDesigner designer = (PolygonsDesigner)component;
     PolygonProperties dialog = new PolygonProperties();
     dialog.m_designerComponent = designer;
     DialogResult result = dialog.ShowDialog();
     if (result == DialogResult.OK)
     {
        designer.Invalidate();
        designer.ChangeService().OnComponentChanged(designer, null, null, null);
        return true;
     }
     else
        return false;
    }
}

自定义属性编辑器对话框可以调用报表设计器表达式编辑器。在下面的示例中，在用户选择相应组合框中的第一个元素时，会调用表达式编辑器：

private void EditableCombo_SelectedIndexChanged(object sender, 
    EventArgs e)
{
   ComboBox combo = (ComboBox)sender;
   if (combo.SelectedIndex == 0 && m_launchEditor)
   {
      m_launchEditor = false;
      ExpressionEditor editor = new ExpressionEditor();
      string newValue;
      newValue = (string)editor.EditValue(null, m_designerComponent.Site, m_oldComboValue);
      combo.Items[0] = newValue;
   }
}

设计器谓词是与事件处理程序链接的菜单命令。在设计环境下使用自定义报表项运行时控件时，可以添加将显示在相应组件的快捷菜单中的设计器谓词。可以使用 Verbs 属性从运行时组件返回可用设计器谓词的列表。

下面的代码示例显示的是将添加到 DesignerVerbCollection 的设计器谓词和事件处理程序，以及事件处理程序代码：

public override DesignerVerbCollection Verbs
{
    get
    {
        if (m_verbs == null)
        {
            m_verbs = new DesignerVerbCollection();
            m_verbs.Add(new DesignerVerb("Proportional Scaling", new EventHandler(OnProportionalScaling)));
         m_verbs[0].Checked = (GetCustomProperty("poly:Proportional") == bool.TrueString);
        }

        return m_verbs;
    }
}

private void OnProportionalScaling(object sender, EventArgs e)
{
   bool proportional = !
        (GetCustomProperty("poly:Proportional") == bool.TrueString);
   m_verbs[0].Checked = proportional;
   SetCustomProperty("poly:Proportional", proportional.ToString());
   ChangeService().OnComponentChanged(this, null, null, null);
   Invalidate();
}

自定义报表项类还可实现 Microsoft.ReportDesigner.Design.Adornment 类。使用修饰后，自定义报表项控件可提供设计图面主矩形之外的区域。这些区域可用来处理用户界面事件，如鼠标单击和拖放操作。Reporting ServicesMicrosoft.ReportDesigner 命名空间中定义的 Adornment 类是通过传递 Windows 窗体中的 Adorner 类实现的。有关 Adorner 类的完整文档，请参阅 MSDN Library 中的行为服务概述。有关实现 Microsoft.ReportDesigner.Design.Adornment 类的示例代码，请参阅 SQL Server Reporting Services Product Samples（SQL Server Reporting Services 产品示例）。

有关在 Visual Studio 中如何对 Windows 窗体进行编程和使用 Windows 窗体的详细信息，请参见 MSDN Library 中的以下主题：

• Design-Time Attributes for Components（组件的设计时属性）

• Components in Visual Studio（Visual Studio 中的组件）

• Walkthrough: Creating a Windows Forms Control that Takes Advantage of Visual Studio Design-Time Features（演练：创建一个利用 Visual Studio 设计时功能的 Windows 窗体控件）