79 lines
4.4 KiB
Plaintext
79 lines
4.4 KiB
Plaintext
|
|
/**************** 2024-01-06 À la chasse aux widgets ! ****************/
|
|
/* in > 01/GTK4/tree (learning)/The_Gnome_way/demos/gtk-demo */
|
|
/* */
|
|
/* tree_store() listview_words() editable_cells() search_entry2() */
|
|
/* dnd()(= drag and drop) entry_undo() expander() textundo() */
|
|
/* scale() (= scale entries from bars) font_features() hypertext() */
|
|
/* iconview_edit() (= drag and drop icons) image_scaling() infobar() */
|
|
/* links() listbox_controls() list_store() listview_colors() */
|
|
/* listview_selections() mask(NULL) and more... */
|
|
/* */
|
|
/******************************************************************************/
|
|
|
|
/*************** The basic ideas behind list views: *******************/
|
|
/* */
|
|
/* The data for items is provided in the form of a model containing objects */
|
|
/* Widgets are created just for the viewable range of items */
|
|
/* Widgets can be recycled by binding them to different items */
|
|
/* Avoid iterating over all items in the model as much as possible, and */
|
|
/* just deal with the items in the visible range which are bound to widgets */
|
|
/* from https://blog.gtk.org/2020/06/07/scalable-lists-in-gtk-4/ */
|
|
/* */
|
|
/******************************************************************************/
|
|
|
|
|
|
// GtkListItemFactory is the object that is tasked with creating widgets
|
|
// for the items in the model.
|
|
// One implementations of this factory, GtkBuilderListItemFactory,
|
|
// is using ui files as templates for the list item widgets.
|
|
|
|
|
|
/*************** A B O U T T R E E S **************************/
|
|
/* */
|
|
/* https://docs.gtk.org/gtk4/ */
|
|
/* https://docs.gtk.org/gtk4/getting_started.html */
|
|
/* https://toshiocp.github.io/Gtk4-tutorial/sec29.html <<< TODO (tuto) */
|
|
/* Keep the "comparison chart of equivalent functionalities" (link below) */
|
|
/* https://docs.gtk.org/gtk4/section-list-widget.html */
|
|
/* https://en.wikibooks.org/wiki/GTK%2B_By_Example/Tree_View */
|
|
/* https://gnome.pages.gitlab.gnome.org/libsoup/gio/GListModel.html */
|
|
/* https://docs.gtk.org/gio/iface.ListModel.html < +++ */
|
|
/* */
|
|
/* https://docs.gtk.org/gtk4/class.TreeListModel.html (easy to find) */
|
|
/* https://developer-old.gnome.org/gtk4/stable/GtkTreeView.html (vieux...) */
|
|
/* get-path-at-pos(x,y) finds the path at these window coordinates. */
|
|
/* https://blog.gtk.org/2020/09/08/on-list-models/ */
|
|
/* */
|
|
/******************************************************************************/
|
|
|
|
/*..............................................................................
|
|
*
|
|
* >>> GtkStringList <<<
|
|
*
|
|
* GtkStringList is a list model that wraps an array of strings.
|
|
* The objects in the model are of type GtkStringObject
|
|
* and have a “string” property that can be used inside expressions.
|
|
* Use it where/when you would typically use a char*[], but need a list model.
|
|
*
|
|
* Every item in a model has a position (= unsigned integer)
|
|
* "factories" takes care of mapping the items of the model
|
|
* to widgets that can be shown in the view
|
|
* by creating a listitem for each item that is currently in use.
|
|
* List items are always GtkListItem instances. Widgets can be recycled.
|
|
*
|
|
* GtkStringList can only handle strings.
|
|
* It is backed by a dynamically allocated array.
|
|
* GListStore is backed by a balanced tree.
|
|
*
|
|
* GTK provides functionality to make lists look and behave like trees
|
|
* by using the GtkTreeListModel and the GtkTreeExpander widget.
|
|
*
|
|
* Widgets are styleable using GTK CSS. Use the .rich-list style class.
|
|
*
|
|
* GListModel is an interface that represents a mutable list of GObjects.
|
|
*
|
|
*............................................................................*/
|
|
|
|
|