ContainerControlDesigner Třída

Reference

Definice

Obor názvů:: System.Web.UI.Design

Sestavení:: System.Design.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Poskytuje funkce návrháře pro ovládací prvky, které obsahují podřízené ovládací prvky nebo vlastnosti, které lze upravit v době návrhu.

public ref class ContainerControlDesigner : System::Web::UI::Design::ControlDesigner

public class ContainerControlDesigner : System.Web.UI.Design.ControlDesigner

type ContainerControlDesigner = class
    inherit ControlDesigner

Public Class ContainerControlDesigner
Inherits ControlDesigner

Dědičnost: Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner
ContainerControlDesigner

Odvozené: System.Web.UI.Design.WebControls.MultiViewDesigner

System.Web.UI.Design.WebControls.PanelContainerDesigner

System.Web.UI.Design.WebControls.ViewDesigner

Příklady

Následující příklad kódu ukazuje, jak odvodit třídu návrháře ContainerControlDesigner z třídy. Příklad definuje jednoduchý ovládací prvek, který je odvozen od CompositeControl třídy, a pak definuje přidruženého návrháře, který je odvozen z ContainerControlDesigner třídy. Odvozená třída návrháře přepíše FrameCaption vlastnosti a FrameStyle pro přizpůsobení rámečku, který je kolem upravitelné oblasti ovládacího prvku na návrhové ploše.

using System;
using System.ComponentModel;
using System.ComponentModel.Design;
using System.Drawing;
using System.Web.UI;
using System.Web.UI.Design;
using System.Web.UI.Design.WebControls;
using System.Web.UI.WebControls;

namespace ControlDesignerSamples.CS
{

    // Define a simple composite control, derived from the 
    // System.Web.UI.WebControls.CompositeControl class.
    [
        Designer(typeof(SimpleContainerControlDesigner)) , 
        ParseChildren(false)
    ]
    public class SimpleContainerControl : CompositeControl
    {
    }


    // Define the designer for the simple composite control.
    // The designer derives from System.Web.UI.Design.ContainerControlDesigner.
    // The designer defines the style and caption for frame around the 
    // editable region in the design surface.
    public class SimpleContainerControlDesigner : ContainerControlDesigner
    {
        private Style _style = null;

        // Define the caption text for the frame in the design surface.
        public override string FrameCaption
        {
            get
            {
                return "= My simple container control =";
            }
        }

        // Define the style of the frame around the control in the design surface.
        public override Style FrameStyle
        {
            get
            {
                if (_style == null)
                {
                    _style = new Style();
                    _style.Font.Name = "Verdana";
                    _style.Font.Size = new FontUnit("XSmall");
                    _style.BackColor = Color.LavenderBlush;
                    _style.ForeColor = Color.DarkBlue;
                }

                return _style;
            }
        }
    }
}


Imports System.ComponentModel
Imports System.ComponentModel.Design
Imports System.Collections
Imports System.Drawing
Imports System.Web.UI
Imports System.Web.UI.Design
Imports System.Web.UI.Design.WebControls
Imports System.Web.UI.WebControls

Namespace ControlDesignerSamples.VB


    ' Define a simple composite control, derived from the 
    ' System.Web.UI.WebControls.CompositeControl class.

    <Designer(GetType(SimpleContainerControlDesigner)), _
     ParseChildren(False)> _
    Public Class SimpleContainerControl
        Inherits CompositeControl

    End Class


    ' Define the designer for the simple composite control.
    ' The designer derives from System.Web.UI.Design.ContainerControlDesigner.
    ' The designer defines the style and caption for the frame around the 
    ' editable region of the control in the design surface.
    Public Class SimpleContainerControlDesigner
        Inherits ContainerControlDesigner

        Private _style As Style = Nothing

        ' Define the caption text for the frame in the design surface.
        Public Overrides ReadOnly Property FrameCaption() As String
            Get
                Return "- My simple container control -"
            End Get
        End Property


        ' Define the style of the frame around the control in the design surface.
        Public Overrides ReadOnly Property FrameStyle() As Style
            Get
                If _style Is Nothing Then

                    _style = New Style()
                    _style.Font.Name = "Verdana"
                    _style.Font.Size = New FontUnit("XSmall")
                    _style.BackColor = Color.LavenderBlush
                    _style.ForeColor = Color.DarkBlue
                End If

                Return _style
            End Get
        End Property


    End Class

