CDialogBar::Create

Articolo
03/05/2013

Carica il modello di risorse della finestra di dialogo specificato da lpszTemplateName o da nIDTemplate, crea la finestra della barra della finestra di dialogo, impostare lo stile e lo associa all'oggetto CDialogBar.

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

Parametri

pParentWnd
Un puntatore all'oggetto padre CWnd.
lpszTemplateName
Un puntatore al nome del modello di risorse della finestra di dialogo dell'oggetto CDialogBar.
nStyle
Lo stile della barra degli strumenti.Gli stili aggiuntivi della barra degli strumenti di supporto sono:
- La barra di controlloCBRS_TOP si trova in cima alla finestra cornice.
- La barra di controlloCBRS_BOTTOM è giù della finestra cornice.
- La barra di controlloCBRS_NOALIGN non viene riposizionato quando il padre viene ridimensionato.
- La barra di controlloCBRS_TOOLTIPS visualizzare le descrizioni comandi.
- La barra di controlloCBRS_SIZE_DYNAMIC è dinamica.
- La barra di controlloCBRS_SIZE_FIXED è fissa.
- La barra di controlloCBRS_FLOATING è mobile.
- La barra di stato diCBRS_FLYBY visualizzare le informazioni sul pulsante.
- La barra di controlloCBRS_HIDE_INPLACE non viene visualizzato all'utente.
nID
ID del controllo della barra della finestra di dialogo.
nIDTemplate
ID di risorsa modello di finestra di dialogo dell'oggetto CDialogBar.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Note

Se si specifica lo stile di allineamento CBRS_BOTTOM o CBRS_TOP, la larghezza della barra della finestra di dialogo è quella della finestra cornice e la l'altezza sia quella della risorsa specificata da nIDTemplate.Se si specifica lo stile di allineamento CBRS_RIGHT o CBRS_LEFT, l'altezza della barra della finestra di dialogo è quella della finestra cornice e la larghezza è quella della risorsa specificata da nIDTemplate.

Esempio

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