|
|
|
SFTTREE_OBSOLETE_4 |
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.
See Also C/C++ API | Categories | Notifications