DesignerRegion DesignerRegion DesignerRegion DesignerRegion Class

Definición

Define una región de contenido dentro del marcado en tiempo de diseño para el control asociado.Defines a region of content within the design-time markup for the associated control.

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
Herencia
DesignerRegionDesignerRegionDesignerRegionDesignerRegion
Derivado

Comentarios

El DesignerRegion objeto representa una región de contenido dentro del marcado en tiempo de diseño generado por una ControlDesigner implementación de.The DesignerRegion object represents a region of content within the design-time markup that is generated by a ControlDesigner implementation. Un desarrollador de controles utiliza regiones del diseñador en ControlDesigner una implementación personalizada para definir áreas independientes en el marcado en tiempo de diseño para el control asociado y para proporcionar la edición y el control de eventos para el área.A control developer uses designer regions in a custom ControlDesigner implementation to define separate areas within the design-time markup for the associated control and to provide editing and event handling for the area. Un diseñador visual, Visual Studio 2005Visual Studio 2005como, puede utilizar regiones del diseñador para mostrar las áreas independientes de un control en la superficie de diseño y para generar eventos de usuario para la región en el diseñador de controles.A visual designer, such as Visual Studio 2005Visual Studio 2005, can use designer regions to display the separate areas of a control on the design surface and to raise user events for the region to the control designer. Las regiones del diseñador pueden simplificar la implementación de un diseñador de controles, ya que las clases base del diseñador y el diseñador visual proporcionan muchas características basadas en regiones.Designer regions can simplify a control designer implementation because many region-based features are provided by the base designer classes and the visual designer.

La DesignerRegion clase proporciona la funcionalidad básica para las regiones del diseñador, como la capacidad de hacer clic, seleccionar y resaltar una región en la superficie de diseño.The DesignerRegion class provides the base functionality for designer regions, such as the ability to click, select, and highlight a region in the design surface. Use un DesignerRegion objeto en una implementación del diseñador de controles para definir una región que no requiera edición.Use a DesignerRegion object in a control designer implementation to define a region that does not require editing. Utilice la clase EditableDesignerRegion derivada en una implementación del diseñador de controles para definir una región con contenido editable en tiempo de diseño.Use the derived EditableDesignerRegion class in a control designer implementation to define a region with editable content at design time. Utilice la clase TemplatedEditableDesignerRegion derivada en una implementación del diseñador de controles para definir un área modificable que represente una plantilla en un control.Use the derived TemplatedEditableDesignerRegion class in a control designer implementation to define an editable region that represents a template in a control.

Para admitir regiones dentro de una clase que se deriva de ControlDesigner, invalide el GetDesignTimeHtml método y agregue DesignerRegion uno o más objetos inicializados DesignerRegionCollection a la colección.To support regions within a class that is derived from the ControlDesigner, override the GetDesignTimeHtml method and add one or more initialized DesignerRegion objects to the DesignerRegionCollection collection. Opcionalmente, puede controlar los clics del mouse en las regiones en la superficie de diseño invalidando el OnClick método.Optionally, you can handle mouse clicks in the regions on the design surface by overriding the OnClick method.

Use las propiedades de un DesignerRegion objeto para determinar cómo se muestra la región en el diseñador visual.Use the properties of a DesignerRegion object to determine how the region is displayed by the visual designer. Invalide la Selectable propiedad para indicar que el usuario puede seleccionar la región en la superficie de diseño.Override the Selectable property to indicate that the region can be selected by the user on the design surface. Use la Highlight propiedad para resaltar la región del diseñador en el diseñador visual; por ejemplo, puede resaltar una región después de que un usuario haga clic en ella para seleccionarla.Use the Highlight property to highlight the designer region in the visual designer; for example, you can highlight a region after a user has clicked to select it. Utilice las DisplayName propiedades Description y para almacenar o recuperar detalles adicionales sobre la región.Use the DisplayName and Description properties to store or retrieve additional details about the region. En concreto, el Description diseñador visual utiliza la propiedad para mostrar información sobre herramientas cuando el usuario mueve el puntero del mouse sobre la región del diseñador.In particular, the Description property is used by the visual designer to display ToolTip information when the user moves the mouse pointer over the designer region. Utilice la Designer propiedad para tener acceso a los métodos y propiedades del objeto del diseñador de controles que contiene la región del diseñador.Use the Designer property to access the methods and properties of the control designer object that contains the designer region.

