DesignerActionItem Classe

Definizione

Fornisce la classe base per i tipi che rappresentano un elemento del pannello in un pannello smart tag.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
Ereditarietà
DesignerActionItem
Derivato

Esempi

Nell'esempio di codice riportato di seguito viene illustrato come creare DesignerActionItem una raccolta di oggetti.The following code example demonstrates how to create a collection of DesignerActionItem objects.

Per un esempio completo dell'implementazione di smart tag, vedere Procedura: Consente di connettere smart tag a uncomponente Windows Forms.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

Commenti

La DesignerActionItem classe funge da base astratta per le classi che rappresentano singoli elementi del pannello in un pannello smart tag, che rappresenta un'interfaccia utente di tipo menu per gli smart tag.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. Fornisce classi derivate che rappresentano le diverse voci comuni in un pannello smart tag, inclusi testo normale, testo intestazione, proprietà e metodi della classe DesignerActionList associata e verbi di progettazione. .NET Framework.NET FrameworkThe .NET Framework.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 genere, DesignerAction la funzionalità è definita in una classe fornita dal programmatore derivata DesignerActionListda, che contiene GetSortedActionItems un metodo che raggruppa singoli elementi del pannello per formare il pannello smart tag.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. I DesignerActionPropertyItem tipi DesignerActionMethodItem e sono associati ai membri della classe derivata da DesignerActionListe DesignerActionMethodItem gli oggetti vengono attivati quando la voce del pannello associato viene selezionata dall'utente.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.

Nota

I moduli e le finestre di dialogo possono essere visualizzati dai membri della classe DesignerActionListderivata da.Forms and dialog boxes can be displayed by members of the class derived from DesignerActionList. Per impostazione predefinita, l'elemento padre di queste finestre sarà la finestra del contenitore per il pannello smart tag.By default, the parent of these windows will be the container window for the smart tag panel. L'elemento padre di queste finestre figlio in modo esplicito a un altro servizio o a un'altra finestra potrebbe causare la visualizzazione non corretta degli elementi.Explicitly parenting these child windows to another service or window may cause items to display improperly.

Costruttori

DesignerActionItem(String, String, String)

Inizializza una nuova istanza della classe DesignerActionItem.Initializes a new instance of the DesignerActionItem class.

Proprietà

AllowAssociate

Ottiene o imposta un valore che indica se consentire il posizionamento di questo elemento in un gruppo di elementi con lo stesso valore per la proprietà Category.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

Ottiene il nome del gruppo per un elemento.Gets the group name for an item.

Description

Ottiene il testo aggiuntivo per l'elemento.Gets the supplemental text for the item.

DisplayName

Ottiene il testo per l'elemento.Gets the text for this item.

Properties

Ottiene un riferimento a un insieme che può essere utilizzato per memorizzare coppie chiave/valore definite dal programmatore.Gets a reference to a collection that can be used to store programmer-defined key/value pairs.

ShowInSourceView

Ottiene o imposta un valore che indica se questo elemento compare nella visualizzazione del codice sorgente.Gets or sets a value that indicates whether this item appears in source code view.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Si applica a

Vedi anche