Compartilhar via


CWnd::GetDCEx

Recupera a alça de um contexto de dispositivo para o CWnd janela.

CDC* GetDCEx(
   CRgn* prgnClip,
   DWORD flags 
);

Parâmetros

  • prgnClip
    Identifica uma região de recorte que pode ser combinada com a região visível da janela do cliente.

  • flags
    Pode ter um dos seguintes valores predefinidos:

    • DCX_CACHE   Retorna um contexto de dispositivo do cache em vez do OWNDC or CLASSDC janela. SubstituiCS_OWNDC and CS_CLASSDC.

    • DCX_CLIPCHILDREN   Exclui as regiões visíveis de todas as janelas filho abaixo o CWnd janela.

    • DCX_CLIPSIBLINGS   Exclui as regiões visíveis de todas as janelas irmãs acima de CWnd janela.

    • DCX_EXCLUDERGN   Exclui a região de recorte identificada por prgnClip região visível do contexto de dispositivo retornado.

    • DCX_INTERSECTRGN   Intercepta a região de recorte identificada por prgnClip dentro da região visível do contexto de dispositivo retornado.

    • DCX_LOCKWINDOWUPDATE   Permite que o desenho mesmo se houver um LockWindowUpdate Chame no efeito contrário seria excluir esta janela. Esse valor é usado para desenho durante o acompanhamento.

    • DCX_PARENTCLIP   Usa a região visível da janela pai e ignora WS_CLIPCHILDREN and WS_PARENTDC estilo bits.Esse valor define origem do contexto de dispositivo para o canto superior esquerdo do CWnd janela.

    • DCX_WINDOW   Retorna um contexto de dispositivo correspondente para o retângulo de janela em vez do retângulo do cliente.

Valor de retorno

O contexto de dispositivo para a janela especificada se a função for bem-sucedida; caso contrário, NULO.

Comentários

O contexto de dispositivo pode ser usado nas funções GDI subseqüentes para desenhar na área de cliente.

Essa função, que é uma extensão para o GetDC função, permite que um aplicativo mais controle sobre como e se um contexto de dispositivo para uma janela será recortado.

A menos que o contexto de dispositivo pertence a uma classe de janela, a versão DC função deve ser chamada para versão contexto depois de desenho.Como apenas cinco contextos de dispositivo comuns estão disponível a qualquer momento, falha ao liberar um contexto de dispositivo pode impedir que outros aplicativos tenham acesso a um contexto de dispositivo.

Para obter um contexto de dispositivo em cache, um aplicativo deve especificar DCX_CACHE.If DCX_CACHE não for especificado e a janela é nenhuma CS_OWNDC nor CS_CLASSDC, essa função retorna NULO.

Um contexto de dispositivo com características especiais retornado pelo GetDCEx funcionar se o CS_CLASSDC, CS_OWNDC, or CS_PARENTDC especificado no estiloWNDCLASS estrutura quando a classe foi registrada.

Para obter mais informações sobre essas características, consulte a descrição do WNDCLASS estrutura o Windows SDK.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CWnd

Gráfico de hierarquia

CWnd::BeginPaint

CWnd::GetDC

CWnd::GetWindowDC

CWnd::ReleaseDC

GetDCEx

Outros recursos

Membros CWnd