DesignerRegion Classe

Definição

Define uma região de conteúdo dentro da marcação de tempo de design para o controle associado.

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
Herança
DesignerRegion
Derivado

Comentários

O DesignerRegion objeto representa uma região de conteúdo dentro da marcação de tempo de design gerada por uma ControlDesigner implementação. Um desenvolvedor de controle usa regiões de designer em uma implementação personalizada ControlDesigner para definir áreas separadas dentro da marcação de tempo de design para o controle associado e para fornecer edição e manipulação de eventos para a área. Um designer visual, como o Visual Studio 2005, pode usar regiões de designer para exibir as áreas separadas de um controle na superfície de design e gerar eventos de usuário para a região para o designer de controle. As regiões do designer podem simplificar uma implementação do designer de controle porque muitos recursos baseados em região são fornecidos pelas classes de designer base e pelo designer visual.

A DesignerRegion classe fornece a funcionalidade base para regiões de designer, como a capacidade de clicar, selecionar e realçar uma região na superfície de design. Use um DesignerRegion objeto em uma implementação de designer de controle para definir uma região que não requer edição. Use a classe derivada EditableDesignerRegion em uma implementação de designer de controle para definir uma região com conteúdo editável em tempo de design. Use a classe derivada TemplatedEditableDesignerRegion em uma implementação de designer de controle para definir uma região editável que representa um modelo em um controle.

Para dar suporte a regiões em uma classe derivada do ControlDesigner, substitua o GetDesignTimeHtml método e adicione um ou mais objetos inicializados DesignerRegion à DesignerRegionCollection coleção. Opcionalmente, você pode lidar com cliques de mouse nas regiões na superfície de design substituindo o OnClick método .

Use as propriedades de um DesignerRegion objeto para determinar como a região é exibida pelo designer visual. Substitua a Selectable propriedade para indicar que a região pode ser selecionada pelo usuário na superfície de design. Use a Highlight propriedade para realçar a região do designer no designer visual; por exemplo, você pode realçar uma região depois que um usuário clicar para selecioná-la. Use as DisplayName propriedades e Description para armazenar ou recuperar detalhes adicionais sobre a região. Em particular, a Description propriedade é usada pelo designer visual para exibir informações de Dica de Ferramenta quando o usuário move o ponteiro do mouse sobre a região do designer. Use a Designer propriedade para acessar os métodos e as propriedades do objeto do designer de controle que contém a região do designer.

Construtores

DesignerRegion(ControlDesigner, String)

Inicializa uma nova instância da classe DesignerRegion com o nome especificado para um designer de controle.

DesignerRegion(ControlDesigner, String, Boolean)

Inicializa uma nova instância da classe DesignerRegion com o nome especificado para um designer de controle, configurando opcionalmente a instância como uma região selecionável no designer.

Campos

DesignerRegionAttributeName

Define o nome do atributo HTML para uma região de designer.

Propriedades

Description

Obtém ou define a descrição para uma região de designer.

Designer

Obtém o componente de designer associado.

(Herdado de DesignerObject)
DisplayName

Obtém ou define o nome de exibição para uma região de designer.

EnsureSize

Obtém ou define um valor que indica se o tamanho da região deve ser definido explicitamente na região de designer pelo host de design.

Highlight

Obtém ou define um valor que indica se a região de designer deve ser realçada na superfície de design.

Name

Obtém o nome do objeto.

(Herdado de DesignerObject)
Properties

Obtém as propriedades do objeto.

(Herdado de DesignerObject)
Selectable

Obtém ou define um valor que indica se a região de designer pode ser selecionada pelo usuário na superfície de design.

Selected

Obtém ou define um valor que indica se a região de designer está atualmente selecionada na superfície de design.

UserData

Obtém ou define os dados de usuário opcionais a serem associados com a região de designer.

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetBounds()

Recupera o tamanho da região de designer na superfície de design.

GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetService(Type)

Obtém um serviço de host de design, conforme identificado pelo tipo fornecido.

(Herdado de DesignerObject)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Implantações explícitas de interface

IServiceProvider.GetService(Type)

Para obter uma descrição desse membro, confira GetService(Type).

(Herdado de DesignerObject)

Aplica-se a

Confira também