Tree-View Control Extended Styles
This section lists extended styles used when creating tree-view controls. The value of extended styles is a bitwise combination of these styles.
| Constant | Description |
|---|---|
|
Windows Vista. Remove the horizontal scroll bar and auto-scroll depending on mouse position. |
|
Windows Vista. Adds a checkbox on the leftmost side of a given item that contains an icon of a dimmed check mark, that can indicate that a node is selected because its parent is selected. This includes a dimmed checkbox state in addition to 2 normal checkbox states. Do not use it at the same time as the TVS_CHECKBOXES style. See note below. |
|
Windows Vista. Specifies how the background is erased or filled. |
|
Windows Vista. Retrieves calendar grid information. |
|
Windows Vista. Adds a checkbox icon on the leftmost side of a given item that contains a red X. This includes an exclusion checkbox state in addition to 2 normal checkbox states. Do not use it at the same time as the TVS_CHECKBOXES style. See note below. |
|
Windows Vista. Fade expando buttons in or out when the mouse moves away or into a state of hovering over the control. |
|
Not supported. Do not use. |
|
Windows Vista. Do not indent the tree view for the expando buttons. |
| TVS_EX_NOSINGLECOLLAPSE |
Windows Vista. Intended for internal use; not recommended for use in applications. Do not collapse the previously selected tree-view item unless it has the same parent as the new selection. This style must be used with the TVS_SINGLEEXPAND style. Note: This style may not be supported in future versions of Comctl32.dll. Also, this style is not defined in commctrl.h. Add the following definition to the source files of your application to use this style: #define TVS_EX_NOSINGLECOLLAPSE 0x0001 |
|
Windows Vista. Adds a checkbox icon on the leftmost side of a given item with a square in the center, that can indicate that the node is partially selected. This includes a partial checkbox state in addition to 2 normal checkbox states. Do not use it at the same time as the TVS_CHECKBOXES style. See note below. |
|
Windows Vista. Allow rich tooltips in the tree view (custom drawn with icon and text). |
Note on using extended checkbox styles
The tree-view control has a very specific behavior for the checkbox styles. When a specific style or 'EX'-style combination is activated, the control keeps it to the end of its life (which means that you cannot modify the first checkbox style during the life of tree-view control).
To create a tree-view control with any extended checkbox styles, you must initially create the control window without the TVS_CHECKBOXES style and add (after creation) the chosen extended checkbox style by sending the TVM_SETEXTENDEDSTYLE message or by using the TreeView_SetExtendedStyle macro. The extended checkbox style can be any OR combination of TVS_EX_DIMMEDCHECKBOXES, TVS_EX_EXCLUSIONCHECKBOXES, or TVS_EX_PARTIALCHECKBOXES style.
The new tree-view control will provide the 2 normal checkbox states (checked and unchecked) plus 1 to 3 additional states (function of the chosen extended style). The normal states are always coded as 0x1000 and 0x2000, and any additional states are coded with the next values (0x3000, 0x4000, 0x5000). Use TVIS_STATEIMAGEMASK constant (0xF000) as the mask to get or set these states to/from the TVITEM structure.
Requirements
| Requirement | Value |
|---|---|
| Header |
|