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