краткое описание

#include <gtk/gtk.h>


            gtktreeview;
enum        gtktreeviewdropposition;
            gtktreeviewprivate;

gboolean    (*gtktreeviewcolumndropfunc)    (gtktreeview *tree_view,
                                             gtktreeviewcolumn *column,
                                             gtktreeviewcolumn *prev_column,
                                             gtktreeviewcolumn *next_column,
                                             gpointer data);
void        (*gtktreeviewmappingfunc)       (gtktreeview *tree_view,
                                             gtktreepath *path,
                                             gpointer user_data);

gboolean    (*gtktreeviewsearchequalfunc)   (gtktreemodel *model,
                                             gint column,
                                             const gchar *key,
                                             gtktreeiter *iter,
                                             gpointer search_data);

gtkwidget*  gtk_tree_view_new               (void);
gtkwidget*  gtk_tree_view_new_with_model    (gtktreemodel *model);
gtktreemodel* gtk_tree_view_get_model       (gtktreeview *tree_view);
void        gtk_tree_view_set_model         (gtktreeview *tree_view,
                                             gtktreemodel *model);

gtktreeselection* gtk_tree_view_get_selection
                                            (gtktreeview *tree_view);
gtkadjustment* gtk_tree_view_get_hadjustment
                                            (gtktreeview *tree_view);
void        gtk_tree_view_set_hadjustment   (gtktreeview *tree_view,
                                             gtkadjustment *adjustment);

gtkadjustment* gtk_tree_view_get_vadjustment
                                            (gtktreeview *tree_view);
void        gtk_tree_view_set_vadjustment   (gtktreeview *tree_view,
                                             gtkadjustment *adjustment);

gboolean    gtk_tree_view_get_headers_visible
                                            (gtktreeview *tree_view);
void        gtk_tree_view_set_headers_visible
                                            (gtktreeview *tree_view,
                                             gboolean headers_visible);
void        gtk_tree_view_columns_autosize  (gtktreeview *tree_view);

gboolean    gtk_tree_view_get_headers_clickable
                                            (gtktreeview *tree_view);
void        gtk_tree_view_set_headers_clickable
                                            (gtktreeview *tree_view,
                                             gboolean setting);
void        gtk_tree_view_set_rules_hint    (gtktreeview *tree_view,
                                             gboolean setting);

gboolean    gtk_tree_view_get_rules_hint    (gtktreeview *tree_view);
gint        gtk_tree_view_append_column     (gtktreeview *tree_view,
                                             gtktreeviewcolumn *column);

gint        gtk_tree_view_remove_column     (gtktreeview *tree_view,
                                             gtktreeviewcolumn *column);
gint        gtk_tree_view_insert_column     (gtktreeview *tree_view,
                                             gtktreeviewcolumn *column,
                                             gint position);

gint        gtk_tree_view_insert_column_with_attributes
                                            (gtktreeview *tree_view,
                                             gint position,
                                             const gchar *title,
                                             gtkcellrenderer *cell,
                                             ...);

gint        gtk_tree_view_insert_column_with_data_func
                                            (gtktreeview *tree_view,
                                             gint position,
                                             const gchar *title,
                                             gtkcellrenderer *cell,
                                             gtktreecelldatafunc func,
                                             gpointer data,
                                             gdestroynotify dnotify);

gtktreeviewcolumn* gtk_tree_view_get_column (gtktreeview *tree_view,
                                             gint n);
glist*      gtk_tree_view_get_columns       (gtktreeview *tree_view);
void        gtk_tree_view_move_column_after (gtktreeview *tree_view,
                                             gtktreeviewcolumn *column,
                                             gtktreeviewcolumn *base_column);
void        gtk_tree_view_set_expander_column

                                            (gtktreeview *tree_view,
                                             gtktreeviewcolumn *column);
gtktreeviewcolumn* gtk_tree_view_get_expander_column
                                            (gtktreeview *tree_view);
void        gtk_tree_view_set_column_drag_function

                                            (gtktreeview *tree_view,
                                             gtktreeviewcolumndropfunc func,
                                             gpointer user_data,
                                             gtkdestroynotify destroy);
void        gtk_tree_view_scroll_to_point   (gtktreeview *tree_view,
                                             gint tree_x,
                                             gint tree_y);
void        gtk_tree_view_scroll_to_cell    (gtktreeview *tree_view,
                                             gtktreepath *path,
                                             gtktreeviewcolumn *column,
                                             gboolean use_align,
                                             gfloat row_align,
                                             gfloat col_align);
void        gtk_tree_view_set_cursor        (gtktreeview *tree_view,
                                             gtktreepath *path,
                                             gtktreeviewcolumn *focus_column,
                                             gboolean start_editing);
void        gtk_tree_view_set_cursor_on_cell

                                            (gtktreeview *tree_view,
                                             gtktreepath *path,
                                             gtktreeviewcolumn *focus_column,
                                             gtkcellrenderer *focus_cell,
                                             gboolean start_editing);
void        gtk_tree_view_get_cursor        (gtktreeview *tree_view,
                                             gtktreepath **path,
                                             gtktreeviewcolumn **focus_column);
void        gtk_tree_view_row_activated     (gtktreeview *tree_view,
                                             gtktreepath *path,
                                             gtktreeviewcolumn *column);
void        gtk_tree_view_expand_all        (gtktreeview *tree_view);
void        gtk_tree_view_collapse_all      (gtktreeview *tree_view);
void        gtk_tree_view_expand_to_path    (gtktreeview *tree_view,
                                             gtktreepath *path);

gboolean    gtk_tree_view_expand_row        (gtktreeview *tree_view,
                                             gtktreepath *path,
                                             gboolean open_all);
gboolean    gtk_tree_view_collapse_row      (gtktreeview *tree_view,
                                             gtktreepath *path);
void        gtk_tree_view_map_expanded_rows (gtktreeview *tree_view,
                                             gtktreeviewmappingfunc func,
                                             gpointer data);

gboolean    gtk_tree_view_row_expanded      (gtktreeview *tree_view,
                                             gtktreepath *path);
void        gtk_tree_view_set_reorderable   (gtktreeview *tree_view,
                                             gboolean reorderable);

gboolean    gtk_tree_view_get_reorderable   (gtktreeview *tree_view);
gboolean    gtk_tree_view_get_path_at_pos   (gtktreeview *tree_view,
                                             gint x,
                                             gint y,
                                             gtktreepath **path,
                                             gtktreeviewcolumn **column,
                                             gint *cell_x,
                                             gint *cell_y);
void        gtk_tree_view_get_cell_area     (gtktreeview *tree_view,
                                             gtktreepath *path,
                                             gtktreeviewcolumn *column,
                                             gdkrectangle *rect);
void        gtk_tree_view_get_background_area

                                            (gtktreeview *tree_view,
                                             gtktreepath *path,
                                             gtktreeviewcolumn *column,
                                             gdkrectangle *rect);
void        gtk_tree_view_get_visible_rect  (gtktreeview *tree_view,
                                             gdkrectangle *visible_rect);

gboolean    gtk_tree_view_get_visible_range (gtktreeview *tree_view,
                                             gtktreepath **start_path,
                                             gtktreepath **end_path);
gdkwindow*  gtk_tree_view_get_bin_window    (gtktreeview *tree_view);
void        gtk_tree_view_widget_to_tree_coords

                                            (gtktreeview *tree_view,
                                             gint wx,
                                             gint wy,
                                             gint *tx,
                                             gint *ty);
