WIN32 APPLICATION : CppWindowsCommonControls Project Overview

Use:

CppWindowsCommonControls contains simple examples of how to create common
controls defined in comctl32.dll. The controls include Animation, ComboBoxEx,
Updown, Header, MonthCal, DateTimePick, ListView, TreeView, Tab, Tooltip, IP
Address, Statusbar, Progress Bar, Toolbar, Trackbar, and SysLink.

Creation:

First, build up the dialogs for use in this example according to the
CppWindowsDialog example. Then link the application to comctl32.lib in the
project's property page / Linker / Input / Additional Dependencies. Because
the sample needs to work on Windows XP and Windows 2003 apart from Windows
Vista, change the default target version to _WIN32_WINNT_WINXP in the
targetver.h.

    #ifndef WINVER
    #define WINVER _WIN32_WINNT_WINXP        // Originally 0x0600
    #endif

    #ifndef _WIN32_WINNT
    #define _WIN32_WINNT _WIN32_WINNT_WINXP    // Originally 0x0600
    #endif

A. Animation Control

Step1. Add the AVI resource IDR_UPLOAD_AVI according to the KB article:

How to create a resource .dll file that contains an AVI file
http://support.microsoft.com/kb/178199

Step2. In OnInitAnimationDialog, load and register animation control class.

    INITCOMMONCONTROLSEX iccx;
    iccx.dwSize = sizeof(INITCOMMONCONTROLSEX);
    iccx.dwICC = ICC_ANIMATE_CLASS;
    if (!InitCommonControlsEx(&iccx))
        return FALSE;

Step3. Create the animation control.

    RECT rc = { 20, 20, 280, 60 };
    HWND hAnimate = CreateWindowEx(0, ANIMATE_CLASS, 0,
        ACS_TIMER | ACS_AUTOPLAY | ACS_TRANSPARENT | WS_CHILD | WS_VISIBLE,
        rc.left, rc.top, rc.right, rc.bottom,
        hWnd, (HMENU)IDC_ANIMATION, hInst, 0);

Step4. Open and play the AVI clip in the animation control.

    SendMessage(hAnimate, ACM_OPEN, (WPARAM)0,
        (LPARAM)MAKEINTRESOURCE(IDR_UPLOAD_AVI));
    SendMessage(hAnimate, ACM_PLAY, (WPARAM)-1,
        MAKELONG(/*from frame*/0, /*to frame*/-1));

B. ComboBoxEx Control

Step1. In OnInitComboBoxExDialog, load and register ComboBoxEx control class.

    INITCOMMONCONTROLSEX iccx;
    iccx.dwSize = sizeof(INITCOMMONCONTROLSEX);
    iccx.dwICC = ICC_USEREX_CLASSES;
    if (!InitCommonControlsEx(&iccx))
        return FALSE;

Step2. Create the ComboBoxEx control.

    RECT rc = { 20, 20, 280, 100 };
    HWND hComboEx = CreateWindowEx(0, WC_COMBOBOXEX, 0,
        CBS_DROPDOWN | WS_CHILD | WS_VISIBLE,
        rc.left, rc.top, rc.right, rc.bottom,
        hWnd, (HMENU)IDC_COMBOBOXEX, hInst, 0);

Step3. Create an image list and associate the image list with the ComboBoxEx
control. (ImageList_Create, CBEM_SETIMAGELIST)

Step4. Add some items with image to the ComboBoxEx common control.
(COMBOBOXEXITEM, CBEM_INSERTITEM)

Step5. Destroy the image list on close. (ImageList_Destroy)

C. Up-Down Control

Step1. In OnInitUpdownDialog, load and register Updown control class.

    INITCOMMONCONTROLSEX iccx;
    iccx.dwSize = sizeof(INITCOMMONCONTROLSEX);
    iccx.dwICC = ICC_UPDOWN_CLASS;
    if (!InitCommonControlsEx(&iccx))
        return FALSE;

Step2. Create an Updown control and an Edit control. (CreateWindowEx)

Step3. Attach the Updown control to its 'buddy' edit control. (UDM_SETBUDDY)

D. Header Control

Step1. In OnInitHeaderDialog, load and register Header control class.

    INITCOMMONCONTROLSEX iccx;
    iccx.dwSize = sizeof(INITCOMMONCONTROLSEX);
    iccx.dwICC = ICC_WIN95_CLASSES;
    if (!InitCommonControlsEx(&iccx))
        return FALSE;

Step2. Create an Header control. (CreateWindowEx)

