Defines whether item pictures of items are aligned with the cells of the immediate parent level.

C

BOOL WINAPI SftTree_GetItemBitmapAlign(HWND hwndCtl);
void WINAPI SftTree_SetItemBitmapAlign(HWND hwndCtl, BOOL fSet);
BOOL WINAPI SftTreeSplit_GetItemBitmapAlign(HWND hwndCtl);
void WINAPI SftTreeSplit_SetItemBitmapAlign(HWND hwndCtl, BOOL fSet);

C++

BOOL CSftTree::GetItemBitmapAlign() const;
void CSftTree::SetItemBitmapAlign(BOOL fSet = TRUE);
BOOL CSftTreeSplit::GetItemBitmapAlign() const;
void CSftTreeSplit::SetItemBitmapAlign(BOOL fSet = TRUE);

Parameters

hwndCtl

The window handle of the tree control.

fSet

Set to TRUE to align item pictures of items with the cells of the immediate parent item.

Returns

GetItemBitmapAlign returns a value indicating whether item pictures of items are aligned with the cells of the immediate parent level.

Comments

The GetItemBitmapAlign and SetItemBitmapAlign functions define whether item pictures of items are aligned with the cells of the immediate parent level.

As items are indented based on their levels, the width of the indentation is determined by the width of the expand/collapse button bitmaps, the width of the item pictures and the default font used for the tree control.  By using SetItemBitmapAlign(TRUE), item pictures of items at a lower level can be aligned with the cell of the immediate parent level.

If the SetIndentation function is used to define the exact indentation for item levels, the SetItemPictureAlign defines whether tree lines are aligned with the parent's item picture or simply centered within the parent's cell.

In a variable height tree control, item pictures may be of varying widths and heights.  If item pictures are smaller than the maximum width registered using SetPictures, the item pictures are horizontally centered within the space available for item pictures.  This results in (smaller) item pictures not aligned with the cells of the parent level.

Get/SetItemPictureAlign is a synonym for Get/SetItemBitmapAlign. 

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