Função GetDC (winuser.h)

Artigo
03/04/2024

A função GetDC recupera um identificador para um DC (contexto de dispositivo) para a área de cliente de uma janela especificada ou para toda a tela. Você pode usar o identificador retornado em funções GDI subsequentes para desenhar no DC. O contexto do dispositivo é uma estrutura de dados opaca, cujos valores são usados internamente pela GDI.

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

Sintaxe

HDC GetDC(
  [in] HWND hWnd
);

Parâmetros

[in] hWnd

Um identificador para a janela cujo DC deve ser recuperado. Se esse valor for NULL, GetDC recuperará o DC para toda a tela.

Retornar valor

Se a função for bem-sucedida, o valor retornado será um identificador para o controlador de domínio da área de cliente da janela especificada.

Se a função falhar, o valor retornado será NULL.

Comentários

A função GetDC recupera um DC comum, de classe ou privado, dependendo do estilo de classe da janela especificada. Para DCs privados e de classe, GetDC deixa os atributos atribuídos anteriormente inalterados. No entanto, para controladores de domínio comuns, o GetDC atribui atributos padrão ao controlador de domínio sempre que ele é recuperado. Por exemplo, a fonte padrão é System, que é uma fonte bitmap. Por isso, o identificador para um DC comum retornado pelo GetDC não informa qual fonte, cor ou pincel foi usado quando a janela foi desenhada. Para determinar a fonte, chame GetTextFace.

Observe que o identificador para o controlador de domínio só pode ser usado por um único thread a qualquer momento.

Depois de pintar com um DC comum, a função ReleaseDC deve ser chamada para liberar o DC. Os DCs de classe e privados não precisam ser liberados. ReleaseDC deve ser chamado do mesmo thread chamado GetDC. O número de DCs é limitado apenas pela memória disponível.

Exemplos

Para obter um exemplo, consulte Desenhando com o mouse.

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)
Biblioteca	User32.lib
DLL	User32.dll