Compartilhar via


COleControl::GetDC

Fornece um objeto sem janelas para obter um contexto de dispositivo de tela (ou o) correspondente do recipiente.

CDC* GetDC(
   LPCRECT lprcRect = NULL,
   DWORD dwFlags = OLEDC_PAINTBKGND 
);

Parâmetros

  • lprcRect
    Um ponteiro para o retângulo que o controle sem janelas deseja redesenho, em coordenadas do cliente do controle.NULO significa a extensão do objeto completo.

  • dwFlags
    Atributos de desenho do contexto de dispositivo.As opções são:

    • OLEDC_NODRAW indica que o objeto não usará o contexto de dispositivo para executar desenho mas nenhum simplesmente para obter informações sobre o dispositivo de vídeo.O contêiner deve simplesmente passar dc. da janela sem adicional.

    • OLEDC_PAINTBKGND solicita que a pintura do recipiente o plano de fundo antes de retornar dc.Um objeto deve usar este sinalizador se estiver solicitando uma C.C. redesenhando uma área com plano de fundo transparente.

    • OLEDC_OFFSCREEN informa o contêiner que o objeto deseja processar em um bitmap de fora- tela em que deve ser copiado para a tela.Um objeto deve usar este sinalizador quando a operação de desenho é o ponto de execução gera de tremulação.O contêiner está livre honrar a solicitação ou não.Em o entanto, se este sinalizador não é definido, o contêiner deve entregar novamente uma C.C. na tela.Isso permite que objetos para executar operações através da tela como mostrar uma seleção (por uma operação de XOR ).

Valor de retorno

Ponteiro para o contexto do dispositivo de vídeo para a área cliente de CWnd de contêiner se com êxito; caso contrário, o valor de retorno é NULO.O contexto do dispositivo de vídeo pode ser usado em funções subseqüentes do GDI para desenhar na área cliente da janela do recipiente.

Comentários

A função de membro de ReleaseDC deve ser chamada para liberar o contexto depois que a pintura.A o chamar GetDC, os objetos passar o retângulo que deseja desenhar em suas próprias coordenadas do cliente.EssesGetDC converte para coordenadas da área cliente do contêiner.O objeto não deve solicitar um retângulo desenho desejado maior do que seu próprio retângulo da área cliente, o tamanho de que pode ser recuperada com GetClientRect.Isso impede que os objetos desenhar inadvertidamente em onde não deveriam.

Requisitos

Cabeçalho: afxctl.h

Consulte também

Referência

Classe de COleControl

Gráfico de hierarquia

COleControl::ReleaseDC