DesignSurface DesignSurface DesignSurface DesignSurface Class

Definizione

Offre un'interfaccia utente per la progettazione di componenti.Presents a user interface for designing components.

public ref class DesignSurface : IDisposable, IServiceProvider
[System.Security.SecurityCritical]
public class DesignSurface : IDisposable, IServiceProvider
type DesignSurface = class
    interface IDisposable
    interface IServiceProvider
Public Class DesignSurface
Implements IDisposable, IServiceProvider
Ereditarietà
DesignSurfaceDesignSurfaceDesignSurfaceDesignSurface
Attributi
Implementazioni

Commenti

Il DesignSurface classe implementa percepita dall'utente come finestra di progettazione.The DesignSurface class implements what the user perceives as a designer. DesignSurface è che l'interfaccia utente, l'utente modifica le modifiche alle funzionalità in fase di progettazione.DesignSurface is the user interface the user manipulates to change design-time features. DesignSurface fornisce una superficie di progettazione completamente autosufficiente.DesignSurface provides a completely self-contained design surface.

Il DesignSurface classe può essere usata come una finestra di progettazione autonomo o può essere abbinato il DesignSurfaceManager classe per fornire un'implementazione comune per un'applicazione che ospita più DesignSurface oggetti.The DesignSurface class may be used as a stand-alone designer, or it may be coupled with the DesignSurfaceManager class to provide a common implementation for an application that hosts multiple DesignSurface objects.

Il DesignSurface classe può essere usata da solo o l'utente può derivare una nuova classe da quest'ultimo e migliorare il comportamento.The DesignSurface class can be used by itself, or the user can derive a new class from it and augment the behavior.

Il DesignSurface classe fornisce vari servizi in fase di progettazione automaticamente.The DesignSurface class provides several design-time services automatically. Il DesignSurface classe aggiunge tutti i relativi servizi nel relativo costruttore.The DesignSurface class adds all of its services in its constructor. La maggior parte di questi servizi può essere sostituita dal sostituirli in protetto ServiceContainer proprietà.Most of these services can be overridden by replacing them in the protected ServiceContainer property. Per sostituire un servizio, eseguire l'override del costruttore, chiamare il metodo base e apportare le modifiche tramite il metodo protetto ServiceContainer proprietà.To replace a service, override the constructor, call base, and make any changes through the protected ServiceContainer property. Tutti i servizi che vengono aggiunte al contenitore del servizio e che implementano IDisposable vengono eliminati quando si elimina l'area di progettazione.All services that are added to the service container and that implement IDisposable are disposed when the design surface is disposed. Il set predefinito di sostituibili servizi a cui il DesignSurface classe fornisce è illustrato nella tabella seguente.The default set of replaceable services that the DesignSurface class provides is shown in the following table.

ServiceService DescrizioneDescription
IExtenderProviderService Abilita gli oggetti che non fanno parte della raccolta di componenti del contenitore per fornire i propri provider di estensione.Enables objects that are not part of the container's components collection to provide their own extender providers.
IExtenderListService Usato da TypeDescriptor per ottenere un elenco di provider di estensione.Used by TypeDescriptor to get a list of extender providers. Con questo servizio, provider di estensione possano in tempo reale all'esterno del contenitore.With this service, extender providers can live outside of the container.
ITypeDescriptorFilterService Offre hook della finestra di progettazione metadati.Provides designer metadata hooks. Questo è l'interfaccia principale per il filtro di metadati.This is the primary interface for metadata filtering.
ISelectionService Fornisce un modo per selezionare i componenti nella finestra di progettazione.Provides a way to select components in the designer.
IReferenceService Fornisce un modo per ottenere un nome per gli oggetti, anche quando tali oggetti non sono definiti nel sito.Provides a way to get a name for objects, even when those objects are not sited.
DesignSurface Offre l'area di progettazione se stesso come un servizio.Offers the design surface itself as a service.
DesignerOptionService Fornisce una classe base per ottenere e impostare i valori delle opzioni per una finestra di progettazione.Provides a base class for getting and setting option values for a designer.

La tabella seguente illustra i servizi non sostituibili forniti per impostazione predefinita.The following table shows the non-replaceable services provided by default.

