Méthode ITaskbarList3 ::RegisterTab (shobjidl_core.h)

Article
03/02/2024

Informe la barre des tâches qu’un nouvel onglet ou une nouvelle miniature de document a été fourni pour être affiché dans le menu volant du groupe de barre des tâches d’une application.

Syntaxe

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

Paramètres

[in] hwndTab

Type : HWND

Handle de la fenêtre d’onglet ou de document. Cette valeur est obligatoire et ne peut pas être NULL.

[in] hwndMDI

Type : HWND

Gérer la fenêtre main de l’application. Cette valeur indique à la barre des tâches le groupe d’aperçu de l’application auquel attacher la nouvelle miniature. Cette valeur est obligatoire et ne peut pas être NULL.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite, ou une valeur d’erreur dans le cas contraire. Si l’un des paramètres a la valeur NULL, cette méthode retourne une erreur.

Remarques

En soi, l’inscription d’une miniature d’onglet seule n’entraîne pas son affichage. Vous devez également appeler ITaskbarList3 ::SetTabOrder pour indiquer au groupe où l’afficher.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (inclure Shobjidl.h)
Bibliothèque	Explorerframe.lib
DLL	Explorerframe.dll