callisto-debian/gtk3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

more docs.

Browse Source 
Sun Nov  3 13:23:51 2002  Jonathan Blandford  <jrb@gnome.org>

	* gtk/tmpl/gtkcellrenderer.sgml: more docs.
This commit is contained in:
Jonathan Blandford 2002-11-03 18:25:05 +00:00 committed by Jonathan Blandford
parent 42bd8a2a0b
commit e6143c65eb
2 changed files with 91 additions and 62 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
docs/reference/ChangeLog
View File

@ -1,3 +1,7 @@
Sun Nov 3 13:23:51 2002 Jonathan Blandford <jrb@gnome.org>
* gtk/tmpl/gtkcellrenderer.sgml: more docs.
Sat Nov 2 12:46:16 2002 Owen Taylor <otaylor@redhat.com> Sat Nov 2 12:46:16 2002 Owen Taylor <otaylor@redhat.com>
* gdk-pixbuf/Makefile.am: Remove rules for generation * gdk-pixbuf/Makefile.am: Remove rules for generation

149
docs/reference/gtk/tmpl/gtkcellrenderer.sgml
View File

@ -2,36 +2,61 @@
GtkCellRenderer GtkCellRenderer
<!-- ##### SECTION Short_Description ##### --> <!-- ##### SECTION Short_Description ##### -->
An object for rendering a single cell on a #GdkDrawable
<!-- ##### SECTION Long_Description ##### --> <!-- ##### SECTION Long_Description ##### -->
<para> <para>
The #GtkCellRenderer is a base class of a set of objects used for
rendering a cell to a #GdkDrawable. These objects are used primarily by
the #GtkTreeView widget, though they aren't tied to them in any
specific way. It is worth noting that #GtkCellRenderer is not a
#GtkWidget and cannot be treated as such.
</para> </para>
<para>
The primary use of a #GtkCellRenderer is for drawing a certain graphical
elements on a #GdkDrawable. Typically, one cell renderer is used to
draw many cells on the screen. To this extent, it isn't expected that a
CellRenderer keep any permanent state around. Instead, any state is set
just prior to use using #GObject<!-- -->s property system. Then, the
cell is measured using @gtk_cell_renderer_get_size. Finally, the cell
is rendered in the correct location using @gtk_cell_renderer_render.
</para>
<para>
There are a number of rules that must be followed when writing a new
#GtkCellRenderer. First and formost, it's important that a certain set
of properties will always yield a cell renderer of the same size,
barring a #GtkStyle change. The #GtkCellRenderer also has a number of
generic properties that are expected to be honored by all children.
</para>
<!-- ##### SECTION See_Also ##### --> <!-- ##### SECTION See_Also ##### -->
<para> <para>
#GtkCellRendererText,#GtkCellRendererPixbuf,#GtkCellRendererToggle
</para> </para>
<!-- ##### ENUM GtkCellRendererState ##### --> <!-- ##### ENUM GtkCellRendererState ##### -->
<para> <para>
Tells how a cell is to be rendererd.
</para> </para>
@GTK_CELL_RENDERER_SELECTED: @GTK_CELL_RENDERER_SELECTED: The cell is currently selected, and
@GTK_CELL_RENDERER_PRELIT: probably has a selection colored background to render to.
@GTK_CELL_RENDERER_INSENSITIVE: @GTK_CELL_RENDERER_PRELIT: The mouse is hovering over the cell.
@GTK_CELL_RENDERER_SORTED: @GTK_CELL_RENDERER_INSENSITIVE: The cell is drawn in an insensitive manner
@GTK_CELL_RENDERER_SORTED: The cell is in a sorted row
<!-- ##### ENUM GtkCellRendererMode ##### --> <!-- ##### ENUM GtkCellRendererMode ##### -->
<para> <para>
Identifies how the user can interact with a particular cell.
</para> </para>
@GTK_CELL_RENDERER_MODE_INERT: @GTK_CELL_RENDERER_MODE_INERT: The cell is just for display
@GTK_CELL_RENDERER_MODE_ACTIVATABLE: and cannot be interacted with. Note that this doesn't mean that eg. the
@GTK_CELL_RENDERER_MODE_EDITABLE: row being drawn can't be selected -- just that a particular element of
it cannot be individually modified.
@GTK_CELL_RENDERER_MODE_ACTIVATABLE: The cell can be clicked.
@GTK_CELL_RENDERER_MODE_EDITABLE: The cell can be edited or otherwise modified.
<!-- ##### STRUCT GtkCellRenderer ##### --> <!-- ##### STRUCT GtkCellRenderer ##### -->
<para> <para>
@ -117,6 +142,56 @@ GtkCellRenderer
@height: @height:
<!-- ##### ARG GtkCellRenderer:mode ##### -->
<para>
</para>
<!-- ##### ARG GtkCellRenderer:visible ##### -->
<para>
</para>
<!-- ##### ARG GtkCellRenderer:xalign ##### -->
<para>
</para>
<!-- ##### ARG GtkCellRenderer:yalign ##### -->
<para>
</para>
<!-- ##### ARG GtkCellRenderer:xpad ##### -->
<para>
</para>
<!-- ##### ARG GtkCellRenderer:ypad ##### -->
<para>
</para>
<!-- ##### ARG GtkCellRenderer:width ##### -->
<para>
</para>
<!-- ##### ARG GtkCellRenderer:height ##### -->
<para>
</para>
<!-- ##### ARG GtkCellRenderer:is-expander ##### -->
<para>
</para>
<!-- ##### ARG GtkCellRenderer:is-expanded ##### -->
<para>
</para>
<!-- ##### ARG GtkCellRenderer:cell-background ##### --> <!-- ##### ARG GtkCellRenderer:cell-background ##### -->
<para> <para>
@ -132,53 +207,3 @@ GtkCellRenderer
</para> </para>
<!-- ##### ARG GtkCellRenderer:height ##### -->
<para>
</para>
<!-- ##### ARG GtkCellRenderer:is-expanded ##### -->
<para>
</para>
<!-- ##### ARG GtkCellRenderer:is-expander ##### -->
<para>
</para>
<!-- ##### ARG GtkCellRenderer:mode ##### -->
<para>
</para>
<!-- ##### ARG GtkCellRenderer:visible ##### -->
<para>
</para>
<!-- ##### ARG GtkCellRenderer:width ##### -->
<para>
</para>
<!-- ##### ARG GtkCellRenderer:xalign ##### -->
<para>
</para>
<!-- ##### ARG GtkCellRenderer:xpad ##### -->
<para>
</para>
<!-- ##### ARG GtkCellRenderer:yalign ##### -->
<para>
</para>
<!-- ##### ARG GtkCellRenderer:ypad ##### -->
<para>
</para>