Partager via


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

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

Voir aussi

Iaccessible

IAccessible ::accSelect

IAccessible ::get_accFocus

IDispatch

Méthodes et propriétés de sélection et de focus

VARIANTE