Partager via

Méthode IPicture::get_hPal (ocidl.h)

  • Article

Récupère une copie de la palette actuellement utilisée par l’objet image.

Syntaxe

HRESULT get_hPal(
  [out] OLE_HANDLE *phPal
);

Paramètres

[out] phPal

Pointeur vers une variable qui reçoit le handle de palette. La variable est définie sur NULL en cas d’échec.

Valeur retournée

Cette méthode prend en charge les valeurs de retour standard E_FAIL et E_OUTOFMEMORY, ainsi que les valeurs suivantes.

Code de retour Description
S_OK
 La hauteur a été retournée avec succès.
S_FALSE
 Cette image n’a pas de palette. La variable vers laquelle phpal pointe a la valeur NULL.
E_POINTER
 La valeur de phPal n’est pas valide. Par exemple, il peut s’agir de NULL.

Notes

Remarques aux appelants

Si l’objet image possède la propriété de l’image, il possède également la propriété de la palette et la détruit lorsque l’objet est lui-même détruit. Sinon, l’appelant est propriétaire de la palette. Le paramètre fOwn sur OleCreatePictureIndirect détermine la propriété. OleLoadPicture définit fOwn sur TRUE pour indiquer que l’objet image est propriétaire de la palette.

Spécifications

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête ocidl.h

Voir aussi

IPicture