void        gtk_tree_view_tree_to_widget_coords

                                            (gtktreeview *tree_view,
                                             gint tx,
                                             gint ty,
                                             gint *wx,
                                             gint *wy);
void        gtk_tree_view_enable_model_drag_dest

                                            (gtktreeview *tree_view,
                                             const gtktargetentry *targets,
                                             gint n_targets,
                                             gdkdragaction actions);
void        gtk_tree_view_enable_model_drag_source
                                            (gtktreeview *tree_view,
                                             gdkmodifiertype start_button_mask,
                                             const gtktargetentry *targets,
                                             gint n_targets,
                                             gdkdragaction actions);
void        gtk_tree_view_unset_rows_drag_source

                                            (gtktreeview *tree_view);
void        gtk_tree_view_unset_rows_drag_dest
                                            (gtktreeview *tree_view);
void        gtk_tree_view_set_drag_dest_row (gtktreeview *tree_view,
                                             gtktreepath *path,
                                             gtktreeviewdropposition pos);
void        gtk_tree_view_get_drag_dest_row (gtktreeview *tree_view,
                                             gtktreepath **path,
                                             gtktreeviewdropposition *pos);

gboolean    gtk_tree_view_get_dest_row_at_pos
                                            (gtktreeview *tree_view,
                                             gint drag_x,
                                             gint drag_y,
                                             gtktreepath **path,
                                             gtktreeviewdropposition *pos);

gdkpixmap*  gtk_tree_view_create_row_drag_icon
                                            (gtktreeview *tree_view,
                                             gtktreepath *path);
void        gtk_tree_view_set_enable_search (gtktreeview *tree_view,
                                             gboolean enable_search);

gboolean    gtk_tree_view_get_enable_search (gtktreeview *tree_view);
gint        gtk_tree_view_get_search_column (gtktreeview *tree_view);
void        gtk_tree_view_set_search_column (gtktreeview *tree_view,
                                             gint column);

gtktreeviewsearchequalfunc gtk_tree_view_get_search_equal_func
                                            (gtktreeview *tree_view);
void        gtk_tree_view_set_search_equal_func
                                            (gtktreeview *tree_view,
                                             gtktreeviewsearchequalfunc search_equal_func,
                                             gpointer search_user_data,
                                             gtkdestroynotify search_destroy);

gtkentry*   gtk_tree_view_get_search_entry  (gtktreeview *tree_view);
void        gtk_tree_view_set_search_entry  (gtktreeview *tree_view,
                                             gtkentry *entry);
void        (*gtktreeviewsearchpositionfunc)
                                            (gtktreeview *tree_view,
                                             gtkwidget *search_dialog,
                                             gpointer user_data);

gtktreeviewsearchpositionfunc gtk_tree_view_get_search_position_func
                                            (gtktreeview *tree_view);
void        gtk_tree_view_set_search_position_func
                                            (gtktreeview *tree_view,
                                             gtktreeviewsearchpositionfunc func,
                                             gpointer data,
                                             gdestroynotify destroy);

gboolean    gtk_tree_view_get_fixed_height_mode
                                            (gtktreeview *tree_view);
void        gtk_tree_view_set_fixed_height_mode
                                            (gtktreeview *tree_view,
                                             gboolean enable);

gboolean    gtk_tree_view_get_hover_selection
                                            (gtktreeview *tree_view);
void        gtk_tree_view_set_hover_selection
                                            (gtktreeview *tree_view,
                                             gboolean hover);

gboolean    gtk_tree_view_get_hover_expand  (gtktreeview *tree_view);
void        gtk_tree_view_set_hover_expand  (gtktreeview *tree_view,
                                             gboolean expand);
void        (*gtktreedestroycountfunc)      (gtktreeview *tree_view,
                                             gtktreepath *path,
                                             gint children,
                                             gpointer user_data);
void        gtk_tree_view_set_destroy_count_func

                                            (gtktreeview *tree_view,
                                             gtktreedestroycountfunc func,
                                             gpointer data,
                                             gtkdestroynotify destroy);
gboolean    (*gtktreeviewrowseparatorfunc)  (gtktreemodel *model,
                                             gtktreeiter *iter,
                                             gpointer data);

gtktreeviewrowseparatorfunc gtk_tree_view_get_row_separator_func
                                            (gtktreeview *tree_view);
void        gtk_tree_view_set_row_separator_func
                                            (gtktreeview *tree_view,
                                             gtktreeviewrowseparatorfunc func,
                                             gpointer data,
                                             gtkdestroynotify destroy);

gboolean    gtk_tree_view_get_rubber_banding
                                            (gtktreeview *tree_view);
void        gtk_tree_view_set_rubber_banding
                                            (gtktreeview *tree_view,
                                             gboolean enable);

gboolean    gtk_tree_view_get_enable_tree_lines
                                            (gtktreeview *tree_view);
void        gtk_tree_view_set_enable_tree_lines
                                            (gtktreeview *tree_view,
                                             gboolean enabled);
enum        gtktreeviewgridlines;

gtktreeviewgridlines gtk_tree_view_get_grid_lines
                                            (gtktreeview *tree_view);
void        gtk_tree_view_set_grid_lines    (gtktreeview *tree_view,
                                             gtktreeviewgridlines grid_lines);

иерархия объектов

  gobject
   +----ginitiallyunowned
         +----gtkobject

               +----gtkwidget
                     +----gtkcontainer
                           +----gtktreeview

осуществляемые интерфейсы

gtktreeview осуществляет atkimplementoriface.

свойства

  "enable-grid-lines"    gtktreeviewgridlines  : read / write
  "enable-search"        gboolean              : read / write
  "enable-tree-lines"    gboolean              : read / write
  "expander-column"      gtktreeviewcolumn     : read / write
  "fixed-height-mode"    gboolean              : read / write
  "hadjustment"          gtkadjustment         : read / write
  "headers-clickable"    gboolean              : read / write
  "headers-visible"      gboolean              : read / write
  "hover-expand"         gboolean              : read / write
  "hover-selection"      gboolean              : read / write
  "level-indentation"    gint                  : read / write
  "model"                gtktreemodel          : read / write
  "reorderable"          gboolean              : read / write
  "rubber-banding"       gboolean              : read / write
  "rules-hint"           gboolean              : read / write
  "search-column"        gint                  : read / write
  "show-expanders"       gboolean              : read / write
  "vadjustment"          gtkadjustment         : read / write

свойства стиля

  "allow-rules"          gboolean              : read
  "even-row-color"       gdkcolor              : read
  "expander-size"        gint                  : read
  "grid-line-pattern"    gchararray            : read
  "grid-line-width"      gint                  : read
  "horizontal-separator" gint                  : read
  "indent-expanders"     gboolean              : read
  "odd-row-color"        gdkcolor              : read
  "row-ending-details"   gboolean              : read
  "tree-line-pattern"    gchararray            : read
  "tree-line-width"      gint                  : read
  "vertical-separator"   gint                  : read

сигналы

"columns-changed"
            void        user_function      (gtktreeview *tree_view,
                                            gpointer     user_data)      : run last
"cursor-changed"
            void        user_function      (gtktreeview *tree_view,
                                            gpointer     user_data)      : run last
"expand-collapse-cursor-row"
            gboolean    user_function      (gtktreeview *treeview,
                                            gboolean     arg1,
                                            gboolean     arg2,
                                            gboolean     arg3,
                                            gpointer     user_data)      : run last / action
"move-cursor"
            gboolean    user_function      (gtktreeview     *treeview,
                                            gtkmovementstep *arg1,
                                            gint             arg2,
                                            gpointer         user_data)      : run last / action
