TextRange_ExpandToEnclosingUnit函式 (uiautomationcoreapi.h)

注意此函式已被取代。用戶端應用程式應該改用 Microsoft 使用者介面自動化元件物件模型 (COM) 介面。

將文字範圍展開為較大的或較小的單位，例如 Character、Word、Line 或 Page。

語法

HRESULT TextRange_ExpandToEnclosingUnit(
  [in] HUIATEXTRANGE hobj,
  [in] TextUnit      unit
);

[in] hobj

類型： HUIATEXTRANGE

文字範圍物件。

[in] unit

類型： TextUnit

提供者必須展開文字範圍的單位。

類型： HRESULT

如果成功或錯誤值，則傳回S_OK。

如果範圍已經是指定單位的整數編號，它就會保持不變。

如果起始端點不在 TextUnit 界限，則會往後移動，直到它位於界限為止。接著，如果結束端點不在界限，或它位於與起始端點相同的界限，則結束端點會向前移動，直到端點位於界限為止。

注意螢幕助讀程式通常會在插入點或任何虛擬游標位置讀出完整文字、整個段落等等。

TextRange_ExpandToEnclosingUnit 會同時遵守隱藏和可見的文字。 UI Automationclient 可以檢查隱藏的屬性 (Text_IsHidden_Attribute_GUID) 是否有文字可見性。

如果控件不支援指定的 TextUnit，TextRange_ExpandToEnclosingUnit 預設為下一個支援的 TextUnit 。