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 |