|  |  |  | GTK+ Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Properties | ||||
#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);
GtkTreeModel *      gtk_cell_view_get_model             (GtkCellView *cell_view);
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" gchar* : Write "background-gdk" GdkColor* : Read / Write "background-set" gboolean : Read / Write "model" GtkTreeModel* : 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.
| 
 | 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 
| 
 | 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.
| 
 | 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.
| 
 | a GtkCellView | 
| 
 | a GtkTreeModel | 
Since 2.6
GtkTreeModel * gtk_cell_view_get_model (GtkCellView *cell_view);
Returns the model for cell_view. If no model is used NULL is
returned.
| 
 | a GtkCellView | 
| Returns : | a GtkTreeModel used or NULL | 
Since 2.16
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.
| 
 | a GtkCellView | 
| 
 | a GtkTreePath or NULLto unset. | 
Since 2.6
GtkTreePath * gtk_cell_view_get_displayed_row (GtkCellView *cell_view);
Returns a GtkTreePath referring to the currently 
displayed row. If no row is currently displayed, 
NULL is returned.
| 
 | a GtkCellView | 
| Returns : | the currently displayed row or NULL | 
Since 2.6
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.
| 
 | a GtkCellView | 
| 
 | a GtkTreePath | 
| 
 | 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.
| 
 | a GtkCellView | 
| 
 | the new background color | 
Since 2.6
GList * gtk_cell_view_get_cell_renderers (GtkCellView *cell_view);
gtk_cell_view_get_cell_renderers has been deprecated since version 2.18 and should not be used in newly-written code. use gtk_cell_layout_get_cells() instead.
Returns the cell renderers which have been added to 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" property"background" gchar* : Write
Background color as a string.
Default value: NULL
"background-gdk" property"background-gdk" GdkColor* : Read / Write
Background color as a GdkColor.
"background-set" property"background-set" gboolean : Read / Write
Whether this tag affects the background color.
Default value: FALSE