Go to the first, previous, next, last section, table of contents.
A list of rows of columns, with a title row. You can insert rows, and
delete rows. The user can scroll around and select a row. Derived from
see section 6.13 The container widget. Cells can be empty, have a text and/or pixmap, or
be a widget.
- Function: guint gtk_clist_get_type (void)
-
Returns the
GtkCList type identifier.
- Function: GtkWidget* gtk_clist_new (int columns)
-
Create a new
GtkCList initializing it with the value columns.
The new widget is returned as a pointer to a GtkWidget object.
NULL is returned on failure.
- Function: GtkWidget* gtk_clist_new_with_titles (int columns, gchar *titles[])
-
- Function: void gtk_clist_set_border (GtkCList *clist, GtkShadowType border)
-
Set the border style of the clist to the shadow type border.
- Function: void gtk_clist_set_selection_mode (GtkCList *clist GtkSelectionMode mode)
-
Set the selection mode on the clist to the mode selection mode.
- Function: void gtk_clist_set_policy (GtkCList *clist, GtkPolicyType vscrollbar_policy, GtkPolicyType hscrollbar_policy)
-
Set the policy on the scrollbars on the clist to vscrollbar_policy and hscrollbar_policy.
- Function: void gtk_clist_freeze (GtkCList *clist)
-
Stop all visual updates of the clist. Useful for when making a large
number of changes to a
GtkCList.
- Function: void gtk_clist_thaw (GtkCList *clist)
-
Allow all visual updates of the clist to resume.
- Function: void gtk_clist_column_titles_show (GtkCList *clist)
-
Show the column title buttons on the clist.
- Function: void gtk_clist_column_titles_hide (GtkCList *clist)
-
Hide the column title buttons on the clist.
- Function: void gtk_clist_set_column_title (GtkCList *clist, gint column, gchar *title)
-
Set the title in column column of the clist button to title.
- Function: void gtk_clist_set_column_widget (GtkCList *clist, gint column, GtkWidget *widget)
-
Set the widget instead of the title button for the column column
in the clist.
- Function: void gtk_clist_set_column_justification (GtkCList *clist, gint column, GtkJustification justification)
-
Set the column's justification, in the clist to justification.
- Function: void gtk_clist_set_column_width (GtkCList *clist, gint column, gint width)
-
Set the pixel width of column column in the
GtkCList clist
to width. This function is a necessary step in creating a
GtkCList because otherwise the column width is chosen from the width
of the column title, which is almost never correct.
- Function: void gtk_clist_set_row_height (GtkCList *clist, gint height)
-
Change the height of the rows in the clist to height. The default
is the height of the current font.
- Function: void gtk_clist_moveto (GtkCList *clist, gint row, gintcolumn, gfloat row_align, gfloat col_align)
-
Scroll the viewing area of the
GtkClist in clist to column
and row. The row_align and col_align are between zero and
one, representing the location the row should appear on screen. Setting
row_align or the col_align to 0.0 will be the top or left of the
viewing area. Setting the row_align or col_align to 1.0 will
be the bottom or right of the viewing area. If the row or column
is -1 then there is no change.
- Function: void gtk_clist_set_text (GtkCList *clist, gint row, gint column, gchar *text)
-
Set a given cell's text, located by the row and column, to
text replacing its current contents.
- Function: void gtk_clist_set_pixmap (GtkCList *clist, gint row, gint column, GdkPixmap *pixmap, GdkBitmap *mask)
-
Set a given cell's text, located by the column and row arguments,
to the pixmap described by the pixmap argument using the mask as
its mask. The current contents of the cell will be replaced.
- Function: void gtk_clist_setpixtext (GtkCList *clist, gint row, gint column, gchar *text, guint8 spacing, GdkPixmap *pixmap, GdkBitmap *mask)
-
Set a given cell's text and pixmap, located by the row and column
arguments, to the text and pixmap described by the pixmap and text
arguments. The mask will be used for the pixmap mask and the
spacing argument specifies the spacing between the two.
- Function: void gtk_clist_set_foreground (GtkCList *clist, gint row, GdkColor *color)
-
Set the foreground color of row row to color in the
GtkCList clist. The color must
already be allocated.
- Function: void gtk_clist_set_background (GtkCList *clist, gint row, GdkColor *color)
-
Set the background color of row row to color in the
GtkCList pointed to by clist. The color must be previously
allocated.
- Function: void gtk_clist_set_shift (GtkCList *clist, gint row, gint column, gint vertical, gint horizontal)
-
Set the horizontal and vertical shift for drawing the contents of the cell
located at row and column. The vertical and horizontal
arguments can be positive or negative.
- Function: gint gtk_clist_append (GtkCList *clist, gchar *text[])
-
Append the given text, in the text[] argument, to the
GtkCList
pointed to by the clist. The return value is the index of the row that
was just added.
- Function: void gtk_clist_insert (GtkCList *clist, gint row, gchar *text[])
-
Insert a row into the
GtkCList pointed to by clist at row
row with the text in text[].
- Function: void gtk_clist_remove (GtkCList *clist, gint row)
-
Remove row index row from the clist.
- Function: void gtk_clist_set_row_data (GtkCList *clist, gint row, gpointer data)
-
Will set an arbitrary data pointer, data, for row row in the
GtkCList pointed to by clist.
- Function: gpointer gtk_clist_get_row_data (GtkCList *clist, gint row)
-
Return the data that was set for row row from the
GtkCList pointed
to by clist. NULL is returned if no data was set.
- Function: void gtk_clist_select_row (GtkCList *clist, gint row, gint column)
-
Force selection of a row, located by row and column, in the
GtkCList pointed to by clist.
- Function: void gtk_clist_unselect_row (GtkCList *clist, gint row, gint column)
-
Force the unselection of a row, located by row and column, in the
GtkCList pointed to by clist.
- Function: void gtk_clist_clear (GtkCList *clist)
-
Clear the entire contents of the
GtkCList pointed to by clist.
This is much faster then removing each item separately with
gtk_clist_remove.
@gtkstdmacros{CList, CLIST}
Go to the first, previous, next, last section, table of contents.