End Namespace

Poznámky

Třída ContainerControlDesigner poskytuje základní třídu návrháře pro ovládací prvky, které lze upravit na návrhové ploše. To zahrnuje ovládací prvky, které obsahují podřízené ovládací prvky nebo upravitelné vnitřní vlastnosti. Poskytuje ContainerControlDesigner jednu zarámovanou oblast, která představuje ovládací prvek, a automaticky zpracovává vykreslování ovládacího prvku v době návrhu.

Použití atributu ParseChildrenAttribute u přidruženého ovládacího prvku k určení chování v době návrhu objektu ContainerControlDesigner. Nastavení u přidruženého ParseChildrenAttribute ovládacího prvku použijte následujícím způsobem:

false označuje, že ContainerControlDesigner objekt představuje obsah upravitelné oblasti návrhu jako podřízené ovládací prvky.
true označuje, že ContainerControlDesigner představuje obsah upravitelné oblasti návrhu jako upravitelné vnitřní vlastnosti ovládacího prvku.

Vývojáři ovládacích prvků můžou odvodit a rozšířit vlastního návrháře z jednoho z několika základních návrhářů v závislosti na druhu vyvíjeného ovládacího prvku, jak je definováno v následujícím seznamu:

Ovládací prvky, které umožňují přidání podřízených ovládacích prvků do této třídy v době návrhu, mohou být odvozeny ContainerControlDesigner od třídy. Například PanelContainerDesigner třída je odvozena od ContainerControlDesigner třídy a představuje ovládací prvek Panel na návrhové ploše.
Ovládací prvky, které mají jeden nebo více podřízených ovládacích prvků a můžou mít také upravitelnou oblast návrháře, do které lze ovládací prvky přidat v době návrhu CompositeControlDesigner , mohou být odvozeny z třídy.
Ovládací prvky, které vyžadují vlastní zpracování v době návrhu, mohou být odvozeny od základní ControlDesigner třídy.

Poznámka

Třída ContainerControlDesigner nahrazuje zastaralou ReadWriteControlDesigner třídu.

Pomocí atributu přidružte DesignerAttribute vlastní třídu návrháře společně s implementací vlastního ovládacího prvku. Podrobné informace o použití návrhářů ovládacích prvků s vlastními ovládacími prvky najdete v tématu Návod: Vytvoření základního Designer ovládacího prvku pro ovládací prvek webového serveru.

Konstruktory

ContainerControlDesigner()

Inicializuje novou instanci ContainerControlDesigner třídy.

Vlastnosti

