Język

ContainerControlDesigner Klasa

Definicja

Udostępnia funkcje projektanta dla kontrolek zawierających kontrolki podrzędne lub właściwości, które można modyfikować w czasie projektowania.

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
Dziedziczenie
Pochodne

Przykłady

W poniższym przykładzie kodu pokazano, jak utworzyć klasę projektanta ContainerControlDesigner z klasy . W przykładzie zdefiniowano prostą kontrolkę pochodzącą z CompositeControl klasy, a następnie zdefiniowano skojarzony projektant, który pochodzi z ContainerControlDesigner klasy. Klasa projektanta pochodnego zastępuje FrameCaption właściwości i FrameStyle , aby dostosować ramkę wokół edytowalnego regionu kontrolki na powierzchni projektowej.

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

Uwagi

Klasa ContainerControlDesigner udostępnia klasę projektanta podstawowego dla kontrolek, które można modyfikować na powierzchni projektowej. Obejmuje to kontrolki zawierające kontrolki podrzędne lub edytowalne właściwości wewnętrzne. Element ContainerControlDesigner zapewnia pojedynczy region w ramce reprezentujący kontrolkę i automatycznie obsługuje renderowanie kontrolki w czasie projektowania.

ParseChildrenAttribute Zastosuj atrybut w skojarzonej kontrolce, aby określić zachowanie czasu projektowania obiektu ContainerControlDesigner. ParseChildrenAttribute Zastosuj ustawienia skojarzonej kontrolki w następujący sposób:

  • false aby wskazać, że ContainerControlDesigner element reprezentuje zawartość edytowalnego regionu projektu jako kontrolki podrzędne.

  • true aby wskazać, że ContainerControlDesigner element reprezentuje zawartość edytowalnego regionu projektu jako edytowalne właściwości wewnętrzne kontrolki.

Deweloperzy kontrolek mogą uzyskiwać i rozszerzać projektanta niestandardowego od jednego z kilku projektantów bazowych w zależności od rodzaju opracowywanej kontrolki, zgodnie z definicją na poniższej liście:

  • Kontrolki, które umożliwiają dodawanie do niego kontrolek podrzędnych w czasie projektowania, mogą pochodzić z ContainerControlDesigner klasy . Na przykład PanelContainerDesigner klasa pochodzi z ContainerControlDesigner klasy i reprezentuje kontrolkę Panel na powierzchni projektowej.

  • Kontrolki, które mają co najmniej jedną kontrolkę podrzędną, a także mogą mieć edytowalny region projektanta, w którym można dodawać kontrolki w czasie projektowania, mogą pochodzić z CompositeControlDesigner klasy .

  • Kontrolki, które wymagają niestandardowego przetwarzania w czasie projektowania, mogą pochodzić z klasy bazowej ControlDesigner .

Note

Klasa ContainerControlDesigner zastępuje przestarzałą ReadWriteControlDesigner klasę.

Użyj atrybutu DesignerAttribute , aby skojarzyć klasę projektanta niestandardowego z implementacją niestandardowej kontrolki. Aby uzyskać szczegółowe informacje na temat używania projektantów kontrolek z kontrolkami niestandardowymi, zobacz Przewodnik: tworzenie podstawowego projektanta kontrolek dla kontrolki serwera sieci Web.

Konstruktory

Nazwa Opis
ContainerControlDesigner()

Inicjuje nowe wystąpienie klasy ContainerControlDesigner.

Właściwości

Nazwa Opis
ActionLists

Pobiera kolekcję listy akcji dla projektanta kontrolek.

(Odziedziczone po ControlDesigner)
AllowResize

Pobiera wartość wskazującą, czy rozmiar kontrolki można zmienić w czasie projektowania.

AssociatedComponents

Pobiera kolekcję składników skojarzonych ze składnikiem zarządzanym przez projektanta.

(Odziedziczone po ComponentDesigner)
AutoFormats

Pobiera kolekcję wstępnie zdefiniowanych schematów automatycznego formatowania do wyświetlenia w oknie dialogowym Automatyczne formatowanie skojarzonej kontrolki w czasie projektowania.

(Odziedziczone po ControlDesigner)
Behavior
Przestarzałe.

Pobiera lub ustawia zachowanie DHTML skojarzone z projektantem.

(Odziedziczone po HtmlControlDesigner)
Component

Pobiera składnik, który projektuje ten projektant.

