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

179 lines
7.3 KiB
C
Raw Normal View History

Re-add copyright notice https://bugzilla.gnome.org/show_bug.cgi?id=632677
2010-10-20 11:04:53 +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
Move docs for gtkmain inline At the same time, introduce a gtkmainprivate.h header and various other cleanups. Based on a patch by Tadej Borovšak. https://bugzilla.gnome.org/show_bug.cgi?id=617471
2011-01-04 22:32:12 +00:00
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Re-add copyright notice https://bugzilla.gnome.org/show_bug.cgi?id=632677
2010-10-20 11:04:53 +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/>.
Re-add copyright notice https://bugzilla.gnome.org/show_bug.cgi?id=632677
2010-10-20 11:04:53 +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/.
*/
forgot gtkprivate.h as well -timj
1998-02-02 04:56:42 +00:00
#ifndef __GTK_PRIVATE_H__
#define __GTK_PRIVATE_H__
Move gtkstyle and gtkrc to deprecated/ This required a somewhat more substantial include reshuffling. Some typedefs have been moved to gtkiconfactory.h and to gtksettings.h.
2011-11-02 05:15:21 +00:00
#include <glib-object.h>
#include <gdk/gdk.h>
Rename gdk-private.h to gdkprivate.h The extra - does not add any value.
2022-09-24 03:23:27 +00:00
#include <gdk/gdkprivate.h>
Rename gdkdebug.h to gdkdebugprivate.h This is the naming convention for private headers.
2022-09-24 03:11:41 +00:00
#include <gdk/gdkdebugprivate.h>
Move docs for gtkmain inline At the same time, introduce a gtkmainprivate.h header and various other cleanups. Based on a patch by Tadej Borovšak. https://bugzilla.gnome.org/show_bug.cgi?id=617471
2011-01-04 22:32:12 +00:00
Add generation of private g-types for private headers This starts with just the gtkcsstypesprivate.h header
2011-11-25 12:07:43 +00:00
#include "gtkcsstypesprivate.h"
Add GtkTextHandle This is a helper object to allow text widgets to implement text selection on touch devices. It allows for both cursor placement and text selection, displaying draggable handles on/around the cursor and selection bound positions. Currently, this is private to GTK+, and only available to GtkEntry and GtkTextView.
2012-07-11 13:51:43 +00:00
#include "gtktexthandleprivate.h"
Remove GtkPlacesOpenFlags from public headers The GtkPlacesOpenFlags enum is only used in private API, so move it to private headers. Since we still need a GType for it, add gtkplacessidebarprivate.h to the headers we use for generating private enum types. In turn, this registers the other private enums in that header, so take the opportunity to fix their naming, and use the generated types for the corresponding sidebarrow properties. Fixes: #3337
2020-11-08 15:40:20 +00:00
#include "gtkplacessidebarprivate.h"
motion controller: Match focus event propagation Make the crossing event generation for pointer events match what we do for focus now.
2020-02-21 04:20:58 +00:00
#include "gtkeventcontrollerprivate.h"
Drop gtk_grab_add/remove from public api The only form in which we still allow grabs to take place is with modal toplevels.
2020-02-28 21:36:17 +00:00
#include "gtkwindowgroup.h"
Add generation of private g-types for private headers This starts with just the gtkcsstypesprivate.h header
2011-11-25 12:07:43 +00:00
Define macros GTK_PARAM_READABLE, GTK_PARAM_WRITABLE, GTK_PARAM_READWRITE 2005-03-21 Matthias Clasen <mclasen@redhat.com> * gtk/gtkprivate.h: Define macros GTK_PARAM_READABLE, GTK_PARAM_WRITABLE, GTK_PARAM_READWRITE which are like their G_ counterparts, but also mark the name, nick and blurb as static. * gtk/*.c: Mark param spec strings as static, using the new macros.
2005-03-22 02:14:55 +00:00
G_BEGIN_DECLS
forgot gtkprivate.h as well -timj
1998-02-02 04:56:42 +00:00
Define macros GTK_PARAM_READABLE, GTK_PARAM_WRITABLE, GTK_PARAM_READWRITE 2005-03-21 Matthias Clasen <mclasen@redhat.com> * gtk/gtkprivate.h: Define macros GTK_PARAM_READABLE, GTK_PARAM_WRITABLE, GTK_PARAM_READWRITE which are like their G_ counterparts, but also mark the name, nick and blurb as static. * gtk/*.c: Mark param spec strings as static, using the new macros.
2005-03-22 02:14:55 +00:00
#define GTK_PARAM_READABLE G_PARAM_READABLE|G_PARAM_STATIC_NAME|G_PARAM_STATIC_NICK|G_PARAM_STATIC_BLURB
#define GTK_PARAM_WRITABLE G_PARAM_WRITABLE|G_PARAM_STATIC_NAME|G_PARAM_STATIC_NICK|G_PARAM_STATIC_BLURB
#define GTK_PARAM_READWRITE G_PARAM_READWRITE|G_PARAM_STATIC_NAME|G_PARAM_STATIC_NICK|G_PARAM_STATIC_BLURB
gtkprivate: #define OPPOSITE_ORIENTATION and use it
2013-04-29 23:15:01 +00:00
#define OPPOSITE_ORIENTATION(_orientation) (1 - (_orientation))
gtkprivate: Only define gtk_internal_return_if* for consistency checks The wanted behavior here is that these are only defined if the buildtype is debug, i.e. full debugging.
2019-08-19 08:54:09 +00:00
#ifndef G_ENABLE_CONSISTENCY_CHECKS
/* This is true for buildtypes release and debugoptimized */
Add internal versions of g_return_[val_]_if_fail These are only enabled on debug=yes, so not by default in released tarballs.
2012-12-03 12:25:14 +00:00
#define gtk_internal_return_if_fail(__expr) G_STMT_START{ (void)0; }G_STMT_END
#define gtk_internal_return_val_if_fail(__expr, __val) G_STMT_START{ (void)0; }G_STMT_END
#else
gtkprivate: Only define gtk_internal_return_if* for consistency checks The wanted behavior here is that these are only defined if the buildtype is debug, i.e. full debugging.
2019-08-19 08:54:09 +00:00
/* This is true for debug builds */
Add internal versions of g_return_[val_]_if_fail These are only enabled on debug=yes, so not by default in released tarballs.
2012-12-03 12:25:14 +00:00
#define gtk_internal_return_if_fail(__expr) g_return_if_fail(__expr)
#define gtk_internal_return_val_if_fail(__expr, __val) g_return_val_if_fail(__expr, __val)
#endif
Replace "gchar" with "char"
2020-07-24 18:40:36 +00:00
const char * _gtk_get_datadir (void);
const char * _gtk_get_libdir (void);
const char * _gtk_get_sysconfdir (void);
const char * _gtk_get_localedir (void);
const char * _gtk_get_data_prefix (void);
gtk: clean up the private horror - add gtkmodulesprivate.h and move stuff there from gtkprivate.h - add gtkprivate.c and move stuff there from gtkmain.c - add gtkwin32.c and move stuff there from gtkmain.c - don't redefine GTK_DATADIR and friends in gtkprivate.h - have _gtk_get_datadir() and friends on all platforms - remove the horrid hacks where gtkprivate.h can't be included, or must be included later due to redefinition of the compile-time directories
2011-10-22 06:48:13 +00:00
gboolean _gtk_fnmatch (const char *pattern,
const char *string,
fnmatch: Support case-folding This will be used in GtkFileFilter in the future. Update all callers.
2021-06-04 03:55:30 +00:00
gboolean no_leading_period,
gboolean casefold);
Move docs for gtkmain inline At the same time, introduce a gtkmainprivate.h header and various other cleanups. Based on a patch by Tadej Borovšak. https://bugzilla.gnome.org/show_bug.cgi?id=617471
2011-01-04 22:32:12 +00:00
Add a helper to make case-insensitive globs This will be used in GtkFileFilter in the future. Tests included.
2021-06-04 03:50:09 +00:00
char * _gtk_make_ci_glob_pattern (const char *pattern);
Replace "gchar" with "char"
2020-07-24 18:40:36 +00:00
char * _gtk_get_lc_ctype (void);
Move docs for gtkmain inline At the same time, introduce a gtkmainprivate.h header and various other cleanups. Based on a patch by Tadej Borovšak. https://bugzilla.gnome.org/show_bug.cgi?id=617471
2011-01-04 22:32:12 +00:00
Work around access to global resources without calling gtk_init() Some utilities such as GIR and gtk-doc, initialize class vtables without initializing GTK+, with composite templates accessing resources this causes a hand full of unneeded warnings. The workaround for now is the use a private function _gtk_ensure_resources() which is both called while initializing GTK+, and at the beginning of gtk_widget_class_set_template_from_resource() (the private function ensures that the resource will only ever be registered GOnce).
2013-03-24 08:16:20 +00:00
void _gtk_ensure_resources (void);
application: Put shared code into a common function
2017-11-29 23:09:37 +00:00
void gtk_main_sync (void);
Drop gtk_grab_add/remove from public api The only form in which we still allow grabs to take place is with modal toplevels.
2020-02-28 21:36:17 +00:00
GtkWidget * gtk_window_group_get_current_grab (GtkWindowGroup *window_group);
void gtk_grab_add (GtkWidget *widget);
void gtk_grab_remove (GtkWidget *widget);
gtk: clean up the private horror - add gtkmodulesprivate.h and move stuff there from gtkprivate.h - add gtkprivate.c and move stuff there from gtkmain.c - add gtkwin32.c and move stuff there from gtkmain.c - don't redefine GTK_DATADIR and friends in gtkprivate.h - have _gtk_get_datadir() and friends on all platforms - remove the horrid hacks where gtkprivate.h can't be included, or must be included later due to redefinition of the compile-time directories
2011-10-22 06:48:13 +00:00
gboolean _gtk_boolean_handled_accumulator (GSignalInvocationHint *ihint,
GValue *return_accu,
const GValue *handler_return,
gpointer dummy);
Move docs for gtkmain inline At the same time, introduce a gtkmainprivate.h header and various other cleanups. Based on a patch by Tadej Borovšak. https://bugzilla.gnome.org/show_bug.cgi?id=617471
2011-01-04 22:32:12 +00:00
gtk: clean up the private horror - add gtkmodulesprivate.h and move stuff there from gtkprivate.h - add gtkprivate.c and move stuff there from gtkmain.c - add gtkwin32.c and move stuff there from gtkmain.c - don't redefine GTK_DATADIR and friends in gtkprivate.h - have _gtk_get_datadir() and friends on all platforms - remove the horrid hacks where gtkprivate.h can't be included, or must be included later due to redefinition of the compile-time directories
2011-10-22 06:48:13 +00:00
gboolean _gtk_single_string_accumulator (GSignalInvocationHint *ihint,
GValue *return_accu,
const GValue *handler_return,
gpointer dummy);
Moved GtkSizeRequest cache to GtkWidget->priv Now that we have a private data installed directly on the GtkWidget instance it makes no sense to cache the size requests on widget qdata. This change will generally make GTK+ memory less fragmented as well as significantly speed up the size request process.
2010-09-09 06:02:56 +00:00
Use normal event propagation for DND events This works just fine, now that drop targets are event controllers. There is only a very vestigial gtk_drag_dest_handle_event() left that deals with corner cases.
2020-01-06 04:49:22 +00:00
gboolean gtk_propagate_event_internal (GtkWidget *widget,
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
GdkEvent *event,
GtkWidget *topmost);
Remove gtk_propagate_event from public API This is not a function that can be safely called outside of GTK.
2020-02-09 16:00:53 +00:00
gboolean gtk_propagate_event (GtkWidget *widget,
GdkEvent *event);
Remove gtk_main_do_event from public API
2020-02-09 15:55:56 +00:00
void gtk_main_do_event (GdkEvent *event);
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
motion controller: Match focus event propagation Make the crossing event generation for pointer events match what we do for focus now.
2020-02-21 04:20:58 +00:00
GtkWidget *gtk_get_event_widget (GdkEvent *event);
Drop gtk_get_current_ apis We have event controller apis to replace these. There is one remaining use of gtk_get_current_event_time in gtkwindow.c, so we can't drop the implementation yet. Add a section in the migration guide for this.
2020-04-11 19:04:52 +00:00
guint32 gtk_get_current_event_time (void);
motion controller: Match focus event propagation Make the crossing event generation for pointer events match what we do for focus now.
2020-02-21 04:20:58 +00:00
void check_crossing_invariants (GtkWidget *widget,
GtkCrossingData *crossing);
Replace "gdouble" with "double"
2020-07-24 20:32:16 +00:00
double _gtk_get_slowdown (void);
void _gtk_set_slowdown (double slowdown_factor);
progresstracker: add GTK_SLOWDOWN environment variable As we consolidate widgets to use progress tracker, this will allow us to control the speed of all animations in a centralized place
2016-03-14 10:38:23 +00:00
Add utility functions for portal paths The paths that we create for requests and sessions need some icky code to create. Keep it in one place.
2018-08-30 17:05:55 +00:00
char *gtk_get_portal_request_path (GDBusConnection *connection,
char **token);
char *gtk_get_portal_session_path (GDBusConnection *connection,
char **token);
Add portal version checking helper Add gtk_get_portal_interface_version() to check the version of a portal.
2020-03-23 13:56:43 +00:00
guint gtk_get_portal_interface_version (GDBusConnection *connection,
const char *interface_name);
Add a portal helper Instead of open-coding checks for sandboxing in multiple places, add a helper function that caches the information. https://bugzilla.gnome.org/show_bug.cgi?id=768499
2016-07-05 00:29:59 +00:00
Use defines for bus names This helps eradicate typos (we had some here). Closes https://gitlab.gnome.org/GNOME/gtk/issues/1267
2018-08-15 22:53:05 +00:00
#define PORTAL_BUS_NAME "org.freedesktop.portal.Desktop"
#define PORTAL_OBJECT_PATH "/org/freedesktop/portal/desktop"
#define PORTAL_REQUEST_INTERFACE "org.freedesktop.portal.Request"
GtkApplication: track screensaver state A number of applications want to track the state of the screensaver. Make this information available as a boolean property. We only listen for state changes when ::register-session is set to TRUE. This is implemented for unsandboxed D-Bus access by talking directly to org.gnome.ScreenSaver or org.freedesktop.ScreenSaver, and for sandboxed D-Bus by using a (new) portal API. A Quartz implementation is missing.
2018-08-30 05:06:51 +00:00
#define PORTAL_SESSION_INTERFACE "org.freedesktop.portal.Session"
Use defines for bus names This helps eradicate typos (we had some here). Closes https://gitlab.gnome.org/GNOME/gtk/issues/1267
2018-08-15 22:53:05 +00:00
#define PORTAL_FILECHOOSER_INTERFACE "org.freedesktop.portal.FileChooser"
#define PORTAL_PRINT_INTERFACE "org.freedesktop.portal.Print"
#define PORTAL_SCREENSHOT_INTERFACE "org.freedesktop.portal.Screenshot"
#define PORTAL_INHIBIT_INTERFACE "org.freedesktop.portal.Inhibit"
Make sure native W32 print dialog uses visual styles For that to happen the libgtk3 is embedded with a manifest that requests common controls library 6.x, and GTK lazily calls InitCommonControlsEx() to initialize those. Then this manifest is used to temporarily override the process activation contest when loading comdlg32 (which contains the code for the print dialog), ensuring that it too depends on common controls 6.x, even if the application that uses GTK does not. https://bugzilla.gnome.org/show_bug.cgi?id=733773
2014-07-29 08:18:32 +00:00
#ifdef G_OS_WIN32
void _gtk_load_dll_with_libgtk3_manifest (const char *dllname);
#endif
Add a private function to determine if we simulate These same two or three tests are currently duplicated in several places, with separate static variables. Lets do this in one place.
2015-07-31 17:30:05 +00:00
gboolean gtk_simulate_touchscreen (void);
gtk: Add missing function declarations
2016-10-15 20:34:52 +00:00
void gtk_set_display_debug_flags (GdkDisplay *display,
guint flags);
Make debug flags per-display Tihs lets us toggle debug flags in the inspector without affecting the inspector itself.
2016-03-11 05:16:35 +00:00
guint gtk_get_display_debug_flags (GdkDisplay *display);
main: Don't look at first GTK_DISPLAY_DEBUG_CHECK parameter... ... if none of the debug displays have any debug flags set. This way, we can ignore the first parameter to e.g. GTK_DISPLAY_NOTE, which is usually a call to gtk_widget_get_display. Before this patch, gtk_widget_get_display was the slowest part of gtk_widget_query_size_for_orientation.
2018-07-07 09:37:24 +00:00
gboolean gtk_get_any_display_debug_flag_set (void);
Make debug flags per-display Tihs lets us toggle debug flags in the inspector without affecting the inspector itself.
2016-03-11 05:16:35 +00:00
Redo the handling of Emoji data Use the data files from https://github.com/milesj/emojibase.git as source for our Emoji data. Slightly change our data format by adding a group to each item, in both the Emoji data and in the setting for recent-emoji. Install translated versions of the data as separate resource bundles in $prefix/gtk-4.0/emoji, and load them when appropriate. Currently, we have data for de, en, es, fr, zh, with data taken from Unicode 13 and CLDR 13. Fixes: #950 #1511
2020-10-04 02:26:56 +00:00
GBytes *get_emoji_data (void);
Make debug flags per-display Tihs lets us toggle debug flags in the inspector without affecting the inspector itself.
2016-03-11 05:16:35 +00:00
#ifdef G_ENABLE_DEBUG
gtk: Introduce new debug macros Introduce GTK_DISPLAY_DEBUG() and GTK_DEBUG(), which mirror the new macros in gdk. They use the same helper function gdk_debug_message().
2022-09-23 14:10:51 +00:00
#define GTK_DISPLAY_DEBUG_CHECK(display,type) \
(gtk_get_any_display_debug_flag_set () && \
G_UNLIKELY (gtk_get_display_debug_flags (display) & GTK_DEBUG_##type))
#define GTK_DEBUG(type,...) \
G_STMT_START { \
if (GTK_DEBUG_CHECK (type)) \
gdk_debug_message (__VA_ARGS__); \
} G_STMT_END
#define GTK_DISPLAY_DEBUG(display,type,...) \
G_STMT_START { \
if (GTK_DISPLAY_DEBUG_CHECK (display,type)) \
gdk_debug_message (__VA_ARGS__); \
gtk: add a per-display log macro This makes the conversion easier.
2018-01-14 14:54:45 +00:00
} G_STMT_END
Make debug flags per-display Tihs lets us toggle debug flags in the inspector without affecting the inspector itself.
2016-03-11 05:16:35 +00:00
#else
#define GTK_DISPLAY_DEBUG_CHECK(display,type) 0
gtk: Introduce new debug macros Introduce GTK_DISPLAY_DEBUG() and GTK_DEBUG(), which mirror the new macros in gdk. They use the same helper function gdk_debug_message().
2022-09-23 14:10:51 +00:00
#define GTK_DISPLAY_DEBUG(display,type,...)
#define GTK_DEBUG(type,...)
Make debug flags per-display Tihs lets us toggle debug flags in the inspector without affecting the inspector itself.
2016-03-11 05:16:35 +00:00
#endif /* G_ENABLE_DEBUG */
Bring back elide_underscores This used to live in gtktoolbar.c, which is gone. We still need it, so put it in gtkprivate.c.
2021-05-24 21:37:05 +00:00
char * _gtk_elide_underscores (const char *original);
GtkApplication: Call setlocale early If we don't call setlocale early enough, --help output may come out misformatted. Fixes: #4234
2021-09-06 05:37:51 +00:00
void setlocale_initialization (void);
gtkwindow: Use pointer-oriented function to deal with crossing events Commit adba0b97 fixed missed pointer crossings by using a helper function that was already present and looked like did everything that was needed. However this function was oriented to keyboard focus and it also did update the related widget state. Doing these changes on pointer-based crossing was misuse, and could cause weird interactions with keyboard focus management. Fix this by using gtkmain.c gtk_synthesize_crossing_event() that is in fact oriented to pointers. Fixes: adba0b97 (gtkwindow: Synthesize pointer crossing events on state changes) Closes: https://gitlab.gnome.org/GNOME/gtk/-/issues/5094
2022-08-09 16:49:35 +00:00
void gtk_synthesize_crossing_events (GtkRoot *toplevel,
GtkCrossingType crossing_type,
GtkWidget *old_target,
GtkWidget *new_target,
double surface_x,
double surface_y,
GdkCrossingMode mode,
GdkDrop *drop);
Define macros GTK_PARAM_READABLE, GTK_PARAM_WRITABLE, GTK_PARAM_READWRITE 2005-03-21 Matthias Clasen <mclasen@redhat.com> * gtk/gtkprivate.h: Define macros GTK_PARAM_READABLE, GTK_PARAM_WRITABLE, GTK_PARAM_READWRITE which are like their G_ counterparts, but also mark the name, nick and blurb as static. * gtk/*.c: Mark param spec strings as static, using the new macros.
2005-03-22 02:14:55 +00:00
G_END_DECLS
forgot gtkprivate.h as well -timj
1998-02-02 04:56:42 +00:00
#endif /* __GTK_PRIVATE_H__ */
Reference in New Issue Copy Permalink