Partager via

CDialogBar, classe

  • Article

Fournit les fonctionnalités d'une boîte de dialogue non modale Windows dans une barre de contrôles.

Syntaxe

class CDialogBar : public CControlBar

Membres

Constructeurs publics

Nom Description
CDialogBar ::CDialogBar Construit un objet CDialogBar.

Méthodes publiques

Nom Description
CDialogBar ::Create Crée une barre de dialogue Windows et l’attache à l’objet CDialogBar .

Notes

Une barre de dialogue ressemble à une boîte de dialogue dans laquelle elle contient des contrôles Windows standard que l’utilisateur peut tabulationr. Une autre similarité est que vous créez un modèle de dialogue pour représenter la barre de dialogue.

La création et l’utilisation d’une barre de dialogue sont similaires à la création et à l’utilisation d’un CFormView objet. Tout d’abord, utilisez l’éditeur de dialogue pour définir un modèle de dialogue avec le style WS_CHILD et aucun autre style. Le modèle ne doit pas avoir le style WS_VISIBLE. Dans votre code d’application, appelez le constructeur pour construire l’objet CDialogBar , puis appelez-le Create pour créer la fenêtre de barre de dialogue et l’attacher à l’objet CDialogBar .

Pour plus d’informations sur CDialogBar, consultez l’article Barres de dialogue et Note technique 31, Barres de contrôle.

Remarque

Dans la version actuelle, un CDialogBar objet ne peut pas héberger les contrôles Windows Forms. Pour plus d’informations sur les contrôles Windows Forms dans Visual C++, consultez Utilisation d’un contrôle utilisateur Windows Form dans MFC.

Hiérarchie d'héritage

CObject

CCmdTarget

CWnd

CControlBar

CDialogBar

Spécifications

En-tête : afxext.h

CDialogBar ::CDialogBar

Construit un objet CDialogBar.

CDialogBar();

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 barre de dialogue, définit son style et l’associe à l’objet 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 CWnd .

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

nStyle
Style de barre d’outils. Les styles de barre d’outils supplémentaires pris en charge sont les suivants :

  • CBRS_TOP barre de contrôle se trouve en haut de la fenêtre frame.

  • CBRS_BOTTOM barre de contrôle se trouve en bas de la fenêtre frame.

  • CBRS_NOALIGN barre de contrôle n’est pas repositionnée lorsque le parent est redimensionné.

  • CBRS_TOOLTIPS barre de contrôle affiche des info-bulles.

  • CBRS_SIZE_DYNAMIC barre de contrôle est dynamique.

  • CBRS_SIZE_FIXED barre de contrôle est fixe.

  • CBRS_FLOATING barre de contrôle flottante.

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

  • CBRS_HIDE_INPLACE barre de contrôle n’est pas affichée à l’utilisateur.

nID
ID de contrôle de la barre de dialogue.

nIDTemplate
ID de ressource du modèle de boîte de dialogue de l’objet CDialogBar .

Valeur de retour

Valeur différente de zéro cas de réussite ; sinon, 0.

Notes

Si vous spécifiez le style d’alignement CBRS_TOP ou CBRS_BOTTOM, la largeur de la barre 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 CBRS_LEFT ou CBRS_RIGHT, la hauteur de la barre 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;
}

Voir aussi

Exemple MFC CTRLBARS
CControlBar Class
Graphique hiérarchique
CFormView, classe
CControlBar Class