(Odziedziczone po ComponentDesigner)
DataBindings

Pobiera kolekcję powiązań danych dla bieżącej kontrolki.

(Odziedziczone po HtmlControlDesigner)
DataBindingsEnabled

Pobiera wartość wskazującą, czy powiązanie danych jest obsługiwane przez region zawierający dla skojarzonej kontrolki.

(Odziedziczone po ControlDesigner)
DesignerState

Pobiera obiekt, który jest używany do utrwalania danych dla skojarzonej kontrolki w czasie projektowania.

(Odziedziczone po ControlDesigner)
DesignTimeElement
Przestarzałe.

Pobiera obiekt czasu projektowania reprezentujący kontrolkę skojarzona z obiektem HtmlControlDesigner na powierzchni projektowej.

(Odziedziczone po HtmlControlDesigner)
DesignTimeElementView
Przestarzałe.

Pobiera obiekt kontrolki widoku dla projektanta kontrolek.

(Odziedziczone po ControlDesigner)
DesignTimeHtmlRequiresLoadComplete
Przestarzałe.

Pobiera wartość wskazującą, czy host projektu musi zakończyć ładowanie, zanim będzie można wywołać metodę GetDesignTimeHtml .

(Odziedziczone po ControlDesigner)
Expressions

Pobiera powiązania wyrażeń dla bieżącej kontrolki w czasie projektowania.

(Odziedziczone po HtmlControlDesigner)
FrameCaption

Pobiera podpis wyświetlany dla kontrolki w czasie projektowania.

FrameStyle

Pobiera styl zastosowany do ramki sterującej w czasie projektowania.

HidePropertiesInTemplateMode

Pobiera wartość wskazującą, czy właściwości skojarzonej kontrolki są ukryte, gdy kontrolka jest w trybie szablonu.

(Odziedziczone po ControlDesigner)
ID

Pobiera lub ustawia ciąg identyfikatora dla kontrolki.

(Odziedziczone po ControlDesigner)
InheritanceAttribute

Pobiera atrybut wskazujący typ dziedziczenia skojarzonego składnika.

(Odziedziczone po ComponentDesigner)
Inherited

Pobiera wartość wskazującą, czy ten składnik jest dziedziczony.

(Odziedziczone po ComponentDesigner)
InTemplateMode

Pobiera wartość wskazującą, czy kontrolka jest w trybie wyświetlania szablonu lub edycji na hoście projektu. Właściwość InTemplateMode jest tylko do odczytu.

(Odziedziczone po ControlDesigner)
IsDirty
Przestarzałe.

Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera sieci Web została oznaczona jako zmieniona.

(Odziedziczone po ControlDesigner)
NoWrap

Pobiera wartość określającą, czy używać atrybutu HTML nowrap w tabelach.

ParentComponent

Pobiera składnik nadrzędny dla tego projektanta.

(Odziedziczone po ComponentDesigner)
ReadOnly
Przestarzałe.

Pobiera lub ustawia wartość wskazującą, czy właściwości kontrolki są tylko do odczytu w czasie projektowania.

(Odziedziczone po ControlDesigner)
RootDesigner

Pobiera projektanta kontrolek dla strony Formularze sieci Web zawierającej skojarzona kontrolkę.

(Odziedziczone po ControlDesigner)
ShadowProperties

Pobiera kolekcję wartości właściwości, które zastępują ustawienia użytkownika.

(Odziedziczone po ComponentDesigner)
ShouldCodeSerialize
Przestarzałe.

Pobiera lub ustawia wartość wskazującą, czy podczas serializacji utworzyć deklarację pola dla kontrolki w pliku za kodem dla bieżącego dokumentu projektowego.

(Odziedziczone po HtmlControlDesigner)
Tag

Pobiera obiekt reprezentujący element znaczników HTML dla skojarzonej kontrolki.

(Odziedziczone po ControlDesigner)
TemplateGroups

Pobiera kolekcję grup szablonów, z których każda zawiera co najmniej jedną definicję szablonu.

(Odziedziczone po ControlDesigner)
UsePreviewControl

Pobiera wartość wskazującą, czy projektant kontrolek używa tymczasowej kontrolki podglądu do generowania znacznika HTML w czasie projektowania.

(Odziedziczone po ControlDesigner)
Verbs

Pobiera czas projektowania czasowniki obsługiwane przez składnik skojarzony z projektantem.

