DesignerActionList.GetSortedActionItems Methode

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

Retouren

Een DesignerActionItem matrix die de items in deze lijst bevat.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een verzameling DesignerActionItem objecten maakt.

Zie Hoe to: Infolabels koppelen aan een Windows Forms-onderdeel voor een volledige uitleg van dit codevoorbeeld.

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

Opmerkingen

De virtualGetSortedActionItems methode wordt geïmplementeerd om, in de verwachte weergavevolgorde, een verzameling objecten te retourneren die zijn afgeleid van de DesignerActionItem klasse. Deze items kunnen van de volgende specifieke typen zijn.

Voor elke DesignerActionMethodItem en DesignerActionPropertyItem, moet een bijbehorende methode of eigenschap worden toegevoegd aan de door programmeurs geleverde klasse die is afgeleid van de DesignerActionList klasse. Elk methode- en eigenschapsitem wordt weergegeven als een actieve vermelding; Interactie met deze methode via de gebruikersinterface (UI) roept respectievelijk de bijbehorende methode of eigenschap aan.

Eigenschapsitems hebben een speciale interface voor paneelitems waarmee de bijbehorende eigenschapswaarden kunnen worden weergegeven en gemanipuleerd. Zie de DesignerActionPropertyItem klas voor meer informatie.

De volgorde van de items in de geretourneerde matrix weerspiegelt de volgorde die ze in het deelvenster weergeven. De items worden gegroepeerd op basis van de Category eigenschap, met behulp van de volgende regels:

• De categorie van het eerste item dat is aangetroffen, geeft het begin van de eerste groep aan. Deze groep gaat door zolang elk voltooiend item van dezelfde categorie is. Wanneer een item van een andere categorie wordt aangetroffen, wordt er een nieuwe groep gemaakt en wordt het item erin geplaatst.

• Als een item een ander type heeft dan de huidige groep, maar die categorie al is gebruikt, wordt het item in de overeenkomende bestaande categorie geplaatst.

• Als een item geen categorie heeft, wordt het aan het einde van het deelvenster in een diverse groep geplaatst. Deze groep bevat ook items waarvan AllowAssociate de eigenschap is ingesteld op false.

De GetSortedActionItems methode wordt aangeroepen wanneer het deelvenster voor het eerst wordt gemaakt. U moet de Refresh methode aanroepen om de lijst met items in het deelvenster bij te werken.

Zie ook

• DesignerActionItem
• Category
• AllowAssociate
• PropertyDescriptor