GTK+ 2 Reference Manual | ||||
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces | Properties |
#include <gtk/gtk.h> struct 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 it show markup
. The 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. [allow-none] |
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 . [transfer none]
|
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 NULL to unset. [allow-none]
|
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. [out] |
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