GtkCList
A multi-columned scrolling list widget.
The #GtkCList widget is a very useful multi-columned scrolling list. It can display
data in nicely aligned vertical columns, with titles at the top of the list.
FIXME: More info
This is the embodiment of the #GtkCList widget.
Identifies the type of element in the current cell of the CList. Cells can
contain text, pixmaps, or even other widgets.
@GTK_CELL_EMPTY:
@GTK_CELL_TEXT:
@GTK_CELL_PIXMAP:
@GTK_CELL_PIXTEXT:
@GTK_CELL_WIDGET:
@GTK_BUTTON_IGNORED:
@GTK_BUTTON_SELECTS:
@GTK_BUTTON_DRAGS:
@GTK_BUTTON_EXPANDS:
Reads the current flags of the specified CList.
@clist: The #GtkCList widget from which to get the flags
A macro to set a particular flag for the specified CList.
@clist: The #GtkCList widget to affect.
@flag: A single #GtkCList flag to set. NOTE: Do not add the GTK_ prefix.
A macro to clear a particular flag for the specified CList.
@clist: The #GtkCList widget to affect.
@flag: A single #GtkCList flag to clear. NOTE: Do not add the GTK_ prefix.
A macro to check whether the #GtkCList is in "drag mode."
@clist: The #GtkCList to check.
@clist:
A macro to check whether the flag for showing the
widget's column titles is set.
@clist: The #GtkCList widget to check.
A macro to check whether a child widget of the CList
has the focus.
@clist: The #GtkCList widget to check.
@clist:
@clist:
@clist:
@clist:
@clist:
@clist:
@clist:
A macro to cast a GList element to a CListRow pointer.
@_glist_: The GList element to convert.
A macro to cast a generic #GtkCList cell item to a GtkCellText pointer.
@cell: The #GtkCList cell item to convert.
A macro to cast a generic #GtkCList cell item to a GtkCellPixmap pointer.
@cell: The #GtkCList cell item to convert.
A macro to cast a generic #GtkCList cell item to a GtkCellPixText pointer.
@cell: The #GtkCList cell item to convert.
A macro to cast a generic #GtkCList cell item to a GtkCellWidget pointer.
@cell: The #GtkCList cell item to convert.
@clist:
@ptr1:
@ptr2:
@Returns:
A structure that the #GtkCList widget uses to keep track of information
about its columns.
@title:
@area:
@button:
@window:
@width:
@min_width:
@max_width:
@justification:
@visible:
@width_set:
@resizeable:
@auto_resize:
@button_passive:
A structure that the #GtkCList widget uses to keep track of information
about its rows.
@cell:
@state:
@foreground:
@background:
@style:
@data:
@destroy:
@fg_set:
@bg_set:
@selectable:
A structure that the #GtkCList widget uses to keep track of #GtkCList cells
that contain text.
@type:
@vertical:
@horizontal:
@style:
@text:
A structure that the #GtkCList widget uses to keep track of #GtkCList cells
that contain a GdkPixmap.
@type:
@vertical:
@horizontal:
@style:
@pixmap:
@mask:
A structure that the #GtkCList widget uses to keep track of #GtkCList cells
that contain a combination of text and a GdkPixmap.
@type:
@vertical:
@horizontal:
@style:
@text:
@spacing:
@pixmap:
@mask:
A structure that the #GtkCList widget uses to keep track of #GtkCList cells
that contain another widget.
@type:
@vertical:
@horizontal:
@style:
@widget:
A generic structure that the #GtkCList widget uses to keep track of the
contents of each of its cells.
@type:
@vertical:
@horizontal:
@style:
@widget:
@row:
@column:
@cell:
@insert_pos:
@GTK_CLIST_DRAG_NONE:
@GTK_CLIST_DRAG_BEFORE:
@GTK_CLIST_DRAG_INTO:
@GTK_CLIST_DRAG_AFTER:
Initializes a previously allocated #GtkCList widget for use. This should not
normally be used to create a #GtkCList widget. Use gtk_clist_new() instead.
@clist: A pointer to an uninitialized #GtkCList widget.
@columns: The number of columns the #GtkCList should have.
@titles: An array of strings that should be used as the titles i
of the columns. There should be enough strings in the array for
the number of columns specified.
Creates a new #GtkCList widget for use.
@columns: The number of columns the #GtkCList should have.
@Returns: A pointer to a new GtkCList object.
Creates a new #GtkCList widget with column titles for use.
@columns: The number of columns the #GtkCList should have.
@titles: A string array of titles for the widget. There should be
enough strings in the array for the specified number of columns.
@Returns: A pointer to a new GtkCList object.
Sets the shadow type for the specified CList. Changing this value
will cause the #GtkCList to update its visuals.
@clist: The #GtkCList to affect.
@type: The GtkShadowType desired.
Sets the selection mode for the specified CList. This allows you to
set whether only one or more than one item can be selected at a time
in the widget. Note that setting the widget's selection mode to one
of GTK_SELECTION_BROWSE or GTK_SELECTION_SINGLE will cause all the
items in the #GtkCList to become deselected.
@clist: The #GtkCList to affect.
@mode: The GtkSelectionMode type to set for this CList.
Causes the #GtkCList to stop updating its visuals until a matching call to
gtk_clist_thaw() is made. This function is useful if a lot of changes
will be made to the widget that may cause a lot of visual updating to
occur. Note that calls to gtk_clist_freeze() can be nested.
@clist: The #GtkCList to freeze.
Causes the specified #GtkCList to allow visual updates.
@clist: The #GtkCList to thaw.
This function causes the #GtkCList to show its column titles, if
they are not already showing.
@clist: The #GtkCList to affect.
Causes the #GtkCList to hide its column titles, if they are currently
showing.
@clist: The #GtkCList to affect.
Sets the specified column in the #GtkCList to become selectable. You can
then respond to events from the user clicking on a title button, and take
appropriate action.
@clist: The #GtkCList to affect.
@column: The column to make active, counting from 0.
Causes the specified column title button to become passive, i.e., does
not respond to events, such as the user clicking on it.
@clist: The #GtkCList to affect.
@column: The column to make passive, counting from 0.
Causes all column title buttons to become active. This is the same
as calling gtk_clist_column_title_active() for each column.
@clist: The #GtkCList to affect.
Causes all column title buttons to become passive. This is the same
as calling gtk_clist_column_title_passive() for each column.
@clist: The #GtkCList to affect.
Sets the title for the specified column.
@clist: The #GtkCList to affect.
@column: The column whose title should be changed.
@title: A string to be the column's title.
Sets a widget to be used as the specified column's title. This
can be used to place a pixmap or something else as the column
title, instead of the standard text.
@clist: The #GtkCList to affect.
@column: The column whose title should be a widget.
@widget: A pointer to a previously create widget.
Sets the justification to be used for all text in the specified
column.
@clist: The #GtkCList to affect.
@column: The column which should be affected.
@justification: A GtkJustification value for the column.
Allows you to set whether a specified column in the #GtkCList should
be hidden or shown. Note that at least one column must always be
showing, so attempting to hide the last visible column will be
ignored.
@clist: The #GtkCList to affect.
@column: The column to set visibility.
@visible: %TRUE or %FALSE.
Lets you specify whether a specified column should be resizeable
by the user. Note that turning on resizeability for the column will
automatically shut off auto-resizing, but turning off resizeability
will NOT turn on auto-resizing. This must be done manually via a
call to gtk_clist_set_column_auto_resize().
@clist: The #GtkCList to affect.
@column: The column on which to set resizeability.
@resizeable: %TRUE or %FALSE.
Lets you specify whether a column should be automatically resized
by the widget when data is added or removed. Enabling auto-resize
on a column explicity disallows user-resizing of the column.
@clist: The #GtkCList to affect.
@column: The column on which to set auto-resizing.
@auto_resize: %TRUE or %FALSE.
Gets the required width in pixels that is needed to show
everything in the specified column.
@clist: The #GtkCList to check.
@column: The column to check.
@Returns: The required width in pixels for the column.
Causes the column specified for the #GtkCList to be set to
a specified width.
@clist: The #GtkCList to affect.
@column: The column to set the width.
@width: The width, in pixels.
Causes the column specified to have a minimum width, preventing
the user from resizing it smaller than that specified.
@clist: The #GtkCList to affect.
@column: The column to set the minimum width.
@min_width: The width, in pixels.
Causes the column specified to have a maximum width, preventing
the user from resizing it larger than that specified.
@clist: The #GtkCList to affect.
@column: The column to set the maximum width.
@max_width: The width, in pixels.
Causes the #GtkCList to have a specified height for its
rows. Setting the row height to 0 allows the #GtkCList to adjust
automatically to data in the row.
@clist: The #GtkCList to affect.
@height: The height, in pixels.
@clist: The #GtkCList to affect.
@row:
@column:
@row_align:
@col_align:
@clist:
@row:
@Returns:
@clist:
@row:
@column:
@Returns:
@clist: The #GtkCList to affect.
@row:
@column:
@text:
@clist:
@row:
@column:
@text:
@Returns:
@clist: The #GtkCList to affect.
@row:
@column:
@pixmap:
@mask:
@clist:
@row:
@column:
@pixmap:
@mask:
@Returns:
@clist: The #GtkCList to affect.
@row:
@column:
@text:
@spacing:
@pixmap:
@mask:
@clist:
@row:
@column:
@text:
@spacing:
@pixmap:
@mask:
@Returns:
@clist: The #GtkCList to affect.
@row:
@color:
@clist: The #GtkCList to affect.
@row:
@color:
@clist: The #GtkCList to affect.
@row:
@column:
@style:
@clist:
@row:
@column:
@Returns:
@clist: The #GtkCList to affect.
@row:
@style:
@clist:
@row:
@Returns:
@clist: The #GtkCList to affect.
@row:
@column:
@vertical:
@horizontal:
@clist: The #GtkCList to affect.
@row:
@selectable:
@clist:
@row:
@Returns:
@clist: The #GtkCList to affect.
@text:
@Returns:
@clist: The #GtkCList to affect.
@text:
@Returns:
@clist: The #GtkCList to affect.
@row:
@text:
@Returns:
@clist: The #GtkCList to affect.
@row:
@clist: The #GtkCList to affect.
@row:
@data:
@clist: The #GtkCList to affect.
@row:
@data:
@destroy:
@clist:
@row:
@Returns:
@clist:
@data:
@Returns:
@clist: The #GtkCList to affect.
@row:
@column:
@clist: The #GtkCList to affect.
@row:
@column:
@clist: The #GtkCList to affect.
@clist: The #GtkCList to affect.
@clist:
@x:
@y:
@row:
@column:
@Returns:
@clist: The #GtkCList to affect.
@clist: The #GtkCList to affect.
@clist: The #GtkCList to affect.
@row1:
@row2:
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().
@clist: The #GtkCList to affect.
@cmp_func: The #GtkCompareFunction to use.
Sets the sort column of the clist. The sort column is used by the
default compare function to determine which column to sort by.
@clist: The #GtkCList to affect.
@column: The column to sort by
Sets the sort type of the #GtkClist. This is either GTK_SORT_ASCENDING for
ascening sort or GTK_SORT_DESCENDING for descending sort.
@clist: The #GtkCList to affect.
@sort_type: the #GtkSortType to use
Sorts the #GtkClist according to the current compare function, which
can be set with the gtk_clist_set_compare_func() function.
@clist: The #GtkCList to sort.
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.
@clist: The #GtkCList to affect.
@auto_sort: whether auto sort should be on or off
@clist: The #GtkCList to affect.
@Returns:
@clist:
@column:
@Returns:
@clist:
@column:
@Returns:
@clist:
@Returns:
Gets the #GtkAdjustment currently being used for the vertical
aspect.
@clist: The #GtkCList to check.
@Returns: A #GtkAdjustment widget, or NULL if none is currently
being used.
Allows you to move a row from one position to another in the
list.
@clist: The #GtkCList to affect.
@source_row:
@dest_row:
@clist: The #GtkCList to affect.
@button:
@button_actions:
Allows you to set the #GtkAdjustment to be used for the horizontal
aspect of the #GtkCList widget.
@clist: The #GtkCList to affect.
@adjustment: A pointer to a #GtkAdjustment widget, or NULL.
@clist:
@reorderable:
Determines whether the #GtkClist should use icons when
doing drag-and-drop operations.
@clist: The #GtkCList to affect.
@use_icons: %TRUE or %FALSE.
Allows you to set the #GtkAdjustment to be used for the vertical
aspect of the #GtkCList widget.
@clist: The #GtkCList to affect.
@adjustment: A pointer to a #GtkAdjustment widget, or NULL.
@clist: the object which received the signal.
@row:
@column:
@event:
@clist: the object which received the signal.
@row:
@column:
@event:
@clist: the object which received the signal.
@arg1:
@arg2:
@clist: the object which received the signal.
@column:
@clist: the object which received the signal.
@column:
@width:
@clist: the object which received the signal.
@clist: the object which received the signal.
@clist: the object which received the signal.
@clist: the object which received the signal.
@clist: the object which received the signal.
@clist: the object which received the signal.
@clist: the object which received the signal.
@clist: the object which received the signal.
@scroll_type:
@position:
@auto_start_selection:
@clist: the object which received the signal.
@scroll_type:
@position:
@clist: the object which received the signal.
@scroll_type:
@position: a value between 0.0 and 1.0.
@clist: the object which received the signal.