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

gtktreemodelfilter: Move documentation to inline comments

Browse Source
This commit is contained in:
Javier Jardón
2010-10-22 22:32:10 +02:00
parent 8d3b36d534
commit ec0c739520
4 changed files with 61 additions and 198 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
docs/reference/gtk/tmpl/.gitignore vendored
View File

@ -50,6 +50,7 @@ gtktoolbar.sgml
gtktoolitem.sgml
gtktooltip.sgml
gtktreednd.sgml
gtktreemodelfilter.sgml
gtktreeselection.sgml
gtktreesortable.sgml
gtktreestore.sgml

198
docs/reference/gtk/tmpl/gtktreemodelfilter.sgml
View File

@ -1,198 +0,0 @@
<!-- ##### SECTION Title ##### -->
GtkTreeModelFilter
<!-- ##### SECTION Short_Description ##### -->
A GtkTreeModel which hides parts of an underlying tree model
<!-- ##### SECTION Long_Description ##### -->
<para>
A #GtkTreeModelFilter is a tree model which wraps another tree model,
and can do the following things:
<itemizedlist>
<listitem><para>
Filter specific rows, based on data from a "visible column", a column
storing booleans indicating whether the row should be filtered or not,
or based on the return value of a "visible function", which gets a
model, iter and user_data and returns a boolean indicating whether the
row should be filtered or not.
</para></listitem>
<listitem><para>
Modify the "appearance" of the model, using a modify function.
This is extremely powerful and allows for just changing
some values and also for creating a completely different model based on
the given child model.
</para></listitem>
<listitem><para>
Set a different root node, also known as a "virtual root". You can pass in
a #GtkTreePath indicating the root node for the filter at construction time.
</para></listitem>
</itemizedlist>
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
#GtkTreeModelSort
</para>
<!-- ##### SECTION Stability_Level ##### -->
<!-- ##### SECTION Image ##### -->
<!-- ##### STRUCT GtkTreeModelFilter ##### -->
<para>
The GtkTreeModelFilter struct contains only private fields.
</para>
<!-- ##### ARG GtkTreeModelFilter:child-model ##### -->
<para>
</para>
<!-- ##### ARG GtkTreeModelFilter:virtual-root ##### -->
<para>
</para>
<!-- ##### USER_FUNCTION GtkTreeModelFilterVisibleFunc ##### -->
<para>
A function which decides whether the row indicated by @iter is visible.
</para>
@model: the child model of the #GtkTreeModelFilter
@iter: a #GtkTreeIter pointing to the row in @model whose visibility
is determined
@data: user data given to gtk_tree_model_filter_set_visible_func()
@Returns: Whether the row indicated by @iter is visible.
<!-- ##### USER_FUNCTION GtkTreeModelFilterModifyFunc ##### -->
<para>
A function which calculates display values from raw values in the model.
It must fill @value with the display value for the column @column in the
row indicated by @iter.
</para>
<para>
Since this function is called for each data access, it's not a
particularly efficient operation.
</para>
@model: the #GtkTreeModelFilter
@iter: a #GtkTreeIter pointing to the row whose display values are determined
@value: A #GValue which is already initialized for with the correct type for
the column @column.
@column: the column whose display value is determined
@data: user data given to gtk_tree_model_filter_set_modify_func()
<!-- ##### FUNCTION gtk_tree_model_filter_new ##### -->
<para>
</para>
@child_model:
@root:
@Returns:
<!-- ##### FUNCTION gtk_tree_model_filter_set_visible_func ##### -->
<para>
</para>
@filter:
@func:
@data:
@destroy:
<!-- ##### FUNCTION gtk_tree_model_filter_set_modify_func ##### -->
<para>
</para>
@filter:
@n_columns:
@types:
@func:
@data:
@destroy:
<!-- ##### FUNCTION gtk_tree_model_filter_set_visible_column ##### -->
<para>
</para>
@filter:
@column:
<!-- ##### FUNCTION gtk_tree_model_filter_get_model ##### -->
<para>
</para>
@filter:
@Returns:
<!-- ##### FUNCTION gtk_tree_model_filter_convert_child_iter_to_iter ##### -->
<para>
</para>
@filter:
@filter_iter:
@child_iter:
@Returns:
<!-- ##### FUNCTION gtk_tree_model_filter_convert_iter_to_child_iter ##### -->
<para>
</para>
@filter:
@child_iter:
@filter_iter:
<!-- ##### FUNCTION gtk_tree_model_filter_convert_child_path_to_path ##### -->
<para>
</para>
@filter:
@child_path:
@Returns:
<!-- ##### FUNCTION gtk_tree_model_filter_convert_path_to_child_path ##### -->
<para>
</para>
@filter:
@filter_path:
@Returns:
<!-- ##### FUNCTION gtk_tree_model_filter_refilter ##### -->
<para>
</para>
@filter:
<!-- ##### FUNCTION gtk_tree_model_filter_clear_cache ##### -->
<para>
</para>
@filter: