enum GtkTreeViewColumnSizing

typedef enum
{
  GTK_TREE_VIEW_COLUMN_GROW_ONLY,
  GTK_TREE_VIEW_COLUMN_AUTOSIZE,
  GTK_TREE_VIEW_COLUMN_FIXED
} GtkTreeViewColumnSizing;

Méthode de calibrage des colonnes utilisée pour déterminer leur largeur.  Notez que  GTK_TREE_VIEW_COLUMN_AUTOSIZE n'a aucun effet pour de grand visualiseur et peut donner aux colonnes un aspect irrégulier.

GtkTreeCellDataFunc ()

void                (*GtkTreeCellDataFunc)              (GtkTreeViewColumn *tree_column,
                                                         GtkCellRenderer *cell,
                                                         GtkTreeModel *tree_model,
                                                         GtkTreeIter *iter,
                                                         gpointer data);

GtkTreeViewColumn

typedef struct _GtkTreeViewColumn GtkTreeViewColumn;

gtk_tree_view_column_new ()

GtkTreeViewColumn*  gtk_tree_view_column_new            (void);

Crée une nouvelle  GtkTreeViewColumn.

gtk_tree_view_column_new_with_attributes ()

GtkTreeViewColumn*  gtk_tree_view_column_new_with_attributes
                                                        (const gchar *title,
                                                         GtkCellRenderer *cell,
                                                         ...);

Crée une nouvelle GtkTreeViewColumn avec un nombre de valeurs par défaut. Cela équivaut à appeler  gtk_tree_view_column_set_title(), gtk_tree_view_column_pack_start(), et gtk_tree_view_column_set_attributes() sur la GtkTreeViewColumn nouvellement créée.

Voici un  exemple simple :

 enum { COLONNE_TEXTE, COLONNE_COULEUR, N_COLONNE };
 ...
 {
   GtkTreeViewColumn *column;
   GtkCellRenderer   *renderer = gtk_cell_renderer_text_new ();
 
   column = gtk_tree_view_column_new_with_attributes ("Titre",
                                                      renderer,
                                                      "text", COLONNE_TEXTE,
                                                      "foreground", COLONNE_COULEUR,
                                                      NULL);
 }

gtk_tree_view_column_pack_start ()

void                gtk_tree_view_column_pack_start     (GtkTreeViewColumn *tree_column,
                                                         GtkCellRenderer *cell,
                                                         gboolean expand);

Place la cellule cell au début de la colonne. Si expand prend la valeur FALSE, alors la cellule cell aura exactement l'espace dont elle a besoin. Tout espace inutilisé sera dividé également et partagé entre les cellules pour lesquelles  expand prend la valeur TRUE.

gtk_tree_view_column_pack_end ()

void                gtk_tree_view_column_pack_end       (GtkTreeViewColumn *tree_column,
                                                         GtkCellRenderer *cell,
                                                         gboolean expand);

Ajoute une cellule à la fin de la colonne. Si expand prend la valeur FALSE, alors la cellule cell aura exactement l'espace dont elle a besoin. Tout espace inutilisé sera dividé également et partagé entre les cellules pour lesquelles  expand prend la valeur TRUE.

gtk_tree_view_column_clear ()

void                gtk_tree_view_column_clear          (GtkTreeViewColumn *tree_column);

Supprime toutes les applications sur tous les afficheurs dans la colonne d'arbre  tree_column.

gtk_tree_view_column_get_cell_renderers ()

GList*              gtk_tree_view_column_get_cell_renderers
                                                        (GtkTreeViewColumn *tree_column);

Retourne une GList nouvellement allouée de tous les afficheurs de cellules de la colonne, sans ordre particulier. La liste doit être libérée avec g_list_free().

gtk_tree_view_column_add_attribute ()

void                gtk_tree_view_column_add_attribute  (GtkTreeViewColumn *tree_column,
                                                         GtkCellRenderer *cell_renderer,
                                                         const gchar *attribute,
                                                         gint column);

