Bagikan melalui


ITextRangeProvider.MoveEndpointByUnit Metode

Definisi

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

public:
 int MoveEndpointByUnit(System::Windows::Automation::Text::TextPatternRangeEndpoint endpoint, System::Windows::Automation::Text::TextUnit unit, int count);
public int MoveEndpointByUnit (System.Windows.Automation.Text.TextPatternRangeEndpoint endpoint, System.Windows.Automation.Text.TextUnit unit, int count);
abstract member MoveEndpointByUnit : System.Windows.Automation.Text.TextPatternRangeEndpoint * System.Windows.Automation.Text.TextUnit * int -> int
Public Function MoveEndpointByUnit (endpoint As TextPatternRangeEndpoint, unit As TextUnit, count As Integer) As Integer

Parameter

endpoint
TextPatternRangeEndpoint

Titik akhir yang akan dipindahkan.

unit
TextUnit

Unit tekstual untuk pemindahan.

count
Int32

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

Mengembalikan

Jumlah unit benar-benar dipindahkan, yang bisa kurang dari angka yang diminta jika memindahkan titik akhir berjalan ke awal atau akhir dokumen.

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 kemudian diperluas dari status rentang yang merosot dengan memindahkan titik akhir End dengan satu batas unit yang diminta.

Penyesuaian rentang menurut Pindahkan & penyesuaian Rentang ExpandToEnclosingUnit
Contoh bagaimana rentang teks disesuaikan untuk Move() dan ExpandToEnclosingUnit()

MoveEndpointByUnit 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.

Berlaku untuk