ActionLists	Získá kolekci seznamu akcí pro návrháře ovládacích prvků. (Zděděno od ControlDesigner)
AllowResize	Získá hodnotu označující, zda lze změnit velikost ovládacího prvku v době návrhu.
AssociatedComponents	Získá kolekci komponent přidružených k komponentě spravované návrhářem. (Zděděno od ComponentDesigner)
AutoFormats	Získá kolekci předdefinovaných schémat automatického formátování, které se zobrazí v dialogovém okně Automatický formát pro přidružený ovládací prvek v době návrhu. (Zděděno od ControlDesigner)
Behavior	Zastaralé. Získá nebo nastaví chování DHTML, která je přidružena k návrháři. (Zděděno od HtmlControlDesigner)
Component	Získá komponentu, která tento návrhář navrhuje. (Zděděno od ComponentDesigner)
DataBindings	Získá kolekci datových vazeb pro aktuální ovládací prvek. (Zděděno od HtmlControlDesigner)
DataBindingsEnabled	Získá hodnotu určující, zda je datová vazba podporována obsahující oblast pro přidružený ovládací prvek. (Zděděno od ControlDesigner)
DesignerState	Získá objekt, který se používá k uchování dat pro přidružený ovládací prvek v době návrhu. (Zděděno od ControlDesigner)
DesignTimeElement	Zastaralé. Získá návrh-čas objekt představující ovládací prvek, který je přidružen k objektu HtmlControlDesigner na návrhové ploše. (Zděděno od HtmlControlDesigner)
DesignTimeElementView	Zastaralé. Získá objekt view-control pro návrhář ovládacího prvku. (Zděděno od ControlDesigner)
DesignTimeHtmlRequiresLoadComplete	Zastaralé. Získá hodnotu označující, zda návrhový hostitel musí dokončit načítání před volat metodu GetDesignTimeHtml . (Zděděno od ControlDesigner)
Expressions	Získá vazby výrazu pro aktuální ovládací prvek v době návrhu. (Zděděno od HtmlControlDesigner)
FrameCaption	Získá popis, který je zobrazen pro ovládací prvek v době návrhu.
FrameStyle	Získá styl, který je použit v ovládacím rámci v době návrhu.
HidePropertiesInTemplateMode	Získá hodnotu určující, zda jsou vlastnosti přidruženého ovládacího prvku skryté, když je ovládací prvek v režimu šablony. (Zděděno od ControlDesigner)
ID	Získá nebo nastaví řetězec ID ovládacího prvku. (Zděděno od ControlDesigner)
InheritanceAttribute	Získá atribut, který označuje typ dědičnosti přidružené komponenty. (Zděděno od ComponentDesigner)
Inherited	Získá hodnotu označující, zda je tato komponenta zděděna. (Zděděno od ComponentDesigner)
InTemplateMode	Získá hodnotu označující, zda je ovládací prvek v režimu zobrazení šablony nebo úpravy v hostiteli návrhu. Vlastnost InTemplateMode je jen pro čtení. (Zděděno od ControlDesigner)
IsDirty	Zastaralé. Získá nebo nastaví hodnotu označující, zda byl ovládací prvek webového serveru označen jako změněn. (Zděděno od ControlDesigner)
NoWrap	Získá hodnotu, která určuje, zda použít html `nowrap` atribut tabulky.
ParentComponent	Získá nadřazenou komponentu pro tohoto návrháře. (Zděděno od ComponentDesigner)
ReadOnly	Zastaralé. Získá nebo nastaví hodnotu označující, zda jsou vlastnosti ovládacího prvku jen pro čtení v době návrhu. (Zděděno od ControlDesigner)
RootDesigner	Získá návrhář ovládacího prvku pro Web Forms stránku, která obsahuje přidružený ovládací prvek. (Zděděno od ControlDesigner)
SetTextualDefaultProperty	Poskytuje funkce návrháře pro ovládací prvky, které obsahují podřízené ovládací prvky nebo vlastnosti, které lze upravit v době návrhu. (Zděděno od ComponentDesigner)
ShadowProperties	Získá kolekci hodnot vlastností, které přepíší nastavení uživatele. (Zděděno od ComponentDesigner)
ShouldCodeSerialize	Zastaralé. Získá nebo nastaví hodnotu určující, zda vytvořit pole deklarace pro ovládací prvek v souboru kódu na pozadí aktuálního dokumentu návrhu během serializace. (Zděděno od HtmlControlDesigner)
Tag	Získá objekt představující html značky element pro přidružený ovládací prvek. (Zděděno od ControlDesigner)
TemplateGroups	Získá kolekci skupin šablon, z nichž každá obsahuje jednu nebo více definic šablon. (Zděděno od ControlDesigner)
UsePreviewControl	Získá hodnotu označující, zda návrhář ovládacího prvku používá dočasný náhled ovládací prvek generovat kód HTML v době návrhu. (Zděděno od ControlDesigner)
Verbs	Získá příkazy v době návrhu podporované komponentou, která je přidružena k návrháři. (Zděděno od ComponentDesigner)
ViewControl	Získá nebo nastaví ovládací prvek webového serveru, který lze použít pro náhled kódu HTML v době návrhu. (Zděděno od ControlDesigner)
ViewControlCreated	Získá nebo nastaví hodnotu označující, zda `View` byl vytvořen ovládací prvek pro zobrazení na návrhové ploše. (Zděděno od ControlDesigner)
Visible	Získá hodnotu, která označuje, zda je ovládací prvek viditelný v době návrhu. (Zděděno od ControlDesigner)

