Defines an application-supplied owner-draw function, which is called whenever an object needs to be rendered.

C

BOOL WINAPI SftTree_SetOwnerDrawCallback(HWND hwndCtl, LPCSFTTREE_OWNERDRAWPARM lpDrawInfo);
BOOL WINAPI SftTreeSplit_SetOwnerDrawCallback(HWND hwndCtl, LPCSFTTREE_OWNERDRAWPARM lpDrawInfo);

C++

BOOL CSftTree::SetOwnerDrawCallback(LPCSFTTREE_OWNERDRAWPARM lpDrawInfo);
BOOL CSftTreeSplit::SetOwnerDrawCallback(LPCSFTTREE_OWNERDRAWPARM lpDrawInfo);

Parameters

hwndCtl

The window handle of the tree control.

lpDrawInfo

A pointer to a SFTTREE_OWNERDRAWPARM structure containing the parameters for this function to register a callback function and user supplied data.  This parameter may be NULL to stop using the callback function.  The SFTTREE_OWNERDRAWPARM structure contains the following members:

LPFNSFTTREE_OWNERDRAWPROC lpfnOwnerDrawProc	A user supplied routine which is called every time an object needs to be rendered.
SFTTREE_DWORD_PTR OwnerDrawUserData	User supplied, application-specific data.

Returns

The return value is TRUE if the function was successful, otherwise FALSE if an error occurred.

Comments

The SetOwnerDrawCallback function defines an application-supplied owner-draw function, which is called whenever an object needs to be rendered.

The callback receives control when an object needs to be rendered.  The callback can then perform application specific rendering of the object.  An application can render cells, cell ToolTips, row headers, column headers and row/column headers using the owner-draw function.

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