Atribut Teks Automasi 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 melaluiGetAttributeValue dan metode FindAttribute dari pola kontrol TextRange. Aplikasi klien menggunakan metode IUIAutomationTextRange::GetAttributeValue untuk mengambil nilai atribut teks tertentu untuk rentang teks. Klien dapat menggunakan metodeIUIAutomationTextRange::FindAttribute untuk mencari rentang teks untuk teks yang memiliki atribut tertentu. Jika ditemukan teks yang cocok, 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.

Nota

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
• Atribut Font
• Atribut Bahasa
• Atribut Link
• Atribut Margin Halaman
• Atribut Perataan Teks
• Atribut Warna Teks
• Atribut Dekorasi Teks
• Atribut Gaya Teks
• Atribut Interaksi dan Pemilihan
• Topik terkait

Atribut Anotasi

Objek anotasi dan jenis anotasi tersedia melalui atribut berikut.

Atribut	Pengenal
AnotasiObjects	UIA_AnnotationObjectsAttributeId
AnnotationTypes	UIA_AnnotationTypesAttributeId

 

Atribut Font

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

Atribut	Pengenal
FontName	UIA_FontNameAttributeId
FontSize	UIA_FontSizeAttributeId
FontWeight	UIA_FontWeightAttributeId

 

Atribut Bahasa

Informasi tentang bahasa teks tersedia melalui atribut berikut.

Atribut	Pengenal
Budaya	UIA_CultureAttributeId
TextFlowDirections	UIA_TextFlowDirectionsAttributeId

 

Atribut Tautan

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

Atribut	Pengenal
Tautan	UIA_LinkAttributeId

 

Atribut Margin Halaman

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

Atribut	Pengenal
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	Pengenal
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 dataCOLORREF.

Atribut	Pengenal
BackgroundColor	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 depan, 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	Pengenal
AnimationStyle	UIA_AnimationStyleAttributeId
GayaPoin	UIA_BulletStyleAttributeId
OutlineStyles	UIA_OutlineStylesAttributeId
OverlineColor	UIA_OverlineColorAttributeId
OverlineStyle	UIA_OverlineStyleAttributeId
StrikethroughColor	UIA_StrikethroughColorAttributeId
StrikethroughStyle	UIA_StrikethroughStyleAttributeId
Garis Bawah	UIA_UnderlineColorAttributeId
Garis Bawah	UIA_UnderlineStyleAttributeId

 

Atribut Gaya Teks

Informasi tentang gaya teks tersedia melalui atribut berikut.

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

 

Atribut Interaksi dan Pilihan

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

Atribut	Pengenal
IsActive	UIA_IsActiveAttributeId
SelectionActiveEnd	UIA_SelectionActiveEndAttributeId
CaretPosition	UIA_CaretPositionAttributeId
CaretBidiMode	UIA_CaretBidiModeAttributeId

 

Topik terkait

Konseptual

Tentang Teks Automasi UI dan Pola Kontrol TextRange

Pola Kontrol Text dan TextRange

Bekerja dengan Kontrol Berbasis Teks