Bagikan melalui

IUIAutomationTextRange::Metode pindah (uiautomationclient.h)

  • Artikel

Memindahkan rentang teks ke depan atau mundur dengan jumlah unit teks yang ditentukan .

Sintaks

HRESULT Move(
  [in]          TextUnit unit,
  [in]          int      count,
  [out, retval] int      *moved
);

Parameter

[in] unit

Jenis: TextUnit

Nilai yang menentukan jenis unit teks, seperti karakter, kata, paragraf, dan sebagainya.

[in] count

Jenis: int

Jumlah unit teks yang akan dipindahkan. Nilai positif memindahkan rentang teks ke depan. Nilai negatif memindahkan rentang teks mundur. Nol tidak berpengaruh.

[out, retval] moved

Jenis: int*

Menerima jumlah unit teks yang benar-benar dipindahkan. Ini bisa kurang dari angka yang diminta jika salah satu titik akhir rentang teks baru lebih besar dari atau kurang dari titik akhir yang diambil oleh metode IUIAutomationTextPattern::D ocumentRange . Nilai ini bisa negatif jika navigasi terjadi ke arah mundur.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

IUIAutomationTextRange::Move memindahkan rentang teks untuk menjangkau bagian teks yang berbeda; itu tidak mengubah teks dengan cara apa pun.

Untuk rentang teks yang tidak degenerasi (tidak kosong), IUIAutomationTextRange::Move menormalkan dan memindahkan rentang dengan melakukan langkah-langkah berikut.

  1. Rentang teks diciutkan ke rentang degenerasi (kosong) di titik akhir awal.
  2. Jika perlu, rentang teks yang dihasilkan dipindahkan mundur dalam dokumen ke awal batas unit teks yang diminta.
  3. Rentang teks dipindahkan ke depan atau mundur dalam dokumen dengan jumlah batas unit teks yang diminta.
  4. Rentang teks diperluas dari status degenerasi dengan memindahkan titik akhir ke depan oleh satu batas unit teks yang diminta.
Jika salah satu langkah sebelumnya gagal, rentang teks dibiarkan tidak berubah. Jika rentang teks tidak dapat dipindahkan sejauh jumlah unit teks yang diminta, tetapi dapat dipindahkan dengan jumlah unit teks yang lebih kecil, rentang teks dipindahkan oleh jumlah unit teks yang lebih kecil dan dipindahkan diatur ke jumlah unit teks yang dipindahkan.

Untuk rentang teks degenerasi, IUIAutomationTextRange::Move hanya memindahkan titik penyisipan teks dengan jumlah unit teks yang ditentukan.

Saat memindahkan rentang teks, IUIAutomationTextRange::Move mengabaikan batas objek yang disematkan dalam teks.

IUIAutomationTextRange::Move menghormati teks tersembunyi dan terlihat.

Jika kontrol berbasis teks tidak mendukung unit teks yang ditentukan oleh parameter unit , IUIAutomationTextRange::Move menggantikan unit teks berikutnya yang didukung lebih besar.

Ukuran unit teks, dari unit terkecil hingga terbesar, adalah sebagai berikut.

  • Karakter
  • Format
  • Word
  • Garis
  • Paragraph
  • Halaman
  • Dokumen

Perilaku rentang saat unitTextUnit::Format

TextUnit::Format sebagai nilai unit memposisikan batas rentang teks untuk memperluas atau memindahkan rentang berdasarkan atribut teks bersama (format) teks dalam rentang. Namun, menggunakan unit teks format tidak akan memindahkan atau memperluas rentang teks di seluruh batas objek yang disematkan, seperti gambar atau hyperlink. Untuk informasi selengkapnya, lihat Unit Teks Automasi UI atau Dukungan Automasi UI untuk Konten Tekstual.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 7, Windows Vista dengan SP2 dan Pembaruan Platform untuk Windows Vista, Windows XP dengan SP3 dan Pembaruan Platform untuk Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2, Windows Server 2008 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008, Windows Server 2003 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header uiautomationclient.h (termasuk UIAutomation.h)

Lihat juga

IUIAutomationTextRange

Dukungan Automasi UI untuk Konten Tekstual