Bagikan melalui


Atribut Teks Automation UI

Topik ini menjelaskan bagaimana Microsoft UI Automation mengekspos properti format dan gaya (atribut teks) konten tekstual, dan menyediakan daftar atribut teks yang didukung.

Penyedia Automation UI mengekspos atribut teks melalui metode GetAttributeValue dan FindAttribute dari pola kontrol TextRange . Aplikasi klien menggunakan metode IUIAutomationTextRange::GetAttributeValue untuk mengambil nilai atribut teks tertentu untuk rentang teks. Klien dapat menggunakan metode IUIAutomationTextRange::FindAttribute untuk mencari rentang teks untuk teks yang memiliki atribut tertentu. Jika ada teks yang cocok ditemukan, metode membuat rentang teks baru yang berisi teks yang cocok.

Atribut teks dalam daftar berikut didukung oleh pola kontrol TextRange . Nama atribut berasal dari pengidentifikasi atribut teks Automation UI. Misalnya, atribut AnimationStyle diidentifikasi oleh klien sebagai UIA_AnimationStyleAttributeId (didefinisikan dalam Uiautomationclient.h) dan oleh penyedia sebagai Text_AnimationStyle_Attribute_GUID (didefinisikan dalam Uiautomationcoreapi.h). Untuk informasi selengkapnya tentang setiap atribut teks yang didukung, lihat Pengidentifikasi Atribut Teks.

Catatan

Beberapa atribut yang tercantum didukung dimulai dengan Windows 8. Lihat Pengidentifikasi Atribut Teks untuk catatan mengenai dukungan versi.

 

Topik ini berisi bagian berikut:

Atribut Anotasi

Objek anotasi dan jenis anotasi tersedia melalui atribut berikut.

Atribut Pengidentifikasi
AnotasiObjects UIA_AnnotationObjectsAttributeId
AnnotationTypes UIA_AnnotationTypesAttributeId

 

Atribut Font

Nama, ukuran, dan berat font tersedia melalui atribut berikut.

Atribut Pengidentifikasi
FontName UIA_FontNameAttributeId
FontSize UIA_FontSizeAttributeId
FontWeight UIA_FontWeightAttributeId

 

Atribut Bahasa

Informasi tentang bahasa teks tersedia melalui atribut berikut.

Atribut Pengidentifikasi
Kultur UIA_CultureAttributeId
TextFlowDirections UIA_TextFlowDirectionsAttributeId

 

Atribut berikut ini menyediakan rentang teks yang merupakan target tautan dalam dokumen.

Atribut Pengidentifikasi
Tautan UIA_LinkAttributeId

 

Atribut Margin Halaman

Persegi panjang batas rentang teks tidak mengekspos koordinat teks di halaman. Namun, penyedia dapat mengekspos informasi margin halaman menggunakan atribut teks berikut.

Atribut Pengidentifikasi
MarginBottom UIA_MarginBottomAttributeId
MarginLeading UIA_MarginLeadingAttributeId
MarginTop UIA_MarginTopAttributeId
MarginTrailing UIA_MarginTrailingAttributeId

 

Atribut Perataan Teks

Informasi tentang perataan teks seperti indentasi, pengaturan tab, dan perataan horizontal tersedia melalui atribut berikut.

Atribut Pengidentifikasi
HorizontalTextAlignment UIA_HorizontalTextAlignmentAttributeId
IndentationFirstLine UIA_IndentationFirstLineAttributeId
IndentationLeading UIA_IndentationLeadingAttributeId
IndentationTrailing UIA_IndentationTrailingAttributeId
Tab UIA_TabsAttributeId

 

Atribut Warna Teks

Warna teks latar depan dan latar belakang tersedia melalui atribut teks berikut. Kedua warna ditentukan sebagai jenis data COLORREF .

Atribut Pengidentifikasi
Warna Latar Belakang UIA_BackgroundColorAttributeId
ForegroundColor UIA_ForegroundColorAttributeId

 

Atribut Dekorasi Teks

Dekorasi teks mencakup area seperti poin, garis bawah, dan animasi. Jika teks menyertakan poin atau angka di awal, simbol atau teks yang digunakan untuk poin atau angka harus disertakan dalam aliran teks, jika berlaku.

Informasi tentang dekorasi teks tersedia melalui atribut berikut.

Atribut Pengidentifikasi
Gaya Animasi UIA_AnimationStyleAttributeId
Gaya Poin UIA_BulletStyleAttributeId
OutlineStyles UIA_OutlineStylesAttributeId
OverlineColor UIA_OverlineColorAttributeId
OverlineStyle UIA_OverlineStyleAttributeId
StrikethroughColor UIA_StrikethroughColorAttributeId
StrikethroughStyle UIA_StrikethroughStyleAttributeId
Garis BawahKolom UIA_UnderlineColorAttributeId
Garis BawahStyle UIA_UnderlineStyleAttributeId

 

Atribut Gaya Teks

Informasi tentang gaya teks tersedia melalui atribut berikut.

Atribut Pengidentifikasi
CapStyle UIA_CapStyleAttributeId
IsHidden UIA_IsHiddenAttributeId
IsItalic UIA_IsItalicAttributeId
IsReadOnly UIA_IsReadOnlyAttributeId
IsSuperscript UIA_IsSuperscriptAttributeId
IsSubscript UIA_IsSubscriptAttributeId

 

Atribut Interaksi dan Pemilihan

Informasi tentang pilihan teks saat ini dalam rentang dan status fokus tersedia melalui atribut berikut.

Atribut Pengidentifikasi
IsActive UIA_IsActiveAttributeId
SelectionActiveEnd UIA_SelectionActiveEndAttributeId
CaretPosition UIA_CaretPositionAttributeId
CaretBidiMode UIA_CaretBidiModeAttributeId

 

Konseptual

Tentang Teks Automasi UI dan Pola Kontrol TextRange

Pola Kontrol Text dan TextRange

Bekerja dengan Kontrol Berbasis Teks