ServiceService DescrizioneDescription
IComponentChangeService Genera eventi quando vengono apportate modifiche ai componenti.Raises events as changes are made to components.
IDesignerHost Controlla l'accesso a tipi, servizi e transazioni.Controls access to types, services, and transactions. Interfaccia principale per le finestre di progettazione.Master interface for designers.
IContainer Proprietario del set di componenti che sono in fase di progettazione.Owns the set of components that are being designed. Ogni finestra di progettazione ha un IContainer che possiede i componenti.Each designer has an IContainer that owns the components.
IServiceContainer Deriva da IServiceProvider e fornisce un modo per aggiungere e rimuovere servizi dalla finestra di progettazione.Derives from IServiceProvider and provides a way to add and remove services from the designer.

Oltre a questi servizi, il DesignSurface classe fornisce anche un unico servizio che è disponibile tramite un sito del componente.In addition to these services, the DesignSurface class also provides a single service that is available through a component's site. Questo servizio è univoco per ogni componente.This service is unique for each component. Nella tabella seguente vengono illustrati i servizi che non possono essere sostituiti.The following table shows the services that cannot be replaced.

ServiceService DescrizioneDescription
IDictionaryService Un dizionario generico di coppie chiave/valore che può essere utilizzato per archiviare i dati arbitrari su un componente.A generic dictionary of key/value pairs that can be used to store arbitrary data about a component.
INestedContainer Un contenitore che consente a un componente aggiungere i componenti figlio aggiuntive nella finestra di progettazione.A container that enables a component to add additional child components to the designer. Questi componenti faranno parte dell'area di progettazione, ma non verranno inclusa nella serializzazione.These components will be part of the design surface, but will not participate in serialization. Ciò è utile quando si vuole progettare un controllo che è in grado di esporre un'area di se stesso in una finestra di progettazione, ma non si desidera l'area a far parte di serializzazione.This is useful when you want to design a control that is capable of exposing a region of itself in a designer, but you do not want the region to participate in serialization.

Oltre a ISite, il sito implementa anche le interfacce seguenti.In addition to ISite, the site also implements the following interfaces.

Attenzione

Verificare l'esistenza di tali interfacce, anziché usano indiscriminato cast, poiché altre implementazioni di sito potrebbero non essere implementate.Check for the existence of these interfaces, rather than use indiscriminate casting, because other site implementations may not implement them.

ServiceService DescrizioneDescription
IServiceContainer Fornisce un modo per ottenere il contenitore dei servizi specifico del sito.Provides a way to get to the container of site-specific services. Ad esempio, IDictionaryService è un servizio specifico del sito.For example, IDictionaryService is a site-specific service. Con questo servizio, è possibile aggiungere servizi specifico del sito aggiuntivi.With this service, you can add additional site-specific services.

Costruttori

DesignSurface() DesignSurface() DesignSurface() DesignSurface()

Inizializza una nuova istanza della classe DesignSurface.Initializes a new instance of the DesignSurface class.

DesignSurface(IServiceProvider) DesignSurface(IServiceProvider) DesignSurface(IServiceProvider) DesignSurface(IServiceProvider)

Inizializza una nuova istanza della classe DesignSurface.Initializes a new instance of the DesignSurface class.

DesignSurface(IServiceProvider, Type) DesignSurface(IServiceProvider, Type) DesignSurface(IServiceProvider, Type) DesignSurface(IServiceProvider, Type)

Inizializza una nuova istanza della classe DesignSurface.Initializes a new instance of the DesignSurface class.

DesignSurface(Type) DesignSurface(Type) DesignSurface(Type) DesignSurface(Type)

Inizializza una nuova istanza della classe DesignSurface.Initializes a new instance of the DesignSurface class.

Proprietà

ComponentContainer ComponentContainer ComponentContainer ComponentContainer

Ottiene il IContainer implementazione all'interno dell'area di progettazione.Gets the IContainer implementation within the design surface.

DtelLoading DtelLoading DtelLoading DtelLoading

Ottiene un valore che indica se Design-time Error List viene caricato.Gets a value indicating whether the Design-time Error List is loading.

IsLoaded IsLoaded IsLoaded IsLoaded

Ottiene un valore che indica se l'area di progettazione è attualmente caricato.Gets a value indicating whether the design surface is currently loaded.

LoadErrors LoadErrors LoadErrors LoadErrors

Restituisce una raccolta di errori di caricamento o un insieme vuoto.Returns a collection of loading errors or a void collection.

ServiceContainer ServiceContainer ServiceContainer ServiceContainer

Ottiene il contenitore del servizio.Gets the service container.

View View View View

Ottiene la visualizzazione della finestra di progettazione radice.Gets the view for the root designer.

Metodi

