ITextRangeProvider.Move(TextUnit, Int32) Metode

Definisi

Ruang nama:

System.Windows.Automation.Provider

Rakitan:

UIAutomationTypes.dll

Memindahkan rentang teks jumlah unit teks yang ditentukan.

public:
 int Move(System::Windows::Automation::Text::TextUnit unit, int count);

public int Move (System.Windows.Automation.Text.TextUnit unit, int count);

abstract member Move : System.Windows.Automation.Text.TextUnit * int -> int

Public Function Move (unit As TextUnit, count As Integer) As Integer

Parameter

unit

TextUnit

Batas unit teks.

count

Int32

Jumlah unit teks yang akan dipindahkan.

Nilai positif memindahkan rentang teks ke depan, nilai negatif memindahkan rentang teks mundur, dan 0 tidak berpengaruh.

Mengembalikan

Int32

Jumlah unit 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 DocumentRange titik akhir.

Keterangan

Ketika perlu untuk melintasi konten rentang teks, serangkaian langkah terlibat di belakang layar agar metode Move berhasil dijalankan.

1. Rentang teks dinormalisasi; yaitu, rentang teks diciutkan menjadi rentang yang merosot di titik akhir Start, yang membuat titik akhir End tidak berguna. Langkah ini diperlukan untuk menghapus ambiguitas dalam situasi di mana rentang teks mencakup unit batas; misalnya, "{U}RL https://www.microsoft.com/ disematkan dalam teks" di mana "{" dan "}" adalah titik akhir rentang teks.

2. Rentang yang dihasilkan dipindahkan ke belakang di DocumentRange ke awal batas unit yang diminta.

3. Rentang dipindahkan ke depan atau ke belakang di DocumentRange dengan jumlah batas unit yang diminta.

4. Rentang kemudian diperluas dari status rentang yang merosot dengan memindahkan titik akhir End dengan satu batas unit yang diminta.

Contoh bagaimana rentang teks disesuaikan untuk Move() dan ExpandToEnclosingUnit()

Konten tekstual (atau teks dalam) kontainer teks dan objek yang disematkan, seperti hyperlink atau sel tabel, diekspos sebagai aliran teks berkelanjutan tunggal dalam tampilan kontrol dan tampilan konten pohon Automation UI; batas objek diabaikan.

Contoh aliran teks dengan objek yang disematkan dan rentang rentangnya

Move menghormati teks tersembunyi dan terlihat.

Move menunda ke terbesar TextUnit berikutnya yang didukung jika yang diberikan TextUnit tidak didukung oleh kontrol.

Pesanan, dari unit terkecil hingga terbesar, tercantum di bawah ini.

• Character

• Format

• Word

• Line

• Paragraph

• Page

• Document

Teks tidak diubah dengan cara apa pun, rentang teks hanya mencakup bagian teks yang berbeda.