XP Themes Tab Control in any orientation

• Download source VC++ project - 22.1 Kb
• Download sample demo executable - 11.2 Kb

Using CXPTabCtrl, XP Themes Tab Control, left, bottom and right orientation

Introduction

The article shows how to solve a problem, which appears on the Windows Tab Control when using Windows XP operating system with XP Themes enabled. Tab control behaves as if it has only one orientation - top. In fact, it has all four orientations, but all four of them (for some reason) have the same appearance.

It is demonstrated how to use the proposed class CXPTabCtrl, Windows tab control extension as a solution to this problem. CXPTabCtrl detects the operating system and tab control orientation:

• If it is not XP system or XP Themes are not enabled - it uses default Windows tab behavior (it does not do anything extra).
• If it is XP system and XP Themes are enabled - it draws tab control properly in appropriate direction.

CXPTabCtrl control also works properly if the state of XP Themes enabling is changed during the running of the application. Tab control hot tracking is also supported.

Background

There are a lots of Windows applications developed for earlier Windows versions, which use bottom or other "not-top" oriented Windows tab control. The problem is: if the application is running on an XP system with XP Themes, Windows tab control is not shown properly as it used to be.

Problems when using default SysTabControl32 (CTabCtrl) with XP Themes, bottom orientation

One possibility to solve this problem is to change all tab controls in these applications to be top oriented. This would involve change of the look of the applications and painful Windows resource changes and possible code changes.

Another possibility (used for CXPTabCtrl) is to use a thin wrapper around the tab control and to simulate missing orientations. CXPTabCtrl uses available XP Themes "top-tab" look as a template and adapts it for other tab orientations:

• Bottom orientation:
  1. use top background bitmap,
  2. mirror it vertically,
  3. draw icon and text on mirrored background.

  

• Left orientation:
  1. use top background bitmap,
  2. draw icon and text on the background,
  3. rotate the bitmap for 90°.

  

• Right orientation:
  1. use top background bitmap,
  2. mirror it vertically,
  3. draw icon and text on the background,
  4. rotate the bitmap for 90°.

  

• Top orientation (used only for test purposes, could use default from XP Themes Windows XP):
  1. use top background bitmap,
  2. draw icon and text.

  

Notice also that the body of the tab control has to be manipulated, mirrored or rotated, not only the "tab" parts of the tab control (because a "tab body" has texture and shadows).

How to use it

The CXPTabCtrl class is simple to use. To add it to your project, please follow the steps below:

1. Put its source files (XPTabCtrl.cpp and XPTabCtrl.h) into the proper project folder and add their file names to your Visual Studio project.
2. Include its header to the appropriate header file - usually dialog class header where class CXPTabCtrl is used. If you plan to use CXPTabCtrl in several places of your application, you can add it only to your StdAfx.h file:

   #include "XPTabCtrl.h"

3. You should replace CTabCtrl with CXPTabCtrl everywhere in the project where you want new XP Themes tab behavior.

   CXPTabCtrl  m_tabCtrl

4. If CXPTabCtrl has images, then appropriate bitmap IDB_TABIMAGES (or other with correct tab images) should be included as resource bitmap. It is also necessary to call InitImageList(IDB_TABIMAGES) function, from OnInitDialog or other appropriate initializing place:

   m_tabCtrl.InitImageList(IDB_TABIMAGES);
   // only necessary to call if tabs have images

Although tab control orientation is usually set in resource editor or in Tab's Create function, CXPTabCtrl orientation can be changed any time while application is running.

Points of Interest

This sample could also be used as an example of how to solve some other problems in Windows programming. Other techniques shown in this sample include:

1. How to mirror bitmap image vertically fast and simply by using only two Windows calls GetDIBits and SetDIBits. This works in any color resolution.
2. How to rotate rectangular bitmap image fast and in any color resolution.
3. How to use inline assembler for lengthy repetitive processing, in this case, rotating bitmap image pixels. If image is of large dimensions (large tab control body), a C style coding could take considerable more time than assembler version.
4. How to use XP Themes functions in applications, which can run on earlier operating systems.
5. How to enable XP Themes dialog texture background.
6. How to make applications XP Themes aware by simply copying XP manifest, resource "24", ID "1" from one application resource to another.
7. How to use tab ToolTips.

Please note

• The sample is created and compiled on VC++ 6.0 service pack 5.
• The sample has been tested on Windows XP (XP Themes enabled or disabled while sample was running).
• The sample has also been tested on Windows 2000, Windows NT 4.0 (CXPTabCtr does not have effect).
• Other Windows systems could have possible problems (?)
• The sample has been tested on the following color resolutions: 8 bit, 16 bit, 24 bit and 32 bit colors.
• The sample has not been tested on multi-line (stacked) tabs, could be problems (?)

Correspondence

Please post your questions, suggestions and bug reports only to the forum below.