Ajoute un attribute mapping à la liste dans une colonne d'arbre tree_column. La colonne column est la colonne d'un magasin de laquelle on extrait la valeur et l'attribut  attribute est le paramètre de l'afficheur de cellule  cell_rendererqui définit cette valeur. Ainsi par exemple si la colonne 2 du magasin contient des chaînes de caractères vous pourrez donner l'attribut "text" d'un  GtkCellRendererText aux valeurs de la colonne 2.

(traduction très tordue, à revoir )

gtk_tree_view_column_set_attributes ()

void                gtk_tree_view_column_set_attributes (GtkTreeViewColumn *tree_column,
                                                         GtkCellRenderer *cell_renderer,
                                                         ...);

Définit des attributs de la liste comme attributs de la colonne d'arbre tree_column. Les attributs doivent être dans l'ordre des attributs/ colonnes, comme dans  gtk_tree_view_column_add_attribute(). Tous les attributs existants sont supprimés et remplacés par les nouveaux attributs.

gtk_tree_view_column_set_cell_data_func ()

void                gtk_tree_view_column_set_cell_data_func
                                                        (GtkTreeViewColumn *tree_column,
                                                         GtkCellRenderer *cell_renderer,
                                                         GtkTreeCellDataFunc func,
                                                         gpointer func_data,
                                                         GtkDestroyNotify destroy);

Définit la  fonction  GtkTreeViewColumnFuncutilisée pour la colonne. Cette fonction est utilisée à la place de l'application standard des attributs pour configurer les valeur de la colonne, et peut définir les valeurs de l'afficheur de cellule de  tree_column's de façon appropriée . func peut être  NULL pour en supprimer une plus ancienne.

gtk_tree_view_column_clear_attributes ()

void                gtk_tree_view_column_clear_attributes
                                                        (GtkTreeViewColumn *tree_column,
                                                         GtkCellRenderer *cell_renderer);

Efface tous les attributs existant définit préalablement avec gtk_tree_view_column_set_attributes().

gtk_tree_view_column_set_spacing ()

void                gtk_tree_view_column_set_spacing    (GtkTreeViewColumn *tree_column,
                                                         gint spacing);

Définit le champ d'espacement de tree_column qui est le nombre de pixels placés entre les afficheurs de cellule rangés à l'intérieur de la colonne d'arbre.

gtk_tree_view_column_get_spacing ()

gint                gtk_tree_view_column_get_spacing    (GtkTreeViewColumn *tree_column);

Retourne l'espacement de la colonne  tree_column.

gtk_tree_view_column_set_visible ()

void                gtk_tree_view_column_set_visible    (GtkTreeViewColumn *tree_column,
                                                         gboolean visible);

Définit la visibilité de la colonne d'arbre tree_column.

gtk_tree_view_column_get_visible ()

gboolean            gtk_tree_view_column_get_visible    (GtkTreeViewColumn *tree_column);

Retourne  TRUE si la colonne d'arbre  tree_column est visible.

gtk_tree_view_column_set_resizable ()

void                gtk_tree_view_column_set_resizable  (GtkTreeViewColumn *tree_column,
                                                         gboolean resizable);

Si resizable est TRUE, alors l'utilisateur peut redimensionner la colonne en saisissant le bord externe du bouton ? de la colonne . Si le redimensionnement est  TRUE et que le mode de redimensionnement de la colonne est  GTK_TREE_VIEW_COLUMN_AUTOSIZE, alors le mode change pour prendre la valeur GTK_TREE_VIEW_COLUMN_GROW_ONLY.

gtk_tree_view_column_get_resizable ()

gboolean            gtk_tree_view_column_get_resizable  (GtkTreeViewColumn *tree_column);

Retourne TRUE si la colonne d'arbre  tree_column peut être redimensionnée par l'utilisateur (end user)

