Partager via


CDialogBar::Create

Charge le modèle de ressource de boîte de dialogue spécifié par lpszTemplateName ou nIDTemplate, crée la fenêtre de la barre de boîte de dialogue, définit son style, et l'associe à l'objet d' CDialogBar .

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

Paramètres

  • pParentWnd
    Pointeur vers l'objet parent d' CWnd .

  • lpszTemplateName
    Pointeur vers le nom du modèle de ressource de boîte de dialogue de l'objet d' CDialogBar .

  • nStyle
    Le style de barre d'outils. Les styles supplémentaires de barre d'outils sont pris en charge :

    • La barre de contrôles d'CBRS_TOP est au sommet de la fenêtre frame.

    • La barre de contrôles d'CBRS_BOTTOM est en bas de la fenêtre frame.

    • La barre de contrôles d'CBRS_NOALIGN n'est pas repositionnée lorsque le parent est redimensionné.

    • La barre de contrôles d'CBRS_TOOLTIPS affiche des info-bulles.

    • La barre de contrôles deCBRS_SIZE_DYNAMIC est dynamique.

    • La barre de contrôles deCBRS_SIZE_FIXED est fixe.

    • La barre de contrôles deCBRS_FLOATING est flottante.

    • La barre d'état d'CBRS_FLYBY affiche des informations sur le bouton.

    • La barre de contrôles deCBRS_HIDE_INPLACE n'est pas affichée à l'utilisateur.

  • nID
    l'ID du contrôle de la barre de boîte de dialogue.

  • nIDTemplate
    L'ID de ressource de modèle de boîte de dialogue de l'objet d' CDialogBar .

Valeur de retour

Une valeur différente de zéro si l'opération a réussi ; sinon 0.

Notes

Si vous spécifiez le style d'alignement d' CBRS_TOP ou d' CBRS_BOTTOM , la largeur de la barre de boîte de dialogue est celle de la fenêtre frame et sa hauteur est celle de la ressource spécifiée par nIDTemplate. Si vous spécifiez le style d'alignement d' CBRS_LEFT ou d' CBRS_RIGHT , la hauteur de la barre de boîte de dialogue est celle de la fenêtre frame et sa largeur est celle de la ressource spécifiée par nIDTemplate.

Exemple

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

Configuration requise

Header: afxext.h

Voir aussi

Référence

CDialogBar, classe

Graphique de la hiérarchie

CDialogBar::CDialogBar