DesignerRegion Klasa

Definicja

Definiuje region zawartości w ramach znaczników czasu projektowania dla skojarzonej kontrolki.Defines a region of content within the design-time markup for the associated control.

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
DesignerRegion
Pochodne

Uwagi

Obiekt reprezentuje region zawartości w ramach znaczników czasu projektowania, który jest generowany ControlDesigner przez implementację. DesignerRegionThe DesignerRegion object represents a region of content within the design-time markup that is generated by a ControlDesigner implementation. Deweloper kontroli używa regionów projektanta w niestandardowej ControlDesigner implementacji do definiowania oddzielnych obszarów w ramach znaczników czasu projektowania dla skojarzonej kontrolki oraz do zapewnienia obsługi edycji i zdarzeń dla obszaru.A control developer uses designer regions in a custom ControlDesigner implementation to define separate areas within the design-time markup for the associated control and to provide editing and event handling for the area. Projektant wizualny, taki jak Visual Studio 2005Visual Studio 2005, może używać regionów projektanta do wyświetlania oddzielnych obszarów kontrolki na powierzchni projektowej oraz do wywoływania zdarzeń użytkownika dla regionu w projektancie formantów.A visual designer, such as Visual Studio 2005Visual Studio 2005, can use designer regions to display the separate areas of a control on the design surface and to raise user events for the region to the control designer. Regiony projektanta mogą uprościć implementację projektanta formantów, ponieważ wiele funkcji opartych na regionie jest udostępnianych przez podstawowe klasy projektanta i projektanta wizualnego.Designer regions can simplify a control designer implementation because many region-based features are provided by the base designer classes and the visual designer.

DesignerRegion Klasa zawiera podstawowe funkcje dla regionów projektanta, takich jak możliwość kliknięcia, wyboru i wyróżnienia regionu na powierzchni projektowej.The DesignerRegion class provides the base functionality for designer regions, such as the ability to click, select, and highlight a region in the design surface. DesignerRegion Użyj obiektu w implementacji projektanta formantów, aby zdefiniować region, który nie wymaga edycji.Use a DesignerRegion object in a control designer implementation to define a region that does not require editing. Użyj klasy pochodnej EditableDesignerRegion w implementacji projektanta formantów, aby zdefiniować region z zawartością edytowalną w czasie projektowania.Use the derived EditableDesignerRegion class in a control designer implementation to define a region with editable content at design time. Użyj klasy pochodnej TemplatedEditableDesignerRegion w implementacji projektanta formantów, aby zdefiniować edytowalny region, który reprezentuje szablon w kontrolce.Use the derived TemplatedEditableDesignerRegion class in a control designer implementation to define an editable region that represents a template in a control.

Aby obsługiwać regiony w klasie, która pochodzi ControlDesignerod, GetDesignTimeHtml Zastąp metodę i Dodaj do DesignerRegionCollection kolekcji jeden lub więcej zainicjowanych DesignerRegion obiektów.To support regions within a class that is derived from the ControlDesigner, override the GetDesignTimeHtml method and add one or more initialized DesignerRegion objects to the DesignerRegionCollection collection. Opcjonalnie można obsłużyć kliknięcia myszą w regionach na powierzchni projektowej, zastępując OnClick metodę.Optionally, you can handle mouse clicks in the regions on the design surface by overriding the OnClick method.

