CheckBoxDesigner Klasa

Definicja

Przestrzeń nazw:

System.Web.UI.Design.WebControls

Zestaw:

System.Design.dll

Rozszerza zachowanie czasu projektowania dla kontrolki CheckBox serwera sieci Web.

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

[System.Web.UI.Design.SupportsPreviewControl(true)]
public class CheckBoxDesigner : System.Web.UI.Design.ControlDesigner

[<System.Web.UI.Design.SupportsPreviewControl(true)>]
type CheckBoxDesigner = class
    inherit ControlDesigner

Public Class CheckBoxDesigner
Inherits ControlDesigner

Dziedziczenie

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

CheckBoxDesigner

Atrybuty

SupportsPreviewControlAttribute

Przykłady

Poniższy przykład kodu tworzy klasę projektanta niestandardowego o nazwie SampleCheckBoxDesigner, która dziedziczy z CheckBoxDesigner klasy. Zastępuje metodę GetDesignTimeHtml . CheckBox.Text Jeśli właściwość nie została wcześniej ustawiona, wywołanie tej metody ustawia ją na ciąg i wyświetla ten ciąg na powierzchni projektowej. Text Jeśli właściwość została ustawiona, zostanie wyświetlona istniejąca wartość właściwości.

'Imports System.Design
Imports System.Drawing
Imports System.ComponentModel
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design
Imports System.Web.UI.Design.WebControls
'Imports Examples.AspNet

Namespace Examples.AspNet '.Design

    ' Create a class, named SampleCheckBoxDesigner, that overrides the
    ' GetDesignTimeHtml method to display the control on the design
    ' surface.

    Public Class SampleCheckBoxDesigner
        Inherits System.Web.UI.Design.WebControls.CheckBoxDesigner

        ' Override the GetDesignTimeHtml method to display a border on the 
        ' control if the BorderStyle property has not been set by the user.
        Public Overrides Function GetDesignTimeHtml() As String

            Dim sampleCheckBox As SampleCheckBox = CType(Component, _
                SampleCheckBox)
            Dim designTimeHtml As String = Nothing

            ' Check the control's BorderStyle property.
            If (sampleCheckBox.BorderStyle = BorderStyle.NotSet) Then

                ' Save the current value of the BorderStyle property.
                Dim oldBorderStyle As BorderStyle = _
                    sampleCheckBox.BorderStyle

                ' Change the value of the BorderStyle property and 
                ' generate the design-time HTML.
                Try
                    sampleCheckBox.BorderStyle = BorderStyle.Groove
                    designTimeHtml = MyBase.GetDesignTimeHtml()

                    ' If an exception occurs, call the GetErrorDesignTimeHtml
                    ' method.
                Catch ex As Exception
                    designTimeHtml = GetErrorDesignTimeHtml(ex)

                    ' Restore the BorderStyle property to its original value.
                Finally
                    sampleCheckBox.BorderStyle = oldBorderStyle
                End Try

            Else
                designTimeHtml = MyBase.GetDesignTimeHtml()
            End If

            Return designTimeHtml
        End Function
    End Class
End Namespace

Poniższy przykład kodu to prosta klasa o nazwie SampleCheckBox, która dziedziczy z CheckBox klasy i jest skojarzona z klasą przez klasę SampleCheckBoxDesignerDesignerAttribute .

Namespace Examples.AspNet

    ' The SampleCheckBox class that uses the SampleCheckBoxDesigner class.
    <Designer(GetType( _
        Examples.AspNet.SampleCheckBoxDesigner))> _
    Public Class SampleCheckBox
        Inherits CheckBox
        ' To customize the CheckBox class, insert code here.
    End Class

End Namespace

Uwagi

Klasa CheckBoxDesigner zastępuje metodę GetDesignTimeHtmlControlDesigner klasy, aby upewnić się, że kontrolka jest wyświetlana z zrozumiałą reprezentacją w czasie projektowania. Text Jeśli właściwość jest pusta, GetDesignTimeHtml metoda tej klasy ustawia Text właściwość kontrolki na Control.ID właściwość kontrolki.

Konstruktory

CheckBoxDesigner()

Inicjuje nowe wystąpienie klasy CheckBoxDesigner.

Właściwości

ActionLists	Pobiera kolekcję listy akcji dla projektanta kontrolek. (Odziedziczone po ControlDesigner)
AllowResize	Pobiera wartość wskazującą, czy można zmienić rozmiar kontrolki w środowisku czasu projektowania. (Odziedziczone po ControlDesigner)
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świetlania 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 skojarzona kontrolka. (Odziedziczone po ControlDesigner)
DesignerState	Pobiera obiekt używany do utrwalania danych 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)
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 edytowania 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)
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)
SetTextualDefaultProperty	Rozszerza zachowanie czasu projektowania dla kontrolki CheckBox serwera sieci Web. (Odziedziczone po ComponentDesigner)
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 zawierającą co najmniej jedną definicję szablonu. (Odziedziczone po ControlDesigner)
UsePreviewControl	Pobiera wartość wskazującą, czy projektant kontrolek używa tymczasowej kontrolki podglądu do generowania znaczników HTML w czasie projektowania. (Odziedziczone po ControlDesigner)
Verbs	Pobiera czasy projektowania 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 znaczników HTML w czasie projektowania. (Odziedziczone po ControlDesigner)
ViewControlCreated	Pobiera lub ustawia wartość wskazującą, czy kontrolka View 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

