DesignerActionItem 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.

Udostępnia klasę podstawową typów reprezentujących element panelu na panelu tagów inteligentnych.

public ref class DesignerActionItem abstract

public abstract class DesignerActionItem

type DesignerActionItem = class

Public MustInherit Class DesignerActionItem

Dziedziczenie: Object
DesignerActionItem

Pochodne: System.ComponentModel.Design.DesignerActionMethodItem

System.ComponentModel.Design.DesignerActionPropertyItem

System.ComponentModel.Design.DesignerActionTextItem

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 DesignerActionItem służy jako abstrakcyjna podstawa dla klas reprezentujących poszczególne elementy panelu w panelu tagów inteligentnych, który reprezentuje interfejs użytkownika przypominający menu dla tagów inteligentnych. Program .NET Framework dostarcza klasy pochodne reprezentujące różne typowe wpisy w panelu tagów inteligentnych, w tym zwykły tekst, tekst nagłówka, właściwości i metody skojarzonej DesignerActionList klasy oraz czasowniki projektanta.

DesignerAction Zazwyczaj funkcja jest definiowana w klasie dostarczanej przez programistę pochodzącej z DesignerActionListklasy , która zawiera metodę grupującą GetSortedActionItems poszczególne elementy panelu w celu utworzenia panelu inteligentnego. Typy DesignerActionPropertyItem i DesignerActionMethodItem są skojarzone z członkami klasy pochodzącej z DesignerActionListklasy , a DesignerActionMethodItem obiekty są aktywowane po wybraniu przez użytkownika skojarzonego wpisu panelu.

Uwaga

Formularze i okna dialogowe mogą być wyświetlane przez elementy członkowskie klasy pochodzącej z DesignerActionListklasy . Domyślnie element nadrzędny tych okien będzie oknem kontenera dla panelu tagów inteligentnych. Jawne rodzicielstwo tych okien podrzędnych do innej usługi lub okna może spowodować nieprawidłowe wyświetlanie elementów.

Konstruktory

DesignerActionItem(String, String, String)

Inicjuje nowe wystąpienie klasy DesignerActionItem.

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.
Category	Pobiera nazwę grupy dla elementu.
Description	Pobiera tekst uzupełniający dla elementu.
DisplayName	Pobiera tekst dla tego elementu.
Properties	Pobiera odwołanie do kolekcji, która może służyć do przechowywania par klucz/wartość zdefiniowana przez programistę.
ShowInSourceView	Pobiera lub ustawia wartość wskazującą, czy ten element jest wyświetlany w widoku kodu źródłowego.

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 bieżące wystąpienie. (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

Udostępnij za pośrednictwem