BeginLoad(DesignerLoader) BeginLoad(DesignerLoader) BeginLoad(DesignerLoader) BeginLoad(DesignerLoader)

Avvia il processo di caricamento con il caricatore della finestra di progettazione specificato.Begins the loading process with the given designer loader.

BeginLoad(Type) BeginLoad(Type) BeginLoad(Type) BeginLoad(Type)

Avvia il processo di caricamento.Begins the loading process.

CreateComponent(Type) CreateComponent(Type) CreateComponent(Type) CreateComponent(Type)

Crea un'istanza di un componente.Creates an instance of a component.

CreateDesigner(IComponent, Boolean) CreateDesigner(IComponent, Boolean) CreateDesigner(IComponent, Boolean) CreateDesigner(IComponent, Boolean)

Crea una finestra di progettazione quando un componente viene aggiunto al contenitore.Creates a designer when a component is added to the container.

CreateInstance(Type) CreateInstance(Type) CreateInstance(Type) CreateInstance(Type)

Crea un'istanza del tipo specificato.Creates an instance of the given type.

CreateNestedContainer(IComponent) CreateNestedContainer(IComponent) CreateNestedContainer(IComponent) CreateNestedContainer(IComponent)

Crea un contenitore adatto per la nidificazione controlli o componenti.Creates a container suitable for nesting controls or components.

CreateNestedContainer(IComponent, String) CreateNestedContainer(IComponent, String) CreateNestedContainer(IComponent, String) CreateNestedContainer(IComponent, String)

Crea un contenitore adatto per la nidificazione controlli o componenti.Creates a container suitable for nesting controls or components.

Dispose() Dispose() Dispose() Dispose()

Rilascia le risorse usate da DesignSurface.Releases the resources used by the DesignSurface.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Rilascia le risorse usate da DesignSurface.Releases the resources used by the DesignSurface.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Flush() Flush() Flush() Flush()

Serializza le modifiche apportate all'area di progettazione.Serializes changes to the design surface.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Ottiene un servizio dal contenitore dei servizi.Gets a service from the service container.

GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
OnLoaded(LoadedEventArgs) OnLoaded(LoadedEventArgs) OnLoaded(LoadedEventArgs) OnLoaded(LoadedEventArgs)

Genera l'evento Loaded.Raises the Loaded event.

OnLoading(EventArgs) OnLoading(EventArgs) OnLoading(EventArgs) OnLoading(EventArgs)

Genera l'evento Loading.Raises the Loading event.

OnUnloaded(EventArgs) OnUnloaded(EventArgs) OnUnloaded(EventArgs) OnUnloaded(EventArgs)

Genera l'evento Unloaded.Raises the Unloaded event.

OnUnloading(EventArgs) OnUnloading(EventArgs) OnUnloading(EventArgs) OnUnloading(EventArgs)

Genera l'evento Unloading.Raises the Unloading event.

OnViewActivate(EventArgs) OnViewActivate(EventArgs) OnViewActivate(EventArgs) OnViewActivate(EventArgs)

Genera l'evento ViewActivated.Raises the ViewActivated event.

ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Eventi

Disposed Disposed Disposed Disposed

Si verifica quando viene eliminato l'area di progettazione.Occurs when the design surface is disposed.

Flushed Flushed Flushed Flushed

Si verifica quando viene eseguita una chiamata per il Flush() metodo DesignSurface.Occurs when a call is made to the Flush() method of DesignSurface.

Loaded Loaded Loaded Loaded

Si verifica quando il caricamento della finestra di progettazione è stata completata.Occurs when the designer load has completed.

Loading Loading Loading Loading

Si verifica quando la finestra di progettazione sta per essere caricato.Occurs when the designer is about to be loaded.

Unloaded Unloaded Unloaded Unloaded

Si verifica quando una finestra di progettazione è terminato lo scaricamento.Occurs when a designer has finished unloading.

Unloading Unloading Unloading Unloading

Si verifica quando una finestra di progettazione sta per essere scaricato.Occurs when a designer is about to unload.

ViewActivated ViewActivated ViewActivated ViewActivated

Si verifica quando la Activate() metodo è stato chiamato su IDesignerHost.Occurs when the Activate() method has been called on IDesignerHost.

Sicurezza

NamedPermissionSet
per l'accesso completo alle risorse di sistema.for full access to system resources. Valori richiesta: LinkDemand, InheritanceDemand.Demand values: LinkDemand, InheritanceDemand. Stato associato:Associated state:

Si applica a

Vedi anche