次の方法で共有


IAccessible::get_accChild メソッド (oleacc.h)

IAccessible::get_accChild メソッドは、指定した子の IDispatch (存在する場合) を取得します。 すべてのオブジェクトでこのプロパティがサポートされている必要があります。

構文

HRESULT get_accChild(
  [in]          VARIANT   varChild,
  [out, retval] IDispatch **ppdispChild
);

パラメーター

[in] varChild

型: VARIANT

IDispatch インターフェイスが取得される子を識別します。 VARIANT の初期化の詳細については、「子 ID をパラメーターで使用する方法」を参照してください。

[out, retval] ppdispChild

種類: IDispatch**

[out, retval]子オブジェクトの IDispatch インターフェイスのアドレスを受け取ります。

戻り値

種類: HRESULT

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

成功しなかった場合は、次のテーブルの値の 1 つ、または別の標準 COM エラー コードを返します。 サーバーはこれらの値を返しますが、クライアントは常に出力パラメーターをチェックして、有効な値が含まれていることを確認する必要があります。 詳細については、「 IAccessible 戻り値の確認」を参照してください。

エラー 説明
S_FALSE
子はアクセス可能なオブジェクトではありません。
E_INVALIDARG
引数が有効ではありません。

注釈

サーバーは、要素 (子 ID) または完全なオブジェクト (IAccessible インターフェイス ポインター) として要素を公開します。 子が要素の場合、 get_accChild はS_FALSEを返し、親はその子の情報を提供します。 子が完全なオブジェクトである場合、 get_accChildIAccessible インターフェイス ポインターを返し、親はその子に関する情報を提供しません。 サーバー アプリケーションが一時的なシステム エラー (メモリ不足エラーなど) のためにアクセス可能なオブジェクトを作成できないためにget_accChildが失敗した場合、サーバーは適切なエラー コードを返す必要があります。

サーバー開発者への注意: varChildID にVT_EMPTYが含まれている場合は、E_INVALIDARGを返す必要があります。

サーバーの例

次のコード例は、子を持たないオブジェクト、または子がオブジェクトではなく要素であるオブジェクトの実装を示しています。

HRESULT STDMETHODCALLTYPE AccServer::get_accChild( 
    VARIANT varChild,
    IDispatch **ppdispChild)
{
    if (varChild.vt != VT_I4)
    {
        *ppdispChild = NULL;
        return E_INVALIDARG;
    }
    *ppdispChild = NULL;    
    return S_FALSE;     
};

要件

要件
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー oleacc.h
Library Oleacc.lib
[DLL] Oleacc.dll
再頒布可能パッケージ SP6 以降および Windows 95 を使用した Windows NT 4.0 の Active Accessibility 1.3 RDK

こちらもご覧ください

AccessibleChildren

Iaccessible

IAccessible::get_accParent

IDispatch

オブジェクト ナビゲーションのプロパティとメソッド

バリアント