ITaskbarList::SetActiveAlt-Methode (shobjidl_core.h)

Markiert ein Taskleistenelement als aktiv, aktiviert es aber nicht visuell.

Syntax

HRESULT SetActiveAlt(
  HWND hwnd
);

Parameter

hwnd

Typ: HWND

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

Rückgabewert

Typ: HRESULT

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

Hinweise

SetActiveAlt markiert das Element, das hwnd zugeordnet ist, als aktuell aktives 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 aktivieren würde, aktiviert stattdessen die registerkarte, die hwnd zugeordnet ist. Es ist nicht garantiert, dass der aktive Status des Fensterelements beibehalten wird, 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 ist. Durch aufrufen von SetActiveAltmit nullhwnd wird dieser Zustand gelöscht.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (einschließlich Shobjidl.h)
DLL	Shell32.dll (Version 4.71 oder höher)