DesignerActionItem Clase

Definición

Proporciona la clase base para los tipos que representan un elemento de panel en un panel de etiquetas inteligentes.Provides the base class for types that represent a panel item on a smart tag panel.

public ref class DesignerActionItem abstract
public abstract class DesignerActionItem
type DesignerActionItem = class
Public MustInherit Class DesignerActionItem
Herencia
DesignerActionItem
Derivado

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear una colección de DesignerActionItem objetos.The following code example demonstrates how to create a collection of DesignerActionItem objects.

Para obtener un ejemplo completo de la implementación de etiquetas inteligentes, consulte Cómo: adjuntar etiquetas inteligentes a un componente de Windows Forms.For a full example of implementing smart tags, see How to: Attach Smart Tags to a Windows Forms Component.

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

Comentarios

La DesignerActionItem clase actúa como base abstracta para las clases que representan elementos de panel individuales en un panel de etiquetas inteligentes, que representa una interfaz de usuario de tipo menú (UI) para etiquetas inteligentes.The DesignerActionItem class serves as an abstract base for classes that represent individual panel items in a smart tag panel, which represents a menu-like user interface (UI) for smart tags. .NET Framework.NET FrameworkProporciona clases derivadas que representan las distintas entradas comunes en un panel de etiquetas inteligentes, como texto sin formato, texto de encabezado, propiedades y métodos de la DesignerActionList clase asociada y verbos del diseñador.The .NET Framework.NET Framework supplies derived classes that represent the different common entries in a smart tag panel, including plain text, header text, properties and methods of the associated DesignerActionList class, and designer verbs.

Normalmente, la DesignerAction característica se define en una clase proporcionada por el programador derivada de DesignerActionList , que contiene un GetSortedActionItems método que agrupa los elementos individuales del panel para formar el panel de etiquetas inteligentes.Typically, your DesignerAction feature is defined in a programmer-supplied class derived from DesignerActionList, which contains a GetSortedActionItems method that groups individual panel items together to form the smart tag panel. Los DesignerActionPropertyItem DesignerActionMethodItem tipos y se asocian a los miembros de la clase derivada de DesignerActionList y DesignerActionMethodItem los objetos se activan cuando el usuario selecciona su entrada de panel asociada.The DesignerActionPropertyItem and DesignerActionMethodItem types are associated with members of the class derived from DesignerActionList, and DesignerActionMethodItem objects are activated when their associated panel entry is selected by the user.

Nota

Los formularios y cuadros de diálogo pueden ser mostrados por miembros de la clase derivada de DesignerActionList .Forms and dialog boxes can be displayed by members of the class derived from DesignerActionList. De forma predeterminada, el elemento primario de estas ventanas será la ventana contenedora del panel de etiquetas inteligentes.By default, the parent of these windows will be the container window for the smart tag panel. Al pausar explícitamente estas ventanas secundarias en otro servicio o ventana, es posible que los elementos no se muestren correctamente.Explicitly parenting these child windows to another service or window may cause items to display improperly.

Constructores

DesignerActionItem(String, String, String)

Inicializa una nueva instancia de la clase DesignerActionItem.Initializes a new instance of the DesignerActionItem class.

Propiedades

AllowAssociate

Obtiene o establece un valor que indica si se permite colocar este elemento en un grupo de elementos cuya propiedad Category tenga el mismo valor.Gets or sets a value indicating whether to allow this item to be placed into a group of items that have the same Category property value.

Category

Obtiene el nombre de grupo para un elemento.Gets the group name for an item.

Description

Obtiene el texto complementario para el elemento.Gets the supplemental text for the item.

DisplayName

Obtiene el texto para este elemento.Gets the text for this item.

Properties

Obtiene una referencia a una colección que se puede utilizar para almacenar los pares de clave/valor definidos por programador.Gets a reference to a collection that can be used to store programmer-defined key/value pairs.

ShowInSourceView

Obtiene o establece un valor que indica si este elemento aparece en la vista de código fuente.Gets or sets a value that indicates whether this item appears in source code view.

Métodos

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Se aplica a

Consulte también