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 o controle de tempo de execução do item de relatório personalizado não é suportado.
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.

Conteúdo relacionado

Linguagem RDL (SSRS)
Criando um componente de tempo de execução de item de relatório personalizado
Criando um componente de tempo de design de item de relatório personalizado