Displaying an image in the header


Unlike most other common controls, the header control does not use an image list. It does allow you to use a bitmap in any of the header item. You can display just the bitmap or the bitmap with the item label. You use the CHeaderCtrl::SetItem() function to assign a bitmap to a header item or to remove a bitmap if one is already assigned.

The following code assigns a bitmap to a header control item. This code will show the bitmap as well as the item label. I noticed one bug with this code. The right most column of pixels in the bitmap does not get displayed. You should, therefore, not consider the right most column when creating the bitmap. Also, if the bitmap is taller than what the header control can display, then only the middle portion of the bitmap is displayed. The header control does not have a problem in displaying wide bitmaps. Another note of warning, the bitmap is not displayed transparently. If you want a non rectangular shape, you have to use a gray background for the bitmap and hope that the user does not change the color scheme.

	HD_ITEM hditem;
	hditem.mask = HDI_FORMAT;
	((CHeaderCtrl*)GetDlgItem(0))->GetItem( nCol, &hditem );
	hditem.mask = HDI_BITMAP | HDI_FORMAT;
	hditem.fmt |= HDF_BITMAP;
	// mybitmap is a CBitmap object containing the bitmap
	hditem.hbm = (HBITMAP)mybitmap.GetSafeHandle();
	((CHeaderCtrl*)GetDlgItem(0))->SetItem( nCol, &hditem );

If you want to display just the bitmap and not the label, then you can remove the HDF_STRING flag from the fmt field.
	HD_ITEM hditem;
	hditem.mask = HDI_FORMAT;
	((CHeaderCtrl*)GetDlgItem(0))->GetItem( nCol, &hditem );
	hditem.mask = HDI_BITMAP | HDI_FORMAT;
	hditem.fmt |= HDF_BITMAP;
	hditem.fmt &= ~HDF_STRING ;
	// mybitmap is a CBitmap object containing the bitmap
	hditem.hbm = (HBITMAP)mybitmap.GetSafeHandle();
	((CHeaderCtrl*)GetDlgItem(0))->SetItem( nCol, &hditem );

To remove a bitmap from the column header, you can change the format by calling the SetItem() function again and clear the HDF_BITMAP flag from the format field. Alternatively, you can use HDI_BITMAP as the mask and set the hbm field to NULL.

	HD_ITEM hditem;
	hditem.mask = HDI_FORMAT;
	((CHeaderCtrl*)GetDlgItem(0))->GetItem( nCol, &hditem );
	hditem.mask = HDI_FORMAT;
	hditem.fmt &= ~HDF_BITMAP;
	((CHeaderCtrl*)GetDlgItem(0))->SetItem( nCol, &hditem );



