DesignSurface Classe

Definizione

Fornisce un'interfaccia utente per la progettazione dei 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à
DesignSurface
Attributi
Implementazioni

Commenti

La DesignSurface classe implementa gli elementi che l'utente percepisce come una finestra di progettazione.The DesignSurface class implements what the user perceives as a designer. DesignSurfaceè l'interfaccia utente modificata dall'utente per modificare le funzionalità della fase di progettazione.DesignSurface is the user interface the user manipulates to change design-time features. DesignSurfacefornisce un'area di progettazione completamente indipendente.DesignSurface provides a completely self-contained design surface.

La DesignSurface classe può essere utilizzata come finestra di progettazione autonoma oppure può essere DesignSurfaceManager associata alla 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.

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

La DesignSurface classe fornisce automaticamente diversi servizi in fase di progettazione.The DesignSurface class provides several design-time services automatically. La 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 sottoposta a override sostituendo tali servizi nella proprietà protetta ServiceContainer .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 base e apportare le modifiche tramite la ServiceContainer proprietà protetta.To replace a service, override the constructor, call base, and make any changes through the protected ServiceContainer property. Tutti i servizi aggiunti al contenitore del servizio e che implementano IDisposable vengono eliminati quando l'area di progettazione viene eliminata.All services that are added to the service container and that implement IDisposable are disposed when the design surface is disposed. La tabella seguente illustra il set predefinito di servizi sostituibili forniti dalla DesignSurface classe.The default set of replaceable services that the DesignSurface class provides is shown in the following table.

ServiceService DescriptionDescription
IExtenderProviderService Consente agli oggetti che non fanno parte della raccolta di componenti del contenitore di 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 Utilizzato da TypeDescriptor per ottenere un elenco di provider di estensione.Used by TypeDescriptor to get a list of extender providers. Con questo servizio, i provider di estensione possono essere attivi all'esterno del contenitore.With this service, extender providers can live outside of the container.
ITypeDescriptorFilterService Fornisce hook di metadati della finestra di progettazione.Provides designer metadata hooks. Si tratta dell'interfaccia principale per il filtraggio dei metadati.This is the primary interface for metadata filtering.
ISelectionService Consente di 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 presenti nel sito.Provides a way to get a name for objects, even when those objects are not sited.
DesignSurface Offre l'area di progettazione stessa come servizio.Offers the design surface itself as a service.
DesignerOptionService Fornisce una classe di 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 DescriptionDescription
IComponentChangeService Genera eventi quando vengono apportate modifiche ai componenti.Raises events as changes are made to components.
IDesignerHost Controlla l'accesso ai tipi, ai servizi e alle transazioni.Controls access to types, services, and transactions. Interfaccia master per le finestre di progettazione.Master interface for designers.
IContainer Possiede il set di componenti in fase di progettazione.Owns the set of components that are being designed. Ogni finestra di progettazione IContainer dispone di un oggetto 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, la DesignSurface classe fornisce anche un unico servizio disponibile tramite il sito di un 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. La tabella seguente illustra i servizi che non possono essere sostituiti.The following table shows the services that cannot be replaced.

ServiceService DescriptionDescription
IDictionaryService Dizionario generico di coppie chiave/valore che è possibile utilizzare per archiviare dati arbitrari relativi a un componente.A generic dictionary of key/value pairs that can be used to store arbitrary data about a component.
INestedContainer Contenitore che consente a un componente di aggiungere ulteriori componenti figlio alla 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 parteciperanno alla serializzazione.These components will be part of the design surface, but will not participate in serialization. Questa operazione è utile quando si desidera progettare un controllo in grado di esporre un'area di se stessa in una finestra di progettazione, ma non si desidera che l'area partecipi alla 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 queste interfacce, anziché usare il cast indiscriminato, perché altre implementazioni del sito potrebbero non implementarle.Check for the existence of these interfaces, rather than use indiscriminate casting, because other site implementations may not implement them.

ServiceService DescriptionDescription
IServiceContainer Fornisce un modo per ottenere il contenitore di servizi specifici 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 altri servizi specifici del sito.With this service, you can add additional site-specific services.

Costruttori

DesignSurface()

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

DesignSurface(IServiceProvider)

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

DesignSurface(IServiceProvider, Type)

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

DesignSurface(Type)

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

Proprietà

ComponentContainer

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

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

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

LoadErrors

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

ServiceContainer

Ottiene il contenitore dei servizi.Gets the service container.

View

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

Metodi

BeginLoad(DesignerLoader)

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

BeginLoad(Type)

Avvia il processo di caricamento.Begins the loading process.

CreateComponent(Type)

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

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)

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

CreateNestedContainer(IComponent)

Crea un contenitore adatto per i controlli o i componenti di annidamento.Creates a container suitable for nesting controls or components.

CreateNestedContainer(IComponent, String)

Crea un contenitore adatto per i controlli o i componenti di annidamento.Creates a container suitable for nesting controls or components.

Dispose()

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

Dispose(Boolean)

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

Equals(Object)

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

(Ereditato da Object)
Flush()

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

GetHashCode()

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

(Ereditato da Object)
GetService(Type)

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

GetType()

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

(Ereditato da Object)
MemberwiseClone()

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

(Ereditato da Object)
OnLoaded(LoadedEventArgs)

Genera l'evento Loaded.Raises the Loaded event.

OnLoading(EventArgs)

Genera l'evento Loading.Raises the Loading event.

OnUnloaded(EventArgs)

Genera l'evento Unloaded.Raises the Unloaded event.

OnUnloading(EventArgs)

Genera l'evento Unloading.Raises the Unloading event.

OnViewActivate(EventArgs)

Genera l'evento ViewActivated.Raises the ViewActivated event.

ToString()

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

(Ereditato da Object)

Eventi

Disposed

Generato quando viene eliminata l'area di progettazione.Occurs when the design surface is disposed.

Flushed

Generato quando viene eseguita una chiamata al metodo Flush() dell'oggetto DesignSurface.Occurs when a call is made to the Flush() method of DesignSurface.

Loaded

Generato al termine del caricamento della finestra di progettazione.Occurs when the designer load has completed.

Loading

Generato quando si sta per caricare la finestra di progettazione.Occurs when the designer is about to be loaded.

Unloaded

Generato al termine dello scaricamento della finestra di progettazione.Occurs when a designer has finished unloading.

Unloading

Generato quando la finestra di progettazione è in fase di scaricamento.Occurs when a designer is about to unload.

ViewActivated

Generato quando viene chiamato il metodo Activate() nell'interfaccia 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 della richiesta LinkDemand: InheritanceDemand,.Demand values: LinkDemand, InheritanceDemand. Stato associato:Associated state:

Si applica a

Vedi anche