IAccessible::accSelect-Methode (oleacc.h)

Artikel
03/04/2024

Die IAccessible::accSelect-Methode ändert die Auswahl oder verschiebt den Tastaturfokus des angegebenen Objekts. Alle Objekte, die die Auswahl unterstützen oder den Tastaturfokus erhalten, müssen diese Methode unterstützen.

Syntax

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

Parameter

[in] flagsSelect

Typ: long

Gibt an, welche Auswahl- oder Fokusvorgänge ausgeführt werden sollen. Dieser Parameter muss eine Kombination der SELFLAG-Konstanten aufweisen.

[in] varChild

Typ: VARIANT

Gibt das ausgewählte Objekt an. Wenn der Wert CHILDID_SELF ist, wird das Objekt selbst ausgewählt. wenn eine untergeordnete ID ausgewählt ist, ist eines der untergeordneten Elemente des Objekts ausgewählt. Weitere Informationen zum Initialisieren der VARIANT-Struktur finden Sie unter Verwenden untergeordneter IDs in Parametern.

Rückgabewert

Typ: HRESULT

Gibt bei Erfolg S_OK zurück.

Wenn dies nicht erfolgreich ist, gibt einen der Werte in der folgenden Tabelle oder einen anderen COM-Standardfehlercode zurück.

Fehler	BESCHREIBUNG
S_FALSE	Das angegebene Objekt ist nicht ausgewählt.
E_INVALIDARG	Ein Argument ist ungültig. Dieser Rückgabewert bedeutet, dass die angegebene SELFLAG-Kombination ungültig ist oder dass der SELFLAG-Wert für das angegebene Objekt nicht sinnvoll ist. Beispielsweise sind die folgenden Flags für ein Listenfeld mit einzeler Auswahl nicht zulässig: SELFLAG_EXTENDSELECTION, SELFLAG_ADDSELECTION und SELFLAG_REMOVESELECTION.
DISP_E_MEMBERNOTFOUND	Diese Methode wird vom -Objekt nicht unterstützt.

Hinweise

Clientanwendungen verwenden diese Methode, um komplexe Auswahlvorgänge auszuführen. Weitere Informationen finden Sie unter Auswählen untergeordneter Objekte. Diese Methode bietet die einfachste Möglichkeit, den Eingabefokus programmgesteuert zwischen Anwendungen zu wechseln. Dies gilt für Anwendungen, die unter Windows 2000 ausgeführt werden.

Hinweis: Diese Methode dient zur Auswahl von Elementen, nicht für Text.

Clientbeispiel

Die folgende Beispielfunktion wählt das Element an einem angegebenen Punkt auf dem Bildschirm aus. Es wird davon ausgegangen, dass eine einzelne Auswahl gewünscht ist.


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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	oleacc.h
Bibliothek	Oleacc.lib
DLL	Oleacc.dll
Verteilbare Komponente	Active Accessibility 1.3 RDK unter Windows NT 4.0 mit SP6 und höher und Windows 95