| GTK+ Reference Manual | |||
|---|---|---|---|
| <<< Previous Page | Home | Up | Next Page >>> | 
| "height" gint : Read / Write "is-expanded" gboolean : Read / Write "is-expander" gboolean : Read / Write "mode" GtkCellRendererMode : Read / Write "visible" gboolean : Read / Write "width" gint : Read / Write "xalign" gfloat : Read / Write "xpad" guint : Read / Write "yalign" gfloat : Read / Write "ypad" guint : Read / Write | 
| typedef enum
{
  GTK_CELL_RENDERER_SELECTED    = 1 << 0,
  GTK_CELL_RENDERER_PRELIT      = 1 << 1,
  GTK_CELL_RENDERER_INSENSITIVE = 1 << 2,
  /* this flag means the cell is in the sort column/row */
  GTK_CELL_RENDERER_SORTED      = 1 << 3
} GtkCellRendererState; | 
| typedef enum
{
  GTK_CELL_RENDERER_MODE_INERT,
  GTK_CELL_RENDERER_MODE_ACTIVATABLE,
  GTK_CELL_RENDERER_MODE_EDITABLE
} GtkCellRendererMode; | 
| void gtk_cell_renderer_get_size (GtkCellRenderer *cell, GtkWidget *widget, GdkRectangle *cell_area, gint *x_offset, gint *y_offset, gint *width, gint *height); | 
Obtains the width and height needed to render the cell. Used by view widgets to determine the appropriate size for the cell_area passed to gtk_cell_renderer_render(). If cell_area is not NULL, fills in the x and y offsets (if set) of the cell relative to this location. Please note that the values set in width and height, as well as those in x_offset and y_offset are inclusive of the xpad and ypad properties.
| cell : | |
| widget : | the widget the renderer is rendering to | 
| cell_area : | The area a cell will be allocated, or NULL | 
| x_offset : | location to return x offset of cell relative to cell_area, or NULL | 
| y_offset : | location to return y offset of cell relative to cell_area, or NULL | 
| width : | location to return width needed to render a cell, or NULL | 
| height : | location to return height needed to render a cell, or NULL | 
| void gtk_cell_renderer_render (GtkCellRenderer *cell, GdkWindow *window, GtkWidget *widget, GdkRectangle *background_area, GdkRectangle *cell_area, GdkRectangle *expose_area, GtkCellRendererState flags); | 
Invokes the virtual render function of the GtkCellRenderer. The three passed-in rectangles are areas of window. Most renderers will draw within cell_area; the xalign, yalign, xpad, and ypad fields of the GtkCellRenderer should be honored with respect to cell_area. background_area includes the blank space around the cell, and also the area containing the tree expander; so the background_area rectangles for all cells tile to cover the entire window. expose_area is a clip rectangle.
| cell : | |
| window : | a GdkDrawable to draw to | 
| widget : | the widget owning window | 
| background_area : | entire cell area (including tree expanders and maybe padding on the sides) | 
| cell_area : | area normally rendered by a cell renderer | 
| expose_area : | area that actually needs updating | 
| flags : | flags that affect rendering | 
| gboolean gtk_cell_renderer_activate (GtkCellRenderer *cell, GdkEvent *event, GtkWidget *widget, const gchar *path, GdkRectangle *background_area, GdkRectangle *cell_area, GtkCellRendererState flags); | 
Passes an activate event to the cell renderer for possible processing. Some cell renderers may use events; for example, GtkCellRendererToggle toggles when it gets a mouse click.
| cell : | |
| event : | a GdkEvent | 
| widget : | widget that received the event | 
| path : | widget-dependent string representation of the event location; e.g. for GtkTreeView, a string representation of GtkTreePath | 
| background_area : | background area as passed to gtk_cell_renderer_render | 
| cell_area : | cell area as passed to gtk_cell_renderer_render | 
| flags : | render flags | 
| Returns : | TRUE if the event was consumed/handled | 
| GtkCellEditable* gtk_cell_renderer_start_editing (GtkCellRenderer *cell, GdkEvent *event, GtkWidget *widget, const gchar *path, GdkRectangle *background_area, GdkRectangle *cell_area, GtkCellRendererState flags); | 
Passes an activate event to the cell renderer for possible processing.
| cell : | |
| event : | a GdkEvent | 
| widget : | widget that received the event | 
| path : | widget-dependent string representation of the event location; e.g. for GtkTreeView, a string representation of GtkTreePath | 
| background_area : | background area as passed to gtk_cell_renderer_render | 
| cell_area : | cell area as passed to gtk_cell_renderer_render | 
| flags : | render flags | 
| Returns : | A new GtkCellEditable, or NULL | 
| void        gtk_cell_renderer_get_fixed_size
                                            (GtkCellRenderer *cell,
                                             gint *width,
                                             gint *height); | 
Fills in width and height with the appropriate size of cell.
| cell : | |
| width : | location to fill in with the fixed width of the widget, or NULL | 
| height : | location to fill in with the fixed height of the widget, or NULL | 
| "height" (gint : Read / Write) | The fixed height. | 
| "is-expanded" (gboolean : Read / Write) | Row is an expander row, and is expanded. | 
| "is-expander" (gboolean : Read / Write) | Row has children. | 
| "mode" (GtkCellRendererMode : Read / Write) | Editable mode of the CellRenderer. | 
| "visible" (gboolean : Read / Write) | Display the cell. | 
| "width" (gint : Read / Write) | The fixed width. | 
| "xalign" (gfloat : Read / Write) | The x-align. | 
| "xpad" (guint : Read / Write) | The xpad. | 
| "yalign" (gfloat : Read / Write) | The y-align. | 
| "ypad" (guint : Read / Write) | The ypad. |