Freigeben über

CDialogBar-Klasse

  • Artikel

Stellt die Funktionalität eines nicht modalen Windows-Dialogfelds in einer Steuerleiste bereit.

Syntax

class CDialogBar : public CControlBar

Member

Öffentliche Konstruktoren

Name Beschreibung
CDialogBar::CDialogBar Erstellt ein CDialogBar-Objekt.

Öffentliche Methoden

Name Beschreibung
CDialogBar::Create Erstellt eine Windows-Dialogfeldleiste und fügt sie an das CDialogBar Objekt an.

Hinweise

Eine Dialogfeldleiste ähnelt einem Dialogfeld, in dem es Standardmäßige Windows-Steuerelemente enthält, zwischen denen der Benutzer wechseln kann. Eine weitere Ähnlichkeit besteht darin, dass Sie eine Dialogfeldvorlage zum Darstellen der Dialogfeldleiste erstellen.

Das Erstellen und Verwenden einer Dialogfeldleiste ähnelt dem Erstellen und Verwenden eines CFormView Objekts. Verwenden Sie zunächst den Dialogfeld-Editor , um eine Dialogfeldvorlage mit der Formatvorlage WS_CHILD und keine andere Formatvorlage zu definieren. Die Vorlage darf nicht über die Formatvorlage WS_VISIBLE verfügen. Rufen Sie im Anwendungscode den Konstruktor auf, um das CDialogBar Objekt zu erstellen, und rufen Sie Create dann auf, um das Dialogfeldfenster zu erstellen und es an das CDialogBar Objekt anzufügen.

Weitere Informationen finden Sie im Artikel Dialog bars and Technical Note 31, Control Bars.For more information on CDialogBar, see the article Dialog Bars and Technical Note 31, Control Bars.

Hinweis

In der aktuellen Version kann ein CDialogBar Objekt keine Windows Forms-Steuerelemente hosten. Weitere Informationen zu Windows Forms-Steuerelementen in Visual C++ finden Sie unter Verwenden eines Windows Form-Benutzersteuerelements in MFC.

Vererbungshierarchie

CObject

CCmdTarget

CWnd

CControlBar

CDialogBar

Anforderungen

Header: afxext.h

CDialogBar::CDialogBar

Erstellt ein CDialogBar-Objekt.

CDialogBar();

CDialogBar::Create

Lädt die durch lpszTemplateName das Dialogfeld angegebene Ressourcenvorlage oder nIDTemplateerstellt das Dialogfeldfenster, legt dessen Format fest und ordnet sie dem Objekt zu CDialogBar .

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

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

Parameter

pParentWnd
Ein Zeiger auf das übergeordnete CWnd Objekt.

lpszTemplateName
Ein Zeiger auf den Namen der Dialogfeld-Ressourcenvorlage des CDialogBar Objekts.

nStyle
Die Symbolleistenformatvorlage. Es werden weitere unterstützte Symbolleistenformatvorlagen unterstützt:

  • CBRS_TOP Steuerelementleiste befindet sich oben im Rahmenfenster.

  • CBRS_BOTTOM Steuerelementleiste befindet sich am unteren Rand des Rahmenfensters.

  • CBRS_NOALIGN Steuerelementleiste wird nicht neu positioniert, wenn die Größe des übergeordneten Elements geändert wird.

  • CBRS_TOOLTIPS Steuerelementleiste zeigt QuickInfos an.

  • CBRS_SIZE_DYNAMIC Steuerleiste ist dynamisch.

  • CBRS_SIZE_FIXED Steuerelementleiste ist fest.

  • CBRS_FLOATING Steuerleiste unverankert ist.

  • CBRS_FLYBY Statusleiste zeigt Informationen zur Schaltfläche an.

  • CBRS_HIDE_INPLACE Steuerelementleiste wird dem Benutzer nicht angezeigt.

Nid
Die Steuerelement-ID der Dialogfeldleiste.

nIDTemplate
Die Ressourcen-ID der Dialogfeldvorlage des CDialogBar Objekts.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

Hinweise

Wenn Sie die CBRS_TOP- oder CBRS_BOTTOM Ausrichtungsart angeben, ist die Breite des Rahmenfensters der Dialogleiste und die Höhe der durch nIDTemplate angegebenen Ressource. Wenn Sie die CBRS_LEFT- oder CBRS_RIGHT Ausrichtungsart angeben, entspricht die Höhe der Dialogfeldleiste dem Rahmenfenster und deren Breite der ressource, die durch nIDTemplate angegeben wird.

Beispiel

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

Siehe auch

MFC-Beispiel STRGBARS
CControlBar Class
Hierarchiediagramm
CFormView-Klasse
CControlBar Class