Condividi tramite


Metodo IAccess::get_accSelection (oleacc.h)

Il metodo IAccess::get_accSelection recupera gli elementi figlio selezionati di questo oggetto. Tutti gli oggetti che supportano la selezione devono supportare questa proprietà.

Sintassi

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

Parametri

[out, retval] pvarChildren

Tipo: VARIANT*

Indirizzo di una struttura VARIANT che riceve informazioni su quali elementi figlio sono selezionati. La tabella seguente descrive le informazioni restituite in pvarChildren.

membro vt Membro valore
VT_EMPTY
Non sono selezionati elementi figlio.
VT_DISPATCH
Viene selezionato un oggetto figlio e l'indirizzo dell'interfaccia IDispatch viene impostato nel membro pdispVal .
VT_I4
lVal contiene l'ID figlio dell'elemento figlio selezionato. Se lVal è CHILDID_SELF, questo significa che l'oggetto stesso è selezionato.
VT_UNKNOWN
Sono selezionati più oggetti figlio e il membro punkVal contiene l'indirizzo dell'interfaccia IUnknown . Il client esegue una query su questa interfaccia per l'interfaccia IEnumVARIANT , che usa per enumerare gli oggetti selezionati.

Valore restituito

Tipo: HRESULT

Se ha esito positivo, restituisce S_OK.

In caso contrario, restituisce uno dei valori della tabella che segue o un altro codice di errore COM standard. I server restituiscono questi valori, ma i client devono sempre controllare i parametri di output per assicurarsi che contengano valori validi. Per altre informazioni, vedere Controllo dei valori restituiti IAccessibile.

Errore Descrizione
DISP_E_MEMBERNOTFOUND
L'oggetto non supporta questa proprietà.

Commenti

Questo metodo deve supportare l'interfaccia IEnumVARIANT .

Questo metodo restituisce un puntatore dell'interfaccia IDispatch o un ID figlio per il parametro pvarChildren . Per altre informazioni su come usare il puntatore dell'interfaccia IDispatch o l'ID figlio, vedere Modalità di utilizzo degli ID figlio nei parametri.

Come per altri metodi e funzioni IAccessi , i client potrebbero ricevere errori per i puntatori di interfaccia IAccessi a causa di un'azione utente. Per altre informazioni, vedere Ricezione di errori per i puntatori dell'interfaccia IAccessibile.

Nota: Questo metodo recupera un elemento selezionato, non selezionato testo.

Esempio di server

Il codice di esempio seguente mostra un'implementazione possibile di questo metodo per una casella di riepilogo di selezione singola personalizzata. Il metodo GetSelectedIndex restituisce -1 se non è selezionato alcun elemento.

// 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;
};




Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione oleacc.h
Libreria Oleacc.lib
DLL Oleacc.dll
Componente ridistribuibile Accessibilità attiva 1.3 RDK in Windows NT 4.0 con SP6 e versioni successive e Windows 95

Vedi anche

Iaccessible

IAccessibile::accSelect

IAccessibile::get_accFocus

Idispatch

Proprietà e metodi di selezione e messa a fuoco

VARIANTE