SftTree/DLL 6.5

TreeLineStyle

Softel vdm, Inc.

Defines the display style of tree lines.

C

int WINAPI SftTree_GetTreeLineStyle(HWND hwndCtl);
void WINAPI SftTree_SetTreeLineStyle(HWND hwndCtl, int style);
int WINAPI SftTreeSplit_GetTreeLineStyle(HWND hwndCtl);
void WINAPI SftTreeSplit_SetTreeLineStyle(HWND hwndCtl, int style);

C++

int CSftTree::GetTreeLineStyle() const;
void CSftTree::SetTreeLineStyle(int style);
int CSftTreeSplit::GetTreeLineStyle() const;
void CSftTreeSplit::SetTreeLineStyle(int style);

Parameters

hwndCtl

The window handle of the tree control.

style

Defines the display style used for selected items. Style can be one of the following values:

SFTTREE_TREELINE_NONE

No tree lines.

SFTTREE_TREELINE_SOLID

Tree lines are drawn using a solid line.  Items on level 1 and lower are connected to items on level 0. Items on level 0 are not connected to each other.

SFTTREE_TREELINE_DOT

Tree lines are drawn using a dotted line.  Items on level 1 and lower are connected to items on level 0. Items on level 0 are not connected to each other.

SFTTREE_TREELINE_DOT0

Tree lines are drawn using a dotted line.  Items on level 1 and lower are connected to items on level 0. Items on level 0 are also connected to each other.

SFTTREE_TREELINE_TRANSPARENT

Connecting tree lines are not shown, but all layout and formatting is calculated as if they were present. This only affects the horizontal indentation of levels.

SFTTREE_TREELINE_AUTOMATIC

The value is translated to SFTTREE_TREELINE_DOT or SFTTREE_TREELINE_TRANSPARENT depending on the operating system used. On Windows 98, ME, 2000, connecting dotted tree lines are shown between items on levels 1 and lower (using SFTTREE_TREELINE_DOT). On Windows XP and above, connecting dotted tree lines are not shown (using SFTTREE_TREELINE_TRANSPARENT).

SFTTREE_TREELINE_AUTOMATIC0

The value is translated to SFTTREE_TREELINE_DOT0 or SFTTREE_TREELINE_TRANSPARENT depending on the operating system used. On Windows 98, ME, 2000, connecting dotted tree lines are shown between all items (using SFTTREE_TREELINE_DOT0). On Windows XP and above, connecting dotted tree lines are not shown (using SFTTREE_TREELINE_TRANSPARENT).

Returns

GetTreeLineStyle returns a value indicating the current display style used for tree lines.

Comments

The GetTreeLineStyle and SetTreeLineStyle functions define the display style of tree lines.

The color used for tree lines can be defined using SFTTREE_COLORS, colorTreeLines.

When printing or previewing the tree control contents using SftPrintPreview/DLL, solid tree lines are used, even if dotted tree lines are defined using SFTTREE_TREELINE_DOT or SFTTREE_TREELINE_DOT0.

Information specific to SftTree/DLL Windows Mobile EditionWindows Mobile Edition:  Dotted tree lines are not supported.  Solid tree lines are used instead. 

See Also  C/C++ API  |  CategoriesNotifications

 


Feedback / comments / error reports for this topic
© 2009 - Softel vdm, Inc. - www.softelvdm.com