Funzione OleLoadPictureEx (olectl.h)

Crea un nuovo oggetto immagine e lo inizializza dal contenuto di un flusso. Equivale a chiamare OleCreatePictureIndirect con NULL come primo parametro, seguito da una chiamata a IPersistStream::Load.

Sintassi

WINOLECTLAPI OleLoadPictureEx(
  [in]  LPSTREAM lpstream,
  [in]  LONG     lSize,
  [in]  BOOL     fRunmode,
  [in]  REFIID   riid,
  [in]  DWORD    xSizeDesired,
  [in]  DWORD    ySizeDesired,
  [in]  DWORD    dwFlags,
  [out] LPVOID   *lplpvObj
);

Parametri

[in] lpstream

Puntatore al flusso contenente i dati dell'immagine.

[in] lSize

Numero di byte che devono essere letti dal flusso oppure zero se l'intero flusso deve essere letto.

[in] fRunmode

L'opposto del valore iniziale della proprietà KeepOriginalFormat . Se TRUE, KeepOriginalFormat è impostato su FALSE e viceversa.

[in] riid

Riferimento all'identificatore dell'interfaccia che descrive il tipo di puntatore di interfaccia da restituire in ppvObj.

[in] xSizeDesired

Larghezza desiderata dell'icona o del cursore. I valori validi sono 16, 32 e 48. Passare LP_DEFAULT a entrambi i parametri di dimensione per usare le dimensioni predefinite del sistema.

[in] ySizeDesired

Altezza desiderata dell'icona o del cursore. I valori validi sono 16, 32 e 48. Passare LP_DEFAULT a entrambi i parametri di dimensione per usare le dimensioni predefinite del sistema.

[in] dwFlags

Profondità di colore desiderata per l'icona o il cursore. I valori sono LP_MONOCHROME (monocromatico), LP_VGACOLOR (16 colori), LP_COLOR (256 colori) o LP_DEFAULT (seleziona la profondità migliore per la visualizzazione corrente).

[out] lplpvObj

Indirizzo della variabile del puntatore che riceve il puntatore di interfaccia richiesto in riid. Al termine della restituzione, *ppvObj contiene il puntatore di interfaccia richiesto nella risorsa di archiviazione dell'oggetto identificato dal moniker. Se *ppvObj non è NULL, questa funzione chiama IUnknown::AddRef nell'interfaccia; è responsabilità del chiamante chiamare IUnknown::Release. Se si verifica un errore, *ppvObj è impostato su NULL.

Valore restituito

Questa funzione restituisce S_OK in caso di esito positivo. Altri valori possibili includono quanto segue.

Commenti

Il flusso deve essere in formato BMP (bitmap), WMF (metafile) o ICO (icona). Un oggetto immagine creato con OleLoadPictureEx ha sempre la proprietà delle relative risorse interne (fOwn==TRUE è implicito).

Oltre a consentire la specifica delle dimensioni dell'icona o del cursore, OleLoadPictureEx supporta il caricamento di cursori colore.

Requisiti

Vedi anche

OleCreatePictureIndirect

PICTDESC