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

Rappresenta un elemento del pannello smart tag associato a un metodo in una classe derivata da DesignerActionList.

public ref class DesignerActionMethodItem : System::ComponentModel::Design::DesignerActionItem

public class DesignerActionMethodItem : System.ComponentModel.Design.DesignerActionItem

type DesignerActionMethodItem = class
    inherit DesignerActionItem

Public Class DesignerActionMethodItem
Inherits DesignerActionItem

Ereditarietà: Object

DesignerActionItem
DesignerActionMethodItem

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 DesignerActionMethodItem classe rappresenta i singoli elementi in un pannello smart tag. Un elemento di questo tipo viene visualizzato come elemento dell'interfaccia utente attivo, ad esempio un collegamento ipertestuale, che richiama un metodo fornito dal programmatore in una classe derivata da DesignerActionList. L'associazione tra l'elemento e il metodo viene mantenuta tramite il valore della MemberName proprietà . Il metodo richiamato da questo elemento non deve accettare parametri né restituire un valore.

I singoli elementi del pannello sono associati per formare un pannello tramite una chiamata al GetSortedActionItems metodo della DesignerActionList classe .

Costruttori

DesignerActionMethodItem(DesignerActionList, String, String)	Inizializza una nuova istanza della classe DesignerActionMethodItem con i nomi di metodo e visualizzati specificati.
DesignerActionMethodItem(DesignerActionList, String, String, Boolean)	Inizializza una nuova istanza della classe DesignerActionMethodItem, con i nomi di metodo e visualizzati specificati, e un flag che indica se l'elemento deve essere visualizzato in altri contesti dell'interfaccia utente.
DesignerActionMethodItem(DesignerActionList, String, String, String)	Inizializza una nuova istanza della classe DesignerActionMethodItem con i nomi di metodo, visualizzati e di categoria specificati.
DesignerActionMethodItem(DesignerActionList, String, String, String, Boolean)	Inizializza una nuova istanza della classe DesignerActionMethodItem, con i nomi di metodo, visualizzati e di categoria specificati, e un flag che indica se l'elemento deve essere visualizzato in altri contesti dell'interfaccia utente.
DesignerActionMethodItem(DesignerActionList, String, String, String, String)	Inizializza una nuova istanza della classe DesignerActionMethodItem, con i nomi di metodo e di categoria specificati, nonché il testo visualizzato e della descrizione.
DesignerActionMethodItem(DesignerActionList, String, String, String, String, Boolean)	Inizializza una nuova istanza della classe DesignerActionMethodItem, con nomi di metodo e di categoria specificati, il testo visualizzato e della descrizione e un flag che indica se l'elemento deve essere visualizzato in altri contesti dell'interfaccia utente.

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. (Ereditato da DesignerActionItem)
Category	Ottiene il nome del gruppo per un elemento. (Ereditato da DesignerActionItem)
Description	Ottiene il testo aggiuntivo per l'elemento. (Ereditato da DesignerActionItem)
DisplayName	Ottiene il testo per l'elemento. (Ereditato da DesignerActionItem)
IncludeAsDesignerVerb	Ottiene un valore che indica che l'oggetto DesignerActionMethodItem deve essere visualizzato in altri contesti dell'interfaccia utente.
MemberName	Ottiene il nome del metodo a cui questo oggetto DesignerActionMethodItem è associato.
Properties	Ottiene un riferimento a un insieme che può essere utilizzato per memorizzare coppie chiave/valore definite dal programmatore. (Ereditato da DesignerActionItem)
RelatedComponent	Ottiene o imposta un componente che fornisce i propri oggetti DesignerActionMethodItem al pannello corrente.
ShowInSourceView	Ottiene o imposta un valore che indica se questo elemento compare nella visualizzazione del codice sorgente. (Ereditato da DesignerActionItem)

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)
Invoke()	Esegue a livello di codice il metodo associato all'oggetto DesignerActionMethodItem.
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