Método ITaskbarList3::SetTabOrder (shobjidl_core.h)

Artigo
03/13/2024

Insere uma nova miniatura em um submenu de grupo do aplicativo TDI (interface de documento com guias) ou MDI (interface de vários documentos) ou move uma miniatura existente para uma nova posição no grupo do aplicativo.

Sintaxe

HRESULT SetTabOrder(
  [in]           HWND hwndTab,
  [in, optional] HWND hwndInsertBefore
);

Parâmetros

[in] hwndTab

Digite: HWND

O identificador da janela da guia cuja miniatura está sendo colocada. Esse valor é necessário, já deve estar registrado por meio de ITaskbarList3::RegisterTab e não pode ser NULL.

[in, optional] hwndInsertBefore

Digite: HWND

O identificador da janela de guia cuja miniatura hwndTab é inserida à esquerda de. Esse identificador já deve estar registrado por meio de ITaskbarList3::RegisterTab. Se esse valor for NULL, a nova miniatura será adicionada ao final da lista.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Esse método deve ser chamado para que a miniatura seja mostrada no grupo. Chame-o depois de ter chamado ITaskbarList3::RegisterTab.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)
Biblioteca	Explorerframe.lib
DLL	Explorerframe.dll