Enlightenment CVS committal Author : moom Project : e17 Module : libs/etk
Dir : e17/libs/etk/src/lib Modified Files: etk_tree.c Log Message: * [Doc] Document the signals/properties of Etk_Tree =================================================================== RCS file: /cvs/e/e17/libs/etk/src/lib/etk_tree.c,v retrieving revision 1.93 retrieving revision 1.94 diff -u -3 -r1.93 -r1.94 --- etk_tree.c 2 Apr 2007 22:11:53 -0000 1.93 +++ etk_tree.c 4 Apr 2007 19:57:32 -0000 1.94 @@ -173,6 +173,7 @@ tree_type, -1, etk_marshaller_VOID__POINTER, NULL, NULL); _etk_tree_signals[ETK_TREE_ROW_CLICKED_SIGNAL] = etk_signal_new("row-clicked", tree_type, -1, etk_marshaller_VOID__POINTER_POINTER, NULL, NULL); + /* TODO: do we really need "row-activated" */ _etk_tree_signals[ETK_TREE_ROW_ACTIVATED_SIGNAL] = etk_signal_new("row-activated", tree_type, -1, etk_marshaller_VOID__POINTER, NULL, NULL); _etk_tree_signals[ETK_TREE_ROW_UNFOLDED_SIGNAL] = etk_signal_new("row-unfolded", @@ -1247,7 +1248,7 @@ * @param emit_signal whether or not the "cell-value-changed" signal should be emitted on the modified columns. * Most of the time, the signal don't need to be emitted (so @a emit_signal should be ETK_FALSE), except if you have a * callback connected on this signal - * @param args an "Etk_Tree_Model *" followed by the value of the model, then any number of + * @param ... an "Etk_Tree_Model *" followed by the value of the model, then any number of * "Etk_Tree_Model *"/Value pairs, and terminated by NULL. * Note that, according to the models, a cell value can use several parameters */ @@ -3578,3 +3579,155 @@ } /** @} */ + +/************************** + * + * Documentation + * + **************************/ + +/** + * @addtogroup Etk_Tree + * + * @image html widgets/tree.png + * + * \par Object Hierarchy: + * - Etk_Object + * - Etk_Widget + * - Etk_Tree + * + * <hr> + * + * \par Signals of Etk_Tree: + * @signal_name "row-selected": Emitted when a row is selected + * @signal_cb void callback(Etk_Tree *tree, Etk_Tree_Row *row, void *data) + * @signal_arg tree: the tree containing the row that has been selected + * @signal_arg row: the row that has been selected + * @signal_data + * \par + * @signal_name "row-unselected": Emitted when a row is unselected + * @signal_cb void callback(Etk_Tree *tree, Etk_Tree_Row *row, void *data) + * @signal_arg tree: the tree containing the row that has been unselected + * @signal_arg row: the row that has been unselected + * @signal_data + * \par + * @signal_name "all-selected": Emitted when all the rows of a tree are selected with etk_tree_select_all() + * @signal_cb void callback(Etk_Tree *tree, void *data) + * @signal_arg tree: the tree whose all rows have been selected + * @signal_data + * \par + * @signal_name "all-unselected": Emitted when all the rows of a tree are unselected with etk_tree_unselect_all() + * @signal_cb void callback(Etk_Tree *tree, void *data) + * @signal_arg tree: the tree whose all rows have been unselected + * @signal_data + * \par + * @signal_name "row-clicked": Emitted when a row of the tree has been clicked + * @signal_cb void callback(Etk_Tree *tree, Etk_Tree_Row *row, Etk_Event_Mouse_Up *event, void *data) + * @signal_arg tree: the tree containing the row that has been clicked + * @signal_arg row: the row that has been clicked + * @signal_arg event: the event-structure corresponding to the click event + * @signal_data + * \par + * @signal_name "row-activated": Emitted when a row is double-clicked or when the user presses "space" on a selected row + * @signal_cb void callback(Etk_Tree *tree, Etk_Tree_Row *row, void *data) + * @signal_arg tree: the tree containing the row that has been activated + * @signal_arg row: the row that has been activated + * @signal_data + * \par + * @signal_name "row-unfolded": Emitted when a row is unfolded + * @signal_cb void callback(Etk_Tree *tree, Etk_Tree_Row *row, void *data) + * @signal_arg tree: the tree containing the row that has been unfolded + * @signal_arg row: the row that has been unfolded + * @signal_data + * \par + * @signal_name "row-folded": Emitted when a row is folded + * @signal_cb void callback(Etk_Tree *tree, Etk_Tree_Row *row, void *data) + * @signal_arg tree: the tree containing the row that has been folded + * @signal_arg row: the row that has been folded + * @signal_data + * \par + * @signal_name "row-shown": Emitted when a row becomes visible, i.e when the row enters in the tree's viewport + * @signal_cb void callback(Etk_Tree *tree, Etk_Tree_Row *row, void *data) + * @signal_arg tree: the tree containing the row that has hecome visible + * @signal_arg row: the row that has hecome visible + * @signal_data + * \par + * @signal_name "row-hidden": Emitted when a row becomes invisible, i.e when the row leaves in the tree's viewport + * @signal_cb void callback(Etk_Tree *tree, Etk_Tree_Row *row, void *data) + * @signal_arg tree: the tree containing the row that has hecome invisible + * @signal_arg row: the row that has hecome invisible + * @signal_data + * + * \par Properties of Etk_Tree: + * @prop_name "mode": The current mode of the tree ("tree" or "list" mode) + * @prop_type Integer (Etk_Tree_Mode) + * @prop_rw + * @prop_val ETK_TREE_MODE_LIST + * \par + * @prop_name "multiple-select": Whether or not several rows of the tree can be selected + * @prop_type Boolean + * @prop_rw + * @prop_val ETK_TRUE + * \par + * @prop_name "headers-visible": Whether or not the headers of the columns are visible + * @prop_type Boolean + * @prop_rw + * @prop_val ETK_TRUE + * \par + * @prop_name "rows-height": The height of the rows of the tree + * @prop_type Integer + * @prop_rw + * @prop_val 24 + * + * <hr> + * + * \par Signals of Etk_Tree_Col: + * @signal_name "cell-value-changed": Emitted when the value of a cell of the column is changed + * @signal_cb void callback(Etk_Tree_Col *col, Etk_Tree_Row *row, void *data) + * @signal_arg col: the column containing the cell whose value has been changed + * @signal_arg row: the row containing the cell whose value has been changed + * @signal_data + * + * \par Properties of Etk_Tree_Col: + * @prop_name "title": The title of the column + * @prop_type String (char *) + * @prop_rw + * @prop_val NULL + * \par + * @prop_name "visible": Whether or not the column is visible + * @prop_type Boolean + * @prop_rw + * @prop_val ETK_TRUE + * \par + * @prop_name "resizable": Whether or not the column can be resized by the user + * @prop_type Boolean + * @prop_rw + * @prop_val ETK_TRUE + * \par + * @prop_name "position": The position of the column inside the tree (between 0 and (num_cols - 1)) + * @prop_type Integer + * @prop_rw + * @prop_val 0 + * \par + * @prop_name "expand": Whether the column should expand to take up all available width + * @prop_type Boolean + * @prop_rw + * @prop_val ETK_FALSE + * \par + * @prop_name "width": The current width of the column + * @prop_type Boolean + * @prop_rw + * @prop_val 24 + * \par + * @prop_name "min-width": The minimum width of the column + * @prop_type Boolean + * @prop_rw + * @prop_val 24 + * \par + * @prop_name "align": The horizontal alignment of the objects inside the cells of the column, from 0.0 (left) to 1.0 (right) + * @prop_type Float + * @prop_rw + * @prop_val 0.0 + * + * <hr> + */ ------------------------------------------------------------------------- Take Surveys. Earn Cash. Influence the Future of IT Join SourceForge.net's Techsay panel and you'll get the chance to share your opinions on IT & business topics through brief surveys-and earn cash http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV _______________________________________________ enlightenment-cvs mailing list enlightenment-cvs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/enlightenment-cvs