DesignerActionItem Klasse

Definition

Stellt die Basisklasse für Typen bereit, die in einem Smarttagbereich ein Bereichselement darstellen.Provides the base class for types that represent a panel item on a smart tag panel.

public ref class DesignerActionItem abstract
public abstract class DesignerActionItem
type DesignerActionItem = class
Public MustInherit Class DesignerActionItem
Vererbung
DesignerActionItem
Abgeleitet

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine Auflistung von-Objekten erstellt wird DesignerActionItem .The following code example demonstrates how to create a collection of DesignerActionItem objects.

Ein vollständiges Beispiel für das Implementieren von Smarttags finden Sie unter Gewusst wie: Anfügen von Smarttags an eine Windows Forms Komponente.For a full example of implementing smart tags, see How to: Attach Smart Tags to a Windows Forms Component.

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

Hinweise

Die- DesignerActionItem Klasse fungiert als abstrakte Basis für Klassen, die einzelne Panel Elemente in einem smarttagpanel darstellen, das eine Menü ähnliche Benutzeroberfläche (UI) für Smarttags darstellt.The DesignerActionItem class serves as an abstract base for classes that represent individual panel items in a smart tag panel, which represents a menu-like user interface (UI) for smart tags. Der .NET Framework stellt abgeleitete Klassen bereit, die die verschiedenen allgemeinen Einträge in einem smarttagpanel darstellen, einschließlich Klartext, Header Text, Eigenschaften und Methoden der zugeordneten DesignerActionList Klasse und Designer Verben.The .NET Framework supplies derived classes that represent the different common entries in a smart tag panel, including plain text, header text, properties and methods of the associated DesignerActionList class, and designer verbs.

In der Regel DesignerAction wird das Feature in einer vom Programmierer bereitgestellten Klasse definiert DesignerActionList , die von abgeleitet ist und eine Methode enthält, GetSortedActionItems die einzelne Panel Elemente gruppiert, um den Smarttagbereich zu bilden.Typically, your DesignerAction feature is defined in a programmer-supplied class derived from DesignerActionList, which contains a GetSortedActionItems method that groups individual panel items together to form the smart tag panel. Der DesignerActionPropertyItem -Typ und der-Typ sind den Membern DesignerActionMethodItem der von abgeleiteten Klasse zugeordnet DesignerActionList , und- DesignerActionMethodItem Objekte werden aktiviert, wenn der zugehörige Bereichs Eintrag vom Benutzer ausgewählt wird.The DesignerActionPropertyItem and DesignerActionMethodItem types are associated with members of the class derived from DesignerActionList, and DesignerActionMethodItem objects are activated when their associated panel entry is selected by the user.

Hinweis

Formulare und Dialogfelder können von Membern der von abgeleiteten Klasse angezeigt werden DesignerActionList .Forms and dialog boxes can be displayed by members of the class derived from DesignerActionList. Standardmäßig ist das übergeordnete Element dieses Fensters das Containerfenster für den Smarttagbereich.By default, the parent of these windows will be the container window for the smart tag panel. Das explizite durchführen dieser untergeordneten Fenster in einem anderen Dienst oder Fenster kann dazu führen, dass Elemente nicht ordnungsgemäß angezeigt werden.Explicitly parenting these child windows to another service or window may cause items to display improperly.

Konstruktoren

DesignerActionItem(String, String, String)

Initialisiert eine neue Instanz der DesignerActionItem-Klasse.Initializes a new instance of the DesignerActionItem class.

Eigenschaften

AllowAssociate

Ruft einen Wert ab, der angibt, ob dieses Element in eine Gruppe von Elementen eingefügt werden darf, die denselben Category-Eigenschaftswert aufweisen, oder legt diesen fest.Gets or sets a value indicating whether to allow this item to be placed into a group of items that have the same Category property value.

Category

Ruft den Gruppennamen für ein Element ab.Gets the group name for an item.

Description

Ruft den ergänzenden Text für das Element ab.Gets the supplemental text for the item.

DisplayName

Ruft den Text für dieses Element ab.Gets the text for this item.

Properties

Ruft einen Verweis auf eine Auflistung ab, die zum Speichern von vom Programmierer bereitgestellten Schlüssel-Wert-Paaren verwendet werden kann.Gets a reference to a collection that can be used to store programmer-defined key/value pairs.

ShowInSourceView

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob dieses Element in der Quellcodeansicht angezeigt wird.Gets or sets a value that indicates whether this item appears in source code view.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für:

Siehe auch