(Odziedziczone po ComponentDesigner)
ViewControl

Pobiera lub ustawia kontrolkę serwera sieci Web, która może służyć do wyświetlania podglądu znacznika HTML w czasie projektowania.

(Odziedziczone po ControlDesigner)
ViewControlCreated

Pobiera lub ustawia wartość wskazującą View , czy kontrolka została utworzona do wyświetlania na powierzchni projektowej.

(Odziedziczone po ControlDesigner)
Visible

Pobiera wartość wskazującą, czy kontrolka jest widoczna w czasie projektowania.

(Odziedziczone po ControlDesigner)

Metody

Nazwa Opis
AddDesignTimeCssAttributes(IDictionary)

Dodaje atrybuty stylu dla kontrolki w czasie projektowania.

CreateErrorDesignTimeHtml(String, Exception)

Tworzy znacznik HTML w celu wyświetlenia określonego komunikatu o błędzie wyjątku w czasie projektowania.

(Odziedziczone po ControlDesigner)
CreateErrorDesignTimeHtml(String)

Tworzy znacznik HTML w celu wyświetlenia określonego komunikatu o błędzie w czasie projektowania.

(Odziedziczone po ControlDesigner)
CreatePlaceHolderDesignTimeHtml()

Zawiera prostą prostokątną reprezentację symbolu zastępczego, która wyświetla typ i identyfikator kontrolki.

(Odziedziczone po ControlDesigner)
CreatePlaceHolderDesignTimeHtml(String)

Zawiera prostą prostokątną reprezentację symbolu zastępczego, która wyświetla typ i identyfikator kontrolki, a także dodatkowe określone instrukcje lub informacje.

(Odziedziczone po ControlDesigner)
CreateViewControl()

Zwraca kopię skojarzonej kontrolki do wyświetlania lub renderowania na powierzchni projektowej.

(Odziedziczone po ControlDesigner)
Dispose()

Zwalnia wszystkie zasoby używane przez program ComponentDesigner.

(Odziedziczone po ComponentDesigner)
Dispose(Boolean)

Zwalnia niezarządzane zasoby, które są używane przez HtmlControlDesigner obiekt i opcjonalnie zwalnia zarządzane zasoby.

(Odziedziczone po HtmlControlDesigner)
DoDefaultAction()

Tworzy podpis metody w pliku kodu źródłowego dla domyślnego zdarzenia w składniku i przechodzi kursor użytkownika do tej lokalizacji.

(Odziedziczone po ComponentDesigner)
Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.

(Odziedziczone po Object)
GetBounds()

Pobiera współrzędne prostokąta reprezentującego granice kontrolki wyświetlane na powierzchni projektowej.

(Odziedziczone po ControlDesigner)
GetDesignTimeCssAttributes()

Zwraca kolekcję atrybutów stylu dla kontrolki w czasie projektowania.

GetDesignTimeHtml()

Pobiera znaczniki HTML używane do reprezentowania kontrolki w czasie projektowania.

(Odziedziczone po ControlDesigner)
GetDesignTimeHtml(DesignerRegionCollection)

Zwraca znacznik HTML używany do reprezentowania kontrolki w czasie projektowania.

GetEditableDesignerRegionContent(EditableDesignerRegion)

Zwraca zawartość dla edytowalnego regionu kontrolki w czasie projektowania.

GetEmptyDesignTimeHtml()

Pobiera znacznik HTML reprezentujący kontrolkę serwera sieci Web w czasie projektowania, która nie będzie mieć wizualnej reprezentacji w czasie wykonywania.

(Odziedziczone po ControlDesigner)
GetErrorDesignTimeHtml(Exception)

Pobiera znacznik HTML zawierający informacje o określonym wyjątku.

(Odziedziczone po ControlDesigner)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetPersistenceContent()

Zwraca utrwalalną zawartość kontrolki w czasie projektowania.

GetPersistInnerHtml()
Przestarzałe.

Pobiera utrwalane wewnętrzne znaczniki HTML kontrolki.

(Odziedziczone po ControlDesigner)
GetService(Type)

Próbuje pobrać określony typ usługi z witryny trybu projektowania składnika projektanta.

(Odziedziczone po ComponentDesigner)
GetType()

Pobiera Type bieżącego wystąpienia.

(Odziedziczone po Object)
GetViewRendering()

Pobiera obiekt, który zawiera znacznik czasu projektowania dla zawartości i regionów skojarzonej kontrolki.