Użyj właściwości DesignerRegion obiektu, aby określić, w jaki sposób region jest wyświetlany przez projektanta wizualnego.Use the properties of a DesignerRegion object to determine how the region is displayed by the visual designer. Zastąp Selectable właściwość, aby wskazać, że użytkownik może wybrać region na powierzchni projektowej.Override the Selectable property to indicate that the region can be selected by the user on the design surface. Highlight Użyj właściwości, aby wyróżnić region projektanta w projektancie wizualizacji. na przykład można podświetlić region po kliknięciu przez użytkownika, aby go zaznaczyć.Use the Highlight property to highlight the designer region in the visual designer; for example, you can highlight a region after a user has clicked to select it. DisplayName Właściwości i Description służą do przechowywania lub pobierania dodatkowych informacji o regionie.Use the DisplayName and Description properties to store or retrieve additional details about the region. W szczególności Description właściwość jest używana przez projektanta wizualizacji do wyświetlania informacji o etykietce narzędzia, gdy użytkownik przesuwa wskaźnik myszy nad regionem projektanta.In particular, the Description property is used by the visual designer to display ToolTip information when the user moves the mouse pointer over the designer region. Designer Użyj właściwości, aby uzyskać dostęp do metod i właściwości obiektu projektanta formantów, który zawiera region projektanta.Use the Designer property to access the methods and properties of the control designer object that contains the designer region.

Konstruktory

DesignerRegion(ControlDesigner, String)

Inicjuje nowe wystąpienie DesignerRegion klasy z określoną nazwą projektanta formantów.Initializes a new instance of the DesignerRegion class with the specified name for a control designer.

DesignerRegion(ControlDesigner, String, Boolean)

Inicjuje nowe wystąpienie DesignerRegion klasy z określoną nazwą projektanta formantów, opcjonalnie ustawiając wystąpienie jako region do wyboru w projektancie.Initializes a new instance of the DesignerRegion class with the specified name for a control designer, optionally setting the instance as a selectable region in the designer.

Pola

DesignerRegionAttributeName

Definiuje nazwę atrybutu HTML dla regionu projektanta.Defines the HTML attribute name for a designer region.

Właściwości

Description

Pobiera lub ustawia opis dla regionu projektanta.Gets or sets the description for a designer region.

Designer

Pobiera skojarzony składnik projektanta.Gets the associated designer component.

(Odziedziczone po DesignerObject)
DisplayName

Pobiera lub ustawia przyjazną nazwę wyświetlaną dla regionu projektanta.Gets or sets the friendly display name for a designer region.

EnsureSize

Pobiera lub ustawia wartość wskazującą, czy rozmiar regionu ma być jawnie ustawiony w regionie projektanta przez hosta projektu.Gets or sets a value indicating whether the region size is to be explicitly set on the designer region by the design host.

Highlight

Pobiera lub ustawia wartość wskazującą, czy region projektanta ma zostać wyświetlona na powierzchni projektowej.Gets or sets a value indicating whether to highlight the designer region on the design surface.

Name

Pobiera nazwę obiektu.Gets the name of the object.

(Odziedziczone po DesignerObject)
Properties

Pobiera właściwości obiektu.Gets the object's properties.

(Odziedziczone po DesignerObject)
Selectable

Pobiera lub ustawia wartość wskazującą, czy region projektanta może być wybrany przez użytkownika na powierzchni projektowej.Gets or sets a value indicating whether the designer region can be selected by the user on the design surface.

Selected

Pobiera lub ustawia wartość wskazującą, czy region projektanta jest obecnie zaznaczony na powierzchni projektowej.Gets or sets a value indicating whether the designer region is currently selected on the design surface.

UserData

Pobiera lub ustawia opcjonalne dane użytkownika do skojarzenia z regionem projektanta.Gets or sets optional user data to associate with the designer region.

Metody

Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetBounds()

Pobiera rozmiar regionu projektanta na powierzchni projektowej.Retrieves the size of the designer region on the design surface.

GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetService(Type)

Pobiera usługę z hosta projektu identyfikowaną przez dostarczony typ.Gets a service from the design host, as identified by the provided type.

(Odziedziczone po DesignerObject)
GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
ToString()

Zwraca ciąg, który reprezentuje bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Jawne implementacje interfejsu

IServiceProvider.GetService(Type)

Aby uzyskać opis tego elementu członkowskiego, GetService(Type)Zobacz.For a description of this member, see GetService(Type).

(Odziedziczone po DesignerObject)

Dotyczy

Zobacz też