ButtonDesigner Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.Design.WebControls

Zestaw:: System.Design.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Służy do zapewniania obsługi czasu projektowania w projektancie wizualizacji dla kontrolki Button serwera sieci Web.

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

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

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

type ButtonDesigner = class
    inherit ControlDesigner

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

Public Class ButtonDesigner
Inherits ControlDesigner

Dziedziczenie: Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner
ButtonDesigner

Atrybuty: SupportsPreviewControlAttribute

Przykłady

Ta sekcja zawiera dwa przykłady kodu. Pierwszy pokazuje, jak rozszerzyć klasę ButtonDesigner . Drugi pokazuje, jak rozszerzyć klasę Button i skojarzyć ją z klasą utworzoną w pierwszym przykładzie kodu.

W poniższym przykładzie kodu pokazano, jak utworzyć klasę projektanta niestandardowego, która rozszerza ButtonDesigner klasę i zastępuje metodę GetDesignTimeHtml . BorderStyle Jeśli właściwość nie została wcześniej ustawiona (oznacza to, że ma NotSet wartość pola), wywołanie GetDesignTimeHtml metody ustawia ją na niebiesko-kreskowaną obramowanie o szerokości trzech pikseli, a następnie wyświetla tę obramowanie na powierzchni projektowej. BorderStyle Jeśli właściwość została ustawiona, zostaną wyświetlone istniejące wartości właściwości obramowania.

Zazwyczaj metoda podstawowa GetDesignTimeHtml wywołuje metodę , która wywołuje Control.RenderControl metodę ControlDesigner.GetDesignTimeHtmlskojarzonej kontrolki w celu wygenerowania znaczników.

' Create a class that derives from ButtonDesigner
' and displays the custom SampleButton control
' on the design surface.
Imports System.Web.UI.Design
Imports System.Drawing
Imports System.ComponentModel
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design.WebControls

Namespace Examples.AspNet 

    
    Public Class SampleButtonDesigner
        Inherits ButtonDesigner

        ' Override the GetDesignTimeHtml method.
        Public Overrides Function GetDesignTimeHtml() As String

            Dim sampleButton As SampleButton = CType(Component, SampleButton)
            Dim designTimeHtml As String = Nothing

            ' Check the control's BorderStyle property
            ' to conditionally render design-time HTML.
            If (sampleButton.BorderStyle = BorderStyle.NotSet) Then

                ' Create variables to hold current property settings.
                Dim oldBorderStyle As BorderStyle = sampleButton.BorderStyle
                Dim oldBorderWidth As Unit = sampleButton.BorderWidth
                Dim oldBorderColor As Color = sampleButton.BorderColor

                ' Set properties and the design-time HTML.
                Try
                    sampleButton.BorderStyle = BorderStyle.Dashed
                    sampleButton.BorderWidth = Unit.Pixel(3)
                    sampleButton.BorderColor = Color.Blue
                    designTimeHtml = MyBase.GetDesignTimeHtml()

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

                    ' Return properties to their original settings.
                Finally
                    sampleButton.BorderStyle = oldBorderStyle
                    sampleButton.BorderWidth = oldBorderWidth
                    sampleButton.BorderColor = oldBorderColor
                End Try

            Else
                designTimeHtml = MyBase.GetDesignTimeHtml()
            End If

            Return designTimeHtml

        End Function

    End Class
End Namespace

W poniższym przykładzie kodu pokazano, jak używać prostej klasy, która rozszerza Button klasę i jest skojarzona z klasą utworzoną SampleButtonDesigner w poprzednim przykładzie za pośrednictwem DesignerAttribute obiektu.

<DesignerAttribute( _
    GetType(Examples.AspNet.SampleButtonDesigner))> _
Public Class SampleButton
    Inherits Button
    ' Include code here for a custom 
    ' class that inherits from Button.        
End Class

Uwagi

W projektancie wizualizacji po przełączeniu z widoku Źródła na projekt kod źródłowy znaczników opisujący Button kontrolkę jest analizowany, a na powierzchni projektowej jest tworzona wersja kontrolki w czasie projektowania. Po przełączeniu z powrotem do widoku źródła kontrolka czasu projektowania jest utrwalana w kodzie źródłowym znaczników i edytowana w znacznikach dla strony sieci Web.

Konstruktory

ButtonDesigner()

Inicjuje nowe wystąpienie klasy ButtonDesigner.

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	Służy do zapewniania obsługi czasu projektowania w projektancie wizualizacji dla kontrolki Button 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 renderowania skojarzonej 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. 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. 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)

Dotyczy

Udostępnij za pośrednictwem