Bagikan melalui

Memahami Model Objek Teks Automasi UI

  • Artikel

Topik ini menjelaskan bagaimana aplikasi klien Microsoft UI Automation mengakses konten tekstual kontrol berbasis teks.

Kontrol berbasis teks mengekspos konten tekstual ke aplikasi klien Automation UI melalui model objek teks sederhana. Aplikasi klien memiliki akses ke model objek teks melalui antarmuka pola kontrol Text dan TextRange , termasuk IUIAutomationTextPattern dan IUIAutomationTextRange. Aplikasi klien dapat menggunakan antarmuka ini untuk mengambil konten tekstual, atribut teks, dan objek yang disematkan seperti tabel dan hyperlink dari kontrol berbasis teks.

Jenis kontrol yang mendukung model objek teks Automation UI menyertakan jenis kontrol Edit dan Dokumen . Jenis kontrol lain seperti TipsAlat dan Teks mungkin juga mendukung model objek teks, tetapi tidak diperlukan.

Catatan

Model objek teks Automation UI tidak menyediakan sarana untuk menyisipkan atau mengubah teks. Namun, beberapa kontrol memungkinkan teks disisipkan atau dimodifikasi baik melalui antarmuka IUIAutomationValuePattern , atau melalui input keyboard langsung.

 

Model Objek khusus kontrol

Kontrol berbasis teks yang mengimplementasikan Model Objek Dokumen (DOM) sendiri dapat mengekspos DOM dengan menerapkan pola kontrol ObjectModel . Mengekspos DOM dapat memberi aplikasi klien akses yang lebih besar, dan mengontrol konten kontrol berbasis teks.

Aplikasi klien dapat menemukan apakah kontrol berbasis teks tertentu mengimplementasikan DOM dengan mengambil antarmuka IUIAutomationElement kontrol. Kemudian, panggil metode IUIAutomationElement::GetCurrentPropertyValue , menentukan pengidentifikasi properti UIA_IsObjectModelPatternAvailablePropertyId , dan varian yang menerima TRUE jika kontrol mengimplementasikan DOM.

Untuk mengakses DOM, panggil metode IUIAutomationElement::GetCurrentPattern , yang menentukan pengidentifikasi pola kontrol UIA_ObjectModelPatternId dan variabel yang menerima antarmuka IUIAutomationObjectModelPattern . Panggil metode IUIAutomationObjectModelPattern::GetUnderlyingObjectModel untuk mengambil antarmuka DOM.

Pola Kontrol Text dan TextRange

Dukungan Automasi UI untuk Konten Tekstual

Bekerja dengan Kontrol Berbasis Teks