gtk_tree_view_column_set_sizing ()

void                gtk_tree_view_column_set_sizing     (GtkTreeViewColumn *tree_column,
                                                         GtkTreeViewColumnSizing type);

gtk_tree_view_column_get_sizing ()

GtkTreeViewColumnSizing gtk_tree_view_column_get_sizing (GtkTreeViewColumn *tree_column);

gtk_tree_view_column_get_width ()

gint                gtk_tree_view_column_get_width      (GtkTreeViewColumn *tree_column);

Retourne la taille courante de la colonne d'arbre  tree_column en pixels.

gtk_tree_view_column_get_fixed_width ()

gint                gtk_tree_view_column_get_fixed_width
                                                        (GtkTreeViewColumn *tree_column);

Récupére la largeur fixée pour la colonne. Cette valeur n'est pas forcément la largeur de la colonne affichée à l'écran, elle correspond seulement à la largeur demandée à sa création.

gtk_tree_view_column_set_fixed_width ()

void                gtk_tree_view_column_set_fixed_width
                                                        (GtkTreeViewColumn *tree_column,
                                                         gint fixed_width);

Définit la taille de la colonne en pixels. Cela a une signification uniquement si le type de redimensionnement est  GTK_TREE_VIEW_COLUMN_FIXED. La taille de la colonne est comprise entre une largeur minimale et une largeur maximal. Notez que la largeur min/max  de la colonne ne concerne pas la propriété "fixed_width"(largeur_fixée)  du widget  mais simplement la taille d'affichage courant de la colonne.

gtk_tree_view_column_set_min_width ()

void                gtk_tree_view_column_set_min_width  (GtkTreeViewColumn *tree_column,
                                                         gint min_width);

Définit la largeur minimale de la colonne tree_column. Si min_width est -1, alors la largeur minimale n'est pas définie.

gtk_tree_view_column_get_min_width ()

gint                gtk_tree_view_column_get_min_width  (GtkTreeViewColumn *tree_column);

gtk_tree_view_column_set_max_width ()

void                gtk_tree_view_column_set_max_width  (GtkTreeViewColumn *tree_column,
                                                         gint max_width);

Dédinit la largeur maximal d'une colonne d'arbre tree_column. Si max_width est -1, alors la largeur maximale n'est pas définie.Notez qu'en réalité la colonne peut être plus large que la largeur maximale si c'est la dernière colonne d'un visualisateur. Dans ce cas, la colonne prendra toute la place restante.

gtk_tree_view_column_get_max_width ()

gint                gtk_tree_view_column_get_max_width  (GtkTreeViewColumn *tree_column);

Retourne la largeur maximale d'une colonne d'arbre  tree_column en pixels ou -1 si la largeur maximale n'est pas définie.

gtk_tree_view_column_clicked ()

void                gtk_tree_view_column_clicked        (GtkTreeViewColumn *tree_column);

Emet le signal "clicked" sur la colonne. Cette focntion ne fonctionne que si la colonne tree_column est "cliquable"

gtk_tree_view_column_set_title ()

void                gtk_tree_view_column_set_title      (GtkTreeViewColumn *tree_column,
                                                         const gchar *title);

Définit le titre de la colonne  tree_column. Si un widget (custom) est définit alors cette valeur est ignorée.

gtk_tree_view_column_get_title ()

const gchar*        gtk_tree_view_column_get_title      (GtkTreeViewColumn *tree_column);

Retourne le titre du widget.

gtk_tree_view_column_set_expand ()

void                gtk_tree_view_column_set_expand     (GtkTreeViewColumn *tree_column,
                                                         gboolean expand);

Définit la colonne qui sera chargée d'occuper la place supplémentaire. Cet espace est partagé également entre toutes les colonne qui ont l'attribut d'étirement défini à TRUE. Si aucune colonne n'a cette option définie, alors la dernière colonne prend tout l'espace disponible en plus. Par défaut toutes les colonnes sont créé avec l'option définie à  FALSE.

