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