DesignerActionPropertyItem Třída

Reference

Definice

Obor názvů:: System.ComponentModel.Design

Sestavení:: System.Design.dll

Sestavení:: System.Windows.Forms.Design.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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 ke komponentě model 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žena MemberName ve 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 pro datový typ přidružené vlastnosti. Následující tabulka ukazuje pravděpodobné schéma.

Informace o typu vlastnosti	Úprava položky vlastnosti uživatelského rozhraní (UI)
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)	Editor typů známého typu se zobrazí pro úpravu hodnoty vlastnosti. Například převaděč typů na bude pravděpodobně zobrazovat String TextBox.
Logická hodnota	Položka se zobrazí pomocí binárního uživatelského rozhraní, jako je například značka 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í převaděče a editory typů. Další informace o převaděčích typů naleznete v tématu Postupy: Implementace převaděče typů nebo Zobecněný převod typů. Další informace o editorech typů najdete v tématu Postupy: Implementace typu uživatelského rozhraní Editor.

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 zobrazeným textem.
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, která je přidružena k této položce.
Properties	Získá odkaz na kolekci, která lze použít k uložení programátorem definované páry klíč/hodnota. (Zděděno od DesignerActionItem)
RelatedComponent	Získá nebo nastaví komponentu, která přispívá jeho položky 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()	Type Získá z aktuální instance. (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)

Platí pro