Hide

SftTree/OCX 7.5 - ActiveX Tree Control

Display
Print

ColumnWidth Property, SftTree Object

Defines the width of the specified column.

Deprecated - Provided for compatibility with earlier versions only - Use Column.Width instead

Syntax

Get

VB.NETWidth = object.get_ColumnWidth(ByVal ColIndex As Short) As Single
VBWidth = object.ColumnWidth(ByVal ColIndex As Integer) As Single
C#.NETfloat Width = object.get_ColumnWidth(short ColIndex);
VC++float Width = object->ColumnWidth[short ColIndex];
float Width = object->GetColumnWidth(short ColIndex);
CHRESULT object->get_ColumnWidth(short ColIndex, float* Width);

Put

VB.NETobject.set_ColumnWidth(ByVal ColIndex As Short, ByVal Width As Single)
VBobject.ColumnWidth(ByVal ColIndex As Integer) = Width As Single
C#.NETvoid object.set_ColumnWidth(short ColIndex, float Width);
VC++float object->ColumnWidth[short ColIndex] = Width;
void object->PutColumnWidth(short ColIndex, float Width);
CHRESULT object->put_ColumnWidth(short ColIndex, float Width);

object

A SftTree object.

ColIndex

The zero-based column number.

Width

Defines the width of the specified column. The units used depend on the container (Visual Basic, Visual C++, etc.) and the coordinate system used.

Comments

Deprecated - Provided for compatibility with earlier versions only - Use Column.Width instead

The ColumnWidth property defines the width of the specified column.

The column width must be greater or equal to the column's minimum width. The minimum width can be defined using the Column.MinWidth property.

The last column in a tree control may be defined as an open-ended column (see ColumnsObj.OpenEnded). An open-ended column cannot be resized, because an open-ended column doesn't have a defined width. An open-ended column will always use the space remaining between the previous column and the right edge of the tree control window.

Due to the variable number of levels and the resulting hierarchical display, the width of the first column is always treated as a minimum width. The text portion of the first column will always be at least of the specified width, no matter what level the item is on. This can result in the first column being much wider than the defined width. To calculate the actual width of column 0, add the value returned by the ColumnsObj.OverheadWidth property to the value returned by ColumnWidth(0).

When changing column widths, the Items.RecalcHorizontalExtent method may have to be used to recalculate the optimal horizontal scrolling extent.

The Column.OptimalWidth or Column.MakeOptimal methods can be used to calculate or define the optimal width for a column. An optimal width allows all text and graphic components in a column to be displayed in their entirety, without being clipped.

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.