"row-activated"
            void        user_function      (gtktreeview       *tree_view,
                                            gtktreepath       *path,
                                            gtktreeviewcolumn *column,
                                            gpointer           user_data)      : run last / action
"row-collapsed"
            void        user_function      (gtktreeview *tree_view,
                                            gtktreeiter *iter,
                                            gtktreepath *path,
                                            gpointer     user_data)      : run last
"row-expanded"
            void        user_function      (gtktreeview *tree_view,
                                            gtktreeiter *iter,
                                            gtktreepath *path,
                                            gpointer     user_data)      : run last
"select-all"
            gboolean    user_function      (gtktreeview *treeview,
                                            gpointer     user_data)      : run last / action
"select-cursor-parent"
            gboolean    user_function      (gtktreeview *treeview,
                                            gpointer     user_data)      : run last / action
"select-cursor-row"
            gboolean    user_function      (gtktreeview *treeview,
                                            gboolean     arg1,
                                            gpointer     user_data)      : run last / action
"set-scroll-adjustments"
            void        user_function      (gtktreeview   *treeview,
                                            gtkadjustment *arg1,
                                            gtkadjustment *arg2,
                                            gpointer       user_data)      : run last / action
"start-interactive-search"
            gboolean    user_function      (gtktreeview *treeview,
                                            gpointer     user_data)      : run last / action
"test-collapse-row"
            gboolean    user_function      (gtktreeview *tree_view,
                                            gtktreeiter *iter,
                                            gtktreepath *path,
                                            gpointer     user_data)      : run last
"test-expand-row"
            gboolean    user_function      (gtktreeview *tree_view,
                                            gtktreeiter *iter,
                                            gtktreepath *path,
                                            gpointer     user_data)      : run last
"toggle-cursor-row"
            gboolean    user_function      (gtktreeview *treeview,
                                            gpointer     user_data)      : run last / action
"unselect-all"
            gboolean    user_function      (gtktreeview *treeview,
                                            gpointer     user_data)      : run last / action

описание

виджет который отображает любой объект реализуемый интерфейсом gtktreemodel.

пожалуйста обратитесь к tree widget conceptual overview для получения краткого описания объектов и типов данных связанных с древовидным виджетом и как они взаимодействуют.

детали

gtktreeview

typedef struct _gtktreeview gtktreeview;

enum gtktreeviewdropposition

typedef enum
{
  /* перенос перед/после этой строки */
  gtk_tree_view_drop_before,
  gtk_tree_view_drop_after,
  /* перенос как дочернего элемента этой строки (с аварийным переходом в до или после
   * если во внутрь не возможно)
   */
  gtk_tree_view_drop_into_or_before,
  gtk_tree_view_drop_into_or_after
} gtktreeviewdropposition;

перечисление для определения передвижения строки.

gtktreeviewprivate

typedef struct _gtktreeviewprivate gtktreeviewprivate;

закрытая структура только для внутреннего использования.

gtktreeviewcolumndropfunc ()

gboolean    (*gtktreeviewcolumndropfunc)    (gtktreeview *tree_view,
                                             gtktreeviewcolumn *column,
                                             gtktreeviewcolumn *prev_column,
                                             gtktreeviewcolumn *next_column,
                                             gpointer data);

тип функции для определения может ли column перемещен в специфическую ячейку (как определено параметрами prev_column и next_column). в локалях слева на право, prev_column это потенциальную ячейку для переноса слева, а next_column это право. в режиме с право на лево, всё наоборот. эта функция должна возвращать true если ячейка доступна для перемещения. пожалуйста помните, возвращаемое true фактически не указывает на перенос столбца, а указывает только о возможности переноса ячейки для пользователя.

gtktreeviewmappingfunc ()

void        (*gtktreeviewmappingfunc)       (gtktreeview *tree_view,
                                             gtktreepath *path,
                                             gpointer user_data);

функция используемая для gtk_tree_view_map_expanded_rows.

gtktreeviewsearchequalfunc ()

gboolean    (*gtktreeviewsearchequalfunc)   (gtktreemodel *model,
                                             gint column,
                                             const gchar *key,
                                             gtktreeiter *iter,
                                             gpointer search_data);

функция используемая для контроля соответствует ли строка в model ключевой строке поиска введенной пользователем. помните, возвращаемое значение обратно тому которое вы обычно ожидаете, однако она имеет некоторое сходство с strcmp(), для равных значений возвращается 0.

gtk_tree_view_new ()

gtkwidget*  gtk_tree_view_new               (void);

создаёт новый виджет gtktreeview.

gtk_tree_view_new_with_model ()

gtkwidget*  gtk_tree_view_new_with_model    (gtktreemodel *model);

создаёт новый gtktreeview с моделью инициализируемой как model.

gtk_tree_view_get_model ()

gtktreemodel* gtk_tree_view_get_model       (gtktreeview *tree_view);

возвращает модель на которой основан gtktreeview. возвращает null если модель не установлена.

gtk_tree_view_set_model ()

void        gtk_tree_view_set_model         (gtktreeview *tree_view,
                                             gtktreemodel *model);

устанавливает модель для gtktreeview. если tree_view уже имеет установленную модель, она переписывает предыдущие установки новой моделью. если model равна null, то когда предыдущая модель удаляется.

gtk_tree_view_get_selection ()

gtktreeselection* gtk_tree_view_get_selection
                                            (gtktreeview *tree_view);

выдаёт gtktreeselection связанный с tree_view.

gtk_tree_view_get_hadjustment ()

gtkadjustment* gtk_tree_view_get_hadjustment
                                            (gtktreeview *tree_view);

выдаёт gtkadjustment используемый в текущий момент для горизонтального аспекта.

gtk_tree_view_set_hadjustment ()

void        gtk_tree_view_set_hadjustment   (gtktreeview *tree_view,
                                             gtkadjustment *adjustment);

устанавливает gtkadjustment для текущемго горизонтального аспекта.

gtk_tree_view_get_vadjustment ()

gtkadjustment* gtk_tree_view_get_vadjustment
                                            (gtktreeview *tree_view);

выдаёт gtkadjustment используемый в текущий момент для вертикального аспекта.

gtk_tree_view_set_vadjustment ()

void        gtk_tree_view_set_vadjustment   (gtktreeview *tree_view,
                                             gtkadjustment *adjustment);

устанавливает gtkadjustment для текущемго вертикального аспекта.

gtk_tree_view_get_headers_visible ()

gboolean    gtk_tree_view_get_headers_visible
                                            (gtktreeview *tree_view);

возвращает true заголовки в tree_view видимы.

gtk_tree_view_set_headers_visible ()

void        gtk_tree_view_set_headers_visible
                                            (gtktreeview *tree_view,
                                             gboolean headers_visible);

устанавливает состояние видимости заголовков.

gtk_tree_view_columns_autosize ()

void        gtk_tree_view_columns_autosize  (gtktreeview *tree_view);

изменяет размер всех столбцов до оптимальной ширины. работает только после реализации древовидного просмотра.

gtk_tree_view_get_headers_clickable ()

gboolean    gtk_tree_view_get_headers_clickable
                                            (gtktreeview *tree_view);

возвращает доступны ли все заголовки столбцов для нажатия.

начиная с версии 2.10

gtk_tree_view_set_headers_clickable ()

void        gtk_tree_view_set_headers_clickable
                                            (gtktreeview *tree_view,
                                             gboolean setting);

позволяет нажимать кнопки заголовков столбцов.

gtk_tree_view_set_rules_hint ()

