Metode IUIAutomationTextRange::MoveEndpointByUnit (uiautomationclient.h)

Memindahkan satu titik akhir rentang teks jumlah unit teks yang ditentukan dalam rentang dokumen.

Sintaks

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

Parameter

[in] endpoint

Jenis: TextPatternRangeEndpoint

Nilai yang menentukan titik akhir (awal atau akhir) untuk dipindahkan.

[in] unit

Jenis: TextUnit

Nilai yang menentukan unit tekstual untuk pemindahan, seperti baris atau paragraf.

[in] count

Jenis: int

Jumlah unit yang akan dipindahkan. Jumlah positif memindahkan titik akhir ke depan. Jumlah negatif bergerak mundur. Hitungan 0 tidak berpengaruh.

[out, retval] moved

Jenis: int*

Menerima jumlah unit yang benar-benar dipindahkan. Nilai ini bisa kurang dari angka yang diminta jika memindahkan titik akhir berjalan ke awal atau akhir dokumen.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Titik akhir dipindahkan ke depan atau mundur, seperti yang ditentukan, ke batas unit berikutnya yang tersedia. Jika titik akhir asli berada di batas unit teks yang ditentukan, titik akhir dipindahkan ke batas unit teks berikutnya yang tersedia, seperti yang ditunjukkan dalam ilustrasi berikut.

Jika titik akhir yang dipindahkan melewati titik akhir lain dari rentang teks yang sama, titik akhir lainnya juga dipindahkan, menghasilkan rentang yang turun dan memastikan urutan titik akhir yang benar (artinya, awal selalu kurang dari atau sama dengan akhir).

MoveEndpointByUnit tidak digunakan lagi hingga unit teks berikutnya yang didukung jika unit teks yang diberikan tidak didukung oleh kontrol.

Pesanan, dari unit terkecil hingga terbesar, tercantum di sini.

• Karakter
• Format
• Word
• Line
• 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