DesignerActionPropertyItem Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.ComponentModel.Design

Zestaw:: System.Design.dll

Zestaw:: System.Windows.Forms.Design.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Reprezentuje element panelu skojarzony z właściwością klasy pochodzącej z DesignerActionListklasy . Klasa ta nie może być dziedziczona.

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

Dziedziczenie: Object

DesignerActionItem
DesignerActionPropertyItem

Przykłady

W poniższym przykładzie kodu pokazano, jak utworzyć kolekcję DesignerActionItem obiektów. Pełny przykład implementowania tagów inteligentnych można znaleźć w temacie How to: Attach Smart Tags to a Windows Forms Component (Instrukcje: dołączanie tagów inteligentnych do składnika 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

Uwagi

Klasa DesignerActionPropertyItem reprezentuje poszczególne elementy w panelu tagów inteligentnych. Każdy element jest zwykle skojarzony z właściwością w klasie, która pochodzi z DesignerActionList klasy i dostarczana przez autora składnika. Skojarzenie jest utrzymywane za pomocą nazwy właściwości przechowywanej MemberName we właściwości .

Poszczególne elementy panelu są skojarzone ze sobą w celu utworzenia panelu przez wywołanie GetSortedActionItems metody DesignerActionList klasy.

Aby wyświetlić wartość skojarzonej właściwości, ta właściwość musi mieć metodę get dostępu; aby umożliwić edycję, właściwość musi mieć metodę set dostępu. Sposób, w jaki panel umożliwia bezpośrednią edycję elementu właściwości przez użytkownika, zależy od informacji o typie pomocniczym dostępnym dla typu danych skojarzonej właściwości. W poniższej tabeli przedstawiono prawdopodobny schemat.

Informacje o typie właściwości	Interfejs użytkownika (UI) edytowania elementu właściwości
Ma skojarzony edytor typów (UITypeEditor)	Edytor typów skojarzony z właściwością podstawową jest wyświetlany do edytowania wartości właściwości.
Ma skojarzony konwerter typów ze znanym typem (TypeConverter)	Edytor typów dla znanego typu jest wyświetlany do edycji wartości właściwości. Na przykład konwerter typów, aby String prawdopodobnie wyświetlić TextBox.
Wartość logiczna	Element jest wyświetlany przy użyciu binarnego interfejsu użytkownika, takiego jak znacznik wyboru.
Żadne z powyższych.	Element jest wyświetlany jako nieedytowalny ciąg tekstowy przy użyciu metody typu ToString danych.

Wszystkie podstawowe typy, takie jak System.Boolean, i wspólne typy danych .NET Framework, takie jak System.String, dostarczają standardowe konwertery typów i edytory. Aby uzyskać więcej informacji na temat konwerterów typów, zobacz Instrukcje: implementowanie konwertera typów lub uogólnionej konwersji typów. Aby uzyskać więcej informacji na temat edytorów typów, zobacz How to: Implement a UI Type Redaktor (Instrukcje: implementowanie typu interfejsu użytkownika Redaktor).

Konstruktory

DesignerActionPropertyItem(String, String)	Inicjuje DesignerActionPropertyItem nowe wystąpienie klasy z określoną właściwością i nazwami wyświetlanymi.
DesignerActionPropertyItem(String, String, String)	Inicjuje DesignerActionPropertyItem nowe wystąpienie klasy z określoną właściwością i nazwami kategorii oraz wyświetla tekst.
DesignerActionPropertyItem(String, String, String, String)	Inicjuje DesignerActionPropertyItem nowe wystąpienie klasy z określoną właściwością i nazwami kategorii oraz tekstem wyświetlania i opisu.

Właściwości

AllowAssociate	Pobiera lub ustawia wartość wskazującą, czy zezwolić na umieszczenie tego elementu w grupie elementów, które mają tę samą Category wartość właściwości. (Odziedziczone po DesignerActionItem)
Category	Pobiera nazwę grupy dla elementu. (Odziedziczone po DesignerActionItem)
Description	Pobiera tekst uzupełniający dla elementu. (Odziedziczone po DesignerActionItem)
DisplayName	Pobiera tekst dla tego elementu. (Odziedziczone po DesignerActionItem)
MemberName	Pobiera nazwę właściwości, z którą jest skojarzony ten element.
Properties	Pobiera odwołanie do kolekcji, która może służyć do przechowywania par klucz/wartość zdefiniowana przez programistę. (Odziedziczone po DesignerActionItem)
RelatedComponent	Pobiera lub ustawia składnik, który współtworzy jego elementy do bieżącego panelu.
ShowInSourceView	Pobiera lub ustawia wartość wskazującą, czy ten element jest wyświetlany w widoku kodu źródłowego. (Odziedziczone po DesignerActionItem)

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Dotyczy