Fonction AccessibleObjectFromPoint (oleacc.h)

Article
02/29/2024

Récupère l’adresse du pointeur d’interface IAccessible pour l’objet affiché à un point spécifié à l’écran.

Syntaxe

HRESULT AccessibleObjectFromPoint(
  [in]  POINT       ptScreen,
  [out] IAccessible **ppacc,
  [out] VARIANT     *pvarChild
);

Paramètres

[in] ptScreen

Spécifie, dans les coordonnées d’écran physiques, le point examiné.

[out] ppacc

Adresse d’une variable pointeur qui reçoit l’adresse de l’interface IAccessible de l’objet.

[out] pvarChild

Adresse d’une structure VARIANT qui spécifie si le pointeur d’interface IAccessible retourné dans ppacc appartient à l’objet affiché au point spécifié ou au parent de l’élément au point spécifié. Le membre vt du VARIANT est toujours VT_I4. Si le membre lVal est CHILDID_SELF, le pointeur d’interface IAccessible à ppacc appartient à l’objet au point. Si le membre lVal n’est pas CHILDID_SELF, ppacc est l’adresse de l’interface IAccessible de l’objet parent de l’élément enfant. Les clients doivent appeler VariantClear sur le paramètre VARIANT récupéré lorsqu’ils ont terminé de l’utiliser.

Valeur retournée

En cas de réussite, retourne S_OK.

En cas de non-réussite, retourne l’un des codes d’erreur COM suivants ou un autre code d’erreur COM standard.

Code de retour	Description
E_INVALIDARG	Un argument n’est pas valide.

Remarques

Cette fonction récupère l’objet accessible de niveau le plus bas dans la hiérarchie d’objets à un point donné. Si l’élément au point n’est pas un objet accessible (autrement dit, ne prend pas en charge IAccessible), la fonction récupère l’interface IAccessible de l’objet parent. L’objet parent doit fournir des informations sur l’élément enfant via l’interface IAccessible . Appelez IAccessible ::accHitTest pour identifier l’élément enfant aux coordonnées d’écran spécifiées.

Comme avec d’autres méthodes et fonctions IAccessible , les clients peuvent recevoir des erreurs pour les pointeurs d’interface IAccessible en raison d’une action utilisateur. Pour plus d’informations, consultez Réception d’erreurs pour les pointeurs d’interface IAccessible.

Exemple de client

L’exemple de fonction suivant sélectionne l’élément à un point spécifié à l’écran. Il est supposé qu’une seule sélection est souhaitée.


HRESULT SelectItemAtPoint(POINT point)
{
    VARIANT varItem;
    IAccessible* pAcc;
    HRESULT hr = AccessibleObjectFromPoint(point, &pAcc, &varItem);
    if ((hr == S_OK))
    {
        hr = pAcc->accSelect((SELFLAG_TAKEFOCUS | SELFLAG_TAKESELECTION), varItem);
        VariantClear(&varItem);
        pAcc->Release();
    }
    return hr;
}

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