|
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
|
Traduction
Source
|
Procédure pas à pas : ajout de balises actives à un composant Windows Forms
-
Implémentation d'une classe, dérivée de DesignerActionList, qui définit les méthodes et propriétés qui sont les cibles des éléments du menu de balises actives. Cette classe peut également fournir une méthode GetSortedActionItems substituée qui retourne un tableau d'instances de DesignerActionItem. -
La classe du concepteur associée au composant doit implémenter la propriété ActionLists. La récupération de cette propriété fournit la DesignerActionListCollection qui contient toutes les instances DesignerActionList associées à un seul menu de balises actives. Souvent, il n'existe qu'une seule liste dans ce type de collection.
Remarque
|
|---|
|
|
Pour implémenter une classe dérivée de DesignerActionList
-
Dans le même espace de noms que celui de votre composant, ajoutez la déclaration pour votre classe dérivée de DesignerActionList.
Remarque
Vous devez ajouter une référence à l'assembly au moment du design, System.Design.dll. Cet assembly n'est pas inclus dans le Framework 4 Client Profile. Pour ajouter une référence à System.Design.dll, vous devez remplacer le Framework cible du projet par .NET Framework 4. -
Ajoutez à cette classe un constructeur qui accepte une instance du contrôle associé. Fournissez un champ privé pour contenir une référence à cette instance. Fournissez également un champ privé pour mettre en cache une référence au DesignerActionService. Il sera utilisé pour mettre à jour la liste. private ColorLabel colLabel; ... private DesignerActionUIService designerActionUISvc = null; ... public ColorLabelActionList( IComponent component ) : base(component) { this.colLabel = component as ColorLabel; // Cache a reference to DesignerActionUIService, so the // DesigneractionList can be refreshed. this.designerActionUISvc = GetService(typeof(DesignerActionUIService)) as DesignerActionUIService; }
-
Ajoutez les méthodes et les propriétés que vous souhaitez associer aux éléments de balise active. Les méthodes sont exécutées lorsque leur entrée de balise active correspondante est sélectionnée. Les propriétés doivent disposer de sections d'accesseur Get pour que leur valeur actuelle soit affichée. Elles peuvent éventuellement disposer de sections d'accesseur Set qui utilisent la méthode GetProperties si leurs valeurs sont modifiables à partir de l'entrée de balise active correspondante.
Remarque
Comme c'est le cas dans tout l'environnement au moment du design, une propriété peut être modifiée uniquement si l'un des types de base est fourni par le .NET Framework, si le type peut être converti en type de base par un TypeConverter fourni ou lorsqu'un UITypeEditor personnalisé est fourni. public Color ForeColor { get { return colLabel.ForeColor; } set { GetPropertyByName("ForeColor").SetValue(colLabel, value); } } ... // Boolean properties are automatically displayed with binary // UI (such as a checkbox). public bool LockColors { get { return colLabel.ColorLocked; } set { GetPropertyByName("ColorLocked").SetValue(colLabel, value); // Refresh the list. this.designerActionUISvc.Refresh(this.Component); } } ... public void InvertColors() { Color currentBackColor = colLabel.BackColor; BackColor = Color.FromArgb( 255 - currentBackColor.R, 255 - currentBackColor.G, 255 - currentBackColor.B); Color currentForeColor = colLabel.ForeColor; ForeColor = Color.FromArgb( 255 - currentForeColor.R, 255 - currentForeColor.G, 255 - currentForeColor.B); }
-
Implémentez éventuellement une version substituée de la méthode GetSortedActionItems pour retourner un tableau d'instances DesignerActionItem dans lequel chaque élément est associé à une propriété ou une méthode créée à l'étape précédente. Vous pouvez exécuter cette opération pour modifier l'ordre des éléments, les classer ou éventuellement les afficher. La liste peut également inclure des éléments statiques tels que les titres de groupes logiques. public override DesignerActionItemCollection GetSortedActionItems() { DesignerActionItemCollection items = new DesignerActionItemCollection(); //Define static section header entries. items.Add(new DesignerActionHeaderItem("Appearance")); items.Add(new DesignerActionHeaderItem("Information")); //Boolean property for locking color selections. items.Add(new DesignerActionPropertyItem("LockColors", "Lock Colors", "Appearance", "Locks the color properties.")); if (!LockColors) { items.Add(new DesignerActionPropertyItem("BackColor", "Back Color", "Appearance", "Selects the background color.")); items.Add(new DesignerActionPropertyItem("ForeColor", "Fore Color", "Appearance", "Selects the foreground color.")); //This next method item is also added to the context menu // (as a designer verb). items.Add(new DesignerActionMethodItem(this, "InvertColors", "Invert Colors", "Appearance", "Inverts the fore and background colors.", true)); } items.Add(new DesignerActionPropertyItem("Text", "Text String", "Appearance", "Sets the display text.")); //Create entries for static Information section. StringBuilder location = new StringBuilder("Location: "); location.Append(colLabel.Location); StringBuilder size = new StringBuilder("Size: "); size.Append(colLabel.Size); items.Add(new DesignerActionTextItem(location.ToString(), "Information")); items.Add(new DesignerActionTextItem(size.ToString(), "Information")); return items; }
Pour mettre à jour la classe de concepteur associée afin d'implémenter la propriété ActionLists
-
Localisez la classe de concepteur pour le contrôle. S'il n'en existe pas, créez une classe de concepteur et associez-la à la classe de contrôle. Pour plus d'informations sur les concepteurs, consultez Classes de concepteurs de base. -
Comme technique d'optimisation, ajoutez un champ privé de type DesignerActionListCollection. -
Ajoutez la propriété ActionLists substituée pour retourner une nouvelle instance de la classe ColorLabelActionList que vous avez créée précédemment.
-
Lorsqu'une propriété ou une méthode dans la classe dérivée de DesignerActionList modifie l'état du contrôle associé, ces modifications ne doivent pas être effectuées par des appels d'accesseur Set directs aux propriétés du composant. Ces modifications doivent plutôt être effectuées par le biais d'un PropertyDescriptor créé de manière appropriée. Cette approche indirecte garantit que les opérations d'annulation de balise active et de mise à jour de l'interface utilisateur s'exécutent correctement. -
Vous pouvez mettre à jour dynamiquement le panneau des balises actives en appelant DesignerActionUIService.Refresh. Ce processus peut être utilisé pour modifier dynamiquement le contenu du panneau des balises actives. Dans l'exemple, les balises actives concernées par la modification des couleurs sont incluses de manière conditionnelle selon l'état de la propriété LockColors. Cette propriété booléenne est également associée à une balise active, de sorte que le développeur peut verrouiller ou déverrouiller la sélection de couleurs actuelle, au moins par le menu. -
Une entrée de balise active de type DesignerActionMethodItem peut éventuellement être incluse dans le menu contextuel pour le contrôle associé en affectant au paramètre includeAsDesignerVerb la valeur true dans le constructeur. Le .NET Framework crée alors implicitement un DesignerVerb correspondant, puis l'ajoute au menu contextuel. Dans cet exemple, l'élément InvertColors est traité de cette manière. -
Les éléments de balise active sont regroupés dans un panneau par leur propriété Category, qui est définie dans le constructeur pour chaque élément. Si cette propriété n'est pas explicitement définie, elle est assignée à la catégorie par défaut. Chaque élément est classé dans le panneau des balises actives par catégorie, puis par ordre d'occurrence dans le tableau DesignerActionItem retourné par la classe dérivée de la classe DesignerActionList. Cet exemple met en jeu deux catégories : Appearance et Information.
Remarque
Aucun DesignerActionHeaderItem n'est fourni pour la deuxième catégorie. -
Une entrée qui affiche des informations textuelles statiques peut être implémentée à l'aide d'un DesignerActionTextItem ou d'un DesignerActionPropertyItem dont la propriété associée contient uniquement un accesseur Set. Cet exemple utilise la première approche.
-
Ajoutez des attributs à vos membres pour faciliter la communication avec l'environnement au moment du design. Pour plus d'informations, consultez Attributs dans les contrôles Windows Forms. -
Écrivez votre propre concepteur personnalisé. Pour plus d'informations, consultez Comment : créer un contrôle Windows Forms qui bénéficie des fonctionnalités au moment du design.