Depuis 2.4

gtk_tree_view_column_get_expand ()

gboolean            gtk_tree_view_column_get_expand     (GtkTreeViewColumn *tree_column);

Retourne TRUE si la colonne peut s'étirer pour occuper l'espace disponible.

Depuis 2.4

gtk_tree_view_column_set_clickable ()

void                gtk_tree_view_column_set_clickable  (GtkTreeViewColumn *tree_column,
                                                         gboolean clickable);

Définit l'entête qui sera actif si  active est à TRUE. Quand l'entête est active, elle peut prendre le focus clavier et peut être "cliquée".

gtk_tree_view_column_get_clickable ()

gboolean            gtk_tree_view_column_get_clickable  (GtkTreeViewColumn *tree_column);

Retourne  TRUE si l'utilisateur peut clique sur l'entête de la colonne.

gtk_tree_view_column_set_widget ()

void                gtk_tree_view_column_set_widget     (GtkTreeViewColumn *tree_column,
                                                         GtkWidget *widget);

Définit comme widget le  widget qui est à l'intérieur de l'entête. Si le widget est  NULL alors le bouton de l'entête est définit avec un  GtkLabel du titre de la colonne d'arbre  tree_column.

gtk_tree_view_column_get_widget ()

GtkWidget*          gtk_tree_view_column_get_widget     (GtkTreeViewColumn *tree_column);

Retourne le  GtkWidget dans le bouton de l'entête de la colonne. Si un widget (costum) n'a pas été défini alors NULL est retourné.

gtk_tree_view_column_set_alignment ()

void                gtk_tree_view_column_set_alignment  (GtkTreeViewColumn *tree_column,
                                                         gfloat xalign);

Définit l'alignement du titre du widget configuré dans l'entête de colonne. m'alignement détermine la position du titre dans le bouton -- 0. pour gauche, 0.5 pour centre et 1.0 pour droite.

gtk_tree_view_column_get_alignment ()

gfloat              gtk_tree_view_column_get_alignment  (GtkTreeViewColumn *tree_column);

Retourne l'alignement courant x de la colonne d'arbre  tree_column. Cette valeur est comprise entre  0.0 et 1.0.

gtk_tree_view_column_set_reorderable ()

void                gtk_tree_view_column_set_reorderable
                                                        (GtkTreeViewColumn *tree_column,
                                                         gboolean reorderable);

Si reorderable est TRUE  alors la colonne peut être réajustée par l'utilisateur en faisant glisser l'entête.

gtk_tree_view_column_get_reorderable ()

gboolean            gtk_tree_view_column_get_reorderable
                                                        (GtkTreeViewColumn *tree_column);

Retourne  TRUE si la colonne d'arbre  tree_column peut -être réajustée par l'utilisateur.

gtk_tree_view_column_set_sort_column_id ()

void                gtk_tree_view_column_set_sort_column_id
                                                        (GtkTreeViewColumn *tree_column,
                                                         gint sort_column_id);

Définit l'identifiant logique  sort_column_idque la colonne utilise pour le tri quand la colonne est sélectionnée pour être triée. Rend également la colonne "cliquable".

gtk_tree_view_column_get_sort_column_id ()

gint                gtk_tree_view_column_get_sort_column_id
                                                        (GtkTreeViewColumn *tree_column);

Récupère l'idnetifiant logique sort_column_id utilisé pour le tri du magasin quand la colonne est sélectionnée pour petre triée. Voir  gtk_tree_view_column_set_sort_column_id().

gtk_tree_view_column_set_sort_indicator ()

void                gtk_tree_view_column_set_sort_indicator
                                                        (GtkTreeViewColumn *tree_column,
                                                         gboolean setting);

Cette fonction doit être appelée avec a setting définit à  TRUE pour afficher un flêche dans bouton de l'entête indiquant que la colonne est triée. Il faut appeler  gtk_tree_view_column_set_sort_order() pour changer la direction de la flêche.

