ISelectionItemProvider.AddToSelection Methode

Definition

Namespace:

System.Windows.Automation.Provider

Assembly:

UIAutomationProvider.dll

Fügt das aktuelle Element zur Sammlung ausgewählter Elemente hinzu.

public:
 void AddToSelection();

public void AddToSelection ();

abstract member AddToSelection : unit -> unit

Public Sub AddToSelection ()

Beispiele

Im folgenden Beispielcode wird das Element einer Auflistung ausgewählter Elemente hinzugefügt.

/// <summary>
/// Adds an item to the selection for list boxes that 
/// support multiple selection.
/// </summary>
/// <remarks>
/// In a single-selection list box, AddToSelection() is 
/// equivalent to Select().
/// selectedItems is the collection of selected ListItems.
/// </remarks>
public void AddToSelection()
{
    // Return if the item is already selected.
    if (((ISelectionItemProvider)this).IsSelected)
        return;
    selectedItems.Add(this);
    // TODO: Update UI.
}

''' <summary>
''' Adds an item to the selection for list boxes that 
''' support multiple selection.
''' </summary>
''' <remarks>
''' In a single-selection list box, AddToSelection() is 
''' equivalent to Select().
''' selectedItems is the collection of selected ListItems.
''' </remarks>
Public Sub AddToSelection() Implements ISelectionItemProvider.AddToSelection
    ' Return if the item is already selected.
    If (CType(Me, ISelectionItemProvider)).IsSelected Then
        Return
    End If
    selectedItems.Add(Me)
    ' TODO: Update UI.
End Sub

/// <summary>
/// Specifies whether the item is selected.
/// </summary>
/// <remarks>
/// selectedItems is the collection of selected ListItems.
/// </remarks>
public bool IsSelected
{
    get
    {
        return selectedItems.Contains(this);
    }
}

''' <summary>
''' Specifies whether the item is selected.
''' </summary>
''' <remarks>
''' selectedItems is the collection of selected ListItems.
''' </remarks>
Public ReadOnly Property IsSelected() As Boolean Implements ISelectionItemProvider.IsSelected
    Get
        Return selectedItems.Contains(Me)
    End Get
End Property

Hinweise

Wenn das Ergebnis eines Aufrufs AddToSelection von ist, dass ein einzelnes Element ausgewählt wird, senden Sie eine ElementSelectedEvent für dieses Element; senden Sie andernfalls oder ElementAddedToSelectionEventElementRemovedFromSelectionEvent nach Bedarf.

Hinweis

Diese Regel hängt nicht davon ab, ob der Container eine oder mehrere Auswahlmöglichkeiten zulässt oder welche Methode zum Ändern der Auswahl verwendet wurde. Nur das Ergebnis ist wichtig.

Weitere Informationen

• Implementieren des SelectionItem-Steuerelementmusters der Benutzeroberflächenautomatisierung
• Beispiel für einen Fragmentanbieter