SftTree/DLL 7.0 - New Features

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).

SftTree/DLL 7.0 is virtually 100% upward compatible from version 6.5 and earlier versions. The following major enhancements have been made available with SftTree/DLL 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:

• 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.