Bibliotecas de classes de itens de relatório personalizados
Os itens de relatórios 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 oferecer 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 SQL Server Reporting Services Product Samples (em inglês).
Classes de infraestrutura de itens de relatórios personalizados
As classes a seguir são usadas para implementar um item de relatório personalizado.
.gif "Observação") 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
Esta é 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
Name |
O nome do item de relatório personalizado. |
Type |
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. |
Height |
A altura do controle do item de relatório personalizado. |
Width |
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 o controle de item de relatório personalizado em tempo de execução não tem suporte. |
Style |
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
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
Este é 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
CustomReportItemAttribute |
Constrói o objeto CustomReportItemAttribute. |
Microsoft.ReportDesigner.LocalizedNameAttribute
Este é o atributo usado para especificar o nome para exibição a ser usado para o designer de item de relatório personalizado.
Métodos públicos
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 superfície 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
OnShow |
Chamado quando Adornment está ativado. |
OnHide |
Chamado quando Adornment está desativado. |
Paint |
Chamado em resposta ao evento Paint. |
OnDragEnter OnDragOver OnDragLeave OnDragDrop |
Chamado quando um objeto é arrastado para o Adornment. |
Microsoft.ReportDesigner.AdornerService
Esta 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
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
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
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. Herdada de IReportItemDataObject.
Propriedades públicas
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 serem soltos. |