共用方式為

ITextRangeProvider：：ExpandToEnclosingUnit 方法 (uiautomationcore.h)

  • 發行項

依指定的文字單位將文字範圍正規化。 如果範圍小於指定的單位，則範圍會展開，如果大於指定的單位，則會縮短範圍。

語法

HRESULT ExpandToEnclosingUnit(
  [in] TextUnit unit
);

參數

[in] unit

類型： TextUnit

文字單位的類型，例如字元、文字、段落等等。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

螢幕助讀程式之類的用戶端應用程式會使用這個方法來擷取插入點或插入號位置上存在的完整文字、句子或段落。

儘管其名稱為何， ITextRangeProvider：：ExpandToEnclosingUnit 方法不一定會展開文字範圍。 相反地，它會藉由移動端點來「正規化」文字範圍，讓範圍包含指定的文字單位。 如果範圍小於指定的單位，則範圍會展開，如果大於指定的單位，則會縮短範圍。 如果範圍已經是指定單位的確切數量，它就會保持不變。 ExpandToEnclosingUnit方法一律以一致的方式正規化文字範圍非常重要;否則，文字單位所操作文字範圍的其他層面將無法預期。 下圖顯示 ExpandToEnclosingUnit 如何藉由移動範圍的端點來正規化文字範圍。

此圖顯示呼叫 ExpandToEnclosingUnit ExpandToEnclosingUnit 之前和之後的端點位置，如果控制項不支援指定的文字單位，則會預設為下一個支援的最大文字單位。 從最小單位到最大的順序如下：
  • 字元
  • 格式
  • Word
  • 線條
  • Paragraph
  • 頁面
  • 文件
ExpandToEnclosingUnit 會同時遵守可見和隱藏的文字。

單位為 時的範圍行為TextUnit::Format

TextUnit::Format 作為 單位 值，會將文字範圍的界限定位為根據共用文字屬性來展開或移動範圍， (格式) 範圍內的文字。 不過，使用格式文字單位不應該在内嵌物件的界限之間移動或展開文字範圍，例如影像或超連結。 如需詳細資訊，請參閱 使用者介面自動化文字單位 或 文字和文字Range 控制項模式。

規格需求

   
最低支援的用戶端 Windows XP [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 uiautomationcore.h (包含 UIAutomation.h)

另請參閱

概念

ITextProvider

ITextRangeProvider

參考

Text 和 TextRange 控制項模式

UI 自動化提供者概觀