Função de retorno de chamada MONITORENUMPROC (winuser.h)

Uma função MonitorEnumProc é uma função de retorno de chamada definida pelo aplicativo que é chamada pela função EnumDisplayMonitors .

Um valor do tipo MONITORENUMPROC é um ponteiro para uma função MonitorEnumProc .

Sintaxe

MONITORENUMPROC Monitorenumproc;

BOOL Monitorenumproc(
  HMONITOR unnamedParam1,
  HDC unnamedParam2,
  LPRECT unnamedParam3,
  LPARAM unnamedParam4
)
{...}

Parâmetros

unnamedParam1

Um identificador para o monitor de exibição. Esse valor sempre será não NULL.

unnamedParam2

Um identificador para um contexto de dispositivo.

O contexto do dispositivo tem atributos de cor apropriados para o monitor de exibição identificado pelo hMonitor. A área de recorte do contexto do dispositivo é definida como a interseção da região visível do contexto do dispositivo identificada pelo parâmetro hdc de EnumDisplayMonitors, o retângulo apontado pelo parâmetro lprcClip de EnumDisplayMonitors e o retângulo do monitor de exibição.

Esse valor será NULL se o parâmetro hdc de EnumDisplayMonitors for NULL.

unnamedParam3

Um ponteiro para uma estrutura RECT .

Se hdcMonitor não for NULL, esse retângulo será a interseção da área de recorte do contexto do dispositivo identificado pelo hdcMonitor e pelo retângulo do monitor de exibição. As coordenadas do retângulo são coordenadas de contexto do dispositivo.

Se hdcMonitor for NULL, esse retângulo será o retângulo do monitor de exibição. As coordenadas do retângulo são coordenadas de tela virtual.

unnamedParam4

Dados definidos pelo aplicativo que EnumDisplayMonitors passam diretamente para a função de enumeração.

Retornar valor

Para continuar a enumeração, retorne TRUE.

Para interromper a enumeração, retorne FALSE.

Comentários

Você pode usar a função EnumDisplayMonitors para enumerar o conjunto de monitores de exibição que cruzam a região visível de um contexto de dispositivo especificado e, opcionalmente, um retângulo de recorte. Para fazer isso, defina o parâmetro hdc como um valor não NULL e defina o parâmetro lprcClip conforme necessário.

Você também pode usar a função EnumDisplayMonitors para enumerar um ou mais monitores de exibição na área de trabalho, sem fornecer um contexto de dispositivo. Para fazer isso, defina o parâmetro hdc de EnumDisplayMonitors como NULL e defina o parâmetro lprcClip conforme necessário.

Em todos os casos, EnumDisplayMonitors chama uma função MonitorEnumProc especificada uma vez para cada monitor de exibição no conjunto de enumeração calculado. A função MonitorEnumProc sempre recebe um identificador para o monitor de exibição.

Se o parâmetro hdc de EnumDisplayMonitors não for NULL, a função MonitorEnumProc também receberá um identificador para um contexto de dispositivo cujo formato de cor é apropriado para o monitor de exibição. Em seguida, você pode pintar no contexto do dispositivo de uma maneira ideal para o monitor de exibição.

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)

Confira também

Enumdisplaymonitors

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

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