gtkclist.sgml

This GTK+ version 2.12.3. GTK+ is a multi-platform toolkit for creating graphical user interfaces.

@spacing: The spacing between the cell's text and pixmap.
@pixmap: A pointer to a #GdkPixmap for the cell.
@mask: A pointer to a #GdkBitmap mask for the cell.


<!-- ##### FUNCTION gtk_clist_get_pixtext ##### -->
<para>
Gets the text, pixmap and bitmap mask for the specified cell.
</para>

@clist: The #GtkCList to affect.
@row: The row to query.
@column: The column to query.
@text: A pointer to a pointer to store the text.
@spacing: A pointer to a #guint8 to store the spacing.
@pixmap: A pointer to a #GdkPixmap pointer to store the cell's pixmap.
@mask: A pointer to a #GdkBitmap pointer to store the cell's bitmap mask.
@Returns: 1 if the retrieval was successful, 0 otherwise.


<!-- ##### FUNCTION gtk_clist_set_foreground ##### -->
<para>
Sets the foreground color for the specified row.
</para>

@clist: The #GtkCList to affect.
@row: The row to affect.
@color: A pointer to a #GdkColor structure.


<!-- ##### FUNCTION gtk_clist_set_background ##### -->
<para>
Sets the background color for the specified row.
</para>

@clist: The #GtkCList to affect.
@row: The row to affect.
@color: A pointer to a #GdkColor structure.


<!-- ##### FUNCTION gtk_clist_set_cell_style ##### -->
<para>
Sets the style for the specified cell.
</para>

@clist: The #GtkCList to affect.
@row: The row of the cell.
@column: The column of the cell.
@style: A pointer to a #GtkStyle structure.


<!-- ##### FUNCTION gtk_clist_get_cell_style ##### -->
<para>
Gets the current style of the specified cell.
</para>

@clist: The #GtkCList to affect.
@row: The row of the cell.
@column: The column of the cell.
@Returns: A #GtkStyle object.


<!-- ##### FUNCTION gtk_clist_set_row_style ##### -->
<para>
Sets the style for all cells in the specified row.
</para>

@clist: The #GtkCList to affect.
@row: The row to affect.
@style: A pointer to a #GtkStyle to set.


<!-- ##### FUNCTION gtk_clist_get_row_style ##### -->
<para>
Gets the style set for the specified row.
</para>

@clist: The #GtkCList to affect.
@row: The row to query.
@Returns: The #GtkStyle of the row.


<!-- ##### FUNCTION gtk_clist_set_shift ##### -->
<para>
Sets the vertical and horizontal shift of the specified cell.
</para>

@clist: The #GtkCList to affect.
@row: The row of the cell.
@column: The column of the cell.
@vertical: The value to set for the vertical shift.
@horizontal: The value to set for the vertical shift.


<!-- ##### FUNCTION gtk_clist_set_selectable ##### -->
<para>
Sets whether the specified row is selectable or not.
</para>

@clist: The #GtkCList to affect.
@row: The row to affect.
@selectable: %TRUE or %FALSE.


<!-- ##### FUNCTION gtk_clist_get_selectable ##### -->
<para>
Gets whether the specified row is selectable or not.
</para>

@clist: The #GtkCList to affect.
@row: The row to query.
@Returns: A #gboolean value.


<!-- ##### FUNCTION gtk_clist_prepend ##### -->
<para>
Adds a row to the CList at the top.
</para>

@clist: The #GtkCList to affect.
@text: An array of strings to add.
@Returns: The number of the row added.


<!-- ##### FUNCTION gtk_clist_append ##### -->
<para>
Adds a row to the CList at the bottom.
</para>

@clist: The #GtkCList to affect.
@text: An array of strings to add.
@Returns: The number of the row added.


<!-- ##### FUNCTION gtk_clist_insert ##### -->
<para>
Adds a row of text to the CList at the specified position.
</para>

@clist: The #GtkCList to affect.
@row: The row where the text should be inserted.
@text: An array of string to add.
@Returns: The number of the row added.


