ITextRangeProvider::GetAttributeValue 方法 (uiautomationcore.h)
擷取文字範圍中指定之文字屬性的值。
語法
HRESULT GetAttributeValue(
[in] TEXTATTRIBUTEID attributeId,
[out, retval] VARIANT *pRetVal
);
參數
[in] attributeId
類型: TEXTATTRIBUTEID
文字屬性的識別碼。 如需文字屬性識別碼的清單,請參閱 文字屬性識別碼。
[out, retval] pRetVal
類型: VARIANT*
收到下列其中一項。
- 物件的位址,表示指定之屬性的值。 值的資料類型會根據指定的屬性而有所不同。 例如,如果 attributeId是UIA_FontNameAttributeId, GetAttributeValue 會傳回代表文字範圍的字型名稱的字串,但如果 attributeId是UIA_IsItalicAttributeId, GetAttributeValue 會傳回布林值。
- UiaGetReservedMixedAttributeValue函式所擷取的值位址,如果指定屬性的值會隨著文字範圍而有所不同。
- 如果提供者或控制項不支援指定的屬性, UiaGetReservedNotSupportedValue 函式所擷取的值位址。
傳回值
類型: HRESULT
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
不論文字是隱藏還是可見, GetAttributeValue 方法都應該擷取屬性值。
需求
最低支援的用戶端 | Windows XP [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | uiautomationcore.h (包含 UIAutomation.h) |
另請參閱
概念
參考