Metody

AddDesignTimeCssAttributes(IDictionary)	Přidá atributy stylu ovládacího prvku v době návrhu.
CreateErrorDesignTimeHtml(String)	Vytvoří kód HTML pro zobrazení zadané chybové zprávy v době návrhu. (Zděděno od ControlDesigner)
CreateErrorDesignTimeHtml(String, Exception)	Vytvoří kód HTML, který zobrazí zadanou chybovou zprávu o výjimce v době návrhu. (Zděděno od ControlDesigner)
CreatePlaceHolderDesignTimeHtml()	Poskytuje jednoduchou obdélníkovou zástupnou reprezentaci, která zobrazuje typ a ID ovládacího prvku. (Zděděno od ControlDesigner)
CreatePlaceHolderDesignTimeHtml(String)	Poskytuje jednoduchou obdélníkovou zástupnou reprezentaci, která zobrazuje typ a ID ovládacího prvku a také další zadané pokyny nebo informace. (Zděděno od ControlDesigner)
CreateViewControl()	Vrátí kopii přidruženého ovládacího prvku pro zobrazení nebo vykreslování na návrhové ploše. (Zděděno od ControlDesigner)
Dispose()	Uvolní všechny prostředky používané nástrojem ComponentDesigner. (Zděděno od ComponentDesigner)
Dispose(Boolean)	Uvolní nespravované prostředky, které objekt používá HtmlControlDesigner , a volitelně uvolní spravované prostředky. (Zděděno od HtmlControlDesigner)
DoDefaultAction()	Vytvoří podpis metody v souboru zdrojového kódu pro výchozí událost v komponentě a přejde kurzor uživatele do daného umístění. (Zděděno od ComponentDesigner)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetBounds()	Načte souřadnice obdélníku představující hranice ovládacího prvku, jak je znázorněno na návrhové ploše. (Zděděno od ControlDesigner)
GetDesignTimeCssAttributes()	Vrátí kolekci atributů stylu ovládacího prvku v době návrhu.
GetDesignTimeHtml()	Načte kód HTML, který se používá k reprezentaci ovládacího prvku v době návrhu. (Zděděno od ControlDesigner)
GetDesignTimeHtml(DesignerRegionCollection)	Vrátí kód HTML, který se používá k reprezentaci ovládacího prvku v době návrhu.
GetEditableDesignerRegionContent(EditableDesignerRegion)	Vrátí obsah upravitelné oblasti ovládacího prvku v době návrhu.
GetEmptyDesignTimeHtml()	Načte kód HTML představující ovládací prvek webového serveru v době návrhu, který nebude mít za běhu žádnou vizuální reprezentaci. (Zděděno od ControlDesigner)
GetErrorDesignTimeHtml(Exception)	Načte kód HTML, který poskytuje informace o zadané výjimce. (Zděděno od ControlDesigner)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetPersistenceContent()	Vrátí trvalý obsah ovládacího prvku v době návrhu.
GetPersistInnerHtml()	Zastaralé. Načte trvalé vnitřní značky HTML ovládacího prvku. (Zděděno od ControlDesigner)
GetService(Type)	Pokusí se načíst zadaný typ služby z webu režimu návrhu komponenty návrháře. (Zděděno od ComponentDesigner)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
GetViewRendering()	Načte objekt, který obsahuje značky v době návrhu pro obsah a oblasti přidruženého ovládacího prvku. (Zděděno od ControlDesigner)
Initialize(IComponent)	Inicializuje návrhář ovládacího prvku a načte zadanou komponentu. (Zděděno od ControlDesigner)
InitializeExistingComponent(IDictionary)	Znovu inicializuje existující komponentu. (Zděděno od ComponentDesigner)
InitializeNewComponent(IDictionary)	Inicializuje nově vytvořenou komponentu. (Zděděno od ComponentDesigner)
InitializeNonDefault()	Zastaralé. Zastaralé. Inicializuje nastavení pro importovanou komponentu, která je již inicializována do jiných než výchozích nastavení. (Zděděno od ComponentDesigner)
Invalidate()	Zruší platnost celé oblasti ovládacího prvku, která je zobrazena na návrhové ploše, a signalizuje návrháři ovládacích prvků, aby ovládací prvek překreslil. (Zděděno od ControlDesigner)
Invalidate(Rectangle)	Zruší platnost zadané oblasti ovládacího prvku, která je zobrazena na návrhové ploše, a signalizuje návrháři ovládacích prvků překreslit ovládací prvek. (Zděděno od ControlDesigner)
InvokeGetInheritanceAttribute(ComponentDesigner)	Získá zadaný InheritanceAttribute .ComponentDesigner (Zděděno od ComponentDesigner)
IsPropertyBound(String)	Zastaralé. Načte hodnotu označující, zda je zadaná vlastnost přidruženého ovládacího prvku vázána na data. (Zděděno od ControlDesigner)
Localize(IDesignTimeResourceWriter)	Použije zadaný zapisovač prostředků k zachování lokalizovatelných vlastností přidruženého ovládacího prvku pro prostředek v hostiteli návrhu. (Zděděno od ControlDesigner)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
OnAutoFormatApplied(DesignerAutoFormat)	Volá se, když je u přidruženého ovládacího prvku použito předdefinované schéma automatického formátování. (Zděděno od ControlDesigner)
OnBehaviorAttached()	Volá se, když je návrhář ovládacího prvku připojen k objektu Behavior. (Zděděno od ControlDesigner)
OnBehaviorDetaching()	Zastaralé. Volá se, když se chování oddělí od elementu. (Zděděno od HtmlControlDesigner)
OnBindingsCollectionChanged(String)	Zastaralé. Volá se při změně kolekce datových vazeb. (Zděděno od ControlDesigner)
OnClick(DesignerRegionMouseEventArgs)	Volá ho hostitel návrhu, když uživatel klikne na přidružený ovládací prvek v době návrhu. (Zděděno od ControlDesigner)
OnComponentChanged(Object, ComponentChangedEventArgs)	Volá se při změně přidruženého ovládacího prvku. (Zděděno od ControlDesigner)
OnComponentChanging(Object, ComponentChangingEventArgs)	Představuje metodu, která bude zpracovávat ComponentChanging událost přidruženého ovládacího prvku. (Zděděno od ControlDesigner)
OnControlResize()	Zastaralé. Volá se při změně velikosti přidruženého ovládacího prvku webového serveru v hostiteli návrhu v době návrhu. (Zděděno od ControlDesigner)
OnPaint(PaintEventArgs)	Volá se, když návrhář ovládacího prvku nakreslí přidružený ovládací prvek na návrhové ploše, pokud CustomPaint je `true`hodnota . (Zděděno od ControlDesigner)
OnSetComponentDefaults()	Zastaralé. Zastaralé. Nastaví výchozí vlastnosti komponenty. (Zděděno od ComponentDesigner)
OnSetParent()	Poskytuje způsob, jak provést další zpracování, když je přidružený ovládací prvek připojen k nadřazený ovládací prvek. (Zděděno od HtmlControlDesigner)
PostFilterAttributes(IDictionary)	Umožňuje návrháři změnit nebo odebrat položky ze sady atributů, které zveřejňuje prostřednictvím TypeDescriptor. (Zděděno od ComponentDesigner)
PostFilterEvents(IDictionary)	Umožňuje návrháři změnit nebo odebrat položky ze sady událostí, které zveřejňuje prostřednictvím TypeDescriptor. (Zděděno od ComponentDesigner)
PostFilterProperties(IDictionary)	Umožňuje návrháři změnit nebo odebrat položky ze sady vlastností, které zveřejňuje prostřednictvím TypeDescriptor. (Zděděno od ComponentDesigner)
PreFilterAttributes(IDictionary)	Umožňuje návrháři přidat do sady atributů, které zveřejňuje prostřednictvím TypeDescriptor. (Zděděno od ComponentDesigner)
PreFilterEvents(IDictionary)	Nastaví seznam událostí, které jsou vystaveny v době návrhu TypeDescriptor pro objekt pro komponentu. (Zděděno od HtmlControlDesigner)
PreFilterProperties(IDictionary)	Přidá vlastnosti do nebo odebere vlastnosti z mřížky Vlastnosti v hostiteli návrhu v době návrhu nebo poskytne nové vlastnosti v době návrhu, které můžou odpovídat vlastnostem přidruženého ovládacího prvku. (Zděděno od ControlDesigner)
RaiseComponentChanged(MemberDescriptor, Object, Object)	Oznámí, IComponentChangeService že tato komponenta byla změněna. (Zděděno od ComponentDesigner)
RaiseComponentChanging(MemberDescriptor)	Upozorní, IComponentChangeService že se tato komponenta chystá ke změně. (Zděděno od ComponentDesigner)
RaiseResizeEvent()	Zastaralé. OnControlResize() Vyvolá událost. (Zděděno od ControlDesigner)
RegisterClone(Object, Object)	Registruje interní data v klonovaném ovládacím prvku. (Zděděno od ControlDesigner)
SetEditableDesignerRegionContent(EditableDesignerRegion, String)	Nastaví obsah pro upravitelnou oblast ovládacího prvku v době návrhu.
SetRegionContent(EditableDesignerRegion, String)	Určuje obsah pro upravitelnou oblast v zobrazení ovládacího prvku v době návrhu. (Zděděno od ControlDesigner)
SetViewFlags(ViewFlags, Boolean)	Přiřadí zadaný bitový ViewFlags výčet zadané hodnotě příznaku. (Zděděno od ControlDesigner)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
UpdateDesignTimeHtml()	Aktualizuje kód HTML v době návrhu pro přidružený ovládací prvek webového serveru voláním GetDesignTimeHtml metody. (Zděděno od ControlDesigner)

