ITaskbarList::SetActiveAlt-Methode (shobjidl_core.h)

Markiert ein Taskleistenelement als aktiv, aktiviert aber nicht visuell.

Syntax

HRESULT SetActiveAlt(
  HWND hwnd
);

Parameter

hwnd

Typ: HWND-

Ein Handle für das Fenster, das als aktiv markiert werden soll.

Rückgabewert

Typ: HRESULT-

Wenn diese Methode erfolgreich ist, wird S_OKzurückgegeben. Andernfalls wird ein HRESULT- Fehlercode zurückgegeben.

Bemerkungen

SetActiveAlt markiert das Element, das hwnd zugeordnet ist, als das derzeit aktive Element für den Prozess des Fensters, ohne den gedrückten Zustand eines Elements zu ändern. Jede Benutzeraktion, die eine andere Registerkarte in diesem Prozess aktiviert, aktiviert stattdessen die registerkarte, die hwnd zugeordnet ist. Der aktive Status des Fensterelements wird nicht garantiert beibehalten, wenn der mit hwnd- verknüpfte Prozess nicht aktiv ist. Um sicherzustellen, dass eine bestimmte Registerkarte immer aktiv ist, rufen Sie SetActiveAlt auf, wenn eines ihrer Fenster aktiviert wird. Das Aufrufen SetActiveAlt- mit einem NULL-hwnd löscht diesen Zustand.

Anforderungen