Compartilhar via


Função MonitorFromPoint (winuser.h)

A função MonitorFromPoint recupera um identificador para o monitor de exibição que contém um ponto especificado.

Sintaxe

HMONITOR MonitorFromPoint(
  [in] POINT pt,
  [in] DWORD dwFlags
);

Parâmetros

[in] pt

Uma estrutura POINT que especifica o ponto de interesse em coordenadas de tela virtual.

[in] dwFlags

Determina o valor retornado da função se o ponto não estiver contido em nenhum monitor de exibição.

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

Valor Significado
MONITOR_DEFAULTTONULL
0x00000000
Retorna NULL.
MONITOR_DEFAULTTOPRIMARY
0x00000001
Retorna um identificador para o monitor de exibição primário.
MONITOR_DEFAULTTONEAREST
0x00000002
Retorna um identificador para o monitor de exibição mais próximo do ponto.

Retornar valor

Se o ponto estiver contido por um monitor de exibição, o valor retornado será um identificador HMONITOR para esse monitor de exibição.

Se o ponto não estiver contido por 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

MonitorFromRect

MonitorFromWindow

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

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