Pileus Git - ~andy/gtk/blob - docs/reference/gtk/tmpl/gtkcellrenderer.sgml

   1 <!-- ##### SECTION Title ##### -->
   2 GtkCellRenderer
   3
   4 <!-- ##### SECTION Short_Description ##### -->
   5 An object for rendering a single cell on a #GdkDrawable
   6
   7 <!-- ##### SECTION Long_Description ##### -->
   8 <para>
   9 The #GtkCellRenderer is a base class of a set of objects used for
  10 rendering a cell to a #GdkDrawable.  These objects are used primarily by
  11 the #GtkTreeView widget, though they aren't tied to them in any
  12 specific way.  It is worth noting that #GtkCellRenderer is not a
  13 #GtkWidget and cannot be treated as such.
  14 </para>
  15
  16 <para>
  17 The primary use of a #GtkCellRenderer is for drawing a certain graphical
  18 elements on a #GdkDrawable.  Typically, one cell renderer is used to
  19 draw many cells on the screen.  To this extent, it isn't expected that a
  20 CellRenderer keep any permanent state around.  Instead, any state is set
  21 just prior to use using #GObject<!-- -->s property system.  Then, the
  22 cell is measured using @gtk_cell_renderer_get_size.  Finally, the cell
  23 is rendered in the correct location using @gtk_cell_renderer_render.
  24 </para>
  25
  26 <para>
  27 There are a number of rules that must be followed when writing a new
  28 #GtkCellRenderer.  First and formost, it's important that a certain set
  29 of properties will always yield a cell renderer of the same size,
  30 barring a #GtkStyle change.  The #GtkCellRenderer also has a number of
  31 generic properties that are expected to be honored by all children.
  32 </para>
  33
  34 <!-- ##### SECTION See_Also ##### -->
  35 <para>
  36 #GtkCellRendererText,#GtkCellRendererPixbuf,#GtkCellRendererToggle
  37 </para>
  38
  39 <!-- ##### ENUM GtkCellRendererState ##### -->
  40 <para>
  41 Tells how a cell is to be rendererd.
  42 </para>
  43
  44 @GTK_CELL_RENDERER_SELECTED: The cell is currently selected, and
  45 probably has a selection colored background to render to.
  46 @GTK_CELL_RENDERER_PRELIT: The mouse is hovering over the cell.
  47 @GTK_CELL_RENDERER_INSENSITIVE: The cell is drawn in an insensitive manner
  48 @GTK_CELL_RENDERER_SORTED: The cell is in a sorted row
  49 @GTK_CELL_RENDERER_FOCUSED:
  50
  51 <!-- ##### ENUM GtkCellRendererMode ##### -->
  52 <para>
  53 Identifies how the user can interact with a particular cell.
  54 </para>
  55
  56 @GTK_CELL_RENDERER_MODE_INERT: The cell is just for display
  57 and cannot be interacted with.  Note that this doesn't mean that eg. the
  58 row being drawn can't be selected -- just that a particular element of
  59 it cannot be individually modified.
  60 @GTK_CELL_RENDERER_MODE_ACTIVATABLE: The cell can be clicked.
  61 @GTK_CELL_RENDERER_MODE_EDITABLE: The cell can be edited or otherwise modified.
  62
  63 <!-- ##### STRUCT GtkCellRenderer ##### -->
  64 <para>
  65
  66 </para>
  67
  68
  69 <!-- ##### ARG GtkCellRenderer:cell-background ##### -->
  70 <para>
  71
  72 </para>
  73
  74 <!-- ##### ARG GtkCellRenderer:cell-background-gdk ##### -->
  75 <para>
  76
  77 </para>
  78
  79 <!-- ##### ARG GtkCellRenderer:cell-background-set ##### -->
  80 <para>
  81
  82 </para>
  83
  84 <!-- ##### ARG GtkCellRenderer:height ##### -->
  85 <para>
  86
  87 </para>
  88
  89 <!-- ##### ARG GtkCellRenderer:is-expanded ##### -->
  90 <para>
  91
  92 </para>
  93
  94 <!-- ##### ARG GtkCellRenderer:is-expander ##### -->
  95 <para>
  96
  97 </para>
  98
  99 <!-- ##### ARG GtkCellRenderer:mode ##### -->
 100 <para>
 101
 102 </para>
 103
 104 <!-- ##### ARG GtkCellRenderer:visible ##### -->
 105 <para>
 106
 107 </para>
 108
 109 <!-- ##### ARG GtkCellRenderer:width ##### -->
 110 <para>
 111
 112 </para>
 113
 114 <!-- ##### ARG GtkCellRenderer:xalign ##### -->
 115 <para>
 116
 117 </para>
 118
 119 <!-- ##### ARG GtkCellRenderer:xpad ##### -->
 120 <para>
 121
 122 </para>
 123
 124 <!-- ##### ARG GtkCellRenderer:yalign ##### -->
 125 <para>
 126
 127 </para>
 128
 129 <!-- ##### ARG GtkCellRenderer:ypad ##### -->
 130 <para>
 131
 132 </para>
 133
 134 <!-- ##### FUNCTION gtk_cell_renderer_get_size ##### -->
 135 <para>
 136
 137 </para>
 138
 139 @cell:
 140 @widget:
 141 @cell_area:
 142 @x_offset:
 143 @y_offset:
 144 @width:
 145 @height:
 146
 147
 148 <!-- ##### FUNCTION gtk_cell_renderer_render ##### -->
 149 <para>
 150
 151 </para>
 152
 153 @cell:
 154 @window:
 155 @widget:
 156 @background_area:
 157 @cell_area:
 158 @expose_area:
 159 @flags:
 160
 161
 162 <!-- ##### FUNCTION gtk_cell_renderer_activate ##### -->
 163 <para>
 164
 165 </para>
 166
 167 @cell:
 168 @event:
 169 @widget:
 170 @path:
 171 @background_area:
 172 @cell_area:
 173 @flags:
 174 @Returns:
 175
 176
 177 <!-- ##### FUNCTION gtk_cell_renderer_start_editing ##### -->
 178 <para>
 179
 180 </para>
 181
 182 @cell:
 183 @event:
 184 @widget:
 185 @path:
 186 @background_area:
 187 @cell_area:
 188 @flags:
 189 @Returns:
 190
 191
 192 <!-- ##### FUNCTION gtk_cell_renderer_get_fixed_size ##### -->
 193 <para>
 194
 195 </para>
 196
 197 @cell:
 198 @width:
 199 @height:
 200
 201
 202 <!-- ##### FUNCTION gtk_cell_renderer_set_fixed_size ##### -->
 203 <para>
 204
 205 </para>
 206
 207 @cell:
 208 @width:
 209 @height:
 210
 211