Compartilhar via


PanelContainerDesigner Classe

Definição

Fornece suporte em tempo de design em um designer visual para o Panel controle.

public ref class PanelContainerDesigner : System::Web::UI::Design::ContainerControlDesigner
public class PanelContainerDesigner : System.Web.UI.Design.ContainerControlDesigner
type PanelContainerDesigner = class
    inherit ContainerControlDesigner
Public Class PanelContainerDesigner
Inherits ContainerControlDesigner
Herança

Exemplos

O exemplo de código a seguir mostra como estender a PanelContainerDesigner classe para alterar a aparência e o comportamento dos controles derivados do Panel controle em tempo de design.

O exemplo deriva a MyPanelContainer classe do Panel controle. O exemplo também deriva a MyPanelContainerDesigner classe da PanelContainerDesigner classe e aplica um DesignerAttribute atributo para a MyPanelContainerDesignerMyPanelContainer classe.

Os MyPanelContainerDesigner substitui os seguintes PanelContainerDesigner membros:

  • A FrameStyle propriedade para definir um estilo de borda de tempo de design para o MyPanelContainer controle.

  • A FrameCaption propriedade para fornecer uma legenda padrão para o MyPanelContainer controle, se nenhuma tiver sido definida.

  • O Initialize método para gerar uma exceção ArgumentException , se o controle associado não for um MyPanelContainer objeto.

using System;
using System.Web;
using System.Web.UI.WebControls;
using System.Web.UI.Design.WebControls;
using System.ComponentModel;
using System.Security.Permissions;

