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

C

BOOL WINAPI SftTree_GetItemPictureAlign(HWND hwndCtl);
void WINAPI SftTree_SetItemPictureAlign(HWND hwndCtl, BOOL fSet);
BOOL WINAPI SftTreeSplit_GetItemPictureAlign(HWND hwndCtl);
void WINAPI SftTreeSplit_SetItemPictureAlign(HWND hwndCtl, BOOL fSet);

C++

BOOL CSftTree::GetItemPictureAlign() const;
void CSftTree::SetItemPictureAlign(BOOL fSet = TRUE);
BOOL CSftTreeSplit::GetItemPictureAlign() const;
void CSftTreeSplit::SetItemPictureAlign(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

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

Comments

The GetItemPictureAlign and SetItemPictureAlign 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 SetItemPictureAlign(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 function defines whether tree lines are connected to 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/SetItemBitmapAlign is a synonym for Get/SetItemPictureAlign. 

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