Kelas CDialogBar

Menyediakan fungsionalitas kotak dialog tanpa mode Windows di bilah kontrol.

Sintaks

class CDialogBar : public CControlBar

Anggota

Konstruktor Publik

Metode Publik

Keterangan

Bilah dialog menyerupan kotak dialog di mana kotak dialog berisi kontrol Windows standar yang dapat ditautkan pengguna. Kesamaan lainnya adalah Anda membuat templat dialog untuk mewakili bilah dialog.

Membuat dan menggunakan bilah dialog mirip dengan membuat dan menggunakan CFormView objek. Pertama, gunakan editor dialog untuk menentukan templat dialog dengan gaya WS_CHILD dan tanpa gaya lain. Templat tidak boleh memiliki gaya WS_VISIBLE. Dalam kode aplikasi Anda, panggil konstruktor untuk membuat CDialogBar objek, lalu panggil Create untuk membuat jendela bilah dialog dan melampirkannya ke CDialogBar objek.

Untuk informasi selengkapnya tentang CDialogBar, lihat artikel Bilah Dialog dan Catatan Teknis 31, Bilah Kontrol.

Hierarki Warisan

CObject

CCmdTarget

CWnd

CControlBar

CDialogBar

Persyaratan

Header: afxext.h

CDialogBar::CDialogBar

Membuat CDialogBar objek.

CDialogBar();

CDialogBar::Create

Memuat templat sumber daya kotak dialog yang ditentukan oleh lpszTemplateName atau nIDTemplate, membuat jendela bilah dialog, mengatur gayanya, dan mengaitkannya dengan CDialogBar objek.

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

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

Parameter

pParentWnd
Penunjuk ke objek induk CWnd .

lpszTemplateName
Penunjuk ke nama CDialogBar templat sumber daya kotak dialog objek.

nStyle
Gaya bilah alat. Gaya toolbar tambahan yang didukung adalah:

• CBRS_TOP Bilah kontrol berada di atas jendela bingkai.

• CBRS_BOTTOM Bilah kontrol berada di bagian bawah jendela bingkai.

• CBRS_NOALIGN Bilah kontrol tidak diposisikan ulang ketika induk diubah ukurannya.

• CBRS_TOOLTIPS Control bar menampilkan tips alat.

• CBRS_SIZE_DYNAMIC Bilah kontrol bersifat dinamis.

• CBRS_SIZE_FIXED Bilah kontrol diperbaiki.

• bilah Kontrol CBRS_FLOATING mengambang.

• CBRS_FLYBY Bilah status menampilkan informasi tentang tombol .

• CBRS_HIDE_INPLACE Bilah kontrol tidak ditampilkan kepada pengguna.

Nid
ID kontrol bilah dialog.

nIDTemplate
ID CDialogBar sumber daya templat kotak dialog objek.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Jika Anda menentukan gaya perataan CBRS_TOP atau CBRS_BOTTOM, lebar bilah dialog adalah dari jendela bingkai dan tingginya adalah sumber daya yang ditentukan oleh nIDTemplate. Jika Anda menentukan gaya perataan CBRS_LEFT atau CBRS_RIGHT, tinggi bilah dialog adalah dari jendela bingkai dan lebarnya adalah sumber daya yang ditentukan oleh nIDTemplate.

Contoh

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

Lihat juga

Sampel MFC CTRLBARS
Kelas CControlBar
Bagan Hierarki
Kelas CFormView
Kelas CControlBar