Constructores

DesignerRegion(ControlDesigner, String) DesignerRegion(ControlDesigner, String) DesignerRegion(ControlDesigner, String) DesignerRegion(ControlDesigner, String)

Inicializa una nueva instancia de la clase DesignerRegion con el nombre especificado para un diseñador de controles.Initializes a new instance of the DesignerRegion class with the specified name for a control designer.

DesignerRegion(ControlDesigner, String, Boolean) DesignerRegion(ControlDesigner, String, Boolean) DesignerRegion(ControlDesigner, String, Boolean) DesignerRegion(ControlDesigner, String, Boolean)

Inicializa una nueva instancia de la clase DesignerRegion con el nombre especificado para un diseñador de controles, que de modo opcional establece la instancia como una región seleccionable del diseñador.Initializes a new instance of the DesignerRegion class with the specified name for a control designer, optionally setting the instance as a selectable region in the designer.

Campos

DesignerRegionAttributeName DesignerRegionAttributeName DesignerRegionAttributeName DesignerRegionAttributeName

Define el nombre del atributo HTML de una región del diseñador.Defines the HTML attribute name for a designer region.

Propiedades

Description Description Description Description

Obtiene o establece la descripción de una región del diseñador.Gets or sets the description for a designer region.

Designer Designer Designer Designer

Obtiene el componente del diseñador asociado.Gets the associated designer component.

(Inherited from DesignerObject)
DisplayName DisplayName DisplayName DisplayName

Obtiene o establece el nombre descriptivo que se va a mostrar de una región del diseñador.Gets or sets the friendly display name for a designer region.

EnsureSize EnsureSize EnsureSize EnsureSize

Obtiene o establece un valor que indica si el host del diseñador va a establecer explícitamente el tamaño de la región del diseñador.Gets or sets a value indicating whether the region size is to be explicitly set on the designer region by the design host.

Highlight Highlight Highlight Highlight

Obtiene o establece un valor que indica si la región del diseñador se va a resaltar en la superficie de diseño.Gets or sets a value indicating whether to highlight the designer region on the design surface.

Name Name Name Name

Obtiene el nombre del objeto.Gets the name of the object.

(Inherited from DesignerObject)
Properties Properties Properties Properties

Obtiene las propiedades del objeto.Gets the object's properties.

(Inherited from DesignerObject)
Selectable Selectable Selectable Selectable

Obtiene o establece un valor que indica si el usuario puede seleccionar la región del diseñador en la superficie de diseño.Gets or sets a value indicating whether the designer region can be selected by the user on the design surface.

Selected Selected Selected Selected

Obtiene o establece un valor que indica si la región del diseñador está actualmente seleccionada en la superficie de diseño.Gets or sets a value indicating whether the designer region is currently selected on the design surface.

UserData UserData UserData UserData

Obtiene o establece datos de usuario opcionales que se van a asociar a la región del diseñador.Gets or sets optional user data to associate with the designer region.

Métodos

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)
GetBounds() GetBounds() GetBounds() GetBounds()

Recupera el tamaño de la región del diseñador en la superficie de diseño.Retrieves the size of the designer region on 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 host de diseño identificado por el tipo proporcionado.Gets a service from the design host, as identified by the provided type.

(Inherited from DesignerObject)
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)
ToString() ToString() ToString() ToString()

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

(Inherited from Object)

Implementaciones de interfaz explícitas

IServiceProvider.GetService(Type) IServiceProvider.GetService(Type) IServiceProvider.GetService(Type) IServiceProvider.GetService(Type)

Para una descripción de este miembro, vea GetService(Type).For a description of this member, see GetService(Type).

(Inherited from DesignerObject)

Se aplica a

Consulte también: