Bagikan melalui

Pola Kontrol Gaya

  • Artikel

Menjelaskan panduan dan konvensi untuk menerapkan IStylesProvider, termasuk informasi tentang properti dan metode. Pola kontrol Gaya digunakan untuk menggambarkan elemen UI yang memiliki gaya, warna isian, pola isian, atau bentuk tertentu.

Pola kontrol Gaya sangat berguna untuk menjelaskan elemen dalam dokumen, yang sering memiliki gaya seperti itu. Gaya biasanya membawa informasi yang berguna bagi pelanggan penyandang disabilitas; misalnya, gaya dapat menggambarkan string tertentu sebagai judul dokumen, atau objek diagram alur tertentu sebagai berlian atau lingkaran. Untuk contoh kontrol yang mengimplementasikan pola kontrol ini, lihat Jenis Kontrol dan Pola Kontrol yang Didukung.

Topik ini berisi bagian berikut.

Panduan dan Konvensi Implementasi

Saat menerapkan pola kontrol Gaya , perhatikan panduan dan konvensi berikut:

  • File header UIAutomationClient.h menentukan sekumpulan nilai konstanta bernama yang digunakan untuk mengidentifikasi beberapa gaya umum. Untuk informasi selengkapnya, lihat Pengidentifikasi Gaya.
  • Jika Anda menggunakan StyleId_Custom, Anda harus mengimplementasikan properti IStylesProvider::StyleName untuk memungkinkan klien menemukan nama gaya. Anda tidak perlu menerapkan properti StyleName untuk gaya standar karena Microsoft UI Automation menyediakan nama default, tetapi Anda dapat menerapkannya jika Anda perlu mengganti nama default.
  • Properti lain dalam pola Gaya bersifat opsional; penyedia dapat mengembalikan UIA_E_NOTSUPPORTED untuk properti yang tidak didukung.
  • Gaya dalam rentang teks dapat diwakili melalui atribut teks berikut:
    • Saat menanggapi permintaan atribut teks StyleId , rentang teks harus mengembalikan salah satu pengidentifikasi gaya yang dijelaskan dalam Pengidentifikasi Gaya.
    • Jika StyleId_Custom digunakan, rentang teks harus mengembalikan nilai string untuk atribut teks StyleName untuk memungkinkan klien menemukan nama gaya.
    • Rentang teks yang memiliki beberapa gaya, seperti judul dan teks normal, harus mengembalikan properti Automation ReservedMixedAttributeValue UI khusus untuk properti StyleId dan StyleName . Klien yang menerima respons ini dapat membavisi rentang teks untuk menemukan di mana gaya dimulai dan diakhapi.
  • Aplikasi dapat menggunakan berbagai gaya untuk menggambarkan objek, tetapi Automasi UI hanya mewakili yang paling umum. Untuk mewakili atribut gaya tambahan, seperti warna batas, penyedia dapat mengembalikan daftar atribut tambahan di properti ExtendedProperties . Ini pada dasarnya adalah tas properti dengan satu set properti yang diperluas, seperti "BorderColor=0xFF0000; BorderStyle=dotted". Nilai properti yang diperluas dapat spesifik untuk aplikasi.

Anggota yang Diperlukan untuk IStylesProvider

Properti berikut diperlukan untuk mengimplementasikan antarmuka IStylesProvider .

Anggota yang diperlukan Jenis anggota Catatan
ExtendedProperties Properti Tidak ada
FillColor Properti Tidak ada
FillPatternColor Properti Tidak ada
FillPatternStyle Properti Tidak ada
Bentuk Properti Tidak ada
StyleId Properti Tidak ada
StyleName Properti Tidak ada

 

Pola kontrol ini tidak memiliki metode atau peristiwa terkait.

Jenis Kontrol dan Pola Kontrol yang Didukung

Gambaran Umum Pola Kontrol UI Automation

Gambaran Umum Pohon UI Automation