CDialogEx 클래스

CDialogEx 클래스는 대화 상자의 배경 색과 배경 이미지를 지정합니다.

구문

class CDialogEx : public CDialog

멤버

공용 생성자

속성	설명
CDialogEx::CDialogEx	CDialogEx 개체를 생성합니다.
CDialogEx::~CDialogEx	소멸자

공용 메서드

이름	설명
CDialogEx::SetBackgroundColor	대화 상자의 배경 색을 설정합니다.
CDialogEx::SetBackgroundImage	대화 상자의 배경 이미지를 설정합니다.

설명

CDialogEx 클래스를 사용하려면 CDialogEx 클래스 대신 CDialog 클래스에서 대화 상자 클래스를 파생합니다.

대화 상자 이미지는 리소스 파일에 저장됩니다. 프레임워크는 리소스 파일에서 로드되는 모든 이미지를 자동으로 삭제합니다. 현재 배경 이미지를 프로그래밍 방식으로 삭제하려면 메서드를 CDialogEx::SetBackgroundImage 호출하거나 이벤트 처리기를 구현 OnDestroy 합니다. 메서드를 호출할 CDialogEx::SetBackgroundImage 때 이미지 핸들로 매개 변수를 전달 HBITMAP 합니다. CDialogEx 개체가 이미지의 소유권을 갖게 되며 m_bAutoDestroyBmp 플래그가 TRUE이면 삭제합니다.

개체는 CDialogEx Class 개체의 부모일 CMFCPopupMenu 수 있습니다. Class 개체가 CDialogEx::SetActiveMenuCMFCPopupMenu열리면 Class 개체가 메서드를 CMFCPopupMenu 호출합니다. 그 후 개체는 CDialogEx Class 개체가 닫혀야 CMFCPopupMenu 메뉴 이벤트를 처리합니다.

상속 계층 구조

CObject

CCmdTarget

CWnd

CDialog

CDialogEx

요구 사항

헤더afxdialogex.h:

CDialogEx::CDialogEx

CDialogEx 개체를 생성합니다.

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

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

매개 변수

nIDTemplate
[in] 대화 상자 템플릿의 리소스 ID입니다.

lpszTemplateName
[in] 대화 상자 템플릿의 리소스 이름입니다.

pParent
[in] 부모 창에 대한 포인터입니다. 기본값은 NULL입니다.

pParentWnd
[in] 부모 창에 대한 포인터입니다. 기본값은 NULL입니다.

Return Value

설명

CDialogEx::SetBackgroundColor

대화 상자의 배경 색을 설정합니다.

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

매개 변수

color
[in] RGB 색 값입니다.

bRepaint
[in] TRUE 화면을 즉시 업데이트하려면 다음을 실행합니다. 그렇지 않으면 . FALSE 기본값은 TRUE입니다.

설명

CDialogEx::SetBackgroundImage

대화 상자의 배경 이미지를 설정합니다.

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

매개 변수

hBitmap
[in] 배경 이미지에 대한 핸들입니다.

uiBmpResId
[in] 배경 이미지의 리소스 ID입니다.

location
[in] 이미지의 CDialogEx::BackgroundLocation 위치를 지정하는 값 중 하나입니다. 유효한 값에는 BACKGR_TILE, BACKGR_TOPLEFT, BACKGR_TOPRIGHTBACKGR_BOTTOMLEFT및 BACKGR_BOTTOMRIGHT. 기본값은 BACKGR_TILE입니다.

bAutoDestroy
[in] TRUE 배경 이미지를 자동으로 삭제하려면 입니다. 그렇지 않으면 . FALSE

bRepaint
[in] TRUE 대화 상자를 즉시 다시 그리려면 그렇지 않으면 . FALSE

Return Value

두 번째 메서드 오버로드 구문 TRUE 에서 메서드가 성공하면 이고, FALSE그렇지 않으면 .

설명

지정한 이미지는 대화 상자 클라이언트 영역에 맞게 확장되지 않습니다.

참고 항목

계층 구조 차트
클래스
CMFCPopupMenu 클래스
CContextMenuManager 클래스