SftTree/DLL 7.5 - Tree Control

RowHeaderFont

Defines the font used for row header text display.

C

HFONT WINAPI SftTree_GetRowHeaderFont(HWND hwndCtl);
void WINAPI SftTree_SetRowHeaderFont(HWND hwndCtl, HFONT hfont, BOOL fRedraw);
HFONT WINAPI SftTreeSplit_GetRowHeaderFont(HWND hwndCtl);
void WINAPI SftTreeSplit_SetRowHeaderFont(HWND hwndCtl, HFONT hfont, BOOL fRedraw);

C++

CFont* CSftTree::GetRowHeaderFont() const;
void CSftTree::SetRowHeaderFont(CFont* pFont, BOOL fRedraw = TRUE);
CFont* CSftTreeSplit::GetRowHeaderFont() const;
void CSftTreeSplit::SetRowHeaderFont(CFont* pFont, BOOL fRedraw = TRUE);

Parameters

hwndCtl

The window handle of the tree control.

hfont

The font handle describing the new font to be used to draw the row header text.

pFont

A pointer to a CFont object describing the new font to be used to draw the row header text.

fRedraw

Set to TRUE to cause the tree control to be repainted immediately, otherwise set to FALSE.

Returns

GetRowHeaderFont returns the font used to draw the row header text.

Comments

The GetRowHeaderFont and SetRowHeaderFont functions define the font used for row header text display.

The default font used is the system font (GetStockObject(DEFAULT_GUI_FONT)).

The application retains ownership of the font and cannot delete the font until the tree control no longer uses the font (usually until the tree control is destroyed or the font is changed using SetRowHeaderFont).

To change the font used for item text, use the WM_SETFONT message (CWnd::SetFont). The WM_SETFONT message overrides the font defined using SetRowHeaderFont. If the row header font needs to be changed, it must be changed after using the WM_SETFONT message.

The CFont* pointer returned by GetRowHeaderFont may point to a temporary object and should not be stored for later use.

Row headers are made visible using SetShowRowHeader.

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