DesignerRegion 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.
Definierar en region med innehåll inom designtidsmarkeringen för den associerade kontrollen.
public ref class DesignerRegion : System::Web::UI::Design::DesignerObject
public class DesignerRegion : System.Web.UI.Design.DesignerObject
type DesignerRegion = class
inherit DesignerObject
Public Class DesignerRegion
Inherits DesignerObject
- Arv
- Härledda
Kommentarer
Objektet DesignerRegion representerar en region med innehåll inom designtidsmarkeringen som genereras av en ControlDesigner implementering. En kontrollutvecklare använder designerregioner i en anpassad ControlDesigner implementering för att definiera separata områden inom designtidsmarkeringen för den associerade kontrollen och för att tillhandahålla redigering och händelsehantering för området. En visuell designer, till exempel Visual Studio 2005, kan använda designerregioner för att visa de separata områdena i en kontroll på designytan och för att höja användarhändelser för regionen till kontrolldesignern. Designerregioner kan förenkla implementeringen av kontrolldesignern eftersom många regionbaserade funktioner tillhandahålls av basdesignerklasserna och den visuella designern.
Klassen DesignerRegion tillhandahåller basfunktionerna för designerregioner, till exempel möjligheten att klicka, välja och markera en region i designytan. Använd ett DesignerRegion objekt i en kontrolldesignerimplementering för att definiera en region som inte kräver redigering. Använd den härledda EditableDesignerRegion klassen i en kontrolldesignerimplementering för att definiera en region med redigerbart innehåll vid designtillfället. Använd den härledda TemplatedEditableDesignerRegion klassen i en kontrolldesignerimplementering för att definiera en redigerbar region som representerar en mall i en kontroll.
Om du vill stödja regioner inom en klass som härleds från ControlDesigneråsidosätter GetDesignTimeHtml du metoden och lägger till ett eller flera initierade DesignerRegion objekt i DesignerRegionCollection samlingen. Du kan också hantera musklickningar i regionerna på designytan genom att OnClick åsidosätta metoden.
Använd egenskaperna för ett DesignerRegion objekt för att avgöra hur regionen visas av den visuella designern. Åsidosätt Selectable egenskapen för att ange att regionen kan väljas av användaren på designytan. Använd egenskapen Highlight för att markera designerregionen i den visuella designern. Du kan till exempel markera en region när en användare har klickat för att välja den. DisplayName Använd egenskaperna och Description för att lagra eller hämta ytterligare information om regionen. I synnerhet Description används egenskapen av den visuella designern för att visa knappbeskrivningsinformation när användaren flyttar muspekaren över designerregionen. Använd egenskapen Designer för att komma åt metoderna och egenskaperna för kontrolldesignerobjektet som innehåller designerregionen.
Konstruktorer
| Name | Description |
|---|---|
| DesignerRegion(ControlDesigner, String, Boolean) |
Initierar en ny instans av DesignerRegion klassen med det angivna namnet för en kontrolldesigner, om du vill ange instansen som en valbar region i designern. |
| DesignerRegion(ControlDesigner, String) |
Initierar en ny instans av DesignerRegion klassen med det angivna namnet för en kontrolldesigner. |
Fält
| Name | Description |
|---|---|
| DesignerRegionAttributeName |
Definierar HTML-attributnamnet för en designerregion. |
Egenskaper
| Name | Description |
|---|---|
| Description |
Hämtar eller anger beskrivningen för en designerregion. |
| Designer |
Hämtar den associerade designerkomponenten. (Ärvd från DesignerObject) |
| DisplayName |
Hämtar eller anger det egna visningsnamnet för en designerregion. |
| EnsureSize |
Hämtar eller anger ett värde som anger om regionstorleken uttryckligen ska anges i designerregionen av designvärden. |
| Highlight |
Hämtar eller anger ett värde som anger om designerregionen ska markeras på designytan. |
| Name |
Hämtar objektets namn. (Ärvd från DesignerObject) |
| Properties |
Hämtar objektets egenskaper. (Ärvd från DesignerObject) |
| Selectable |
Hämtar eller anger ett värde som anger om designerregionen kan väljas av användaren på designytan. |
| Selected |
Hämtar eller anger ett värde som anger om designerregionen är vald på designytan. |
| UserData |
Hämtar eller anger valfria användardata som ska associeras med designerregionen. |
Metoder
| Name | Description |
|---|---|
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| GetBounds() |
Hämtar storleken på designerregionen på designytan. |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetService(Type) |
Hämtar en tjänst från designvärden enligt den angivna typen. (Ärvd från DesignerObject) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |
Explicita gränssnittsimplementeringar
| Name | Description |
|---|---|
| IServiceProvider.GetService(Type) |
En beskrivning av den här medlemmen finns i GetService(Type). (Ärvd från DesignerObject) |