DesignerActionPropertyItem Classe

Définition

Représente un élément de panneau associé à une propriété dans une classe dérivée de DesignerActionList. Cette classe ne peut pas être héritée.

public ref class DesignerActionPropertyItem sealed : System::ComponentModel::Design::DesignerActionItem
public sealed class DesignerActionPropertyItem : System.ComponentModel.Design.DesignerActionItem
type DesignerActionPropertyItem = class
    inherit DesignerActionItem
Public NotInheritable Class DesignerActionPropertyItem
Inherits DesignerActionItem
Héritage
DesignerActionPropertyItem

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 DesignerActionPropertyItem classe représente des éléments individuels dans un panneau de balise active. Chaque élément est généralement associé à une propriété dans une classe dérivée de la DesignerActionList classe et fournie par l’auteur du composant. L’association est conservée via le nom de la propriété, tel qu’il est stocké dans la MemberName propriété .

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 .

Pour afficher la valeur de la propriété associée, cette propriété doit avoir une get méthode accesseur ; pour permettre la modification, la propriété doit avoir une set méthode accesseur. La façon dont le panneau autorise la modification directe d’un élément de propriété par l’utilisateur dépend des informations de type de prise en charge présentes pour le type de données de la propriété associée. Le tableau suivant montre le schéma probable.

Informations sur le type de propriété Interface utilisateur de modification d’élément de propriété
A un éditeur de type associé (UITypeEditor) L’éditeur de type associé à la propriété sous-jacente s’affiche pour modifier la valeur de la propriété.
A un convertisseur de type associé à un type connu (TypeConverter) L’éditeur de type du type connu s’affiche pour modifier la valeur de la propriété. Par exemple, un convertisseur de type vers String affiche probablement un TextBox.
Valeur booléenne L’élément est affiché à l’aide d’une interface utilisateur binaire, telle qu’une coche.
Aucun des éléments ci-dessus. L’élément s’affiche sous la forme d’une chaîne de texte non modifiable à l’aide de la méthode du type de ToString données.

Tous les types fondamentaux, tels que System.Boolean, et les types de données .NET Framework courants, tels que System.String, fournissent des convertisseurs et des éditeurs de type standard. Pour plus d’informations sur les convertisseurs de types, consultez Guide pratique pour implémenter un convertisseur de type ou uneconversion de type généralisée. Pour plus d’informations sur les éditeurs de type, consultez Guide pratique pour implémenter un éditeur de type d’interface utilisateur.

Constructeurs

DesignerActionPropertyItem(String, String)

Initialise une nouvelle instance de la classe DesignerActionPropertyItem, avec la propriété et les noms complets spécifiés.

DesignerActionPropertyItem(String, String, String)

Initialise une nouvelle instance de la classe DesignerActionPropertyItem, avec la propriété et les noms des catégories spécifiés, ainsi que le texte d'affichage.

DesignerActionPropertyItem(String, String, String, String)

Initialise une nouvelle instance de la classe DesignerActionPropertyItem, avec la propriété et les noms des catégories spécifiés, ainsi que le texte d'affichage et de description.

Propriétés

AllowAssociate

Obtient ou définit une valeur qui indique s'il faut autoriser cet élément à être placé dans un groupe d'éléments ayant la même valeur de propriété Category.

(Hérité de DesignerActionItem)
Category

Obtient le nom de 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 pour cet élément.

(Hérité de DesignerActionItem)
MemberName

Obtient le nom de la propriété à laquelle cet élément est associé.

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 fournit ses éléments au panneau actuel.

ShowInSourceView

Obtient ou définit une valeur qui indique si cet élément s'affiche dans la vue de code source.

(Hérité de DesignerActionItem)

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
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)

S’applique à

Voir aussi