다음을 통해 공유

CDialogBar 클래스

  • 아티클

컨트롤 막대에 Windows 모덜리스 대화 상자의 기능을 제공합니다.

구문

class CDialogBar : public CControlBar

멤버

공용 생성자

속성 설명
CDialogBar::CDialogBar CDialogBar 개체를 생성합니다.

공용 메서드

이름 설명
CDialogBar::Create Windows 대화 상자를 만들어 개체에 CDialogBar 연결합니다.

설명

대화 상자 표시줄은 사용자가 탭할 수 있는 표준 Windows 컨트롤이 포함되어 있는 대화 상자와 비슷합니다. 또 다른 유사성은 대화 상자 표시줄을 나타내는 대화 상자 템플릿을 만드는 것입니다.

대화 상자 모음을 만들고 사용하는 것은 개체를 만들고 사용하는 CFormView 것과 비슷합니다. 먼저 대화 상자 편집기를 사용하여 스타일 WS_CHILD 다른 스타일이 없는 대화 상자 템플릿을 정의합니다. 템플릿에 스타일 WS_VISIBLE 없어야 합니다. 애플리케이션 코드에서 생성자를 호출하여 개체를 CDialogBar 생성한 다음 Create 대화 상자 표시줄 창을 만들어 개체에 CDialogBar 연결합니다.

자세한 CDialogBar내용은 대화 상자 모음 및 Technical Note 31, 컨트롤 바 문서를 참조하세요.

참고 항목

현재 릴리스에서는 개체가 CDialogBar Windows Forms 컨트롤을 호스트할 수 없습니다. Visual C++의 Windows Forms 컨트롤에 대한 자세한 내용은 MFC에서 Windows Form 사용자 컨트롤 사용을 참조하세요.

상속 계층 구조

CObject

CCmdTarget

CWnd

CControlBar

CDialogBar

요구 사항

헤더: afxext.h

CDialogBar::CDialogBar

CDialogBar 개체를 생성합니다.

CDialogBar();

CDialogBar::Create

지정 lpszTemplateName 한 대화 상자 리소스 템플릿을 로드하거나 nIDTemplate, 대화 상자 창을 만들고, 스타일을 설정하고, 개체와 CDialogBar 연결합니다.

virtual BOOL Create(
    CWnd* pParentWnd,
    LPCTSTR lpszTemplateName,
    UINT nStyle,
    UINT nID);

virtual BOOL Create(
    CWnd* pParentWnd,
    UINT nIDTemplate,
    UINT nStyle,
    UINT nID);

매개 변수

pParentWnd
부모 CWnd 개체에 대한 포인터입니다.

lpszTemplateName
개체의 대화 상자 리소스 템플릿 이름에 CDialogBar 대한 포인터입니다.

nStyle
도구 모음 스타일입니다. 지원되는 추가 도구 모음 스타일은 다음과 같습니다.

  • CBRS_TOP 컨트롤 막대는 프레임 창의 맨 위에 있습니다.

  • CBRS_BOTTOM 컨트롤 막대는 프레임 창의 맨 아래에 있습니다.

  • CBRS_NOALIGN 컨트롤 표시줄은 부모 크기가 조정될 때 위치가 조정되지 않습니다.

  • CBRS_TOOLTIPS 컨트롤 막대에 도구 팁이 표시됩니다.

  • CBRS_SIZE_DYNAMIC 컨트롤 막대가 동적입니다.

  • CBRS_SIZE_FIXED 컨트롤 표시줄이 고정되어 있습니다.

  • CBRS_FLOATING 컨트롤 표시줄이 부동입니다.

  • CBRS_FLYBY 상태 표시줄에는 단추에 대한 정보가 표시됩니다.

  • CBRS_HIDE_INPLACE 컨트롤 표시줄이 사용자에게 표시되지 않습니다.

nID
대화 상자 모음의 컨트롤 ID입니다.

nIDTemplate
개체 대화 CDialogBar 상자 템플릿의 리소스 ID입니다.

Return Value

성공하면 0이 아니고, 그렇지 않으면 0입니다.

설명

CBRS_TOP 또는 CBRS_BOTTOM 맞춤 스타일을 지정하는 경우 대화 상자 표시줄의 너비는 프레임 창의 너비이고 높이가 nIDTemplate에 지정된 리소스의 너비입니다. CBRS_LEFT 또는 CBRS_RIGHT 맞춤 스타일을 지정하는 경우 대화 상자 표시줄의 높이는 프레임 창의 높이이고 너비는 nIDTemplate에서 지정한 리소스의 높이입니다.

예시

int CMainFrame::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
   if (CMDIFrameWnd::OnCreate(lpCreateStruct) == -1)
      return -1;

   EnableDocking(CBRS_ALIGN_ANY);

   // m_wndDlgBar is a CDialogBar member of CMainFrame
   // IDD_DIALOGBAR - Resource ID of the dialog
   // template. This dialog template should be created
   // with  the  style  WS_CHILD and no other style.
   // The template must not have the style WS_VISIBLE.
   if (!m_wndDlgBar.Create(this, IDD_DIALOGBAR,
                           CBRS_LEFT | CBRS_TOOLTIPS | CBRS_FLYBY, IDD_DIALOGBAR))
   {
      TRACE0("Failed to create DlgBar\n");
      return -1; // Fail to create.
   }

   return 0;
}

참고 항목

MFC 샘플 CTRLBAR
CControlBar Class
계층 구조 차트
CFormView 클래스
CControlBar Class