HeaderPane
Main
Hide
Share Link
Print

ItemImageAlign Property, SftTreeItems Object

Defines whether item graphics are aligned with higher level cells.

Syntax

Get

C#bool Boolean = object.ItemImageAlign;
VB.NETBoolean = object.ItemImageAlign As Boolean
C++VARIANT_BOOL Boolean = object->ItemImageAlign;
VARIANT_BOOL Boolean = object->GetItemImageAlign();
CHRESULT object->get_ItemImageAlign(VARIANT_BOOL* Boolean);
VBBoolean = object.ItemImageAlign As Boolean

Put

C#bool object.ItemImageAlign = Boolean;
VB.NETobject.ItemImageAlign = Boolean As Boolean
C++VARIANT_BOOL object->ItemImageAlign = Boolean;
void object->PutItemImageAlign(VARIANT_BOOL Boolean);
CHRESULT object->put_ItemImageAlign(VARIANT_BOOL Boolean);
VBobject.ItemImageAlign = Boolean As Boolean

object

A SftTreeItems object.

Boolean

Defines whether item graphics are aligned with higher level cells.

BooleanDescription
TrueItem graphics of items at a lower level are aligned with the cell of the immediate parent level.
FalseItem graphics are not aligned, resulting in a still indented, but narrower look. 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.

Comments

The ItemImageAlign property defines whether item graphics are aligned with higher level cells.

In a variable height tree control, item graphics may be of varying widths and heights. If item bitmaps are smaller than the largest item bitmap used, the item bitmaps are horizontally centered within the space available for item bitmaps. This results in (smaller) item bitmaps not aligned with the cells of the parent level.

If the Items.Indentation property is used to define the exact indentation for item levels, the ItemImageAlign property defines whether tree lines are connected to the parent's item graphic or simply centered within the parent's cell.

See Also SftTreeItems Object | Object Hierarchy


Last Updated 11/03/2026 - (email)
© 2026 Softel vdm, Inc.