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 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 exija edição. Use a classe derivada EditableDesignerRegion em uma implementação do 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 dentro de uma classe derivada do ControlDesignermétodo, 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 da 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
| Nome | Description |
|---|---|
| DesignerRegion(ControlDesigner, String, Boolean) |
Inicializa uma nova instância da DesignerRegion classe com o nome especificado para um designer de controle, opcionalmente definindo a instância como uma região selecionável no designer. |
| DesignerRegion(ControlDesigner, String) |
Inicializa uma nova instância da DesignerRegion classe com o nome especificado para um designer de controle. |
Campos
| Nome | Description |
|---|---|
| DesignerRegionAttributeName |
Define o nome do atributo HTML para uma região do designer. |
Propriedades
| Nome | Description |
|---|---|
| Description |
Obtém ou define a descrição de uma região do designer. |
| Designer |
Obtém o componente de designer associado. (Herdado de DesignerObject) |
| DisplayName |
Obtém ou define o nome de exibição amigável 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 do designer pelo host de design. |
| Highlight |
Obtém ou define um valor que indica se a região do 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 do 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 do designer está selecionada atualmente na superfície de design. |
| UserData |
Obtém ou define dados opcionais do usuário a serem associados à região do designer. |
Métodos
| Nome | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetBounds() |
Recupera o tamanho da região do 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 do 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 Objectatual. (Herdado de Object) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
Implantações explícitas de interface
| Nome | Description |
|---|---|
| IServiceProvider.GetService(Type) |
Para obter uma descrição deste membro, consulte GetService(Type). (Herdado de DesignerObject) |
