ITextRangeProvider.ExpandToEnclosingUnit(TextUnit) メソッド

定義

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

指定されたテキスト単位にテキスト範囲を拡大します。

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)

テキスト単位。

指定した単位の正確な数量が既に範囲である場合は、変更されません。

メソッドが正常に実行されるように、一連の手順が Move バックグラウンドで行われます。

テキスト範囲は正規化されます。つまり、テキスト範囲は Start エンドポイントで低次元テキスト範囲に縮小されるため、 End エンドポイントは不要になります。この手順は、テキスト範囲が境界をまた unit ぐ状況であいまいさを取り除くために必要です。たとえば、"{The U}RL https://www.microsoft.com/ is embedded in text" ("{" と "}" はテキスト範囲のエンドポイント) です。
結果として得られる範囲は、 DocumentRange 内で、要求された unit 境界の先頭に向かって後方に移動されます。
この範囲は、 DocumentRange 内で、 unit 境界の要求された数だけ、前方または後方に移動されます。
その後、この範囲は、要求された 1 つの End 境界の分、 unit エンドポイントを移動することによって、低次元テキスト範囲の状態から展開されます。

Move & ExpandToEnclosingUnit Range
テキスト範囲を Move() と ExpandToEnclosingUnit() に対して調整する方法の例

注意

これらの手順は、スクリーンリーダーが挿入ポイントまたは仮想カーソル位置で完全な単語、文、または段落全体を読み上げるのが一般的であるため、必要です。

ExpandToEnclosingUnit は、非表示のテキストと表示されるテキストの両方を尊重します。

ExpandToEnclosingUnitは、指定されたがコントロールでサポートされていない場合TextUnit、サポートされている次の最大TextUnitに遅延します。

最小単位から最大までの順序を以下に示します。