PanelContainerDesigner Classe

Definição

Espaço de Nomes:: System.Web.UI.Design.WebControls

Assemblagem:: System.Design.dll

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.

Fornece suporte em tempo de design num designer visual para o Panel controlo.

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: Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

ContainerControlDesigner
PanelContainerDesigner

Exemplos

O exemplo de código seguinte mostra como estender a PanelContainerDesigner classe para alterar a aparência e o comportamento dos controlos derivados do Panel controlo no momento do design.

O exemplo deriva a MyPanelContainer classe a partir do Panel controlo. O exemplo também deriva a MyPanelContainerDesigner classe a partir da PanelContainerDesigner classe e aplica um DesignerAttribute atributo para o MyPanelContainerDesigner na MyPanelContainer classe.

Sobrepõe-se MyPanelContainerDesigner aos seguintes PanelContainerDesigner membros:

A FrameStyle propriedade para definir um estilo de borda em tempo de design para o MyPanelContainer controlo.
A FrameCaption propriedade para fornecer uma legenda padrão para o MyPanelContainer controlo, caso não existisse, foi definida.
O Initialize método para lançar uma ArgumentException exceção, se o controlo 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

Observações

O Panel controlo é usado como contentor para outros controlos, especialmente quando os controlos são gerados programaticamente.

Num designer visual, quando se muda da vista Source para a vista Design, o código-fonte de marcação que descreve o controlo associado Panel é analisado, e uma versão em tempo de design do controlo é criada na superfície de design. Quando volta para a vista Fonte, o controlo de tempo de design é mantido para marcar o código-fonte e ser editado na marcação da página Web. A PanelContainerDesigner classe fornece suporte em tempo de design para Panel controlos num designer visual.

A FrameCaption propriedade recebe a legenda que aparece no controlo associado Panel . A FrameStyle propriedade recebe os estilos do controlo associado.

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

O Initialize método prepara o designer para visualizar, editar e desenhar o controlo associado Panel . O AddDesignTimeCssAttributes método define elementos de coleção para as representações das strings de vários atributos de estilo do controlo associado.

Construtores

Name	Description
PanelContainerDesigner()	Inicializa uma nova instância da PanelContainerDesigner classe.

Propriedades

