CDialogBar osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

A vezérlősávon található Windows mód nélküli párbeszédpanel funkcióit biztosítja.

Szemantika

class CDialogBar : public CControlBar

Members

Nyilvános konstruktorok

Név	Description
CDialogBar::CDialogBar	Objektumot CDialogBar hoz létre.

Nyilvános metódusok

Név	Description
CDialogBar::Létrehozás	Létrehoz egy Windows-párbeszédpanelt, és csatolja az CDialogBar objektumhoz.

Megjegyzések

A párbeszédpanelek olyan párbeszédpanelre hasonlítanak, amelyben a felhasználó által tabulátorként használható szabványos Windows-vezérlőket tartalmaz. Egy másik hasonlóság az, hogy létrehoz egy párbeszédpanelsablont a párbeszédpanel sávjának megjelenítéséhez.

A párbeszédpanelek létrehozása és használata hasonló az objektumok létrehozásához és használatához CFormView . Először a párbeszédpanel-szerkesztővel definiáljon egy olyan párbeszédpanelsablont, amely WS_CHILD stílussal rendelkezik, és nincs más stílusa. A sablon nem rendelkezik a stílus WS_VISIBLE. Az alkalmazáskódban hívja meg a konstruktort az CDialogBar objektum létrehozásához, majd hívja meg Create a párbeszédpanel ablakának létrehozásához és az CDialogBar objektumhoz való csatolásához.

További információ: CDialogBarPárbeszédpanelsávok és Műszaki megjegyzés 31, Vezérlősávok.

Megjegyzés:

Az aktuális kiadásban egy CDialogBar objektum nem üzemeltethet Windows Forms-vezérlőket. A Visual Studio Windows Forms-vezérlőiről további információt a Windows űrlap felhasználói vezérlőjének használata az MFC-ben című témakörben talál.

Öröklési hierarchia

CObject

CCmdTarget

CWnd

CControlBar

CDialogBar

Requirements

Fejléc: afxext.h

CDialogBar::CDialogBar

Objektumot CDialogBar hoz létre.

CDialogBar();

CDialogBar::Létrehozás

Betölti a párbeszédpanel által megadott lpszTemplateName erőforrássablont, vagy nIDTemplatelétrehozza a párbeszédpanel ablakát, beállítja annak stílusát, és társítja azt az CDialogBar objektummal.

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

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

Paraméterek

pParentWnd
Mutató a szülőobjektumra CWnd .

lpszTemplateName
Az objektum párbeszédpanel-erőforrássablonjának CDialogBar nevére mutató mutató.

nStyle
Az eszköztár stílusa. További támogatott eszköztárstílusok:

• CBRS_TOP vezérlősáv a keretablak tetején található.

• CBRS_BOTTOM vezérlősáv a keretablak alján található.

• CBRS_NOALIGN vezérlősáv nem lesz áthelyezve a szülő átméretezésekor.

• CBRS_TOOLTIPS Vezérlősáv eszköztippeket jelenít meg.

• CBRS_SIZE_DYNAMIC vezérlősáv dinamikus.

• CBRS_SIZE_FIXED vezérlősáv ki van javítva.

• CBRS_FLOATING vezérlősáv lebegő.

• CBRS_FLYBY Állapotsor megjeleníti a gomb adatait.

• CBRS_HIDE_INPLACE vezérlősáv nem jelenik meg a felhasználó számára.

Nid
A párbeszédpanel vezérlőazonosítója.

nIDTemplate
Az objektum párbeszédpanelsablonjának erőforrás-azonosítója CDialogBar .

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Ha megadja a CBRS_TOP vagy CBRS_BOTTOM igazítási stílust, a párbeszédpanel sávjának szélessége a keretablaké, magassága pedig az nIDTemplate által megadott erőforrásé. Ha megadja a CBRS_LEFT vagy CBRS_RIGHT igazítási stílust, a párbeszédpanel sávjának magassága a keretablaké, szélessége pedig az nIDTemplate által megadott erőforrásé.

Example

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

Lásd még

MFC-minta CTRLBARS
CControlBar osztály
Hierarchiadiagram
CFormView osztály
CControlBar osztály