GTK+ Reference Manual |
---|
GtkCellViewGtkCellView — A widget displaying a single row of a GtkTreeModel |
#include <gtk/gtk.h> GtkCellView; GtkWidget* gtk_cell_view_new (void); GtkWidget* gtk_cell_view_new_with_text (const gchar *text); GtkWidget* gtk_cell_view_new_with_markup (const gchar *markup); GtkWidget* gtk_cell_view_new_with_pixbuf (GdkPixbuf *pixbuf); void gtk_cell_view_set_model (GtkCellView *cell_view, GtkTreeModel *model); void gtk_cell_view_set_displayed_row (GtkCellView *cell_view, GtkTreePath *path); GtkTreePath* gtk_cell_view_get_displayed_row (GtkCellView *cell_view); gboolean gtk_cell_view_get_size_of_row (GtkCellView *cell_view, GtkTreePath *path, GtkRequisition *requisition); void gtk_cell_view_set_background_color (GtkCellView *cell_view, const GdkColor *color); GList* gtk_cell_view_get_cell_renderers (GtkCellView *cell_view);
"background" gchararray : Write "background-gdk" GdkColor : Read / Write "background-set" gboolean : Read / Write
A GtkCellView displays a single row of a GtkTreeModel, using cell renderers just like GtkTreeView. GtkCellView doesn't support some of the more complex features of GtkTreeView, like cell editing and drag and drop.
GtkWidget* gtk_cell_view_new (void);
Creates a new GtkCellView widget.
Returns : | A newly created GtkCellView widget. |
Since 2.6
GtkWidget* gtk_cell_view_new_with_text (const gchar *text);
Creates a new GtkCellView widget, adds a GtkCellRendererText to it, and makes its show text.
text : | the text to display in the cell view |
Returns : | A newly created GtkCellView widget. |
Since 2.6
GtkWidget* gtk_cell_view_new_with_markup (const gchar *markup);
Creates a new GtkCellView widget, adds a GtkCellRendererText
to it, and makes its show markup. The text can text can be
marked up with the
markup : | the text to display in the cell view |
Returns : | A newly created GtkCellView widget. |
Since 2.6
GtkWidget* gtk_cell_view_new_with_pixbuf (GdkPixbuf *pixbuf);
Creates a new GtkCellView widget, adds a GtkCellRendererPixbuf to it, and makes its show pixbuf.
pixbuf : | the image to display in the cell view |
Returns : | A newly created GtkCellView widget. |
Since 2.6
void gtk_cell_view_set_model (GtkCellView *cell_view, GtkTreeModel *model);
Sets the model for cell_view. If cell_view already has a model set, it will remove it before setting the new model. If model is NULL, then it will unset the old model.
cell_view : | a GtkCellView |
model : | a GtkTreeModel |
Since 2.6
void gtk_cell_view_set_displayed_row (GtkCellView *cell_view, GtkTreePath *path);
Sets the row of the model that is currently displayed by the GtkCellView. If the path is unset, then the contents of the cellview "stick" at their last value; this is not normally a desired result, but may be a needed intermediate state if say, the model for the GtkCellView becomes temporarily empty.
cell_view : | a GtkCellView |
path : | a GtkTreePath or NULL to unset. |
Since 2.6
GtkTreePath* gtk_cell_view_get_displayed_row (GtkCellView *cell_view);
cell_view : | |
Returns : |
gboolean gtk_cell_view_get_size_of_row (GtkCellView *cell_view, GtkTreePath *path, GtkRequisition *requisition);
Sets requisition to the size needed by cell_view to display the model row pointed to by path.
cell_view : | a GtkCellView |
path : | a GtkTreePath |
requisition : | return location for the size |
Returns : | TRUE |
Since 2.6
void gtk_cell_view_set_background_color (GtkCellView *cell_view, const GdkColor *color);
Sets the background color of view.
cell_view : | a GtkCellView |
color : | the new background color |
Since 2.6
GList* gtk_cell_view_get_cell_renderers (GtkCellView *cell_view);
Returns the cell renderers which have been added to cell_view.
cell_view : | a GtkCellView |
Returns : | a list of cell renderers. The list, but not the renderers has been newly allocated and should be freed with g_list_free() when no longer needed. |
Since 2.6
"background" gchararray : Write
Background color as a string.
Default value: NULL
"background-gdk" GdkColor : Read / Write
Background color as a GdkColor.
"background-set" gboolean : Read / Write
Whether this tag affects the background color.
Default value: FALSE
<< GtkTreeView drag-and-drop | GtkIconView >> |