Comments

  • How to add a picture to a subitem

    Posted by Legacy on 09/04/2003 12:00am

    Originally posted by: Tiger

    How can i add a picture to a specific subitem in the list control, like you do it in the header control?
    
    

    any help would be very appreciated
    tiger

    Reply
  • Didn't work at the first time. Complete method attached....

    Posted by Legacy on 07/31/2003 12:00am

    Originally posted by: Frenzy

    Hi!
    
    

    I had some trouble at the first time with the code. So I changed it at some parts. Here is now my working method for adding a bitmap to the Header of a CListCtrl.

    Frenzy

    void CBilView::setListCtrlHeaderBitmap( CListCtrl* pList, int iColumn, BOOL bUpDown )
    {
    HINSTANCE hInst = AfxGetInstanceHandle();
    HBITMAP hBitmap = NULL;
    HD_ITEM hditem;

    CString strText = "";

    CWnd * pChild = pList->GetWindow( GW_CHILD ) ;
    if( pChild == NULL )
    {
    return ;
    }
    ASSERT_VALID(pChild) ;

    // load Bitmap
    if( bUpDown == TRUE )
    {
    hBitmap = ::LoadBitmap(hInst,MAKEINTRESOURCE(IDB_BITMAP_ARR_UP));
    }
    else
    {
    hBitmap = ::LoadBitmap(hInst,MAKEINTRESOURCE(IDB_BITMAP_ARR_DOWN));
    }

    // get HeaderCtrl
    CHeaderCtrl* pListHeader = pList->GetHeaderCtrl();

    // get header
    char szText[256] ;
    memset( &hditem, 0, sizeof hditem ) ;
    hditem.mask = HDI_TEXT ;
    hditem.pszText = szText ;
    hditem.cchTextMax = sizeof szText ;
    pChild->SendMessage( HDM_GETITEM, iColumn, (LPARAM)&hditem );
    strText = szText;

    // set header and bitmap
    hditem.mask = HDI_FORMAT;
    BOOL bRes = pListHeader->GetItem( iColumn, &hditem );
    hditem.mask = HDI_TEXT | HDI_FORMAT | HDI_BITMAP;
    hditem.fmt |= HDF_BITMAP;
    hditem.hbm = hBitmap;
    hditem.pszText = strText.GetBuffer(strText.GetLength());
    hditem.cchTextMax = strText.GetLength();
    bRes = pListHeader->SetItem( iColumn, &hditem );

    // reset of all other columns
    int iCount = pListHeader->GetItemCount();

    for( int i=0; i<iCount; i++ )
    {
    if( i != iColumn )
    {
    // get header
    szText[256] ;
    memset( &hditem, 0, sizeof hditem ) ;
    hditem.mask = HDI_TEXT ;
    hditem.pszText = szText ;
    hditem.cchTextMax = sizeof szText ;
    pChild->SendMessage( HDM_GETITEM, i, (LPARAM)&hditem );
    strText = szText;

    // set header
    hditem.mask = HDI_FORMAT;
    bRes = pListHeader->GetItem( i, &hditem );
    hditem.mask = HDI_FORMAT;
    hditem.fmt &= ~HDF_BITMAP;
    hditem.pszText = strText.GetBuffer(strText.GetLength());
    hditem.cchTextMax = strText.GetLength();
    bRes = pListHeader->SetItem( i, &hditem );
    }
    }

    return;
    }

    Reply
  • How to display the icon( ! ) in the center of the column?

    Posted by Legacy on 01/21/2002 12:00am

    Originally posted by: kalpana

    hello,
    i want to display an icon ! in the center of the column.For
    drawing columns we are using listview control..it is not ownerdrwan ...thats why i am gettting problem..is there any way to do this...?
    and second thing is i want to select(highlight) all the columns in a row except the first one.
    so please help me out in this
    thank you,
    kalpana

    Reply
  • Windows XP Icon spacing

    Posted by Legacy on 01/19/2002 12:00am

    Originally posted by: Denis Galiana

    Hello,

    I've noticed in Windows XP that the gap between icons in 2nd, 3rd, ... columns and text is greater (al least 3 times more) that the gap between the first column icon and the first column text ....

    Reply
  • Displaying an image in the header

    Posted by Legacy on 07/07/1999 12:00am

    Originally posted by: Dale King

    I don't seem to get an image included within the header. I only get some blank header space. Any thoughts?

    Reply
  • Displaying and image in header control

    Posted by Legacy on 02/09/1999 12:00am

    Originally posted by: Joe Holloway


    RE: If you want a non rectangular shape, you have to use a gray background for the bitmap and hope that the user does not change the color scheme.

    One can use the CBitmap member function LoadMappedBitmap to get around this. If you create a bitmap with the standard gray windows background and load it using LoadMappedBitmap, it will automagically map that gray color to the current background color. Use the help file to learn more!

    Reply
Leave a Comment
  • Your email address will not be published. All fields are required.

Top White Papers and Webcasts

  • Live Event Date: August 20, 2014 @ 1:00 p.m. ET / 10:00 a.m. PT When you look at natural user interfaces as a developer, it isn't just fun and games. There are some very serious, real-world usage models of how things can help make the world a better place – things like Intel® RealSense™ technology. Check out this upcoming eSeminar and join the panel of experts, both from inside and outside of Intel, as they discuss how natural user interfaces will likely be getting adopted in a wide variety …

  • Hybrid cloud platforms need to think in terms of sweet spots when it comes to application platform interface (API) integration. Cloud Velocity has taken a unique approach to tight integration with the API sweet spot; enough to support the agility of physical and virtual apps, including multi-tier environments and databases, while reducing capital and operating costs. Read this case study to learn how a global-level Fortune 1000 company was able to deploy an entire 6+ TB Oracle eCommerce stack in Amazon Web …

Most Popular Programming Stories

More for Developers

Latest Developer Headlines

RSS Feeds