CTreeCtrl::SetItemImage

Associates images with an item.

BOOL SetItemImage(
   HTREEITEM hItem,
   int nImage,
   int nSelectedImage 
);

Parameters

  • hItem
    Handle of the item whose image is to be set.

  • nImage
    Index of the item's image in the tree view control's image list.

  • nSelectedImage
    Index of the item's selected image in the tree view control's image list.

Return Value

Nonzero if successful; otherwise 0.

Remarks

Each item in a tree view control can have a pair of bitmapped images associated with it. The images appear on the left side of an item's label. One image is displayed when the item is selected, and the other is displayed when the item is not selected. For example, an item might display an open folder when it is selected and a closed folder when it is not selected.

Call this function to set the index of the item's image and its selected image within the tree view control's image list.

For more information on images, see CImageList.

Example

See the example for CTreeCtrl::GetItemImage.

Requirements

Header: afxcmn.h

See Also

Reference

CTreeCtrl Class

Hierarchy Chart

CTreeCtrl::GetItemImage

CImageList Class

Other Resources

CTreeCtrl Members