DesignerRegion Klasa

Odwołanie

Definicja

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

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.

Definiuje region zawartości w znaczniku czasu projektowania dla skojarzonej kontrolki.

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

Dziedziczenie: Object

DesignerObject
DesignerRegion

Pochodne: System.Web.UI.Design.EditableDesignerRegion

Uwagi

Obiekt DesignerRegion reprezentuje region zawartości w znaczniku czasu projektowania generowanym przez implementację ControlDesigner . Deweloper kontrolek używa regionów projektanta w implementacji niestandardowej ControlDesigner do definiowania oddzielnych obszarów w ramach znacznika czasu projektowania dla skojarzonej kontrolki oraz do udostępniania edycji i obsługi zdarzeń dla tego obszaru. Projektant wizualny, taki jak Visual Studio 2005, może używać regionów projektanta do wyświetlania oddzielnych obszarów kontrolki na powierzchni projektowej i zgłaszania zdarzeń użytkownika dla regionu do projektanta sterowania. Regiony projektanta mogą uprościć implementację projektanta sterowania, ponieważ wiele funkcji opartych na regionie jest udostępnianych przez klasy projektanta podstawowego i projektanta wizualnego.

Klasa DesignerRegion udostępnia podstawowe funkcje dla regionów projektanta, takich jak możliwość klikania, wybierania i wyróżniania regionu na powierzchni projektowej. DesignerRegion Użyj obiektu w implementacji projektanta kontrolek, aby zdefiniować region, który nie wymaga edycji. Użyj klasy pochodnej EditableDesignerRegion w implementacji projektanta kontrolek, aby zdefiniować region z edytowalną zawartością w czasie projektowania. Użyj klasy pochodnej TemplatedEditableDesignerRegion w implementacji projektanta kontrolek, aby zdefiniować edytowalny region reprezentujący szablon w kontrolce.

Aby obsługiwać regiony w klasie pochodzącej z ControlDesignerklasy , przesłoń GetDesignTimeHtml metodę i dodaj do DesignerRegionCollection kolekcji co najmniej jeden zainicjowany DesignerRegion obiekt. Opcjonalnie możesz obsługiwać kliknięcia myszy w regionach na powierzchni projektowej, przesłaniając metodę OnClick .

Użyj właściwości DesignerRegion obiektu, aby określić sposób wyświetlania regionu przez projektanta wizualnego. Zastąpij Selectable właściwość, aby wskazać, że region można wybrać przez użytkownika na powierzchni projektowej. Highlight Użyj właściwości , aby wyróżnić region projektanta w projektancie wizualizacji, na przykład możesz wyróżnić region po kliknięciu go przez użytkownika, aby go wybrać. DisplayName Użyj właściwości i Description do przechowywania lub pobierania dodatkowych szczegółów dotyczących regionu. W szczególności Description właściwość jest używana przez projektanta wizualnego do wyświetlania informacji etykietki narzędzia, gdy użytkownik przenosi wskaźnik myszy nad regionem projektanta. Użyj właściwości , Designer aby uzyskać dostęp do metod i właściwości obiektu projektanta kontrolek, który zawiera region projektanta.

Konstruktory

DesignerRegion(ControlDesigner, String)	Inicjuje DesignerRegion nowe wystąpienie klasy o określonej nazwie projektanta kontrolek.
DesignerRegion(ControlDesigner, String, Boolean)	Inicjuje nowe wystąpienie DesignerRegion klasy o określonej nazwie projektanta kontrolek, opcjonalnie ustawiając wystąpienie jako region do wyboru w projektancie.

Pola

DesignerRegionAttributeName

Definiuje nazwę atrybutu HTML dla regionu projektanta.

Właściwości

Description	Pobiera lub ustawia opis regionu projektanta.
Designer	Pobiera skojarzony składnik projektanta. (Odziedziczone po DesignerObject)
DisplayName	Pobiera lub ustawia przyjazną nazwę wyświetlaną dla regionu projektanta.
EnsureSize	Pobiera lub ustawia wartość wskazującą, czy rozmiar regionu ma być jawnie ustawiony w regionie projektanta przez hosta projektu.
Highlight	Pobiera lub ustawia wartość wskazującą, czy wyróżnić region projektanta na powierzchni projektowej.
Name	Pobiera nazwę obiektu. (Odziedziczone po DesignerObject)
Properties	Pobiera właściwości obiektu. (Odziedziczone po DesignerObject)
Selectable	Pobiera lub ustawia wartość wskazującą, czy region projektanta można wybrać przez użytkownika na powierzchni projektowej.
Selected	Pobiera lub ustawia wartość wskazującą, czy region projektanta jest aktualnie wybrany na powierzchni projektowej.
UserData	Pobiera lub ustawia opcjonalne dane użytkownika do skojarzenia z regionem projektanta.

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetBounds()	Pobiera rozmiar regionu projektanta na powierzchni projektowej.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetService(Type)	Pobiera usługę z hosta projektu zgodnie z podanym typem. (Odziedziczone po DesignerObject)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

IServiceProvider.GetService(Type)

Aby uzyskać opis tego elementu członkowskiego, zobacz GetService(Type).

(Odziedziczone po DesignerObject)

Dotyczy