DesignerRegion Classe

Définition

Définit une zone de contenu dans le balisage au moment du design pour le contrôle associé.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
Héritage
DesignerRegion
Dérivé

Remarques

L' DesignerRegion objet représente une zone de contenu dans le balisage au moment du design qui est généré ControlDesigner par une implémentation.The DesignerRegion object represents a region of content within the design-time markup that is generated by a ControlDesigner implementation. Un développeur de contrôles utilise des zones du concepteur ControlDesigner dans une implémentation personnalisée pour définir des zones séparées dans le balisage au moment du design pour le contrôle associé et pour fournir la modification et la gestion des événements pour la zone.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. Un concepteur visuel, tel que Visual Studio 2005Visual Studio 2005, peut utiliser des zones du concepteur pour afficher les zones séparées d’un contrôle sur l’aire de conception et pour déclencher des événements utilisateur pour la région vers le concepteur de contrôles.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. Les zones du concepteur peuvent simplifier une implémentation du concepteur de contrôles, car de nombreuses fonctionnalités basées sur les régions sont fournies par les classes de concepteur de base et le concepteur visuel.Designer regions can simplify a control designer implementation because many region-based features are provided by the base designer classes and the visual designer.

La DesignerRegion classe fournit les fonctionnalités de base pour les zones du concepteur, telles que la possibilité de cliquer, de sélectionner et de mettre en surbrillance une zone dans l’aire de conception.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. Utilisez un DesignerRegion objet dans une implémentation de concepteur de contrôles pour définir une région qui ne nécessite pas de modification.Use a DesignerRegion object in a control designer implementation to define a region that does not require editing. Utilisez la classe EditableDesignerRegion dérivée dans une implémentation du concepteur de contrôles pour définir une zone avec un contenu modifiable au moment du Design.Use the derived EditableDesignerRegion class in a control designer implementation to define a region with editable content at design time. Utilisez la classe TemplatedEditableDesignerRegion dérivée dans une implémentation du concepteur de contrôles pour définir une zone modifiable qui représente un modèle dans un contrôle.Use the derived TemplatedEditableDesignerRegion class in a control designer implementation to define an editable region that represents a template in a control.

Pour prendre en charge les régions dans une classe dérivée ControlDesignerde, substituez GetDesignTimeHtml la méthode et ajoutez DesignerRegion un ou plusieurs objets initialisés à DesignerRegionCollection la collection.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. Si vous le souhaitez, vous pouvez gérer les clics de souris dans les régions de l’aire de OnClick conception en substituant la méthode.Optionally, you can handle mouse clicks in the regions on the design surface by overriding the OnClick method.

Utilisez les propriétés d’un DesignerRegion objet pour déterminer le mode d’affichage de la zone par le concepteur visuel.Use the properties of a DesignerRegion object to determine how the region is displayed by the visual designer. Substituez la Selectable propriété pour indiquer que la zone peut être sélectionnée par l’utilisateur sur l’aire de conception.Override the Selectable property to indicate that the region can be selected by the user on the design surface. Utilisez la Highlight propriété pour mettre en surbrillance la zone du concepteur dans le concepteur visuel. par exemple, vous pouvez mettre en surbrillance une région après avoir cliqué sur un utilisateur pour la sélectionner.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. Utilisez les DisplayName propriétés Description et pour stocker ou récupérer des détails supplémentaires sur la région.Use the DisplayName and Description properties to store or retrieve additional details about the region. En particulier, la Description propriété est utilisée par le concepteur visuel pour afficher des informations d’info-bulle lorsque l’utilisateur déplace le pointeur de la souris sur la zone du concepteur.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. Utilisez la Designer propriété pour accéder aux méthodes et aux propriétés de l’objet du concepteur de contrôles qui contient la zone du concepteur.Use the Designer property to access the methods and properties of the control designer object that contains the designer region.

Constructeurs

DesignerRegion(ControlDesigner, String)

Initialise une nouvelle instance de la classe DesignerRegion avec le nom spécifié pour un Concepteur de contrôles.Initializes a new instance of the DesignerRegion class with the specified name for a control designer.

DesignerRegion(ControlDesigner, String, Boolean)

Initialise une nouvelle instance de la classe DesignerRegion avec le nom spécifié pour un Concepteur de contrôles, en définissant éventuellement l'instance en tant que zone sélectionnable dans le concepteur.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.

Champs

DesignerRegionAttributeName

Définit le nom d'attribut HTML pour une zone du concepteur.Defines the HTML attribute name for a designer region.

Propriétés

Description

Obtient ou définit la description pour une zone du concepteur.Gets or sets the description for a designer region.

Designer

Obtient le composant de concepteur associé.Gets the associated designer component.

(Hérité de DesignerObject)
DisplayName

Obtient ou définit le nom complet convivial pour une zone du concepteur.Gets or sets the friendly display name for a designer region.

EnsureSize

Obtient ou définit une valeur indiquant si la taille de la zone doit être définie explicitement sur la zone du concepteur par l'hôte de conception.Gets or sets a value indicating whether the region size is to be explicitly set on the designer region by the design host.

Highlight

Obtient ou définit une valeur indiquant si la zone du concepteur doit être mise en surbrillance dans l'aire de conception.Gets or sets a value indicating whether to highlight the designer region on the design surface.

Name

Obtient le nom de l'objet.Gets the name of the object.

(Hérité de DesignerObject)
Properties

Obtient les propriétés de l'objet.Gets the object's properties.

(Hérité de DesignerObject)
Selectable

Obtient ou définit une valeur indiquant si la zone du concepteur peut être sélectionnée par l'utilisateur dans l'aire de conception.Gets or sets a value indicating whether the designer region can be selected by the user on the design surface.

Selected

Obtient ou définit une valeur indiquant si la zone du concepteur est actuellement sélectionnée dans l'aire de conception.Gets or sets a value indicating whether the designer region is currently selected on the design surface.

UserData

Obtient ou définit les données de l'utilisateur facultatives à associer à la zone du concepteur.Gets or sets optional user data to associate with the designer region.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetBounds()

Récupère la taille de la zone du concepteur dans l'aire de conception.Retrieves the size of the designer region on the design surface.

GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetService(Type)

Obtient un service de l'hôte de conception, tel qu'identifié par le type fourni.Gets a service from the design host, as identified by the provided type.

(Hérité de DesignerObject)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Hérité de Object)

Implémentations d’interfaces explicites

IServiceProvider.GetService(Type)

Pour obtenir une description de ce membre, consultez GetService(Type).For a description of this member, see GetService(Type).

(Hérité de DesignerObject)

S’applique à

Voir aussi