Hide

SftTree/OCX 7.5 - ActiveX Tree Control

Display
Print

Converting To Version 7.5

If you are upgrading from version 5.0 (or newer), this topic does not apply. This topic documents changes introduced with version 5.0 and is applicable only if you are upgrading from version 4.5 (or older). SftTree/OCX 5.0 and newer versions introduce many new objects, which simplify use of the control by using multiple objects instead of a single object model.

All methods and properties (even those marked "Deprecated") are still available, so it is not necessary to convert to the new object model and pre-5.0 applications can easily upgrade to 7.5 without conversion. The new object model is however recommended for any new development.

The SftTree object represents the control. Through this object, other objects can be accessed which describe individual parts of the control. For example, the SftTreeItem object represents an individual item and its attributes. For a complete list of all available objects, please see "Object Hierarchy".

To eliminate any conversion process, SftTree/OCX 7.5 still supports the "flat" object model used by earlier versions of the product. The documentation also continues to document all methods and properties, but some are marked as "Deprecated". These should no longer be used for new development and the new "object oriented" form should be used instead.

The following is a complete list of deprecated methods and properties. You are encouraged to use the new form instead:

Old Form
(SftTree/OCX 4.5 and older)
New Form
(SftTree/OCX 5.0 and newer)
AddItemItems.Add
BackColorItems.BackColor
BackColorOddItems.BackColorOdd
CalcLimitItems.CalcLimit
CalcOptimalColumnWidthColumn.OptimalWidth
CalcOptimalRowHeaderWidthRowHeaders.OptimalWidth
Cell3DItems.Cell3D
CellBackColorCell.BackColor
CellEditLimit 1)See Cell Editing
CellEditStyle 1)See Cell Editing
CellEventHandling 1)See Cell Editing
CellForeColorCell.ForeColor
CellFontCell.Font
CellItemDataCell.Data
CellItemDataStringCell.DataString
CellPictureCell.Image.Picture
CellPictureAlignCell.ImageHAlign
Cell.ImageVAlign
CellPictureHCell.Image.PictureH
CellSelectBackColorCell.SelectBackColor
CellSelectForeColorCell.SelectForeColor
CellTextCell.Text
CellTextAlignCell.TextHAlign
Cell.TextVAlign
CharSearchColumnItems.CharSearchColumn
CharSearchModeItems.CharSearchMode
ClearItems.Clear
ClearCellPicturesItems.ClearCellImages
ClearItemPicturesItems.ClearItemImages
ClearLabelPicturesItems.ClearLabelImages
ClearRowHeaderPicturesRowHeaders.ClearImages
ColHeaderAppearanceHeaders.Appearance
ColHeaderBackColorHeaders.BackColor
ColHeaderButtonHeaders.Pressed
ColHeaderEnabledHeader.Enabled
ColHeaderFontHeaders.Font
ColHeaderBackColorHeaders.BackColor
ColHeaderForeColorHeaders.ForeColor
ColHeaderGrayedColorHeaders.GrayedColor
ColHeaderHilightColorHeaders.HilightColor
ColHeaderShadowColorHeaders.ShadowColor
CollapseItem.Collapse
Items.Collapse
ColumnBackColorColumn.BackColor
ColumnButtonRemainUpHeader.RemainUp
ColumnForeColorColumn.ForeColor
ColumnMinWidthColumn.MinWidth
ColumnPictureHeader.Image.Picture
ColumnPictureAlignHeader.ImageHAlign
Header.ImageVAlign
ColumnPictureHHeader.Image.PictureH
ColumnsColumnsObj.Count
ColumnSelectBackColorColumn.SelectBackColor
ColumnSelectForeColorColumn.SelectForeColor
ColumnStyleColumn.CellHAlign
Column.CellVAlign
Column.CellMultiline
Column.ToolTip
Column.CellWordWrap
Header.Locked
Header.KeepPosition
Column.Merge
Column.MergeInto
ColumnTextHeader.Text
ColumnTextStyleHeader.TextHAlign
Header.TextVAlign
ColumnWidthColumn.Width
CopyItemItems.Copy
CopyItemDataStringn/a
CopyItemsItems.Copy
CrossColumnResizeHeaders.Resizable
DeleteDependentsItem.DeleteDependents
DependentCountItem.DependentCount
Item.DependentAllCount
DisplayColumnColumn.DisplayPosition
ColumnsObj.DisplayPosition
DropHighlightItems.DropHighlight
DropHighlightColorItems.DropHighlightColor
DropHighlightStyleItems.DropHighlightStyle
ExpandItem.Expand
Items.Expand
FindItemDataItems.FindData
FindItemDataStringItems.FindDataString
FindStringItems.FindCellText
FindStringExactItems.FindCellTextExact
FirstDependentItem.FirstDependent
FirstDisplayColumnColumnsObj.FirstDisplayColumn
FirstDisplayColumn2ColumnsObj.FirstDisplayColumn2
FirstSiblingItem.FirstSibling
FlybyHighlightItems.FlybyHighlightStyle
ForeColorItems.ForeColor
ForeColorOddItems.ForeColorOdd
GetCellColorSampleCell.Image.GetColorSample
GetCellEditSelection 1)See Cell Editing
GetCellPictureImageCell.Image.GetImageList
GetCellPicturePosCell.GetImagePosition
GetCellPicturePosPixCell.GetImagePositionPix
GetCellPosCell.GetPosition
GetCellPosPixCell.GetPositionPix
GetCellTextPosCell.GetTextPosition
GetCellTextPosPixCell.GetTextPositionPix
GetHeaderPosHeader.GetPosition
Headers.GetPosition
GetHeaderPosPixHeader.GetPositionPix
Headers.GetPositionPix
GetItemPictureImageItem.Image.GetImageList
GetItemPosItem.GetPosition
GetItemPosPixItem.GetPositionPix
GetNextShownItems.FirstShown
Item.NextShown
GetPrevShownItems.LastShown
Item.PrevShown
GetSplitterPosSplitter.GetPosition
GetSplitterPosPixSplitter.GetPositionPix
GrayedColorItems.GrayedColor
GridHorizontalColorItems.GridHorizontalColor
GridStyleItems.GridStyle
GridVerticalColorItems.GridVerticalColor
HilightColorItems.HilightColor
HitTestItems.HitTest
HitTestPixItems.HitTestPix
HorizontalExtentItems.HorizontalExtent
HorizontalExtent2Items.HorizontalExtent2
HorizontalOffsetItems.HorizontalOffset
HorizontalOffset2Items.HorizontalOffset2
InheritBgColorColumnsObj.InheritBgColor
InsertItemItems.Insert
IntegralHeightMakeIntegralHeight
ItemDataItem.Data
ItemDataFloatItem.DataFloat
ItemDataObjectItem.DataObject
ItemDataStringItem.DataString
ItemDataTagItem.DataTag
ItemEditFont 1)See Cell Editing
ItemExpandItem.Expanded
ItemExpandableItem.Expandable
ItemExpandAllItem.Collapse
Item.Expand
ItemHeightItem.Height
Items.Height
ItemHeight1Item.Height
Items.Height
ItemIDItem.ID
ItemIndexItems.ItemIndex
ItemLevelItem.Level
ItemLinesItems.Lines
ItemPictureItem.Image.Picture
ItemPictureAlignItems.ItemImageAlign
ItemPictureExpandableItems.ItemImageExpandable.Picture
ItemPictureExpandableHItems.ItemImageExpandable.PictureH
ItemPictureExpandedItems.ItemImageExpanded.Picture
ItemPictureExpandedHItems.ItemImageExpanded.PictureH
ItemPictureHItem.Image.PictureH
ItemPictureLeafItems.ItemImageLeaf.Picture
ItemPictureLeafHItems.ItemImageLeaf.PictureH
ItemShownItem.Shown
ItemsShownItems.Shown
ItemsShownCompleteItems.ShownComplete
ItemStatusItem.Enabled
ItemStyleItems.Style
LabelPictureItem.LabelImage.Picture
LabelPictureHItem.LabelImage.PictureH
LastDependentItem.LastDependent
LastDisplayColumnColumnsObj.LastDisplayColumn
LastDisplayColumn2ColumnsObj.LastDisplayColumn2
LastSiblingItem.LastSibling
LeftWindowSplitter.LeftWindow
ListCell.Text
ListCountItems.Count
ListIndexItems.Current
ListSelectionItems.Selection
ListSelection1Items.Selection
MakeCellVisibleCell.MakeVisible
MakeColumnOptimalColumn.MakeOptimal
ColumnsObj.MakeOptimal
MakeColumnVisibleColumn.MakeVisible
MakeRowHeaderOptimalRowHeaders.MakeOptimal
MakeRowVisibleItem.MakeVisible
MakeSplitterOptimalSplitter.MakeOptimal
MoveColumnColumnsObj.Move
MoveItemItems.Move
MoveItemsItems.Move
MultilineHeaderHeaders.Multiline
MultiSelectItems.MultiSelect
NextSiblingItem.NextSibling
NoFocusStyleItems.NoFocusStyle
NoSelectionItems.SelectionArea
OpenEndedColumnsObj.OpenEnded
OpenEnded2ColumnsObj.OpenEnded2
OverheadWidthColumnsObj.OverheadWidth
ParentItem.Parent
PlusMinusPictureExpandableItems.PlusMinusImageExpandable
PlusMinusPictureExpandableHItems.PlusMinusImageExpandable.PictureH
PlusMinusPictureExpandedItems.PlusMinusImageExpanded
PlusMinusPictureExpandedHItems.PlusMinusImageExpanded.PictureH
PlusMinusPictureLeafItems.PlusMinusImageLeaf
PlusMinusPictureLeafHItems.PlusMinusImageLeaf.PictureH
PostEditEditEnded
PrevSiblingItem.PrevSibling
RealColumnColumnsObj.ColumnIndex
RecalcHorizontalExtentItems.RecalcHorizontalExtent
RemoveItemItems.Remove
ReorderColumnsHeaders.Reorderable
ResizeColumnHeaders.ResizeColumn
ResizeHeaderHeaders.Resizable
RightWindowSplitter.RightWindow
RowBackColorRowHeader.BackColor
RowColButtonDownRowColumnHeader.ButtonDown
RowColButtonRemainUpRowColumnHeader.RemainUp
RowColHeaderAppearanceRowColumnHeader.Appearance
RowColHeaderBackColorRowColumnHeader.BackColor
RowColHeaderEnabledRowColumnHeader.Enabled
RowColHeaderForeColorRowColumnHeader.ForeColor
RowColHeaderGrayedColorRowColumnHeader.GrayedColor
RowColHeaderHilightColorRowColumnHeader.HilightColor
RowColHeaderShadowColorRowColumnHeader.ShadowColor
RowColPictureRowColumnHeader.Image.Picture
RowColPictureHRowColumnHeader.Image.PictureH
RowColPictureAlignRowColumnHeader.ImageHAlign
RowColumnHeader.ImageVAlign
RowColTextRowColumnHeader.Text
RowColTextStyleRowColumnHeader.TextHAlign
RowColumnHeader.TextVAlign
RowForeColorRowHeader.ForeColor
RowHeaderAppearanceRowHeaders.Appearance
RowHeaderBackColorRowHeaders.BackColor
RowHeaderButtonRemainUpRowHeaders.RemainUp
RowHeaderEnabledRowHeaders.Enabled
RowHeaderFontRowHeaders.Font
RowHeaderForeColorRowHeaders.ForeColor
RowHeaderGrayedColorRowHeaders.GrayedColor
RowHeaderHilightColorRowHeaders.HilightColor
RowHeaderLinesRowHeaders.Lines
RowHeaderSelectBackColorRowHeaders.SelectBackColor
RowHeaderSelectForeColorRowHeaders.SelectForeColor
RowHeaderShadowColorRowHeaders.ShadowColor
RowHeaderTextStyleRowHeaders.TextHAlign
RowHeaders.TextVAlign
RowHeaderWidthRowHeaders.Width
RowPictureRowHeader.Image.Picture
RowPictureHRowHeader.Image.PictureH
RowPictureAlignRowHeader.ImageHAlign
RowHeader.ImageVAlign
RowSelectBackColorRowHeader.SelectBackColor
RowSelectForeColorRowHeader.SelectForeColor
RowTextRowHeader.Text
RowTextAlignRowHeader.TextHAlign
RowHeader.TextVAlign
ScrollTipsItems.ScrollTips
SelCountItems.SelectionCount
SelectBackColorItems.SelectBackColor
SelectBackColorNoFocusItems.SelectBackColorNoFocus
SelectedItem.Selected
SelectForeColorItems.SelectForeColor
SelectForeColorNoFocusItems.SelectForeColorNoFocus
SelectionAreaItems.SelectionArea
SelectionGroupEndItems.SelectionGroupEnd
SelectionGroupsItems.SelectionGroups
SelectionGroupStartItems.SelectionGroupStart
SelectRangeItems.SelectRange
SelectStyleItems.SelectStyle
SetCellColorSampleCell.Image.SetColorSample
SetCellEditSelection 1)See Cell Editing
SetCellPictureImageCell.Image.SetImageList
SetItemPictureImageItem.Image.SetImageList
ShadowColorItems.ShadowColor
ShowFocusRectangleItems.ShowFocusRectangle
SortDependentsItems.SortDependents
SplitColumnSplitter.Column
SplitterBarSplitter.Visible
SplitterOffsetSplitter.Offset
SplitterResizeModeSplitter.ResizeMode
SplitterWidthSplitter.WidthPix
StartCombo 1)See Cell Editing
StartComboEdit 1)See Cell Editing
StartEdit 1)See Cell Editing
ToolTipAlwaysItems.ToolTipAlways
ToolTipBackColorItems.ToolTipBackColor
ToolTipForeColorItems.ToolTipForeColor
ToolTipsUseEntireCellItems.ToolTipsUseEntireCell
TopIndexItems.TopIndex
TopParentItem.TopParent
TreeLineColorItems.TreeLineColor
TreeLineGrayedColorItems.TreeLineGrayedColor
TreeLineStyleItems.TreeLineStyle
VirtualItem.CellBackColorVirtualItem.Item.Cell.BackColor
VirtualItem.CellFontVirtualItem.Item.Cell.Font
VirtualItem.CellForeColorVirtualItem.Item.Cell.ForeColor
VirtualItem.CellPictureVirtualItem.Item.Cell.Image.Picture
VirtualItem.CellPictureAlignVirtualItem.Item.Cell.ImageHAlign
VirtualItem.Item.Cell.ImageVAlign
VirtualItem.CellPictureHVirtualItem.Item.Cell.Image.PictureH
VirtualItem.CellSelectBackColorVirtualItem.Item.Cell.SelectBackColor
VirtualItem.CellSelectForeColorVirtualItem.Item.Cell.SelectForeColor
VirtualItem.CellTextVirtualItem.Item.Cell.Text
VirtualItem.CellTextAlignVirtualItem.Item.Cell.TextHAlign
VirtualItem.Item.Cell.TextVAlign
VirtualItem.ColumnCountColumnsObj.Count
VirtualItem.EnabledVirtualItem.Item.Enabled
VirtualItem.ItemDataVirtualItem.Item.Data
VirtualItem.ItemDataFloatVirtualItem.Item.DataFloat
VirtualItem.ItemDataObjectVirtualItem.Item.DataObject
VirtualItem.ItemDataStringVirtualItem.Item.DataString
VirtualItem.ItemDataTagVirtualItem.Item.DataTag
VirtualItem.ItemIDVirtualItem.Item.ID
VirtualItem.ItemPictureVirtualItem.Item.Image.Picture
VirtualItem.ItemPictureHVirtualItem.Item.Image.PictureH
VirtualItem.LabelPictureVirtualItem.Item.LabelImage.Picture
VirtualItem.LabelPictureHVirtualItem.Item.LabelImage.PictureH
VirtualItem.RowBackColorVirtualItem.Item.RowHeader.BackColor
VirtualItem.RowForeColorVirtualItem.Item.RowHeader.ForeColor
VirtualItem.RowIndexVirtualItem.Item.ItemIndex
VirtualItem.RowPictureVirtualItem.Item.RowHeader.Image.Picture
VirtualItem.RowPictureAlignVirtualItem.Item.RowHeader.ImageHAlign
VirtualItem.Item.RowHeader.ImageVAlign
VirtualItem.RowPictureHVirtualItem.Item.RowHeader.Image.PictureH
VirtualItem.RowSelectBackColorVirtualItem.Item.RowHeader.SelectBackColor
VirtualItem.RowSelectForeColorVirtualItem.Item.RowHeader.SelectForeColor
VirtualItem.RowTextVirtualItem.Item.RowHeader.Text
VirtualItem.RowTextAlignVirtualItem.Item.RowHeader.TextHAlign
VirtualItem.Item.RowHeader.TextVAlign
VirtualItem.SetCellColorSampleVirtualItem.Item.Cell.Image.SetColorSample
VirtualItem.SetCellPictureImageVirtualItem.Item.Cell.Image.SetImageList
VirtualItem.SetItemPictureImageVirtualItem.Item.Image.SetImageList
VirtualPicturesVirtualImageSizes

1) These methods and properties continue to be used with Internet Explorer as it does not support the new cell editing mechanisms introduced with SftTree/OCX 5.0.

See Also 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.