Sdílet prostřednictvím

CDialogBar – třída

  • Článek

Poskytuje funkce dialogového okna bez režimu Windows v ovládacím panelu.

Syntaxe

class CDialogBar : public CControlBar

Členové

Veřejné konstruktory

Název Popis
CDialogBar::CDialogBar CDialogBar Vytvoří objekt.

Veřejné metody

Název Popis
CDialogBar::Create Vytvoří panel dialogových oken a připojí ho k objektu CDialogBar .

Poznámky

Dialogový panel se podobá dialogovému oknu, ve které obsahuje standardní ovládací prvky Systému Windows, mezi kterými může uživatel tabulátorovat. Další podobnost spočívá v tom, že vytvoříte šablonu dialogového okna, která bude reprezentovat panel dialogového okna.

Vytvoření a použití dialogového panelu je podobné vytvoření a použití objektu CFormView . Nejprve pomocí editoru dialogů definujte šablonu dialogového okna se stylem WS_CHILD a žádným jiným stylem. Šablona nesmí mít styl WS_VISIBLE. V kódu aplikace zavolejte konstruktor, který objekt sestaví CDialogBar , a pak zavolá Create okno dialogového okna a připojí ho k objektu CDialogBar .

Další informace najdete CDialogBarv článku Dialogové pruhy a Technická poznámka 31, Ovládací panely.

Poznámka:

V aktuální verzi CDialogBar nemůže objekt hostovat model Windows Forms ovládací prvky. Další informace o ovládacích prvcích model Windows Forms v jazyce Visual C++ naleznete v tématu Použití uživatelského ovládacího prvku Windows Form v prostředí MFC.

Hierarchie dědičnosti

Objekt CObject

CCmdTarget

CWnd

CControlBar

CDialogBar

Požadavky

Hlavička: afxext.h

CDialogBar::CDialogBar

CDialogBar Vytvoří objekt.

CDialogBar();

CDialogBar::Create

Načte šablonu prostředku dialogového okna určenou objektem lpszTemplateName nebo nIDTemplate, vytvoří dialogové okno, nastaví jeho styl a přidruží ho k objektu CDialogBar .

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

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

Parametry

pParentWnd
Ukazatel na nadřazený CWnd objekt.

lpszTemplateName
Ukazatel na název šablony prostředku dialogového CDialogBar okna objektu.

nStyle
Styl panelu nástrojů. Podporují se další styly panelů nástrojů:

  • CBRS_TOP Ovládací panel je v horní části okna rámečku.

  • CBRS_BOTTOM Ovládací panel je v dolní části okna rámečku.

  • CBRS_NOALIGN Ovládací panel se při změně velikosti nadřazeného objektu nepřeloží.

  • CBRS_TOOLTIPS Ovládací panel zobrazuje popisy nástrojů.

  • CBRS_SIZE_DYNAMIC Ovládací panel je dynamický.

  • CBRS_SIZE_FIXED Ovládací panel je pevný.

  • CBRS_FLOATING Ovládací panel je plovoucí.

  • CBRS_FLYBY Stavový řádek zobrazuje informace o tlačítku.

  • CBRS_HIDE_INPLACE Ovládací panel se uživateli nezobrazí.

Nid
ID ovládacího prvku na panelu dialogového okna.

nIDTemplate
ID prostředku šablony dialogového okna objektu CDialogBar .

Návratová hodnota

Nenulové, pokud je úspěšné; jinak 0.

Poznámky

Pokud zadáte styl zarovnání CBRS_TOP nebo CBRS_BOTTOM, šířka panelu dialogového okna je šířka okna rámečku a jeho výška je hodnota prostředku určeného hodnotou nIDTemplate. Pokud zadáte styl zarovnání CBRS_LEFT nebo CBRS_RIGHT, výška panelu dialogového okna je výška okna rámečku a jeho šířka je hodnota prostředku určeného nástrojem nIDTemplate.

Příklad

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

Viz také

MFC – ukázkové CTRLBARS
CControlBar – třída
Graf hierarchie
CFormView – třída
CControlBar – třída