DesignerRegion Clase

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.Design
Ensamblado:
System.Design.dll

Define una región de contenido dentro del marcado en tiempo de diseño para el control asociado.

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
Object
DesignerObject
DesignerRegion
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. Un desarrollador de controles usa regiones de diseñador en una implementación personalizada ControlDesigner para definir áreas independientes dentro del marcado en tiempo de diseño para el control asociado y para proporcionar edición y control de eventos para el área. Un diseñador visual, como Visual Studio 2005, puede usar regiones del diseñador para mostrar las áreas independientes de un control en la superficie de diseño y generar eventos de usuario para la región en el diseñador de controles. Las regiones del diseñador pueden simplificar una implementación del diseñador de controles porque muchas características basadas en regiones las proporcionan las clases de diseñador base y el diseñador visual.

La DesignerRegion clase proporciona la funcionalidad base para las regiones del diseñador, como la capacidad de hacer clic, seleccionar y resaltar una región en la superficie de diseño. Use un objeto en una DesignerRegion implementación del diseñador de controles para definir una región que no requiera edición. Use la clase derivada EditableDesignerRegion en una implementación del diseñador de controles para definir una región con contenido editable en tiempo de diseño. Use la clase derivada TemplatedEditableDesignerRegion en una implementación del diseñador de controles para definir una región editable que represente una plantilla en un control.

Para admitir regiones dentro de una clase derivada de ControlDesigner, invalide el GetDesignTimeHtml método y agregue uno o varios objetos inicializados DesignerRegion a la DesignerRegionCollection colección. Opcionalmente, puede controlar los clics del mouse en las regiones de la superficie de diseño reemplazando el OnClick método .

Use las propiedades de un DesignerRegion objeto para determinar cómo el diseñador visual muestra la región. Invalide la Selectable propiedad para indicar que el usuario puede seleccionar la región en la superficie de diseño. Utilice 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 haya clic en ella para seleccionarla. Use las DisplayName propiedades y Description para almacenar o recuperar detalles adicionales sobre la región. En concreto, el diseñador visual usa la Description propiedad para mostrar información sobre herramientas cuando el usuario mueve el puntero del mouse sobre la región del diseñador. 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.

Constructores

DesignerRegion(ControlDesigner, String)

Inicializa una nueva instancia de la clase DesignerRegion con el nombre especificado para un diseñador de controles.
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.

Campos

DesignerRegionAttributeName

Define el nombre del atributo HTML de una región del diseñador.

Propiedades

Description

Obtiene o establece la descripción de una región del diseñador.
Designer

Obtiene el componente del diseñador asociado.

(Heredado de DesignerObject)
DisplayName

Obtiene o establece el nombre descriptivo que se va a mostrar de una región del diseñador.
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.
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.
Name

Obtiene el nombre del objeto.

(Heredado de DesignerObject)
Properties

Obtiene las propiedades del objeto.

(Heredado de DesignerObject)
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.
Selected

Obtiene o establece un valor que indica si la región del diseñador está actualmente seleccionada en la superficie de diseño.
UserData

Obtiene o establece datos de usuario opcionales que se van a asociar a la región del diseñador.

Métodos

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetBounds()

Recupera el tamaño de la región del diseñador en la superficie de diseño.
GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetService(Type)

Obtiene un servicio del host de diseño identificado por el tipo proporcionado.

(Heredado de DesignerObject)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Implementaciones de interfaz explícitas

IServiceProvider.GetService(Type)

Para obtener una descripción de este miembro, vea GetService(Type).

(Heredado de DesignerObject)

Se aplica a

Consulte también