Função GetDC (winuser.h)
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 |
Confira também
Funções de contexto do dispositivo