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

  • Artigo

Seleciona uma imagem bitmap em um determinado contexto de dispositivo e retorna o contexto do dispositivo no qual a imagem foi selecionada anteriormente, bem como o identificador GDI da imagem. Esse método funciona em conjunto com IPicture::get_CurDC.

Sintaxe

HRESULT SelectPicture(
  [in]  HDC        hDCIn,
  [out] HDC        *phDCOut,
  [out] OLE_HANDLE *phBmpOut
);

Parâmetros

[in] hDCIn

Um identificador para o contexto do dispositivo no qual selecionar a imagem.

[out] phDCOut

Um ponteiro para uma variável que recebe o contexto anterior do dispositivo. Esse parâmetro poderá ser NULL se o chamador não precisar dessas informações. A propriedade do contexto do dispositivo é sempre responsabilidade do chamador.

[out] phBmpOut

Um ponteiro para uma variável que recebe o identificador GDI da imagem. Esse parâmetro poderá ser NULL se o chamador não precisar do identificador. A propriedade desse identificador é determinada pelo parâmetro fOwn passado para OleCreatePictureIndirect. As imagens carregadas de um fluxo sempre possuem seus recursos.

Retornar valor

Esse método dá suporte aos valores de retorno padrão E_FAIL, E_INVALIDARG, E_OUTOFMEMORY e S_OK.

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::get_CurDC