namespace Examples.CS.WebControls.Design
{
    // The MyPanelContainer is a copy of the Panel.
    [AspNetHostingPermission(SecurityAction.Demand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [Designer(typeof(Examples.CS.WebControls.Design.MyPanelContainerDesigner))]
    public class MyPanelContainer : Panel
    {
    } // MyPanelContainer

    // Override members of the PanelContainerDesigner.
    public class MyPanelContainerDesigner : PanelContainerDesigner
    {
        // Provide a design-time caption for the panel.
        public override string FrameCaption 
        {
            get
            {
                // If the FrameCaption is empty, use the panel control ID.
                string localCaption = base.FrameCaption;
                if (localCaption == null || localCaption == "")
                    localCaption = ((Panel)Component).ID.ToString();

                return localCaption;
            }
        } // FrameCaption

        // Provide a design-time border style for the panel.
        public override Style FrameStyle
        {
            get
            {
                Style styleOfFrame = base.FrameStyle;

                // If no border style is defined, define one.
                if (styleOfFrame.BorderStyle == BorderStyle.NotSet ||
                    styleOfFrame.BorderStyle == BorderStyle.None)
                    styleOfFrame.BorderStyle = BorderStyle.Outset;

                return styleOfFrame;
            }
        } // FrameStyle

        // Initialize the designer.
        public override void Initialize(IComponent component)
        {
            // Ensure that only a MyPanelContainer can be created 
            // in this designer.
            if (!(component is MyPanelContainer))
                throw new ArgumentException();
            
            base.Initialize(component);
        } // Initialize
    } // MyPanelContainerDesigner
} // Examples.CS.WebControls.Design
Imports System.Web
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design.WebControls
Imports System.ComponentModel
Imports System.Security.Permissions

Namespace Examples.VB.WebControls.Design

    ' The MyPanelContainer is a copy of the PanelContainer.
    <AspNetHostingPermission(SecurityAction.Demand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <Designer(GetType(Examples.VB.WebControls.Design.MyPanelContainerDesigner))> _
    Public Class MyPanelContainer
        Inherits Panel
    End Class

    ' Override members of the PanelContainerDesigner.
    Public Class MyPanelContainerDesigner
        Inherits PanelContainerDesigner

        ' Provide a design-time caption for the panel.
        Public Overrides ReadOnly Property FrameCaption() As String
            Get
                ' If the FrameCaption is empty, use the panel control ID.
                Dim localCaption As String = MyBase.FrameCaption
                If localCaption Is Nothing Or localCaption = "" Then
                    localCaption = CType(Component, Panel).ID.ToString()
                End If

                Return localCaption
            End Get
        End Property ' FrameCaption

        ' Provide a design-time border style for the panel.
        Public Overrides ReadOnly Property FrameStyle() As Style
            Get
                Dim styleOfFrame As Style = MyBase.FrameStyle

                ' If no border style is defined, define one.
                If (styleOfFrame.BorderStyle = BorderStyle.NotSet Or _
                    styleOfFrame.BorderStyle = BorderStyle.None) Then
                    styleOfFrame.BorderStyle = BorderStyle.Outset
                End If

                Return styleOfFrame
            End Get
        End Property ' FrameStyle

        ' Initialize the designer.
        Public Overrides Sub Initialize(ByVal component As IComponent)

            ' Ensure that only a MyPanelContainer can be created   
            ' in this designer. 
            If Not TypeOf component Is MyPanelContainer Then
                Throw New ArgumentException()
            End If

            MyBase.Initialize(component)

        End Sub
    End Class
End Namespace ' Examples.VB.WebControls.Design

Comentários

O Panel controle é usado como um contêiner para outros controles, especialmente quando os controles são gerados programaticamente.

Em um designer visual, quando você alterna do modo de origem para design, o código-fonte de marcação que descreve o controle associado Panel é analisado e uma versão em tempo de design do controle é criada na superfície de design. Quando você alterna de volta para o modo de exibição de origem, o controle de tempo de design é mantido para marcar o código-fonte e editado na marcação da página da Web. A PanelContainerDesigner classe fornece suporte em tempo de design para Panel controles em um designer visual.

A FrameCaption propriedade obtém a legenda que aparece no controle associado Panel . A FrameStyle propriedade obtém os estilos do controle associado.

A UsePreviewControl propriedade sempre retorna true, indicando que o designer cria uma cópia temporária do associado Panel para gerar a marcação de tempo de design.

O Initialize método prepara o designer para exibir, editar e projetar o controle associado Panel . O AddDesignTimeCssAttributes método define elementos de coleção para as representações de cadeia de caracteres de vários atributos de estilo do controle associado.

Construtores

Nome Description
PanelContainerDesigner()

Inicializa uma nova instância da classe PanelContainerDesigner.

Propriedades

Nome Description
ActionLists

Obtém a coleção de lista de ações do designer de controle.

(Herdado de ControlDesigner)
AllowResize

Obtém um valor que indica se o controle pode ser redimensionado em tempo de design.

(Herdado de ContainerControlDesigner)
AssociatedComponents

Obtém a coleção de componentes associados ao componente gerenciado pelo designer.

(Herdado de ComponentDesigner)
AutoFormats

Obtém a coleção de esquemas de formatação automática predefinidos a serem exibidos na caixa de diálogo Formato Automático para o controle associado em tempo de design.

(Herdado de ControlDesigner)
Behavior
Obsoleto.

Obtém ou define o comportamento DHTML associado ao designer.

(Herdado de HtmlControlDesigner)
Component

Obtém o componente que este designer está projetando.

(Herdado de ComponentDesigner)
DataBindings

Obtém a coleção de associações de dados para o controle atual.

(Herdado de HtmlControlDesigner)
DataBindingsEnabled

Obtém um valor que indica se a associação de dados tem suporte pela região que contém o controle associado.

(Herdado de ControlDesigner)
DesignerState

Obtém um objeto usado para persistir dados para o controle associado em tempo de design.

(Herdado de ControlDesigner)
DesignTimeElement
Obsoleto.

Obtém o objeto de tempo de design que representa o controle associado ao HtmlControlDesigner objeto na superfície de design.

(Herdado de HtmlControlDesigner)
DesignTimeElementView
Obsoleto.

Obtém o objeto de controle de exibição para o designer de controle.

(Herdado de ControlDesigner)
DesignTimeHtmlRequiresLoadComplete
Obsoleto.

Obtém um valor que indica se o host de design deve concluir o carregamento antes que o GetDesignTimeHtml método possa ser chamado.

(Herdado de ControlDesigner)
Expressions

Obtém as associações de expressão para o controle atual em tempo de design.

(Herdado de HtmlControlDesigner)
FrameCaption

Obtém a legenda que aparece no controle associado Panel .

FrameStyle

Obtém os estilos do controle associado Panel .

HidePropertiesInTemplateMode

Obtém um valor que indica se as propriedades do controle associado estão ocultas quando o controle está no modo de modelo.

(Herdado de ControlDesigner)
ID

Obtém ou define a cadeia de caracteres de ID para o controle.

(Herdado de ControlDesigner)
InheritanceAttribute

Obtém um atributo que indica o tipo de herança do componente associado.

(Herdado de ComponentDesigner)
Inherited

Obtém um valor que indica se esse componente é herdado.

(Herdado de ComponentDesigner)
InTemplateMode

Obtém um valor que indica se o controle está no modo de exibição ou edição de modelo no host de design. A InTemplateMode propriedade é somente leitura.

(Herdado de ControlDesigner)
IsDirty
Obsoleto.

Obtém ou define um valor que indica se o controle do servidor Web foi marcado como alterado.

(Herdado de ControlDesigner)
NoWrap

Obtém um valor que especifica se o atributo HTML nowrap deve ser usado em tabelas.

(Herdado de ContainerControlDesigner)
ParentComponent

Obtém o componente pai deste designer.

(Herdado de ComponentDesigner)
ReadOnly
Obsoleto.

Obtém ou define um valor que indica se as propriedades do controle são somente leitura no tempo de design.

(Herdado de ControlDesigner)
RootDesigner

Obtém o designer de controle da página Web Forms que contém o controle associado.

(Herdado de ControlDesigner)
ShadowProperties

Obtém uma coleção de valores de propriedade que substituem as configurações do usuário.

(Herdado de ComponentDesigner)
ShouldCodeSerialize
Obsoleto.

Obtém ou define um valor que indica se uma declaração de campo deve ser criada para o controle no arquivo code-behind do documento de design atual durante a serialização.

(Herdado de HtmlControlDesigner)
Tag

Obtém um objeto que representa o elemento de marcação HTML para o controle associado.

(Herdado de ControlDesigner)
TemplateGroups

Obtém uma coleção de grupos de modelos, cada um contendo uma ou mais definições de modelo.

(Herdado de ControlDesigner)
UsePreviewControl

Obtém um valor que indica se o designer deve usar uma cópia temporária em vez do controle real associado ao designer para gerar a marcação de tempo de design.

Verbs

Obtém os verbos de tempo de design compatíveis com o componente associado ao designer.

(Herdado de ComponentDesigner)
ViewControl

Obtém ou define um controle de servidor Web que pode ser usado para visualizar a marcação HTML em tempo de design.

(Herdado de ControlDesigner)
ViewControlCreated

Obtém ou define um valor que indica se um View controle foi criado para exibição na superfície de design.

(Herdado de ControlDesigner)
Visible

Obtém um valor que indica se o controle está visível no momento do design.

(Herdado de ControlDesigner)

Métodos

Nome Description
AddDesignTimeCssAttributes(IDictionary)

Adiciona representações de cadeia de caracteres de atributos de estilo a uma coleção a ser usada na renderização em tempo de design do controle.

CreateErrorDesignTimeHtml(String, Exception)

Cria a marcação HTML para exibir uma mensagem de erro de exceção especificada em tempo de design.

(Herdado de ControlDesigner)
CreateErrorDesignTimeHtml(String)

Cria a marcação HTML para exibir uma mensagem de erro especificada em tempo de design.

(Herdado de ControlDesigner)
CreatePlaceHolderDesignTimeHtml()

Fornece uma representação simples de espaço reservado retangular que exibe o tipo e a ID do controle.

(Herdado de ControlDesigner)
CreatePlaceHolderDesignTimeHtml(String)

Fornece uma representação simples de espaço reservado retangular que exibe o tipo e a ID do controle e também instruções ou informações especificadas adicionais.

(Herdado de ControlDesigner)
CreateViewControl()

Retorna uma cópia do controle associado para exibição ou renderização na superfície de design.

(Herdado de ControlDesigner)
Dispose()

Libera todos os recursos usados pelo ComponentDesigner.

(Herdado de ComponentDesigner)
Dispose(Boolean)

Libera os recursos não gerenciados que são usados pelo HtmlControlDesigner objeto e, opcionalmente, libera os recursos gerenciados.

(Herdado de HtmlControlDesigner)
DoDefaultAction()

Cria uma assinatura de método no arquivo de código-fonte para o evento padrão no componente e navega o cursor do usuário para esse local.

(Herdado de ComponentDesigner)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetBounds()

Recupera as coordenadas do retângulo que representa os limites do controle, conforme exibido na superfície de design.

(Herdado de ControlDesigner)
GetDesignTimeCssAttributes()

Retorna a coleção de atributos de estilo para o controle em tempo de design.

(Herdado de ContainerControlDesigner)
GetDesignTimeHtml()

Recupera a marcação HTML usada para representar o controle em tempo de design.

(Herdado de ControlDesigner)
GetDesignTimeHtml(DesignerRegionCollection)

Retorna a marcação HTML usada para representar o controle em tempo de design.

(Herdado de ContainerControlDesigner)
GetEditableDesignerRegionContent(EditableDesignerRegion)

Retorna o conteúdo da região editável do controle em tempo de design.

(Herdado de ContainerControlDesigner)
GetEmptyDesignTimeHtml()

Recupera a marcação HTML para representar um controle de servidor Web em tempo de design que não terá representação visual em tempo de execução.

(Herdado de ControlDesigner)
GetErrorDesignTimeHtml(Exception)

Recupera a marcação HTML que fornece informações sobre a exceção especificada.

(Herdado de ControlDesigner)
GetHashCode()

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

(Herdado de Object)
GetPersistenceContent()

Retorna o conteúdo persistente do controle em tempo de design.

(Herdado de ContainerControlDesigner)
GetPersistInnerHtml()
Obsoleto.

Recupera a marcação HTML interna persistente do controle.

(Herdado de ControlDesigner)
GetService(Type)

Tenta recuperar o tipo de serviço especificado do site de modo de design do componente do designer.

(Herdado de ComponentDesigner)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
GetViewRendering()

Recupera um objeto que contém a marcação de tempo de design para o conteúdo e as regiões do controle associado.

(Herdado de ControlDesigner)
Initialize(IComponent)

Prepara o designer para exibir, editar e projetar o controle associado.

InitializeExistingComponent(IDictionary)

Reinicializa um componente existente.

(Herdado de ComponentDesigner)
InitializeNewComponent(IDictionary)

Inicializa um componente recém-criado.

(Herdado de ComponentDesigner)
InitializeNonDefault()
Obsoleto.
Obsoleto.

Inicializa as configurações de um componente importado que já está inicializado em configurações diferentes dos padrões.

(Herdado de ComponentDesigner)
Invalidate()

Invalida toda a área do controle exibida na superfície de design e sinaliza o designer de controle para redesenhar o controle.

(Herdado de ControlDesigner)
Invalidate(Rectangle)

Invalida a área especificada do controle que é exibida na superfície de design e sinaliza o designer de controle para redesenhar o controle.

(Herdado de ControlDesigner)
InvokeGetInheritanceAttribute(ComponentDesigner)

Obtém o InheritanceAttribute da especificada ComponentDesigner.

(Herdado de ComponentDesigner)
IsPropertyBound(String)
Obsoleto.

Recupera um valor que indica se a propriedade especificada no controle associado está associada a dados.

(Herdado de ControlDesigner)
Localize(IDesignTimeResourceWriter)

Usa o gravador de recursos fornecido para manter as propriedades localizáveis do controle associado a um recurso no host de design.

(Herdado de ControlDesigner)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
OnAutoFormatApplied(DesignerAutoFormat)

Chamado quando um esquema de formatação automática predefinido foi aplicado ao controle associado.

(Herdado de ControlDesigner)
OnBehaviorDetaching()
Obsoleto.

Chamado quando um comportamento desassocia do elemento.

(Herdado de HtmlControlDesigner)
OnBindingsCollectionChanged(String)
Obsoleto.

Chamado quando a coleção de associação de dados é alterada.

(Herdado de ControlDesigner)
OnClick(DesignerRegionMouseEventArgs)

Chamado pelo host de design quando o usuário clica no controle associado em tempo de design.

(Herdado de ControlDesigner)
OnComponentChanged(Object, ComponentChangedEventArgs)

Chamado quando o controle associado é alterado.

(Herdado de ControlDesigner)
OnComponentChanging(Object, ComponentChangingEventArgs)

Representa o método que manipulará o ComponentChanging evento para o controle associado.

(Herdado de ControlDesigner)
OnControlResize()
Obsoleto.

Chamado quando o controle de servidor Web associado foi redimensionado no host de design em tempo de design.

(Herdado de ControlDesigner)
OnPaint(PaintEventArgs)

Chamado quando o designer de controle desenha o controle associado na superfície de design, se o CustomPaint valor for true.

(Herdado de ControlDesigner)
OnSetComponentDefaults()
Obsoleto.
Obsoleto.

Define as propriedades padrão do componente.

(Herdado de ComponentDesigner)
OnSetParent()

Fornece uma maneira de executar processamento adicional quando o controle associado é anexado a um controle pai.

(Herdado de HtmlControlDesigner)
PostFilterAttributes(IDictionary)

Permite que um designer altere ou remova itens do conjunto de atributos que ele expõe por meio de um TypeDescriptor.

(Herdado de ComponentDesigner)
PostFilterEvents(IDictionary)

Permite que um designer altere ou remova itens do conjunto de eventos que ele expõe por meio de um TypeDescriptor.

(Herdado de ComponentDesigner)
PostFilterProperties(IDictionary)

Permite que um designer altere ou remova itens do conjunto de propriedades que ele expõe por meio de um TypeDescriptor.

(Herdado de ComponentDesigner)
PreFilterAttributes(IDictionary)

Permite que um designer adicione ao conjunto de atributos que ele expõe por meio de um TypeDescriptor.

(Herdado de ComponentDesigner)
PreFilterEvents(IDictionary)

Define a lista de eventos expostos em tempo de design para o TypeDescriptor objeto do componente.

(Herdado de HtmlControlDesigner)
PreFilterProperties(IDictionary)

Adiciona ou remove propriedades da grade Propriedades em um host de design em tempo de design ou fornece novas propriedades de tempo de design que podem corresponder às propriedades no controle associado.

(Herdado de ControlDesigner)
RaiseComponentChanged(MemberDescriptor, Object, Object)

Notifica que IComponentChangeService esse componente foi alterado.

(Herdado de ComponentDesigner)
RaiseComponentChanging(MemberDescriptor)

Notifica que IComponentChangeService esse componente está prestes a ser alterado.

(Herdado de ComponentDesigner)
RaiseResizeEvent()
Obsoleto.

Aciona o evento OnControlResize().

(Herdado de ControlDesigner)
RegisterClone(Object, Object)

Registra dados internos em um controle clonado.

(Herdado de ControlDesigner)
SetEditableDesignerRegionContent(EditableDesignerRegion, String)

Define o conteúdo da região editável do controle em tempo de design.

(Herdado de ContainerControlDesigner)
SetRegionContent(EditableDesignerRegion, String)

Especifica o conteúdo de uma região editável no modo de exibição de tempo de design do controle.

(Herdado de ControlDesigner)
SetViewFlags(ViewFlags, Boolean)

Atribui a enumeração bit a ViewFlags bit especificada ao valor do sinalizador especificado.

(Herdado de ControlDesigner)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)
UpdateDesignTimeHtml()

Atualiza a marcação HTML em tempo de design para o controle de servidor Web associado chamando o GetDesignTimeHtml método.

(Herdado de ControlDesigner)

Implantações explícitas de interface

Nome Description
IDesignerFilter.PostFilterAttributes(IDictionary)

Para obter uma descrição desse membro, consulte o PostFilterAttributes(IDictionary) método.

(Herdado de ComponentDesigner)
IDesignerFilter.PostFilterEvents(IDictionary)

Para obter uma descrição desse membro, consulte o PostFilterEvents(IDictionary) método.

(Herdado de ComponentDesigner)
IDesignerFilter.PostFilterProperties(IDictionary)

Para obter uma descrição desse membro, consulte o PostFilterProperties(IDictionary) método.

(Herdado de ComponentDesigner)
IDesignerFilter.PreFilterAttributes(IDictionary)

Para obter uma descrição desse membro, consulte o PreFilterAttributes(IDictionary) método.

(Herdado de ComponentDesigner)
IDesignerFilter.PreFilterEvents(IDictionary)

Para obter uma descrição desse membro, consulte o PreFilterEvents(IDictionary) método.

(Herdado de ComponentDesigner)
IDesignerFilter.PreFilterProperties(IDictionary)

Para obter uma descrição desse membro, consulte o PreFilterProperties(IDictionary) método.

(Herdado de ComponentDesigner)
ITreeDesigner.Children

Para obter uma descrição desse membro, consulte a Children propriedade.

(Herdado de ComponentDesigner)
ITreeDesigner.Parent

Para obter uma descrição desse membro, consulte a Parent propriedade.

(Herdado de ComponentDesigner)

Aplica-se a

Confira também