Ce navigateur n’est plus pris en charge.
Effectuez une mise à niveau vers Microsoft Edge pour tirer parti des dernières fonctionnalités, des mises à jour de sécurité et du support technique.
Télécharger Microsoft Edge
Plus d’informations sur Internet Explorer et Microsoft Edge
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
Description
Une barre de dialogue ressemble à une boîte de dialogue en ce qu’elle contient des contrôles Windows standard entre tableaux que l’utilisateur peut effectuer. Une autre similitude 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 boîtes 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 le code de votre application, appelez le constructeur pour construire l’objet CDialogBar
, puis appelez 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 boîte de dialogue et Note technique 31, Barres de contrôle.
Notes
Dans la version actuelle, un CDialogBar
objet ne peut pas héberger Windows Forms contrôles. Pour plus d’informations sur Windows Forms contrôles dans Visual C++, consultez Utilisation d’un contrôle utilisateur Windows Form dans MFC.
Hiérarchie d'héritage
CObject
CCmdTarget
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 CDialogBar
ressource de boîte de dialogue de l’objet.
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 est flottante.
CBRS_FLYBY barre d’état affiche des informations sur le bouton.
CBRS_HIDE_INPLACE barre de contrôle ne s’affiche pas pour l’utilisateur.
ID de contrôle de la barre de dialogue.
nIDTemplate
ID de ressource du CDialogBar
modèle de boîte de dialogue de l’objet.
Valeur renvoyée
Valeur différente de zéro cas de réussite ; sinon, 0.
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
MFC Sample CTRLBARS
CControlBar, classe
Graphique hiérarchique
CFormView, classe
CControlBar, classe