(Odziedziczone po ControlDesigner)
Initialize(IComponent)

Inicjuje projektanta kontrolek i ładuje określony składnik.

(Odziedziczone po ControlDesigner)
InitializeExistingComponent(IDictionary)

Ponownie inicjuje istniejący składnik.

(Odziedziczone po ComponentDesigner)
InitializeNewComponent(IDictionary)

Inicjuje nowo utworzony składnik.

(Odziedziczone po ComponentDesigner)
InitializeNonDefault()
Przestarzałe.
Przestarzałe.

Inicjuje ustawienia zaimportowanego składnika, który jest już inicjowany do ustawień innych niż domyślne.

(Odziedziczone po ComponentDesigner)
Invalidate()

Unieważnia cały obszar kontrolki, który jest wyświetlany na powierzchni projektowej i sygnalizuje projektantowi sterowania ponowne rysowanie kontrolki.

(Odziedziczone po ControlDesigner)
Invalidate(Rectangle)

Unieważnia określony obszar kontrolki wyświetlanej na powierzchni projektowej i sygnalizuje projektantowi sterowania ponowne rysowanie kontrolki.

(Odziedziczone po ControlDesigner)
InvokeGetInheritanceAttribute(ComponentDesigner)

Pobiera element InheritanceAttribute z określonego ComponentDesignerelementu .

(Odziedziczone po ComponentDesigner)
IsPropertyBound(String)
Przestarzałe.

Pobiera wartość wskazującą, czy określona właściwość skojarzonej kontrolki jest powiązana z danymi.

(Odziedziczone po ControlDesigner)
Localize(IDesignTimeResourceWriter)

Używa dostarczonego składnika zapisywania zasobów do utrwalania zlokalizowanych właściwości skojarzonej kontrolki z zasobem na hoście projektu.

(Odziedziczone po ControlDesigner)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Object.

(Odziedziczone po Object)
OnAutoFormatApplied(DesignerAutoFormat)

Wywoływana w przypadku wstępnie zdefiniowanego schematu automatycznego formatowania została zastosowana do skojarzonej kontrolki.

(Odziedziczone po ControlDesigner)
OnBehaviorDetaching()
Przestarzałe.

Wywoływana, gdy zachowanie nie jest skojarzone z elementem.

(Odziedziczone po HtmlControlDesigner)
OnBindingsCollectionChanged(String)
Przestarzałe.

Wywoływana po zmianie kolekcji powiązania danych.

(Odziedziczone po ControlDesigner)
OnClick(DesignerRegionMouseEventArgs)

Wywoływany przez hosta projektu, gdy użytkownik kliknie skojarzona kontrolka w czasie projektowania.

(Odziedziczone po ControlDesigner)
OnComponentChanged(Object, ComponentChangedEventArgs)

Wywoływana, gdy skojarzona kontrolka ulegnie zmianie.

(Odziedziczone po ControlDesigner)
OnComponentChanging(Object, ComponentChangingEventArgs)

Reprezentuje metodę, która będzie obsługiwać ComponentChanging zdarzenie dla skojarzonej kontrolki.

(Odziedziczone po ControlDesigner)
OnControlResize()
Przestarzałe.

Wywoływana po zmianie rozmiaru skojarzonej kontrolki serwera sieci Web na hoście projektu w czasie projektowania.

(Odziedziczone po ControlDesigner)
OnPaint(PaintEventArgs)

Wywoływana, gdy projektant kontrolek rysuje skojarzona kontrolka na powierzchni projektowej, jeśli CustomPaint wartość to true.

(Odziedziczone po ControlDesigner)
OnSetComponentDefaults()
Przestarzałe.
Przestarzałe.

Ustawia domyślne właściwości składnika.

(Odziedziczone po ComponentDesigner)
OnSetParent()

Zapewnia sposób wykonywania dodatkowego przetwarzania, gdy skojarzona kontrolka jest dołączona do kontrolki nadrzędnej.

(Odziedziczone po HtmlControlDesigner)
PostFilterAttributes(IDictionary)

Umożliwia projektantowi zmianę lub usunięcie elementów z zestawu atrybutów, które uwidacznia za pośrednictwem elementu TypeDescriptor.

(Odziedziczone po ComponentDesigner)
PostFilterEvents(IDictionary)

