Compartir a través de


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

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

Consulte también

IAccessible

IAccessible::get_accFocus

IAccessible::get_accSelection

SELFLAG

Propiedades y métodos de selección y enfoque

VARIANT