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

Article
02/29/2024

La méthode IAccessible ::accSelect modifie la sélection ou déplace le focus clavier de l’objet spécifié. Tous les objets qui prennent en charge la sélection ou qui reçoivent le focus clavier doivent prendre en charge cette méthode.

Syntaxe

HRESULT accSelect(
  [in] long    flagsSelect,
  [in] VARIANT varChild
);

Paramètres

[in] flagsSelect

Type : long

Spécifie les opérations de sélection ou de focus à effectuer. Ce paramètre doit avoir une combinaison des constantes SELFLAG.

[in] varChild

Type : VARIANT

Spécifie l’objet sélectionné. Si la valeur est CHILDID_SELF, l’objet lui-même est sélectionné ; si un ID enfant, l’un des éléments enfants de l’objet est sélectionné. Pour plus d’informations sur l’initialisation de la structure VARIANT, consultez Utilisation des ID enfants dans les paramètres.

Valeur retournée

Type : HRESULT

En cas de réussite, retourne S_OK.

En cas de non-réussite, retourne l’une des valeurs de la table qui suit ou un autre code d’erreur COM standard.

Erreur	Description
S_FALSE	L’objet spécifié n’est pas sélectionné.
E_INVALIDARG	Un argument n’est pas valide. Cette valeur de retour signifie que la combinaison SELFLAG spécifiée n’est pas valide ou que la valeur SELFLAG n’a pas de sens pour l’objet spécifié. Par exemple, les indicateurs suivants ne sont pas autorisés dans une zone de liste à sélection unique : SELFLAG_EXTENDSELECTION, SELFLAG_ADDSELECTION et SELFLAG_REMOVESELECTION.
DISP_E_MEMBERNOTFOUND	L’objet ne prend pas en charge cette méthode.

Remarques

Les applications clientes utilisent cette méthode pour effectuer des opérations de sélection complexes. Pour plus d’informations, consultez Sélection d’objets enfants. Cette méthode fournit le moyen le plus simple de basculer par programmation le focus d’entrée entre les applications. Cela s’applique aux applications s’exécutant sur Windows 2000.

Note: Cette méthode est destinée à la sélection d’éléments, et non de texte.

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