Condividi tramite

Librerie di classi degli elementi del report personalizzate

  • Articolo

Gli elementi del report personalizzati usano le classi dello spazio dei nomi Microsoft.ReportDesigner. Le classi utilizzate per implementare un elemento del report personalizzato possono essere suddivise in due categorie principali: le classi univoche progettate per supportare l'infrastruttura dell'elemento del report personalizzato e le classi wrapper gestite che incapsulano la funzionalità degli elementi RDL (Report Definition Language) rilevanti. Per un esempio di codice sull'uso di queste classi, vedere SQL Server Reporting Services Product Samples (Esempi del prodotto SQL Server Reporting Services).

Classi di infrastruttura dell'elemento del report personalizzato

Le classi riportate di seguito vengono utilizzate per implementare un elemento del report personalizzato.

Nota

Nelle tabelle seguenti non vengono forniti elenchi completi, ma solo le proprietà e i metodi utilizzati più di frequente per ciascuna classe.

Microsoft.ReportDesigner.CustomReportItemDesigner

Microsoft.ReportDesigner.CustomReportItemDesigner è la classe principale dell'elemento del report personalizzato. La classe principale dell'implementazione dell'elemento del report personalizzato deve ereditare da questa classe.

Proprietà pubbliche

Proprietà Descrizione
Nome Nome dell'elemento del report personalizzato.
Type Tipo di elemento del report personalizzato.
CustomData Oggetto CustomData che incapsula le proprietà dei dati dell'elemento del report personalizzato specificate in fase di progettazione.
CustomProperties Raccolta di proprietà personalizzate per l'elemento del report personalizzato.
Altezza Altezza del controllo dell'elemento del report personalizzato.
Larghezza Larghezza del controllo dell'elemento del report personalizzato.
- Report Contenitore per le proprietà a livello di report, ad esempio l'elenco dei set di dati nel report.
AltReportItem Oggetto elemento del report alternativo da usare in cui il controllo runtime dell'elemento del report personalizzato non è supportato.
Style Proprietà di stile per l'elemento del report personalizzato.
Adornment Finestra dell'area di controllo utilizzata per la modifica interattiva del controllo.
Sito Interfaccia ISite del componente.
DesignerVerbCollection Matrice di verbi personalizzati per il menu di scelta rapida del controllo.

Metodi pubblici

metodo Descrizione
BeginEdit Attiva la modifica interattiva per il controllo.
DoDefaultAction Viene chiamato quando si fa doppio clic o si preme Invio sul controllo.
EndEdit Disattiva la modifica interattiva per il controllo.
GetService Restituisce un oggetto che rappresenta un servizio.
InitializeNewComponent Viene chiamato quando si crea un nuovo elemento del report personalizzato.
Invalidate Ridisegna l'intera superficie del controllo.
OnDragEnter

OnDragDrop		 Viene chiamato quando si trascina un oggetto sul controllo.
OnPaint Viene chiamato in risposta all'evento Paint.

Microsoft.ReportDesigner.CustomReportItemAttribute

Microsoft.ReportDesigner.CustomReportItemAttribute è l'attributo usato per identificare il tipo dell'elemento del report personalizzato. Il nome deve corrispondere al valore dell'attributo <Name> dell'elemento ReportItem nel file di configurazione di Progettazione report.

Metodi pubblici

metodo Descrizione
CustomReportItemAttribute Crea l'oggetto CustomReportItemAttribute.

Microsoft.ReportDesigner.LocalizedNameAttribute

Microsoft.ReportDesigner.LocalizedNameAttribute è l'attributo utilizzato per specificare il nome visualizzato da utilizzare per la finestra di progettazione dell'elemento del report personalizzato.

Metodi pubblici

metodo Descrizione
LocalizedNameAttribute Crea l'oggetto LocalizedNameAttribute.

Microsoft.ReportDesigner.Adornment

La classe Adornment viene usata dal componente della fase di progettazione dell'elemento del report personalizzato per offrire aree esterne al rettangolo principale dell'area di progettazione. Tali aree possono gestire eventi dell'interfaccia utente, quali clic del mouse e operazioni di trascinamento della selezione.

Metodi pubblici

metodo Descrizione
OnShow Viene chiamato quando Adornment è attivato.
OnHide Viene chiamato quando Adornment è disattivato.
Paint Viene chiamato in risposta all'evento Paint.
OnDragEnter

OnDragOver

OnDragLeave

OnDragDrop		 Viene chiamato quando un oggetto viene trascinato in Adornment.

Microsoft.ReportDesigner.AdornerService

Questa classe viene usata per fornire una raccolta di servizi di visualizzazione usata dall'elemento del report personalizzato per supportare gli oggetti Adornment per il componente della fase di progettazione dell'elemento del report personalizzato.

Proprietà pubbliche

Proprietà Descrizione
AdornerWindowBounds Limiti della finestra Adorner.
AdornerWindowRegion Area della finestra Adorner.
AdornerWindowGraphics Contesto grafico per la finestra Adorner.

Metodi pubblici

metodo Descrizione
ComponentRectInDesignerFrame Restituisce i limiti del componente convertito nelle coordinate della cornice della finestra di progettazione.
InvalidateAdorner Invalida la finestra Adorner.
PointToAdorner Restituisce un punto nelle coordinate dello schermo convertito nelle coordinate della finestra Adorner.

Microsoft.ReportDesigner.ExpressionEditor

Questa classe può essere utilizzata da un controllo della fase di progettazione dell'elemento del report personalizzato per richiamare l'Editor espressioni.

Metodi pubblici

metodo Descrizione
EditValue Richiama l'Editor espressioni, inizializzato con il valore dell'oggetto specificato.

Microsoft.ReportDesigner.IFieldsDataObject

Questa classe è una raccolta di campi di Reporting Services e viene usata per supportare eventi di trascinamento della selezione nell'ambiente di progettazione. Eredita da IReportItemDataObject.

Proprietà pubbliche

Proprietà Descrizione
DataSetName Nome del set di dati contenente i campi da eliminare.
Campi Raccolta di campi (Microsoft.ReportDesigner.Field) da rilasciare.

Contenuto correlato