CW&nd::GetDCExnbsp;

CDC *GetDCEx (CRgn *prgnClip,DWORDdesinalizadores de);

Valor de retorno

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

Parâmetros

prgnClip

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

sinalizadores

Pode ter um dos seguintes valores predefinidos:

• DCX_CACHEnbsp;  Retorna um contexto de dispositivo do cache em vez de janela OW&NDC ou CLASSDC . Substitui CS_OWNDC e CS_CLASSDC.
  
  
• DCX_CLIPCHILDRE&Nnbsp;  Exclui as áreas visíveis de todas as janelas filho abaixo da janela CWnd.
  
  
• DCX_CLIPSIBLI&NGSnbsp;  Exclui as áreas visíveis de todas as windows irmão acima da janela CWnd.
  
  
• DCX_EXCLUDERG&Nnbsp;  Exclui a região de corte identificada por prgnClip da região visível do contexto de dispositivo retornado.
  
  
• DCX_I&NTERSECTRGNnbsp;  Intercepta a região de corte identificada por prgnClip dentro da região visível do contexto de dispositivo retornado.
  
  
• DCX_LOCKWI&NDOWUPDATEnbsp;  Permite desenho mesmo se houver um LockWindowUpdate chamar em vigor que caso contrário seria excluir esta janela. Esse valor é usado para desenho durante o rastreamento.
  
  
• DCX_PARE&NTCLIPnbsp;  Usa a região visível da janela pai e ignora bits de estilo WS_CLIPCHILDREN e WS_PARENTDC da janela pai. Esse valor define a origem do contexto de dispositivo para o upper-Esquerda canto da janela CWnd.
  
  
• DCX_WI&NDOWnbsp;  Retorna um contexto dispositivo que corresponde para o retângulo janela, em vez do Retangular de cliente.

Observações

Recupera o identificador de um contexto de dispositivo para a janela CWnd . O contexto de dispositivo pode ser usado em funções GDI subseqüentes para desenhar na área do cliente.

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

A menos que o contexto de dispositivo pertence a uma classe de janela, o ReleaseDC função deve ser chamada para liberar o contexto após desenho. Uma vez que apenas cinco comum contextos dispositivo estão disponíveis em um determinado momento, falha para versão um contexto dispositivo pode impedir que outros aplicativos acessem um contexto para dispositivo.

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

Um contexto de dispositivo com características especiais é retornado pelo GetDCEx função se CS_CLASSDC, CS_OWNDC, ou estilo CS_PARENTDC foi especificado no estrutura WNDCLASS quando a classe foi registrado.

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

|&Nbsp CWnd visão geral ; Membros de classe | Gráfico de hierarquia

Consulte tambémnbsp;CWnd:: BeginPaint, CWnd::GetDC, CWnd::GetWindowDC, CWnd::ReleaseDC, :: GetDCEx