Step3. Resize the header control to fit the client rectangle.
(HDM_LAYOUT, HDLAYOUT, SetWindowPos)

Step4. Add Header items (HDITEM, HDM_INSERTITEM)

Step5. In OnHeaderSize of the window, resize the Header control accordingly.
(HDM_LAYOUT, HDLAYOUT, SetWindowPos)

E. Month Calendar Control

Step1. In OnInitMonthCalDialog, load and register MonthCal control class.

    INITCOMMONCONTROLSEX iccx;
    iccx.dwSize = sizeof(INITCOMMONCONTROLSEX);
    iccx.dwICC = ICC_DATE_CLASSES;
    if (!InitCommonControlsEx(&iccx))
        return FALSE;

Step2. Create a Month Calendar control. (CreateWindowEx)

F. Date and Time Picker Control

Step1. In OnInitDateTimePickDialog, load and register DateTimePick control class.

    INITCOMMONCONTROLSEX iccx;
    iccx.dwSize = sizeof(INITCOMMONCONTROLSEX);
    iccx.dwICC = ICC_DATE_CLASSES;
    if (!InitCommonControlsEx(&iccx))
        return FALSE;

Step2. Create a DateTimePick control. (CreateWindowEx)

G. List View Control

Step1. In OnInitListviewDialog, load and register Listview control class.

    INITCOMMONCONTROLSEX iccx;
    iccx.dwSize = sizeof(INITCOMMONCONTROLSEX);
    iccx.dwICC = ICC_LISTVIEW_CLASSES;
    if (!InitCommonControlsEx(&iccx))
        return FALSE;

Step2. Create a Listview control. (CreateWindowEx)

Step3. Set up and attach image lists to list view common control.
(ImageList_Create, ImageList_AddIcon, ListView_SetImageList)

Step4. Add items to the the list view common control.
(LVITEM, LVM_INSERTITEM)

Step5. In OnListviewSize of the window, resize and re-arrange the Listview
control to fit the client rectangle. (MoveWindow, LVM_ARRANGE)

Step6. In OnListviewClose, free up the image list resources.
(ImageList_Destroy)

H. Tree View Control

Step1. OnInitTreeviewDialog, load and register Treeview control class.

    INITCOMMONCONTROLSEX iccx;
    iccx.dwSize = sizeof(INITCOMMONCONTROLSEX);
    iccx.dwICC = ICC_TREEVIEW_CLASSES;
    if (!InitCommonControlsEx(&iccx))
        return FALSE;

Step2. Create a Treeview control. (CreateWindowEx)

Step3. Set up and attach image lists to tree view common control.
(ImageList_Create, ImageList_AddIcon, TreeView_SetImageList)

Step4. Add items to the tree view common control.
(TVITEM, TVINSERTSTRUCT, TVM_INSERTITEM)

Step5. In OnTreeviewSize of the window, resize the Treeview control to fit
the client rectangle. (MoveWindow)

Step6. In OnTreeviewClose, free up the image list resources.
(TreeView_GetImageList, ImageList_Destroy)

I. Tab Control

Step1. In OnInitTabControlDialog, load and register Tab control class.

    INITCOMMONCONTROLSEX iccx;
    iccx.dwSize = sizeof(INITCOMMONCONTROLSEX);
    iccx.dwICC = ICC_TAB_CLASSES;
    if (!InitCommonControlsEx(&iccx))
        return FALSE;

Step2. Create a Tab control. (CreateWindowEx)

Step3. Add items to the tab common control. (TCITEM, TCM_INSERTITEM)

Step4. In OnTabSize of the window, resize the Tab control to fit the client
rectangle. (MoveWindow)

J. Tooltip Control

Step1. In OnInitTooltipDialog, load and register Tooltip control class.

    INITCOMMONCONTROLSEX iccx;
    iccx.dwSize = sizeof(INITCOMMONCONTROLSEX);
    iccx.dwICC = ICC_WIN95_CLASSES;
    if (!InitCommonControlsEx(&iccx))
        return FALSE;

Step2. Create a button control and a tooltip control. Note that a tooltip
control should not have the WS_CHILD style, nor should it have an id,
otherwise its behavior will be adversely affected, eg. tooltips displayed in
wrong place or not at all. (CreateWindowEx)

Step3. Associate the tooltip with the button control. (TOOLINFO, TTM_ADDTOOL)

K. IP Address Control

Step1. In OnInitIPAddressDialog, load and register IPAddress control class.

    INITCOMMONCONTROLSEX iccx;
    iccx.dwSize = sizeof(INITCOMMONCONTROLSEX);
    iccx.dwICC = ICC_INTERNET_CLASSES;
    if (!InitCommonControlsEx(&iccx))
        return FALSE;

