CDialogBar::Create

Artikel
02/26/2013

Lädt die Dialogfeldressourcenvorlage, die von lpszTemplateName oder nIDTemplate angegeben wird, stellt das Dialogleistenfenster erstellt, legt das Format fest und ordnet ihn mit dem CDialogBar-Objekt zu.

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 Objekt CWnd.
lpszTemplateName
Ein Zeiger auf den Namen der CDialogBar Dialogfeld-Ressourcenvorlage des Objekts.
nStyle
Das Symbolleistenformat.Die zusätzlichen unterstützten Symbolleistenformate sind:
- CBRS_TOP Steuerleiste wird am oberen Rand des Rahmenfensters.
- CBRS_BOTTOM Steuerleiste ist unten vom Rahmenfenster.
- CBRS_NOALIGN Steuerleiste wird nicht neu angeordnet, wenn das übergeordnete Element angepasst wird.
- CBRS_TOOLTIPS Steuerleiste wird QuickInfo an.
- CBRS_SIZE_DYNAMIC Steuerleiste ist dynamisch.
- CBRS_SIZE_FIXED Steuerleiste behoben ist.
- CBRS_FLOATING Steuerleiste unverankert ist.
- CBRS_FLYBY Statusleiste zeigt Informationen über die Schaltfläche an.
- CBRS_HIDE_INPLACE Steuerleiste wird dem Benutzer nicht angezeigt.
nID
Die Steuerelement-ID der Dialogleiste.
nIDTemplate
Das Ressourcen-ID der Dialogfeldvorlage CDialogBar des Objekts.

Rückgabewert

Ungleich 0 (null), wenn erfolgreich; 0 andernfalls.

Hinweise

Wenn Sie das CBRS_TOP oder CBRS_BOTTOM Ausrichtungsformat angeben, ist die Breite der Dialogleiste die des Rahmenfensters und seine Höhe ist die der Ressource, die von nIDTemplate angegeben wird.Wenn Sie das CBRS_LEFT oder CBRS_RIGHT Ausrichtungsformat angeben, ist die Höhe der Dialogleiste die des Rahmenfensters und seine Breite ist die der Ressource, die von 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;
}