Iconview Control

Iconview control offers an interface for user to surf entry in icon and label mode. These entire icon items can be shown in a scroll child window. User can select one or some items using keyboard and mouse operation and the selected icon usually are shown high lightly. The representative usage of Iconview control is to be the container of the desktop icons and display of files under some directory.

CreateWindow using CTRL_ICONVIEW as control class name can create Icon View control.

We can add, delete, set the size of icon (should be done before adding this icon) and get label text of the icon, etc. by sending corresponding message after creating Iconview control.

Styles of Iconview

By default, the Iconview control window will only display the icon and its label and there will be no border in display region. You can add border for the Iconview control by using window style WS_BORDER when create control using CreatWindow. On the other hand, you can also use window style WS_VSCROLL and WS_HSCROLL to add vertical and horizontal scroll bar so that you can display all the content in the list control.

Iconview control is based on the ScrollView Control and it remains the style of the ScrollView Control.

Messages of Iconview

Icon operation

After an Iconview control is created, the next step is to add icon to the control. Sending an IVM_ADDITEM message to the control does this work.

IVITEMINFO ivii;
SendMessage (hIconView, IVM_ADDITEM, 0, (LPARAM)&ivii) ;

In above program, ivii is an IVITEMINFO structure and it is used to display the icon information needed to be set. The definition and meaning of the IVITEMINFO structure are as below:

typedef struct _IVITEMINFO
{
    /**
     * the Index of the item
     */
    int nItem;
    /**
     * the bitmap icon of the item
     */
    PBITMAP bmp;
    /**
     * the text label of the item
     */
    const char *label;
    /** attached additional data of this item */
    DWORD addData;
    /**
     * reserved
     */
    DWORD dwFlags;
} IVITEMINFO;

The index value of the icon shows this icon control’s position in the parent window. It will return the handle of the icon control when success, otherwise return 0.

The height and width of the icon can be specified by IVM_SETITEMSIZE before adding an icon, and all the icons will be displayed in this height and width.

int width;
int height;
SendMessage (hIconView, IVM_SETITEMSIZE, width, height) ;

In above code, width is the width to be set and height is the height to be set.

Since the Iconview control is based on the ScrollView, the rest messages of the Iconview control are almost the same as the ScrollView.

  • IVM_RESETCONTENT: corresponding to SVM_RESETCONTENT: used to clear the icon item in Iconview control.

  • IVM_DELITEM: corresponding to SVM_DELITEM: used to delete the icon item in Iconview control.

  • IVM_SETITEMDRAW: corresponding to SVM_SETITEMDRAW: used to set drawing function of the icon item.

  • IVM_SETCONTWIDTH: corresponding to SVM_SETCONTWIDTH: used to set the width of the scrollable window.

  • IVM_SETCONTHEIGHT: corresponding to SVM_SETCONTHEIGHT: used to set the height of the scrollable window.

  • IVM_SETITEMOPS: corresponding to SVM_ SETITEMOPS: used to set the callback function of correlation operation of the icon item.

  • IVM_GETMARGINS: corresponding to SVM_GETMARGINS: used to get the margin range of the Iconview.

  • IVM_SETMARGINS: corresponding to SVM_SETMARGINS: used to set the margin range of the Iconview.

  • IVM_GETLEFTMARGIN, IVM_GETTOPMARGIN, IVM_GETRIGHTMARGIN and IVM_GETBOTTOMMARGIN corresponding to SVM_GETLEFTMARGIN, SVM_GETTOPMARGIN, SVM_GETRIGHTMARGIN, and SVM_GETBOTTOMMARGIN: used to get the left, up, right, down margin range of the Iconview control

  • IVM_GETCONTWIDTH, IVM_GETCONTHEIGHT, IVM_GETVISIBLEWIDTH and IVM_GETVISIBLEHEIGHT corresponding to SVM_GETCONTWIDTH, SVM_GETCONTHEIGHT, SVM_GETVISIBLEWIDTH and SVM_GETVISIBLEHEIGHT: Used to get the width and height of the content area and visual area.

  • IVM_SETCONTRANGE: corresponding to SVM_SETCONTRANGE: used to set the range of the content area in the scrollable window.

  • IVM_GETCONTENTX and IVM_GETCONTENTY corresponding to SVM_GETCONTENTX and SVM_GETCONTENTY: used to get the current position of the content area.

  • IVM_SETCONTPOS: corresponding to SVM_SETCONTPOS: used to set the current position of the content area, in other word, to move content area to a specific position in the visual area.

  • IVM_GETCURSEL and IVM_SETCURSEL corresponding to SVM_GETCURSEL and SVM_SETCURSEL: used to get and set the current highlighted icon of the icon control.

  • IVM_SELECTITEM: corresponding to SVM_SELECTITEM: used to select a column item, and the selected item will be highlighted displayed.

  • IVM_SHOWITEM: corresponding to SVM_SHOWITEM: used to show an icon item.

  • IVM_CHOOSEITEM: corresponding to SVM_CHOOSEITEM is the combination of IVM_SELECTITEM and IVM_SHOWITEM message: used to select an icon and visualize it.

  • IVM_SETITEMINIT: corresponding to SVM_SETITEMINIT: used to set the initial operation of the icon item.

  • IVM_SETITEMDESTROY: corresponding to SVM_SETITEMDESTROY: used to set the destroy operation of the icon item.

  • IVM_SETITEMCMP: corresponding to SVM_SETITEMCMP: used to set the comparison function of the iconview control item.

  • IVM_MAKEPOSVISIBLE: corresponding to SVM_MAKEPOSVISIBLE: used to visualize one position in the content area.

  • IVM_GETHSCROLLVAL and IVM_GETVSCROLLVAL corresponding to SVM_GETHSCROLLVAL and SVM_GETVSCROLLVAL: used to get the current horizontal and vertical scroll data (the scroll range by clicking the scroll bar arrow).

  • IVM_GETHSCROLLPAGEVAL and IVM_GETVSCROLLPAGEVAL corresponding to SVM_GETHSCROLLPAGEVAL and SVM_GETVSCROLLPAGEVAL: used to get the current horizontal and vertical scroll data (the scroll range of changing page).

  • IVM_SETSCROLLVAL: corresponding to SVM_SETSCROLLVAL: used to set the horizontal or vertical scroll data of the scroll window.

  • IVM_SETSCROLLPAGEVAL: corresponding to SVM_SETSCROLLPAGEVAL: used to set the horizontal or vertical scroll data of the scroll window.

  • IVM_SORTITEMS: corresponding to SVM_SORTITEMS: used to sort the items of the icon.

  • IVM_GETITEMCOUNT: corresponding to SVM_GETITEMCOUNT: used to get the item count of current icon control.

  • IVM_GETITEMADDDATA: corresponding to SVM_GETITEMADDDATA: used to get the additional data of current icon item.

  • IVM_SETITEMADDDATA: corresponding to SVM_SETITEMADDDATA: used to set the additional data of current icon item.

  • IVM_REFRESHITEM: corresponding to SVM_REFRESHITEM: used to refresh a icon item area.

  • IVM_GETFIRSTVISIBLEITEM: corresponding to SVM_GETFIRSTVISIBLEITEM: used to get the first visible icon item.