Name	Description
ActionLists	Obtém a coleção da lista de ações para o designer de controlos. (Herdado de ControlDesigner)
AllowResize	Recebe um valor que indica se o controlo pode ser redimensionado no momento do projeto. (Herdado de ContainerControlDesigner)
AssociatedComponents	Obtém a coleção de componentes associados ao componente gerida pelo designer. (Herdado de ComponentDesigner)
AutoFormats	Obtém a coleção de esquemas automáticos de formatação pré-definidos para ser exibida na caixa de diálogo Formato Automático para o controlo associado no momento do design. (Herdado de ControlDesigner)
Behavior	Obsoleto. Obtém ou define o comportamento DHTML associado ao designer. (Herdado de HtmlControlDesigner)
Component	Recebe o componente que este designer está a desenhar. (Herdado de ComponentDesigner)
DataBindings	Obtém a recolha de ligações de dados para o controlo atual. (Herdado de HtmlControlDesigner)
DataBindingsEnabled	Obtém um valor que indica se a ligação de dados é suportada pela região que contém o controlo associado. (Herdado de ControlDesigner)
DesignerState	Obtém um objeto que é usado para persistir dados para o controlo associado no momento do projeto. (Herdado de ControlDesigner)
DesignTimeElement	Obsoleto. Obtém o objeto em tempo de design que representa o controlo associado ao HtmlControlDesigner objeto na superfície de projeto. (Herdado de HtmlControlDesigner)
DesignTimeElementView	Obsoleto. Obtém o objeto de view-control para o designer de controlo. (Herdado de ControlDesigner)
DesignTimeHtmlRequiresLoadComplete	Obsoleto. Recebe um valor que indica se o host de design deve terminar o carregamento antes de o GetDesignTimeHtml método poder ser chamado. (Herdado de ControlDesigner)
Expressions	Obtém as associações de expressão para o controlo atual no momento do projeto. (Herdado de HtmlControlDesigner)
FrameCaption	Recebe a legenda que aparece no controlo associado Panel .
FrameStyle	Obtém os estilos do controlo associado Panel .
HidePropertiesInTemplateMode	Recebe um valor que indica se as propriedades do controlo associado estão ocultas quando o controlo está em modo template. (Herdado de ControlDesigner)
ID	Recebe ou define a cadeia ID do controlo. (Herdado de ControlDesigner)
InheritanceAttribute	Obtém um atributo que indica o tipo de herança do componente associado. (Herdado de ComponentDesigner)
Inherited	Recebe um valor que indica se este componente é herdado. (Herdado de ComponentDesigner)
InTemplateMode	Recebe um valor que indica se o controlo está em modo visualização de templates ou edição no host de design. A InTemplateMode propriedade é apenas de leitura. (Herdado de ControlDesigner)
IsDirty	Obsoleto. Recebe ou define um valor que indica se o controlo do servidor Web foi marcado como alterado. (Herdado de ControlDesigner)
NoWrap	Recebe um valor que especifica se deve usar o atributo HTML `nowrap` nas tabelas. (Herdado de ContainerControlDesigner)
ParentComponent	Obtém o componente pai para este designer. (Herdado de ComponentDesigner)
ReadOnly	Obsoleto. Recebe ou define um valor que indica se as propriedades do controlo são apenas leitura no momento do projeto. (Herdado de ControlDesigner)
RootDesigner	Obtém o designer de controlos para a página Web Forms que contém o controlo associado. (Herdado de ControlDesigner)
ShadowProperties	Obtém uma coleção de valores de propriedades que sobrepõem as definições do utilizador. (Herdado de ComponentDesigner)
ShouldCodeSerialize	Obsoleto. Recebe ou define um valor que indica se deve criar uma declaração de campo para o controlo no ficheiro 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 controlo associado. (Herdado de ControlDesigner)
TemplateGroups	Obtém uma coleção de grupos de modelos, cada um contendo uma ou mais definições de modelos. (Herdado de ControlDesigner)
UsePreviewControl	Recebe um valor que indica se o designer deve usar uma cópia temporária em vez do controlo real associado ao designer para gerar a marcação de tempo de design.
Verbs	Obtém os verbos em tempo de design suportados pelo componente associado ao designer. (Herdado de ComponentDesigner)
ViewControl	Obtém ou define um controlo de servidor Web que pode ser usado para pré-visualizar a marcação HTML em tempo de design. (Herdado de ControlDesigner)
ViewControlCreated	Recebe ou define um valor que indica se foi criado um `View` controlo para exibição na superfície de design. (Herdado de ControlDesigner)
Visible	Obtém um valor que indica se o controlo é visível no momento do projeto. (Herdado de ControlDesigner)

Métodos