<!-- ##### FUNCTION gtk_clist_remove ##### -->
<para>
Removes the specified row from the CList.
</para>

@clist: The #GtkCList to affect.
@row: The row to remove.


<!-- ##### FUNCTION gtk_clist_set_row_data ##### -->
<para>
Sets data for the specified row.  This is the same as calling gtk_clist_set_row_data_full(clist, row, data, NULL).
</para>

@clist: The #GtkCList to affect.
@row: The row to affect.
@data: The data to set for the row.


<!-- ##### FUNCTION gtk_clist_set_row_data_full ##### -->
<para>
Sets the data for specified row, with a callback when the row is destroyed.
</para>

@clist: The #GtkCList to affect.
@row: The row to affect.
@data: The data to set for the row.
@destroy: A #GtkDestroyNotify function to be called when the row is destroyed.


<!-- ##### FUNCTION gtk_clist_get_row_data ##### -->
<para>
Gets the currently set data for the specified row.
</para>

@clist: The #GtkCList to affect.
@row: The row to query.
@Returns: The data set for the row.


<!-- ##### FUNCTION gtk_clist_find_row_from_data ##### -->
<para>
Searches the CList for the row with the specified data.
</para>

@clist: The #GtkCList to search.
@data: The data to search for a match.
@Returns: The number of the matching row, or -1 if no match could be found.


<!-- ##### FUNCTION gtk_clist_select_row ##### -->
<para>
Selects the specified row.  Causes the "select-row" signal to be emitted for the specified row and column.
</para>

@clist: The #GtkCList to affect.
@row: The row to select.
@column: The column to select.


<!-- ##### FUNCTION gtk_clist_unselect_row ##### -->
<para>
Unselects the specified row.  Causes the "unselect-row" signal to be emitted for the specified row and column.
</para>

@clist: The #GtkCList to affect.
@row: The row to select.
@column: The column to select.


<!-- ##### FUNCTION gtk_clist_undo_selection ##### -->
<para>
Undoes the last selection for an "extended selection mode" CList.
</para>

@clist: The #GtkCList to affect.


<!-- ##### FUNCTION gtk_clist_clear ##### -->
<para>
Removes all the CList's rows.
</para>

@clist: The #GtkCList to affect.


<!-- ##### FUNCTION gtk_clist_get_selection_info ##### -->
<para>
Gets the row and column at the specified pixel position in the CList.
</para>

@clist: The #GtkCList to affect.
@x: The horizontal pixel position to check.
@y: The vertical pixel position to check..
@row: Pointer to a #gint to store the row value.
@column: Pointer to a #gint to store the column value.
@Returns: 1 if row/column is returned and in range, 0 otherwise.


<!-- ##### FUNCTION gtk_clist_select_all ##### -->
<para>
Selects all rows in the CList.  This function has no affect for a
CList in "single" or "browse" selection mode.
</para>

@clist: The #GtkCList to affect.


<!-- ##### FUNCTION gtk_clist_unselect_all ##### -->
<para>
Unselects all rows in the CList.
</para>

@clist: The #GtkCList to affect.


<!-- ##### FUNCTION gtk_clist_swap_rows ##### -->
<para>
Swaps the two specified rows with each other.
</para>

@clist: The #GtkCList to affect.
@row1: Number of the first row.
@row2: Number of the second row.


<!-- ##### FUNCTION gtk_clist_set_compare_func ##### -->
<para>
Sets the compare function of the #GtkClist to @cmp_func. If @cmp_func is NULL,
then the default compare function is used. The default compare function sorts
ascending or with the type set by gtk_clist_set_sort_type() by the column set
by gtk_clist_set_sort_column().
</para>

@clist: The #GtkCList to affect.
@cmp_func: The #GtkCompareFunction to use.


<!-- ##### FUNCTION gtk_clist_set_sort_column ##### -->
<para>
Sets the sort column of the clist. The sort column is used by the
default compare function to determine which column to sort by. 
</para>

@clist: The #GtkCList to affect.
@column: The column to sort by


