Defines the picture displayed in the row/column header.

C

BOOL WINAPI SftTree_GetRowColPicture(HWND hwndCtl, LPSFT_PICTURE lpPicture);
BOOL WINAPI SftTree_SetRowColPicture(HWND hwndCtl, LPCSFT_PICTURE lpPicture);
BOOL WINAPI SftTreeSplit_GetRowColPicture(HWND hwndCtl, LPSFT_PICTURE lpPicture);
BOOL WINAPI SftTreeSplit_SetRowColPicture(HWND hwndCtl, LPCSFT_PICTURE lpPicture);

C++

BOOL CSftTree::GetRowColPicture(LPSFT_PICTURE lpPicture) const;
BOOL CSftTree::SetRowColPicture(LPCSFT_PICTURE lpPicture);
BOOL CSftTreeSplit::GetRowColPicture(LPSFT_PICTURE lpPicture) const;
BOOL CSftTreeSplit::SetRowColPicture(LPCSFT_PICTURE lpPicture);

Parameters

hwndCtl

The window handle of the tree control.

lpPicture

A pointer to a SFT_PICTURE structure to be used as row/column header picture.  If the SFT_PICTURE structure defines a bitmap handle, the top, left pixel of the bitmap must contain the image's background color.  This color will be replaced by the actual window background color when the bitmap is displayed.  This parameter may be NULL to remove the row/column header picture.

Returns

Get/SetRowColPicture returns TRUE if the function was successful, otherwise FALSE is returned.

Comments

The GetRowColPicture and SetRowColPicture functions define the picture displayed in the row/column header.

Get/SetRowColPicture can be used to define a row/column picture using a bitmap, icon or ImageList image.

Get/SetRowColBitmap can be used to define a row/column picture using a bitmap handle only.

The dimensions of the picture are used to calculate the minimum dimension for the row headers, column headers and row/column headers, so pictures displayed in row headers, column headers and row/column headers are never clipped vertically.

The horizontal and vertical alignment of the row/column picture is defined using RowColPictureStyle.

The row/column header area is only shown if row headers and column headers are both shown (see SetShowRowHeader and SetShowHeader). 

See Also  C/C++ API  |  Categories |  Notifications