IUIAutomationElement3::get_CachedIsPeripheral method (uiautomationclient.h)
Retrieves the cached peripheral UI indicator for the element. Peripheral UI appears and supports user interaction, but does not take keyboard focus when it appears. Examples of peripheral UI includes popups, flyouts, context menus, or floating notifications.
This property is read-only.
HRESULT get_CachedIsPeripheral(
BOOL *retVal
);
retVal
None
When the IsPeripheral property is TRUE, a client application can't assume that focus was taken by the element even if it's currently keyboard-interactive.
This property is relevant for these control types:
- UIA_GroupControlTypeId
- UIA_MenuControlTypeId
- UIA_PaneControlTypeId
- UIA_ToolBarControlTypeId
- UIA_ToolTipControlTypeId
- UIA_WindowControlTypeId
- UIA_CustomControlTypeId
- WindowOpened (UIA_Window_WindowOpenedEventId)
- MenuOpened (UIA_MenuOpenedEventId)
- ToolTipOpened (UIA_ToolTipOpenedEventId)
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 8.1 [desktop apps only] |
| Minimum supported server | Windows Server 2012 R2 [desktop apps only] |
| Target Platform | Windows |
| Header | uiautomationclient.h (include UIAutomation.h) |
Reference