void        gtk_tree_view_set_rules_hint    (gtktreeview *tree_view,
                                             gboolean setting);

эта функция сообщает gtk+ что интерфейс пользователя вашего приложения чередует разные по цвету строки и связанные между собой ячейки. по умолчанию, gtk+ будет отображать дерево с разными по цвету строками. не используйте её только потому, что вы предпочитаете плоский вид дерева; это можно настроить темой. некоторые темы будут отображать строки разными цветами даже когда правила выключены и пользователи предпочитающие данный вид могут выбрать эти темы. вы должны вызывать эту функцию только как семантическую подсказку для движка темы, что делает разность цветов вашего дерева полезной с функциональной точки зрения (так как обычно оно имеет множество столбцов).

gtk_tree_view_get_rules_hint ()

gboolean    gtk_tree_view_get_rules_hint    (gtktreeview *tree_view);

выдаёт настройки установленные с помощью gtk_tree_view_set_rules_hint().

gtk_tree_view_append_column ()

gint        gtk_tree_view_append_column     (gtktreeview *tree_view,
                                             gtktreeviewcolumn *column);

устанавливает column в начало списка столбцов. если tree_view имеет "fixed_height" режим включенным, то column должен иметь свойство "sizing" установленным в gtk_tree_view_column_fixed.

gtk_tree_view_remove_column ()

gint        gtk_tree_view_remove_column     (gtktreeview *tree_view,
                                             gtktreeviewcolumn *column);

удаляет column из tree_view.

gtk_tree_view_insert_column ()

gint        gtk_tree_view_insert_column     (gtktreeview *tree_view,
                                             gtktreeviewcolumn *column,
                                             gint position);

вставляет column в tree_view в позицию position. если position равна -1, то когда столбец вставляется в конец. если tree_view имеет "fixed_height" режим включенным, то column должен иметь свойство "sizing" установленное в значение gtk_tree_view_column_fixed.

gtk_tree_view_insert_column_with_attributes ()

gint        gtk_tree_view_insert_column_with_attributes
                                            (gtktreeview *tree_view,
                                             gint position,
                                             const gchar *title,
                                             gtkcellrenderer *cell,
                                             ...);

создаёт новый gtktreeviewcolumn и вставляет его в tree_view в позицию position. если position равна -1, то когда вновь созданный столбец вставляется в конец. столбец инициализируется с полученными атрибутами. если tree_view имеет "fixed_height" режим включенным, то новый столбец будет иметь свойство размера установленное в значение gtk_tree_view_column_fixed.

gtk_tree_view_insert_column_with_data_func ()

gint        gtk_tree_view_insert_column_with_data_func
                                            (gtktreeview *tree_view,
                                             gint position,
                                             const gchar *title,
                                             gtkcellrenderer *cell,
                                             gtktreecelldatafunc func,
                                             gpointer data,
                                             gdestroynotify dnotify);

удобная функция для вставки столбцов в gtktreeview с полученной ячейкой представления и gtkcelldatafunc для установки свойств ячейки представления (обычно используются данные из модели). смотрите также gtk_tree_view_column_set_cell_data_func(), gtk_tree_view_column_pack_start(). если tree_view имеет включенный режим "fixed_height", то новый столбец будет иметь свойство "sizing" установленное в значение gtk_tree_view_column_fixed.

gtk_tree_view_get_column ()

gtktreeviewcolumn* gtk_tree_view_get_column (gtktreeview *tree_view,
                                             gint n);

выдаёт gtktreeviewcolumn из полученной позиции в tree_view.

gtk_tree_view_get_columns ()

glist*      gtk_tree_view_get_columns       (gtktreeview *tree_view);

возвращает glist всех gtktreeviewcolumn находящихся в текущий момент в tree_view. возвращаемый список должен освобождаться с помощью g_list_free().

gtk_tree_view_move_column_after ()

void        gtk_tree_view_move_column_after (gtktreeview *tree_view,
                                             gtktreeviewcolumn *column,
                                             gtktreeviewcolumn *base_column);

перемещает column в позицию после base_column. если base_column равен null, то column помещается в первую позицию.

gtk_tree_view_set_expander_column ()

void        gtk_tree_view_set_expander_column
                                            (gtktreeview *tree_view,
                                             gtktreeviewcolumn *column);

устанавливает столбец для представления расширительной стрелки. он должен быть в tree_view. если column равен null, то расширительная стрелка всегда в первом видимом столбце.

если вы не хотите чтобы расширительная стрелка появлялась в вашем дереве, установите дополнительный столбец в скрытый столбец.

gtk_tree_view_get_expander_column ()

gtktreeviewcolumn* gtk_tree_view_get_expander_column
                                            (gtktreeview *tree_view);

возвращает текущий расширительный столбец. этот столбец имеет стрелку расширителя отображаемую рядом.

gtk_tree_view_set_column_drag_function ()

void        gtk_tree_view_set_column_drag_function
                                            (gtktreeview *tree_view,
                                             gtktreeviewcolumndropfunc func,
                                             gpointer user_data,
                                             gtkdestroynotify destroy);

устанавливает функцию для определения где столбец может быть вставлен при перетаскивании. эта функция вызывается на каждой паре столбцов в начале перетаскивания для определения куда можно поместить перетаскиваемый столбец. аргументы помещаемые в func : tree_view, gtktreeviewcolumn для перетаскивания, два gtktreeviewcolumns определяющих ячейку вставки и user_data. если любой из аргументов gtktreeviewcolumn является null, то это означает край. если func установлена в null, то tree_view возвращается к поведению по умолчанию позволяя всем столбцам перемещаться везде.

gtk_tree_view_scroll_to_point ()

void        gtk_tree_view_scroll_to_point   (gtktreeview *tree_view,
                                             gint tree_x,
                                             gint tree_y);

прокручивает дерево просмотра так, что верхний-левый угол видимой области равен tree_x, tree_y, где tree_x и tree_y определяются в координатах окна дерева. tree_view должен быть реализован перед использованием этой функции. если нет, вам вероятно нужно использовать gtk_tree_view_scroll_to_cell().

если значение параметра tree_x или tree_y равно -1, то когда направление не прокручивается.

gtk_tree_view_scroll_to_cell ()

void        gtk_tree_view_scroll_to_cell    (gtktreeview *tree_view,
                                             gtktreepath *path,
                                             gtktreeviewcolumn *column,
                                             gboolean use_align,
                                             gfloat row_align,
                                             gfloat col_align);

перемещает выравнивание tree_view в позицию определённую column и path. если column это null, то горизонтальная прокрутка не выполняется. аналогично, если path равен null вертикальная прокрутка не выполняется. как минимум один из column или path должен быть не-null. row_align определяет где помещается строка, а col_align определяет где помещается столбец column. оба располагаются в промежутке между 0.0 и 1.0. 0.0 означает левое/верхнее выравнивание, 1.0 означает правое/нижнее выравнивание, 0.5 означает центр.

если use_align равен false, то аргументы выравнивания игнорируются, а дерево выполняет минимальный объём работы для прокручивания ячейки на экран. это означает что ячейка будет прокручена до наиболее близкого края своей текущемй позиции. если ячейка уже видима на экране, то ничего не произойдёт.

эта функция работает только если модель установлена, а path это допустимая строка в модели. если модель изменяется перед изменением размера tree_view, центральный путь будет изменён для отражения этих изменений.

gtk_tree_view_set_cursor ()

void        gtk_tree_view_set_cursor        (gtktreeview *tree_view,
                                             gtktreepath *path,
                                             gtktreeviewcolumn *focus_column,
                                             gboolean start_editing);

