Compartilhar via


Função MonitorFromRect (winuser.h)

A função MonitorFromRect recupera um identificador para o monitor de exibição que tem a maior área de interseção com um retângulo especificado.

Sintaxe

HMONITOR MonitorFromRect(
  [in] LPCRECT lprc,
  [in] DWORD   dwFlags
);

Parâmetros

[in] lprc

Um ponteiro para uma estrutura RECT que especifica o retângulo de interesse em coordenadas de tela virtual.

[in] dwFlags

Determina o valor retornado da função se o retângulo não cruza 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 do retângulo.
MONITOR_DEFAULTTONULL
Retorna NULL.
MONITOR_DEFAULTTOPRIMARY
Retorna um identificador para o monitor de exibição primário.

Retornar valor

Se o retângulo cruzar um ou mais retângulos de 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 o retângulo.

Se o retângulo não cruzar um monitor de exibição, o valor retornado dependerá do valor de dwFlags.

Requisitos

Requisito Valor
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

MonitorFromWindow

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

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