Bagikan melalui

ITextRangeProvider.ExpandToEnclosingUnit(TextUnit) Metode

  • Referensi

Definisi

Ruang nama:
System.Windows.Automation.Provider
Rakitan:
UIAutomationProvider.dll
Rakitan:
UIAutomationProvider.dll, UIAutomationTypes.dll
Rakitan:
UIAutomationTypes.dll

Memperluas rentang teks ke unit teks yang ditentukan.

public:
 void ExpandToEnclosingUnit(System::Windows::Automation::Text::TextUnit unit);
public void ExpandToEnclosingUnit (System.Windows.Automation.Text.TextUnit unit);
abstract member ExpandToEnclosingUnit : System.Windows.Automation.Text.TextUnit -> unit
Public Sub ExpandToEnclosingUnit (unit As TextUnit)

Parameter

unit
TextUnit

Unit tekstual.

Keterangan

Jika rentang sudah merupakan jumlah yang tepat dari unit yang ditentukan, maka rentang tersebut tetap tidak berubah.

Ada serangkaian langkah yang terlibat di belakang layar agar Move metode 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.

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

Catatan

Langkah-langkah ini diperlukan karena adalah umum bagi pembaca layar untuk membaca kata lengkap, kalimat, atau seluruh paragraf di titik penyisipan atau posisi kursor virtual apa pun.

ExpandToEnclosingUnit menghormati teks tersembunyi dan terlihat.

ExpandToEnclosingUnit 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