DesignerActionItem Classe

  • Riferimento

Definizione

Spazio dei nomi:
System.ComponentModel.Design
Assembly:
System.Design.dll
Assembly:
System.Windows.Forms.Design.dll

Fornisce la classe base per i tipi che rappresentano un elemento del pannello in un pannello smart tag.

public ref class DesignerActionItem abstract
public abstract class DesignerActionItem
type DesignerActionItem = class
Public MustInherit Class DesignerActionItem
Ereditarietà
Object
DesignerActionItem
Derivato

Esempio

Nell'esempio di codice seguente viene illustrato come creare una raccolta di DesignerActionItem oggetti.

Per un esempio completo dell'implementazione di smart tag, vedere Procedura: Collegare smart tag a un componente 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

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 simile al menu per gli smart tag. .NET Framework fornisce classi derivate che rappresentano le diverse voci comuni in un pannello smart tag, tra cui testo normale, testo di intestazione, proprietà e metodi della classe associata DesignerActionList e verbi di progettazione.

In genere, la DesignerAction funzionalità viene definita in una classe fornita dal programmatore derivata da DesignerActionList, che contiene un GetSortedActionItems metodo che raggruppa singoli elementi del pannello per formare il pannello smart tag. I DesignerActionPropertyItem tipi e DesignerActionMethodItem sono associati ai membri della classe derivata da DesignerActionListe DesignerActionMethodItem gli oggetti vengono attivati quando la voce del pannello associata viene selezionata dall'utente.

Nota

Forms e finestre di dialogo possono essere visualizzate dai membri della classe derivata da DesignerActionList. Per impostazione predefinita, l'elemento padre di queste finestre sarà la finestra del contenitore per il pannello smart tag. Il padre esplicito di queste finestre figlio a un altro servizio o finestra può causare la visualizzazione non corretta degli elementi.

Costruttori

DesignerActionItem(String, String, String)

Inizializza una nuova istanza della classe DesignerActionItem.

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.
Category

Ottiene il nome del gruppo per un elemento.
Description

Ottiene il testo aggiuntivo per l'elemento.
DisplayName

Ottiene il testo per l'elemento.
Properties

Ottiene un riferimento a un insieme che può essere utilizzato per memorizzare coppie chiave/valore definite dal programmatore.
ShowInSourceView

Ottiene o imposta un valore che indica se questo elemento compare nella visualizzazione del codice sorgente.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Si applica a

Vedi anche