gtk_tree_view_column_get_sort_indicator ()

gboolean            gtk_tree_view_column_get_sort_indicator
                                                        (GtkTreeViewColumn *tree_column);

Récupère la valeur définie par  gtk_tree_view_column_set_sort_indicator().

gtk_tree_view_column_set_sort_order ()

void                gtk_tree_view_column_set_sort_order (GtkTreeViewColumn *tree_column,
                                                         GtkSortType order);

Change l'apparence de l'indicateur de tri.

Cela ne trie pas réellement le magasin. Utilisez  gtk_tree_view_column_set_sort_column_id()si vous voulez un fonction de tri automatique. Cette fonction existe pour configurer le comportement du tru et ne peut pas être utilisée en conjoncture avec  gtk_tree_sortable_set_sort_column(). Pour configurer des magasins, le mécanisme changera.

L'indicateur de tri change de diretion pour indiquer un tri dans le sens normal ou dans le sens invers. Notez qu'il faut que vous activiez l'indicateur de tri pour voir quelque chose quand vous appelez cette fonction; voir  gtk_tree_view_column_set_sort_indicator().

gtk_tree_view_column_get_sort_order ()

GtkSortType         gtk_tree_view_column_get_sort_order (GtkTreeViewColumn *tree_column);

Récupère la valeur définie par gtk_tree_view_column_set_sort_order().

gtk_tree_view_column_cell_set_cell_data ()

void                gtk_tree_view_column_cell_set_cell_data
                                                        (GtkTreeViewColumn *tree_column,
                                                         GtkTreeModel *tree_model,
                                                         GtkTreeIter *iter,
                                                         gboolean is_expander,
                                                         gboolean is_expanded);

Configure l'afficheur de cellule basé sur le magasin tree_model et iter. C'est à dire que pour tout attribut intégré dans la colonne d'arbre tree_column, une valeur sera récupérée pour l'ensemble des colonnes pour cet  iter. Cette valeur sera utilisée pour configurer l'attribut dans l'afficheur de cellules. Cela est utilisé principalement par les GtkTreeView.

J'ai eu bcp de mal pour cette fonction alors je mets le texte en anglais ici : Sets the cell renderer based on the tree_model and iter. That is, for every attribute mapping in tree_column, it will get a value from the set column on the iter, and use that value to set the attribute on the cell renderer. This is used primarily by the GtkTreeView.

gtk_tree_view_column_cell_get_size ()

void                gtk_tree_view_column_cell_get_size  (GtkTreeViewColumn *tree_column,
                                                         GdkRectangle *cell_area,
                                                         gint *x_offset,
                                                         gint *y_offset,
                                                         gint *width,
                                                         gint *height);

Récupère la largeur et la hauteur d'affichage de la colonne. Utilisée principalement par les GtkTreeView.

gtk_tree_view_column_cell_get_position ()

gboolean            gtk_tree_view_column_cell_get_position
                                                        (GtkTreeViewColumn *tree_column,
                                                         GtkCellRenderer *cell_renderer,
                                                         gint *start_pos,
                                                         gint *width);

Récupére la position horizontale et la taille de la cellule dans la colonne. Si la cellule n'est pas trouvée dans la colonne,  start_pos et width ne change pas et  FALSE est retourné.

gtk_tree_view_column_cell_is_visible ()

gboolean            gtk_tree_view_column_cell_is_visible
                                                        (GtkTreeViewColumn *tree_column);

Retourne  TRUE si toutes les cellules placées dans la colonne d'arbre  tree_column sont visibles. Pour que cela soit significatif, vous devez d'abord initilaiser les cellules avec  gtk_tree_view_column_cell_set_cell_data()

gtk_tree_view_column_focus_cell ()

void                gtk_tree_view_column_focus_cell     (GtkTreeViewColumn *tree_column,
                                                         GtkCellRenderer *cell);

