Windows apps
Collapse the table of content
Expand the table of content
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IUIAutomationElement3::CachedIsPeripheral property

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(
  [out, retval] BOOL *retVal

Property value

Type: BOOL*

true if the element is a peripheral UI element in the tree. false if the element is not peripheral UI. The default is false.


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)


Minimum supported client

Windows 8.1 [desktop apps only]

Minimum supported server

Windows Server 2012 R2 [desktop apps only]


UIAutomationClient.h (include UIAutomation.h)



See also




© 2018 Microsoft