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 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 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.

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.

Consulte também

Conceitos

Linguagem RDL (SSRS)

Criando um componente de item de relatório personalizado em tempo de execução

Criando um componente de tempo de design de item de relatório personalizado