DesignSurface Classe

Definizione

Spazio dei nomi:

System.ComponentModel.Design

Assembly:

System.Windows.Forms.Design.dll

Fornisce un'interfaccia utente per la progettazione dei componenti.

public ref class DesignSurface : IDisposable, IServiceProvider

public class DesignSurface : IDisposable, IServiceProvider

type DesignSurface = class
    interface IDisposable
    interface IServiceProvider

Public Class DesignSurface
Implements IDisposable, IServiceProvider

Ereditarietà

Object

DesignSurface

Commenti

La DesignSurface classe implementa ciò che l'utente percepisce come una finestra di progettazione. DesignSurface è l'interfaccia utente che l'utente modifica per modificare le funzionalità in fase di progettazione. DesignSurface fornisce un'area di progettazione completamente autonoma.

La DesignSurface classe può essere usata come finestra di progettazione autonoma oppure può essere associata alla DesignSurfaceManager classe per fornire un'implementazione comune per un'applicazione che ospita più DesignSurface oggetti.

La DesignSurface classe può essere usata da sola oppure l'utente può derivare una nuova classe da essa e aumentare il comportamento.

La DesignSurface classe fornisce automaticamente diversi servizi in fase di progettazione. La DesignSurface classe aggiunge tutti i relativi servizi nel relativo costruttore. La maggior parte di questi servizi può essere sostituita sostituendoli nella proprietà protetta ServiceContainer . Per sostituire un servizio, eseguire l'override del costruttore, chiamare base e apportare modifiche tramite la proprietà protetta ServiceContainer . Tutti i servizi aggiunti al contenitore del servizio e che implementano IDisposable vengono eliminati quando l'area di progettazione viene eliminata. Il set predefinito di servizi sostituibili forniti dalla DesignSurface classe è illustrato nella tabella seguente.

Servizio	Descrizione
IExtenderProviderService	Consente agli oggetti che non fanno parte della raccolta di componenti del contenitore di fornire i propri provider di estensione.
IExtenderListService	Usato da TypeDescriptor per ottenere un elenco di provider extender. Con questo servizio, i provider extender possono risiedere all'esterno del contenitore.
ITypeDescriptorFilterService	Fornisce hook di metadati della finestra di progettazione. Si tratta dell'interfaccia principale per il filtro dei metadati.
ISelectionService	Consente di selezionare i componenti nella finestra di progettazione.
IReferenceService	Fornisce un modo per ottenere un nome per gli oggetti, anche quando tali oggetti non sono presenti nel sito.
DesignSurface	Offre l'area di progettazione stessa come servizio.
DesignerOptionService	Fornisce una classe di base per ottenere e impostare i valori delle opzioni per una finestra di progettazione.

La tabella seguente illustra i servizi non sostituibili forniti per impostazione predefinita.

Servizio	Descrizione
IComponentChangeService	Genera eventi man mano che vengono apportate modifiche ai componenti.
IDesignerHost	Controlla l'accesso a tipi, servizi e transazioni. Interfaccia primaria per le finestre di progettazione.
IContainer	Possiede il set di componenti progettati. Ogni finestra di progettazione dispone di un oggetto IContainer proprietario dei componenti.
IServiceContainer	Deriva da IServiceProvider e fornisce un modo per aggiungere e rimuovere servizi dalla finestra di progettazione.

Oltre a questi servizi, la DesignSurface classe fornisce anche un singolo servizio disponibile tramite il sito di un componente. Questo servizio è univoco per ogni componente. Nella tabella seguente vengono illustrati i servizi che non possono essere sostituiti.

Servizio	Descrizione
IDictionaryService	Dizionario generico di coppie chiave/valore che possono essere usate per archiviare dati arbitrari su un componente.
INestedContainer	Contenitore che consente a un componente di aggiungere componenti figlio aggiuntivi alla finestra di progettazione. Questi componenti faranno parte dell'area di progettazione, ma non faranno parte della serializzazione. Ciò è utile quando si vuole progettare un controllo in grado di esporre un'area di se stessa in una finestra di progettazione, ma non si vuole che l'area partecipi alla serializzazione.

Oltre a ISite, il sito implementa anche le interfacce seguenti.

Attenzione

Verificare l'esistenza di queste interfacce, anziché usare il cast indiscriminato, perché altre implementazioni del sito potrebbero non implementarle.

Servizio	Descrizione
IServiceContainer	Consente di accedere al contenitore di servizi specifici del sito. Ad esempio, IDictionaryService è un servizio specifico del sito. Con questo servizio è possibile aggiungere altri servizi specifici del sito.

Costruttori

DesignSurface()	Inizializza una nuova istanza della classe DesignSurface.
DesignSurface(IServiceProvider)	Inizializza una nuova istanza della classe DesignSurface.
DesignSurface(IServiceProvider, Type)	Inizializza una nuova istanza della classe DesignSurface.
DesignSurface(Type)	Inizializza una nuova istanza della classe DesignSurface.

Proprietà

ComponentContainer	Ottiene l'implementazione dell'interfaccia IContainer all'interno dell'area di progettazione.
DtelLoading	Ottiene un valore che indica se Design-time Error List viene caricato.
IsLoaded	Ottiene un valore che indica se l'area di progettazione è in fase di caricamento.
LoadErrors	Restituisce un insieme di errori di caricamento o un insieme vuoto.
ServiceContainer	Ottiene il contenitore dei servizi.
View	Ottiene la visualizzazione per la finestra di progettazione radice.

Metodi

BeginLoad(DesignerLoader)	Avvia il processo di caricamento con il caricatore della finestra di progettazione indicato.
BeginLoad(Type)	Avvia il processo di caricamento.
CreateComponent(Type)	Obsoleti. Crea un'istanza di un componente.
CreateDesigner(IComponent, Boolean)	Crea una finestra di progettazione quando un componente viene aggiunto al contenitore.
CreateInstance(Type)	Crea un'istanza del tipo indicato.
CreateNestedContainer(IComponent)	Crea un contenitore adatto per i controlli o i componenti di annidamento.
CreateNestedContainer(IComponent, String)	Crea un contenitore adatto per i controlli o i componenti di annidamento.
Dispose()	Rilascia le risorse usate da DesignSurface.
Dispose(Boolean)	Rilascia le risorse usate da DesignSurface.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Flush()	Serializza le modifiche apportate all'area di progettazione.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetService(Type)	Ottiene un servizio dal contenitore dei servizi.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnLoaded(LoadedEventArgs)	Genera l'evento Loaded.
OnLoading(EventArgs)	Genera l'evento Loading.
OnUnloaded(EventArgs)	Genera l'evento Unloaded.
OnUnloading(EventArgs)	Genera l'evento Unloading.
OnViewActivate(EventArgs)	Genera l'evento ViewActivated.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Eventi

Disposed	Generato quando viene eliminata l'area di progettazione.
Flushed	Generato quando viene eseguita una chiamata al metodo Flush() dell'oggetto DesignSurface.
Loaded	Generato al termine del caricamento della finestra di progettazione.
Loading	Generato quando si sta per caricare la finestra di progettazione.
Unloaded	Generato al termine dello scaricamento della finestra di progettazione.
Unloading	Generato quando la finestra di progettazione è in fase di scaricamento.
ViewActivated	Generato quando viene chiamato il metodo Activate() nell'interfaccia IDesignerHost.

Vedi anche

• IDesignerHost
• IServiceProvider
• DesignerLoader
• IDesignerLoaderService