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.

Syntax

HRESULT get_CachedIsPeripheral(
  BOOL *retVal
);

Parameters

retVal

Return value

None

Remarks

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

The appearance of peripheral UI often triggers one of these events, if the peripheral UI supports one of the relevant patterns:

• WindowOpened (UIA_Window_WindowOpenedEventId)
• MenuOpened (UIA_MenuOpenedEventId)
• ToolTipOpened (UIA_ToolTipOpenedEventId)

Requirements

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)

See also

IUIAutomationElement3

Reference