устанавливает текущий клавиатурный фокус соответствующий параметру path, и выбирает его. это полезно для привлечения внимания пользователя к определенной строке. если focus_column не null, то фокус представляется этому столбцу. дополнительно, если focus_column определён, а start_editing равен true, то редактирование должно начинаться в определенной ячейке. эта функция часто сопровождается gtk_widget_grab_focus(tree_view) для предоставления фокуса виджету. пожалуйста помните, что редактирование может происходить только когда виджет реализован.

gtk_tree_view_set_cursor_on_cell ()

void        gtk_tree_view_set_cursor_on_cell
                                            (gtktreeview *tree_view,
                                             gtktreepath *path,
                                             gtktreeviewcolumn *focus_column,
                                             gtkcellrenderer *focus_cell,
                                             gboolean start_editing);

устанавливает текущий клавиатурный фокус в значение path, и выбирает его. это полезно когда вам нужно привлечь внимание пользователя к определенной строке. если focus_column не null, то фокус предоставляется этому столбцу. если focus_column и focus_cell не null, и focus_column содержит 2 и более редактируемых или активизируемых ячейки, то фокус отдаётся ячейке определенной параметром focus_cell. дополнительно, если focus_column определен, а start_editing равен true, то редактирование должно начинаться в определенной ячейке. эта функция обычно сопровождается gtk_widget_grab_focus (tree_view) для предоставления фокуса виджету. пожалуйста помните, что редактирование может происходить только когда виджет реализован.

начиная с версии 2.2

gtk_tree_view_get_cursor ()

void        gtk_tree_view_get_cursor        (gtktreeview *tree_view,
                                             gtktreepath **path,
                                             gtktreeviewcolumn **focus_column);

заполняет поля path и focus_column текущими путём и сфокусированным столбцом. если курсор в текущий момент не установлен, то *path будет null. если нет текущемго сфокусированного столбца, то *focus_column будет null.

возвращаемый gtktreepath должен освобождаться с помощью gtk_tree_path_free().

gtk_tree_view_row_activated ()

void        gtk_tree_view_row_activated     (gtktreeview *tree_view,
                                             gtktreepath *path,
                                             gtktreeviewcolumn *column);

активизирует ячейку определенную параметрами path и column.

gtk_tree_view_expand_all ()

void        gtk_tree_view_expand_all        (gtktreeview *tree_view);

рекурсивно расширяет все элементы в tree_view.

gtk_tree_view_collapse_all ()

void        gtk_tree_view_collapse_all      (gtktreeview *tree_view);

рекурсивно разрушает все видимые, расширенные элементы в tree_view.

gtk_tree_view_expand_to_path ()

void        gtk_tree_view_expand_to_path    (gtktreeview *tree_view,
                                             gtktreepath *path);

разворачивает строку в позиции path. это также развернёт все родительские строки по мере необходимости.

начиная с версии 2.2

gtk_tree_view_expand_row ()

gboolean    gtk_tree_view_expand_row        (gtktreeview *tree_view,
                                             gtktreepath *path,
                                             gboolean open_all);

открывает строку, чтобы были видимы дочерние элементы.

gtk_tree_view_collapse_row ()

gboolean    gtk_tree_view_collapse_row      (gtktreeview *tree_view,
                                             gtktreepath *path);

сворачивает строку (скрывает её дочерние строки, если есть).

gtk_tree_view_map_expanded_rows ()

void        gtk_tree_view_map_expanded_rows (gtktreeview *tree_view,
                                             gtktreeviewmappingfunc func,
                                             gpointer data);

вызывает func для всех развёрнутых строк.

gtk_tree_view_row_expanded ()

gboolean    gtk_tree_view_row_expanded      (gtktreeview *tree_view,
                                             gtktreepath *path);

возвращает true если элемент указанный в path расширен в tree_view.

gtk_tree_view_set_reorderable ()

void        gtk_tree_view_set_reorderable   (gtktreeview *tree_view,
                                             gboolean reorderable);

это удобная функция которая позволяет вам пере-упорядочивать модель которая поддерживает gtkdragsourceiface и gtkdragdestiface. оба gtktreestore и gtkliststore поддерживают их. если reorderable равен true, то пользователь может пере-упорядочивать модель перетаскивая строки. разработчик может слушать эти изменения подключая к модели row_inserted и row_deleted сигналы.

эта функция не даёт вам никакого уровня контроля над порядком – позволяется любое переупорядочивание. если нужно больше контроля, вы должны вероятно обрабатывать drag and drop самостоятельно.

gtk_tree_view_get_reorderable ()

gboolean    gtk_tree_view_get_reorderable   (gtktreeview *tree_view);

определяет может ли пользователь изменять порядок дерева с помощью drag-and-drop. смотрите gtk_tree_view_set_reorderable().

gtk_tree_view_get_path_at_pos ()

gboolean    gtk_tree_view_get_path_at_pos   (gtktreeview *tree_view,
                                             gint x,
                                             gint y,
                                             gtktreepath **path,
                                             gtktreeviewcolumn **column,
                                             gint *cell_x,
                                             gint *cell_y);

находит путь в точке (x, y), относительно координат виджета. таким образом, x и y являются относительными для координат события. x и y должны исходить из события в tree_view только где event->window == gtk_tree_view_get_bin(). это первостепенно для таких вещей как всплывающее меню. если path не-null, то он будет заполнен объектом gtktreepath в этой точке. этот путь должен быть освобождён с помощью gtk_tree_path_free(). если column не-null, то он будет заполнен столбцом в этой точке. cell_x и cell_y возвращает координаты относительно подготовленной ячейки (то есть background_area помещается в gtk_cell_renderer_render()). эта функция имеет значение только если tree_view реализован.

gtk_tree_view_get_cell_area ()

void        gtk_tree_view_get_cell_area     (gtktreeview *tree_view,
                                             gtktreepath *path,
                                             gtktreeviewcolumn *column,
                                             gdkrectangle *rect);

заполняет ограничивающий прямоугольник в оконных координатах дерева для ячейки в строке определенной параметром path и столбце определенном параметром column. если path равен null, или указывает путь не отображенный в текущий момент, y и height поля прямоугольника будут заполнены 0. если column равен null, x и width заполняются 0. итог всей ячейки не покрывает все дерево; например есть дополнительные пикселы между строками. возвращаемый прямоугольник эквивалентен cell_area помещаемой в gtk_cell_renderer_render(). эта функция доступна только если tree_view реализован.

gtk_tree_view_get_background_area ()

void        gtk_tree_view_get_background_area
                                            (gtktreeview *tree_view,
                                             gtktreepath *path,
                                             gtktreeviewcolumn *column,
                                             gdkrectangle *rect);

заполняет ограничивающий прямоугольник в оконных координатах дерева для ячейки в строке определенной параметром path и столбце определенном параметром column. если path равен null, или указывает на элемент не найденный в дереве, y и height поля прямоугольника заполняются 0. если column равен null, x и width поля заполняются 0. возвращаемый прямоугольник эквивалентен background_area помещаемой в gtk_cell_renderer_render(). это фоновая область для покрытия всего окна дерева (за исключением кнопок заголовков). в противоположность cell_area, возвращаемой gtk_tree_view_get_cell_area(), которая возвращает только ячейку непосредственно, исключая окружающие границы и площадь расширителя дерева.

gtk_tree_view_get_visible_rect ()

void        gtk_tree_view_get_visible_rect  (gtktreeview *tree_view,
                                             gdkrectangle *visible_rect);

заполняет visible_rect текущемй видимой областью буфера, в координатах дерева. конвертируется в координаты виджета с помощью gtk_tree_view_tree_to_widget_coords(). координаты дерева начинаются в 0,0 для 0 строки дерева и покрывают всю прокручиваемую область дерева.

gtk_tree_view_get_visible_range ()

gboolean    gtk_tree_view_get_visible_range (gtktreeview *tree_view,
                                             gtktreepath **start_path,
                                             gtktreepath **end_path);

устанавливает start_path и end_path для первого и последнего видимого пути. помните что между ними могут быть невидимые пути.

пути должны освобождаться с помощью gtk_tree_path_free() после использования.

начиная с версии 2.8

gtk_tree_view_get_bin_window ()

gdkwindow*  gtk_tree_view_get_bin_window    (gtktreeview *tree_view);

возвращает окно отображающее tree_view. это используется прежде всего для сравнения event->window , чтобы подтвердить что событие в tree_view находится в правильном окне.

gtk_tree_view_widget_to_tree_coords ()

void        gtk_tree_view_widget_to_tree_coords
                                            (gtktreeview *tree_view,
                                             gint wx,
                                             gint wy,
                                             gint *tx,
                                             gint *ty);

преобразует координаты виджета в координаты окна дерева (полная область прокручивания дерева).

gtk_tree_view_tree_to_widget_coords ()

void        gtk_tree_view_tree_to_widget_coords
                                            (gtktreeview *tree_view,
                                             gint tx,
                                             gint ty,
                                             gint *wx,
                                             gint *wy);

преобразует координаты дерева (координаты всей прокручиваемой области дерева) в координаты виджета.

gtk_tree_view_enable_model_drag_dest ()

void        gtk_tree_view_enable_model_drag_dest
                                            (gtktreeview *tree_view,
                                             const gtktargetentry *targets,
                                             gint n_targets,
                                             gdkdragaction actions);

включает tree_view в адресат назначения для автоматического dnd.

gtk_tree_view_enable_model_drag_source ()

void        gtk_tree_view_enable_model_drag_source
                                            (gtktreeview *tree_view,
                                             gdkmodifiertype start_button_mask,
                                             const gtktargetentry *targets,
                                             gint n_targets,
                                             gdkdragaction actions);

включает tree_view в источник перетаскивания для автоматического dnd.

gtk_tree_view_unset_rows_drag_source ()

void        gtk_tree_view_unset_rows_drag_source
                                            (gtktreeview *tree_view);

отменяет эффект gtk_tree_view_enable_model_drag_source().

gtk_tree_view_unset_rows_drag_dest ()

void        gtk_tree_view_unset_rows_drag_dest
                                            (gtktreeview *tree_view);

отменяет эффект gtk_tree_view_enable_model_drag_dest().

gtk_tree_view_set_drag_dest_row ()

void        gtk_tree_view_set_drag_dest_row (gtktreeview *tree_view,
                                             gtktreepath *path,
                                             gtktreeviewdropposition pos);

устанавливает подсветку строки для обратной связи.

gtk_tree_view_get_drag_dest_row ()

void        gtk_tree_view_get_drag_dest_row (gtktreeview *tree_view,
                                             gtktreepath **path,
                                             gtktreeviewdropposition *pos);

выдаёт информацию о подсвеченной строке для обратной связи.

gtk_tree_view_get_dest_row_at_pos ()

gboolean    gtk_tree_view_get_dest_row_at_pos
                                            (gtktreeview *tree_view,
                                             gint drag_x,
                                             gint drag_y,
                                             gtktreepath **path,
                                             gtktreeviewdropposition *pos);

определяет строку адресата для данной позиции.

gtk_tree_view_create_row_drag_icon ()

gdkpixmap*  gtk_tree_view_create_row_drag_icon
                                            (gtktreeview *tree_view,
                                             gtktreepath *path);

создаёт gdkpixmap представляющий строку в позиции path. это изображение используется для значка перетаскивания.

gtk_tree_view_set_enable_search ()

void        gtk_tree_view_set_enable_search (gtktreeview *tree_view,
                                             gboolean enable_search);

если enable_search установлен, то пользователь может впечатывать в текст для интерактивного поиска (это иногда называют "typeahead find").

помните, даже если установлено false, пользователь всё ещё может начать поиск используя привязку клавиш "start-interactive-search".

gtk_tree_view_get_enable_search ()

gboolean    gtk_tree_view_get_enable_search (gtktreeview *tree_view);

определяет может или нет дерево позволить интерактивный поиск.

gtk_tree_view_get_search_column ()

gint        gtk_tree_view_get_search_column (gtktreeview *tree_view);

выдаёт столбец для интерактивного поиска кода.

gtk_tree_view_set_search_column ()

void        gtk_tree_view_set_search_column (gtktreeview *tree_view,
                                             gint column);

устанавливает column как столбец в котором должен происходить интерактивный поиск кода.

если установлен сортированный столбец, пользователи могут использовать "start-interactive-search" привязку клавиш для начала поиска. включение свойства поиска контролирует будет ли начинаться интерактивный поиск при простом вводе в текст.

помните, column ссылается на столбец модели.

gtk_tree_view_get_search_equal_func ()

gtktreeviewsearchequalfunc gtk_tree_view_get_search_equal_func
                                            (gtktreeview *tree_view);

возвращает функцию сравнения используемую в текущий момент.

gtk_tree_view_set_search_equal_func ()

void        gtk_tree_view_set_search_equal_func
                                            (gtktreeview *tree_view,
                                             gtktreeviewsearchequalfunc search_equal_func,
                                             gpointer search_user_data,
                                             gtkdestroynotify search_destroy);

устанавливает функцию сравнения для интерактивного поиска возможностей; отметьте, отчасти похоже на strcmp() возвращает 0 при равенстве, gtktreeviewsearchequalfunc возвращает false для соответствий.

gtk_tree_view_get_search_entry ()

gtkentry*   gtk_tree_view_get_search_entry  (gtktreeview *tree_view);

возвращает gtkentry который в текущий момент используется как ввод для интерактивного поиска для tree_view. в случае использования встроенного ввода, возвращается null.

начиная с версии 2.10

gtk_tree_view_set_search_entry ()

void        gtk_tree_view_set_search_entry  (gtktreeview *tree_view,
                                             gtkentry *entry);

устанавливает ввод для интерактивного поиска используемый для tree_view. это полезно когда вы хотите обеспечить поле поиска в интерфейсе постоянно в зафиксированной позиции. помещённый null для entry заставит использовать встроенное, всплывающее поле поиска.

начиная с версии 2.10

gtktreeviewsearchpositionfunc ()

void        (*gtktreeviewsearchpositionfunc)
                                            (gtktreeview *tree_view,
                                             gtkwidget *search_dialog,
                                             gpointer user_data);

gtk_tree_view_get_search_position_func ()

gtktreeviewsearchpositionfunc gtk_tree_view_get_search_position_func
                                            (gtktreeview *tree_view);

возвращает используемую в текущеме время функцию позиционирования.

начиная с версии 2.10

gtk_tree_view_set_search_position_func ()

void        gtk_tree_view_set_search_position_func
                                            (gtktreeview *tree_view,
                                             gtktreeviewsearchpositionfunc func,
                                             gpointer data,
                                             gdestroynotify destroy);

устанавливает функцию используемую для позиционирования диалога поиска.

начиная с версии 2.10

gtk_tree_view_get_fixed_height_mode ()

gboolean    gtk_tree_view_get_fixed_height_mode
                                            (gtktreeview *tree_view);

определяет включен ли установленный режим высоты для tree_view.

начиная с версии 2.6

gtk_tree_view_set_fixed_height_mode ()

void        gtk_tree_view_set_fixed_height_mode
                                            (gtktreeview *tree_view,
                                             gboolean enable);

включает или выключает режим фиксированной высоты tree_view. режим фиксированной высоты gtktreeview предполагает что все строки имеют одинаковую высоту. эта опция допустима только если все строки одинаковой высоты а все столбцы типа gtk_tree_view_column_fixed.

начиная с версии 2.6

gtk_tree_view_get_hover_selection ()

gboolean    gtk_tree_view_get_hover_selection
                                            (gtktreeview *tree_view);

определяет включен ли режим плавающего выбора для tree_view.

начиная с версии 2.6

gtk_tree_view_set_hover_selection ()

void        gtk_tree_view_set_hover_selection
                                            (gtktreeview *tree_view,
                                             gboolean hover);

включает или выключает режим плавающего выбора для tree_view. режим плавающего выбора заставляет выделенную строку следовать за указателем. в настоящее время это работает только для режимов выделения gtk_selection_single и gtk_selection_browse.

начиная с версии 2.6

gtk_tree_view_get_hover_expand ()

gboolean    gtk_tree_view_get_hover_expand  (gtktreeview *tree_view);

определяет включен ли режим плавающего расширения для tree_view.

начиная с версии 2.6

gtk_tree_view_set_hover_expand ()

void        gtk_tree_view_set_hover_expand  (gtktreeview *tree_view,
                                             gboolean expand);

включает или выключает режим плавающего расширения для tree_view. плавающее расширение заставляет строки разворачиваться или сворачиваться если указатель передвигается над ними.

начиная с версии 2.6

gtktreedestroycountfunc ()

void        (*gtktreedestroycountfunc)      (gtktreeview *tree_view,
                                             gtktreepath *path,
                                             gint children,
                                             gpointer user_data);

gtk_tree_view_set_destroy_count_func ()

void        gtk_tree_view_set_destroy_count_func
                                            (gtktreeview *tree_view,
                                             gtktreedestroycountfunc func,
                                             gpointer data,
                                             gtkdestroynotify destroy);

эта функция в основном не должна использоваться. она предназначена для закрытого использования в atk, для определения количества видимости дочерних элементов которые удаляются когда пользователь сворачивает строку, или строка удаляется.

gtktreeviewrowseparatorfunc ()

gboolean    (*gtktreeviewrowseparatorfunc)  (gtktreemodel *model,
                                             gtktreeiter *iter,
                                             gpointer data);

функциональный тип для определения должна ли строка на которую указывает iter представляться как разделитель. общий способ осуществления этого, заключается в наличии логического столбца в модели, значение которого возвращает gtktreeviewrowseparatorfunc.

gtk_tree_view_get_row_separator_func ()

gtktreeviewrowseparatorfunc gtk_tree_view_get_row_separator_func
                                            (gtktreeview *tree_view);

возвращает текущую функцию строки разделителя.

начиная с версии 2.6

gtk_tree_view_set_row_separator_func ()

void        gtk_tree_view_set_row_separator_func
                                            (gtktreeview *tree_view,
                                             gtktreeviewrowseparatorfunc func,
                                             gpointer data,
                                             gtkdestroynotify destroy);

устанавливает функцию строки разделителя, которая используется для определения отображается ли строка как разделитель. если функция строки разделителя null, нет отображаемых разделителей. это значение по умолчанию.

начиная с версии 2.6

gtk_tree_view_get_rubber_banding ()

gboolean    gtk_tree_view_get_rubber_banding
                                            (gtktreeview *tree_view);

определяет включен ли метод резиновой нити для tree_view. если режим выделения gtk_selection_multiple, метод резиновой нити позволит пользователю выделять множество строк перемещая мышь.

начиная с версии 2.10

gtk_tree_view_set_rubber_banding ()

void        gtk_tree_view_set_rubber_banding
                                            (gtktreeview *tree_view,
                                             gboolean enable);

включает или выключает метод резиновой нити в tree_view. если режим выделения gtk_selection_multiple, метод резиновой нити позволит пользователю выделять множество строк перемещая мышь.

начиная с версии 2.10

gtk_tree_view_get_enable_tree_lines ()

gboolean    gtk_tree_view_get_enable_tree_lines
                                            (gtktreeview *tree_view);

определяет отображаются ли линии в tree_view.

начиная с версии 2.10

gtk_tree_view_set_enable_tree_lines ()

void        gtk_tree_view_set_enable_tree_lines
                                            (gtktreeview *tree_view,
                                             gboolean enabled);

устанавливает отображаются ли линии связывающие расширители в tree_view. это не имеет видимого эффекта для списков.

начиная с версии 2.10

enum gtktreeviewgridlines

typedef enum {
  gtk_tree_view_grid_lines_none,
  gtk_tree_view_grid_lines_horizontal,
  gtk_tree_view_grid_lines_vertical,
  gtk_tree_view_grid_lines_both
} gtktreeviewgridlines;

gtk_tree_view_get_grid_lines ()

gtktreeviewgridlines gtk_tree_view_get_grid_lines
                                            (gtktreeview *tree_view);

определяет какие линии сетки включены в tree_view.

начиная с версии 2.10

gtk_tree_view_set_grid_lines ()

void        gtk_tree_view_set_grid_lines    (gtktreeview *tree_view,
                                             gtktreeviewgridlines grid_lines);

устанавливает какие линии сетки отображать в tree_view.

начиная с версии 2.10

детали свойств

свойство "enable-grid-lines"

  "enable-grid-lines"    gtktreeviewgridlines  : read / write

должны ли линии сетки отображаться в дереве просмотра.

значение по умолчанию: gtk_tree_view_grid_lines_none

свойство "enable-search"

  "enable-search"        gboolean              : read / write

позволяет пользователю интерактивный поиск в столбцах.

значение по умолчанию: true

свойство "enable-tree-lines"

  "enable-tree-lines"    gboolean              : read / write

должны ли отображаться линии дерева в дереве просмотра.

значение по умолчанию: false

свойство "expander-column"

  "expander-column"      gtktreeviewcolumn     : read / write

устанавливает столбец для расширительной колонки.

свойство "fixed-height-mode"

  "fixed-height-mode"    gboolean              : read / write

устанавливает свойство ::fixed-height-mode в true для gtktreeview предполагая что все строки имеют одинаковую высоту. только включает эту опцию, если строки имеют одинаковую высоту. подробности смотрите в gtk_tree_view_set_fixed_height_mode().

значение по умолчанию: false

начиная с версии 2.4

свойство "hadjustment"

  "hadjustment"          gtkadjustment         : read / write

горизонтальное выравнивание виджета.

свойство "headers-clickable"

  "headers-clickable"    gboolean              : read / write

заголовки столбцов реагируют на событие нажатия.

значение по умолчанию: false

свойство "headers-visible"

  "headers-visible"      gboolean              : read / write

показывать кнопки заголовков столбцов.

значение по умолчанию: true

свойство "hover-expand"

  "hover-expand"         gboolean              : read / write

включает или выключает плавающий режим для tree_view. плавающий режим заставляет строки сворачиваться или разворачиваться если указатель перемещается над ними.

это режим прежде всего для всплывающих просмотров дерева, например в gtkcombobox или gtkentrycompletion.

значение по умолчанию: false

начиная с версии 2.6

свойство "hover-selection"

  "hover-selection"      gboolean              : read / write

