Méthode IAccessible ::get_accChild (oleacc.h)

Article
03/04/2024

La méthode IAccessible ::get_accChild récupère un IDispatch pour l’enfant spécifié, le cas échéant. Tous les objets doivent prendre en charge cette propriété.

Syntaxe

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

Paramètres

[in] varChild

Type : VARIANT

Identifie l’enfant dont l’interface IDispatch est récupérée. Pour plus d’informations sur l’initialisation du VARIANT, consultez Utilisation des ID enfants dans les paramètres.

[out, retval] ppdispChild

Type : IDispatch**

[out, retval] Reçoit l’adresse de l’interface IDispatch de l’objet enfant.

Valeur retournée

Type : HRESULT

En cas de réussite, retourne S_OK.

En cas d’erreur, retourne l’une des valeurs de la table qui suit ou un autre code d’erreur COM standard. Les serveurs retournent ces valeurs, mais les clients doivent toujours case activée paramètres de sortie pour s’assurer qu’ils contiennent des valeurs valides. Pour plus d’informations, consultez Vérification des valeurs de retour IAccessible.

Erreur	Description
S_FALSE	L’enfant n’est pas un objet accessible.
E_INVALIDARG	Un argument n’est pas valide.

Remarques

Les serveurs exposent des éléments sous forme d’éléments (ID enfants) ou d’objets complets (pointeurs d’interface IAccessible ). Si un enfant est un élément, get_accChild retourne S_FALSE et le parent fournit des informations pour cet enfant. Si l’enfant est un objet complet, get_accChild retourne le pointeur d’interface IAccessible et le parent ne fournit pas d’informations sur cet enfant. Si get_accChild échoue parce que l’application serveur ne peut pas créer un objet accessible en raison d’une erreur système temporaire (telle qu’une erreur de mémoire insuffisante), le serveur doit retourner un code d’échec approprié.

Remarque pour les développeurs de serveurs : Si varChildID contient VT_EMPTY, vous devez retourner E_INVALIDARG.

Exemple de serveur

L’exemple de code suivant montre une implémentation pour un objet qui n’a pas d’enfants ou dont les enfants sont des éléments plutôt que des objets.


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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	oleacc.h
Bibliothèque	Oleacc.lib
DLL	Oleacc.dll
Composant redistribuable	Active Accessibility 1.3 RDK sur Windows NT 4.0 avec SP6 et versions ultérieures et Windows 95