CreateErrorDesignTimeHtml(String)	Tworzy znaczniki HTML w celu wyświetlenia określonego komunikatu o błędzie w czasie projektowania. (Odziedziczone po ControlDesigner)
CreateErrorDesignTimeHtml(String, Exception)	Tworzy znacznik HTML w celu wyświetlenia określonego komunikatu o błędzie wyjątku w czasie projektowania. (Odziedziczone po ControlDesigner)
CreatePlaceHolderDesignTimeHtml()	Udostępnia 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 wszelkie zasoby używane przez element 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 zdarzenia domyślnego w składniku i przechodzi kursor użytkownika do tej lokalizacji. (Odziedziczone po ComponentDesigner)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetBounds()	Pobiera współrzędne prostokąta reprezentującego granice kontrolki wyświetlane na powierzchni projektowej. (Odziedziczone po ControlDesigner)
GetDesignTimeHtml()	Pobiera znaczniki używane do reprezentowania kontrolki w czasie projektowania.
GetDesignTimeHtml(DesignerRegionCollection)	Pobiera znacznik HTML, aby wyświetlić kontrolkę i wypełnić kolekcję bieżącymi regionami projektanta kontrolek. (Odziedziczone po ControlDesigner)
GetEditableDesignerRegionContent(EditableDesignerRegion)	Zwraca zawartość dla edytowalnego regionu widoku czasu projektowania skojarzonej kontrolki. (Odziedziczone po ControlDesigner)
GetEmptyDesignTimeHtml()	Pobiera znaczniki HTML, aby reprezentować kontrolkę serwera sieci Web w czasie projektowania, która nie będzie miała wizualnej reprezentacji w czasie wykonywania. (Odziedziczone po ControlDesigner)
GetErrorDesignTimeHtml(Exception)	Pobiera znacznik HTML, który zawiera informacje o określonym wyjątku. (Odziedziczone po ControlDesigner)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetPersistenceContent()	Pobiera trwały wewnętrzny znacznik HTML kontrolki w czasie projektowania. (Odziedziczone po ControlDesigner)
GetPersistInnerHtml()	Przestarzałe. Pobiera trwały wewnętrzny znacznik 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()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
GetViewRendering()	Pobiera obiekt zawierający znacznik czasu projektowania 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. 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 wyświetlanej 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)	InheritanceAttribute Pobiera określony ComponentDesignerelement . (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 Objectelementu . (Odziedziczone po Object)
OnAutoFormatApplied(DesignerAutoFormat)	Wywoływana, gdy wstępnie zdefiniowany schemat formatowania automatycznego został zastosowany do skojarzonej kontrolki. (Odziedziczone po ControlDesigner)
OnBehaviorAttached()	Wywoływane, gdy projektant kontrolek jest dołączony do obiektu Zachowanie. (Odziedziczone po ControlDesigner)
OnBehaviorDetaching()	Przestarzałe. Wywoływane, gdy zachowanie nie jest skojarzone z elementem. (Odziedziczone po HtmlControlDesigner)
OnBindingsCollectionChanged(String)	Przestarzałe. Wywoływane po zmianie kolekcji powiązania danych. (Odziedziczone po ControlDesigner)
OnClick(DesignerRegionMouseEventArgs)	Wywoływane przez hosta projektu, gdy użytkownik kliknie skojarzą kontrolkę 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 kontrolkę na powierzchni projektowej, jeśli CustomPaint wartość to true. (Odziedziczone po ControlDesigner)
OnSetComponentDefaults()	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ń udostępnianych 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 uwidacznianych za pomocą elementu TypeDescriptor. (Odziedziczone po ComponentDesigner)
PreFilterAttributes(IDictionary)	Umożliwia projektantowi dodanie do zestawu atrybutów uwidacznianych za pośrednictwem elementu TypeDescriptor. (Odziedziczone po ComponentDesigner)
PreFilterEvents(IDictionary)	Ustawia listę zdarzeń, które są uwidocznione w czasie projektowania dla TypeDescriptor obiektu składnika. (Odziedziczone po HtmlControlDesigner)
PreFilterProperties(IDictionary)	Dodaje właściwości do siatki Właściwości lub usuwa je w 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 o IComponentChangeService zmianie tego składnika. (Odziedziczone po ComponentDesigner)
RaiseResizeEvent()	Przestarzałe. OnControlResize() Zgłasza zdarzenie. (Odziedziczone po ControlDesigner)
RegisterClone(Object, Object)	Rejestruje dane wewnętrzne w sklonowanej kontrolce. (Odziedziczone po ControlDesigner)
SetEditableDesignerRegionContent(EditableDesignerRegion, String)	Określa zawartość edytowalnego regionu kontrolki w czasie projektowania. (Odziedziczone po ControlDesigner)
SetRegionContent(EditableDesignerRegion, String)	Określa zawartość regionu edytowalnego w widoku czasu projektowania kontrolki. (Odziedziczone po ControlDesigner)
SetViewFlags(ViewFlags, Boolean)	Przypisuje określoną 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 czasu projektowania dla skojarzonej kontrolki serwera sieci Web, wywołując metodę GetDesignTimeHtml . (Odziedziczone po ControlDesigner)

Jawne implementacje interfejsu

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)

Zobacz też

• Wprowadzenie do projektantów kontrolek ASP.NET
• Przewodnik: tworzenie podstawowego projektanta kontrolek dla kontrolki serwera sieci Web