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

Uma função de retorno de chamada definida pelo aplicativo usada com a função EnumDisplayMonitors . O tipo MONITORENUMPROC define um ponteiro para essa função de retorno de chamada. MonitorEnumProc é um espaço reservado para o nome da função definida pelo aplicativo.

Sintaxe

MONITORENUMPROC Monitorenumproc;

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

Parâmetros

unnamedParam1

Tipo: HMONITOR

Um identificador para o monitor de exibição. Esse valor sempre será diferente de NULL. Esse parâmetro normalmente é chamado de hMonitor.

unnamedParam2

Tipo: HDC

Um identificador para um contexto de dispositivo. Esse parâmetro normalmente é chamado de hdcMonitor.

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 identificado 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

Tipo: LPRECT

Um ponteiro para uma estrutura RECT . Esse parâmetro normalmente é chamado lprcMonitor.

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 de 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

Tipo: LPARAM

Dados definidos pelo aplicativo que o EnumDisplayMonitors passa diretamente para a função de enumeração. Esse parâmetro normalmente é chamado de dwData.

Valor de retorno

Tipo: BOOL

Para continuar a enumeração, retorne TRUE.

Para interromper a enumeração, retorne FALSE.

Observações

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, o 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.

Requirements

Consulte também

EnumDisplayMonitors

Funções de monitores de exibição múltiplas

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