Share via

Função MonitorFromWindow (winuser.h)

  • Artigo

A função MonitorFromWindow recupera um identificador para o monitor de exibição que tem a maior área de interseção com o retângulo delimitador de uma janela especificada.

Sintaxe

HMONITOR MonitorFromWindow(
  [in] HWND  hwnd,
  [in] DWORD dwFlags
);

Parâmetros

[in] hwnd

Um identificador para a janela de interesse.

[in] dwFlags

Determina o valor retornado da função se a janela não intersecionar nenhum monitor de exibição.

Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
MONITOR_DEFAULTTONEAREST
 Retorna um identificador para o monitor de exibição mais próximo da janela.
MONITOR_DEFAULTTONULL
 Retorna NULL.
MONITOR_DEFAULTTOPRIMARY
 Retorna um identificador para o monitor de exibição primário.

Valor retornado

Se a janela cruzar um ou mais retângulos do monitor de exibição, o valor retornado será um identificador HMONITOR para o monitor de exibição que tem a maior área de interseção com a janela.

Se a janela não intersecionar um monitor de exibição, o valor retornado dependerá do valor de dwFlags.

Comentários

Se a janela estiver minimizada no momento, MonitorFromWindow usará o retângulo da janela antes de ser minimizada.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll
Conjunto de APIs ext-ms-win-ntuser-sysparams-ext-l1-1-1 (introduzido no Windows 10, versão 10.0.14393)

Confira também

MonitorFromPoint

MonitorFromRect

Várias funções de monitores de exibição

Visão geral de vários monitores de exibição