Defines the grid line display style.

C

int WINAPI SftTree_GetGridStyle(HWND hwndCtl);
void WINAPI SftTree_SetGridStyle(HWND hwndCtl, int style);
int WINAPI SftTreeSplit_GetGridStyle(HWND hwndCtl);
void WINAPI SftTreeSplit_SetGridStyle(HWND hwndCtl, int style);

C++

int CSftTree::GetGridStyle() const;
void CSftTree::SetGridStyle(int type = SFTTREE_GRID_VERT);
int CSftTreeSplit::GetGridStyle() const;
void CSftTreeSplit::SetGridStyle(int type = SFTTREE_GRID_VERT);

Parameters

hwndCtl

The window handle of the tree control.

style

A value describing the grid lines displayed.

SFTTREE_GRID_VERT	Vertical grid lines are drawn around columns using a solid line.
SFTTREE_GRID_HORZ	Horizontal grid lines are drawn around items using a solid line.
SFTTREE_GRID_BOTH	Vertical and horizontal grid lines are drawn using a solid line.
SFTTREE_GRID_VERT_DOT	Vertical grid lines are drawn around columns using a dotted line.
SFTTREE_GRID_HORZ_DOT	Horizontal grid lines are drawn around items using a dotted line.
SFTTREE_GRID_BOTH_DOT	Vertical and horizontal grid lines are drawn using a dotted line.

Returns

GetGridStyle returns the current grid line display style.

Comments

The GetGridStyle and SetGridStyle functions define the grid line display style.

The color used for grid lines can be defined using SFTTREE_COLORS, colorGridVert and colorGridHorz.

If grid lines are not shown (see SetShowGrid), this function has no effect.

Horizontal grid lines are not drawn if items are drawn using a 3D display method (see SetShow3D).

Vertical grid lines are not drawn if all column headers have no header text (except for the first column) and all cells are marked for cell merging, in which case all cells are handled as one (visually) contiguous cell, even if each cell has individual cell text.

When printing or previewing the tree control contents using SftPrintPreview/DLL, solid grid lines are used, even if dotted grid lines are defined using SFTTREE_GRID_VERT_DOT, SFTTREE_GRID_HORZ_DOT or SFTTREE_GRID_BOTH_DOT.

Windows Mobile Edition:  Dotted grid lines are not supported.  Solid grid lines are used instead. 

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