Notification Codes of Iconview

The Iconview control will generate notification code when it responds to user’s operations such as clicking or some status changed. The notification codes include:

  • LVN_SELCHANGE: corresponding to SVN_SELCHANGE: current highlighted icon item is changed.

  • LVN_CLICKED: corresponding to SVN_CLICKED: user clicks the icon item.

A notification handle function should be registered by application using SetNotificationCallback to handle all the received notification code.

LVN_CLICKED and LVN_SELCHANGE are used to inform the message handle function that the additional data is the clicked or highlighted icon handle.

Sample Program

Code in List 1 illustrates the use of an Iconview control to construct a simple icon explore window. Please refer to iconview.c file of the demo program package mg-samples of this guide for complete source code.

List 1 Use of iconview control

#define IDC_ICONVIEW    100
#define IDC_BT          200
#define IDC_BT2         300
#define IDC_BT3         400
#define IDC_BT4         500

#define IDC_ADD         600
#define IDC_DELETE      601

static HWND hIconView;

static BITMAP myicons [12];

static const char* iconfiles[12] =
{
    "./res/acroread.png",
    "./res/icons.png",
    "./res/looknfeel.png",
    "./res/package_games.png",
    "./res/tux.png",
    "./res/xemacs.png",
    "./res/gimp.png",
    "./res/kpilot.png",
    "./res/multimedia.png",
    "./res/realplayer.png",
    "./res/usb.png",
    "./res/xmms.png"
};

static const char *iconlabels[12] =
{
    "acroread",
    "icons",
    "looknfeel",
    "games",
    "tux",
    "xemacs",
    "gimp",
    "kpilot",
    "multimedia",
    "realplayer",
    "usb",
    "xmms"
};

static void myDrawItem (HWND hWnd, GHANDLE hsvi, HDC hdc, RECT *rcDraw)
{
    const PBITMAP pbmp = (PBITMAP)iconview_get_item_bitmap (hsvi);
    const char *label = (const char*)iconview_get_item_label (hsvi);

    SetBkMode (hdc, BM_TRANSPARENT);
    SetTextColor (hdc, PIXEL_black);

    if (iconview_is_item_hilight(hWnd, hsvi)) {
        SetBrushColor (hdc, PIXEL_blue);
    }
    else {
        SetBrushColor (hdc, PIXEL_lightwhite);
    }
    FillBox (hdc, rcDraw->left, rcDraw->top, RECTWP(rcDraw), RECTHP(rcDraw));
    SetBkColor (hdc, PIXEL_blue);

    if (label) {
        RECT rcTxt = *rcDraw;
        rcTxt.top = rcTxt.bottom - GetWindowFont (hWnd)->size * 2;
        rcTxt.left = rcTxt.left - (GetWindowFont (hWnd)->size) + 2;

        DrawText (hdc, label, -1, &rcTxt, DT_SINGLELINE | DT_CENTER | DT_VCENTER);
    }
    FillBoxWithBitmap (hdc, rcDraw->left, rcDraw->top, 0, 0, pbmp);
}

