SftTree/DLL 7.5 - Tree Control

SFTTREE_OBSOLETE_4 Preprocessor Symbol

The SFTTREE_OBSOLETE_4 preprocessor symbol is used to indicate compatibility with SftTree/DLL 4.0 (and older).

#define SFTTREE_OBSOLETE_4

Comments

The SFTTREE_OBSOLETE_4 preprocessor symbol is used to indicate compatibility with SftTree/DLL 4.0 (and older).

Starting with SftTree/DLL 4.5, a number of structure members and API functions, which only accepted bitmap handles, have been replaced with the new SFT_PICTURE type which supports various pictures, such as bitmaps, icons, GDI+ images and ImageLists, etc.

If "bitmap only" features are used, compile errors will result, alerting you to the fact that an obsolete feature is used:

• SFTTREE_CELL structure - cell bitmap - the hBmp member is now called CellPicture1
• SFTTREE_ROW structure - row header bitmap - the hBmp member is now called RowPicture1
• SFTTREE_COLUMN_EX structure - column header bitmap - the hBmp member is now called Picture1
• SFTTREE_ITEM - virtual mode - the hLabel and hItem members are now called ItemPicture and LabelPicture

The preprocessor symbol SFTTREE_OBSOLETE_4 can be used to make these old structure members accessible to applications, so no conversion is required. By defining this symbol (using #define SFTTREE_OBSOLETE_4) these structure members can be used as in earlier releases. At the same time you can also use the new SFT_PICTURE type. Once you are ready to use the new SFT_PICTURE type throughout, simply remove SFTTREE_OBSOLETE_4.

At the same time, without defining SFTTREE_OBSOLETE_4, any use of the bitmap members will cause a compile error. While you are encouraged to convert to the new SFT_PICTURE structure, this is not required as long as you define SFTTREE_OBSOLETE_4.

For additional information see "Upgrading from SftTree/DLL 4.0".

See Also C/C++ API | Categories | Notifications