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

Article
02/29/2024

La méthode IAccessible ::get_accSelection récupère les enfants sélectionnés de cet objet. Tous les objets qui prennent en charge la sélection doivent prendre en charge cette propriété.

Syntaxe

HRESULT get_accSelection(
  [out, retval] VARIANT *pvarChildren
);

Paramètres

[out, retval] pvarChildren

Type : VARIANT*

Adresse d’une structure VARIANT qui reçoit des informations sur les enfants sélectionnés. Le tableau suivant décrit les informations retournées dans pvarChildren.

membre vt	Membre value
VT_EMPTY	Aucun enfant n’est sélectionné.
VT_DISPATCH	Un objet enfant est sélectionné et l’adresse de son interface IDispatch est définie dans le membre pdispVal .
VT_I4	lVal contient l’ID enfant de l’élément enfant sélectionné. Si lVal est CHILDID_SELF, cela signifie que l’objet lui-même est sélectionné.
VT_UNKNOWN	Plusieurs objets enfants sont sélectionnés et le membre punkVal contient l’adresse de l’interface IUnknown . Le client interroge cette interface pour l’interface IEnumVARIANT , qu’il utilise pour énumérer les objets sélectionnés.

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. 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 IAccessibles.

Erreur	Description
DISP_E_MEMBERNOTFOUND	L’objet ne prend pas en charge cette propriété.

Remarques

Cette méthode doit prendre en charge l’interface IEnumVARIANT .

Cette méthode retourne un pointeur d’interface IDispatch ou un ID enfant pour le paramètre pvarChildren . Pour plus d’informations sur l’utilisation du pointeur d’interface IDispatch ou de l’ID enfant, consultez Utilisation des ID enfants dans les paramètres.

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.

Note: Cette méthode récupère un élément sélectionné, et non du texte sélectionné.

Exemple de serveur

L’exemple de code suivant montre une implémentation possible de cette méthode pour une zone de liste à sélection unique personnalisée. Sa méthode GetSelectedIndex retourne -1 si aucun élément n’est sélectionné.


// m_pControl is the control that returns this accessible object. 

HRESULT STDMETHODCALLTYPE AccServer::get_accSelection(VARIANT *pvarChildren)
{
    int childID = m_pControl->GetSelectedIndex() + 1; // Convert from 0-based. 
    if (childID <= 0)
    {
        pvarChildren->vt = VT_EMPTY;
    }
    else 
    {
        pvarChildren->vt = VT_I4;
        pvarChildren->lVal = childID;
    }
    return S_OK;
};

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