GetDCEx

9/9/2008

Essa função recupera um identificador para um contexto para dispositivo exibir (DC) para o área cliente de uma janela especificada ou para a Tela inteira. Você pode usar o identificador retornado em funções interface (GDI) exibir gráficos subseqüentes para desenhar no contexto de dispositivo.

GetDCEx é uma extensão para o GetDC função, que oferece um aplicativo mais controle sobre como e se recorte ocorre na área de cliente.

Syntax

HDC GetDCEx( 
  HWND hWnd, 
  HRGN hrgnClip, 
  DWORD flags
);

Parameters

• hWnd
  Identificador para a janela cujo contexto dispositivo é a serem recuperados.

  Se esse valor é NULL, GetDCEx Recupera o contexto dispositivo para a Tela inteira.

• hrgnClip
  Especifica um região de recorte que pode ser combinada com a região visível do contexto de dispositivo.

• Sinalizadores
  Especifica como o contexto dispositivo é criado.

  Este parâmetro pode ser uma combinação dos seguinte valores.

  Valor	Descrição
  DCX_WINDOW	Retorna um contexto dispositivo correspondente para o retângulo janela rather than o retângulo cliente.
  DCX_CACHE	Retorna um contexto dispositivo a partir de armazenar em cache, em vez de janela OWNDC ou CLASSDC. Essencialmente substitui CS_OWNDC e CS_CLASSDC.
  DCX_PARENTCLIP	Usa a região visível do janela pai. WS_CLIPCHILDREN e CS_PARENTDC estilo Bits do pai são ignorados. A origem contexto dispositivo estiver definida como a upper-left corner da janela identificada por hWnd.
  DCX_CLIPSIBLINGS	Exclui as áreas visíveis de todas as janelas irmão acima a janela identificado por hWnd.
  DCX_CLIPCHILDREN	Exclui as áreas visíveis de todas as janelas filho abaixo a janela identificado por hWnd.
  DCX_NORESETATTRS	Não redefinir os atributos de contexto este dispositivo para o usar como padrão atributos quando este contexto dispositivo for lançado.
  DCX_EXCLUDERGN	O região de recorte identificado por hrgnClip foi excluída da região visível do contexto de dispositivo retornado.
  DCX_EXCLUDEUPDATE	Retorna uma região que exclui atualização região a janela.
  DCX_INTERSECTRGN	O região de recorte identificado por hrgnClip é interseção com a região visível do contexto de dispositivo retornado.
  DCX_INTERSECTUPDATE	Retorna uma região que inclui atualização região a janela.
  DCX_VALIDATE	Quando especificado com DCX_INTERSECTUPDATE, faz com que o contexto dispositivo a ser validado completamente. O uso essa função com DCX_INTERSECTUPDATE e DCX_VALIDATE é idêntico ao uso de BeginPaint função.

Return Value

O identificador do contexto para dispositivo para a janela especificada indica sucesso. NULL Indica falha. Um valor inválido para a hWnd parâmetro faz com que a função falha.

Para informações de erro estendidas get, chamar GetLastError.

Remarks

O Sinalizadores parâmetro suporta o seguinte valores: DCX_WINDOW, DCX_CACHE, DCX_CLIPCHILDREN, DCX_CLIPSIBLINGS, DCX_EXCLUDERGN, DCX_INTERSECTRGN, DCX_EXCLUDEUPDATE e DCX_INTERSECTUPDATE.

Ao contrário um DC retornado por GetDC, um DC retornado por essa função não é mantido em sincronizar com seu associado janela.

Se a janela move ou é redimensionada, inesperado resultados desenho pode ocorrer. A possibilidade de erros é reduzida se um aplicativo obtém um DC, desenha e em seguida, solta que DC.

A menos que o contexto dispositivo exibir pertence a uma classe janela, o ReleaseDC função deve ser chamado para versão o contexto dispositivo após pintura.

Porque somente cinco comum contextos dispositivo estão disponível em um tempo, falha para versão um contexto dispositivo pode evitar outros aplicativos acessem um contexto dispositivo.

A função retorna um contexto dispositivo pertencentes a classe da janela de se CS_CLASSDC, CS_OWNDC ou CS_PARENTDC foi especificado como um estilo in a WNDCLASS estrutura quando a classe foi registrado.

Requirements

Header	winuser.h
Library	coredll.lib, Winmgr.lib
Windows Embedded CE	Windows CE 2.10 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

BeginPaint
GetDC
ReleaseDC
WNDCLASS