La classe CDialogEx

  • Article

La classe CDialogEx spécifie la couleur d'arrière-plan et l'image d'arrière-plan d'une boîte de dialogue.

Syntaxe

class CDialogEx : public CDialog

Membres

Constructeurs publics

Nom Description
CDialogEx::CDialogEx Construit un objet CDialogEx.
CDialogEx::~CDialogEx Destructeur.

Méthodes publiques

Nom Description
CDialogEx::SetBackgroundColor Définit la couleur d'arrière-plan de la boîte de dialogue.
CDialogEx::SetBackgroundImage Définit l'image d'arrière-plan de la boîte de dialogue.

Notes

Pour utiliser la classe CDialogEx, dérivez votre classe de boîte de dialogue de la classe CDialogEx plutôt que de la classe CDialog.

Les images de boîte de dialogue sont stockées dans un fichier de ressources. Le framework supprime automatiquement toute image qui est chargée à partir du fichier de ressources. Pour supprimer par programmation l’image d’arrière-plan actuelle, appelez la CDialogEx::SetBackgroundImage méthode ou implémentez un gestionnaire d’événements OnDestroy . Lorsque vous appelez la CDialogEx::SetBackgroundImage méthode, transmettez un HBITMAP paramètre en tant que handle d’image. L'objet CDialogEx prend possession de l'image et la supprime si l'indicateur m_bAutoDestroyBmp a pour valeur TRUE.

Un CDialogEx objet peut être un parent d’un CMFCPopupMenu objet Class . L’objet Class appelle la CDialogEx::SetActiveMenu méthode lorsque l’objet Class s’ouvreCMFCPopupMenu. CMFCPopupMenu Par la suite, l’objet CDialogEx gère n’importe quel événement de menu jusqu’à ce que l’objet CMFCPopupMenu Class soit fermé.

Hiérarchie d'héritage

CObject

CCmdTarget

CWnd

CDialog

CDialogEx

Spécifications

En-tête : afxdialogex.h

CDialogEx::CDialogEx

Construit un objet CDialogEx.

CDialogEx(
    UINT nIDTemplate,
    CWnd* pParent=NULL);

CDialogEx(
    LPCTSTR lpszTemplateName,
    CWnd* pParentWnd=NULL);

Paramètres

nIDTemplate
[in] ID de ressource d’un modèle de boîte de dialogue.

lpszTemplateName
[in] Nom de ressource d’un modèle de boîte de dialogue.

pParent
[in] Pointeur vers la fenêtre parente. La valeur par défaut est NULL.

pParentWnd
[in] Pointeur vers la fenêtre parente. La valeur par défaut est NULL.

Valeur de retour

Notes

CDialogEx::SetBackgroundColor

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

void SetBackgroundColor(
    COLORREF color,
    BOOL bRepaint=TRUE);

Paramètres

color
[in] Valeur de couleur RVB.

bRepaint
[in] TRUE pour mettre à jour immédiatement l’écran ; sinon, FALSE. La valeur par défaut est TRUE.

Notes

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

hBitmap
[in] Handle de l’image d’arrière-plan.

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

location
[in] Une des CDialogEx::BackgroundLocation valeurs qui spécifient l’emplacement de l’image. Les valeurs valides incluent BACKGR_TILE, , BACKGR_TOPLEFTBACKGR_TOPRIGHT, BACKGR_BOTTOMLEFTet BACKGR_BOTTOMRIGHT. La valeur par défaut est BACKGR_TILE.

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

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

Valeur de retour

Dans la deuxième syntaxe de surcharge de méthode, TRUE si la méthode réussit ; sinon, FALSE.

Notes

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

Voir aussi

Graphique hiérarchique
Classes
CMFCPopupMenu Classe
CContextMenuManager Classe