Partager via


CDialogEx::SetBackgroundImage

Définit l'image d'arrière-plan de la boîte de dialogue.

void SetBackgroundImage(
   HBITMAP hBitmap,
   BackgroundLocation location=BACKGR_TILE,
   BOOL bAutoDestroy=TRUE,
   BOOL bRepaint=TRUE 
);
BOOL SetBackgroundImage(
   UINT uiBmpResId,
   BackgroundLocation location=BACKGR_TILE,
   BOOL bRepaint=TRUE 
);

Paramètres

  • [in] hBitmap
    Un handle vers l'image d'arrière-plan.

  • [in] uiBmpResId
    L'ID de ressource de l'image d'arrière-plan.

  • [in] location
    L'une des valeurs d' CDialogEx::BackgroundLocation qui spécifient l'emplacement de l'image.Les valeurs valides incluent BACKGR_TILE, BACKGR_TOPLEFT, BACKGR_TOPRIGHT, BACKGR_BOTTOMLEFT, et BACKGR_BOTTOMRIGHT.La valeur par défaut est BACKGR_TILE.

  • [in] bAutoDestroy
    TRUE pour détruire automatiquement l'image d'arrière-plan ; sinon, FALSE.

  • [in] bRepaint
    TRUE pour redessiner immédiatement la boîte de dialogue ; sinon, FALSE.

Valeur de retour

Dans la deuxième méthode surchargez la syntaxe, TRUE si la méthode est réussie ; sinon, FALSE.

Notes

L'image que vous spécifiez n'est pas étirée pour s'ajuster à la zone cliente de la boîte de dialogue.

Configuration requise

en-tête : afxdialogex.h

Voir aussi

Référence

Classe de CDialogEx

Graphique de la hiérarchie