Hide

SftTree/DLL 7.5 - Tree Control

Display
Print

RowHeaderStyle

Defines the position of text displayed in the row headers.

C

DWORD WINAPI SftTree_GetRowHeaderStyle(HWND hwndCtl);
void WINAPI SftTree_SetRowHeaderStyle(HWND hwndCtl, DWORD style);
DWORD WINAPI SftTreeSplit_GetRowHeaderStyle(HWND hwndCtl);
void WINAPI SftTreeSplit_SetRowHeaderStyle(HWND hwndCtl, DWORD style);

C++

DWORD CSftTree::GetRowHeaderStyle() const;
void CSftTree::SetRowHeaderStyle(DWORD style);
DWORD CSftTreeSplit::GetRowHeaderStyle() const;
void CSftTreeSplit::SetRowHeaderStyle(DWORD style);

Parameters

hwndCtl

The window handle of the tree control.

style

The row header style used for all row headers. This value applies to all row headers.

One value of each of the following tables can be combined and passed as style parameter.

styleHorizontal row header text alignment
not specifiedIf no horizontal row header text alignment is specified, the default is ES_LEFT.
ES_LEFTThe row header text is left aligned within the row header. Row headers can override this default by defining new alignment values using the SFTTREE_ROW, flag member.
ES_CENTERThe row header text is centered within the row header. Row headers can override this default by defining new alignment values using the SFTTREE_ROW, flag member.
ES_RIGHTThe row header text is right aligned within the row header. Row headers can override this default by defining new alignment values using the SFTTREE_ROW, flag member.
styleVertical row header text alignment
not specifiedIf no vertical row header text alignment is specified, the default is SFTTREE_VCENTER.
SFTTREE_TOPThe row header text and picture are aligned with the top of the row header. Row headers can override this default by defining new alignment values using the SFTTREE_ROW, flag member.
SFTTREE_VCENTERThe row header text and picture are vertically centered within the row header. Row headers can override this default by defining new alignment values using the SFTTREE_ROW, flag member.
SFTTREE_BOTTOMThe row header text and picture are aligned with the bottom of the row header. Row headers can override this default by defining new alignment values using the SFTTREE_ROW, flag member.

The style value can optionally be combined with one or more of the following values:

SFTTREE_HEADER_DISABLEDThe row headers are disabled, cannot be clicked and are displayed in a "grayed" fashion. The item contents are otherwise unaffected.
SFTTREE_HEADER_UPThe row header buttons will automatically return to their "up" position when clicked.

Returns

GetRowHeaderStyle returns a value indicating the position of the text displayed in row headers.

Comments

The GetRowHeaderStyle and SetRowHeaderStyle functions define the position of text displayed in the row headers.

The row header style defined using SetRowHeaderStyle affects all row headers, individual items cannot override the style given.

Row header text can be defined using SetRowText.

Row headers are made visible using SetShowRowHeader.

Examples

C

                0,                           /* Column flag */
                0,                           /* Minimum column width */
              }
            };
            SftTree_SetColumnsEx(m_hwndLeftTree, 1, aCol);/* Set column attributes */
        }

        SftTree_SetShowRowHeader(m_hwndLeftTree, SFTTREE_ROWSTYLE_BUTTONCOUNT0);/* Row style */
        SftTree_SetRowHeaderStyle(m_hwndLeftTree, ES_LEFT | SFTTREE_HEADER_UP);/* Row header style */
        SftTree_SetDragBitmaps(m_hwndLeftTree, TRUE);/* Allow drag & drop from item, label pictures */
        SftTree_SetDragType(m_hwndLeftTree, SFTTREE_DRAG_PIXELIMM);/* Select and move by a number of pixels to start drag */
        SftTree_SetDropHighlightStyle(m_hwndLeftTree, SFTTREE_DROPHIGHLIGHT_BETWEEN);/* Draw line to represent drop target */
        SftTree_SetCharSearchMode(m_hwndLeftTree, SFTTREE_CHARSEARCH_ALLCHARS, -1);/* Consider all characters typed */
        /* Change the default colors */
        {
            SFTTREE_COLORS Colors;

C++

            0,                           /* Column flag */
            0,                           /* Minimum column width */
          }                              
        };
        m_LeftTree.SetColumns(1, aCol);  /* Set column attributes */
    }

    m_LeftTree.SetShowRowHeader(SFTTREE_ROWSTYLE_BUTTONCOUNT0);/* Row style */
    m_LeftTree.SetRowHeaderStyle(ES_LEFT | SFTTREE_HEADER_UP);/* Row header style */
    m_LeftTree.SetDragBitmaps(TRUE);     /* Allow drag & drop from item, label pictures */
    m_LeftTree.SetDragType(SFTTREE_DRAG_PIXELIMM);/* Select and move by a number of pixels to start drag */
    m_LeftTree.SetDropHighlightStyle(SFTTREE_DROPHIGHLIGHT_BETWEEN);/* Draw line to represent drop target */
    m_LeftTree.SetCharSearchMode(SFTTREE_CHARSEARCH_ALLCHARS, -1);/* Consider all characters typed */
    /* Change the default colors */
    {
        SFTTREE_COLORS Colors;

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