ButtonDesigner Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Används för att ge designtidsstöd i en visuell designer för Button webbserverkontrollen.
public ref class ButtonDesigner : System::Web::UI::Design::ControlDesignerpublic class ButtonDesigner : System.Web.UI.Design.ControlDesigner[System.Web.UI.Design.SupportsPreviewControl(true)]
public class ButtonDesigner : System.Web.UI.Design.ControlDesignertype ButtonDesigner = class
inherit ControlDesigner[<System.Web.UI.Design.SupportsPreviewControl(true)>]
type ButtonDesigner = class
inherit ControlDesignerPublic Class ButtonDesigner
Inherits ControlDesigner- Arv
- Attribut
Exempel
Det här avsnittet innehåller två kodexempel. Den första visar hur du ButtonDesigner utökar klassen. Den andra visar hur du utökar klassen och associerar den Button med klassen som skapas i det första kodexemplet.
I följande kodexempel visas hur du skapar en anpassad designerklass som utökar ButtonDesigner klassen och åsidosätter GetDesignTimeHtml metoden. Om egenskapen BorderStyle inte har angetts tidigare (det vill säga att den NotSet har fältvärdet) anger ett anrop till GetDesignTimeHtml metoden den till en blåstreckad kantlinje med en bredd på tre bildpunkter och visar sedan den kantlinjen på designytan. Om egenskapen BorderStyle har angetts visas de befintliga gränsegenskapsvärdena.
GetDesignTimeHtml Normalt anropar dess basmetod, ControlDesigner.GetDesignTimeHtml, som anropar metoden för den Control.RenderControl associerade kontrollen för att generera pålägget.
' 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
Följande kodexempel visar hur du använder en enkel klass som utökar Button klassen och är associerad med SampleButtonDesigner klassen, som skapades i föregående exempel, via DesignerAttribute objektet.
<DesignerAttribute( _
GetType(Examples.AspNet.SampleButtonDesigner))> _
Public Class SampleButton
Inherits Button
' Include code here for a custom
' class that inherits from Button.
End Class
Kommentarer
När du växlar från vyn Källa till Design i en visuell designer parsas källkoden Button som beskriver kontrollen och en designtidsversion av kontrollen skapas på designytan. När du växlar tillbaka till källvyn sparas designtidskontrollen till källkoden för markering och redigeras till markering för webbsidan.
Konstruktorer
| Name | Description |
|---|---|
| ButtonDesigner() |
Initierar en ny instans av ButtonDesigner klassen. |
Egenskaper
| Name | Description |
|---|---|
| ActionLists |
Hämtar åtgärdslistsamlingen för kontrolldesignern. (Ärvd från ControlDesigner) |
| AllowResize |
Hämtar ett värde som anger om kontrollen kan ändras i designmiljön. (Ärvd från ControlDesigner) |
| AssociatedComponents |
Hämtar den samling komponenter som är associerade med komponenten som hanteras av designern. (Ärvd från ComponentDesigner) |
| AutoFormats |
Hämtar samlingen med fördefinierade automatiska formateringsscheman som ska visas i dialogrutan Automatiskt format för den associerade kontrollen vid designtillfället. (Ärvd från ControlDesigner) |
| Behavior |
Föråldrad.
Hämtar eller anger det DHTML-beteende som är associerat med designern. (Ärvd från HtmlControlDesigner) |
| Component |
Hämtar komponenten som designern designar. (Ärvd från ComponentDesigner) |
| DataBindings |
Hämtar databindningssamlingen för den aktuella kontrollen. (Ärvd från HtmlControlDesigner) |
| DataBindingsEnabled |
Hämtar ett värde som anger om databindning stöds av den innehållande regionen för den associerade kontrollen. (Ärvd från ControlDesigner) |
| DesignerState |
Hämtar ett objekt som används för att bevara data för den associerade kontrollen vid designtillfället. (Ärvd från ControlDesigner) |
| DesignTimeElement |
Föråldrad.
Hämtar designtidsobjektet som representerar kontrollen som är associerad med HtmlControlDesigner objektet på designytan. (Ärvd från HtmlControlDesigner) |
| DesignTimeElementView |
Föråldrad.
Hämtar visningskontrollobjektet för kontrolldesignern. (Ärvd från ControlDesigner) |
| DesignTimeHtmlRequiresLoadComplete |
Föråldrad.
Hämtar ett värde som anger om designvärden måste slutföra inläsningen GetDesignTimeHtml innan metoden kan anropas. (Ärvd från ControlDesigner) |
| Expressions |
Hämtar uttrycksbindningarna för den aktuella kontrollen vid designtillfället. (Ärvd från HtmlControlDesigner) |
| HidePropertiesInTemplateMode |
Hämtar ett värde som anger om egenskaperna för den associerade kontrollen är dolda när kontrollen är i mallläge. (Ärvd från ControlDesigner) |
| ID |
Hämtar eller anger ID-strängen för kontrollen. (Ärvd från ControlDesigner) |
| InheritanceAttribute |
Hämtar ett attribut som anger typen av arv för den associerade komponenten. (Ärvd från ComponentDesigner) |
| Inherited |
Hämtar ett värde som anger om den här komponenten ärvs. (Ärvd från ComponentDesigner) |
| InTemplateMode |
Hämtar ett värde som anger om kontrollen är i antingen mallvisnings- eller redigeringsläge i designvärden. Egenskapen InTemplateMode är skrivskyddad. (Ärvd från ControlDesigner) |
| IsDirty |
Föråldrad.
Hämtar eller anger ett värde som anger om webbserverkontrollen har markerats som ändrad. (Ärvd från ControlDesigner) |
| ParentComponent |
Hämtar den överordnade komponenten för den här designern. (Ärvd från ComponentDesigner) |
| ReadOnly |
Föråldrad.
Hämtar eller anger ett värde som anger om egenskaperna för kontrollen är skrivskyddade vid designtillfället. (Ärvd från ControlDesigner) |
| RootDesigner |
Hämtar kontrolldesignern för sidan Webbformulär som innehåller den associerade kontrollen. (Ärvd från ControlDesigner) |
| ShadowProperties |
Hämtar en samling egenskapsvärden som åsidosätter användarinställningar. (Ärvd från ComponentDesigner) |
| ShouldCodeSerialize |
Föråldrad.
Hämtar eller anger ett värde som anger om du vill skapa en fältdeklaration för kontrollen i filen bakom koden för det aktuella designdokumentet under serialiseringen. (Ärvd från HtmlControlDesigner) |
| Tag |
Hämtar ett objekt som representerar HTML-markeringselementet för den associerade kontrollen. (Ärvd från ControlDesigner) |
| TemplateGroups |
Hämtar en samling mallgrupper som var och en innehåller en eller flera malldefinitioner. (Ärvd från ControlDesigner) |
| UsePreviewControl |
Hämtar ett värde som anger om kontrolldesignern använder en tillfällig förhandsgranskningskontroll för att generera HTML-kod för designtid. (Ärvd från ControlDesigner) |
| Verbs |
Hämtar designtidsverb som stöds av komponenten som är associerad med designern. (Ärvd från ComponentDesigner) |
| ViewControl |
Hämtar eller anger en webbserverkontroll som kan användas för att förhandsgranska HTML-markeringen för designtid. (Ärvd från ControlDesigner) |
| ViewControlCreated |
Hämtar eller anger ett värde som anger om en |
| Visible |
Hämtar ett värde som anger om kontrollen är synlig vid designtillfället. (Ärvd från ControlDesigner) |
Metoder
| Name | Description |
|---|---|
| CreateErrorDesignTimeHtml(String, Exception) |
Skapar HTML-koden för att visa ett angivet undantagsfel vid designtillfället. (Ärvd från ControlDesigner) |
| CreateErrorDesignTimeHtml(String) |
Skapar HTML-kod för att visa ett angivet felmeddelande vid designtillfället. (Ärvd från ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml() |
Ger en enkel rektangulär platshållarrepresentation som visar kontrollens typ och ID. (Ärvd från ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml(String) |
Tillhandahåller en enkel rektangulär platshållarrepresentation som visar kontrollens typ och ID, samt ytterligare angivna instruktioner eller information. (Ärvd från ControlDesigner) |
| CreateViewControl() |
Returnerar en kopia av den associerade kontrollen för visning eller återgivning på designytan. (Ärvd från ControlDesigner) |
| Dispose() |
Släpper alla resurser som används av ComponentDesigner. (Ärvd från ComponentDesigner) |
| Dispose(Boolean) |
Släpper de ohanterade resurser som används av HtmlControlDesigner objektet och släpper eventuellt de hanterade resurserna. (Ärvd från HtmlControlDesigner) |
| DoDefaultAction() |
Skapar en metodsignatur i källkodsfilen för standardhändelsen på komponenten och navigerar användarens markören till den platsen. (Ärvd från ComponentDesigner) |
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| GetBounds() |
Hämtar koordinaterna för rektangeln som representerar gränserna för kontrollen enligt designytan. (Ärvd från ControlDesigner) |
| GetDesignTimeHtml() |
Hämtar den markering som används för att återge den associerade kontrollen vid designtillfället. |
| GetDesignTimeHtml(DesignerRegionCollection) |
Hämtar HTML-markering för att visa kontrollen och fyller samlingen med de aktuella kontrolldesignerregionerna. (Ärvd från ControlDesigner) |
| GetEditableDesignerRegionContent(EditableDesignerRegion) |
Returnerar innehållet för en redigerbar region i designtidsvyn för den associerade kontrollen. (Ärvd från ControlDesigner) |
| GetEmptyDesignTimeHtml() |
Hämtar HTML-markering för att representera en webbserverkontroll vid designtillfället som inte har någon visuell representation vid körning. (Ärvd från ControlDesigner) |
| GetErrorDesignTimeHtml(Exception) |
Hämtar HTML-koden som innehåller information om det angivna undantaget. (Ärvd från ControlDesigner) |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetPersistenceContent() |
Hämtar den bestående inre HTML-koden för kontrollen vid designtillfället. (Ärvd från ControlDesigner) |
| GetPersistInnerHtml() |
Föråldrad.
Hämtar kontrollens bestående inre HTML-kod. (Ärvd från ControlDesigner) |
| GetService(Type) |
Försöker hämta den angivna typen av tjänst från designlägesplatsen för designerns komponent. (Ärvd från ComponentDesigner) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| GetViewRendering() |
Hämtar ett objekt som innehåller designtidsmarkeringen för innehållet och regionerna i den associerade kontrollen. (Ärvd från ControlDesigner) |
| Initialize(IComponent) |
Initierar kontrolldesignern och läser in den angivna komponenten. (Ärvd från ControlDesigner) |
| InitializeExistingComponent(IDictionary) |
Initierar om en befintlig komponent. (Ärvd från ComponentDesigner) |
| InitializeNewComponent(IDictionary) |
Initierar en nyskapade komponent. (Ärvd från ComponentDesigner) |
| InitializeNonDefault() |
Föråldrad.
Föråldrad.
Initierar inställningarna för en importerad komponent som redan har initierats till andra inställningar än standardinställningarna. (Ärvd från ComponentDesigner) |
| Invalidate() |
Ogiltigförklarar hela området av kontrollen som visas på designytan och signalerar kontrolldesignern att rita om kontrollen. (Ärvd från ControlDesigner) |
| Invalidate(Rectangle) |
Ogiltigförklarar det angivna området för kontrollen som visas på designytan och signalerar kontrolldesignern att rita om kontrollen. (Ärvd från ControlDesigner) |
| InvokeGetInheritanceAttribute(ComponentDesigner) |
Hämtar den InheritanceAttribute angivna ComponentDesigner. (Ärvd från ComponentDesigner) |
| IsPropertyBound(String) |
Föråldrad.
Hämtar ett värde som anger om den angivna egenskapen för den associerade kontrollen är databunden. (Ärvd från ControlDesigner) |
| Localize(IDesignTimeResourceWriter) |
Använder den angivna resursskrivaren för att bevara de localizable egenskaperna för den associerade kontrollen till en resurs i designvärden. (Ärvd från ControlDesigner) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| OnAutoFormatApplied(DesignerAutoFormat) |
Anropas när ett fördefinierat, automatiskt formateringsschema har tillämpats på den associerade kontrollen. (Ärvd från ControlDesigner) |
| OnBehaviorAttached() |
Anropas när kontrolldesignern är kopplad till ett beteendeobjekt. (Ärvd från ControlDesigner) |
| OnBehaviorDetaching() |
Föråldrad.
Anropas när ett beteende avassocierar från elementet. (Ärvd från HtmlControlDesigner) |
| OnBindingsCollectionChanged(String) |
Föråldrad.
Anropas när databindningssamlingen ändras. (Ärvd från ControlDesigner) |
| OnClick(DesignerRegionMouseEventArgs) |
Anropas av designvärden när användaren klickar på den associerade kontrollen vid designtillfället. (Ärvd från ControlDesigner) |
| OnComponentChanged(Object, ComponentChangedEventArgs) |
Anropas när den associerade kontrollen ändras. (Ärvd från ControlDesigner) |
| OnComponentChanging(Object, ComponentChangingEventArgs) |
Representerar den metod som ska hantera ComponentChanging händelsen för den associerade kontrollen. (Ärvd från ControlDesigner) |
| OnControlResize() |
Föråldrad.
Anropas när den associerade webbserverkontrollen har ändrats i designvärden vid designtillfället. (Ärvd från ControlDesigner) |
| OnPaint(PaintEventArgs) |
Anropas när kontrolldesignern ritar den associerade kontrollen på designytan, om CustomPaint värdet är |
| OnSetComponentDefaults() |
Föråldrad.
Föråldrad.
Anger standardegenskaperna för komponenten. (Ärvd från ComponentDesigner) |
| OnSetParent() |
Ger ett sätt att utföra ytterligare bearbetning när den associerade kontrollen är kopplad till en överordnad kontroll. (Ärvd från HtmlControlDesigner) |
| PostFilterAttributes(IDictionary) |
Gör att en designer kan ändra eller ta bort objekt från den uppsättning attribut som den exponerar via en TypeDescriptor. (Ärvd från ComponentDesigner) |
| PostFilterEvents(IDictionary) |
Gör att en designer kan ändra eller ta bort objekt från den uppsättning händelser som den exponerar via en TypeDescriptor. (Ärvd från ComponentDesigner) |
| PostFilterProperties(IDictionary) |
Gör att en designer kan ändra eller ta bort objekt från den uppsättning egenskaper som den exponerar via en TypeDescriptor. (Ärvd från ComponentDesigner) |
| PreFilterAttributes(IDictionary) |
Gör att en designer kan lägga till i den uppsättning attribut som den exponerar via en TypeDescriptor. (Ärvd från ComponentDesigner) |
| PreFilterEvents(IDictionary) |
Anger listan över händelser som exponeras vid designtid för TypeDescriptor objektet för komponenten. (Ärvd från HtmlControlDesigner) |
| PreFilterProperties(IDictionary) |
Lägger till egenskaper i eller tar bort egenskaper från rutnätet Egenskaper i en designvärd vid designtillfället eller ger nya designtidsegenskaper som kan motsvara egenskaper för den associerade kontrollen. (Ärvd från ControlDesigner) |
| RaiseComponentChanged(MemberDescriptor, Object, Object) |
Meddelar IComponentChangeService att den här komponenten har ändrats. (Ärvd från ComponentDesigner) |
| RaiseComponentChanging(MemberDescriptor) |
IComponentChangeService Meddelar att den här komponenten håller på att ändras. (Ärvd från ComponentDesigner) |
| RaiseResizeEvent() |
Föråldrad.
Genererar händelsen OnControlResize() . (Ärvd från ControlDesigner) |
| RegisterClone(Object, Object) |
Registrerar interna data i en klonad kontroll. (Ärvd från ControlDesigner) |
| SetEditableDesignerRegionContent(EditableDesignerRegion, String) |
Anger innehållet för en redigerbar region för kontrollen vid designtillfället. (Ärvd från ControlDesigner) |
| SetRegionContent(EditableDesignerRegion, String) |
Anger innehållet för en redigerbar region i kontrollens designtidsvy. (Ärvd från ControlDesigner) |
| SetViewFlags(ViewFlags, Boolean) |
Tilldelar den angivna bitvis ViewFlags uppräkning till det angivna flaggvärdet. (Ärvd från ControlDesigner) |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |
| UpdateDesignTimeHtml() |
Uppdaterar HTML-koden för designtid för den associerade webbserverkontrollen genom att anropa GetDesignTimeHtml metoden. (Ärvd från ControlDesigner) |
