ITextRangeProvider.MoveEndpointByUnit Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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.
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.Rentang yang dihasilkan dipindahkan ke belakang di DocumentRange ke awal batas
unit
yang diminta.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()
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.