SftTree/DLL 7.5 - Tree Control

ForwardChildMsgs

Defines the child window message handling status.

C

BOOL WINAPI SftTree_GetForwardChildMsgs(HWND hwndCtl);
void WINAPI SftTree_SetForwardChildMsgs(HWND hwndCtl, BOOL fSet);
BOOL WINAPI SftTreeSplit_GetForwardChildMsgs(HWND hwndCtl);
void WINAPI SftTreeSplit_SetForwardChildMsgs(HWND hwndCtl, BOOL fSet);

C++

BOOL CSftTree::GetForwardChildMsgs() const;
void CSftTree::SetForwardChildMsgs(BOOL fSet);
BOOL CSftTreeSplit::GetForwardChildMsgs() const;
void CSftTreeSplit::SetForwardChildMsgs(BOOL fSet);

Parameters

hwndCtl

The window handle of the tree control.

fSet

Set to TRUE so messages received for a tree control's child windows are forwarded to the tree control's parent window, otherwise set to FALSE.

Returns

GetForwardChildMsgs returns TRUE if messages for a child window are forwarded to the tree control's parent window, otherwise FALSE is returned.

Comments

The GetForwardChildMsgs and SetForwardChildMsgs functions define the child window message handling status.

Child windows can be created by an application and attached to a tree control by specifying the tree control as the owner of the child window. Child controls created in this manner are usually used for cell editing.

Child window messages are normally forwarded to the parent window of the tree control, so an application can implement all event handlers in the parent window.

If an application handles child control messages by subclassing the control or in a derived C++ class (which implicitly subclasses the window), these child messages need not be forwarded to the tree control's parent window. SetForwardChildMsgs can be used to suppress messages to be sent to the parent window, eliminating some of the overhead.

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