CDialogBar::Create

Artikel
06/10/2015

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