ContainerControlDesigner 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.
Tillhandahåller designerfunktioner för kontroller som innehåller underordnade kontroller eller egenskaper som kan ändras vid designtillfället.
public ref class ContainerControlDesigner : System::Web::UI::Design::ControlDesignerpublic class ContainerControlDesigner : System.Web.UI.Design.ControlDesignertype ContainerControlDesigner = class
inherit ControlDesignerPublic Class ContainerControlDesigner
Inherits ControlDesigner- Arv
- Härledda
Exempel
Följande kodexempel visar hur du härleder en designerklass från ContainerControlDesigner klassen. Exemplet definierar en enkel kontroll som härleds från CompositeControl klassen och definierar sedan en associerad designer som härleds från ContainerControlDesigner klassen. Den härledda designerklassen FrameCaption åsidosätter egenskaperna och FrameStyle för att anpassa den ram som finns runt kontrollens redigerbara region på designytan.
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
Kommentarer
Klassen ContainerControlDesigner tillhandahåller en basdesignerklass för kontroller som kan ändras på designytan. Detta inkluderar kontroller som innehåller underordnade kontroller eller redigerbara inre egenskaper. ContainerControlDesigner Ger en enda inramad region som representerar kontrollen och hanterar automatiskt återgivningen av kontrollen vid designtillfället.
ParseChildrenAttribute Använd attributet på den associerade kontrollen för att fastställa designtidsbeteendet för ContainerControlDesigner. ParseChildrenAttribute Tillämpa inställningarna på den associerade kontrollen på följande sätt:
falseför att ange att ContainerControlDesigner representerar innehållet i den redigerbara designregionen som underordnade kontroller.trueför att ange att ContainerControlDesigner representerar innehållet i den redigerbara designregionen som redigerbara inre egenskaper för kontrollen.
Kontrollutvecklare kan härleda och utöka en anpassad designer från en av flera basdesigners beroende på vilken typ av kontroll som utvecklas, enligt definitionen i följande lista:
Kontroller som gör det möjligt att lägga till underordnade kontroller i den vid designtillfället kan härledas från ContainerControlDesigner klassen. Klassen härleds till exempel PanelContainerDesigner från ContainerControlDesigner klassen och representerar en Panel kontroll på designytan.
Kontroller som har en eller flera underordnade kontroller, och som också kan ha en redigerbar designerregion där kontroller kan läggas till vid designtillfället, kan härledas från CompositeControlDesigner klassen.
Kontroller som kräver anpassad designtidsbearbetning kan härledas från basklassen ControlDesigner .
Note
Klassen ContainerControlDesigner ersätter den föråldrade ReadWriteControlDesigner klassen.
DesignerAttribute Använd attributet för att associera en anpassad designerklass med en anpassad kontrollimplementering. Detaljerad information om hur du använder kontrolldesigners med anpassade kontroller finns i Genomgång: Skapa en grundläggande kontrolldesigner för en webbserverkontroll.
Konstruktorer
| Name | Description |
|---|---|
| ContainerControlDesigner() |
Initierar en ny instans av ContainerControlDesigner 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 vid designtillfället. |
| 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) |
| FrameCaption |
Hämtar undertexten som visas för en kontroll vid designtillfället. |
| FrameStyle |
Hämtar formatmallen som tillämpas på kontrollramen vid designtillfället. |
| 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) |
| NoWrap |
Hämtar ett värde som anger om HTML-attributet |
| 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 |
|---|---|
| AddDesignTimeCssAttributes(IDictionary) |
Lägger till formatattributen för kontrollen vid designtillfället. |
| 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) |
| GetDesignTimeCssAttributes() |
Returnerar samlingen med formatattribut för kontrollen vid designtillfället. |
| GetDesignTimeHtml() |
Hämtar HTML-markering som används för att representera kontrollen vid designtillfället. (Ärvd från ControlDesigner) |
| GetDesignTimeHtml(DesignerRegionCollection) |
Returnerar DEN HTML-kod som används för att representera kontrollen vid designtillfället. |
| GetEditableDesignerRegionContent(EditableDesignerRegion) |
Returnerar innehållet för kontrollens redigerbara region vid designtillfället. |
| 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() |
Returnerar det beständiga innehållet i kontrollen vid designtillfället. |
| 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) |
| 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 kontrollens redigerbara region vid designtillfället. |
| 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) |
