Visual C++ Team Blog : MFC

TechEd Europe Demo Session - Face-Lifting MFC Applications on Windows 7

vcblog — Mon, 23 Nov 2009 20:40:00 GMT

Hello,

My name is Damien Watkins, and I am a Program Manager on the Visual C++ team. Today, I thought I would post the “overview script” for my TechEd Europe session – so those who could not attend can try it out for themselves at home. My talk was about the new MFC features we have added in Visual Studio 2010.

Just before we get started, I would like to point out that Pat Brenner has been doing some Channel 9 videos on the new MFC functionality too, you can find the first three videos here (and keep your eyes open for more in the future):

1. Pat Brenner: Visual Studio 2010 - MFC and Windows 7 (a 25 minute interview on the rationale for and design of the new MFC features)

2. MFC: Implementing handlers for preview, thumbnail and search filtering (a 3 minute “How To” style video)

3. MFC: Integrating your application with the Windows Restart Manager (a 5 minute “How To” style video)

Creating my Solution/Application

To begin, you could run Visual Studio 2010 (VS2010) as an administrator. This is needed to register the “File Type Handlers” for providing Preview, Search and Thumbnail support for your document type. Alternatively, you could run VS2010 as a normal user and run the command to register the file type handlers in an elevated command prompt.

After starting VS2010 (and executing it as an Administrator) you will create a new MFC Application (File->New->Project or CONTROL+SHIFT+n). In the New Project Wizard you will select MFC Application and enter a name for the Project. In my example below I entered “VCBlogDemo” but you can use anything you like however, if you use the same name as me it will be easier to follow the instructions below when I refer to specific classes, methods, etc. I then click “OK”. As an aside, unless I say otherwise I always select the defaults on any screen.

Now work your way through the MFC Application Wizard dialogs, selecting/enabling these features as you go:

1. On the “Overview” page, just click “Next”.

2. On the “Application Type” page, set the Project Style to Office (I will show some Ribbon features further on and so I want a Ribbon based UI) and then click “Next”.

3. On the “Compound Document Support” page, just click “Next”.

4. On the Document Template Properties page:

· Add a file extension, I entered demo-ms

· And I added support for Preview, Thumbnail and Search handler support by clicking the various buttons once they were enabled.

· Check the screenshot you have the same settings:

· Then click “Next”.

5. On the “Database Support” page, just click “Next”.

6. On the “User Interface Features” page, just click “Next”.

7. On the “Advanced Features”, please note that “Support Restart Manager” is already selected, and then just click “Next”.

8. On the “Generated Classes” page:

· Change the Base Class for the CVCBlogDemoView class to CEditView. The reason for doing this is that the default implementation of this class can be used to highlight the Preview, Search and Thumbnail functionality without the need for the developer to write any additional code. Your screen should now look like this:

· Then click Finish

Once the Wizard completes, as a quick sanity check, I changed my “Solution Configuration” to be “Release”, build the solution (F7) and started the application without debugging (CONTROL+F5) – I essentially just closed it after it I saw it running. Then I returned to VS2010.

Configuring Restart Manger and Auto-Save

By default, the auto save interval is 5 minutes, but rather than have to wait five minutes after starting the application to demonstrate this functionality I am going to set the interval to 15 seconds. I do this by first finding the command that enables Restart Manger support in the CVCBlogDemoApp constructor and then by adding a line immediately after it. The Constructor will then have these two lines in:

m_dwRestartManagerSupportFlags = AFX_RESTARTMANAGER_SUPPORT_ALL_ASPECTS;

m_nAutosaveInterval = 15000; // add this line after the preceding line

Editing the Ribbon

You can then change to the Resource View and go to the VCBlogDemo project and expand VCBlogDemo.rc. Then expand the Ribbon resources and double click on the IDR_RIBBON resource. Next I dragged a Panel from the Toolbox and plac it on the ribbon. I changed the caption of the panel to “Restart”. I then dragged a Button from the Toolbox to the Restart Panel. I then changed the button’s ID to ID_CRASHME and its Caption to CrashMe.

Return of the MFC Class Wizard!

Now you need to add events handlers for the “CrashMe” button in the ribbon. At this point it becomes time to welcome back an old friend, the Class Wizard. Hit CONTROL-SHIFT-X (different key binding to the original) and the Wizard appears. It is hard to imagine a more commonly requested feature than the return of the Wizard – we really hope you enjoy using it!

Now change the “Class name” field to CVCBlogDemoApp and on the Commands Tab enter ID_CRASHME in the search box. The Class Wizard screen looks like this:

Next, selected COMMAND and clicked on “Add Handler” and then select UPDATE_COMMAND_UI and clicked on “Add Handler”. The COMMAND handler will crash our application, so we can see the Restart Manager functionality at work. The UPDATE_COMMAND handler will disable the “CrashMe” button until our application has been running for more than 1 minute so Windows Restart Manger machinery is enabled (and so the auto save timeout has expired at least once.) Now use the “Edit Code” button to add the following code (of course, you can add whatever logic you like to enable/disable the button and terminate the application – the code below is the simplest and most constrained I could think of – however it is not an example of good coding practices):

Demonstrating our application

So now rebuild the Solution and start the application (remember - it should be built for “Release”.) When you start the application without debugging (CONTROL+F5) you will notice that the “CrashMe” button is initially disabled. Next I will open two more documents (keying CONTROL-N twice will do).

