AuroraMiddleware/gtk2
1
0
Fork 0
forked from AuroraMiddleware/gtk
Code Issues Pull Requests Projects Releases Wiki Activity
d775caff7f
gtk2/gtk/gtklistitemfactoryprivate.h

83 lines
4.3 KiB
C
Raw Normal View History

listview: Introduce GtkListItemFactory Thisis the abstraction I intend to use for creating widgets and binding them to the item out of the listview. For now this is a very dumb wrapper around the functions that exist in the API. But it leaves the freedom to turn this into public API, make an interface out of it and most of all write different implementations, in particular one that uses GtkBuilder.
2018-09-17 05:29:50 +00:00
/*
* Copyright © 2018 Benjamin Otte
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
*
* Authors: Benjamin Otte <otte@gnome.org>
*/
listview: Expose GtkListItemFactory APIs Due to the many different ways to set factories, it makes sense to expose them as custom objects. This makes the actual APIs for the list widgets simpler, because they can just have a regular "factory" property. As a convenience function, gtk_list_view_new_with_factory() was added to make this whole approach easy to use from C.
2019-10-08 22:07:07 +00:00
#ifndef __GTK_LIST_ITEM_FACTORY_PRIVATE_H__
#define __GTK_LIST_ITEM_FACTORY_PRIVATE_H__
listview: Introduce GtkListItemFactory Thisis the abstraction I intend to use for creating widgets and binding them to the item out of the listview. For now this is a very dumb wrapper around the functions that exist in the API. But it leaves the freedom to turn this into public API, make an interface out of it and most of all write different implementations, in particular one that uses GtkBuilder.
2018-09-17 05:29:50 +00:00
listview: Add GtkListItem GtkListItem is a generic row widget that is supposed to replace GtkListBoxRow and GtkFlowBoxChild.
2018-09-21 03:05:34 +00:00
#include <gtk/gtklistitem.h>
listitemfactory: Simplify Instead of 6 vfuncs, we now have 3 and rely on the factory keeping track of what it needs to do. We're doing lots of dancing from one object to another here, but this will hopefully get simpler with further commits.
2019-11-03 01:23:46 +00:00
#include "gtk/gtklistitemwidgetprivate.h"
listview: Introduce GtkListItemFactory Thisis the abstraction I intend to use for creating widgets and binding them to the item out of the listview. For now this is a very dumb wrapper around the functions that exist in the API. But it leaves the freedom to turn this into public API, make an interface out of it and most of all write different implementations, in particular one that uses GtkBuilder.
2018-09-17 05:29:50 +00:00
G_BEGIN_DECLS
listitemfactory: Sanitize APIs Make sure the APIs follow a predictable path: setup bind rebind/update (0-N times) unbind teardown This is the first step towards providing multiple different factories.
2019-06-09 20:50:46 +00:00
struct _GtkListItemFactory
{
GObject parent_instance;
};
struct _GtkListItemFactoryClass
{
GObjectClass parent_class;
listitemfactory: vfuncify No functional changes other than a new indirection.
2019-06-09 22:17:44 +00:00
/* setup @list_item so it can be bound */
void (* setup) (GtkListItemFactory *self,
listitemfactory: Make this callback-based This way, we no longer prescribe the use of either GtkListItem or GtkListItemWidget. This means we can use it in other places, such as for custom section header objects or with my Canvas ideas.
2022-06-28 14:34:24 +00:00
GObject *item,
gboolean bind,
GFunc func,
gpointer data);
listitemfactory: vfuncify No functional changes other than a new indirection.
2019-06-09 22:17:44 +00:00
/* undo the effects of GtkListItemFactoryClass::setup() */
void (* teardown) (GtkListItemFactory *self,
listitemfactory: Make this callback-based This way, we no longer prescribe the use of either GtkListItem or GtkListItemWidget. This means we can use it in other places, such as for custom section header objects or with my Canvas ideas.
2022-06-28 14:34:24 +00:00
GObject *item,
gboolean unbind,
GFunc func,
gpointer data);
listitemfactory: vfuncify No functional changes other than a new indirection.
2019-06-09 22:17:44 +00:00
listitemfactory: Reorganize vfuncs Instead of bind/rebind/update/unbind, we now just have update, and the factories get to interpret that in the way they want.
2019-11-02 17:56:36 +00:00
/* Update properties on @list_item to the given @item, which is in @position and @selected state.
* One or more of those properties might be unchanged. */
listitemfactory: vfuncify No functional changes other than a new indirection.
2019-06-09 22:17:44 +00:00
void (* update) (GtkListItemFactory *self,
listitemfactory: Make this callback-based This way, we no longer prescribe the use of either GtkListItem or GtkListItemWidget. This means we can use it in other places, such as for custom section header objects or with my Canvas ideas.
2022-06-28 14:34:24 +00:00
GObject *item,
gboolean unbind,
gboolean bind,
GFunc func,
gpointer data);
listitemfactory: Sanitize APIs Make sure the APIs follow a predictable path: setup bind rebind/update (0-N times) unbind teardown This is the first step towards providing multiple different factories.
2019-06-09 20:50:46 +00:00
};
listitem: Add a press gesture to select the item This is implemented by using actions, which are a neat trick to get to allow the ListItem to call functions on the ListView without actually needing to be aware of it.
2018-10-05 21:24:18 +00:00
void gtk_list_item_factory_setup (GtkListItemFactory *self,
listitemfactory: Make this callback-based This way, we no longer prescribe the use of either GtkListItem or GtkListItemWidget. This means we can use it in other places, such as for custom section header objects or with my Canvas ideas.
2022-06-28 14:34:24 +00:00
GObject *item,
gboolean bind,
GFunc func,
gpointer data);
listitemfactory: Sanitize APIs Make sure the APIs follow a predictable path: setup bind rebind/update (0-N times) unbind teardown This is the first step towards providing multiple different factories.
2019-06-09 20:50:46 +00:00
void gtk_list_item_factory_teardown (GtkListItemFactory *self,
listitemfactory: Make this callback-based This way, we no longer prescribe the use of either GtkListItem or GtkListItemWidget. This means we can use it in other places, such as for custom section header objects or with my Canvas ideas.
2022-06-28 14:34:24 +00:00
GObject *item,
gboolean unbind,
GFunc func,
gpointer data);
listview: Introduce GtkListItemFactory Thisis the abstraction I intend to use for creating widgets and binding them to the item out of the listview. For now this is a very dumb wrapper around the functions that exist in the API. But it leaves the freedom to turn this into public API, make an interface out of it and most of all write different implementations, in particular one that uses GtkBuilder.
2018-09-17 05:29:50 +00:00
listitem: Add gtk_list_item_get_position() Also refactor the whole list item management yet again. Now, list item APIs doesn't have bind/unbind functions anymore, but only property setters. The item factory is the only one doing the binding. As before, the item manager manages when items need to be bound.
2018-09-24 02:01:37 +00:00
void gtk_list_item_factory_update (GtkListItemFactory *self,
listitemfactory: Make this callback-based This way, we no longer prescribe the use of either GtkListItem or GtkListItemWidget. This means we can use it in other places, such as for custom section header objects or with my Canvas ideas.
2022-06-28 14:34:24 +00:00
GObject *item,
gboolean unbind,
gboolean bind,
GFunc func,
gpointer data);
listview: Introduce GtkListItemFactory Thisis the abstraction I intend to use for creating widgets and binding them to the item out of the listview. For now this is a very dumb wrapper around the functions that exist in the API. But it leaves the freedom to turn this into public API, make an interface out of it and most of all write different implementations, in particular one that uses GtkBuilder.
2018-09-17 05:29:50 +00:00
G_END_DECLS
listview: Expose GtkListItemFactory APIs Due to the many different ways to set factories, it makes sense to expose them as custom objects. This makes the actual APIs for the list widgets simpler, because they can just have a regular "factory" property. As a convenience function, gtk_list_view_new_with_factory() was added to make this whole approach easy to use from C.
2019-10-08 22:07:07 +00:00
#endif /* __GTK_LIST_ITEM_FACTORY_PRIVATE_H__ */
Reference in New Issue Copy Permalink