DesignSurface DesignSurface DesignSurface DesignSurface Class

Definición

Presenta una interfaz de usuario para el diseño de componentes.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
Herencia
DesignSurfaceDesignSurfaceDesignSurfaceDesignSurface
Atributos
Implementaciones

Comentarios

La DesignSurface clase implementa lo que el usuario percibe como un diseñador.The DesignSurface class implements what the user perceives as a designer. DesignSurfacees la interfaz de usuario que el usuario manipula para cambiar las características en tiempo de diseño.DesignSurface is the user interface the user manipulates to change design-time features. DesignSurfaceproporciona una superficie de diseño completamente independiente.DesignSurface provides a completely self-contained design surface.

La DesignSurface clase se puede usar como un diseñador independiente o puede estar acoplada a la DesignSurfaceManager clase para proporcionar una implementación común para una aplicación que hospede varios DesignSurface objetos.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 clase se puede usar por sí sola o el usuario puede derivar una nueva clase a partir de ella y aumentar el comportamiento.The DesignSurface class can be used by itself, or the user can derive a new class from it and augment the behavior.

La DesignSurface clase proporciona automáticamente varios servicios en tiempo de diseño.The DesignSurface class provides several design-time services automatically. La DesignSurface clase agrega todos sus servicios en su constructor.The DesignSurface class adds all of its services in its constructor. La mayoría de estos servicios se pueden invalidar reemplazándolo en la propiedad protegida ServiceContainer .Most of these services can be overridden by replacing them in the protected ServiceContainer property. Para reemplazar un servicio, invalide el constructor, llame a base y realice los cambios a ServiceContainer través de la propiedad protegida.To replace a service, override the constructor, call base, and make any changes through the protected ServiceContainer property. Todos los servicios que se agregan al contenedor de servicio y IDisposable que implementan se eliminan cuando se desecha la superficie de diseño.All services that are added to the service container and that implement IDisposable are disposed when the design surface is disposed. En la tabla siguiente se muestra el conjunto predeterminado de DesignSurface servicios reemplazables que proporciona la clase.The default set of replaceable services that the DesignSurface class provides is shown in the following table.

web de OfficeService DescripciónDescription
IExtenderProviderService Permite que los objetos que no forman parte de la colección de componentes del contenedor proporcionen sus propios proveedores extensores.Enables objects that are not part of the container's components collection to provide their own extender providers.
IExtenderListService Utilizado por TypeDescriptor para obtener una lista de proveedores extensores.Used by TypeDescriptor to get a list of extender providers. Con este servicio, los proveedores extensores pueden residir fuera del contenedor.With this service, extender providers can live outside of the container.
ITypeDescriptorFilterService Proporciona enlaces de metadatos del diseñador.Provides designer metadata hooks. Esta es la interfaz principal para el filtrado de metadatos.This is the primary interface for metadata filtering.
ISelectionService Proporciona una manera de seleccionar componentes en el diseñador.Provides a way to select components in the designer.
IReferenceService Proporciona una manera de obtener un nombre para los objetos, incluso cuando esos objetos no se encuentran en el sitio.Provides a way to get a name for objects, even when those objects are not sited.
DesignSurface Ofrece la propia superficie de diseño como servicio.Offers the design surface itself as a service.
DesignerOptionService Proporciona una clase base para obtener y establecer valores de opciones de un diseñador.Provides a base class for getting and setting option values for a designer.

En la tabla siguiente se muestran los servicios no reemplazables proporcionados de forma predeterminada.The following table shows the non-replaceable services provided by default.

web de OfficeService DescripciónDescription
IComponentChangeService Genera eventos a medida que se realizan cambios en los componentes.Raises events as changes are made to components.
IDesignerHost Controla el acceso a tipos, servicios y transacciones.Controls access to types, services, and transactions. Interfaz maestra para diseñadores.Master interface for designers.
IContainer Posee el conjunto de componentes que se están diseñando.Owns the set of components that are being designed. Cada diseñador tiene un IContainer que posee los componentes de.Each designer has an IContainer that owns the components.
IServiceContainer Deriva de IServiceProvider y proporciona una manera de agregar y quitar servicios del diseñador.Derives from IServiceProvider and provides a way to add and remove services from the designer.

Además de estos servicios, la DesignSurface clase también proporciona un servicio único que está disponible a través del sitio de un componente.In addition to these services, the DesignSurface class also provides a single service that is available through a component's site. Este servicio es único para cada componente.This service is unique for each component. En la tabla siguiente se muestran los servicios que no se pueden reemplazar.The following table shows the services that cannot be replaced.

web de OfficeService DescripciónDescription
IDictionaryService Diccionario genérico de pares clave-valor que se puede utilizar para almacenar datos arbitrarios sobre un componente.A generic dictionary of key/value pairs that can be used to store arbitrary data about a component.
INestedContainer Contenedor que permite a un componente agregar componentes secundarios adicionales al diseñador.A container that enables a component to add additional child components to the designer. Estos componentes formarán parte de la superficie de diseño, pero no participarán en la serialización.These components will be part of the design surface, but will not participate in serialization. Esto resulta útil si desea diseñar un control capaz de exponer una región de sí mismo en un diseñador, pero no desea que la región participe en la serialización.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.