Step2. Create the IPAddress control. (CreateWindowEx)

L. Status Bar Control

Step1. In OnInitStatusbarDialog, load and register StatusBar control class.

    INITCOMMONCONTROLSEX iccx;
    iccx.dwSize = sizeof(INITCOMMONCONTROLSEX);
    iccx.dwICC = ICC_BAR_CLASSES;
    if (!InitCommonControlsEx(&iccx))
        return FALSE;

Step2. Create the status bar control. (CreateWindowEx)

Step3. Establish the number of partitions or 'parts' the status bar will
have, their actual dimensions will be set in the parent window's WM_SIZE
handler. (SB_SETPARTS)

Step4. Put some texts into each part of the status bar and setup each part.
(SB_SETTEXT)

Step5. In OnStatusbarSize, partition the statusbar to keep the ratio of the
sizes of its parts constant. Resize statusbar so it's always same width as
parent's client area. (SB_SETPARTS, WM_SIZE)

M. Progress Bar Control

Step1. In OnInitProgressDialog, load and register Progress Bar control class.

    INITCOMMONCONTROLSEX iccx;
    iccx.dwSize = sizeof(INITCOMMONCONTROLSEX);
    iccx.dwICC = ICC_PROGRESS_CLASS;
    if (!InitCommonControlsEx(&iccx))
        return FALSE;

Step2. Create the progress bar control. (CreateWindowEx)

Step3. Set the progress bar position. (PBM_SETPOS)

N. Toolbar Control

Step1. In OnInitToolbarDialog, load and register Toolbar control class.

    INITCOMMONCONTROLSEX iccx;
    iccx.dwSize = sizeof(INITCOMMONCONTROLSEX);
    iccx.dwICC = ICC_BAR_CLASSES;
    if (!InitCommonControlsEx(&iccx))
        return FALSE;

Step2. Create the toolbar control. (CreateWindowEx)

Step3. Setup and add buttons to Toolbar.

3.1 Send the TB_BUTTONSTRUCTSIZE to the toolbar control. If an application
uses the CreateWindowEx function to create the toolbar, the application
must send this message to the toolbar before sending the TB_ADDBITMAP or
TB_ADDBUTTONS message. The CreateToolbarEx function automatically sends
TB_BUTTONSTRUCTSIZE, and the size of the TBBUTTON structure is a parameter
of the function.

3.2 Add images (TBADDBITMAP, TB_ADDBITMAP)

3.3 Add buttons (TBBUTTON, TB_ADDBUTTONS)

Step4. Tell the toolbar to resize itself, and show it. (TB_AUTOSIZE)

O. Trackbar control

Step1. In OnInitTrackbarDialog, load and register Trackbar control class.

    INITCOMMONCONTROLSEX iccx;
    iccx.dwSize = sizeof(INITCOMMONCONTROLSEX);
    iccx.dwICC = ICC_WIN95_CLASSES; // Or ICC_PROGRESS_CLASS
    if (!InitCommonControlsEx(&iccx))
        return FALSE;

Step2. Create the Trackbar control. (CreateWindowEx)

Step3. Set Trackbar range. (TBM_SETRANGE)

P. SysLink Control

Step1. In OnInitSysLinkDialog, load and register SysLink control class.

    INITCOMMONCONTROLSEX iccx;
    iccx.dwSize = sizeof(INITCOMMONCONTROLSEX);
    iccx.dwICC = ICC_LINK_CLASS;
    if (!InitCommonControlsEx(&iccx))
        return FALSE;

Step2. Create the SysLink control. The SysLink control supports the anchor
tag(<a>) along with the attributes HREF and ID. (CreateWindowEx) For example,

    HWND hLink = CreateWindowEx(0, WC_LINK,
        _T("All-In-One Code Framework\n") \
        _T("<A HREF=\"http://cfx.codeplex.com\">Home</A> ") \
        _T("and <A ID=\"idBlog\">Blog</A>"),
WS_VISIBLE | WS_CHILD | WS_TABSTOP,
        rc.left, rc.top, rc.right, rc.bottom,
hWnd, (HMENU)IDC_SYSLINK, hInst, NULL);

Step3. In OnSysLinkNotify, capture the notifications associated with SysLink
controls: NM_CLICK (syslink) and (for links that can be activated by the
Enter key) NM_RETURN. If the link is a HREF, get its url from
NMLINK.LITEM.szUrl, otherwise, get the ID from NMLINK.LITEM.szID.