1. In document one I will type “This document is saved” and click on the save icon and save the documents in the Documents folder.

2. In document two I will type “This document is not saved” (and I will NOT save it).

3. In document three I will type “This sentence is saved” and click on the save icon and save the documents in the Documents folder. Next I will type on the second line “This sentence is not saved” (and I will NOT save it).

Windows 7 Taskbar

To allow the auto-save functionality time to work, at this point you can hover over the application’s icon in the new Windows 7 Taskbar. Notice how each document has a separate tab (although the writing is very small in this example) and you can see a real time view of the document – for example notice the flashing cursor in the active document (whichever one that happens to be.)

Demonstrating the Restart Manager

Now we can crash the application by clicking on the enabled “CrashMe” button. After taking a few seconds to restart, you get a nice example of our new CTaskDialog and the option to auto-recover our work.

I recover everything by clicking on the “Recover the auto-saved documents” option. Now I hover on the application icon in the task bar and, when the document previews appear, I start closing the documents by clicking on the red X. You will notice how a document that has been saved is just closed, a document that has already been saved but subsequently has been updated will have the “Save” dialog enabled and a document that has never been saved will have the “Save As” dialog enabled.

Explorer Interaction

Finally, I start Explorer in the documents folder, type “saved” in the Search field and select one of the demo-ms files and thus we can see the Icon, Preview and Search functionality.

Support for High DPI

For those who have a few minutes, at this stage you can change the resolution of your screen and either restart or logoff (depending on your OS requirements) and see how MFC has added support for High DPI displays.

Summary

As you can see, using the new Windows functionality from MFC is very simple. Add to this the return of the Class Wizard and the addition of the Ribbon Editor and we hope that MFC developers will be excited about the upcoming Visual Studio 2010 release.

One other point, you may notice is that the Ribbon Designer looks a lot like the BCGSoft designer. Again, as with the MFC extensions in VS2008 SP1 (a.k.a. the MFC Feature Pack) we got some assistance from BCGSoft on some of the implementation of the new MFC Features. So that was the overview script of my TechEd Europe talk.

Thanks,

Damien

MFC Updates for Vista Common Controls

vcblog — Thu, 22 Mar 2007 03:31:00 GMT

MFC has been updated for Visual Studio codename Orcas to handle the new common controls/messages/flags added in Windows Vista. We have made a number of updates to MFC to wrap the new controls and messages, so when you’re using these new capabilities, MFC will make it easier to code them.

Three new MFC classes have been added to wrap new controls (from Windows XP and Vista):

· The CPagerCtrl MFC class wraps a ‘SysPager’ control window. The pager control is a control container which has scrollers, so it can contain more controls than there is visible space for.

· The CNetAddressCtrl MFC class wraps a ‘msctls_netaddress’ control window. The network address control is essentially an edit control with network address validation built in, so IPv6, IPv4, and DNS names can be validated by the control rather than by user code.

· The CSplitButton MFC class wraps a button window when it has the BS_SPLITBUTTON style. This is a button with a drop-down attached, so variants of a command can be added to a drop-down menu attached to the button.

Several MFC classes have been updated with methods to wrap new messages (from Windows XP and Vista):

· The CMonthCalCtrl class has 19 new methods, including support for setting various calendar views(month/year/decade/century) and support for calendar borders.

· The CButton class has 15 new methods, including support for the “split-button” and “command-button” styles in Vista.

· The CTreeCtrl class has 15 new methods, including support for expanded images and extended item states.

· The CListCtrl class has 14 new methods, including complete support for group methods and item-index methods.

· The CToolBarCtrl class has 9 new methods, including support for padding and pressed image lists.

· The CProgressCtrl class has 8 new methods, including support for marquee mode, colors and states.

· The CEdit class has 7 new methods, including support for “highlighting” behavior added in Vista and “cue banner” behavior added in Window XP.

· The CComboBox class has 5 new methods, including support for “cue banner” behavior added in Windows XP.

· The CDateTimeCtrl class has 5 new methods, including support for changing the style of the child calendar control.

· The CHeaderCtrl class has 5 new methods, including support for a dropdown from the column header.

· The CReBarCtrl class has 4 new methods, including support for setting band width and extended styles.

· The CToolTipCtrl class has 4 new methods.

· The CSliderCtrl class has 2 new methods.

· The CStatusBarCtrl class has 1 new method.

· The CAnimateCtrl class has 1 new method.

· The CLinkCtrl class has 1 new method.

MFC has been updated to handle the new Vista Aero “look-and-feel”. This includes support for automatically or manually hiding the main menu bar in an application, which is suggested if other UI elements such as toolbars duplicate most of the UI in the main menu bar.

MFC has also been updated to use the new file opening and saving dialogs that are the standard in Vista. This is as simple as recompiling your application with MFC. If you are using CFileDialog to get an open or save dialog, your application will automatically use the new Vista dialogs and gracefully degrade to using the old dialogs on previous versions of Windows.

That pretty much covers the updates to MFC.

Also note that Spy++ has also been updated to handle the new Vista controls and messages, so you can use it effectively in tandem with MFC. An article about those updates will be posted soon.

Thanks, and we welcome any questions you might have about MFC, or feature requests for future versions.

Pat Brenner

Visual C++ Libraries Team