Name	Description
AddDesignTimeCssAttributes(IDictionary)	Adiciona representações de string de atributos de estilo a uma coleção para serem usadas na renderização do controlo em tempo de design.
CreateErrorDesignTimeHtml(String, Exception)	Cria a marcação HTML para mostrar uma mensagem de erro de exceção especificada no momento do design. (Herdado de ControlDesigner)
CreateErrorDesignTimeHtml(String)	Cria marcação HTML para mostrar uma mensagem de erro especificada no momento do design. (Herdado de ControlDesigner)
CreatePlaceHolderDesignTimeHtml()	Fornece uma representação simples retangular que mostra o tipo e o ID do controlo. (Herdado de ControlDesigner)
CreatePlaceHolderDesignTimeHtml(String)	Fornece uma representação simples retangular que mostra o tipo e o ID do controlo, bem como instruções ou informações adicionais especificadas. (Herdado de ControlDesigner)
CreateViewControl()	Devolve uma cópia do controlo associado para visualização ou renderização na superfície de design. (Herdado de ControlDesigner)
Dispose()	Liberta todos os recursos utilizados pelo ComponentDesigner. (Herdado de ComponentDesigner)
Dispose(Boolean)	Liberta os recursos não geridos que são usados pelo HtmlControlDesigner objeto e, opcionalmente, liberta os recursos geridos. (Herdado de HtmlControlDesigner)
DoDefaultAction()	Cria uma assinatura de método no ficheiro de código-fonte para o evento predefinido no componente e navega pelo cursor do utilizador até essa localização. (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 representam os limites do controlo conforme exibido na superfície de design. (Herdado de ControlDesigner)
GetDesignTimeCssAttributes()	Devolve a coleção de atributos de estilo para o controlo no momento do design. (Herdado de ContainerControlDesigner)
GetDesignTimeHtml()	Recupera a marcação HTML que é usada para representar o controlo no momento do design. (Herdado de ControlDesigner)
GetDesignTimeHtml(DesignerRegionCollection)	Devolve a marcação HTML que é usada para representar o controlo no momento do design. (Herdado de ContainerControlDesigner)
GetEditableDesignerRegionContent(EditableDesignerRegion)	Devolve o conteúdo para a região editável do controlo no momento do design. (Herdado de ContainerControlDesigner)
GetEmptyDesignTimeHtml()	Recupera a marcação HTML para representar um controlo 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 função de hash predefinida. (Herdado de Object)
GetPersistenceContent()	Devolve o conteúdo persistente do controlo no momento do projeto. (Herdado de ContainerControlDesigner)
GetPersistInnerHtml()	Obsoleto. Recupera a marcação HTML interna persistente do controlo. (Herdado de ControlDesigner)
GetService(Type)	Tenta recuperar o tipo de serviço especificado a partir do local do modo de design do componente do projetista. (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 em tempo de design para o conteúdo e regiões do controlo associado. (Herdado de ControlDesigner)
Initialize(IComponent)	Prepara o designer para visualizar, editar e desenhar o controlo associado.
InitializeExistingComponent(IDictionary)	Reinicializa um componente existente. (Herdado de ComponentDesigner)
InitializeNewComponent(IDictionary)	Inicializa um componente recém-criado. (Herdado de ComponentDesigner)
InitializeNonDefault()	Obsoleto. Inicializa as definições de um componente importado que já está inicializado para definições diferentes das predefinidas. (Herdado de ComponentDesigner)
Invalidate()	Invalida toda a área do controlo que é exibida na superfície de projeto e sinaliza ao projetista do controlo para redesenhar o controlo. (Herdado de ControlDesigner)
Invalidate(Rectangle)	Invalida a área especificada do controlo que é exibida na superfície de design e sinaliza ao projetista do controlo para redesenhar o controlo. (Herdado de ControlDesigner)
InvokeGetInheritanceAttribute(ComponentDesigner)	Obtém o InheritanceAttribute do especificado ComponentDesigner. (Herdado de ComponentDesigner)
IsPropertyBound(String)	Obsoleto. Recupera um valor que indica se a propriedade especificada no controlo associado está ligada a dados. (Herdado de ControlDesigner)
Localize(IDesignTimeResourceWriter)	Utiliza o escritor de recursos fornecido para persistir as propriedades localizáveis do controlo associado a um recurso no host de design. (Herdado de ControlDesigner)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
OnAutoFormatApplied(DesignerAutoFormat)	Chamado quando um esquema de formatação automático pré-definido foi aplicado ao controlo associado. (Herdado de ControlDesigner)
OnBehaviorDetaching()	Obsoleto. Chamada quando um comportamento se dissocia do elemento. (Herdado de HtmlControlDesigner)
OnBindingsCollectionChanged(String)	Obsoleto. Chamada quando a coleção de ligação de dados muda. (Herdado de ControlDesigner)
OnClick(DesignerRegionMouseEventArgs)	Chamada pelo anfitrião de design quando o utilizador clica no controlo associado no momento do design. (Herdado de ControlDesigner)
OnComponentChanged(Object, ComponentChangedEventArgs)	Chamada quando o controlo associado muda. (Herdado de ControlDesigner)
OnComponentChanging(Object, ComponentChangingEventArgs)	Representa o método que irá gerir o ComponentChanging evento para o controlo associado. (Herdado de ControlDesigner)
OnControlResize()	Obsoleto. Chamado quando o controlo do servidor Web associado foi redimensionado no host de design em tempo de design. (Herdado de ControlDesigner)
OnPaint(PaintEventArgs)	Chamado quando o projetista de controlo desenha o controlo associado na superfície de projeto, se o CustomPaint valor for `true`. (Herdado de ControlDesigner)
OnSetComponentDefaults()	Obsoleto. Define as propriedades padrão do componente. (Herdado de ComponentDesigner)
OnSetParent()	Proporciona uma forma de realizar processamento adicional quando o controlo associado está associado a um controlo parental. (Herdado de HtmlControlDesigner)
PostFilterAttributes(IDictionary)	Permite a um designer alterar ou remover itens do conjunto de atributos que expõe através de um TypeDescriptor. (Herdado de ComponentDesigner)
PostFilterEvents(IDictionary)	Permite a um designer alterar ou remover itens do conjunto de eventos que expõe através de um TypeDescriptor. (Herdado de ComponentDesigner)
PostFilterProperties(IDictionary)	Permite a um designer alterar ou remover itens do conjunto de propriedades que expõe através de um TypeDescriptor. (Herdado de ComponentDesigner)
PreFilterAttributes(IDictionary)	Permite a um designer adicionar ao conjunto de atributos que expõe através de um TypeDescriptor. (Herdado de ComponentDesigner)
PreFilterEvents(IDictionary)	Define a lista de eventos expostos no momento do design para o TypeDescriptor objeto do componente. (Herdado de HtmlControlDesigner)
PreFilterProperties(IDictionary)	Adiciona propriedades ou remove propriedades da grelha de Propriedades num host de projeto no momento do projeto ou fornece novas propriedades em tempo de projeto que possam corresponder a propriedades no controlo associado. (Herdado de ControlDesigner)
RaiseComponentChanged(MemberDescriptor, Object, Object)	Notifica que IComponentChangeService este componente foi alterado. (Herdado de ComponentDesigner)
RaiseComponentChanging(MemberDescriptor)	Notifica que IComponentChangeService este componente está prestes a ser alterado. (Herdado de ComponentDesigner)
RaiseResizeEvent()	Obsoleto. Eleva o OnControlResize() evento. (Herdado de ControlDesigner)
RegisterClone(Object, Object)	Regista dados internos num controlo clonado. (Herdado de ControlDesigner)
SetEditableDesignerRegionContent(EditableDesignerRegion, String)	Define o conteúdo para a região editável do controlo no momento do design. (Herdado de ContainerControlDesigner)
SetRegionContent(EditableDesignerRegion, String)	Especifica o conteúdo de uma região editável na vista de design time do controlo. (Herdado de ControlDesigner)
SetViewFlags(ViewFlags, Boolean)	Atribui a enumeração bit ViewFlags a bit especificada ao valor da bandeira especificado. (Herdado de ControlDesigner)
ToString()	Devolve uma cadeia que representa o objeto atual. (Herdado de Object)
UpdateDesignTimeHtml()	Atualiza a marcação HTML em tempo de design para o controlo associado do servidor Web chamando o GetDesignTimeHtml método. (Herdado de ControlDesigner)

Implementações de Interface Explícita

Name	Description
IDesignerFilter.PostFilterAttributes(IDictionary)	Para uma descrição deste elemento, veja o PostFilterAttributes(IDictionary) método. (Herdado de ComponentDesigner)
IDesignerFilter.PostFilterEvents(IDictionary)	Para uma descrição deste elemento, veja o PostFilterEvents(IDictionary) método. (Herdado de ComponentDesigner)
IDesignerFilter.PostFilterProperties(IDictionary)	Para uma descrição deste elemento, veja o PostFilterProperties(IDictionary) método. (Herdado de ComponentDesigner)
IDesignerFilter.PreFilterAttributes(IDictionary)	Para uma descrição deste elemento, veja o PreFilterAttributes(IDictionary) método. (Herdado de ComponentDesigner)
IDesignerFilter.PreFilterEvents(IDictionary)	Para uma descrição deste elemento, veja o PreFilterEvents(IDictionary) método. (Herdado de ComponentDesigner)
IDesignerFilter.PreFilterProperties(IDictionary)	Para uma descrição deste elemento, veja o PreFilterProperties(IDictionary) método. (Herdado de ComponentDesigner)
ITreeDesigner.Children	Para uma descrição deste membro, veja a propriedade Children . (Herdado de ComponentDesigner)
ITreeDesigner.Parent	Para uma descrição deste membro, veja a propriedade Parent . (Herdado de ComponentDesigner)

Aplica-se a

Ver também

Comentários

Esta página foi útil?