SftTree/DLL 7.5 - Tree Control

New Features

SftTree/DLL 7.5 is virtually 100% upward compatible from version 7.0 and earlier versions. The following major enhancements have been made available with SftTree/DLL 7.5:

• SftTree/DLL 7.5 no longer provides help documentation integrated with development tools in various custom formats - instead documentation is located at https://softelvdm.com/Documentation/SftTree DLL 7 5, which allows for continuous documentation updates without the need to release a new product version. Web access is required to access the product documentation.
• New built-in column sort indicators.
• New column header dropdown/filter buttons.
• New column footer dropdown/filter buttons.
• New EnableSortIndicators function to enable built-in header sort indicators, typically used for column sorting.
• New GetDisplayFooterDropDownRect function to retrieve the position of a footer dropdown button.
• New GetDisplayHeaderDropDownRect function to retrieve the position of a footer dropdown button.
• New GetFlybyIndex function to retrieve to index of the current target item of flyby highlighting.
• New GetSortColumn1 function to retrieve the current sort selection.
• New GetSortIndicator function to retrieve the current sort selection of a specific column.
• New ResetSortIndicators function to clear all sort indicators.
• New SetSortIndicator function to set the current sort selection of a specific column.
• New SFTTREEN_FLYBYHIGHLIGHT notification indicating that the item highlighted by flyby highlighting has changed.
• New SFTTREEN_LBUTTONDOWN_COLUMN_HEADERDD, SFTTREEN_MBUTTONDOWN_COLUMN_HEADERDD, SFTTREEN_RBUTTONDOWN_COLUMN_HEADERDD notifications indicating that a header dropdown button has been clicked.
• New SFTTREEN_LBUTTONDBLCLK_COLUMN_HEADERDD, SFTTREEN_MBUTTONDBLCLK_COLUMN_HEADERDD, SFTTREEN_RBUTTONDBLCLK_COLUMN_HEADERDD notifications indicating that a header dropdown button has been double-clicked.
• New SFTTREEN_LBUTTONDOWN_COLUMN_FOOTERDD, SFTTREEN_MBUTTONDOWN_COLUMN_FOOTERDD, SFTTREEN_RBUTTONDOWN_COLUMN_FOOTERDD notifications indicating that a footer dropdown button has been clicked.
• New SFTTREEN_LBUTTONDBLCLK_COLUMN_FOOTERDD, SFTTREEN_MBUTTONDBLCLK_COLUMN_FOOTERDD, SFTTREEN_RBUTTONDBLCLK_COLUMN_FOOTERDD notifications indicating that a footer dropdown button has been double-clicked.

The following enhancements were made available in version 7.0:

• The maximum level number has been increased to 100 (SFTTREE_MAXLEVELS).
• The SFTTREEN_MOUSEENTER and SFTTREEN_MOUSELEAVE notifications occur when the mouse cursor enters/leaves the tree control window.
• The SFTTREE_TOOLTIPSPROC structure has been expanded to support column footers ToolTips.
• The color of vertical and horizontal edges around headers and footers can now be defined (see SFTTREE_COLORS, colorEdgeVertical and colorEdgeHorizontal).
• The SetControlInfo function can be used to define the delay after which a collapsed parent item is automatically expanded (SFTTREE_CONTROL, autoExpandHoverInterval) when AutoExpand is used.
• The SetControlInfo function can be used to define the delay after which a ToolTip is shown and hidden (SFTTREE_CONTROL, toolTipTimeOn and toolTipTimeOff).
• The control now offers column footers and row/column footers.
• New color definitions for column footers and row/column footers (see SFTTREE_COLORS).
• Numerous new notifications to handle column footers and row/column footers interaction (see Notifications).
• The owner-draw structure SFTTREE_OWNERDRAW has been expanded to support column footers and row/column footers.

• The column definition structure SFTTREE_COLUMN_EX has been expanded to support column footer definitions.
• The DisplayFooterRect function returns the dimensions of the column footer area.
• The Footer function is used to define the column footer text.
• The FooterButton function defines the column number of the currently pressed column footer button.
• The FooterFont function defines the font used for column footer text display.
• The FooterLength function returns the length of a column's footer text.
• The FooterRect function returns the dimensions of the column footer area.
• The MultilineFooter function defines whether column footers can display multiple lines of text.
• The ResizeFooter function defines whether column footers are resizable by the user.

• The row/column footer color definitions can override Windows themes (see SFTTREE_CONTROL, fRowColumnFooterColorsOverrideTheme).
• The RowColFooterButton function defines whether the row/column footer button is currently down (pressed).
• The RowColFooterText function is used to define a row/column footer's text.
• The RowColFooterPicture function defines the picture displayed in the row/column footer.
• The RowColFooterPictureStyle function defines the position of the picture displayed in the row/column footer.
• The RowColFooterRect function returns the dimensions of the row/column footer area.
• The RowColFooterStyle function defines the position of the text displayed in the row/column footer.
• The RowColFooterTextLength function returns the row/column footer text length.
• The ShowFooter function defines the presence of column footers.
• The ShowFooterButtons function defines the presence of column footer buttons.

• The RowColHeaderPicture function replaces by the equivalent RowColPicture function to make its intended use with row/column headers more evident.
• The RowColHeaderPictureStyle function replaces by the equivalent RowColPictureStyle function to make its intended use with row/column headers more evident.
• The RowColHeaderText function replaces by the equivalent RowColText function to make its intended use with row/column headers more evident.
• The RowColHeaderTextLength function replaces by the equivalent RowColTextLength function to make its intended use with row/column headers more evident.

The following enhancements were made available in version 6.5:

Windows 98 and Windows ME are no longer supported. For support of these platforms, an older version of SftTree/DLL must be used instead (version 6.0 or earlier).

• Cells can now define a gradient fill as background (see SFTTREE_CELL, colorBgEnd and flag3).
• Cells can now display a progress bar (see SFTTREE_CELL, colorProgress and colorProgressEnd, progressVal, progressMax).
• It is now possible to prevent a user from selecting disabled items (see ItemStatus, SFTTREE_CONTROL fSelectEnabledItemsOnly).
• Individual column headers can now define their own colors and can individually override Windows themes (see SFTTREE_COLUMN_EX, fColorsOverrideTheme).
• The row header color definitions can now override Windows themes (see SFTTREE_CONTROL, fRowHeaderColorsOverrideTheme).
• The row/column header color definitions can now override Windows themes (see SFTTREE_CONTROL, fRowColumnHeaderColorsOverrideTheme).
• Column specific defaults for background colors (gradient fills) and progress bars are now available (see SFTTREE_COLUMN_EX, flag3).
• New FindStringEx function which allows searching of subsets of items, with starting/ending index, levels, etc.
• New CalcOptimalCellDimensions function to determine whether cell contents are truncated.
• GetFlyby and SetFlyby have been replaced by SFTTREE_CONTROL, iFlybyStyle, which now also allows all cells to be underlined.
• New SFTTREEN_COLUMNSIZESTARTED notification indicating that column resizing is starting.
• New SFTTREEN_COLUMNSIZEENDED notification indicating that column resizing has ended.
• SetCellInfo now allows updating attributes of all cells of an item in one operation.
• Deselecting individual items in a multiple selection tree control is now identical to the selection method.
• Default color values for the selection outline are now operating system dependent.