DesignerActionPropertyItem Třída

Definice

Obor názvů:

System.ComponentModel.Design

Sestavení:

System.Windows.Forms.Design.dll

Zdroj:

DesignerActionPropertyItem.cs

Představuje položku panelu, která je přidružena k vlastnosti ve třídě odvozené od DesignerActionList. Tuto třídu nelze zdědit.

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

Dědičnost

Object

DesignerActionItem

DesignerActionPropertyItem

Příklady

Následující příklad kódu ukazuje, jak vytvořit kolekci DesignerActionItem objektů. Úplný příklad implementace inteligentních značek najdete v tématu Postupy: Připojení inteligentních značek ke komponentě 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

Poznámky

Třída DesignerActionPropertyItem představuje jednotlivé položky na panelu inteligentních značek. Každá položka je obvykle přidružena k vlastnosti ve třídě, která je odvozena z DesignerActionList třídy a dodána autorem komponenty. Přidružení se udržuje prostřednictvím názvu vlastnosti, jak je uloženo ve MemberName vlastnosti.

Jednotlivé položky panelu jsou přidružené k vytvoření panelu voláním GetSortedActionItems metody DesignerActionList třídy.

Chcete-li zobrazit hodnotu přidružené vlastnosti, musí mít tato vlastnost metodu get přístupového objektu. Chcete-li povolit úpravy, musí mít vlastnost metodu přístupového objektu set . Způsob, jakým panel umožňuje přímé úpravy položky vlastnosti uživatelem, závisí na podpůrných informacích o typu, které jsou k dispozici pro datový typ přidružené vlastnosti. Následující tabulka ukazuje pravděpodobné schéma.

Informace o typu vlastnosti	Položka vlastnosti, která upravuje uživatelské rozhraní
Má přidružený editor typů (UITypeEditor)	Editor typů přidružený k podkladové vlastnosti se zobrazí pro úpravu hodnoty vlastnosti.
Má přidružený převaděč typů na známý typ (TypeConverter)	Editor typů známého typu se zobrazí pro úpravu hodnoty vlastnosti. Například převaděč typů, který String pravděpodobně zobrazí TextBox.
Logická hodnota	Položka se zobrazí pomocí binárního uživatelského rozhraní, například značky zaškrtnutí.
Žádná z výše uvedených možností.	Položka se zobrazí jako needitovatelný textový řetězec pomocí metody datového ToString typu.

Všechny základní typy, například System.Booleana běžné datové typy rozhraní .NET Framework, například System.String, poskytují standardní převaděče typů a editory. Další informace o převaděčích typů naleznete v tématu Postupy: Implementace převaděče typů nebo zobecněného převodu typů. Další informace o editorech typů naleznete v tématu Postupy: Implementace editoru typů uživatelského rozhraní.

Konstruktory

Name	Description
DesignerActionPropertyItem(String, String, String, String)	Inicializuje novou instanci DesignerActionPropertyItem třídy se zadanou vlastností a názvy kategorií a zobrazí a popis text.
DesignerActionPropertyItem(String, String, String)	Inicializuje novou instanci DesignerActionPropertyItem třídy se zadanou vlastností a názvy kategorií a zobrazovaný text.
DesignerActionPropertyItem(String, String)	Inicializuje novou instanci DesignerActionPropertyItem třídy se zadanou vlastností a zobrazovanými názvy.

Vlastnosti

Name	Description
AllowAssociate	Získá nebo nastaví hodnotu označující, zda má být tato položka umístěna do skupiny položek, které mají stejnou Category hodnotu vlastnosti. (Zděděno od DesignerActionItem)
Category	Získá název skupiny pro položku. (Zděděno od DesignerActionItem)
Description	Získá doplňkový text pro položku. (Zděděno od DesignerActionItem)
DisplayName	Získá text pro tuto položku. (Zděděno od DesignerActionItem)
MemberName	Získá název vlastnosti, ke které je tato položka přidružena.
Properties	Získá odkaz na kolekci, která lze použít k ukládání programátor-definovaných párů klíč/hodnota. (Zděděno od DesignerActionItem)
RelatedComponent	Získá nebo nastaví komponentu, která přispívá svými položkami na aktuální panel.
ShowInSourceView	Získá nebo nastaví hodnotu, která určuje, zda se tato položka zobrazí v zobrazení zdrojového kódu. (Zděděno od DesignerActionItem)

Viz také

• MemberName
• DesignerActionList
• GetSortedActionItems()
• Příkazy návrháře a objektový model DesignerAction pro Windows Forms