COleControl::GetDC

Artigo
08/25/2010

Fornece para um objeto sem janelas para obter uma tela (ou compatível) contexto para dispositivo de seu contêiner.

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

Parâmetros

lprcRect
Um ponteiro para o retângulo de controle sem janelas quer redesenhar nas coordenadas do cliente do controle.NULO significa que a extensão total do objeto.
dwFlags
Atributos do contexto de dispositivo de desenho.As opções são:
- OLEDC_NODRAW Indica que o objeto não usar o contexto de dispositivo para executar qualquer desenho, mas simplesmente para obter informações sobre o dispositivo de vídeo.O contêiner simplesmente deve passar controlador de domínio da janela sem processamento adicional.
- OLEDC_PAINTBKGND Solicitações que o contêiner de pintar o segundo plano antes de retornar o controlador de domínio.Um objeto deve usar este sinalizar se ele está solicitando um controlador de domínio para redesenhar uma área com cor de plano de fundo transparente.
- OLEDC_OFFSCREEN Informa o contêiner em que o objeto deseja processar em um bitmap fora da tela, em seguida, deve ser copiado para a tela.Um objeto deve usar esse sinalizar quando a operação de desenho que está prestes a executar gera muita cintilação.O contêiner está disponível para aceitar essa solicitação ou não.No entanto, se este sinalizar não for definido, o contêiner deve mão novamente uma tela DC.Isso permite que objetos executar operações de tela direta sistema autônomo exibir uma seleção (via um XOR operação).

Valor de retorno

Ponteiro para o contexto de dispositivo de vídeo para o contêiner CWnd área de cliente se bem-sucedida; caso contrário, o valor retornado é NULO.O contexto de dispositivo de vídeo pode ser usado nas funções GDI subseqüentes para desenhar na área de cliente da janela do contêiner.

Comentários

The ReleaseDCfunção de membro deve ser chamada para liberar o contexto depois de pintura.Ao chamar GetDC, objetos de passam o retângulo que desejam desenhar em seus próprios coordenadas do cliente. GetDC Converte para coordenadas da área de cliente do contêiner. O objeto não deve solicitação um retângulo de desenho desejado maior do que seu próprio retângulo de área de cliente, o dimensionar do que pode ser recuperado com GetClientRect.Isso evita que objetos inadvertidamente desenho onde eles não deveriam.