Skip to content

Latest commit

 

History

History
86 lines (69 loc) · 3.14 KB

nn-uiautomationcore-iselectionprovider2.md

File metadata and controls

86 lines (69 loc) · 3.14 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NN:uiautomationcore.ISelectionProvider2
ISelectionProvider2 (uiautomationcore.h)
Extends the ISelectionItemProvider interface to provide information about selected items.
ISelectionProvider2
ISelectionProvider2 interface [Windows Accessibility]
ISelectionProvider2 interface [Windows Accessibility]
described
uiautomationcore/ISelectionProvider2
winauto.uiauto_ISelectionProvider2
winauto\uiauto_ISelectionProvider2.htm
WinAuto
1FC0406D-6924-4C24-8491-E18BA33DAFEB
12/05/2018
ISelectionProvider2, ISelectionProvider2 interface [Windows Accessibility], ISelectionProvider2 interface [Windows Accessibility],described, uiautomationcore/ISelectionProvider2, winauto.uiauto_ISelectionProvider2
uiautomationcore.h
UIAutomation.h
Windows
Windows 10, version 1709 [desktop apps \| UWP apps]
Windows Server 2016 [desktop apps \| UWP apps]
UIAutomationCore.idl
UIAutomationCore.dll
Windows
19H1
ISelectionProvider2
uiautomationcore/ISelectionProvider2
c++
APIRef
kbSyntax
COM
UIAutomationCore.dll
ISelectionProvider2

ISelectionProvider2 interface

-description

Extends the ISelectionItemProvider interface to provide information about selected items.

-remarks

This interface is implemented by a Microsoft UI Automation provider.

Providers should raise an event of type UIA_Selection_InvalidatedEventId when a selection in a container has changed significantly.

When selecting from a list or 2D grid there are primary pieces of information that ATs would like to better read to their end users. Using Excel as a primary example, there are 4 main pieces of information necessary for the AT to provide a good experience:

  • The first cell in the selection
  • The last cell in the selection
  • The current item as you select
  • The total count

Image of an Excel spreadsheet showing multiple cells selected. Selection starts in the upper right on cell F5 and ends in the lower left on cell D7.

The above image illustrates the end state of a 2D selection:
  • The user started in cell F5 (note this is where focus input stays because if you type that is where data lands)
  • The user selects down the column to cell F7
  • The user then selects left to cell D7

-see-also

ISelectionItemProvider

UI Automation Providers Overview