Skip Navigation LinksBCGSoft > Support > Developer Area > Application Wizard > Application Wizard for VS 2017-2026

Application Wizard for VS 2017-2026

In this article, we'll describe how to create a new BCGControlBar for MFC applications in Visual Studio 2017-2026 environments.

  1. Run the Visual Studio environment.
  2. Choose the "File | New | Project..." menu item.
  3. Choose BCGControlBar Application Wizard:
    • BCGPAppWizard2017: for Visual Studio 2017.
    • BCGPAppWizard2019: for Visual Studio 2019.
    • BCGPAppWizard2022: for Visual Studio 2022.
    • BCGPAppWizard2026: for Visual Studio 2026.
  4. Click the "Next" button.
  5. Specify the project/solution name and location. Click the "Create" button.
  6. Now, you can specify your application's appearance, content, and basic functionality.

    "Application Type" page:

    BCGControlBar Application Wizard for Visual Studio 2017-2026 (1)
    • Application type. Specifies your application's UI type:
      • Single-document interface (SDI): the application frame contains one document only.
      • Multiple-document interface (MDI): the application frame contains multiple document windows. MDI tabs are available for this type of application.
      • Dialog-based application: creates either a dialog box or a property sheet-based application. The HTML Dialog option is available for the dialog box applications.
      • Multiple top-level documents: each new document will be created in a separate top-level frame.
      • Multi-views single document: the application frame contains one document with multiple views.

      If you need more details about application types, please refer to MFC/Windows documentation.

    • Visual style and colors. Choose the visual theme (such as Office 2024 or Visual Studio 2026) that will be initially applied to your application. For most visual styles, you can choose the initial color theme. For the modern visual styles such as Office 2024 or Visual Studio 2026, you may choose the "System on startup" color option: if the Windows app mode is dark, the dark color theme will be used by default; otherwise, the application starts in the light color theme.
    • Enable visual style switching. Check this option if you wish to allow the user to modify the application's visual theme at runtime. If your application is toolbar/menu-based, the "Application Look" menu item will appear under the "View" menu. The "Style" menu will be located on the right side for applications that use a ribbon bar. When this option is checked, you may specify a list of available themes by clicking the Options button below this check box.
    • Enable themed file dialog. Replaces all standard (Windows) file dialogs with themed (visual manager-based) dialogs.
    • Resource language. Only English (United States) is available for this application wizard.
    • Character Set. You can choose between Unicode or a multi-byte character set. Please note that using a multi-byte character set is not recommended for the new applications.
    • Use of libraries. This option specifies how to link to the BCGControlBar and MFC libraries. By default, both libraries are linked as shared DLLs. Please note that the static link is not available in the evaluation product version!
    • Application type options:
      • Project style. This option specifies whether the application is created using Visual Studio, Office, or File Explorer styles, applicable to SDI, MDI, and MTI application types. For the dialog-based applications, you may choose the dialog box or property sheet style. When you change the project style, the wizard automatically configures the application's command bar and docking panes as follows:
        • Visual Studio: menu bar, toolbar, explorer docking pane, output pane and properties docking pane.
        • Office: ribbon bar, Outlook pane and caption bar.
        • Windows Explorer: explorer bar, task pane.
      • Document-view architecture support. Specifies whether to include document/view architecture in your application. Not available in the dialog-based applications. For more details about document-view architecture, please refer to MFC documentation.
      • Security Development Lifecycle (SDL) checks. This option specifies whether SDL should be enabled in your application. For more information about SDL, see Microsoft documentation.
      • MDI tabs. Specifies whether each document will be placed on a separate tab (MDI application only). If your application is SDI, MTI or dialog-based, this option will be disabled. The Options dialog, located near this checkbox, allows you to specify the MDI tab style: and other MDI tab options:
        • Maximize child: specifies whether the MDI child window is always maximized. This option is available for the Standard tabs only.
        • Tabs on top: specifies whether MDI tabs are positioned at the top of the window. If this box is unchecked, the tabs are located on the bottom of the frame. This option is not available for tabs on the frame caption.
        • Tab icons: specifies whether the document's icon is displayed on the corresponding MDI tab.
        • Tear-off MDI tabs: specifies whether the application will be created with tear-off MDI child windows. This option is not available for the Standard tabs.
      • Use HTML dialog. This option is available for the dialog box applications only. If you select this option, an HTML-based dialog box will be used.
      • Resizeable dialog with controls layout. This option is available for the dialog box or property sheet applications only. Specifies whether Layout Manager is enabled in dialogs or property pages.
  7. Click the "Next" button to proceed to the Document Template Properties page:

    BCGControlBar Application Wizard for Visual Studio 2017-2026 (2)

    On this page of the Application Wizard, provide document template strings (available only if the application has document/view architecture support). For more details, please refer to MFC documentation.

  8. Click the "Next" button and open the User Interface Features page: BCGControlBar Application Wizard for Visual Studio 2017-2026 (3)

    On this page of the Application Wizard, provide the main application frame styles and command bar(s) that will be created in the main frame. This page contains the following sections:

    • Main frame styles: sets the features of your application's main window frame. For more details, please refer to Windows/MFC documentation.
    • Command bar (menu/toolbar/ribbon): this indicates whether your application includes a menu with a toolbar, ribbon or explorer bar. Not available for dialog-based applications. Command bar options can be specified on the next page (Command Bars).
  9. Click the "Next" button and open the Command Bars page:

    BCGControlBar Application Wizard for Visual Studio 2017-2026 (4)

    On this page of the Application Wizard, provide command bar options. Please note that the content of this page depends on the command bar type (specified on the User Interface Features page).

    • Menu bar and toolbar options:
    • Ribbon bar options:
      • Backstage view: select this item if you wish to create your ribbon bar with the Backstage view.
      • Use Ribbon Designer: if this item is checked, the project will be created with Ribbon Designer resources. Otherwise, the ribbon bar will be initialized in the source code.
      • Ribbon customization: select this option if you want to enable the Ribbon Customization dialog.
      • Context menu customization: select this option if you want to enable context menu customization.
      • Ribbon display options. If this item is checked, the "Ribbon Display Options" button will be displayed instead of the "Minimize" button. You can specify the following options for this button:
        • Ribbon Layout. Allows switching between the classic and simplified Ribbon modes.
        • Auto-hide Ribbon. Allows switching the ribbon to full-screen mode.
      • User-defined tools: adds an ability to customize user-defined (usually external) tools at runtime.
      • SVG icons: use SVG (Scalable Vector Graphics) ribbon bar icons. If this checkbox is unchecked, raster icons (PNG format) will be used.
      • Use font icons: when this option is checked, the application will be created with Windows 10/11 font icons.
    • Explorer bar options:
      • Navigation buttons: select this item if you wish to add standard navigation buttons (such as "Back" or "Forward") to the explorer bar.
      • Buttons simplified look: if this option is checked, navigation buttons will be displayed with simplified icons instead of full-color icons.
      • Forward button: select this option if you want to add a "Forward" button.
      • History button: select this option if you want to add the "History" menu button.
      • Up button: select this option if you want to add an "Up" button.
      • Home button: select this option if you want to add a "Home" button.
      • Refresh button: select this option if you want to add a "Refresh" button.
      • Breadcrumb window: select this option if you want to add a breadcrumb window.
      • SVG icons: use SVG (Scalable Vector Graphics) explorer bar icons. If this checkbox is unchecked, raster icons (PNG format) will be used.
  10. Click the "Next" button and open the Advanced Features page:

    BCGControlBar Application Wizard for Visual Studio 2017-2026 (5)

    This page of the Application Wizard provides advanced features for your application, such as frame panes, printing support, and so on.

    • Use graphics manager in view: check this option if you want to use a graphics manager (Direct2D or GDI+) to draw the content of your CView-derived class. By default, this option is unchecked.
    • Enable docking panes auto-hide: enables the "Auto Hide Window" feature for all docking panes. By default, this option is checked.
    • Automatically hide scroll bars: enables auto-hidden scroll bars. By default, this option is unchecked.
    • Per Monitor High DPI Awareness V2: enables the Per-Monitor (V2) DPI support.
    • Frame and Dialogs rounded corners: enables the frame and dialog windows' rounded corners in all visual themes (Windows 11 or newer versions only).
    • Explorer docking pane: adds an example of a workspace bar with detachable tabs.
    • Output docking pane: adds an example of an output bar.
    • Properties docking pane: adds a Visual Studio-style property grid.
      • Create Property Manager: if this option is checked, the application will be created with a built-in property manager.
    • Outlook pane: select this option if you want to add a shortcuts bar.
      • Style: choose one of the following styles of the shortcuts bar:
        • Office 2013: all page buttons are located on the bottom toolbar only.
        • Office 2003: the page butons area is resizable and page buttons that don't fit the height are added to the bottom-located toolbar.
        • Office XP: the active page button and all previous page buttons are located on top; the rest are on the bottom.
      • Embedded control: a shortcuts bar will be created with an embedded control.
      • Enable collapse/expand: select this option if you want to add a "Minimize" button to the shortcuts bar.
    • Caption bar: select this option if you want to add a caption bar.
    • Task pane: adds an example of a task pane.
    • Toolbox pane: adds an example of the toolbox.
    Information about other advanced options can be found in MFC Application Wizard documentation.
  11. Click the "Next" button to open the Generated Classes page:

    BCGControlBar Application Wizard for Visual Studio 2017-2026 (6)

    This page allows you to change the generated class or file name and the base class of your view.

  12. Click the "Finish" button.

Back to the Developer Area