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

Marca uma janela como tela inteira.

Sintaxe

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

Parameters

[in] hwnd

Tipo: 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 de devolução

Tipo: HRESULT

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

Observações

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 fosse de tela inteira. Com um valor falso 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.

Since Windows 7, chamada 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 à ITaskbarList2::MarkFullscreenWindow(FALSE) exceção de que o Shell não fará fallback para seu recurso de detecção automática e não tratará a janela como tela inteira.

Requirements

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

Consulte também

ITaskbarList

ITaskbarList2

SetPropA

SetPropW