Método Graphics::GetHDC (gdiplusgraphics.h)
O método Graphics::GetHDC obtém um identificador para o contexto do dispositivo associado a esse objeto Graphics .
Sintaxe
HDC GetHDC();
Valor retornado
Tipo: HDC
Esse método retorna um identificador para o contexto do dispositivo associado a este objeto Graphics .
Comentários
Cada chamada para o método Graphics::GetHDC de um objeto Graphics deve ser emparelhada com uma chamada para o método Graphics::ReleaseHDC desse mesmo objeto Graphics . Não chame nenhum método do objeto Graphics entre as chamadas para Graphics::GetHDC e Graphics::ReleaseHDC. Se você tentar chamar um método do objeto Graphics entre Graphics::GetHDC e Graphics::ReleaseHDC, o método falhará e retornará ObjectBusy.
Todas as alterações de estado feitas no contexto do dispositivo entre Graphics::GetHDC e Graphics::ReleaseHDC serão ignoradas pelo GDI+ e não serão refletidas na renderização feita pelo GDI+.
Exemplos
A função a seguir usa GDI+ para desenhar uma elipse, usa GDI para desenhar um retângulo e, por fim, usa GDI+ para desenhar uma linha. O único parâmetro da função é um ponteiro para um objeto GDI+ Graphics . O código chama o método Graphics::D rawEllipse desse objeto Graphics para desenhar uma elipse . Em seguida, o código chama o método Graphics::GetHDC para obter um identificador para o contexto do dispositivo associado ao objeto Graphics . O código desenha um retângulo passando o identificador de contexto do dispositivo para a função Retângulo GDI. O código chama o método Graphics::ReleaseHDC do objeto Graphics e usa o objeto Graphics para desenhar uma linha.
VOID Example_GetReleaseHDC(Graphics* g)
{
Pen pen(Color(255, 0, 0, 255));
g->DrawEllipse(&pen, 10, 10, 100, 50); // GDI+
HDC hdc = g->GetHDC();
// Make GDI calls, but don't call any methods
// on g until after the call to ReleaseHDC.
Rectangle(hdc, 120, 10, 220, 60); // GDI
g->ReleaseHDC(hdc);
// Ok to call methods on g again.
g->DrawLine(&pen, 240, 10, 340, 60);
}
Requisitos
| Cliente mínimo com suporte | Windows XP, 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 | gdiplusgraphics.h (inclua Gdiplus.h) |
| Biblioteca | Gdiplus.lib |
| DLL | Gdiplus.dll |