DesignerRegion Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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::DesignerObjectpublic class DesignerRegion : System.Web.UI.Design.DesignerObjecttype DesignerRegion = class
inherit DesignerObjectPublic Class DesignerRegion
Inherits DesignerObject- Herança
- 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 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) |