Place le focus clavier courant sur  cell, si la colonne contient 2 ou plusieurs cellules éditables et activales.

Depuis 2.2

gtk_tree_view_column_queue_resize ()

void                gtk_tree_view_column_queue_resize   (GtkTreeViewColumn *tree_column);

Depuis  2.8

gtk_tree_view_column_get_tree_view ()

GtkWidget*          gtk_tree_view_column_get_tree_view  (GtkTreeViewColumn *tree_column);

Retourne le  GtkTreeView dans lequel la colonne d'arbe  tree_column a été inserrée. si tree_column n'est inserrée dans aucun visualiseur d'arbre alors  NULL est retourné.

Depuis 2.12

La propriété  "alignment" 

  "alignment"                gfloat                : Lecture / Ecriture

Alignement X Alignment du texte ou du widget dans l'entête de colonne.

Valeurs possibles: [0,1]

Valeur par défaut: 0

La propriété "clickable" 

  "clickable"                gboolean              : Lecture /Ecriture

Si l'entête peut être cliquée.

Valeur par défaut: FALSE

La propriété  "expand" 

  "expand"                   gboolean              : Lecture /Ecriture

La colonne prend part au partage de la largeur supplémentaire allouée au widget.

Valeur par défaut: FALSE

La propriété  "fixed-width" 

  "fixed-width"              gint                  : Lecture /Ecriture

Largeur fixe courante de la colonne.

Valeurs possibles: >= 1

Valeur par défaut: 1

La propriété  "max-width" 

  "max-width"                gint                  : Lecture /Ecriture

Largeur maximale de la  colonne.

Valeurs possibles: >= -1

Valeur par défaut: -1

La propriété  "min-width" 

  "min-width"                gint                  : Lecture /Ecriture

Largeur minimale de la colonne.

Valeurs possibles: >= -1

Valeur par défaut: -1

La propriété  "reorderable" 

  "reorderable"              gboolean              : Lecture /Ecriture

 Si la colonne peut être reordered around the headers.

Valeur par défaut: FALSE

La propriété  "resizable" 

  "resizable"                gboolean              : Lecture /Ecriture

L'utilisateur peut redimensionner la colonne.

Valeur par défaut: FALSE

La propriété  "sizing" 

  "sizing"                   GtkTreeViewColumnSizing  : Lecture /Ecriture

Mode de redimensionnement de la colonne.

Valeur par défaut: GTK_TREE_VIEW_COLUMN_GROW_ONLY

La propriété  "sort-indicator" 

  "sort-indicator"           gboolean              : Lecture /Ecriture

Pour afficher un indicateur de tri.

Valeur par défaut: FALSE

La propriété  "sort-order" 

  "sort-order"               GtkSortType           : Lecture /Ecriture

Direction de tri que l'indicateur de tri doit afficher.

Valeur par défaut: GTK_SORT_ASCENDING

La propriété  "spacing" 

  "spacing"                  gint                  : Lecture /Ecriture

Espace qui est inserré entre les cellules.

Valeurs possibles: >= 0

Valeur par défaut: 0

La propriété  "title" 

"title"                    gchararray            : Lecture /Ecriture

Titre qui apparaît dans l'entête de colonne.

Valeur par défaut: ""

La propriété  "visible" 

  "visible"                  gboolean              : Lecture /Ecriture

Pour afficher la colonne.

Valeur par défaut: TRUE

La propriété  "widget" 

  "widget"                   GtkWidget             : Lecture /Ecriture

Widget placé dans le bouton de l'entête de colonne à la place du titre.

La propriété  "width" 

  "width"                    gint                  : Lecture

Largeur courante de la colonne.

Valeurs possibles: >= 0

Valeur par défaut: 0

Le signal "clicked" 

void                user_function                      (GtkTreeViewColumn *treeviewcolumn,
                                                        gpointer           user_data)           : Run Last