Además de, el sitio también implementa las siguientes interfaces. ISiteIn addition to ISite, the site also implements the following interfaces.

Precaución

Compruebe la existencia de estas interfaces, en lugar de usar la conversión indiscriminada, ya que otras implementaciones del sitio pueden no implementarlas.Check for the existence of these interfaces, rather than use indiscriminate casting, because other site implementations may not implement them.

web de OfficeService DescripciónDescription
IServiceContainer Proporciona una manera de obtener el contenedor de servicios específicos del sitio.Provides a way to get to the container of site-specific services. Por ejemplo, IDictionaryService es un servicio específico del sitio.For example, IDictionaryService is a site-specific service. Con este servicio, puede agregar servicios adicionales específicos del sitio.With this service, you can add additional site-specific services.

Constructores

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

Inicializa una nueva instancia de la clase DesignSurface.Initializes a new instance of the DesignSurface class.

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

Inicializa una nueva instancia de la clase DesignSurface.Initializes a new instance of the DesignSurface class.

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

Inicializa una nueva instancia de la clase DesignSurface.Initializes a new instance of the DesignSurface class.

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

Inicializa una nueva instancia de la clase DesignSurface.Initializes a new instance of the DesignSurface class.

Propiedades

ComponentContainer ComponentContainer ComponentContainer ComponentContainer

Obtiene la implementación de IContainer en la superficie de diseño.Gets the IContainer implementation within the design surface.

DtelLoading DtelLoading DtelLoading DtelLoading

Obtiene un valor que indica si se está cargando la Lista de errores en tiempo de diseño.Gets a value indicating whether the Design-time Error List is loading.

IsLoaded IsLoaded IsLoaded IsLoaded

Obtiene un valor que indica si la superficie de diseño está cargada actualmente.Gets a value indicating whether the design surface is currently loaded.

LoadErrors LoadErrors LoadErrors LoadErrors

Devuelve una colección de errores de carga o una colección nula.Returns a collection of loading errors or a void collection.

ServiceContainer ServiceContainer ServiceContainer ServiceContainer

Obtiene el contenedor de servicios.Gets the service container.

View View View View

Obtiene la vista para el diseñador raíz.Gets the view for the root designer.

Métodos

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

Comienza el proceso de carga con el cargador de diseñadores especificado.Begins the loading process with the given designer loader.

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

Comienza el proceso de carga.Begins the loading process.

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

Crea una instancia de un componente.Creates an instance of a component.

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

Crea un diseñador cuando se agrega un componente al contenedor.Creates a designer when a component is added to the container.

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

Crea una instancia del tipo especificado.Creates an instance of the given type.

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

Crea un contenedor adecuado para anidar controles o componentes.Creates a container suitable for nesting controls or components.

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

Crea un contenedor adecuado para anidar controles o componentes.Creates a container suitable for nesting controls or components.

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

Libera los recursos que usa DesignSurface.Releases the resources used by the DesignSurface.

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

Libera los recursos que usa DesignSurface.Releases the resources used by the DesignSurface.

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

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

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

Serializa los cambios en la superficie de diseño.Serializes changes to the design surface.

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

Sirve como la función hash predeterminada.Serves as the default hash function.

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

Obtiene un servicio del contenedor de servicios.Gets a service from the service container.

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

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

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

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

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

Genera el evento Loaded.Raises the Loaded event.

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

Genera el evento Loading.Raises the Loading event.

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

Genera el evento Unloaded.Raises the Unloaded event.

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

Genera el evento Unloading.Raises the Unloading event.

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

Genera el evento ViewActivated.Raises the ViewActivated event.

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

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Eventos

Disposed Disposed Disposed Disposed

Se produce cuando se desecha la superficie de diseño.Occurs when the design surface is disposed.

Flushed Flushed Flushed Flushed

Se produce cuando se realiza una llamada al método Flush() de DesignSurface.Occurs when a call is made to the Flush() method of DesignSurface.

Loaded Loaded Loaded Loaded

Se produce cuando se completa la carga del diseñador.Occurs when the designer load has completed.

Loading Loading Loading Loading

Se produce cuando el diseñador está a punto de cargarse.Occurs when the designer is about to be loaded.

Unloaded Unloaded Unloaded Unloaded

Se produce cuando un diseñador ha finalizado la descarga.Occurs when a designer has finished unloading.

Unloading Unloading Unloading Unloading

Se produce cuando un diseñador está a punto de descargarse.Occurs when a designer is about to unload.

ViewActivated ViewActivated ViewActivated ViewActivated

Se produce cuando se ha llamado al método Activate() en IDesignerHost.Occurs when the Activate() method has been called on IDesignerHost.

Seguridad

NamedPermissionSet
para obtener acceso completo a los recursos del sistema.for full access to system resources. Valores de petición LinkDemand: InheritanceDemand,.Demand values: LinkDemand, InheritanceDemand. Estado asociado:Associated state:

Se aplica a

Consulte también: