GTK+ 1.2 Tutorial
Prev | Chapter 12. CTree Widget | Next

# Setting CTree Attributes

There are a number of functions that set options that pertain to a CTree instance as a whole (rather than to a particular node). The first group set padding attributes that effect how the widget is drawn:

    void gtk_ctree_set_indent( GtkCTree *ctree,
                               gint      indent );

    void gtk_ctree_set_spacing( GtkCTree *ctree,
                                gint      spacing );

The function `gtk_ctree_set_indent()` sets how far a new branch is indented in relation to it's parent. The default is 20.

The function `gtk_ctree_set_spacing()` sets how far a node is horizontally padded from the vertical line that is drawn linking the nodes of each branch. The default is 5.

The next two functions affect the style of the lines and expander that are drawn to represent the tree structure. An expander is a grpahical component that the user can select to expand and collapse a branch of the tree.

    void gtk_ctree_set_line_style( GtkCTree          *ctree,
                                   GtkCTreeLineStyle  line_style );

    void gtk_ctree_set_expander_style( GtkCTree              *ctree,
                                       GtkCTreeExpanderStyle  expander_style );

The function `gtk_ctree_set_line_style()` is used to select the style of line that is drawn between nodes of the tree. The parameter `line_style` can be one of:

     GTK_CTREE_LINES_NONE
     GTK_CTREE_LINES_SOLID
     GTK_CTREE_LINES_DOTTED
     GTK_CTREE_LINES_TABBED

The function `gtk_ctree_set_expander_style()` is used to select the style of branch expander, and the parameter `expander_style` can be one of:

     GTK_CTREE_EXPANDER_NONE
     GTK_CTREE_EXPANDER_SQUARE
     GTK_CTREE_EXPANDER_TRIANGLE
     GTK_CTREE_EXPANDER_CIRCULAR

Prev | Home | Next
Adding and Removing nodes | Up | Utilizing row data