ITextRangeProvider::GetAttributeValue メソッド (uiautomationcore.h)

指定したテキスト属性の値をテキスト範囲全体で取得します。

構文

HRESULT GetAttributeValue(
  [in]          TEXTATTRIBUTEID attributeId,
  [out, retval] VARIANT         *pRetVal
);

[in] attributeId

型: TEXTATTRIBUTEID

テキスト属性の識別子。テキスト属性 ID の一覧については、「テキスト属性識別子」を参照してください。

[out, retval] pRetVal

次のいずれかを受け取ります。

指定した属性の値を表すオブジェクトのアドレス。値のデータ型は、指定した属性によって異なります。たとえば、 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 を含む)