Partager via


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

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

Voir aussi

AccessibleChildren

Iaccessible

IAccessible ::get_accParent

IDispatch

Propriétés et méthodes de navigation d’objet

VARIANTE