SelectionItemPattern.ElementAddedToSelectionEvent Feld

Definition

Bezeichnet das Ereignis,das ausgelöst wird, wenn ein Element zu einer Auflistung ausgewählter Elemente hinzugefügt wird.

public: static initonly System::Windows::Automation::AutomationEvent ^ ElementAddedToSelectionEvent;
public static readonly System.Windows.Automation.AutomationEvent ElementAddedToSelectionEvent;
 staticval mutable ElementAddedToSelectionEvent : System.Windows.Automation.AutomationEvent
Public Shared ReadOnly ElementAddedToSelectionEvent As AutomationEvent 

Feldwert

Beispiele

Im folgenden Beispiel werden Ereignislistener für die SelectionItemPattern Ereignisse deklariert.

///--------------------------------------------------------------------
/// <summary>
/// Subscribe to the selection item events of interest.
/// </summary>
/// <param name="selectionItem">
/// Automation element that supports SelectionItemPattern and is 
/// a child of a selection container that supports SelectionPattern
/// </param>
/// <remarks>
/// The events are raised by the SelectionItem elements, 
/// not the Selection container.
/// </remarks>
///--------------------------------------------------------------------
private void SetSelectionEventHandlers
    (AutomationElement selectionItem)
{
    AutomationEventHandler selectionHandler =
        new AutomationEventHandler(SelectionHandler);

    Automation.AddAutomationEventHandler(
        SelectionItemPattern.ElementSelectedEvent,
        selectionItem,
        TreeScope.Element,
        SelectionHandler);
    Automation.AddAutomationEventHandler(
        SelectionItemPattern.ElementAddedToSelectionEvent,
        selectionItem,
        TreeScope.Element,
        SelectionHandler);
    Automation.AddAutomationEventHandler(
        SelectionItemPattern.ElementRemovedFromSelectionEvent,
        selectionItem,
        TreeScope.Element,
        SelectionHandler);
}

private void SelectionHandler(object src, AutomationEventArgs e)
{
    // TODO: event handling
}
'''--------------------------------------------------------------------
''' <summary>
''' Subscribe to the selection item events of interest.
''' </summary>
''' <param name="selectionItem">
''' Automation element that supports SelectionItemPattern and is 
''' a child of a selection container that supports SelectionPattern
''' </param>
''' <remarks>
''' The events are raised by the SelectionItem elements, 
''' not the Selection container.
''' </remarks>
'''--------------------------------------------------------------------
Private Sub SetSelectionEventHandlers( _
ByVal selectionItem As AutomationElement)
    Dim selectionHandler As AutomationEventHandler = _
    New AutomationEventHandler(AddressOf OnSelectionHandler)

    Automation.AddAutomationEventHandler( _
    SelectionItemPattern.ElementSelectedEvent, _
    selectionItem, TreeScope.Element, selectionHandler)
    Automation.AddAutomationEventHandler( _
    SelectionItemPattern.ElementAddedToSelectionEvent, _
    selectionItem, TreeScope.Element, selectionHandler)
    Automation.AddAutomationEventHandler( _
    SelectionItemPattern.ElementRemovedFromSelectionEvent, _
    selectionItem, TreeScope.Element, selectionHandler)
End Sub


Private Sub OnSelectionHandler(ByVal src As Object, ByVal e As AutomationEventArgs)
    ' TODO: event handling
End Sub

Hinweise

Wenn das Ergebnis eines Aufrufs AddToSelection ein einzelnes ausgewähltes Element ist, wird stattdessen ein ElementSelectedEvent ausgelöst.

Dieser Bezeichner wird von Benutzeroberflächenautomatisierungsclientanwendungen verwendet. Benutzeroberflächenautomatisierungsanbieter sollten das entsprechende Feld in SelectionItemPatternIdentifiersverwenden.

Gilt für: