1284 lines
23 KiB
Plaintext
1284 lines
23 KiB
Plaintext
<!-- ##### SECTION Title ##### -->
|
|
GtkCList
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
A multi-columned scrolling list widget.
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
<para>
|
|
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
|
|
</para>
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### STRUCT GtkCList ##### -->
|
|
<para>
|
|
This is the embodiment of the #GtkCList widget.
|
|
</para>
|
|
|
|
|
|
<!-- ##### ENUM GtkCellType ##### -->
|
|
<para>
|
|
Identifies the type of element in the current cell of the CList. Cells can
|
|
contain text, pixmaps, or even other widgets.
|
|
</para>
|
|
|
|
@GTK_CELL_EMPTY:
|
|
@GTK_CELL_TEXT:
|
|
@GTK_CELL_PIXMAP:
|
|
@GTK_CELL_PIXTEXT:
|
|
@GTK_CELL_WIDGET:
|
|
|
|
<!-- ##### ENUM GtkButtonAction ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@GTK_BUTTON_IGNORED:
|
|
@GTK_BUTTON_SELECTS:
|
|
@GTK_BUTTON_DRAGS:
|
|
@GTK_BUTTON_EXPANDS:
|
|
|
|
<!-- ##### MACRO GTK_CLIST_FLAGS ##### -->
|
|
<para>
|
|
Reads the current flags of the specified CList.
|
|
</para>
|
|
|
|
@clist: The #GtkCList widget from which to get the flags
|
|
|
|
|
|
<!-- ##### MACRO GTK_CLIST_SET_FLAG ##### -->
|
|
<para>
|
|
A macro to set a particular flag for the specified CList.
|
|
</para>
|
|
|
|
@clist: The #GtkCList widget to affect.
|
|
@flag: A single #GtkCList flag to set. NOTE: Do not add the GTK_ prefix.
|
|
|
|
|
|
<!-- ##### MACRO GTK_CLIST_UNSET_FLAG ##### -->
|
|
<para>
|
|
A macro to clear a particular flag for the specified CList.
|
|
</para>
|
|
|
|
@clist: The #GtkCList widget to affect.
|
|
@flag: A single #GtkCList flag to clear. NOTE: Do not add the GTK_ prefix.
|
|
|
|
|
|
<!-- ##### MACRO GTK_CLIST_IN_DRAG ##### -->
|
|
<para>
|
|
A macro to check whether the #GtkCList is in "drag mode."
|
|
</para>
|
|
|
|
@clist: The #GtkCList to check.
|
|
|
|
|
|
<!-- ##### MACRO GTK_CLIST_ROW_HEIGHT_SET ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist:
|
|
|
|
|
|
<!-- ##### MACRO GTK_CLIST_SHOW_TITLES ##### -->
|
|
<para>
|
|
A macro to check whether the flag for showing the
|
|
widget's column titles is set.
|
|
</para>
|
|
|
|
@clist: The #GtkCList widget to check.
|
|
|
|
|
|
<!-- ##### MACRO GTK_CLIST_CHILD_HAS_FOCUS ##### -->
|
|
<para>
|
|
A macro to check whether a child widget of the CList
|
|
has the focus.
|
|
</para>
|
|
|
|
@clist: The #GtkCList widget to check.
|
|
|
|
|
|
<!-- ##### MACRO GTK_CLIST_ADD_MODE ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist:
|
|
|
|
|
|
<!-- ##### MACRO GTK_CLIST_AUTO_SORT ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist:
|
|
|
|
|
|
<!-- ##### MACRO GTK_CLIST_AUTO_RESIZE_BLOCKED ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist:
|
|
|
|
|
|
<!-- ##### MACRO GTK_CLIST_REORDERABLE ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist:
|
|
|
|
|
|
<!-- ##### MACRO GTK_CLIST_USE_DRAG_ICONS ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist:
|
|
|
|
|
|
<!-- ##### MACRO GTK_CLIST_DRAW_DRAG_LINE ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist:
|
|
|
|
|
|
<!-- ##### MACRO GTK_CLIST_DRAW_DRAG_RECT ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist:
|
|
|
|
|
|
<!-- ##### MACRO GTK_CLIST_ROW ##### -->
|
|
<para>
|
|
A macro to cast a GList element to a CListRow pointer.
|
|
</para>
|
|
|
|
@_glist_: The GList element to convert.
|
|
|
|
|
|
<!-- ##### MACRO GTK_CELL_TEXT ##### -->
|
|
<para>
|
|
A macro to cast a generic #GtkCList cell item to a GtkCellText pointer.
|
|
</para>
|
|
|
|
@cell: The #GtkCList cell item to convert.
|
|
|
|
|
|
<!-- ##### MACRO GTK_CELL_PIXMAP ##### -->
|
|
<para>
|
|
A macro to cast a generic #GtkCList cell item to a GtkCellPixmap pointer.
|
|
</para>
|
|
|
|
@cell: The #GtkCList cell item to convert.
|
|
|
|
|
|
<!-- ##### MACRO GTK_CELL_PIXTEXT ##### -->
|
|
<para>
|
|
A macro to cast a generic #GtkCList cell item to a GtkCellPixText pointer.
|
|
</para>
|
|
|
|
@cell: The #GtkCList cell item to convert.
|
|
|
|
|
|
<!-- ##### MACRO GTK_CELL_WIDGET ##### -->
|
|
<para>
|
|
A macro to cast a generic #GtkCList cell item to a GtkCellWidget pointer.
|
|
</para>
|
|
|
|
@cell: The #GtkCList cell item to convert.
|
|
|
|
|
|
<!-- ##### USER_FUNCTION GtkCListCompareFunc ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist:
|
|
@ptr1:
|
|
@ptr2:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### STRUCT GtkCListColumn ##### -->
|
|
<para>
|
|
A structure that the #GtkCList widget uses to keep track of information
|
|
about its columns.
|
|
</para>
|
|
|
|
@title:
|
|
@area:
|
|
@button:
|
|
@window:
|
|
@width:
|
|
@min_width:
|
|
@max_width:
|
|
@justification:
|
|
@visible:
|
|
@width_set:
|
|
@resizeable:
|
|
@auto_resize:
|
|
@button_passive:
|
|
|
|
<!-- ##### STRUCT GtkCListRow ##### -->
|
|
<para>
|
|
A structure that the #GtkCList widget uses to keep track of information
|
|
about its rows.
|
|
</para>
|
|
|
|
@cell:
|
|
@state:
|
|
@foreground:
|
|
@background:
|
|
@style:
|
|
@data:
|
|
@destroy:
|
|
@fg_set:
|
|
@bg_set:
|
|
@selectable:
|
|
|
|
<!-- ##### STRUCT GtkCellText ##### -->
|
|
<para>
|
|
A structure that the #GtkCList widget uses to keep track of #GtkCList cells
|
|
that contain text.
|
|
</para>
|
|
|
|
@type:
|
|
@vertical:
|
|
@horizontal:
|
|
@style:
|
|
@text:
|
|
|
|
<!-- ##### STRUCT GtkCellPixmap ##### -->
|
|
<para>
|
|
A structure that the #GtkCList widget uses to keep track of #GtkCList cells
|
|
that contain a GdkPixmap.
|
|
</para>
|
|
|
|
@type:
|
|
@vertical:
|
|
@horizontal:
|
|
@style:
|
|
@pixmap:
|
|
@mask:
|
|
|
|
<!-- ##### STRUCT GtkCellPixText ##### -->
|
|
<para>
|
|
A structure that the #GtkCList widget uses to keep track of #GtkCList cells
|
|
that contain a combination of text and a GdkPixmap.
|
|
</para>
|
|
|
|
@type:
|
|
@vertical:
|
|
@horizontal:
|
|
@style:
|
|
@text:
|
|
@spacing:
|
|
@pixmap:
|
|
@mask:
|
|
|
|
<!-- ##### STRUCT GtkCellWidget ##### -->
|
|
<para>
|
|
A structure that the #GtkCList widget uses to keep track of #GtkCList cells
|
|
that contain another widget.
|
|
</para>
|
|
|
|
@type:
|
|
@vertical:
|
|
@horizontal:
|
|
@style:
|
|
@widget:
|
|
|
|
<!-- ##### STRUCT GtkCell ##### -->
|
|
<para>
|
|
A generic structure that the #GtkCList widget uses to keep track of the
|
|
contents of each of its cells.
|
|
</para>
|
|
|
|
@type:
|
|
@vertical:
|
|
@horizontal:
|
|
@style:
|
|
@widget:
|
|
|
|
<!-- ##### STRUCT GtkCListCellInfo ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@row:
|
|
@column:
|
|
|
|
<!-- ##### STRUCT GtkCListDestInfo ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@cell:
|
|
@insert_pos:
|
|
|
|
<!-- ##### ENUM GtkCListDragPos ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@GTK_CLIST_DRAG_NONE:
|
|
@GTK_CLIST_DRAG_BEFORE:
|
|
@GTK_CLIST_DRAG_INTO:
|
|
@GTK_CLIST_DRAG_AFTER:
|
|
|
|
<!-- ##### FUNCTION gtk_clist_construct ##### -->
|
|
<para>
|
|
Initializes a previously allocated #GtkCList widget for use. This should not
|
|
normally be used to create a #GtkCList widget. Use gtk_clist_new() instead.
|
|
</para>
|
|
|
|
@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.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_new ##### -->
|
|
<para>
|
|
Creates a new #GtkCList widget for use.
|
|
</para>
|
|
|
|
@columns: The number of columns the #GtkCList should have.
|
|
@Returns: A pointer to a new GtkCList object.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_new_with_titles ##### -->
|
|
<para>
|
|
Creates a new #GtkCList widget with column titles for use.
|
|
</para>
|
|
|
|
@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.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_set_shadow_type ##### -->
|
|
<para>
|
|
Sets the shadow type for the specified CList. Changing this value
|
|
will cause the #GtkCList to update its visuals.
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@type: The GtkShadowType desired.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_set_selection_mode ##### -->
|
|
<para>
|
|
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.
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@mode: The GtkSelectionMode type to set for this CList.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_freeze ##### -->
|
|
<para>
|
|
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.
|
|
</para>
|
|
|
|
@clist: The #GtkCList to freeze.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_thaw ##### -->
|
|
<para>
|
|
Causes the specified #GtkCList to allow visual updates.
|
|
</para>
|
|
|
|
@clist: The #GtkCList to thaw.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_column_titles_show ##### -->
|
|
<para>
|
|
This function causes the #GtkCList to show its column titles, if
|
|
they are not already showing.
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_column_titles_hide ##### -->
|
|
<para>
|
|
Causes the #GtkCList to hide its column titles, if they are currently
|
|
showing.
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_column_title_active ##### -->
|
|
<para>
|
|
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.
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@column: The column to make active, counting from 0.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_column_title_passive ##### -->
|
|
<para>
|
|
Causes the specified column title button to become passive, i.e., does
|
|
not respond to events, such as the user clicking on it.
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@column: The column to make passive, counting from 0.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_column_titles_active ##### -->
|
|
<para>
|
|
Causes all column title buttons to become active. This is the same
|
|
as calling gtk_clist_column_title_active() for each column.
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_column_titles_passive ##### -->
|
|
<para>
|
|
Causes all column title buttons to become passive. This is the same
|
|
as calling gtk_clist_column_title_passive() for each column.
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_set_column_title ##### -->
|
|
<para>
|
|
Sets the title for the specified column.
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@column: The column whose title should be changed.
|
|
@title: A string to be the column's title.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_set_column_widget ##### -->
|
|
<para>
|
|
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.
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@column: The column whose title should be a widget.
|
|
@widget: A pointer to a previously create widget.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_set_column_justification ##### -->
|
|
<para>
|
|
Sets the justification to be used for all text in the specified
|
|
column.
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@column: The column which should be affected.
|
|
@justification: A GtkJustification value for the column.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_set_column_visibility ##### -->
|
|
<para>
|
|
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.
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@column: The column to set visibility.
|
|
@visible: %TRUE or %FALSE.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_set_column_resizeable ##### -->
|
|
<para>
|
|
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().
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@column: The column on which to set resizeability.
|
|
@resizeable: %TRUE or %FALSE.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_set_column_auto_resize ##### -->
|
|
<para>
|
|
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.
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@column: The column on which to set auto-resizing.
|
|
@auto_resize: %TRUE or %FALSE.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_optimal_column_width ##### -->
|
|
<para>
|
|
Gets the required width in pixels that is needed to show
|
|
everything in the specified column.
|
|
</para>
|
|
|
|
@clist: The #GtkCList to check.
|
|
@column: The column to check.
|
|
@Returns: The required width in pixels for the column.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_set_column_width ##### -->
|
|
<para>
|
|
Causes the column specified for the #GtkCList to be set to
|
|
a specified width.
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@column: The column to set the width.
|
|
@width: The width, in pixels.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_set_column_min_width ##### -->
|
|
<para>
|
|
Causes the column specified to have a minimum width, preventing
|
|
the user from resizing it smaller than that specified.
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@column: The column to set the minimum width.
|
|
@min_width: The width, in pixels.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_set_column_max_width ##### -->
|
|
<para>
|
|
Causes the column specified to have a maximum width, preventing
|
|
the user from resizing it larger than that specified.
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@column: The column to set the maximum width.
|
|
@max_width: The width, in pixels.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_set_row_height ##### -->
|
|
<para>
|
|
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.
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@height: The height, in pixels.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_moveto ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@row:
|
|
@column:
|
|
@row_align:
|
|
@col_align:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_row_is_visible ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist:
|
|
@row:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_get_cell_type ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist:
|
|
@row:
|
|
@column:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_set_text ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@row:
|
|
@column:
|
|
@text:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_get_text ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist:
|
|
@row:
|
|
@column:
|
|
@text:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_set_pixmap ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@row:
|
|
@column:
|
|
@pixmap:
|
|
@mask:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_get_pixmap ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist:
|
|
@row:
|
|
@column:
|
|
@pixmap:
|
|
@mask:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_set_pixtext ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@row:
|
|
@column:
|
|
@text:
|
|
@spacing:
|
|
@pixmap:
|
|
@mask:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_get_pixtext ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist:
|
|
@row:
|
|
@column:
|
|
@text:
|
|
@spacing:
|
|
@pixmap:
|
|
@mask:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_set_foreground ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@row:
|
|
@color:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_set_background ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@row:
|
|
@color:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_set_cell_style ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@row:
|
|
@column:
|
|
@style:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_get_cell_style ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist:
|
|
@row:
|
|
@column:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_set_row_style ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@row:
|
|
@style:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_get_row_style ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist:
|
|
@row:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_set_shift ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@row:
|
|
@column:
|
|
@vertical:
|
|
@horizontal:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_set_selectable ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@row:
|
|
@selectable:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_get_selectable ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist:
|
|
@row:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_prepend ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@text:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_append ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@text:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_insert ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@row:
|
|
@text:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_remove ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@row:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_set_row_data ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@row:
|
|
@data:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_set_row_data_full ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@row:
|
|
@data:
|
|
@destroy:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_get_row_data ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist:
|
|
@row:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_find_row_from_data ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist:
|
|
@data:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_select_row ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@row:
|
|
@column:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_unselect_row ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@row:
|
|
@column:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_undo_selection ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_clear ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_get_selection_info ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist:
|
|
@x:
|
|
@y:
|
|
@row:
|
|
@column:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_select_all ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_unselect_all ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_swap_rows ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@row1:
|
|
@row2:
|
|
|
|
|
|
<!-- ##### 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>
|
|
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_get_column_title ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist:
|
|
@column:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_get_column_widget ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist:
|
|
@column:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_get_hadjustment ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### 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 widget, 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:
|
|
@dest_row:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_clist_set_button_actions ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: The #GtkCList to affect.
|
|
@button:
|
|
@button_actions:
|
|
|
|
|
|
<!-- ##### 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>
|
|
|
|
</para>
|
|
|
|
@clist:
|
|
@reorderable:
|
|
|
|
|
|
<!-- ##### 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.
|
|
|
|
|
|
<!-- ##### SIGNAL GtkCList::select-row ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: the object which received the signal.
|
|
@row:
|
|
@column:
|
|
@event:
|
|
|
|
<!-- ##### SIGNAL GtkCList::unselect-row ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: the object which received the signal.
|
|
@row:
|
|
@column:
|
|
@event:
|
|
|
|
<!-- ##### SIGNAL GtkCList::row-move ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: the object which received the signal.
|
|
@arg1:
|
|
@arg2:
|
|
|
|
<!-- ##### SIGNAL GtkCList::click-column ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: the object which received the signal.
|
|
@column:
|
|
|
|
<!-- ##### SIGNAL GtkCList::resize-column ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: the object which received the signal.
|
|
@column:
|
|
@width:
|
|
|
|
<!-- ##### SIGNAL GtkCList::toggle-focus-row ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: the object which received the signal.
|
|
|
|
<!-- ##### SIGNAL GtkCList::select-all ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: the object which received the signal.
|
|
|
|
<!-- ##### SIGNAL GtkCList::unselect-all ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: the object which received the signal.
|
|
|
|
<!-- ##### SIGNAL GtkCList::undo-selection ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: the object which received the signal.
|
|
|
|
<!-- ##### SIGNAL GtkCList::start-selection ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: the object which received the signal.
|
|
|
|
<!-- ##### SIGNAL GtkCList::end-selection ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: the object which received the signal.
|
|
|
|
<!-- ##### SIGNAL GtkCList::toggle-add-mode ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: the object which received the signal.
|
|
|
|
<!-- ##### SIGNAL GtkCList::extend-selection ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: the object which received the signal.
|
|
@scroll_type:
|
|
@position:
|
|
@auto_start_selection:
|
|
|
|
<!-- ##### SIGNAL GtkCList::scroll-vertical ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: the object which received the signal.
|
|
@scroll_type:
|
|
@position:
|
|
|
|
<!-- ##### SIGNAL GtkCList::scroll-horizontal ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: the object which received the signal.
|
|
@scroll_type:
|
|
@position: a value between 0.0 and 1.0.
|
|
|
|
<!-- ##### SIGNAL GtkCList::abort-column-resize ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@clist: the object which received the signal.
|
|
|
|
<!-- ##### ARG GtkCList:n_columns ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkCList:shadow_type ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkCList:selection_mode ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkCList:row_height ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkCList:reorderable ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkCList:titles_active ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkCList:use_drag_icons ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|