SftTree/DLL 7.5 - Tree Control

RowColBitmap

Defines the picture displayed in the row/column header.

C

HBITMAP WINAPI SftTree_GetRowColBitmap(HWND hwndCtl);
void WINAPI SftTree_SetRowColBitmap(HWND hwndCtl, HBITMAP hBitmap);
HBITMAP WINAPI SftTreeSplit_GetRowColBitmap(HWND hwndCtl);
void WINAPI SftTreeSplit_SetRowColBitmap(HWND hwndCtl, HBITMAP hBitmap);

C++

CBitmap* CSftTree::GetRowColBitmap() const;
void CSftTree::SetRowColBitmap(int val = 0);
void CSftTree::SetRowColBitmap(const CBitmap& Bitmap);
CBitmap* CSftTreeSplit::GetRowColBitmap() const;
void CSftTreeSplit::SetRowColBitmap(int val = 0);
void CSftTreeSplit::SetRowColBitmap(const CBitmap& Bitmap);

Parameters

hwndCtl

The window handle of the tree control.

hBitmap, Bitmap

A bitmap handle or a reference to a CBitmap object to be used as row/column header picture. 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.

val

The only allowable value is 0, which is used to stop displaying the row/column header picture.

Returns

GetRowColBitmap returns the bitmap used to draw the row/column header, or NULL if the row/column header doesn't have a defined bitmap.

Comments

The GetRowColBitmap and SetRowColBitmap functions define the picture displayed in the row/column header.

Get/SetRowColBitmap can be used to define a row/column picture using a bitmap handle only. Get/SetRowColHeaderPicture can be used to define a row/column picture using a bitmap, icon or ImageList image.

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 RowColHeaderPictureStyle.

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