Share via

IUIAutomationElement3::get_CurrentIsPeripheral-Methode (uiautomationclient.h)

  • Artikel

Ruft den aktuellen Indikator der Peripherie-UI für das -Element ab.

Diese Eigenschaft ist schreibgeschützt.

Syntax

HRESULT get_CurrentIsPeripheral(
  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)
Wenn Clientanwendungen, die Hilfstechnologien sind, eines dieser Ereignisse verarbeiten, sollte der Client den Wert von CurrentIsPeripheral überprüfen. Wenn der Wert TRUE ist, muss der Client möglicherweise eine alternative Darstellung der Peripherie-Benutzeroberfläche bereitstellen, die der Benutzer mit einer einzelnen Aktion erreichen kann, da der Client den geänderten Fokus nicht als Indikator für eine neue Benutzeroberfläche oder eine benutzerdefinierte Benutzeroberfläche verwenden kann. Die peripherierische Benutzeroberfläche ist sonst nicht in der Steuerelementansicht, Registerkartensequenz usw. vorhanden. Ein Client ist garantiert, dass nur ein Peripherieelement der Benutzeroberfläche gleichzeitig in der Gesamtstruktur vorhanden ist. Durch das Öffnen eines anderen wird das erste Element automatisch geschlossen.

Anforderungen

   
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