Metode ITextRangeProvider::MoveEndpointByUnit (uiautomationcore.h)

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

Sintaks

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

Parameter

endpoint

unit

[in] count

Jenis: int

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

[out, retval] pRetVal

Jenis: int*

Menerima jumlah unit yang benar-benar dipindahkan, yang 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 akan 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 diperlihatkan dalam ilustrasi berikut.

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

ITextRangeProvider::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 karena nilai unit memosisikan batas rentang teks untuk memperluas atau memindahkan rentang berdasarkan atribut teks bersama (format) teks dalam rentang. Namun, menggunakan unit teks format tidak boleh memindahkan atau memperluas rentang teks di seluruh batas objek yang disematkan, seperti gambar atau hyperlink. Untuk informasi selengkapnya, lihat Unit Teks Automasi UI atau Pola Kontrol TextRange dan Teks.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	uiautomationcore.h (termasuk UIAutomation.h)

Lihat juga

Konseptual

ITextProvider

ITextRangeProvider

Referensi

Pola Kontrol Text dan TextRange

Gambaran Umum Penyedia UI Automation