I’ve been doing a lot of managed C++ programming lately and I had forgotten what a pain it is switching back and forth between the header file and source file.  Back in the days of Visual Studio 6 I had a macro that switched between the CPP and H file, so I went googling, but the macro I found didn’t work very well in VS2008.  Like any good coder, I decided to write it myself instead.

If you haven’t written a macro before, here are the steps.

1. In Visual Studio, go to Tools | Macros | Macros IDE. A new window should open and in the Project Explorer, the MyMacros project should be open.
2. Right click on the MyMacros project and select Add | Add Module. Name it CppUtilities.  The CppUtilities
   should open in the editor window.
3. Add the code from below into the module and save the project.

1. ‘===================================================================== 
2. ‘ If the currently open document is a CPP or an H file, attempts to 
3. ‘ switch between the CPP and the H file. 
4. ‘===================================================================== 
5. Public Sub SwitchBetweenSourceAndHeader() 
6. Dim currentDocument As String
7. Dim targetDocument As String
8.   currentDocument = ActiveDocument.FullName 
9. If currentDocument.EndsWith(“.cpp”, StringComparison.InvariantCultureIgnoreCase) Then
10.     targetDocument = Left(currentDocument, Len(currentDocument) - 3) + “h” 
11.     OpenDocument(targetDocument) 
12. ElseIf currentDocument.EndsWith(“.h”, StringComparison.InvariantCultureIgnoreCase) Then
13.     targetDocument = Left(currentDocument, Len(currentDocument) - 1) + “cpp” 
14.     OpenDocument(targetDocument) 
15. End If
16. End Sub
17. ‘===================================================================== 
18. ‘ Given a document name, attempts to activate it if it is already open, 
19. ‘ otherwise attempts to open it. 
20. ‘===================================================================== 
21. Private Sub OpenDocument(ByRef documentName As String) 
22. Dim document As EnvDTE.Document 
23. Dim activatedTarget As Boolean
24.   activatedTarget = False
25. For Each document In Application.Documents 
26. If document.FullName = documentName And document.Windows.Count > 0 Then
27.       document.Activate() 
28.       activatedTarget = True
29. Exit For
30. End If
31. Next
32. If Not activatedTarget Then
33.     Application.Documents.Open(documentName, “Text”) 
34. End If
35. End Sub

If you switch back to Visual Studio and open the Macro Explorer, you should see the new module CppUtilities and the new macro SwitchBetweenSourceAndHeader in the tree.  You could run the macro from here, but it is much easier to bind it to a keystroke.

1. Click on Tools | Options then go to the Environment | Keyboard tab.
2. In the Show commands containing: box, type CppUtilities. This should filter the list down to one entry,Macros.MyMacros.CppUtilitities.SwitchBetweenSourceAndHeader.
3. Click on the Press shortcut keys: text box and then press the keystroke you would like to use to run the macro. If the keystroke is already used, it will show you below in the Shortcut currently used by: dropdown.  When you find one that is unused, click the Assign button to use it.  I use Ctrl+Shift+Alt+Bkspce.
4. Click OK then open a CPP or H file and give it a try.