<!-- ##### FUNCTION gtk_clist_set_sort_type ##### -->
<para>
Sets the sort type of the #GtkClist. This is either GTK_SORT_ASCENDING for
ascening sort or GTK_SORT_DESCENDING for descending sort.
</para>

@clist: The #GtkCList to affect.
@sort_type: the #GtkSortType to use


<!-- ##### FUNCTION gtk_clist_sort ##### -->
<para>
Sorts the #GtkClist according to the current compare function, which
can be set with the gtk_clist_set_compare_func() function.
</para>

@clist: The #GtkCList to sort.


<!-- ##### FUNCTION gtk_clist_set_auto_sort ##### -->
<para>
Turns on or off auto sort of the #GtkCList. If auto sort is on, then the CList will be resorted when a row is inserted into the CList.
</para>

@clist: The #GtkCList to affect.
@auto_sort: whether auto sort should be on or off


<!-- ##### FUNCTION gtk_clist_columns_autosize ##### -->
<para>
Auto-sizes all columns in the CList and returns the total width of the CList.
</para>

@clist: The #GtkCList to affect.
@Returns: The total width of the CList.


<!-- ##### FUNCTION gtk_clist_get_column_title ##### -->
<para>
Gets the current title of the specified column
</para>

@clist: The #GtkCList to affect.
@column: The column to query.
@Returns: The title of the column.


<!-- ##### FUNCTION gtk_clist_get_column_widget ##### -->
<para>
Gets the widget in the column header for the specified column.
</para>

@clist: The #GtkCList to affect.
@column: The column to query.
@Returns: Pointer to a #GtkWidget for the column header.


<!-- ##### FUNCTION gtk_clist_get_hadjustment ##### -->
<para>
Gets the #GtkAdjustment currently being used for the horizontal
aspect.
</para>

@clist: The #GtkCList to check.
@Returns: A #GtkAdjustment object, or NULL if none is currently
being used.


<!-- ##### FUNCTION gtk_clist_get_vadjustment ##### -->
<para>
Gets the #GtkAdjustment currently being used for the vertical
aspect.
</para>

@clist: The #GtkCList to check.
@Returns: A #GtkAdjustment object, or NULL if none is currently
being used.


<!-- ##### FUNCTION gtk_clist_row_move ##### -->
<para>
Allows you to move a row from one position to another in the
list.
</para>

@clist: The #GtkCList to affect.
@source_row: The original position of the row to move.
@dest_row: The position to which the row should be moved.


<!-- ##### FUNCTION gtk_clist_set_button_actions ##### -->
<para>
Sets the action(s) that the specified mouse button will have
on the CList.
</para>

@clist: The #GtkCList to affect.
@button: The mouse button to set. The values here, unlike in the
         rest of GTK+ start from 0. For instance, the right mouse
         button, which is 3 elsewhere, should be given as 2 here.
@button_actions: A logically OR'd value of #GtkButtonAction values 
for the button.


<!-- ##### FUNCTION gtk_clist_set_hadjustment ##### -->
<para>
Allows you to set the #GtkAdjustment to be used for the horizontal
aspect of the #GtkCList widget.
</para>

@clist: The #GtkCList to affect.
@adjustment: A pointer to a #GtkAdjustment widget, or NULL.


<!-- ##### FUNCTION gtk_clist_set_reorderable ##### -->
<para>
Sets whether the CList's rows are re-orderable using drag-and-drop.
</para>

@clist: The #GtkCList to affect.
@reorderable: %TRUE or %FALSE.


<!-- ##### FUNCTION gtk_clist_set_use_drag_icons ##### -->
<para>
Determines whether the #GtkClist should use icons when
doing drag-and-drop operations.
</para>

@clist: The #GtkCList to affect.
@use_icons: %TRUE or %FALSE.


<!-- ##### FUNCTION gtk_clist_set_vadjustment ##### -->
<para>
Allows you to set the #GtkAdjustment to be used for the vertical
aspect of the #GtkCList widget.
</para>

@clist: The #GtkCList to affect.
@adjustment: A pointer to a #GtkAdjustment widget, or NULL.