Interfaccia IPicture (ocidl.h)

Gestisce un oggetto immagine e le relative proprietà. Gli oggetti immagine forniscono un'astrazione indipendente dal linguaggio per bitmap, icone e metafile. Come per l'oggetto carattere standard, il sistema fornisce un'implementazione standard dell'oggetto immagine. Le interfacce principali sono IPicture eIPictureDisp, che vengono derivate da IDispatch per fornire l'accesso alle proprietà dell'immagine tramite Automazione. Viene creato un oggetto immagine con OleCreatePictureIndirect.

L'oggetto immagine supporta anche l'interfaccia in uscita IPropertyNotifySink, in modo che un client possa determinare quando cambiano le proprietà dell'immagine. Poiché l'oggetto immagine supporta almeno un'interfaccia in uscita, implementa anche IConnectionPointContainer e le interfacce associate a questo scopo.

L'oggetto immagine supporta anche IPersistStream in modo che possa salvare e caricare se stesso da un'istanza di IStream. Un oggetto che usa un oggetto immagine internamente salva e carica l'immagine come parte della gestione della persistenza dell'oggetto. La funzione OleLoadPicture semplifica la creazione di un oggetto immagine in base al contenuto del flusso.

Ereditarietà

L'interfaccia IPicture eredita dall'interfaccia IUnknown . IPicture include anche questi tipi di membri:

Metodi

L'interfaccia IPicture include questi metodi.

 
IPicture::get_Attributes

Recupera il set corrente degli attributi di bit dell'immagine.
IPicture::get_CurDC

Recupera l'handle del contesto di dispositivo corrente. Questa proprietà è valida solo per le immagini bitmap.
IPicture::get_Handle

Recupera l'handle nell'immagine gestita all'interno dell'oggetto immagine in una posizione specificata.
IPicture::get_Height

Recupera l'altezza corrente dell'immagine nell'oggetto immagine.
IPicture::get_hPal

Recupera una copia della tavolozza attualmente utilizzata dall'oggetto immagine.
IPicture::get_KeepOriginalFormat

Recupera il valore corrente della proprietà KeepOriginalFormat dell'immagine.
IPicture::get_Type

Recupera il tipo corrente dell'immagine contenuta nell'oggetto immagine.
IPicture::get_Width

Recupera la larghezza corrente dell'immagine nell'oggetto immagine.
IPicture::P ictureChanged

Notifica all'oggetto immagine che la risorsa immagine è stata modificata. Questo metodo chiama solo IPropertyNotifySink::OnChanged con DISPID_PICT_HANDLE per qualsiasi sink connesso.
IPicture::p ut_KeepOriginalFormat

Imposta il valore della proprietà KeepOriginalFormat dell'immagine.
IPicture::Render

Esegue il rendering (disegna) di una parte specificata dell'immagine definita dall'offset (xSrc,ySrc) dell'immagine di origine e delle dimensioni da copiare (cxSrc,xySrc).
IPicture::SaveAsFile

Salva i dati dell'immagine in un flusso nello stesso formato in cui verrà salvato in un file. Le bitmap usano il formato di file BMP, metafiles il formato WMF e icone il formato ICO.
IPicture::SelectPicture

Seleziona un'immagine bitmap in un determinato contesto di dispositivo e restituisce il contesto del dispositivo in cui l'immagine è stata selezionata in precedenza, nonché l'handle GDI dell'immagine. Questo metodo funziona insieme a IPicture::get_CurDC.
IPicture::set_hPal

Assegna una tavolozza GDI all'immagine contenuta nell'oggetto immagine.

Commenti

Ogni proprietà nell'interfaccia IPicture include un metodo get_PropertyName se la proprietà supporta l'accesso in lettura e un metodo put_PropertyName se la proprietà supporta l'accesso in scrittura.

Proprietà Type Accesso Descrizione
Handle OLE_HANDLE (int) R Handle GDI di Windows dell'immagine
hPal OLE_HANDLE (int) LS Handle di Windows della tavolozza utilizzata dall'immagine.
Tipo short R Tipo di immagine (vedere PICTYPE).
Larghezza OLE_XSIZE_HIMETRIC (long) R Larghezza dell'immagine.
Altezza OLE_YSIZE_HIMETRIC (long) R Altezza dell'immagine.
CurDC HDC R Contesto del dispositivo corrente.
KeepOriginalFormat BOOL LS Se TRUE, l'oggetto immagine mantiene l'intero stato originale dell'immagine in memoria. Se FALSE, qualsiasi stato non applicabile al computer dell'utente viene rimosso.
Attributi DWORD R Attributi di bit vari dell'immagine.
 

Implementazione OLE

Gli oggetti immagine forniscono un'astrazione indipendente dal linguaggio per bitmap, icone e metafile. Come per l'oggetto carattere standard, il sistema fornisce un'implementazione standard dell'oggetto immagine. Le interfacce principali sono IPicture e IPictureDisp. Un oggetto immagine viene creato con OleCreatePictureIndirect e supporta sia le interfacce IPicture che IPictureDisp .

L'oggetto immagine fornito da OLE implementa la semantica completa delle interfacce IPicture e IPictureDisp.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione ocidl.h

Vedi anche

IPictureDisp