The SFTTREE_VIRTUALDEF structure is used by VirtualInitialize to use the tree control in virtual mode and to define the virtual data source.

typedef struct tagSftTreeVirtualFuncs {
    DWORD version;
    SFTTREE_DWORD_PTR userdataVirtPool;
    LPFNSFTTREE_VGETITEM         lpfnVGetItem;
    LPFNSFTTREE_VRELEASEITEM     lpfnVReleaseItem;
    LPFNSFTTREE_VGETSTATUS       lpfnVGetStatus;
    LPFNSFTTREE_VSETSTATUS       lpfnVSetStatus;
    LPFNSFTTREE_VINDEXTOVISIBLE  lpfnVCvtIndexToVisible;
    LPFNSFTTREE_VVISIBLETOINDEX  lpfnVCvtVisibleToIndex;
    LPFNSFTTREE_VGETPARENTINDEX  lpfnVGetParentIndex;
    LPFNSFTTREE_VGETNEXTSIBLING  lpfnVGetNextSibling;
    LPFNSFTTREE_VGETPREVSIBLING  lpfnVGetPrevSibling;
    LPFNSFTTREE_VGETFIRSTSIBLING lpfnVGetFirstSibling;
    LPFNSFTTREE_VGETLASTSIBLING  lpfnVGetLastSibling;
    LPFNSFTTREE_VGETITEM_EX      lpfnVGetItemEx;
    LPFNSFTTREE_VRELEASEITEM_EX  lpfnVReleaseItemEx;
    SFTTREE_DWORD_PTR res4, res5, res6;
} SFTTREE_VIRTUALDEF, * LPSFTTREE_VIRTUALDEF;

typedef const SFTTREE_VIRTUALDEF * LPCSFTTREE_VIRTUALDEF;

Members

version

The SftTree/DLL version expected by the application.  This value must be set to SFTTREE_VERSION_700, otherwise the call to VirtualInitialize will fail (SFTTREE_VERSION_400, SFTTREE_VERSION_450, SFTTREE_VERSION_500, SFTTREE_VERSION_600 and SFTTREE_VERSION_650 are still accepted as the current version is upward compatible).  This version field will be used by future versions of SftTree/DLL to provide upward compatibility for applications designed for earlier versions.

userdataVirtPool

An application defined value.  May be 0.  This value is used as userData parameter in the callback functions SFTTREE_VGETITEM, SFTTREE_VRELEASEITEM, etc.  The value defined here can also be retrieved using GetVirtualUserData.

lpfnVGetItem

A pointer to a callback function SFTTREE_VGETITEM.  This function is called by SftTree/DLL to retrieve item information.

lpfnVReleaseItem

A pointer to a callback function SFTTREE_VRELEASEITEM.  This function is called by SftTree/DLL to release item information previously retrieved using SFTTREE_VGETITEM.

lpfnVGetStatus, lpfnVSetStatus, lpfnVCvtIndexToVisible, , lpfnVCvtVisibleToIndex, lpfnVGetParentIndex, lpfnVGetNextSibling, lpfnVGetPrevSibling, lpfnVGetFirstSibling, lpfnVGetLastSibling, lpfnVGetItemEx, lpfnVReleaseItemEx, res4, res5, res6

These fields must be set to NULL and are reserved for future use.

Comments

The SFTTREE_VIRTUALDEF structure is used by VirtualInitialize to use the tree control in virtual mode and to define the virtual data source.

All fields marked "reserved for future use" must be initialized to 0 or NULL to insure compatibility with future releases of SftTree/DLL.

SftTree/DLL supports "flat" lists only in virtual mode.  Hierarchies cannot be represented in virtual mode. 

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