включает или выключает плавающее выделение для tree_view. плавающее выделение заставляет выделенную строку следовать за указателем. в настоящее время это работает только для режимов выделения gtk_selection_single и gtk_selection_browse.

это режим прежде всего для всплывающих просмотров дерева, например в gtkcombobox или gtkentrycompletion.

значение по умолчанию: false

начиная с версии 2.6

свойство "level-indentation"

  "level-indentation"    gint                  : read / write

дополнительный отступ для каждого уровня.

допустимые значения: >= 0

значение по умолчанию: 0

свойство "model"

  "model"                gtktreemodel          : read / write

модель для дерева просмотра.

свойство "reorderable"

  "reorderable"          gboolean              : read / write

возможность смены порядка.

значение по умолчанию: false

свойство "rubber-banding"

  "rubber-banding"       gboolean              : read / write

допускается ли выделение множества пунктов перемещением указателя.

значение по умолчанию: false

свойство "rules-hint"

  "rules-hint"           gboolean              : read / write

устанавливает подсказку для движка темы, чтобы отображать строки разными цветами.

значение по умолчанию: false

свойство "search-column"

  "search-column"        gint                  : read / write

столбец модели для поиска.

допустимые значения: >= -1

значение по умолчанию: -1

свойство "show-expanders"

  "show-expanders"       gboolean              : read / write

вид имеет расширители.

значение по умолчанию: true

свойство "vadjustment"

  "vadjustment"          gtkadjustment         : read / write

вертикальное выравнивание для виджета.

детали свойств стиля

свойство стиля "allow-rules"

  "allow-rules"          gboolean              : read

позволяет отображать строки разными цветами.

значение по умолчанию: true

свойство стиля "even-row-color"

  "even-row-color"       gdkcolor              : read

цвет используемый для четных строк.

свойство стиля "expander-size"

  "expander-size"        gint                  : read

размер расширяющей стрелки.

допустимые значения: >= 0

значение по умолчанию: 12

свойство стиля "grid-line-pattern"

  "grid-line-pattern"    gchararray            : read

шаблон черты используемый для отображения линий сетки дерева просмотра.

значение по умолчанию: "\001\001"

свойство стиля "grid-line-width"

  "grid-line-width"      gint                  : read

ширина в пикселах линий сетки дерева просмотра.

допустимые значения: >= 0

значение по умолчанию: 1

свойство стиля "horizontal-separator"

  "horizontal-separator" gint                  : read

горизонтальный интервал между ячейками. должен быть целым числом.

допустимые значения: >= 0

значение по умолчанию: 2

свойство стиля "indent-expanders"

  "indent-expanders"     gboolean              : read

создаёт выравнивание расширителя.

значение по умолчанию: true

свойство стиля "odd-row-color"

  "odd-row-color"        gdkcolor              : read

цвет для нечетных строк.

свойство стиля "row-ending-details"

  "row-ending-details"   gboolean              : read

включает расширенный фон строк.

значение по умолчанию: false

свойство стиля "tree-line-pattern"

  "tree-line-pattern"    gchararray            : read

шаблон черты используемой для отображения линий в дереве просмотра.

значение по умолчанию: "\001\001"

свойство стиля "tree-line-width"

  "tree-line-width"      gint                  : read

ширина линий дерева просмотра в пикселах.

допустимые значения: >= 0

значение по умолчанию: 1

свойство стиля "vertical-separator"

  "vertical-separator"   gint                  : read

вертикальный интервал между ячейками. должно быть целое число.

допустимые значения: >= 0

значение по умолчанию: 2

детали сигналов

сигнал "columns-changed"

void        user_function                  (gtktreeview *tree_view,
                                            gpointer     user_data)      : run last

изменение количества столбцов в дереве просмотра.

сигнал "cursor-changed"

void        user_function                  (gtktreeview *tree_view,
                                            gpointer     user_data)      : run last

изменение позиции курсора (фокусирование ячейки).

сигнал "expand-collapse-cursor-row"

gboolean    user_function                  (gtktreeview *treeview,
                                            gboolean     arg1,
                                            gboolean     arg2,
                                            gboolean     arg3,
                                            gpointer     user_data)      : run last / action

сигнал "move-cursor"

gboolean    user_function                  (gtktreeview     *treeview,
                                            gtkmovementstep *arg1,
                                            gint             arg2,
                                            gpointer         user_data)      : run last / action

сигнал "row-activated"

void        user_function                  (gtktreeview       *tree_view,
                                            gtktreepath       *path,
                                            gtktreeviewcolumn *column,
                                            gpointer           user_data)      : run last / action

сигнал "row-activated" издаётся когда вызван метод gtk_tree_view_row_activated() или пользователь два раза кликнул на строке дерева просмотра. он также издаётся когда выделена не редактируемая строка и одна из клавиш: space, shift+space, return или enter нажата.

для изучения обработки выделения обратитесь к разделу tree widget conceptual overview, а также к gtktreeselection.

сигнал "row-collapsed"

void        user_function                  (gtktreeview *tree_view,
                                            gtktreeiter *iter,
                                            gtktreepath *path,
                                            gpointer     user_data)      : run last

данная строка свернулась (дочерние элементы скрыты).

сигнал "row-expanded"

void        user_function                  (gtktreeview *tree_view,
                                            gtktreeiter *iter,
                                            gtktreepath *path,
                                            gpointer     user_data)      : run last

данная строка развернулась (дочерние элементы видимы).

сигнал "select-all"

gboolean    user_function                  (gtktreeview *treeview,
                                            gpointer     user_data)      : run last / action

сигнал "select-cursor-parent"

gboolean    user_function                  (gtktreeview *treeview,
                                            gpointer     user_data)      : run last / action

сигнал "select-cursor-row"

gboolean    user_function                  (gtktreeview *treeview,
                                            gboolean     arg1,
                                            gpointer     user_data)      : run last / action

сигнал "set-scroll-adjustments"

void        user_function                  (gtktreeview   *treeview,
                                            gtkadjustment *arg1,
                                            gtkadjustment *arg2,
                                            gpointer       user_data)      : run last / action

сигнал "start-interactive-search"

gboolean    user_function                  (gtktreeview *treeview,
                                            gpointer     user_data)      : run last / action

сигнал "test-collapse-row"

gboolean    user_function                  (gtktreeview *tree_view,
                                            gtktreeiter *iter,
                                            gtktreepath *path,
                                            gpointer     user_data)      : run last

данная строка предполагает сворачивание (скрытие дочерних элементов). используйте этот сигнал если вам нужно контролировать возможность сворачивания индивидуальных строк.

сигнал "test-expand-row"

gboolean    user_function                  (gtktreeview *tree_view,
                                            gtktreeiter *iter,
                                            gtktreepath *path,
                                            gpointer     user_data)      : run last

данная строка предполагает разворачивание (отображение дочерних элементов). используйте этот сигнал если вам нужно контролировать возможность разворачивания индивидуальных строк.

сигнал "toggle-cursor-row"

gboolean    user_function                  (gtktreeview *treeview,
                                            gpointer     user_data)      : run last / action

сигнал "unselect-all"

gboolean    user_function                  (gtktreeview *treeview,
                                            gpointer     user_data)      : run last / action

смотрите также

gtktreeviewcolumn, gtktreeselection, gtktreednd, gtktreemode, gtktreesortable, gtktreemodelsort, gtkliststore, gtktreestore, gtkcellrenderer, gtkcelleditable, gtkcellrendererpixbuf, gtkcellrenderertext, gtkcellrenderertoggle