Método IPicture::get_CurDC (ocidl.h)

  • Artigo

Recupera o identificador do contexto atual do dispositivo. Essa propriedade é válida apenas para imagens de bitmap.

Sintaxe

HRESULT get_CurDC(
  [out] HDC *phDC
);

Parâmetros

[out] phDC

Um ponteiro para uma variável que recebe o contexto do dispositivo.

Retornar valor

Esse método dá suporte ao valor retornado padrão E_FAIL, bem como aos valores a seguir.

Código de retorno Descrição
S_OK
 Os bits de atributo foram retornados com êxito.
E_POINTER
 O valor de phDC não é válido. Por exemplo, pode ser NULL.

Comentários

A propriedade CurDC e o método IPicture::SelectPicture existem para contornar restrições no Windows; especificamente, que um objeto só pode ser selecionado em exatamente um contexto de dispositivo por vez. Em alguns casos, um objeto de imagem pode ser selecionado permanentemente em um contexto de dispositivo específico (por exemplo, um controle pode usar uma determinada imagem para uma tela de fundo). Para usar essa propriedade de imagem em outro lugar, ela deve ser temporariamente desmarcada de seu contexto de dispositivo antigo, selecionada no novo contexto de dispositivo para a operação e, em seguida, reeleita de volta para o contexto de dispositivo antigo. O método IPicture::get_CurDC retorna o identificador de contexto do dispositivo no qual a imagem está selecionada no momento. O método IPicture::SelectPicture seleciona a imagem em um novo contexto de dispositivo, retornando o contexto do dispositivo antigo e o identificador GDI da imagem. O chamador deve selecionar a imagem de volta no contexto do dispositivo antigo quando o chamador terminar de usá-la, como é normal para o código do Windows.

Anotações aos Chamadores

O chamador sempre possui contextos de dispositivo passados entre ele e o objeto de imagem. Como o objeto de imagem mantém uma cópia do HDC, o chamador deve usar um contexto de dispositivo de memória (criado com a função CreateCompatibleDC ) e não um contexto de dispositivo de tela (de GetDC, CreateDC ou BeginPaint), porque os contextos do dispositivo de tela são um recurso de sistema limitado.

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 ocidl.h

Confira também

Ipicture

IPicture::SelectPicture