Metodo IUIAutomationElement3::get_CurrentIsPeripheral (uiautomationclient.h)

  • Articolo

Recupera l'indicatore dell'interfaccia utente periferica corrente per l'elemento.

Questa proprietà è di sola lettura.

Sintassi

HRESULT get_CurrentIsPeripheral(
  BOOL *retVal
);

Parametri

retVal

Valore restituito

nessuno

Osservazioni

Quando la proprietà IsPeripheral è TRUE, un'applicazione client non può presupporre che lo stato attivo sia stato preso dall'elemento anche se è attualmente interattivo da tastiera.

Questa proprietà è rilevante per questi tipi di controllo:

  • UIA_GroupControlTypeId
  • UIA_MenuControlTypeId
  • UIA_PaneControlTypeId
  • UIA_ToolBarControlTypeId
  • UIA_ToolTipControlTypeId
  • UIA_WindowControlTypeId
  • UIA_CustomControlTypeId
L'aspetto dell'interfaccia utente periferica spesso attiva uno di questi eventi, se l'interfaccia utente periferica supporta uno dei modelli pertinenti:
  • WindowOpened (UIA_Window_WindowOpenedEventId)
  • MenuAprito (UIA_MenuOpenedEventId)
  • ToolTipOpened (UIA_ToolTipOpenedEventId)
Quando le applicazioni client che sono assistive technology gestiscono uno di questi eventi, il client deve controllare il valore di CurrentIsPeripheral. Se il valore è TRUE, il client potrebbe dover fornire una rappresentazione alternativa dell'interfaccia utente periferica che l'utente può raggiungere con una singola azione, perché il client non può usare lo stato attivo modificato come indicatore di una nuova interfaccia utente o di un'interfaccia utente di interesse. L'interfaccia utente periferica non esiste in altro modo nella visualizzazione controlli, nella sequenza di tabulazioni e così via. Un client garantisce che nell'albero complessivo esista un solo elemento dell'interfaccia utente periferica in qualsiasi momento, l'apertura di un'altra chiude automaticamente la prima.

Requisiti

   
Client minimo supportato Windows 8.1 [solo app desktop]
Server minimo supportato Windows Server 2012 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione uiautomationclient.h (include UIAutomation.h)

Vedi anche

IUIAutomationElement3

Riferimento