DesignerActionHeaderItem 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 dell'intestazione statica di un pannello smart tag. La classe non può essere ereditata.

public ref class DesignerActionHeaderItem sealed : System::ComponentModel::Design::DesignerActionTextItem

public sealed class DesignerActionHeaderItem : System.ComponentModel.Design.DesignerActionTextItem

type DesignerActionHeaderItem = class
    inherit DesignerActionTextItem

Public NotInheritable Class DesignerActionHeaderItem
Inherits DesignerActionTextItem

Ereditarietà: Object

DesignerActionItem

DesignerActionTextItem
DesignerActionHeaderItem

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

Come la DesignerActionTextItem classe di base, DesignerActionHeaderItem rappresenta singoli elementi di testo statici in un pannello smart tag. Tuttavia, DesignerActionHeaderItem le voci vengono visualizzate usando il testo grassetto. In genere, viene usato un elemento di intestazione per creare un'intestazione per un gruppo di elementi in un pannello. Facendo clic su un elemento di intestazione non viene eseguita alcuna azione.

I singoli elementi del pannello sono associati insieme per formare un pannello chiamando il GetSortedActionItems metodo della DesignerActionList classe.

Costruttori

DesignerActionHeaderItem(String)	Inizializza una nuova istanza della classe DesignerActionHeaderItem utilizzando la stringa del nome fornita.
DesignerActionHeaderItem(String, String)	Inizializza una nuova istanza della classe DesignerActionHeaderItem utilizzando le stringhe del nome e della categoria fornite.

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)
Properties	Ottiene un riferimento a un insieme che può essere utilizzato per memorizzare coppie chiave/valore definite dal programmatore. (Ereditato da DesignerActionItem)
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