IUIAutomationElement3::get_CachedIsPeripheral-Methode (uiautomationclient.h)

Ruft den Zwischenspeicherungsindikator für die Peripherieoberfläche für das Element ab. Die Peripherie-Benutzeroberfläche wird angezeigt und unterstützt die Benutzerinteraktion, jedoch nicht den Tastaturfokus, wenn sie angezeigt wird. Beispiele für Peripheriebenutzeroberfläche sind Popups, Flyouts, Kontextmenüs oder schwebende Benachrichtigungen.

Diese Eigenschaft ist schreibgeschützt.

Syntax

HRESULT get_CachedIsPeripheral(
  BOOL *retVal
);

Parameter

retVal

Rückgabewert

Keine

Bemerkungen

Wenn die IsPeripheral-EigenschaftTRUE ist, kann eine Clientanwendung nicht davon ausgehen, dass der Fokus vom Element übernommen wurde, auch wenn es sich derzeit um eine interaktive Tastatur handelt.

Diese Eigenschaft ist für diese Steuerelementtypen relevant:

• UIA_GroupControlTypeId
• UIA_MenuControlTypeId
• UIA_PaneControlTypeId
• UIA_ToolBarControlTypeId
• UIA_ToolTipControlTypeId
• UIA_WindowControlTypeId
• UIA_CustomControlTypeId

Die Darstellung der Peripherie-Benutzeroberfläche löst häufig eines der folgenden Ereignisse aus, wenn die Peripherieoberfläche eines der relevanten Muster unterstützt:

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8.1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	uiautomationclient.h (include UIAutomation.h)

Weitere Informationen

IUIAutomationElement3

Referenz