Metodo IAccess::get_accSelection (oleacc.h)

Articolo
02/29/2024

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