DesignerActionMethodItem Classe

Définition

Espace de noms:

System.ComponentModel.Design

Assembly:

System.Windows.Forms.Design.dll

Source:

DesignerActionMethodItem.cs

Représente un élément de panneau d’étiquettes actives associé à une méthode dans une classe dérivée de DesignerActionList.

public ref class DesignerActionMethodItem : System::ComponentModel::Design::DesignerActionItem

public class DesignerActionMethodItem : System.ComponentModel.Design.DesignerActionItem

type DesignerActionMethodItem = class
    inherit DesignerActionItem

Public Class DesignerActionMethodItem
Inherits DesignerActionItem

Héritage

Object

DesignerActionItem

DesignerActionMethodItem

Exemples

L’exemple de code suivant montre comment créer une collection d’objets DesignerActionItem .

Pour obtenir un exemple complet d’implémentation de balises actives, consultez Guide pratique pour attacher des balises actives à un composant Windows Forms.

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;
}

Public Overrides Function GetSortedActionItems() _
As DesignerActionItemCollection
    Dim items As 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 Not LockColors Then
        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( _
        Me, _
        "InvertColors", _
        "Invert Colors", _
        "Appearance", _
        "Inverts the fore and background colors.", _
        True))
    End If
    items.Add( _
    New DesignerActionPropertyItem( _
    "Text", _
    "Text String", _
    "Appearance", _
    "Sets the display text."))

    'Create entries for static Information section.
    Dim location As New StringBuilder("Location: ")
    location.Append(colLabel.Location)
    Dim size As New StringBuilder("Size: ")
    size.Append(colLabel.Size)

    items.Add( _
    New DesignerActionTextItem( _
    location.ToString(), _
    "Information"))

    items.Add( _
    New DesignerActionTextItem( _
    size.ToString(), _
    "Information"))

    Return items
End Function

Remarques

La DesignerActionMethodItem classe représente des éléments individuels dans un panneau d’étiquettes actives. Un élément de ce type est affiché en tant qu’élément d’interface utilisateur actif, tel qu’un lien hypertexte, qui appelle une méthode fournie par le programmeur dans une classe dérivée de DesignerActionList. L’association entre l’élément et la méthode est conservée par le biais de la valeur de la MemberName propriété. La méthode appelée par cet élément ne doit ni prendre de paramètres ni retourner une valeur.

Les éléments de panneau individuels sont associés ensemble pour former un panneau par un appel à la GetSortedActionItems méthode de la DesignerActionList classe.

Constructeurs

Nom	Description
DesignerActionMethodItem(DesignerActionList, String, String, Boolean)	Initialise une nouvelle instance de la DesignerActionMethodItem classe, avec la méthode et les noms d’affichage spécifiés, ainsi qu’un indicateur qui indique si l’élément doit apparaître dans d’autres contextes d’interface utilisateur.
DesignerActionMethodItem(DesignerActionList, String, String, String, Boolean)	Initialise une nouvelle instance de la DesignerActionMethodItem classe, avec la méthode, l’affichage et les noms de catégorie spécifiés, ainsi qu’un indicateur qui indique si l’élément doit apparaître dans d’autres contextes d’interface utilisateur.
DesignerActionMethodItem(DesignerActionList, String, String, String, String, Boolean)	Initialise une nouvelle instance de la DesignerActionMethodItem classe, avec les noms de méthode et de catégorie spécifiés, le texte d’affichage et de description, ainsi qu’un indicateur qui indique si l’élément doit apparaître dans d’autres contextes d’interface utilisateur.
DesignerActionMethodItem(DesignerActionList, String, String, String, String)	Initialise une nouvelle instance de la DesignerActionMethodItem classe, avec les noms de méthode et de catégorie spécifiés, ainsi que le texte d’affichage et de description.
DesignerActionMethodItem(DesignerActionList, String, String, String)	Initialise une nouvelle instance de la DesignerActionMethodItem classe, avec la méthode, l’affichage et les noms de catégorie spécifiés.
DesignerActionMethodItem(DesignerActionList, String, String)	Initialise une nouvelle instance de la DesignerActionMethodItem classe, avec la méthode et les noms d’affichage spécifiés.

Propriétés

Nom	Description
AllowAssociate	Obtient ou définit une valeur indiquant s’il faut autoriser cet élément à être placé dans un groupe d’éléments qui ont la même Category valeur de propriété. (Hérité de DesignerActionItem)
Category	Obtient le nom du groupe d’un élément. (Hérité de DesignerActionItem)
Description	Obtient le texte supplémentaire de l’élément. (Hérité de DesignerActionItem)
DisplayName	Obtient le texte de cet élément. (Hérité de DesignerActionItem)
IncludeAsDesignerVerb	Obtient une valeur qui indique que le DesignerActionMethodItem doit apparaître dans d’autres contextes d’interface utilisateur.
MemberName	Obtient le nom de la méthode DesignerActionMethodItem associée.
Properties	Obtient une référence à une collection qui peut être utilisée pour stocker des paires clé/valeur définies par le programmeur. (Hérité de DesignerActionItem)
RelatedComponent	Obtient ou définit un composant qui contribue à ses DesignerActionMethodItem objets au panneau actuel.
ShowInSourceView	Obtient ou définit une valeur qui indique si cet élément apparaît en mode code source. (Hérité de DesignerActionItem)

Méthodes

Nom	Description
Invoke()	Exécute par programmation la méthode associée au DesignerActionMethodItem.

Voir aussi

• DesignerActionList
• GetSortedActionItems()
• MemberName
• Commandes du concepteur et modèle objet DesignerAction pour Windows Forms