Defines the type of the virtual data source callback called by SftBox/DLL to release information previously returned by the LPFNSFTBOX_VGETITEM callback.
typedef void (CALLBACK* LPFNSFTBOX_VRELEASEITEM)(HWND hwnd, SFTBOX_DWORD_PTR userData, int totCols, LONG index, LPSFTBOX_ITEM lpItem);
hwnd
The window handle of the combo box control.
userData
An application-specific value, as supplied in the call to VirtualInitialize using the SFTBOX_VIRTUALDEF structure member userdataVirtPool.
totCols
The total number of columns that was passed to the LPFNSFTBOX_VGETITEM callback when the item was retrieved.
index
The zero-based index of the item to be released.
lpItem
A pointer to the SFTBOX_ITEM structure returned by the preceding call to the LPFNSFTBOX_VGETITEM callback.
LPFNSFTBOX_VRELEASEITEM defines the type of the callback function addressed by the SFTBOX_VIRTUALDEF structure member lpfnVReleaseItem.
This callback is only used if a virtual data source has been defined using VirtualInitialize. If items are added using AddString or InsertString, the callback is not used.
SftBox/DLL always calls the LPFNSFTBOX_VRELEASEITEM callback for the item last retrieved before calling the LPFNSFTBOX_VGETITEM callback for another item. The callback can free any memory that was dynamically allocated by the LPFNSFTBOX_VGETITEM callback for the item. All memory is managed by the application; no memory is allocated or freed by SftBox/DLL.
This callback cannot modify the contents of the combo box control in any way. Changing the total number of items (see VirtualCount) is not possible while the callback is called.
See Also C/C++ API | Categories | Notifications