OleLoadPictureEx, fonction (olectl.h)

Crée un objet image et l’initialise à partir du contenu d’un flux. Cela équivaut à appeler OleCreatePictureIndirect avec NULL comme premier paramètre, suivi d’un appel à IPersistStream ::Load.

Syntaxe

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
);

Paramètres

[in] lpstream

Pointeur vers le flux qui contient les données de l’image.

[in] lSize

Nombre d’octets à lire à partir du flux, ou zéro si l’ensemble du flux doit être lu.

[in] fRunmode

L’inverse de la valeur initiale de la propriété KeepOriginalFormat . Si la valeur est TRUE, KeepOriginalFormat a la valeur FALSE et vice versa.

[in] riid

Référence à l’identificateur de l’interface décrivant le type de pointeur d’interface à retourner dans ppvObj.

[in] xSizeDesired

Largeur souhaitée de l’icône ou du curseur. Les valeurs valides sont 16, 32 et 48. Passez LP_DEFAULT aux deux paramètres de taille pour utiliser la taille par défaut du système.

[in] ySizeDesired

Hauteur souhaitée de l’icône ou du curseur. Les valeurs valides sont 16, 32 et 48. Passez LP_DEFAULT aux deux paramètres de taille pour utiliser la taille par défaut du système.

[in] dwFlags

Profondeur de couleur souhaitée pour l’icône ou le curseur. Les valeurs sont LP_MONOCHROME (monochrome), LP_VGACOLOR (16 couleurs), LP_COLOR (256 couleurs) ou LP_DEFAULT (sélectionne la meilleure profondeur pour l’affichage actuel).

[out] lplpvObj

Adresse de la variable pointeur qui reçoit le pointeur d’interface demandé dans riid. Une fois le retour réussi, *ppvObj contient le pointeur d’interface demandé sur le stockage de l’objet identifié par le moniker. Si *ppvObj n’a pas la valeur NULL, cette fonction appelle IUnknown ::AddRef sur l’interface ; il incombe à l’appelant d’appeler IUnknown ::Release. Si une erreur se produit, *ppvObj a la valeur NULL.

Valeur retournée

Cette fonction retourne S_OK en cas de réussite. Les autres valeurs possibles sont les suivantes.

Remarques

Le flux doit être au format BMP (bitmap), WMF (métafichier) ou ICO (icône). Un objet image créé à l’aide d’OleLoadPictureEx a toujours la propriété de ses ressources internes (fOwn==TRUE est implicite).

En plus d’autoriser la spécification de la taille de l’icône ou du curseur, OleLoadPictureEx prend en charge le chargement de curseurs de couleur.

Configuration requise

Voir aussi

OleCreatePictureIndirect

PICTDESC