Bagikan melalui


Dukungan Automasi UI untuk Jenis Kontrol Jendela

Nota

Dokumentasi ini ditujukan untuk pengembang .NET Framework yang ingin menggunakan kelas Automation UI terkelola yang ditentukan dalam namespace System.Windows.Automation. Untuk informasi terbaru tentang Automasi UI, lihat Windows Automation API: UI Automation.

Topik ini menyediakan informasi tentang dukungan Automation UI untuk jenis kontrol Jendela. Di Automasi UI, jenis kontrol adalah serangkaian kondisi yang harus dipenuhi kontrol untuk menggunakan ControlTypeProperty properti . Kondisi ini mencakup pedoman khusus untuk struktur pohon Automation UI, nilai properti Automation UI, dan pola kontrol.

Kontrol jendela terdiri dari bingkai jendela, yang berisi objek anak seperti bilah judul, klien, dan objek lainnya.

Persyaratan Otomatisasi UI di bagian berikut berlaku untuk semua kontrol yang mengimplementasikan jenis kontrol Jendela, baik Windows Presentation Foundation (WPF), Win32, atau Windows Forms.

Struktur Pohon Automasi UI yang Diperlukan

Tabel berikut ini menggambarkan tampilan kontrol dan tampilan konten pohon Automation UI yang berkaitan dengan kontrol jendela dan menjelaskan apa yang dapat dimuat dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon Automation UI, lihat Gambaran Umum Pohon Automasi UI.

Tampilan Kontrol Tampilan Isi
Jendela Jendela

Properti Otomasi Antarmuka Pengguna yang Dibutuhkan

Tabel berikut mencantumkan properti Automation UI yang nilai atau definisinya sangat relevan dengan kontrol jendela. Untuk informasi selengkapnya tentang properti Automation UI, lihat Properti Automasi UI untuk Klien.

Properti Automasi Antarmuka Pengguna Nilai Catatan
AutomationIdProperty Lihat catatan. Nilai properti ini harus unik di semua kontrol dalam aplikasi.
BoundingRectangleProperty Lihat catatan. Persegi terluar yang berisi seluruh kontrol.
ClickablePointProperty Lihat catatan. Kontrol jendela harus memiliki titik yang dapat diklik yang akan menyebabkan jendela dipilih atau tidak dipilih.
ControlTypeProperty Jendela Nilai ini sama untuk semua kerangka kerja UI.
IsContentElementProperty Benar Kontrol jendela harus selalu berfungsi dengan baik.
IsControlElementProperty Benar Kontrol jendela harus selalu tetap berfungsi sebagai kontrol.
IsKeyboardFocusableProperty Lihat catatan. Jika kontrol dapat menerima fokus keyboard, maka kontrol harus mendukung properti ini.
LabeledByProperty null Kontrol jendela tidak memiliki label Jendela statis.
LocalizedControlTypeProperty jendela String yang sudah dilokalkan sesuai dengan jenis kontrol jendela.
NameProperty Lihat catatan. Kontrol jendela selalu berisi elemen Jendela utama yang dianggap pengguna sebagai pengidentifikasi paling semantik untuk item tersebut.

Pola Kontrol Automasi UI yang Diperlukan

Tabel berikut mencantumkan pola kontrol Automation UI yang diperlukan untuk didukung oleh kontrol jendela. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi UI .

Pola Kontrol Dukungan Catatan
IDockProvider Bersyarat Harus didukung jika jendela memiliki kemampuan untuk ditambatkan.
ITransformProvider Diperlukan Memungkinkan jendela dipindahkan, diubah ukurannya, atau diputar pada layar.
IWindowProvider Diperlukan Mengaktifkan operasi tertentu untuk jendela.

Peristiwa Automasi UI yang Diperlukan

Tabel berikut mencantumkan peristiwa Automasi UI yang diperlukan untuk didukung oleh semua kontrol jendela. Untuk informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa Automasi UI.

Peristiwa UI Automation Dukungan Catatan
AsyncContentLoadedEvent Diperlukan Tidak ada
AutomationFocusChangedEvent Diperlukan Tidak ada
BoundingRectangleProperty acara perubahan properti. Diperlukan Tidak ada
IsEnabledProperty acara perubahan properti. Diperlukan Tidak ada
IsOffscreenProperty acara perubahan properti. Diperlukan Tidak ada
LayoutInvalidatedEvent Diperlukan Tidak ada
NameProperty acara perubahan properti. Diperlukan Tidak ada
StructureChangedEvent Diperlukan Tidak ada
HorizontallyScrollableProperty acara perubahan properti. Bergantung Tidak ada
HorizontalScrollPercentProperty acara perubahan properti. Bergantung Tidak ada
HorizontalViewSizeProperty acara perubahan properti. Bergantung Tidak ada
VerticalScrollPercentProperty acara perubahan properti. Bergantung Tidak ada
VerticallyScrollableProperty acara perubahan properti. Bergantung Tidak ada
VerticalViewSizeProperty acara perubahan properti. Bergantung Tidak ada
WindowClosedEvent Diperlukan Tidak ada
WindowOpenedEvent Diperlukan Tidak ada
WindowVisualStateProperty acara perubahan properti. Bergantung Tidak ada

Lihat juga