Compartir vía

DesignerActionList.GetSortedActionItems Método

  • Referencia

Definición

Espacio de nombres:
System.ComponentModel.Design
Ensamblado:
System.Design.dll
Ensamblado:
System.Windows.Forms.Design.dll

Devuelve la colección de DesignerActionItem objetos contenidos en la lista.

public:
 virtual System::ComponentModel::Design::DesignerActionItemCollection ^ GetSortedActionItems();
public virtual System.ComponentModel.Design.DesignerActionItemCollection GetSortedActionItems ();
abstract member GetSortedActionItems : unit -> System.ComponentModel.Design.DesignerActionItemCollection
override this.GetSortedActionItems : unit -> System.ComponentModel.Design.DesignerActionItemCollection
Public Overridable Function GetSortedActionItems () As DesignerActionItemCollection

Devoluciones

DesignerActionItemCollection

Matriz DesignerActionItem que contiene los elementos de esta lista.

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear una colección de objetos DesignerActionItem.

Para obtener una explicación completa de este ejemplo de código, vea Cómo: Asociar etiquetas inteligentes a un componente de 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

Comentarios

El método virtualGetSortedActionItems se implementa para devolver, en el orden de visualización esperado, una colección de objetos derivados de la clase DesignerActionItem. Estos elementos pueden ser de los siguientes tipos específicos.

Tipo Descripción
DesignerActionHeaderItem Etiqueta de grupo, que se muestra en negrita.
DesignerActionTextItem Una etiqueta, que se muestra en una fuente sin formato.
DesignerActionPropertyItem Elemento de panel asociado a una propiedad . También puede mostrar una marca de verificación o un editor de propiedades asociado a la propiedad subyacente.
DesignerActionMethodItem Elemento de panel que se muestra como hipervínculo y asociado a un método .

Para cada DesignerActionMethodItem y DesignerActionPropertyItem, se debe agregar un método o propiedad correspondiente a la clase proporcionada por el programador derivada de la clase DesignerActionList. Cada método y elemento de propiedad se muestran como una entrada activa; interactuar con él a través de la interfaz de usuario (UI) invoca el método o la propiedad correspondientes, respectivamente.

Los elementos de propiedad tienen una interfaz especial de elemento de panel que permite mostrar y manipular sus valores de propiedad correspondientes. Para obtener más información, consulte la clase DesignerActionPropertyItem.

El orden de los elementos de la matriz devuelta refleja el orden en que aparecerán en el panel. Los elementos se agrupan según la propiedad Category, con las siguientes reglas:

  • La categoría del primer elemento encontrado significa el inicio del primer grupo. Ese grupo continúa siempre que cada elemento correcto sea de la misma categoría. Cuando se encuentra un elemento de otra categoría, se crea un nuevo grupo y se coloca el elemento en él.

  • Si un elemento tiene un tipo diferente al grupo actual, pero esa categoría ya se ha usado, el elemento se coloca en la categoría existente coincidente.

  • Si un elemento no tiene una categoría, se coloca en un grupo varios al final del panel. Este grupo también contiene elementos cuya propiedad AllowAssociate está establecida en false.

Se llama al método GetSortedActionItems cuando se crea el panel por primera vez. Debe llamar al método Refresh para actualizar la lista de elementos mostrados en el panel.

Se aplica a

Consulte también