static int
BookProc (HWND hDlg, int message, WPARAM wParam, LPARAM lParam)
{
    switch (message)
    {

    case MSG_INITDIALOG:
    {
        IVITEMINFO ivii;
        static int i = 0, j = 0;

        hIconView = GetDlgItem (hDlg, IDC_ICONVIEW);
        SetWindowBkColor (hIconView, PIXEL_lightwhite);
        //SendMessage (hIconView, IVM_SETITEMDRAW, 0, (LPARAM)myDrawItem);
        SendMessage (hIconView, IVM_SETITEMSIZE, 55, 65);
        //SendMessage (hIconView, IVM_SETITEMSIZE, 35, 35);
        for (j = 0; j < 3; j ++) {
            for (i = 0; i < TABLESIZE(myicons); i++) {
                memset (&ivii, 0, sizeof(IVITEMINFO));
                ivii.bmp = &myicons[i];
                ivii.nItem = 12 * j + i;
                ivii.label = iconlabels[i];
                ivii.addData = (DWORD)iconlabels[i];
                SendMessage (hIconView, IVM_ADDITEM, 0, (LPARAM)&ivii);
            }
        }
        break;
    }

    case MSG_COMMAND:
    {
        int id = LOWORD (wParam);
        int code = HIWORD (wParam);

        switch (id) {
        case IDC_ICONVIEW:
            if (code == IVN_CLICKED) {
                int sel;
                sel = SendMessage (hIconView, IVM_GETCURSEL, 0, 0);
                printf ("clicking %d\n", sel);
            }
            break;
        case IDC_ADD:
        {
            IVITEMINFO ivii;
            char buff [10];
            int idx;
            int count = SendMessage (hIconView, IVM_GETITEMCOUNT, 0, 0);

            sprintf (buff, "NewIcon%i", count);
            memset (&ivii, 0, sizeof (IVITEMINFO));
            ivii.bmp = &myicons [0];
            ivii.nItem = count;
            ivii.label = buff;
            ivii.addData = (DWORD)"NewIcon";

            idx = SendMessage (hIconView, IVM_ADDITEM, 0, (LPARAM)&ivii);
            SendMessage (hIconView, IVM_SETCURSEL, idx, 1);
            break;
        }

        case IDC_DELETE:
        {
            int sel = SendMessage (hIconView, IVM_GETCURSEL, 0, 0);
            int count = SendMessage (hIconView, IVM_GETITEMCOUNT, 0, 0);
            char *label = NULL;

            if (sel >= 0){
                label = (char *) SendMessage (hIconView, IVM_GETITEMADDDATA, sel, 0);
                if (label && strlen (label))
                    printf ("delelete item:%s\n", label);
                SendMessage (hIconView, IVM_DELITEM, sel, 0);
                if (sel == count - 1)
                    sel --;
                SendMessage (hIconView, IVM_SETCURSEL, sel, 1);
            }
            break;
        }

        } /* end command switch */
        break;
    }

    case MSG_KEYDOWN:
        if (wParam == SCANCODE_REMOVE) {
            int cursel = SendMessage (hIconView, IVM_GETCURSEL, 0, 0);

            if (cursel >= 0){
                SendMessage (hIconView, IVM_DELITEM, cursel, 0);
                SendMessage (hIconView, IVM_SETCURSEL, cursel, 0);
            }
        }
        break;

    case MSG_CLOSE:
    {
        EndDialog (hDlg, 0);
        return 0;
    }

    } /* end switch */

    return DefaultDialogProc (hDlg, message, wParam, lParam);
}

static CTRLDATA CtrlBook[] =
{
    {
        CTRL_ICONVIEW,
        WS_BORDER | WS_CHILD | WS_VISIBLE | WS_VSCROLL | WS_HSCROLL,
         10, 10, 290, 300,
        IDC_ICONVIEW,
        "",
        0
    },
    {
        CTRL_BUTTON,
        WS_CHILD | WS_VISIBLE | BS_DEFPUSHBUTTON | WS_TABSTOP,
        90, 330, 50, 30,
        IDC_ADD,
        "Add",
        0
    },
    {
        CTRL_BUTTON,
         WS_CHILD | WS_VISIBLE | WS_TABSTOP | BS_PUSHBUTTON,
        170, 330, 50, 30,
        IDC_DELETE,
        "Delete",
        0
    }
};

static DLGTEMPLATE DlgIcon =
{
    WS_BORDER | WS_CAPTION,
    WS_EX_NONE,
    0, 0, 310, 400,
    "My Friends",
    0, 0,
    TABLESIZE(CtrlBook), CtrlBook,
    0
};
alt

Figure 1 Use of an Icon View control

<< Gridview Control | Table of Contents | Independent Scrollbar Control >>

PreviousGridview ControlNextIndependent Scrollbar Control

Last updated