ホーム › UI.Accessibility › LPFNCREATESTDACCESSIBLEOBJECT

LPFNCREATESTDACCESSIBLEOBJECT

コールバック

シグネチャ

HRESULT LPFNCREATESTDACCESSIBLEOBJECT(
    HWND hwnd,
    INT idObject,
    GUID* riid,
    void** ppvObject
);

パラメーター

フィールド	型	説明
hwnd	HWND	アクセシブルオブジェクトを作成する対象となる、システム提供のユーザーインターフェイス要素(コントロール)のウィンドウハンドルです。
idObject	INT	オブジェクト ID です。この値は通常 OBJID_CLIENT ですが、別のオブジェクト識別子を指定することもできます。
riid	GUID*	要求するインターフェイスの参照識別子です。この値は IID_IAccessible、IID_IDispatch、IID_IEnumVARIANT、IID_IUnknown のいずれかです。
ppvObject	void**	指定したインターフェイスのアドレスを受け取るポインター変数のアドレスです。

公式ドキュメント

指定された種類のシステム提供ユーザーインターフェイス要素のメソッドとプロパティを備えたアクセシブルオブジェクトを作成します。

戻り値

型: STDAPI

成功した場合は S_OK を返します。

失敗した場合は、標準の COM エラーコードを返します。

解説(Remarks)

サーバーアプリケーションは、システム提供のオブジェクトに似たカスタム UI オブジェクトを含む場合に、この関数を呼び出します。サーバー開発者は CreateStdAccessibleObject を呼び出し、カスタムオブジェクトに合わせて必要に応じて IAccessible のメソッドとプロパティをオーバーライドできます。あるいは、CreateStdAccessibleObject が必要とする難しいサブクラス化の手法を使わずに、動的注釈 (Dynamic Annotation) を使用して特定のプロパティのみをオーバーライドすることもできます。子要素を非表示にする、プレースホルダーとなる子要素を作成するといった構造的な変更には、引き続き CreateStdAccessibleObject を使用してください。この方法により、サーバー開発者は IAccessible のすべてのプロパティとメソッドを完全に実装する手間を省くことができます。

この関数は CreateStdAccessibleProxy に似ていますが、CreateStdAccessibleProxy がクラス名をパラメーターとして指定できるのに対し、CreateStdAccessibleObject は hwnd パラメーターに関連付けられたクラス名を使用する点が異なります。

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