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 un ControlDesigner implementación.The DesignerRegion object represents a region of content within the design-time markup that is generated by a ControlDesigner implementation. Un desarrollador del control utiliza regiones del diseñador en un personalizado ControlDesigner implementación para definir distintas áreas dentro del marcado en tiempo de diseño para el control asociado y para proporcionar control de eventos para el área y de edición.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 objeto visual diseñador, como Visual Studio 2005Visual Studio 2005, puede usar las regiones del diseñador para mostrar distintas áreas de un control en la superficie de diseño y para generar eventos de usuario para una 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 una implementación del Diseñador de control porque muchas características basadas en regiones son proporcionadas por las clases de diseñador bases y el diseñador visual.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 regiones del diseñador, como la capacidad de hacer clic en, seleccione y resaltan 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 control 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 derivada EditableDesignerRegion clase en una implementación del Diseñador de control 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 derivada TemplatedEditableDesignerRegion clase en una implementación del Diseñador de control para definir una región editable que representa 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 las regiones dentro de una clase que se deriva el ControlDesigner, invalidar el GetDesignTimeHtml método y agregue uno o más inicializan DesignerRegion objetos a la DesignerRegionCollection 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. Si lo desea, puede controlar los clics del mouse en las regiones en la superficie de diseño reemplazando el OnClick método.Optionally, you can handle mouse clicks in the regions on the design surface by overriding the OnClick method.

Utilice las propiedades de un DesignerRegion para determinar cómo se muestra la región del diseñador visual.Use the properties of a DesignerRegion object to determine how the region is displayed by the visual designer. Invalidar el Selectable propiedad para indicar que se puede seleccionar la región por el usuario 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 el 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 haya hecho clic en él para seleccionarlo.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. Use la DisplayName y Description propiedades para almacenar o recuperar detalles adicionales acerca de la región.Use the DisplayName and Description properties to store or retrieve additional details about the region. En concreto, el Description propiedad se utiliza el diseñador visual 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. Use el Designer propiedad para tener acceso a los métodos y propiedades de los objetos del Diseñador de control 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 obtener 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: