Partager via


Fonction AccessibleObjectFromPoint (oleacc.h)

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

Voir aussi

AccessibleObjectFromEvent

AccessibleObjectFromWindow

Accessibilité active et mise à l’échelle de l’écran Windows Vista

Iaccessible

VARIANT Structure