Bibliotecas de classes de item de relatório personalizadas
Os itens de relatório personalizados usam classes do namespace Microsoft.ReportDesigner. As classes usadas para implementar um item de relatório personalizado podem ser agrupadas em duas categorias principais: classes exclusivas destinadas a dar suporte à infraestrutura do item de relatório personalizado, e classes de wrapper gerenciado que encapsula a funcionalidade de elementos relevantes em linguagem RDL. Para obter um exemplo de código sobre como usar essas classes, consulte Amostras de produto do SQL Server Reporting Services.
Classes de infraestrutura de item de relatório personalizadas
As classes a seguir são usadas para implementar um item de relatório personalizado.
Observação
As tabelas a seguir não são listagens completas; elas incluem apenas as propriedades e os métodos mais usados para cada classe.
Microsoft.ReportDesigner.CustomReportItemDesigner
Microsoft.ReportDesigner.CustomReportItemDesigner é a principal classe de item de relatório personalizado. A classe principal de sua implementação de item de relatório personalizado deve ser herdada dessa classe.
Propriedades públicas
| Propriedade | Descrição |
|---|---|
| Nome | O nome do item de relatório personalizado. |
| Tipo | O tipo do item de relatório personalizado. |
| CustomData | Um objeto CustomData que encapsula as propriedades de dados do item de relatório personalizado especificadas no momento da criação. |
| CustomProperties | Uma coleção de propriedades personalizadas do item de relatório personalizado. |
| Altura | A altura do controle do item de relatório personalizado. |
| Largura | A largura do controle do item de relatório personalizado. |
| Report | Um contêiner das propriedades em nível de relatório, como a lista de conjuntos de dados do relatório. |
| AltReportItem | O objeto de item de relatório alternativo, a ser usado onde não há suporte para o controle de tempo de execução do item de relatório personalizado. |
| Estilo | As propriedades de estilo do item de relatório personalizado. |
| Adornment | Uma janela de adorno usada para a edição interativa do controle. |
| Site | O ISite do componente. |
| DesignerVerbCollection | Uma matriz de verbos personalizados do menu de atalho do controle. |
Métodos públicos
| Método | Descrição |
|---|---|
| BeginEdit | Ativa a edição interativa do controle. |
| DoDefaultAction | Chamado em resposta ao clique duplo ou pressionamento de Retornar no controle. |
| EndEdit | Desativa a edição interativa do controle. |
| GetService | Retorna um objeto, que representa um serviço. |
| InitializeNewComponent | Chamado quando um novo item de relatório personalizado é criado. |
| Invalidate | Redesenha a superfície inteira do controle. |
| OnDragEnter OnDragDrop |
Chamado quando um objeto é arrastado para o controle. |
| OnPaint | Chamado em resposta ao evento Paint. |
Microsoft.ReportDesigner.CustomReportItemAttribute
Microsoft.ReportDesigner.CustomReportItemAttribute é o atributo usado para identificar o tipo do item de relatório personalizado. O nome deve corresponder ao valor do atributo <Name> do elemento ReportItem no arquivo de configuração do Designer de Relatórios.
Métodos públicos
| Método | Descrição |
|---|---|
| CustomReportItemAttribute | Constrói o objeto CustomReportItemAttribute. |
Microsoft.ReportDesigner.LocalizedNameAttribute
Microsoft.ReportDesigner.LocalizedNameAttribute é o atributo usado para especificar o nome de exibição a ser usado para o designer de item de relatório personalizado.
Métodos públicos
| Método | Descrição |
|---|---|
| LocalizedNameAttribute | Constrói o objeto LocalizedNameAttribute. |
Microsoft.ReportDesigner.Adornment
A classe Adornment é usada pelo componente de item de relatório personalizado em tempo de design para fornecer áreas fora do retângulo principal da área de design. Essas áreas podem tratar eventos de interface do usuário, tais como cliques de mouse e operações de arrastar e soltar.
Métodos públicos
| Método | Descrição |
|---|---|
| OnShow | Chamado quando o Adornment é ativado. |
| OnHide | Chamado quando o Adornment é desativado. |
| Paint | Chamado em resposta ao evento Paint. |
| OnDragEnter OnDragOver OnDragLeave OnDragDrop |
Chamado quando um objeto é arrastado para o Adornment. |
Microsoft.ReportDesigner.AdornerService
Essa classe é usada para fornecer uma coleção de serviços de exibição usados pelo item de relatório personalizado para dar suporte a objetos Adornment para o componente de item de relatório personalizado em tempo de design.
Propriedades públicas
| Propriedade | Descrição |
|---|---|
| AdornerWindowBounds | Os limites da janela Adorno. |
| AdornerWindowRegion | A região da janela Adorno. |
| AdornerWindowGraphics | Um contexto gráfico da janela Adorno. |
Métodos públicos
| Método | Descrição |
|---|---|
| ComponentRectInDesignerFrame | Retorna os limites do componente convertidos em coordenadas de quadro de designer. |
| InvalidateAdorner | Invalida a janela Adorno. |
| PointToAdorner | Retorna um ponto em coordenadas de tela convertidas em coordenadas da janela Adorno. |
Microsoft.ReportDesigner.ExpressionEditor
Esta classe pode ser usada de seu controle de item de relatório personalizado em tempo de design para invocar o Editor de Expressão.
Métodos públicos
| Método | Descrição |
|---|---|
| EditValue | Invoca o Editor de Expressão, inicializado com o valor de objeto determinado. |
Microsoft.ReportDesigner.IFieldsDataObject
Esta classe é uma coleção de campos do Reporting Services, usada para dar suporte a eventos de arrastar e soltar no ambiente de design. Herda de IReportItemDataObject.
Propriedades públicas
| Propriedade | Descrição |
|---|---|
| DataSetName | O nome do conjunto de dados que contém os campos a serem soltos. |
| Fields | A coleção de campos (Microsoft.ReportDesigner.Field) a ser removida. |