RightWindow
Returns the window handle or object of the tree control in the right pane of a split tree control.
C
HWND WINAPI SftTreeSplit_GetRightWindow(HWND hwndCtl);
C++
CSftTree* CSftTreeSplit::GetRightWindow() const;
Parameters
hwndCtl
The window handle of the tree control.
Returns
The return value is the window handle of the tree control in the right pane of a split tree control.
Comments
The GetRightWindow function returns the window handle or object of the tree control in the right pane of a split tree control.
GetRightWindow is only available for a split tree control.
The left and right panes of a split tree control are independent tree controls, which communicate with each other to keep their display styles and data contents synchronized. These tree controls are child windows of the split tree control. While the left and right panes exchange information to keep their display and attributes updated, it is possible to affect each pane individually through the window handle or object.
Each pane of a split tree control uses a tree control (of the window class SFTTREE_CLASS or C++ class CSftTree) to display the requested columns (see SetSplitColumn). Occasionally it may be necessary to manipulate the tree control in a pane directly, rather than the main split tree control (of the window class SFTTREESPLIT_CLASS or class CSftTreeSplit). For example, setting the split tree control's font (using the WM_SETFONT message or CWnd::SetFont) will affect both panes of the split tree control. An application could set different fonts for the two panes by using GetLeftWindow and GetRightWindow and setting the fonts for each pane. Or, an application could turn on for the right pane and turn them off for the left pane. SetShowGrid will affect both panes if used for the split tree control, but using GetLeftWindow and GetRightWindow, the individual panes can be defined with different attributes.
Certain operations on individual panes are possible, but should never be performed. For example, accessing a pane to add or delete items is possible, but will result in unexpected behavior of the split tree control. Or turning off column headers in one pane, but not the other causes misalignment of the items displayed in each pane. In general, directly accessing a pane should rarely be necessary.
See Also C/C++ API | Categories | Notifications
On
Off