DesignerRegion Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.Design

Assembly:: System.Design.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Definisce un'area di contenuto nel markup Design-Time per il controllo associato.

public ref class DesignerRegion : System::Web::UI::Design::DesignerObject

public class DesignerRegion : System.Web.UI.Design.DesignerObject

type DesignerRegion = class
    inherit DesignerObject

Public Class DesignerRegion
Inherits DesignerObject

Ereditarietà: Object

DesignerObject
DesignerRegion

Derivato: System.Web.UI.Design.EditableDesignerRegion

Commenti

L' DesignerRegion oggetto rappresenta un'area di contenuto all'interno del markup della fase di progettazione generato da un' ControlDesigner implementazione di. Uno sviluppatore di controlli usa le aree della finestra di progettazione in un' ControlDesigner implementazione personalizzata per definire aree separate all'interno del markup della fase di progettazione per il controllo associato e per fornire la modifica e la gestione degli eventi per l'area. Una finestra di progettazione visiva, ad esempio Visual Studio 2005, può utilizzare le aree della finestra di progettazione per visualizzare le aree separate di un controllo nell'area di progettazione e per generare eventi utente per l'area alla finestra di progettazione del controllo. Le aree della finestra di progettazione possono semplificare l'implementazione di una finestra di progettazione di controlli, perché molte funzionalità basate su aree sono fornite dalle classi della finestra di progettazione di base e dalla finestra

La DesignerRegion classe fornisce la funzionalità di base per le aree della finestra di progettazione, ad esempio la possibilità di fare clic, selezionare ed evidenziare un'area nell'area di progettazione. Usare un DesignerRegion oggetto in un'implementazione della finestra di progettazione del controllo per definire un'area che non richiede la modifica. Usare la EditableDesignerRegion classe derivata in un'implementazione della finestra di progettazione dei controlli per definire un'area con contenuto modificabile in fase di progettazione. Usare la TemplatedEditableDesignerRegion classe derivata in un'implementazione della finestra di progettazione dei controlli per definire un'area modificabile che rappresenta un modello in un controllo.

Per supportare le aree all'interno di una classe derivata da ControlDesigner , eseguire l'override del GetDesignTimeHtml metodo e aggiungere uno o più oggetti inizializzati DesignerRegion alla DesignerRegionCollection raccolta. Facoltativamente, è possibile gestire i clic del mouse nelle aree dell'area di progettazione eseguendo l'override del OnClick metodo.

Usare le proprietà di un DesignerRegion oggetto per determinare il modo in cui l'area viene visualizzata dalla finestra di progettazione visiva. Eseguire l'override della Selectable proprietà per indicare che l'area può essere selezionata dall'utente nell'area di progettazione. Utilizzare la Highlight proprietà per evidenziare l'area della finestra di progettazione nella finestra di progettazione visiva. ad esempio, è possibile evidenziare un'area dopo che un utente ha fatto clic per selezionarla. Usare le DisplayName Description proprietà e per archiviare o recuperare dettagli aggiuntivi sull'area. In particolare, la Description proprietà viene utilizzata dalla finestra di progettazione visiva per visualizzare le informazioni sulla descrizione comando quando l'utente sposta il puntatore del mouse sull'area della finestra di progettazione. Utilizzare la Designer proprietà per accedere ai metodi e alle proprietà dell'oggetto della finestra di progettazione del controllo che contiene l'area della finestra di progettazione.

Costruttori

DesignerRegion(ControlDesigner, String)	Inizializza una nuova istanza della classe DesignerRegion con il nome specificato per una finestra di progettazione del controllo.
DesignerRegion(ControlDesigner, String, Boolean)	Inizializza una nuova istanza della classe DesignerRegion con il nome specificato per una finestra di progettazione del controllo, impostando facoltativamente l'istanza come area selezionabile nella finestra di progettazione.

Campi

DesignerRegionAttributeName

Definisce il nome dell'attributo HTML per un'area della finestra di progettazione.

Proprietà

Description	Ottiene o imposta la descrizione di un'area della finestra di progettazione.
Designer	Ottiene il componente della finestra di progettazione associato. (Ereditato da DesignerObject)
DisplayName	Ottiene o imposta il nome descrittivo visualizzato di un'area della finestra di progettazione.
EnsureSize	Ottiene o imposta un valore che indica se le dimensioni dell'area devono essere impostate in modo esplicito nell'area dalla finestra di progettazione dall'host di progettazione.
Highlight	Ottiene o imposta un valore che indica se l'area della finestra di progettazione deve essere evidenziata nell'area di progettazione.
Name	Ottiene il nome dell'oggetto. (Ereditato da DesignerObject)
Properties	Ottiene il nome delle proprietà dell'oggetto. (Ereditato da DesignerObject)
Selectable	Ottiene o imposta un valore che indica se l'area della finestra di progettazione può essere selezionata dall'utente nell'area di progettazione.
Selected	Ottiene o imposta un valore che indica se l'area della finestra di progettazione è correntemente selezionata nell'area di progettazione.
UserData	Ottiene o imposta dati utente facoltativi da associare all'area della finestra di progettazione.

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetBounds()	Recupera le dimensioni dell'area della finestra di progettazione nell'area di progettazione.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetService(Type)	Ottiene un servizio dall'host di progettazione, come identificato dal tipo fornito. (Ereditato da DesignerObject)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Implementazioni dell'interfaccia esplicita

IServiceProvider.GetService(Type)

Per una descrizione di questo membro, vedere GetService(Type).

(Ereditato da DesignerObject)

Si applica a