Umożliwia projektantowi zmianę lub usunięcie elementów z zestawu zdarzeń, które uwidacznia za pośrednictwem elementu TypeDescriptor.

(Odziedziczone po ComponentDesigner)
PostFilterProperties(IDictionary)

Umożliwia projektantowi zmianę lub usunięcie elementów z zestawu właściwości, które uwidacznia za pośrednictwem elementu TypeDescriptor.

(Odziedziczone po ComponentDesigner)
PreFilterAttributes(IDictionary)

Umożliwia projektantowi dodanie do zestawu atrybutów udostępnianych za pośrednictwem elementu TypeDescriptor.

(Odziedziczone po ComponentDesigner)
PreFilterEvents(IDictionary)

Ustawia listę zdarzeń, które są widoczne w czasie projektowania dla TypeDescriptor obiektu składnika.

(Odziedziczone po HtmlControlDesigner)
PreFilterProperties(IDictionary)

Dodaje właściwości lub usuwa właściwości z siatki Właściwości na hoście projektu w czasie projektowania lub udostępnia nowe właściwości czasu projektowania, które mogą odpowiadać właściwościom skojarzonej kontrolki.

(Odziedziczone po ControlDesigner)
RaiseComponentChanged(MemberDescriptor, Object, Object)

Powiadamia o IComponentChangeService zmianie tego składnika.

(Odziedziczone po ComponentDesigner)
RaiseComponentChanging(MemberDescriptor)

Powiadamia, IComponentChangeService że ten składnik ma zostać zmieniony.

(Odziedziczone po ComponentDesigner)
RaiseResizeEvent()
Przestarzałe.

OnControlResize() Wywołuje zdarzenie.

(Odziedziczone po ControlDesigner)
RegisterClone(Object, Object)

Rejestruje dane wewnętrzne w sklonowanej kontrolce.

(Odziedziczone po ControlDesigner)
SetEditableDesignerRegionContent(EditableDesignerRegion, String)

Ustawia zawartość dla edytowalnego regionu kontrolki w czasie projektowania.

SetRegionContent(EditableDesignerRegion, String)

Określa zawartość regionu edytowalnego w widoku czasu projektowania kontrolki.

(Odziedziczone po ControlDesigner)
SetViewFlags(ViewFlags, Boolean)

Przypisuje określone wyliczenie bitowe ViewFlags do określonej wartości flagi.

(Odziedziczone po ControlDesigner)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)
UpdateDesignTimeHtml()

Odświeża znacznik HTML w czasie projektowania dla skojarzonej kontrolki serwera sieci Web, wywołując metodę GetDesignTimeHtml .

(Odziedziczone po ControlDesigner)

Jawne implementacje interfejsu

Nazwa Opis
IDesignerFilter.PostFilterAttributes(IDictionary)

Aby uzyskać opis tego elementu członkowskiego, zobacz metodę PostFilterAttributes(IDictionary) .

(Odziedziczone po ComponentDesigner)
IDesignerFilter.PostFilterEvents(IDictionary)

Aby uzyskać opis tego elementu członkowskiego, zobacz metodę PostFilterEvents(IDictionary) .

(Odziedziczone po ComponentDesigner)
IDesignerFilter.PostFilterProperties(IDictionary)

Aby uzyskać opis tego elementu członkowskiego, zobacz metodę PostFilterProperties(IDictionary) .

(Odziedziczone po ComponentDesigner)
IDesignerFilter.PreFilterAttributes(IDictionary)

Aby uzyskać opis tego elementu członkowskiego, zobacz metodę PreFilterAttributes(IDictionary) .

(Odziedziczone po ComponentDesigner)
IDesignerFilter.PreFilterEvents(IDictionary)

Aby uzyskać opis tego elementu członkowskiego, zobacz metodę PreFilterEvents(IDictionary) .

(Odziedziczone po ComponentDesigner)
IDesignerFilter.PreFilterProperties(IDictionary)

Aby uzyskać opis tego elementu członkowskiego, zobacz metodę PreFilterProperties(IDictionary) .

(Odziedziczone po ComponentDesigner)
ITreeDesigner.Children

Aby uzyskać opis tego elementu członkowskiego, zobacz Children właściwość .

(Odziedziczone po ComponentDesigner)
ITreeDesigner.Parent

Aby uzyskać opis tego elementu członkowskiego, zobacz Parent właściwość .

(Odziedziczone po ComponentDesigner)

Dotyczy

Zobacz też