Udostępnij za pośrednictwem


DesignerActionPropertyItem Klasa

Definicja

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
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 formularzy systemu Windows).

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 typowe typy danych programu .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 Editor (Instrukcje: implementowanie edytora typów interfejsu użytkownika).

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

Zobacz też