RubberbandSelection
Defines whether click-drag selection of multiple items using a selection rectangle is supported.
C
BOOL WINAPI SftTree_GetRubberbandSelection(HWND hwndCtl);
void WINAPI SftTree_SetRubberbandSelection(HWND hwndCtl, BOOL fSet);
BOOL WINAPI SftTreeSplit_GetRubberbandSelection(HWND hwndCtl);
void WINAPI SftTreeSplit_SetRubberbandSelection(HWND hwndCtl, BOOL fSet);
C++
BOOL CSftTree::GetRubberbandSelection() const;
void CSftTree::SetRubberbandSelection(BOOL fSet = TRUE);
BOOL CSftTreeSplit::GetRubberbandSelection() const;
void CSftTreeSplit::SetRubberbandSelection(BOOL fSet = TRUE);
Parameters
hwndCtl
The window handle of the tree control.
fSet
Set to TRUE to enable click-drag selection of multiple items using a selection rectangle, FALSE otherwise.
Returns
GetRubberbandSelection returns TRUE if click-drag selection of multiple items using a selection rectangle is enabled. Otherwise, FALSE is returned.
Comments
The GetRubberbandSelection and SetRubberbandSelection functions define whether click-drag selection of multiple items using a selection rectangle is supported.
In a single selection this property has no effect. Click-drag selection is only available in a multiple selection tree control and only if SelectionStyle is set to SFTTREE_SELECTION_CELL1FULL, SFTTREE_SELECTION_CELL1 or SFTTREE_SELECTION_CELLCURRENT. If SelectionStyle is set to SFTTREE_SELECTION_CELLCURRENT, click-dragging cannot start in the first column, it must be initiated from another column.
Click-drag selection with a "rubberband" selection rectangle can be initiated by pressing the mouse button on the background (not the ) of a and dragging the mouse cursor. All items between the starting and ending point are selected. If the mouse cursor approaches the edge of the tree control, scrolling will start, allowing selection of additional items. Once the mouse button is released, the currently selected items remain selected.
See Also C/C++ API | Categories | Notifications
On
Off