Método ITaskbarList2::MarkFullscreenWindow (shobjidl_core.h)

  • Artigo

Marca uma janela como tela inteira.

Sintaxe

HRESULT MarkFullscreenWindow(
  [in] HWND hwnd,
  [in] BOOL fFullscreen
);

Parâmetros

[in] hwnd

Digite: HWND

O identificador da janela a ser marcada.

[in] fFullscreen

Tipo: BOOL

Um valor booliano marcando o status de tela inteira desejado da janela.

Valor retornado

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

Definindo o valor de fFullscreen como TRUE, o Shell trata essa janela como uma janela de tela inteira e a barra de tarefas é movida para a parte inferior da ordem z quando essa janela está ativa. Definir o valor de fFullscreen como FALSE remove a marcação de tela inteira, mas não faz com que o Shell trate a janela como se ela definitivamente não estivesse em tela inteira. Com um valor false fFullscreen, o Shell depende de seu recurso de detecção automática para especificar como a janela deve ser tratada, possivelmente ainda sinalizando a janela como tela inteira.

Desde o Windows 7, chame SetProp(hwnd, L”NonRudeHWND”, reinterpret_cast<HANDLE>(TRUE)) antes de mostrar uma janela para indicar ao Shell que a janela não deve ser tratada como tela inteira. Isso garante que a barra de tarefas não se ajuste para estar abaixo da janela na ordem z. Isso é semelhante a ITaskbarList2::MarkFullscreenWindow(FALSE) , exceto que o Shell não fará fallback para seu recurso de detecção automática e não tratará a janela como tela inteira.

Requisitos

   
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)
DLL Shell32.dll

Confira também

ITaskbarList

ITaskbarList2

SetPropA

SetPropW