DesignerActionPropertyItem Třída

Definice

Obor názvů:

System.ComponentModel.Design

Sestavení:

System.Windows.Forms.Design.dll

Představuje položku panelu, která je přidružena k vlastnosti ve třídě odvozené z DesignerActionList. Tato třída se nemůže dě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 k 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 od DesignerActionList třídy a dodána autorem komponenty. Přidružení se udržuje prostřednictvím názvu vlastnosti, jak je uložen ve MemberName vlastnosti.

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

Aby bylo možné zobrazit hodnotu přidružené vlastnosti, musí mít tato vlastnost metodu get přistupujícího objektu. Aby bylo možné provádět úpravy, musí mít vlastnost metodu přistupujícího objektu set . Způsob, jakým panel umožňuje přímou úpravu položky vlastnosti uživatelem, závisí na informacích o podpůrném 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	Uživatelské rozhraní pro úpravu položky vlastnosti
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ů ke známému typu (TypeConverter)	Pro úpravu hodnoty vlastnosti se zobrazí editor typů známého typu. Například převaděč typů do String bude pravděpodobně zobrazovat 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 neupravitelný textový řetězec pomocí metody datového ToString typu.

Všechny základní typy, jako System.Booleanje , a běžné datové typy rozhraní .NET Framework, jako System.Stringje , poskytují standardní typy převaděčů a editorů. Další informace o převaděčích typů najdete v tématu Postupy: Implementace převaděče typů nebo Převod generalizovaného typu. Další informace o editorech typů najdete v tématu Postupy: Implementace editoru typů uživatelského rozhraní.

Konstruktory

DesignerActionPropertyItem(String, String)	Inicializuje novou instanci DesignerActionPropertyItem třídy se zadanou vlastností a zobrazovanými názvy.
DesignerActionPropertyItem(String, String, String)	Inicializuje novou instanci DesignerActionPropertyItem třídy se zadanými názvy vlastností a kategorií a zobrazí text.
DesignerActionPropertyItem(String, String, String, String)	Inicializuje novou instanci DesignerActionPropertyItem třídy se zadanými názvy vlastností a kategorií a textem zobrazení a popisu.

Vlastnosti

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é páry 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á označuje, zda se tato položka zobrazí v zobrazení zdrojového kódu. (Zděděno od DesignerActionItem)

Metody

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

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