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'oggetto DesignerRegion rappresenta un'area di contenuto all'interno del markup in fase di progettazione generato da un'implementazione ControlDesigner . Uno sviluppatore di controlli usa le aree di progettazione in un'implementazione personalizzata ControlDesigner per definire aree separate all'interno del markup in 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ò usare le aree della finestra di progettazione per visualizzare le aree separate di un controllo nell'area di progettazione e generare eventi utente per l'area nella finestra di progettazione dei controlli. Designer aree possono semplificare un'implementazione di Progettazione controlli perché molte funzionalità basate sull'area sono fornite dalle classi di progettazione di base e dalla finestra di progettazione visiva.

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. Utilizzare un DesignerRegion oggetto in un'implementazione di Progettazione controlli per definire un'area che non richiede la modifica. Usare la classe derivata EditableDesignerRegion in un'implementazione di Progettazione controlli per definire un'area con contenuto modificabile in fase di progettazione. Usare la classe derivata TemplatedEditableDesignerRegion in un'implementazione di Progettazione controlli per definire un'area modificabile che rappresenta un modello in un controllo .

Per supportare le aree all'interno di una classe derivata da , eseguire l'override ControlDesignerdel 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 .

Utilizzare le proprietà di un DesignerRegion oggetto per determinare la modalità di visualizzazione dell'area da parte della 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 selezionarlo. Usare le DisplayName proprietà e Description 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 di progettazione. Utilizzare la Designer proprietà per accedere ai metodi e alle proprietà dell'oggetto Progettazione controlli 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)

Metodi di estensione

GetKeyedService<T>(IServiceProvider, Object)	Ottiene un servizio di tipo `T` dall'oggetto IServiceProvider.
GetKeyedServices(IServiceProvider, Type, Object)	Ottiene un'enumerazione dei servizi di tipo `serviceType` dall'oggetto IServiceProvider.
GetKeyedServices<T>(IServiceProvider, Object)	Ottiene un'enumerazione dei servizi di tipo `T` dall'oggetto IServiceProvider.
GetRequiredKeyedService(IServiceProvider, Type, Object)	Ottiene un servizio di tipo `serviceType` dall'oggetto IServiceProvider.
GetRequiredKeyedService<T>(IServiceProvider, Object)	Ottiene un servizio di tipo `T` dall'oggetto IServiceProvider.
CreateAsyncScope(IServiceProvider)	Crea un nuovo oggetto AsyncServiceScope che è possibile usare per risolvere i servizi con ambito.
CreateScope(IServiceProvider)	Crea un nuovo oggetto IServiceScope che è possibile usare per risolvere i servizi con ambito.
GetRequiredService(IServiceProvider, Type)	Ottiene il servizio di tipo `serviceType` da IServiceProvider.
GetRequiredService<T>(IServiceProvider)	Ottiene il servizio di tipo `T` da IServiceProvider.
GetService<T>(IServiceProvider)	Ottiene il servizio di tipo `T` da IServiceProvider.
GetServices(IServiceProvider, Type)	Ottiene un'enumerazione di servizi di tipo `serviceType` da IServiceProvider.
GetServices<T>(IServiceProvider)	Ottiene un'enumerazione di servizi di tipo `T` da IServiceProvider.
GetFakeLogCollector(IServiceProvider)	Ottiene l'oggetto che raccoglie i record di log inviati al logger falso.
GetFakeRedactionCollector(IServiceProvider)	Ottiene l'istanza dell'agente di raccolta redactor falso dal contenitore di inserimento delle dipendenze.

Si applica a