Share via

CDialogBar-klasse

Biedt de functionaliteit van een windows-dialoogvenster zonder modus in een besturingsbalk.

Syntaxis

class CDialogBar : public CControlBar

Members

Openbare constructors

Naam Description
CDialogBar::CDialogBar Maakt een CDialogBar object.

Openbare methoden

Naam Description
CDialogBar::Maken Hiermee maakt u een Windows-dialoogvensterbalk en koppelt u deze aan het CDialogBar object.

Opmerkingen

Een dialoogvensterbalk lijkt op een dialoogvenster dat standaardbesturingselementen voor Windows bevat waartussen de gebruiker kan taben. Een andere overeenkomst is dat u een dialoogvenstersjabloon maakt om de dialoogvensterbalk weer te geven.

Het maken en gebruiken van een dialoogvenster is vergelijkbaar met het maken en gebruiken van een CFormView object. Gebruik eerst de dialoogvenstereditor om een dialoogvenstersjabloon te definiëren met de stijl WS_CHILD en geen andere stijl. De sjabloon mag niet de stijl hebben WS_VISIBLE. Roep in de toepassingscode de constructor aan om het CDialogBar object samen te stellen, roep vervolgens Create het dialoogvenstervenster aan en koppel het aan het CDialogBar object.

Zie het artikel Dialoogvensterbalken en Technische notitie 31, Besturingsbalken voor meer informatie.CDialogBar

Opmerking

In de huidige release kan een CDialogBar object geen Besturingselementen voor Windows Forms hosten. Zie Een Windows-formuliergebruikersbesturingselement gebruiken in MFC voor meer informatie over Besturingselementen voor Windows Forms in Visual Studio.

Overnamehiërarchie

CObject

CCmdTarget

CWnd

CControlBar

CDialogBar

Requirements

Koptekst: afxext.h

CDialogBar::CDialogBar

Maakt een CDialogBar object.

CDialogBar();

CDialogBar::Maken

Hiermee laadt u de resourcesjabloon in het dialoogvenster die is opgegeven door lpszTemplateName of nIDTemplate, maakt u het dialoogvenstervenster, stelt u de stijl in en koppelt u deze aan het CDialogBar object.

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

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

Parameterwaarden

pParentWnd
Een aanwijzer naar het bovenliggende CWnd object.

lpszTemplateName
Een aanwijzer naar de naam van de resourcesjabloon voor het dialoogvenster van het CDialogBar object.

nStyle
De werkbalkstijl. Ondersteunde extra werkbalkstijlen zijn:

  • CBRS_TOP Control-balk bevindt zich boven aan het framevenster.

  • CBRS_BOTTOM besturingsbalk bevindt zich onder aan het framevenster.

  • CBRS_NOALIGN besturingsbalk wordt niet verplaatst wanneer het bovenliggende item wordt gewijzigd.

  • CBRS_TOOLTIPS controlbalk geeft knopinfo weer.

  • CBRS_SIZE_DYNAMIC Control-balk dynamisch is.

  • CBRS_SIZE_FIXED besturingsbalk is opgelost.

  • CBRS_FLOATING besturingsbalk zwevend is.

  • CBRS_FLYBY statusbalk bevat informatie over de knop.

  • CBRS_HIDE_INPLACE besturingsbalk wordt niet weergegeven voor de gebruiker.

Nid
De besturingselement-id van de dialoogvensterbalk.

nIDTemplate
De resource-id van de dialoogvenstersjabloon van het CDialogBar object.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

Als u de CBRS_TOP of CBRS_BOTTOM uitlijningsstijl opgeeft, is de breedte van de dialoogvensterbalk dat van het framevenster en de hoogte ervan die van de resource die is opgegeven door nIDTemplate. Als u de CBRS_LEFT of CBRS_RIGHT uitlijningsstijl opgeeft, is de hoogte van de dialoogvensterbalk die van het framevenster en de breedte ervan is die van de resource die is opgegeven door nIDTemplate.

Example

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

Zie ook

MFC-voorbeeld CTRLBARS
CControlBar-klasse
Hiërarchiediagram
CFormView-klasse
CControlBar-klasse

  • Last updated on