ITaskbarList3::RegisterTab-Methode (shobjidl_core.h)

Artikel
03/06/2024

Informiert die Taskleiste darüber, dass eine neue Registerkarten- oder Dokumentminiaturansicht zur Anzeige im Taskleistengruppen-Flyout einer Anwendung bereitgestellt wurde.

Syntax

HRESULT RegisterTab(
  [in] HWND hwndTab,
  [in] HWND hwndMDI
);

Parameter

[in] hwndTab

Typ: HWND

Handle des Registerkarten- oder Dokumentfensters. Dieser Wert ist erforderlich und darf nicht NULL sein.

[in] hwndMDI

Typ: HWND

Handle des Standard Fensters der Anwendung. Dieser Wert teilt der Taskleiste mit, an welche Vorschaugruppe der Anwendung die neue Miniaturansicht angefügt werden soll. Dieser Wert ist erforderlich und darf nicht NULL sein.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen Fehlerwert zurück. Wenn einer der Parameter NULL ist, gibt diese Methode einen Fehler zurück.

Hinweise

Allein das Registrieren einer Registerkartenminiaturansicht führt nicht dazu, dass sie angezeigt wird. Sie müssen auch ITaskbarList3::SetTabOrder aufrufen, um die Gruppe anzuweisen, wo sie angezeigt werden soll.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (einschließlich Shobjidl.h)
Bibliothek	Explorerframe.lib
DLL	Explorerframe.dll