Win32 API 日本語リファレンス
ホーム › UI.Accessibility › IUIAutomationValuePattern

IUIAutomationValuePattern

COM
📘 Microsoft Learn (日本語) · English
IIDa94cd8b1-0844-4cd6-9d2d-640537ab39e9継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

範囲を持たず、文字列として表現できる値を含むコントロールへのアクセスを提供します。

メソッド 5

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT SetValue(LPWSTR val)

要素の値を設定します。

valLPWSTRin設定する値。

戻り値

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

解説(Remarks)

CurrentIsEnabled プロパティが TRUE であり、かつ IUIAutomationValuePattern::CurrentIsReadOnly プロパティが FALSE である必要があります。

vtbl 4 HRESULT get_CurrentValue(LPWSTR* retVal)

要素の値を取得します。

retValLPWSTR*outコントロールの現在の値を表す文字列を受け取る文字列ポインタへのポインタである。

解説(Remarks)

単一行の編集コントロールは、IUIAutomationValuePattern を通じてその内容へのプログラムによるアクセスをサポートします。ただし、複数行の編集コントロールはこのコントロールパターンをサポートしておらず、その内容は IUIAutomationTextPattern を使用して取得する必要があります。

このプロパティは、書式情報や部分文字列値の取得をサポートしていません。これらのシナリオでも IUIAutomationTextPattern を使用する必要があります。

vtbl 5 HRESULT get_CurrentIsReadOnly(BOOL* retVal)

要素の値が読み取り専用かどうかを示します。

retValBOOL*out値が読み取り専用かどうかを示す論理値を受け取るポインタである。

解説(Remarks)

IUIAutomationValuePattern::SetValue が成功するには、このプロパティが TRUE である必要があります。

vtbl 6 HRESULT get_CachedValue(LPWSTR* retVal)

要素のキャッシュされた値を取得します。

retValLPWSTR*outキャッシュされたコントロールの値を表す文字列を受け取る文字列ポインタへのポインタである。

解説(Remarks)

単一行の編集コントロールは、IUIAutomationValuePattern を通じてその内容へのプログラムによるアクセスをサポートします。ただし、複数行の編集コントロールはこのコントロールパターンをサポートしておらず、その内容は IUIAutomationTextPattern を使用して取得する必要があります。

このプロパティは、書式情報や部分文字列値の取得をサポートしていません。これらのシナリオでも IUIAutomationTextPattern を使用する必要があります。

vtbl 7 HRESULT get_CachedIsReadOnly(BOOL* retVal)

要素の値が読み取り専用かどうかを示す、キャッシュされた値を取得します。

retValBOOL*outキャッシュされた、値が読み取り専用かどうかを示す論理値を受け取るポインタである。

解説(Remarks)

IUIAutomationValuePattern::SetValue が成功するには、このプロパティが TRUE である必要があります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_IUIAutomationValuePattern "{A94CD8B1-0844-4CD6-9D2D-640537AB39E9}"
#usecom global IUIAutomationValuePattern IID_IUIAutomationValuePattern "{}"
#comfunc global IUIAutomationValuePattern_SetValue               3 wstr
#comfunc global IUIAutomationValuePattern_get_CurrentValue       4 var
#comfunc global IUIAutomationValuePattern_get_CurrentIsReadOnly  5 var
#comfunc global IUIAutomationValuePattern_get_CachedValue        6 var
#comfunc global IUIAutomationValuePattern_get_CachedIsReadOnly   7 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。