Método IAccessible::accSelect (oleacc.h)

Artículo
08/25/2023

El método IAccessible::accSelect modifica la selección o mueve el foco de teclado del objeto especificado. Todos los objetos que admiten la selección o reciben el foco del teclado deben admitir este método.

Sintaxis

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

Parámetros

[in] flagsSelect

Tipo: long

Especifica qué operaciones de selección o enfoque se van a realizar. Este parámetro debe tener una combinación de las constantes SELFLAG.

[in] varChild

Tipo: VARIANT

Especifica el objeto seleccionado. Si el valor es CHILDID_SELF, se selecciona el propio objeto; si se selecciona un identificador secundario, se selecciona uno de los elementos secundarios del objeto. Para obtener más información sobre cómo inicializar la estructura VARIANT, vea Cómo se usan los identificadores secundarios en parámetros.

Valor devuelto

Tipo: HRESULT

Si se ejecuta correctamente, devuelve S_OK.

Si no se ejecuta correctamente, devuelve uno de los valores de la tabla siguiente u otro código de error COM estándar.

Error	Descripción
S_FALSE	El objeto especificado no está seleccionado.
E_INVALIDARG	Un argumento no es válido. Este valor devuelto significa que la combinación SELFLAG especificada no es válida o que el valor SELFLAG no tiene sentido para el objeto especificado. Por ejemplo, no se permiten las marcas siguientes en un cuadro de lista de selección única: SELFLAG_EXTENDSELECTION, SELFLAG_ADDSELECTION y SELFLAG_REMOVESELECTION.
DISP_E_MEMBERNOTFOUND	El objeto no admite este método.

Comentarios

Las aplicaciones cliente usan este método para realizar operaciones de selección complejas. Para obtener más información, vea Seleccionar objetos secundarios. Este método proporciona la manera más sencilla de cambiar mediante programación el foco de entrada entre aplicaciones. Esto se aplica a las aplicaciones que se ejecutan en Windows 2000.

Nota: Este método es para la selección de elementos, no para texto.

Ejemplo de cliente

La siguiente función de ejemplo selecciona el elemento en un punto especificado en la pantalla. Se supone que se desea una sola selección.


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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	oleacc.h
Library	Oleacc.lib
Archivo DLL	Oleacc.dll
Redistribuible	RDK de accesibilidad activa 1.3 en Windows NT 4.0 con SP6 y versiones posteriores y Windows 95