DesignerActionItem Classe

Riferimento

Definizione

Spazio dei nomi:: System.ComponentModel.Design

Assembly:: System.Design.dll

Assembly:: System.Windows.Forms.Design.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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: System.ComponentModel.Design.DesignerActionMethodItem

System.ComponentModel.Design.DesignerActionPropertyItem

System.ComponentModel.Design.DesignerActionTextItem

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

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

Le finestre di dialogo e moduli 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

Condividi tramite