DesignerRegion Classe

Référence

Définition

Espace de noms:: System.Web.UI.Design

Assembly:: System.Design.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Définit une zone de contenu dans le balisage au moment du design pour le contrôle associé.

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: Object

DesignerObject
DesignerRegion

Dérivé: System.Web.UI.Design.EditableDesignerRegion

Remarques

L' DesignerRegion objet représente une zone de contenu dans le balisage au moment du design qui est généré par une ControlDesigner implémentation. Un développeur de contrôles utilise des zones du concepteur dans une ControlDesigner 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. Un concepteur visuel, tel que Visual 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. 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.

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. 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. Utilisez la classe dérivée EditableDesignerRegion dans une implémentation du concepteur de contrôles pour définir une zone avec un contenu modifiable au moment du Design. Utilisez la classe dérivée TemplatedEditableDesignerRegion 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.

Pour prendre en charge les régions dans une classe dérivée de ControlDesigner , substituez la GetDesignTimeHtml méthode et ajoutez un ou plusieurs objets initialisés DesignerRegion à la DesignerRegionCollection collection. Si vous le souhaitez, vous pouvez gérer les clics de souris dans les régions de l’aire de conception en substituant la OnClick méthode.

Utilisez les propriétés d’un DesignerRegion objet pour déterminer le mode d’affichage de la zone par le concepteur visuel. Substituez la Selectable propriété pour indiquer que la zone peut être sélectionnée par l’utilisateur sur l’aire de conception. 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. Utilisez les DisplayName Description Propriétés et pour stocker ou récupérer des détails supplémentaires sur la région. 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. 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.

Constructeurs

DesignerRegion(ControlDesigner, String)	Initialise une nouvelle instance de la classe DesignerRegion avec le nom spécifié pour un Concepteur de contrôles.
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.

Champs

DesignerRegionAttributeName

Définit le nom d'attribut HTML pour une zone du concepteur.

Propriétés

Description	Obtient ou définit la description pour une zone du concepteur.
Designer	Obtient le composant de concepteur associé. (Hérité de DesignerObject)
DisplayName	Obtient ou définit le nom complet convivial pour une zone du concepteur.
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.
Highlight	Obtient ou définit une valeur indiquant si la zone du concepteur doit être mise en surbrillance dans l'aire de conception.
Name	Obtient le nom de l'objet. (Hérité de DesignerObject)
Properties	Obtient les propriétés de l'objet. (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.
Selected	Obtient ou définit une valeur indiquant si la zone du concepteur est actuellement sélectionnée dans l'aire de conception.
UserData	Obtient ou définit les données de l'utilisateur facultatives à associer à la zone du concepteur.

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetBounds()	Récupère la taille de la zone du concepteur dans l'aire de conception.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetService(Type)	Obtient un service de l'hôte de conception, tel qu'identifié par le type fourni. (Hérité de DesignerObject)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

IServiceProvider.GetService(Type)

Pour obtenir une description de ce membre, consultez GetService(Type).

(Hérité de DesignerObject)

S’applique à