Interface IPicture (ocidl.h)

Gerencia um objeto de imagem e suas propriedades. Objetos de imagem fornecem uma abstração neutra em linguagem para bitmaps, ícones e metarquivos. Assim como acontece com o objeto de fonte padrão, o sistema fornece uma implementação padrão do objeto de imagem. Suas interfaces primárias são IPicture e IPictureDisp, sendo a última derivada de IDispatch para fornecer acesso às propriedades da imagem por meio da Automação. Um objeto de imagem é criado com OleCreatePictureIndirect.

O objeto picture também dá suporte à interface de saída IPropertyNotifySink, para que um cliente possa determinar quando as propriedades da imagem são alteradas. Como o objeto picture dá suporte a pelo menos uma interface de saída, ele também implementa IConnectionPointContainer e suas interfaces associadas para essa finalidade.

O objeto picture também dá suporte a IPersistStream para que ele possa salvar e carregar a si mesmo de uma instância do IStream. Um objeto que usa um objeto de imagem internamente normalmente salvaria e carregaria a imagem como parte do tratamento de persistência do próprio objeto. A função OleLoadPicture simplifica a criação de um objeto de imagem com base no conteúdo do fluxo.

Herança

A interface IPicture herda da interface IUnknown . O IPicture também tem estes tipos de membros:

Métodos

A interface IPicture tem esses métodos.

IPicture::get_Attributes Recupera o conjunto atual de atributos de bits da imagem.
IPicture::get_CurDC Recupera o identificador do contexto atual do dispositivo. Essa propriedade é válida apenas para imagens de bitmap.
IPicture::get_Handle Recupera o identificador para a imagem gerenciada dentro desse objeto de imagem para um local especificado.
IPicture::get_Height Recupera a altura atual da imagem no objeto de imagem.
IPicture::get_hPal Recupera uma cópia da paleta usada atualmente pelo objeto de imagem.
IPicture::get_KeepOriginalFormat Recupera o valor atual da propriedade KeepOriginalFormat da imagem.
IPicture::get_Type Recupera o tipo atual da imagem contida no objeto de imagem.
IPicture::get_Width Recupera a largura atual da imagem no objeto de imagem.
IPicture::P ictureChanged Notifica o objeto de imagem de que seu recurso de imagem foi alterado. Esse método chama apenas IPropertyNotifySink::OnChanged com DISPID_PICT_HANDLE para todos os coletores conectados.
IPicture::p ut_KeepOriginalFormat Define o valor da propriedade KeepOriginalFormat da imagem.
IPicture::Render Renderiza (desenha) uma parte especificada da imagem definida pelo deslocamento (xSrc,ySrc) da imagem de origem e as dimensões a serem copiadas (cxSrc,xySrc).
IPicture::SaveAsFile Salva os dados da imagem em um fluxo no mesmo formato que ele se salvaria em um arquivo. Os bitmaps usam o formato de arquivo BMP, metarquivos do formato WMF e ícones do formato ICO.
IPicture::SelectPicture Seleciona uma imagem de 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.
IPicture::set_hPal Atribui uma paleta GDI à imagem contida no objeto de imagem.

Comentários

Cada propriedade na interface IPicture inclui um método get_PropertyName se a propriedade der suporte ao acesso de leitura e a um método put_PropertyName se a propriedade der suporte ao acesso de gravação.

Propriedade	Tipo	Access	Descrição
Handle	OLE_HANDLE (int)	R	O identificador GDI do Windows da imagem
hPal	OLE_HANDLE (int)	RW	O identificador do Windows da paleta usada pela imagem.
Tipo	short	R	O tipo de imagem (consulte PICTYPE).
Largura	OLE_XSIZE_HIMETRIC (longo)	R	A largura da imagem.
Altura	OLE_YSIZE_HIMETRIC (longo)	R	A altura da imagem.
CurDC	HDC	R	O contexto atual do dispositivo.
KeepOriginalFormat	BOOL	RW	Se TRUE, o objeto de imagem manterá todo o estado original da imagem na memória. Se FALSE, qualquer estado não aplicável ao computador do usuário será descartado.
Atributos	DWORD	R	Diversos atributos de bits da imagem.

 

Implementação de OLE

Objetos de imagem fornecem uma abstração neutra em linguagem para bitmaps, ícones e metarquivos. Assim como acontece com o objeto de fonte padrão, o sistema fornece uma implementação padrão do objeto de imagem. Suas interfaces primárias são IPicture e IPictureDisp. Um objeto picture é criado com OleCreatePictureIndirect e dá suporte às interfaces IPicture e IPictureDisp .

O objeto de imagem fornecido por OLE implementa a semântica completa das interfaces IPicture e IPictureDisp .

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

Ipicturedisp