DesignerRegion Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Define uma região de conteúdo dentro da marcação de tempo de design para o controlo 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
Observações
O DesignerRegion objeto representa uma região de conteúdo dentro da marcação em tempo de design gerada por uma ControlDesigner implementação. Um programador de controlo utiliza regiões projetadas numa implementação personalizada ControlDesigner para definir áreas separadas dentro da marcação em tempo de design para o controlo associado e para fornecer edição e gestão de eventos para a área. Um designer visual, como o Visual Studio 2005, pode usar regiões de designer para mostrar as áreas separadas de um controlo na superfície de design e para elevar eventos de utilizador para a região ao designer de controlo. As regiões de designer podem simplificar a implementação de um designer de controlo porque muitas funcionalidades baseadas em regiões são fornecidas pelas classes de designer base e pelo designer visual.
A DesignerRegion classe fornece a funcionalidade base para regiões do designer, como a capacidade de clicar, selecionar e destacar uma região na superfície do design. Use um DesignerRegion objeto numa implementação de design de controlos para definir uma região que não exija edição. Use a classe derivada EditableDesignerRegion numa implementação de design de controlo para definir uma região com conteúdo editável no momento do design. Use a classe derivada TemplatedEditableDesignerRegion numa implementação de design de controlos para definir uma região editável que represente um template num controlo.
Para suportar regiões dentro de uma classe que é derivada da ControlDesigner, sobrescrita o GetDesignTimeHtml método e adiciona um ou mais objetos inicializados DesignerRegion à DesignerRegionCollection coleção. Opcionalmente, pode gerir cliques do rato nas regiões da superfície de design ao sobrescrever o OnClick método.
Use as propriedades de um DesignerRegion objeto para determinar como a região é apresentada pelo designer visual. Substitua a Selectable propriedade para indicar que a região pode ser selecionada pelo utilizador na superfície de design. Use a Highlight propriedade para destacar a região do designer no designer visual; por exemplo, pode destacar uma região depois de um utilizador clicar para a selecionar. 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 mostrar informação do ToolTip quando o utilizador move o ponteiro do rato sobre a região do designer. Use a Designer propriedade para aceder aos métodos e propriedades do objeto designer de controlo que contém a região designer.
Construtores
| Name | Description |
|---|---|
| DesignerRegion(ControlDesigner, String, Boolean) |
Inicializa uma nova instância da DesignerRegion classe com o nome especificado para um designer de controlos, 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 controlo. |
Campos
| Name | Description |
|---|---|
| DesignerRegionAttributeName |
Define o nome do atributo HTML para uma região designer. |
Propriedades
| Name | Description |
|---|---|
| Description |
Obtém ou define a descrição de uma região de designer. |
| Designer |
Recebe 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 |
Recebe ou define um valor que indica se o tamanho da região deve ser explicitamente definido na região projetista pelo anfitrião de design. |
| Highlight |
Recebe ou define um valor que indica se deve destacar a região projetista 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 |
Recebe ou define um valor que indica se a região projetista pode ser selecionada pelo utilizador na superfície de design. |
| Selected |
Recebe ou define um valor que indica se a região projetista está atualmente selecionada na superfície de design. |
| UserData |
Obtém ou define dados opcionais do utilizador para associar à região do designer. |
Métodos
| Name | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetBounds() |
Recupera o tamanho da região projetista na superfície de design. |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetService(Type) |
Recebe 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 atual Object. (Herdado de Object) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
Implementações de Interface Explícita
| Name | Description |
|---|---|
| IServiceProvider.GetService(Type) |
Para uma descrição deste elemento, veja GetService(Type). (Herdado de DesignerObject) |
