Hide

SftTree/OCX 7.5 - ActiveX Tree Control

Display
Print

ItemLines Property, SftTree Object

Defines the number of text lines used for item height calculation.

Deprecated - Provided for compatibility with earlier versions only - Use Items.Lines instead

Syntax

Get

VB.NETCount = object.ItemLines As Short
VBCount = object.ItemLines As Integer
C#.NETshort Count = object.ItemLines;
VC++short Count = object->ItemLines;
short Count = object->GetItemLines();
CHRESULT object->get_ItemLines(short* Count);

Put

VB.NETobject.ItemLines = Count As Short
VBobject.ItemLines = Count As Integer
C#.NETshort object.ItemLines = Count;
VC++short object->ItemLines = Count;
void object->PutItemLines(short Count);
CHRESULT object->put_ItemLines(short Count);

object

A SftTree object.

Count

Defines the number of text lines used for item height calculation.

Comments

Deprecated - Provided for compatibility with earlier versions only - Use Items.Lines instead

The ItemLines property defines the number of text lines used for item height calculation.

If fixed height items are used (see Items.Style), all items in a tree control have the same height. The best height for items is automatically calculated based on the font, graphics and text components used. If multi-line text entries are desired, the Items.Lines property should be used to set the expected (maximum) number of lines per item. This insures that multiple lines of text will fit within the vertical space allocated to each item. Some properties which override default properties are not taken into consideration when calculating the item height. E.g., the Cell.Font property does not affect the item height. It must be chosen to be smaller or equal to the size of the Font property, otherwise text may be clipped vertically.

If variable height items are used (see Items.Style), items in a tree control can have varying heights. The best height for each item is automatically calculated based on the font, graphics and text components used. If multi-line text entries are desired, the Items.Lines property should be used to set the maximum number of lines to be displayed. This insures that multiple lines of text will fit within the vertical space allocated to each item. If a cell has more text lines than defined using the Items.Lines property, the lines are not visible. All properties of an item, including cell properties such as the Cell.Font and Cell.Image properties, also affect the item height.

In order to enable multi-line text or word wrap, the Column.CellMultiline and Column.CellWordWrap properties have to be set.

If fixed height items are used (see Items.Style), a tree control defaults to one text line. If the Column.CellMultiline property is set, multi-line text is added and the text exceeds the number of lines defined using the Items.Lines property, the text will be truncated vertically.

If variable height items are used (see Items.Style), a tree control defaults to one text line. If the Column.CellMultiline property is set, if more text lines need to be displayed than are defined using the Items.Lines property, only the specified number of text lines are displayed followed by a '+', indicating that text lines have been truncated.

See Also SftTree Object | Object Hierarchy


Last Updated 08/13/2020 - (email)
© 2024 Softel vdm, Inc.


Spring Break!

Our offices will be closed this week (March 18 through March 22).

We'll be back March 24 to address any pending sales and support issues.