AuroraMiddleware/gtk2
1
0
Fork 0
forked from AuroraMiddleware/gtk
Code Issues Pull Requests Projects Releases Wiki Activity
21536775d7
gtk2/gtk/gtkwidgetprivate.h

169 lines
9.3 KiB
C
Raw Normal View History

Split off gtkprivate.h The gtkprivate.h header contains GtkWidget-specific private symbols that are not useful except in a handful of cases. Basically everything includes gtkprivate.h for the GTK_PARAM_* macros. https://bugzilla.gnome.org/show_bug.cgi?id=632539
2010-10-19 17:14:46 +00:00
/* GTK - The GIMP Toolkit
* Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
*
* 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 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
Port gtk_draw_insertion_cursor to GtkStyleContext
2011-01-24 05:24:12 +00:00
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Split off gtkprivate.h The gtkprivate.h header contains GtkWidget-specific private symbols that are not useful except in a handful of cases. Basically everything includes gtkprivate.h for the GTK_PARAM_* macros. https://bugzilla.gnome.org/show_bug.cgi?id=632539
2010-10-19 17:14:46 +00:00
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
Change FSF Address
2012-02-27 13:01:10 +00:00
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
Split off gtkprivate.h The gtkprivate.h header contains GtkWidget-specific private symbols that are not useful except in a handful of cases. Basically everything includes gtkprivate.h for the GTK_PARAM_* macros. https://bugzilla.gnome.org/show_bug.cgi?id=632539
2010-10-19 17:14:46 +00:00
*/
/*
* Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
* file for a list of people on the GTK+ Team. See the ChangeLog
* files for a list of changes. These files are distributed with
* GTK+ at ftp://ftp.gtk.org/pub/gtk/.
*/
#ifndef __GTK_WIDGET_PRIVATE_H__
#define __GTK_WIDGET_PRIVATE_H__
widget: Add _gtk_widget_invalidate_style_context() This is supposed to replace gtk_widget_reset_style().
2012-03-20 14:40:53 +00:00
#include "gtkcsstypesprivate.h"
#include "gtkwidget.h"
Drop an unneeded include There's no GtkGesture in gtkwidget.h anymore. We do need an include in gtkwidgetprivate.h though.
2014-05-24 00:04:36 +00:00
#include "gtkeventcontroller.h"
action stuff: stop abusing GLib's namespace Rename our internal GActionMuxer, GActionObserver and GActionObservable classes and interfaces to have names in our own namespace. These classes were originally intended for GIO but turned out to be too special-purpose to be useful there, so we never made them public API but have just been copying them around (without bothering to properly rename them). Now that other people will be copying them out of Gtk, it's even more important to prevent this namespace abuse from spreading further.
2013-05-09 18:15:51 +00:00
#include "gtkactionmuxer.h"
widget: Add _gtk_widget_invalidate_style_context() This is supposed to replace gtk_widget_reset_style().
2012-03-20 14:40:53 +00:00
Split off gtkprivate.h The gtkprivate.h header contains GtkWidget-specific private symbols that are not useful except in a handful of cases. Basically everything includes gtkprivate.h for the GTK_PARAM_* macros. https://bugzilla.gnome.org/show_bug.cgi?id=632539
2010-10-19 17:14:46 +00:00
G_BEGIN_DECLS
void _gtk_widget_set_visible_flag (GtkWidget *widget,
gboolean visible);
gboolean _gtk_widget_get_in_reparent (GtkWidget *widget);
void _gtk_widget_set_in_reparent (GtkWidget *widget,
gboolean in_reparent);
gboolean _gtk_widget_get_anchored (GtkWidget *widget);
void _gtk_widget_set_anchored (GtkWidget *widget,
gboolean anchored);
gboolean _gtk_widget_get_shadowed (GtkWidget *widget);
void _gtk_widget_set_shadowed (GtkWidget *widget,
gboolean shadowed);
gboolean _gtk_widget_get_alloc_needed (GtkWidget *widget);
void _gtk_widget_set_alloc_needed (GtkWidget *widget,
gboolean alloc_needed);
Only handle exposes on native window, propagate to children via draw() We now consider non-native windows non-opaque, which means any invalid area in a subwindow will also be invalid all the way up to the nearest native windows. We take advantage of this by ignoring all expose events on non-native windows (which typically means just the toplevel) and instead propagating down the draw() calls to children directly via gtk_container_propagate_draw. This is nice as it means we always draw widgets the same way, and it will let us do some interesting ways in the future. We also clean up the GtkWidget opacity handling as we can now always rely on the draing happening via cairo. We can't really just draw by walking down the widget hierarchy, as this doesn't get the clipping right (so e.g. widgets doing cairo_paint may draw outside the expected gdkwindow subarea) nor does it let us paint window backgrounds. So, we now do multiple draws for each widget, once for each GdkWindow, although we still do it on the same base cairo_t that we get for the toplevel native window. The difference is only the clipping, the rendering order, and which other widgets we propagate into. We also collect all the windows of a widget so we can expose them inside the same opacity group if needed. NOTE: This change neuters gtk_widget_set_double_buffered for widgets without native windows. Its impossible to disable the double buffering in this model.
2013-04-17 18:55:26 +00:00
void _gtk_widget_draw (GtkWidget *widget,
cairo_t *cr);
widget: Track when the window scale factor changes and notify The scale-factor property on the widgets will be notified, and the scale will change on the style property, causing us to pick up new css assets.
2013-06-28 08:39:52 +00:00
void _gtk_widget_scale_changed (GtkWidget *widget);
Split off gtkprivate.h The gtkprivate.h header contains GtkWidget-specific private symbols that are not useful except in a handful of cases. Basically everything includes gtkprivate.h for the GTK_PARAM_* macros. https://bugzilla.gnome.org/show_bug.cgi?id=632539
2010-10-19 17:14:46 +00:00
Optimize queue_resize_on_widget() Optimized GtkSizeGroup code that is invoked for every queued resize and every request that is not previously cached by trading qdata on widgets for 3 extra bitfields on the GtkWidgetPrivate structure.
2011-02-07 07:55:25 +00:00
void _gtk_widget_add_sizegroup (GtkWidget *widget,
gpointer group);
void _gtk_widget_remove_sizegroup (GtkWidget *widget,
gpointer group);
GSList *_gtk_widget_get_sizegroups (GtkWidget *widget);
Introduce gtk_window_get/set_attached_to() gtk_window_get/set_attached_to() is a new API that allows for windows to be attached to a GtkWidget. The attachment is a logical binding between the toplevel window and the widget that generated it; this kind of information is currently used to propagate style information from the widget to the window, but is also useful e.g. for accessibility. https://bugzilla.gnome.org/show_bug.cgi?id=666103
2012-01-12 18:29:52 +00:00
void _gtk_widget_add_attached_window (GtkWidget *widget,
GtkWindow *window);
void _gtk_widget_remove_attached_window (GtkWidget *widget,
GtkWindow *window);
Split off gtkprivate.h The gtkprivate.h header contains GtkWidget-specific private symbols that are not useful except in a handful of cases. Basically everything includes gtkprivate.h for the GTK_PARAM_* macros. https://bugzilla.gnome.org/show_bug.cgi?id=632539
2010-10-19 17:14:46 +00:00
void _gtk_widget_override_size_request (GtkWidget *widget,
Port gtk_draw_insertion_cursor to GtkStyleContext
2011-01-24 05:24:12 +00:00
int width,
int height,
int *old_width,
int *old_height);
Split off gtkprivate.h The gtkprivate.h header contains GtkWidget-specific private symbols that are not useful except in a handful of cases. Basically everything includes gtkprivate.h for the GTK_PARAM_* macros. https://bugzilla.gnome.org/show_bug.cgi?id=632539
2010-10-19 17:14:46 +00:00
void _gtk_widget_restore_size_request (GtkWidget *widget,
Port gtk_draw_insertion_cursor to GtkStyleContext
2011-01-24 05:24:12 +00:00
int old_width,
int old_height);
sizerequest: Split out a common function
2013-04-22 21:37:05 +00:00
void _gtk_widget_get_preferred_size_for_size (GtkWidget *widget,
GtkOrientation orientation,
gint size,
gint *minimum,
widget: Adapt _gtk_widget_get_preferred_size_for_size() ... for baseline support byu taking two extra (possible NULL) arguments.
2013-04-27 21:16:11 +00:00
gint *natural,
gint *minimum_baseline,
gint *natural_baseline);
API: Don't export gtk_widget_preferred_size_and_baseline() gtk_widget_preferred_size() is only useful if you want to quickly port a widget from GTK2 sizing code to GTK3 but does not properly work with height-for-width as used in GTK. So we don't want to encourage people to use it. In particular we want people to convert to height-for-width before adding baseline support to their widgets.
2013-05-11 12:29:29 +00:00
void _gtk_widget_get_preferred_size_and_baseline(GtkWidget *widget,
GtkRequisition *minimum_size,
GtkRequisition *natural_size,
gint *minimum_baseline,
gint *natural_baseline);
Handle non-baseline supporting subclasses overriding baseline supporting classes If a subclass (say a child of GtkButton) overrides the non-baseline size request methods we need to call these, rather than the new get_height_and_baseline_for_width method. In order to handle this we make the default for this method to be NULL, and instead check at runtime which method to call. If any non-baseline vfunc has changed in a class but the baseline one hasn't, then we can't use the baseline one.
2013-03-27 09:22:14 +00:00
gboolean _gtk_widget_has_baseline_support (GtkWidget *widget);
Split off gtkprivate.h The gtkprivate.h header contains GtkWidget-specific private symbols that are not useful except in a handful of cases. Basically everything includes gtkprivate.h for the GTK_PARAM_* macros. https://bugzilla.gnome.org/show_bug.cgi?id=632539
2010-10-19 17:14:46 +00:00
Fix coalescing of state animation areas for multiple window widgets. Coordinates needed to be translated relative to the window position in within the widget.
2010-12-12 23:27:24 +00:00
gboolean _gtk_widget_get_translation_to_window (GtkWidget *widget,
Port gtk_draw_insertion_cursor to GtkStyleContext
2011-01-24 05:24:12 +00:00
GdkWindow *window,
int *x,
int *y);
gtkwidget: Move private functions to private header https://bugzilla.gnome.org/show_bug.cgi?id=651707
2011-06-02 13:25:12 +00:00
const gchar* _gtk_widget_get_accel_path (GtkWidget *widget,
gboolean *locked);
widget: Add _gtk_widget_peek_accessible() This function returns the accessible if it already exists. This way we can call functions on the accessible from the widget itself instead of having to rely on signals.
2011-11-12 02:38:40 +00:00
AtkObject * _gtk_widget_peek_accessible (GtkWidget *widget);
Only handle exposes on native window, propagate to children via draw() We now consider non-native windows non-opaque, which means any invalid area in a subwindow will also be invalid all the way up to the nearest native windows. We take advantage of this by ignoring all expose events on non-native windows (which typically means just the toplevel) and instead propagating down the draw() calls to children directly via gtk_container_propagate_draw. This is nice as it means we always draw widgets the same way, and it will let us do some interesting ways in the future. We also clean up the GtkWidget opacity handling as we can now always rely on the draing happening via cairo. We can't really just draw by walking down the widget hierarchy, as this doesn't get the clipping right (so e.g. widgets doing cairo_paint may draw outside the expected gdkwindow subarea) nor does it let us paint window backgrounds. So, we now do multiple draws for each widget, once for each GdkWindow, although we still do it on the same base cairo_t that we get for the toplevel native window. The difference is only the clipping, the rendering order, and which other widgets we propagate into. We also collect all the windows of a widget so we can expose them inside the same opacity group if needed. NOTE: This change neuters gtk_widget_set_double_buffered for widgets without native windows. Its impossible to disable the double buffering in this model.
2013-04-17 18:55:26 +00:00
GdkWindow * _gtk_cairo_get_event_window (cairo_t *cr);
gtkwidget: Move private functions to private header https://bugzilla.gnome.org/show_bug.cgi?id=651707
2011-06-02 13:25:12 +00:00
GdkEventExpose * _gtk_cairo_get_event (cairo_t *cr);
void _gtk_widget_set_has_default (GtkWidget *widget,
gboolean has_default);
void _gtk_widget_set_has_grab (GtkWidget *widget,
gboolean has_grab);
void _gtk_widget_set_is_toplevel (GtkWidget *widget,
gboolean is_toplevel);
void _gtk_widget_grab_notify (GtkWidget *widget,
gboolean was_grabbed);
void _gtk_widget_propagate_hierarchy_changed (GtkWidget *widget,
GtkWidget *previous_toplevel);
void _gtk_widget_propagate_screen_changed (GtkWidget *widget,
GdkScreen *previous_screen);
void _gtk_widget_propagate_composited_changed (GtkWidget *widget);
void _gtk_widget_set_device_window (GtkWidget *widget,
GdkDevice *device,
GdkWindow *pointer_window);
GdkWindow * _gtk_widget_get_device_window (GtkWidget *widget,
GdkDevice *device);
GList * _gtk_widget_list_devices (GtkWidget *widget);
void _gtk_widget_synthesize_crossing (GtkWidget *from,
GtkWidget *to,
GdkDevice *device,
GdkCrossingMode mode);
gpointer _gtk_widget_peek_request_cache (GtkWidget *widget);
void _gtk_widget_buildable_finish_accelerator (GtkWidget *widget,
GtkWidget *toplevel,
gpointer user_data);
Move deprecated gtkwidget style api to gtkstyle
2011-11-02 10:45:10 +00:00
GtkStyle * _gtk_widget_get_style (GtkWidget *widget);
void _gtk_widget_set_style (GtkWidget *widget,
GtkStyle *style);
widget: Add _gtk_widget_set_css_clip() ... and use it in GtkBox and GtkGrid.
2014-05-21 21:13:52 +00:00
gboolean _gtk_widget_supports_clip (GtkWidget *widget);
widget: Make _gtk_set_simple_clip() take an optional content clip
2014-08-20 21:49:00 +00:00
void _gtk_widget_set_simple_clip (GtkWidget *widget,
GtkAllocation *content_clip);
Move deprecated gtkwidget style api to gtkstyle
2011-11-02 10:45:10 +00:00
gtk: Add a way to do event capture This patch adds a capture phase to GTK+'s event propagation model. Events are first propagated from the toplevel (or the grab widget, if a grab is in place) down to the target widget and then back up. The second phase is using the existing ::event signal, the new capture phase is using a private API instead of a public signal for now. This mechanism can be used in many places where we currently have to prevent child widgets from getting events by putting an input-only window over them. It will also be used to implement kinetic scrolling in subsequent patches. http://bugzilla.gnome.org/show_bug.cgi?id=641836 We automatically request more motion events in behalf of the original widget if it listens to motion hints. So the capturing widget doesn't need to handle such implementation details. We are not making event capture part of the public API for 3.4, which is why there is no ::captured-event signal.
2011-02-08 13:49:31 +00:00
typedef gboolean (*GtkCapturedEventHandler) (GtkWidget *widget, GdkEvent *event);
void _gtk_widget_set_captured_event_handler (GtkWidget *widget,
GtkCapturedEventHandler handler);
gboolean _gtk_widget_captured_event (GtkWidget *widget,
GdkEvent *event);
gtkwidget: Move private functions to private header https://bugzilla.gnome.org/show_bug.cgi?id=651707
2011-06-02 13:25:12 +00:00
widget: Don't cache widget paths all the time Add an internal API that allows GtkStyleContext to create a widget path for the widget and with that bypassing gtk_widget_get_path() and that function caching the path.
2012-04-07 12:15:35 +00:00
GtkWidgetPath * _gtk_widget_create_path (GtkWidget *widget);
widget: Add _gtk_widget_invalidate_style_context() This is supposed to replace gtk_widget_reset_style().
2012-03-20 14:40:53 +00:00
void _gtk_widget_invalidate_style_context (GtkWidget *widget,
GtkCssChange change);
void _gtk_widget_style_context_invalidated (GtkWidget *widget);
stylecontext: Notify widget directly of changes This way, we don't need to g_signal_connect(), which saves a bunch of memory and performance.
2012-03-18 23:25:31 +00:00
GtkWidget: Add gtk_widget_insert_action_group() This allows adding a GActionGroup with a given name at an arbitrary point in the widget tree. This patch also adds an internal _get_action_muxer() API. Calling this will create a GActionMuxer associated with the widget. The parent of the muxer will be the muxer of the widget's conceptual parent. For non-menus, that is the normal parent. For menus, it is the attach widget. In this way, we end up with a hierarchy of GActionMuxer that largely reflects the hierarchy of GtkWidget, but only in places that the action context has been requested. These muxers are the ones on which the inserted actions groups are installed. A following patch will add a user of this API.
2012-08-17 22:09:35 +00:00
void _gtk_widget_update_parent_muxer (GtkWidget *widget);
action stuff: stop abusing GLib's namespace Rename our internal GActionMuxer, GActionObserver and GActionObservable classes and interfaces to have names in our own namespace. These classes were originally intended for GIO but turned out to be too special-purpose to be useful there, so we never made them public API but have just been copying them around (without bothering to properly rename them). Now that other people will be copying them out of Gtk, it's even more important to prevent this namespace abuse from spreading further.
2013-05-09 18:15:51 +00:00
GtkActionMuxer * _gtk_widget_get_action_muxer (GtkWidget *widget);
Add private GtkWidget api for action groups Similar to the just-added action muxer api for enumerating action prefixes and for getting the action group for a prefix. https://bugzilla.gnome.org/show_bug.cgi?id=730095
2014-05-14 00:28:44 +00:00
gchar ** _gtk_widget_list_action_prefixes (GtkWidget *widget);
GActionGroup * _gtk_widget_get_action_group (GtkWidget *widget,
const gchar *prefix);
GtkWidget: Add gtk_widget_insert_action_group() This allows adding a GActionGroup with a given name at an arbitrary point in the widget tree. This patch also adds an internal _get_action_muxer() API. Calling this will create a GActionMuxer associated with the widget. The parent of the muxer will be the muxer of the widget's conceptual parent. For non-menus, that is the normal parent. For menus, it is the attach widget. In this way, we end up with a hierarchy of GActionMuxer that largely reflects the hierarchy of GtkWidget, but only in places that the action context has been requested. These muxers are the ones on which the inserted actions groups are installed. A following patch will add a user of this API.
2012-08-17 22:09:35 +00:00
gesture: Simplify gesture/widget interaction public API The propagation phase property/methods in GtkEventController are gone, This is now set directly on the GtkWidget add/remove controller API, which has been made private. The only public bit now are the new functions gtk_gesture_attach() and gtk_gesture_detach() that will use the private API underneath. All callers have been updated.
2014-05-06 13:50:01 +00:00
void _gtk_widget_add_controller (GtkWidget *widget,
gesture: Replace gtk_gesture_attach/detach with event controller API Event controllers now auto-attach, and the GtkCapturePhase only determines when are events dispatched, but all controllers are managed by the widget wrt grabs. All callers have been updated.
2014-05-26 12:02:30 +00:00
GtkEventController *controller);
gesture: Simplify gesture/widget interaction public API The propagation phase property/methods in GtkEventController are gone, This is now set directly on the GtkWidget add/remove controller API, which has been made private. The only public bit now are the new functions gtk_gesture_attach() and gtk_gesture_detach() that will use the private API underneath. All callers have been updated.
2014-05-06 13:50:01 +00:00
void _gtk_widget_remove_controller (GtkWidget *widget,
GtkEventController *controller);
Add back a private api to list controllers This will let us show them in the inspector.
2014-05-16 17:14:13 +00:00
GList * _gtk_widget_list_controllers (GtkWidget *widget,
GtkPropagationPhase phase);
gesture: Simplify gesture/widget interaction public API The propagation phase property/methods in GtkEventController are gone, This is now set directly on the GtkWidget add/remove controller API, which has been made private. The only public bit now are the new functions gtk_gesture_attach() and gtk_gesture_detach() that will use the private API underneath. All callers have been updated.
2014-05-06 13:50:01 +00:00
Split off gtkprivate.h The gtkprivate.h header contains GtkWidget-specific private symbols that are not useful except in a handful of cases. Basically everything includes gtkprivate.h for the GTK_PARAM_* macros. https://bugzilla.gnome.org/show_bug.cgi?id=632539
2010-10-19 17:14:46 +00:00
G_END_DECLS
#endif /* __GTK_WIDGET_PRIVATE_H__ */
Reference in New Issue Copy Permalink