Metode IUIAutomationElement3::get_CurrentIsPeripheral (uiautomationclient.h)

Artikel
08/26/2023

Mengambil indikator UI periferal saat ini untuk elemen .

Properti ini bersifat hanya baca.

Sintaks

HRESULT get_CurrentIsPeripheral(
  BOOL *retVal
);

Parameter

retVal

Menampilkan nilai

Tidak ada

Keterangan

Ketika properti IsPeripheralTRUE, aplikasi klien tidak dapat mengasumsikan bahwa fokus diambil oleh elemen bahkan jika saat ini interaktif keyboard.

Properti ini relevan untuk jenis kontrol ini:

UIA_GroupControlTypeId
UIA_MenuControlTypeId
UIA_PaneControlTypeId
UIA_ToolBarControlTypeId
UIA_ToolTipControlTypeId
UIA_WindowControlTypeId
UIA_CustomControlTypeId

Munculnya UI periferal sering memicu salah satu peristiwa ini, jika UI periferal mendukung salah satu pola yang relevan:

WindowOpened (UIA_Window_WindowOpenedEventId)
MenuBuka (UIA_MenuOpenedEventId)
TipsAlatBuka (UIA_ToolTipOpenedEventId)

Ketika aplikasi klien yang merupakan teknologi bantu menangani salah satu peristiwa ini, klien harus memeriksa nilai CurrentIsPeripheral. Jika nilainya TRUE, klien mungkin perlu memberikan representasi alternatif dari UI periferal yang dapat dijangkau pengguna dengan satu tindakan, karena klien tidak dapat menggunakan fokus yang diubah sebagai indikator UI baru atau UI yang menarik. UI periferal tidak akan ada di tampilan kontrol, urutan tab, dan sebagainya. Klien dijamin bahwa hanya satu item UI periferal yang ada di pohon keseluruhan pada satu waktu, membuka yang lain akan menutup yang pertama secara otomatis.

Persyaratan


Klien minimum yang didukung	Windows 8.1 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	uiautomationclient.h (termasuk UIAutomation.h)

Lihat juga

IUIAutomationElement3

Referensi

Bagikan melalui