CWnd::GetDCEx
Recupera a alça de um contexto de dispositivo para a janela de CWnd .
CDC* GetDCEx(
CRgn* prgnClip,
DWORD flags
);
Parâmetros
prgnClip
Identifica uma região recortada que pode ser combinado com a área visível da janela de cliente.flags
Pode ter um dos seguintes valores predefinidos:DCX_CACHE retorna um contexto de dispositivo de cache em vez da janela de OWNDC ou de CLASSDC . Substitui CS_OWNDC e CS_CLASSDC.
DCX_CLIPCHILDREN exclui as regiões visíveis de todas as janelas filho abaixo da janela de CWnd .
DCX_CLIPSIBLINGS exclui as regiões visíveis de todas as janelas irmãos acima da janela de CWnd .
DCX_EXCLUDERGN exclui a região recortada identificada por prgnClip da área visível de contexto retornado do dispositivo.
DCX_INTERSECTRGN cruza a região recortada identificada por prgnClip dentro da área visível de contexto retornado do dispositivo.
DCX_LOCKWINDOWUPDATE reserva desenhar mesmo se houver uma chamada de LockWindowUpdate aplicado para excluir de outra forma essa janela. Esse valor é usado durante desenhando o rastreamento.
DCX_PARENTCLIP usa a área visível da janela pai e ignora de estilo pai de WS_CLIPCHILDREN e de WS_PARENTDC bit da janela. Esse valor define a fonte do contexto de dispositivo ao canto superior esquerdo da janela de CWnd .
DCX_WINDOW retorna um contexto de dispositivo que corresponde ao retângulo da janela em vez do retângulo de cliente.
Valor de retorno
O contexto de dispositivo para a janela especificada se a função é com êxito; se não NULO.
Comentários
O contexto de dispositivo pode ser usado em funções subseqüentes do GDI para desenhar na área cliente.
Essa função, que é uma extensão para a função de GetDC , fornece a um aplicativo mais controle sobre como e se um contexto de dispositivo para uma janela está cortado.
A menos que o contexto de dispositivo pertencer a uma classe de janela, a função de ReleaseDC deve ser chamada para liberar o contexto de desenho. Como apenas cinco contextos comuns de dispositivo estão disponíveis em um determinado momento, a falha liberar um contexto de dispositivo pode impedir que outros aplicativos tenham acesso a um contexto de dispositivo.
Para obter um contexto em cache de dispositivo, um aplicativo deve especificar DCX_CACHE. Se DCX_CACHE não é especificado e a janela é CS_OWNDC nem nem CS_CLASSDC, retorna NULOde essa função.
Um contexto de dispositivo com características especiais é retornado pela função de GetDCEx se o estilo de CS_CLASSDC, de CS_OWNDC, ou de CS_PARENTDC foi especificado na estrutura de WNDCLASS quando a classe foi registrada.
Para obter mais informações sobre essas características, consulte a descrição da estrutura de WNDCLASS em Windows SDK.
Requisitos
Cabeçalho: afxwin.h