DesignerActionPropertyItem 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 pannello associato a una proprietà in una classe derivata da DesignerActionList. La classe non può essere ereditata.

public ref class DesignerActionPropertyItem sealed : System::ComponentModel::Design::DesignerActionItem

public sealed class DesignerActionPropertyItem : System.ComponentModel.Design.DesignerActionItem

type DesignerActionPropertyItem = class
    inherit DesignerActionItem

Public NotInheritable Class DesignerActionPropertyItem
Inherits DesignerActionItem

Ereditarietà: Object

DesignerActionItem
DesignerActionPropertyItem

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 DesignerActionPropertyItem classe rappresenta i singoli elementi in un pannello smart tag. Ogni elemento è in genere associato a una proprietà in una classe derivata dalla DesignerActionList classe e fornita dall'autore del componente. L'associazione viene mantenuta tramite il nome della proprietà, come archiviato nella MemberName proprietà .

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

Per visualizzare il valore della proprietà associata, tale proprietà deve avere un get metodo di funzione di accesso. Per consentire la modifica, la proprietà deve disporre di un set metodo di funzione di accesso. Il modo in cui il pannello consente la modifica diretta di un elemento di proprietà da parte dell'utente dipende dalle informazioni sul tipo di supporto presenti per il tipo di dati della proprietà associata. La tabella seguente illustra lo schema probabile.

Informazioni sul tipo di proprietà	Elemento proprietà che modifica l'interfaccia utente
Dispone di un editor di tipi associato (UITypeEditor)	L'editor dei tipi associato alla proprietà sottostante viene visualizzato per modificare il valore della proprietà.
Dispone di un convertitore di tipi associato a un tipo noto (TypeConverter)	L'editor dei tipi per il tipo noto viene visualizzato per modificare il valore della proprietà. Ad esempio, un convertitore di tipi per String visualizzerà probabilmente un oggetto TextBox.
Valore booleano	L'elemento viene visualizzato usando un'interfaccia utente binaria, ad esempio un segno di spunta.
Nessuna delle opzioni precedenti.	L'elemento viene visualizzato come stringa di testo non modificabile usando il metodo del tipo di ToString dati.

Tutti i tipi fondamentali, ad esempio System.Boolean, e i tipi di dati comuni di .NET Framework, ad esempio System.String, forniscono convertitori di tipi standard e editor. Per altre informazioni sui convertitori di tipi, vedere Procedura: Implementare un convertitore di tipi o una conversione di tipi generalizzati. Per altre informazioni sugli editor di tipi, vedere Procedura: Implementare un editor di tipi di interfaccia utente.

Costruttori

DesignerActionPropertyItem(String, String)	Inizializza una nuova istanza della classe DesignerActionPropertyItem con i nomi di proprietà e i nomi visualizzati specificati.
DesignerActionPropertyItem(String, String, String)	Inizializza una nuova istanza della classe DesignerActionPropertyItem, con i nomi di proprietà, di categoria e il testo visualizzato specificati.
DesignerActionPropertyItem(String, String, String, String)	Inizializza una nuova istanza della classe DesignerActionPropertyItem, con i nomi di proprietà e di categoria specificati, nonché il testo della descrizione e quello visualizzato.

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)
MemberName	Ottiene il nome della proprietà a cui è associato l'elemento.
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 rende disponibili i propri elementi 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)
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