Mengontrol pola dan antarmuka
Mencantumkan pola kontrol Microsoft UI Automation, kelas yang digunakan klien untuk mengaksesnya, dan penyedia antarmuka yang digunakan untuk mengimplementasikannya.
Tabel dalam topik ini menjelaskan pola kontrol Microsoft UI Automation. Tabel ini juga mencantumkan kelas yang digunakan oleh klien Automation UI untuk mengakses pola kontrol dan antarmuka yang digunakan oleh penyedia Automation UI untuk mengimplementasikannya. Kolom Pola kontrol memperlihatkan nama pola dari perspektif klien Automation UI, sebagai nilai konstanta yang tercantum dalam Pengidentifikasi Properti Ketersediaan Pola Kontrol. Dari perspektif penyedia Automation UI, masing-masing pola ini adalah nama konstanta PatternInterface. Kolom antarmuka penyedia Kelas menunjukkan nama antarmuka yang diterapkan penyedia untuk menyediakan pola ini untuk kontrol XAML kustom.
Untuk informasi selengkapnya tentang cara menerapkan rekan otomatisasi kustom yang mengekspos pola kontrol dan mengimplementasikan antarmuka, lihat Rekan otomatisasi kustom.
Ketika Menerapkan pola kontrol, Anda juga harus berkonsultasi dengan dokumentasi penyedia Automation UI yang menjelaskan beberapa harapan yang akan dimiliki klien dari pola kontrol terlepas dari kerangka kerja UI mana yang digunakan untuk mengimplementasikannya. Beberapa info yang tercantum dalam dokumentasi penyedia Automation UI umum akan memengaruhi cara Anda menerapkan rekan-rekan Anda dan mendukung pola tersebut dengan benar. Lihat Menerapkan Pola Kontrol Otomatisasi UI, dan lihat halaman yang menandakan pola yang ingin Anda terapkan.
| Pola kontrol | Antarmuka penyedia kelas | Deskripsi |
|---|---|---|
| Anotasi | IAnnotationProvider | Digunakan untuk mengekspos properti anotasi dalam dokumen. |
| Dok | IDockProvider | Digunakan untuk kontrol yang dapat ditambatkan ke dalam kontainer dok. Misalnya, toolbar atau palet alat. |
| Tarik | IDragProvider | Digunakan untuk mendukung kontrol yang dapat diseret, atau kontrol dengan item yang dapat diseret. |
| DropTarget | IDropTargetProvider | Digunakan untuk mendukung kontrol yang dapat menjadi target operasi seret dan letakkan. |
| ExpandCollapse | IExpandCollapseProvider | Digunakan untuk mendukung kontrol yang diperluas secara visual untuk menampilkan lebih banyak konten dan menciutkan untuk menyembunyikan konten. |
| Kisi | IGridProvider | Digunakan untuk kontrol yang mendukung fungsionalitas kisi seperti ukuran dan pemindahan ke sel tertentu. Perhatikan bahwa Grid itu sendiri tidak menerapkan pola ini karena menyediakan tata letak tetapi bukan kontrol. |
| GridItem | IGridItemProvider | Digunakan untuk kontrol yang memiliki sel di dalam kisi. |
| Memohon | IInvokeProvider | Digunakan untuk kontrol yang dapat dipanggil, seperti Tombol. |
| ItemContainer | IItemContainerProvider | Memungkinkan aplikasi menemukan elemen dalam kontainer, seperti daftar virtual. |
| MultipleView | IMultipleViewProvider | Digunakan untuk kontrol yang dapat beralih di antara beberapa representasi dari kumpulan informasi, data, atau turunan yang sama. |
| ObjectModel | IObjectModelProvider | Digunakan untuk mengekspos penunjuk ke model objek yang mendasar dari dokumen. |
| RangeValue | IRangeValueProvider | Digunakan untuk kontrol yang memiliki rentang nilai yang dapat diterapkan ke kontrol. Misalnya, kontrol spinner yang berisi tahun mungkin memiliki kisaran 1900 hingga tahun ini, sementara kontrol spinner lain yang menyajikan bulan akan memiliki kisaran 1 hingga 12. |
| Gulir | IScrollProvider | Digunakan untuk kontrol yang dapat menggulir. Misalnya, kontrol yang memiliki bilah gulir yang aktif saat ada lebih banyak informasi daripada yang bisa ditampilkan di area kontrol yang dapat dilihat. |
| ScrollItem | IScrollItemProvider | Digunakan untuk kontrol yang memiliki item individual dalam daftar yang bergulir. Misalnya, kontrol daftar yang memiliki item individual dalam daftar gulir, seperti kontrol kotak kombo. |
| Pilihan | ISelectionProvider | Digunakan untuk kontrol kontainer pemilihan. Misalnya, ListBox dan ComboBox. |
| SelectionItem | ISelectionItemProvider | Digunakan untuk masing-masing item dalam kontrol kontainer pilihan, seperti kotak daftar dan kotak kombo. |
| Spreadsheet | ISpreadsheetProvider | Digunakan untuk mengekspos konten spreadsheet atau dokumen berbasis kisi lainnya. |
| SpreadsheetItem | ISpreadsheetItemProvider | Digunakan untuk mengekspos properti sel dalam lembar bentang atau dokumen berbasis kisi lainnya. |
| Gaya | IStylesProvider | Digunakan untuk menjelaskan elemen UI yang memiliki gaya, warna isian, pola isian, atau bentuk tertentu. |
| SynchronizedInput | ISynchronizedInputProvider | Memungkinkan aplikasi klien Automation UI untuk mengarahkan input mouse atau keyboard ke elemen UI tertentu. |
| Table | ITableProvider | Digunakan untuk kontrol yang memiliki kisi serta informasi header. Misalnya, kontrol kalender tabular. |
| TableItem | ITableItemProvider | Digunakan untuk item dalam tabel. |
| Teks | ITextProvider | Digunakan untuk mengedit kontrol dan dokumen yang mengekspos informasi tekstual. Lihat juga ITextRangeProvider dan ITextProvider2. |
| TextChild | ITextChildProvider | Digunakan untuk mengakses leluhur terdekat elemen yang mendukung pola kontrol Teks . |
| TextEdit | Tidak ada kelas terkelola yang tersedia | Menyediakan akses ke kontrol yang memodifikasi teks, misalnya kontrol yang melakukan koreksi otomatis atau mengaktifkan komposisi input melalui Editor Metode Input (IME). |
| TextRange | ITextRangeProvider | Menyediakan akses ke rentang teks berkelanjutan dalam kontainer teks yang mengimplementasikan ITextProvider. Lihat juga ITextRangeProvider2. |
| Beralih | IToggleProvider | Digunakan untuk kontrol di mana status dapat dialihkan. Misalnya, Kotak Centang dan item menu yang dapat dicentang. |
| Mengubah | ITransformProvider | Digunakan untuk kontrol yang dapat diubah ukurannya, dipindahkan, dan diputar. Penggunaan umum untuk pola kontrol Transform adalah dalam desainer, formulir, editor grafis, dan aplikasi menggambar. |
| Nilai | IValueProvider | Memungkinkan klien untuk mendapatkan atau menetapkan nilai pada kontrol yang tidak mendukung rentang nilai. |
| VirtualizedItem | IVirtualizedItemProvider | Mengekspos item di dalam kontainer yang divirtualisasi dan perlu dibuat dapat diakses sepenuhnya sebagai elemen Automation UI. |
| Jendela | IWindowProvider | Mengekspos informasi khusus untuk windows, sebuah konsep dasar untuk sistem operasi Microsoft Windows. Contoh kontrol yang merupakan jendela adalah jendela dan dialog anak. |
Catatan
Anda tidak akan selalu menemukan implementasi dari semua pola ini dalam kontrol XAML yang ada. Beberapa pola memiliki antarmuka semata-mata untuk mendukung paritas dengan definisi kerangka kerja Automation UI umum dari pola, dan untuk mendukung skenario peer otomatisasi yang akan memerlukan implementasi kustom murni untuk mendukung pola tersebut.
Catatan
Aplikasi Windows Phone Store tidak mendukung semua pola kontrol Automation UI yang tercantum di sini. Anotasi, Dock, Drag, DropTarget, ObjectModel adalah beberapa pola yang tidak didukung.
Topik terkait
Windows developer