IUIAutomationTextRange：：ExpandToEnclosingUnit 方法 (uiautomationclient.h)

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

語法

HRESULT ExpandToEnclosingUnit(
  [in] TextUnit textUnit
);

參數

[in] textUnit

類型： TextUnit

文字單位，例如行或段落。

傳回值

類型： HRESULT

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

備註

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

儘管其名稱，ExpandToEnclosingUnit 方法不一定會展開文字範圍。 相反地，它會藉由移動端點來「正規化」文字範圍，讓範圍包含指定的文字單位。 如果範圍小於指定的單位，則範圍會展開，如果大於指定的單位，則會縮短範圍。 如果範圍已經是指定單位的確切數量，它就會保持不變。 下圖顯示 ExpandToEnclosingUnit 如何藉由行動範圍的端點來正規化文字範圍。

顯示 ExpandToEnclosingUnit 前後端點的圖表

如果控件不支援指定的文字單位，ExpandToEnclosingUnit 預設為下一個支援的最大文字單位。

從最小單位到最大的順序如下：

• 字元
• 格式
• Word
• 線
• Paragraph
• 頁面
• 文件

ExpandToEnclosingUnit 會同時遵守可見和隱藏的文字。

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

TextUnit::Format，作為 單位 值，會將文字範圍的界限置於範圍中，根據共用文字屬性來展開或移動範圍 (或格式) 。 不過， Format 文字單位不會在內嵌物件的界限之間移動或展開文字範圍，例如影像或超連結。 如需詳細資訊，請參閱 使用者介面自動化 文字單元或 使用者介面自動化 文字內容的支援。

規格需求

需求	值
最低支援的用戶端	Windows 7、Windows Vista SP2 和 Platform Update for Windows Vista、Windows XP 含 SP3 和適用於 Windows Vista 的平臺更新 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008、Windows Server 2003 SP2 和 Platform Update for Windows Server 2008 [僅限桌面應用程式]
目標平台	Windows
標頭	uiautomationclient.h (包含 UIAutomation.h)

另請參閱

IUIAutomationTextRange 介面，使用者介面自動化 支援文字內容