Explicitní implementace rozhraní

IDesignerFilter.PostFilterAttributes(IDictionary)	Popis tohoto člena najdete v PostFilterAttributes(IDictionary) metodě. (Zděděno od ComponentDesigner)
IDesignerFilter.PostFilterEvents(IDictionary)	Popis tohoto člena najdete v PostFilterEvents(IDictionary) metodě. (Zděděno od ComponentDesigner)
IDesignerFilter.PostFilterProperties(IDictionary)	Popis tohoto člena najdete v PostFilterProperties(IDictionary) metodě. (Zděděno od ComponentDesigner)
IDesignerFilter.PreFilterAttributes(IDictionary)	Popis tohoto člena najdete v PreFilterAttributes(IDictionary) metodě. (Zděděno od ComponentDesigner)
IDesignerFilter.PreFilterEvents(IDictionary)	Popis tohoto člena najdete v PreFilterEvents(IDictionary) metodě. (Zděděno od ComponentDesigner)
IDesignerFilter.PreFilterProperties(IDictionary)	Popis tohoto člena najdete v PreFilterProperties(IDictionary) metodě. (Zděděno od ComponentDesigner)
ITreeDesigner.Children	Popis tohoto člena najdete ve Children vlastnosti . (Zděděno od ComponentDesigner)
ITreeDesigner.Parent	Popis tohoto člena najdete ve Parent vlastnosti . (Zděděno od ComponentDesigner)

Platí pro