Metodo IAccessible::accSelect (oleacc.h)

Articolo
08/25/2023

Il metodo IAccessible::accSelect modifica la selezione o sposta lo stato attivo della tastiera dell'oggetto specificato. Tutti gli oggetti che supportano la selezione o ricevono lo stato attivo della tastiera devono supportare questo metodo.

Sintassi

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

Parametri

[in] flagsSelect

Tipo: long

Specifica le operazioni di selezione o messa a fuoco da eseguire. Questo parametro deve avere una combinazione delle costanti SELFLAG.

[in] varChild

Tipo: VARIANT

Specifica l'oggetto selezionato. Se il valore è CHILDID_SELF, viene selezionato l'oggetto stesso; se un ID figlio, viene selezionato uno degli elementi figlio dell'oggetto. Per altre informazioni sull'inizializzazione della struttura VARIANT, vedere Modalità di utilizzo degli ID figlio nei parametri.

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.

Errore	Descrizione
S_FALSE	L'oggetto specificato non è selezionato.
E_INVALIDARG	Un argomento non è valido. Questo valore restituito indica che la combinazione SELFLAG specificata non è valida o che il valore SELFLAG non ha senso per l'oggetto specificato. Ad esempio, i flag seguenti non sono consentiti in una casella di riepilogo a selezione singola: SELFLAG_EXTENDSELECTION, SELFLAG_ADDSELECTION e SELFLAG_REMOVESELECTION.
DISP_E_MEMBERNOTFOUND	L'oggetto non supporta questo metodo.

Commenti

Le applicazioni client usano questo metodo per eseguire operazioni di selezione complesse. Per altre informazioni, vedere Selezione di oggetti figlio. Questo metodo fornisce il modo più semplice per cambiare lo stato attivo dell'input a livello di codice tra le applicazioni. Questo vale per le applicazioni in esecuzione in Windows 2000.

Nota: Questo metodo è per la selezione di elementi, non per il testo.

Esempio di client

La funzione di esempio seguente seleziona l'elemento in corrispondenza di un punto specificato sullo schermo. Si presuppone che sia desiderata una singola selezione.


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

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