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 <!-- ##### SIGNAL GtkCellRenderer::editing-canceled ##### -->
  70 <para>
  71
  72 </para>
  73
  74 @cellrenderer: the object which received the signal.
  75
  76 <!-- ##### ARG GtkCellRenderer:cell-background ##### -->
  77 <para>
  78
  79 </para>
  80
  81 <!-- ##### ARG GtkCellRenderer:cell-background-gdk ##### -->
  82 <para>
  83
  84 </para>
  85
  86 <!-- ##### ARG GtkCellRenderer:cell-background-set ##### -->
  87 <para>
  88
  89 </para>
  90
  91 <!-- ##### ARG GtkCellRenderer:height ##### -->
  92 <para>
  93
  94 </para>
  95
  96 <!-- ##### ARG GtkCellRenderer:is-expanded ##### -->
  97 <para>
  98
  99 </para>
 100
 101 <!-- ##### ARG GtkCellRenderer:is-expander ##### -->
 102 <para>
 103
 104 </para>
 105
 106 <!-- ##### ARG GtkCellRenderer:mode ##### -->
 107 <para>
 108
 109 </para>
 110
 111 <!-- ##### ARG GtkCellRenderer:visible ##### -->
 112 <para>
 113
 114 </para>
 115
 116 <!-- ##### ARG GtkCellRenderer:width ##### -->
 117 <para>
 118
 119 </para>
 120
 121 <!-- ##### ARG GtkCellRenderer:xalign ##### -->
 122 <para>
 123
 124 </para>
 125
 126 <!-- ##### ARG GtkCellRenderer:xpad ##### -->
 127 <para>
 128
 129 </para>
 130
 131 <!-- ##### ARG GtkCellRenderer:yalign ##### -->
 132 <para>
 133
 134 </para>
 135
 136 <!-- ##### ARG GtkCellRenderer:ypad ##### -->
 137 <para>
 138
 139 </para>
 140
 141 <!-- ##### FUNCTION gtk_cell_renderer_get_size ##### -->
 142 <para>
 143
 144 </para>
 145
 146 @cell:
 147 @widget:
 148 @cell_area:
 149 @x_offset:
 150 @y_offset:
 151 @width:
 152 @height:
 153
 154
 155 <!-- ##### FUNCTION gtk_cell_renderer_render ##### -->
 156 <para>
 157
 158 </para>
 159
 160 @cell:
 161 @window:
 162 @widget:
 163 @background_area:
 164 @cell_area:
 165 @expose_area:
 166 @flags:
 167
 168
 169 <!-- ##### FUNCTION gtk_cell_renderer_activate ##### -->
 170 <para>
 171
 172 </para>
 173
 174 @cell:
 175 @event:
 176 @widget:
 177 @path:
 178 @background_area:
 179 @cell_area:
 180 @flags:
 181 @Returns:
 182
 183
 184 <!-- ##### FUNCTION gtk_cell_renderer_start_editing ##### -->
 185 <para>
 186
 187 </para>
 188
 189 @cell:
 190 @event:
 191 @widget:
 192 @path:
 193 @background_area:
 194 @cell_area:
 195 @flags:
 196 @Returns:
 197
 198
 199 <!-- ##### FUNCTION gtk_cell_renderer_editing_canceled ##### -->
 200 <para>
 201
 202 </para>
 203
 204 @cell:
 205
 206
 207 <!-- ##### FUNCTION gtk_cell_renderer_get_fixed_size ##### -->
 208 <para>
 209
 210 </para>
 211
 212 @cell:
 213 @width:
 214 @height:
 215
 216
 217 <!-- ##### FUNCTION gtk_cell_renderer_set_fixed_size ##### -->
 218 <para>
 219
 220 </para>
 221
 222 @cell:
 223 @width:
 224 @height:
 225
 226