This documentation is archived and is not being maintained.

SelectionItemPattern.ElementAddedToSelectionEvent Field

Identifies the event raised when an item is added to a collection of selected items.

Namespace:  System.Windows.Automation
Assembly:  UIAutomationClient (in UIAutomationClient.dll)

public static readonly AutomationEvent ElementAddedToSelectionEvent

If the result of an AddToSelection call is a single selected item, then an ElementSelectedEvent will be raised instead.

This identifier is used by UI Automation client applications. UI Automation providers should use the equivalent field in SelectionItemPatternIdentifiers.

In the following example, event listeners are declared for the SelectionItemPattern events.

///-------------------------------------------------------------------- 
/// <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
}

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0
Show: