Fonction SetBitmapDimensionEx (wingdi.h)

  • Article

La fonction SetBitmapDimensionEx affecte des dimensions préférées à une bitmap. Ces dimensions peuvent être utilisées par les applications ; toutefois, ils ne sont pas utilisés par le système.

Syntaxe

BOOL SetBitmapDimensionEx(
  [in]  HBITMAP hbm,
  [in]  int     w,
  [in]  int     h,
  [out] LPSIZE  lpsz
);

Paramètres

[in] hbm

Handle de la bitmap. La bitmap ne peut pas être une bitmap de section DIB.

[in] w

Largeur, en unités de 0,1 millimètre, de la bitmap.

[in] h

Hauteur, en unités de 0,1 millimètre, de la bitmap.

[out] lpsz

Pointeur vers une structure SIZE pour recevoir les dimensions précédentes de la bitmap. Ce pointeur peut avoir la valeur NULL.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro.

Remarques

Une application peut récupérer les dimensions attribuées à une bitmap avec la fonction SetBitmapDimensionEx en appelant la fonction GetBitmapDimensionEx .

La bitmap identifiée par hBitmap ne peut pas être une section DIB, qui est une bitmap créée par la fonction CreateDIBSection . Si la bitmap est une section DIB, la fonction SetBitmapDimensionEx échoue.

Configuration requise

   
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 wingdi.h (inclure Windows.h)
Bibliothèque Gdi32.lib
DLL Gdi32.dll

Voir aussi

Fonctions bitmap

Vue d’ensemble des bitmaps

CreateDIBSection

GetBitmapDimensionEx

SIZE