AuroraMiddleware/gtk2
1
0
Fork 0
forked from AuroraMiddleware/gtk
Code Issues Pull Requests Projects Releases Wiki Activity
64,921 Commits 969 Branches 749 Tags 504 MiB
dc1c1e8af9
Commit Graph

5269 Commits

Author SHA1 Message Date
Matthias Clasen
48f8affb2c gdk: Make event-related apis private 
Without a way to create events, there is no point
in allowing gdk_display_put_event to be used from
the outside. And little good can come out of using
the other apis, so just make them all private.
 2020-05-28 14:53:08 -04:00
Yuri Chornoivan
01bd4cc4e1 Fix minor typos 2020-05-28 11:00:03 +03:00
Matthias Clasen
c42219cd5b Add to the docs README 
Mention markdown syntax and gtk-doc additions.
 2020-05-27 11:11:30 -04:00
Emmanuele Bassi
347cb94c43 docs: Link the documentation guidelines 
From the coding style.
 2020-05-27 13:44:50 +01:00
Emmanuele Bassi
c5485cd6b1 Add the beginnings of a docs contribution guide 
We have one for the whole project, but the documentation should have a
proper introduction and a proper style guide.
 2020-05-27 13:44:50 +01:00
Emmanuele Bassi
e30c974646 Add myself to more sections 2020-05-27 13:44:50 +01:00
Emmanuele Bassi
6b6c76e3a2 docs: Remove last two steps from the release howto 
Drop the GTK list announcements, as we don't have lists any more.

The GTK website updates itself automatically, these days.
 2020-05-27 13:44:50 +01:00
Emmanuele Bassi
25a8fa73f8 docs: Turn coding style into a markdown document 
It was mostly one already, just needed some minor fixes.
 2020-05-27 13:44:50 +01:00
Matthias Clasen
f27d855c68 gdk: Drop the GdkEventMask enum 
This is not used in public api anymore.
Some of the backends still use it internally,
so keep it in gdkinternals.h for now.
 2020-05-26 19:39:31 -04:00
Matthias Clasen
0553b10214 gdk: Drop the GdkSurfaceTypeHint enum 
This is not used in public api anymore.
Some of the backends still use it internally,
so keep it in gdkinternals.h for now.
 2020-05-26 19:34:59 -04:00
Matthias Clasen
8c6bbcdc2e docs: Mention shortcuts in the migration guide 
Add a few paragraphs about GtkAccelGroup, GtkBindingSet
and GtkAccelMap to the migration guide.

Fixes: #2778
 2020-05-25 21:27:58 -04:00
Matthias Clasen
17b5cfc924 docs: Mention pandoc as build dependency 2020-05-25 20:56:09 -04:00
Matthias Clasen
5590e2f6f2 Merge branch 'doc-chapters-markdown' into 'master' 
Include markdown content, via pandoc

See merge request GNOME/gtk!1961
 2020-05-26 00:55:10 +00:00
Matthias Clasen
ae2e548b4b docs: Use the right python 2020-05-25 18:40:09 -04:00
Matthias Clasen
aca8090a09 docs: Convert question index to markdown 
With this, the expand_content_files list has been
completely converted to markdown files. Whats left
in content_files is man pages, and a few special
cases.
 2020-05-25 16:11:18 -04:00
Matthias Clasen
84437ee0e0 docs: Allow interrupted lists 
We use such an interrupted, numbered list in the
q&a section, so tell pandoc to pay attention to
start numbers.
 2020-05-25 16:11:18 -04:00
Matthias Clasen
dc858c9686 docs: Convert treeview and textview overview to markdown 2020-05-25 16:11:18 -04:00
Matthias Clasen
581b39a38d docs: Allow influencing pandoc divisons 
Arrange for files named section-foo.md to be turned
into docbook sections, while others get turned into
chapters. This is necessary to allow including such
content in chapters, since chapters in docbook don't
nest.
 2020-05-25 16:11:18 -04:00
Matthias Clasen
a37b9d7578 docs: Drop the glossary 
It is very incomplete, somewhat outdated, and
we lack the resources to maintain it properly.
 2020-05-25 16:11:18 -04:00
Matthias Clasen
5a3fe9e5f5 docs: Convert resources section to markdown 2020-05-25 16:11:18 -04:00
Matthias Clasen
f44d611f77 docs: Drop a long-stale file 
The other_software.xml section has not been included in
the docs since 2.x, as far as I can tell. It was clearly
written before GIO existed.
 2020-05-25 16:11:18 -04:00
Matthias Clasen
29fb9ae2d6 docs: Convert platform sections to markdown 2020-05-25 16:11:18 -04:00
Matthias Clasen
2595cd5a93 docs: Convert getting_started to markdown 
As part of the conversion, give up on including
sources files from the examples directory, and
instead include the content directly. All include
mechanisms add complications. They were already
complicated with xml, and markdown is not making
things easier.

We already did that for fragments, and if you
make changes to these example sources, you
probably need to revise the surrounding text
anyway.
 2020-05-25 16:11:18 -04:00
Matthias Clasen
bf14d75cad docs: Refresh the inspector screenshot 2020-05-25 16:11:18 -04:00
Matthias Clasen
b99511ee55 docs: Convert building, compiling, running to markdown 2020-05-25 16:11:18 -04:00
Matthias Clasen
3bf90b4218 doc: Check for pandoc 
Add an explicit check for pandoc, so we get a clear
error message if it is missing.
 2020-05-25 16:11:18 -04:00
Matthias Clasen
9873d983ed docs: Convert css overview to markdown 2020-05-25 16:11:18 -04:00
Matthias Clasen
3338d24da4 docs: Be more careful when expanding abbreviations 
We must not expand #symbol in the middle of a url,
where it is probably a fragment identifier. Restrict
problem.
 2020-05-25 16:11:18 -04:00
Matthias Clasen
10cd539104 wip: Include markdown content, via pandoc 
Use pandoc to convert freestanding markdown files to docbook for
inclusion in the generated docs, and use bits and pieces of
gtk-doc code to continue expanding typical gtk-doc abbreviations.
The new tool for markdown -> docbook is a python script called
gtk-markdown-to-docbook.

The markdown dialect is specified via a list of pandoc extension
in gtk-markdown-to-docbook. It includes header annocations,
definition lists and tables, among other things.

This commit converts the 3 overview chapters (drawing, input
handling and actions) and the migration guide to markdown
syntax. Other files that are still listed in content_files
can be converted later.

This commit adds a pandoc dependency.
 2020-05-25 16:11:18 -04:00
Matthias Clasen
e4623fd0c4 Add GtkOverlayLayout to the docs 2020-05-25 15:18:14 -04:00
Matthias Clasen
5e25ba6c5a Merge branch 'no-app-menu' into 'master' 
Drop the app menu

Closes #2731

See merge request GNOME/gtk!1951
 2020-05-22 23:46:56 +00:00
Matthias Clasen
1038b9b8a1 docs: Mention app menus in the migration guide 2020-05-22 18:46:51 -04:00
Matthias Clasen
79d6a77d58 gtkapplication: Drop app menu support 
Drop apis and code related to appmenus from
both GtkApplication and GtkApplicationWindow.

We still keep the menubar support, since it
is needed for system integration on OS X.

Fixes: #2731
 2020-05-22 17:31:05 -04:00
Matthias Clasen
33b836af7f fixed: Change coordinate apis to doubles 
We are using floating point for coordinates
everywhere now, so be consistent here.

This commit also changes the implementation of
gtk_fixed_get_child_position to work with
non-translation child transforms.
 2020-05-22 17:26:08 -04:00
Matthias Clasen
edf85cb1b3 docs: Refresh the build and backend sections 
Remove some outdated information from the sections
about building and about particular backends.
 2020-05-19 15:19:53 -04:00
Matthias Clasen
287c40276a gdk: Drop gdk_display_supports_shapes 
The apis to set shapes on surfaces are gone,
so there is no point in providing this information
on GdkDisplay.
 2020-05-17 21:52:15 -04:00
Matthias Clasen
93d4253c93 native: Make gtk_native_get_surface_transform public 
This api is needed to translate between surface
and widget coordinates.
 2020-05-17 16:01:08 -04:00
Matthias Clasen
c0faf0c6b6 Merge branch 'toplevel-move-resize' into 'master' 
Toplevel move resize

See merge request GNOME/gtk!1923
 2020-05-17 19:15:46 +00:00
Matthias Clasen
b63690aa6b docs: Mention begin_resize_drag in the migration guide 2020-05-17 14:38:10 -04:00
Benjamin Otte
b353221185 Merge branch 'wip/otte/monitors' into 'master' 
various GDK cleanups

See merge request GNOME/gtk!1920
 2020-05-17 16:57:52 +00:00
Matthias Clasen
eb6edac4bd gdk: Drop gdk_surface_begin_move/resize_drag 
These have been replaced by GdkToplevel api.
 2020-05-17 12:49:29 -04:00
Matthias Clasen
309a7aa253 gdk: Add gdk_toplevel_begin_move/resize 
For now, these are wrappers around the surface apis,
but they are going to replace them, since this operation
is only available on toplevels.
 2020-05-17 12:41:16 -04:00
Benjamin Otte
363c88cef7 migration guide: Update paragraph about monitors 
Clarify the new handling of monitors via a listmodel of GdkMonitor
instead of int monitor_num.
 2020-05-17 18:05:07 +02:00
Benjamin Otte
4c7914dc49 display: Remove unneeded getters 
Applications can use the listmodel instead.
 2020-05-17 07:32:37 +02:00
Benjamin Otte
d4731a4ab4 x11: Remove gdk_x11_register_standard_event_type() 
It's not used anymore since GdkX11Display::xevent exists.
 2020-05-17 01:02:17 +02:00
Benjamin Otte
0c6266fd1a surface: Remove gdk_surface_is_viewable() 
It returns the same value as gdk_surface_get_mapped(), so use that
instead.
 2020-05-17 00:41:44 +02:00
Alexander Mikhaylenko
9f761feb93 docs: Mention GtkHeaderBar title and subtitle changes in migration guide 2020-05-14 19:51:19 +05:00
Benjamin Otte
dd7d76f389 gdk: Add gdk_display_get_monitors() 
Returns a GListModel of GDK_TYPE_MONITOR.

This will replace the current andling of monitors in GdkDisplay.
 2020-05-13 07:00:35 +02:00
Matthias Clasen
450879b1da Merge branch 'matthiasc/for-master' into 'master' 
Documentation work

See merge request GNOME/gtk!1880
 2020-05-12 14:52:01 +00:00
Emmanuele Bassi
e8c4b8338f docs: Mention blocking functions in the migration guide 
Link to how to make a dialog modal, and to the response signal.
 2020-05-12 13:45:15 +01:00
Emmanuele Bassi
d54b7dec94 Remove gtk_dialog_run() 
Nested main loops are bad, as they introduce layers of complexity caused
by the potential re-entrancy in the case of multiple event sources, like
IPC, threads, etc. Additionally, the programming model they provide—stop
the world while spinning a new loop—does not conform to the event-driven
model employed by GTK.
 2020-05-12 13:45:15 +01:00
Emmanuele Bassi
5d272a12cb Remove gtk_native_dialog_run() 
Nested main loops are bad, as they introduce layers of complexity caused
by the potential re-entrancy in the case of multiple event sources, like
IPC, threads, etc. Additionally, the programming model they provide—stop
the world while spinning a new loop—does not conform to the event-driven
model employed by GTK.
 2020-05-12 13:15:19 +01:00
Matthias Clasen
6df8bf7dde docs: Updates to the migration guide 
Remove some duplicated content, reorder things
to make more sense, and tweak the wording.
 2020-05-12 07:50:17 -04:00
Matthias Clasen
072adbf079 docs: Updates to the common questions 
Refresh the answers to some common questions.
 2020-05-12 01:03:34 -04:00
Matthias Clasen
1ef6a35f3e docs: Don't point at mailing lists 
Replace references to the mailing lists by
discourse + irc.
 2020-05-12 01:02:49 -04:00
Matthias Clasen
91f0fcde96 docs: Rearrange the introduction some more 
Fine-tune some wording, and move the Custom Drawing
example earlier.
 2020-05-12 01:02:07 -04:00
Matthias Clasen
848a8a792e docs: Update migration guide 
Add sections about GtkBin, GtkContainer and gtk_widget_destroy().
 2020-05-11 22:38:21 -04:00
Matthias Clasen
5ebd42d402 Drop GtkContainer and its accessible implementation 
It is no longer used.
 2020-05-11 22:38:21 -04:00
Matthias Clasen
2a24b8c653 Replace most remaining uses of container api 
These are all on GtkBox or enumerating children.
 2020-05-11 22:38:21 -04:00
Matthias Clasen
665edcba53 box: Add gtk_box_append/prepend/remove 
Add replacement api for gtk_container_add/remove.
 2020-05-11 22:38:21 -04:00
Matthias Clasen
d59d9d4bd5 headerbar: Add gtk_header_bar_remove 
This is a replacement for gtk_container_remove.
 2020-05-11 22:21:39 -04:00
Matthias Clasen
88141103cd Don't use container api on GtkListBox 2020-05-11 22:21:39 -04:00
Matthias Clasen
ff91ce9eb4 listbox: Add gtk_list_box_remove 
This is a gtk_container_remove replacement.
 2020-05-11 22:21:39 -04:00
Matthias Clasen
2f7f6e6a37 flowbox: Add gtk_flow_box_remove 
This is the replacement for gtk_container_remove.
 2020-05-11 22:21:39 -04:00
Matthias Clasen
5e0c1e6a86 stack: Add gtk_stack_remove 
This is a replacement for gtk_container_remove.
 2020-05-11 22:21:39 -04:00
Matthias Clasen
96d707444d fixed: Add gtk_fixed_remove 
This is the replacement for gtk_container_reomve.
 2020-05-11 22:21:39 -04:00
Matthias Clasen
5cda824784 grid: Add gtk_grid_remove 
This is a replacement for gtk_container_remove.
 2020-05-11 22:21:39 -04:00
Matthias Clasen
12ca08c382 infobar: Add gtk_info_bar_add/remove_child 
This is a replacement for container api that is going away.
 2020-05-11 22:21:39 -04:00
Matthias Clasen
78d20b9301 infobar: Add gtk_info_bar_remove_action_widget 
This is mainly for completeness, since gtk_container_remove
will not work for those anymore.
 2020-05-11 22:21:39 -04:00
Matthias Clasen
bc6643f3c2 paned: Redo the api 
This commit is porting GtkPaned to be derived
from GtkWidget instead of GtkContainer, while adding
start-child and end-child properties. The existing
properties are renamed to follow the start/end naming
scheme, and we add proper getters and setters.

Update all users.

See #2719
 2020-05-11 22:21:33 -04:00
Matthias Clasen
6b80d90db5 expander: Add a child property 2020-05-11 22:21:14 -04:00
Matthias Clasen
c0f090627a actionbar: Add gtk_action_bar_remove 
This is a replacement for gtk_container_remove.
 2020-05-11 20:33:23 -04:00
Matthias Clasen
aeef59fda9 textview: Derive from GtkWidget 
Drop the GtkContainer vfuncs. As a replacement for
gtk_container_remove, make gtk_text_view_remove public.
 2020-05-11 20:33:23 -04:00
Matthias Clasen
cc28a7b0ef Merge branch 'wip/tintou/doc-fixes' into 'master' 
docs: Fix several missing references in the documentation

See merge request GNOME/gtk!1874
 2020-05-11 18:40:34 +00:00
Corentin Noël
076b2f11d2 docs: Fix several missing references in the documentation 
This fixes several typos and missing references
 2020-05-11 19:26:20 +02:00
Matthias Clasen
6d969d1026 Update the docs 
Remove various references to gtk_widget_destroy in the docs.
 2020-05-11 12:20:59 -04:00
Matthias Clasen
1306727fb1 window: Remove _set_has_user_ref_count 2020-05-11 12:20:59 -04:00
Matthias Clasen
0f10b170f4 widget: Drop gtk_widget_destroy 2020-05-11 12:20:59 -04:00
Matthias Clasen
cd0081d08a Use gtk_window_destroy 
Replace calls to gtk_widget_destroy on windows
with gtk_window_destroy.
 2020-05-11 12:20:57 -04:00
Matthias Clasen
48821a64d0 window: Add gtk_window_destroy 
This is a replacement for gtk_widget_destroy for toplevels.
For now, it is just a wrapper.
 2020-05-11 12:19:39 -04:00
Matthias Clasen
573b20a8f8 Drop gtk_widget_destroyed 
Use g_object_add_weak_pointer or a weak reference instead.
 2020-05-11 12:19:39 -04:00
Matthias Clasen
9f3fb69dce Merge branch 'matthiasc/for-master' into 'master' 
Matthiasc/for master

Closes #2729 and #2730

See merge request GNOME/gtk!1870
 2020-05-11 12:51:08 +00:00
Matthias Clasen
d2430c70bd Refresh the tutorial examples 
Redo this series of examples from 2013, and adapt it to modern
way of doing things. The biggest differences are that we use
a headerbar right from the start, and don't mention the app
menu.

Fixes: #2730
 2020-05-11 08:15:56 -04:00
Matthias Clasen
0fc1a290e2 docs: Cosmetic updates to the tutorial 
Since the meson conversion, we are no longer expanding
gtk-doc references in this file, so take them out. And
touch up the wording in various places.
 2020-05-11 08:15:55 -04:00
Matthias Clasen
edc31a264c widget: Add a :focusable property 
Add back a property that determines whether an individual
widget will accept focus or not. :can-focus prevents the
focus from ever entering the entire widget hierarchy
below a widget, and :focusable just determines if grabbing
the focus to the widget itself will succeed.

See #2686
 2020-05-10 23:24:48 -04:00
Alexander Mikhaylenko
8bd44cb3eb Add GtkWindowHandle 
This will allow to move the titlebar handling logic out from GtkWindow.
 2020-05-07 23:57:58 +05:00
Matthias Clasen
8ad49b33ed gestureclick: Drop the area 
This is a rarely used api, and our general trend has been
to use widgets whenever we need an area singled out.
 2020-05-06 14:19:50 -04:00
Matthias Clasen
b96509c030 Merge branch 'wip/baedert/for-master' into 'master' 
Wip/baedert/for master

See merge request GNOME/gtk!1828
 2020-05-06 03:55:55 +00:00
Timm Bäder
14b27446a3 stylecontext: Remove _list_classes() from public API 
Applications can use gtk_widget_get_css_classes these days.
 2020-05-05 08:20:09 +02:00
Matthias Clasen
4735d38e31 docs: Fixup for an uninitialized variable 2020-05-04 22:53:08 -04:00
Matthias Clasen
3c165b3b77 Drop GtkBin 
It is no longer used anywhere.
 2020-05-04 22:53:08 -04:00
Matthias Clasen
ec394e805b Use gtk_combo_box_set_child throughout 2020-05-04 22:53:08 -04:00
Matthias Clasen
5d26af06e4 combobox: Add a child property 2020-05-04 22:53:08 -04:00
Matthias Clasen
b96d7b62d1 Add gtk_overlay_remove_overlay 
Now that GtkOverlay is not a container anymore,
gtk_container_remove can't be used for this anymore,
so add a separate api.
 2020-05-04 22:53:08 -04:00
Matthias Clasen
53f9737dcf overlay: Add a child property 2020-05-04 22:53:08 -04:00
Matthias Clasen
e2abe6dd29 searchbar: Add a child property 2020-05-04 22:53:08 -04:00
Matthias Clasen
b8d1a9eb0d flowboxchild: Derive from GtkWidget 
We want to remove GtkBin and GtkContainer as they don't
provide much useful functionality anymore.

See #2681
 2020-05-04 22:53:08 -04:00
Matthias Clasen
686be577d5 revealer: Add a child property 2020-05-04 22:53:08 -04:00
Matthias Clasen
f59f355190 Use gtk_window_set_child throughout 
Replace all uses of gtk_container_add on windows
by gtk_window_set_child.
 2020-05-04 22:53:08 -04:00
Matthias Clasen
b9b1bf85e1 window: Add a child property 2020-05-04 22:53:07 -04:00
Matthias Clasen
af6e0ee2b3 Use gtk_button_set_child throughout 
Replace all uses of gtk_container_add on buttons
by gtk_button_set_child.
 2020-05-04 22:53:07 -04:00
Matthias Clasen
04e4a02cd0 button: Add a child property 2020-05-04 22:53:07 -04:00
Matthias Clasen
67759d4c3e Use gtk_scrolled_window_set_child throughout 
Replace all uses of gtk_container_add on popovers
by gtk_scrolled_window_set_child.
 2020-05-04 22:53:07 -04:00
Matthias Clasen
54b613392b scrolledwindow: Add a child property 2020-05-04 22:53:07 -04:00
Matthias Clasen
ee284a560a popover: Add a child property 2020-05-04 17:01:18 -04:00
Matthias Clasen
937c94bab5 viewport: Add a child property 2020-05-04 17:01:18 -04:00
Matthias Clasen
e137152520 aspectframe: Add a child property 2020-05-04 17:01:18 -04:00
Matthias Clasen
1706b80815 Use gtk_frame_set_child throughout 
Replace all uses of gtk_container_add for
frames with gtk_frame_set_child.
 2020-05-04 17:01:18 -04:00
Matthias Clasen
7f975472a7 frame: Add a child property 2020-05-04 17:01:18 -04:00
Matthias Clasen
fd1fe0eed5 Merge branch 'matthiasc/for-master' into 'master' 
docs: Add more detail to the drawing overview

See merge request GNOME/gtk!1811
 2020-05-01 21:09:38 +00:00
Benjamin Otte
fa90747815 Merge branch 'wip/exalm/headerbar-title' into 'master' 
Headerbar title/subtitle cleanups

See merge request GNOME/gtk!1807
 2020-05-01 19:39:27 +00:00
Matthias Clasen
431545877e docs: Add more detail to the drawing overview 2020-05-01 14:24:21 -04:00
Alexander Mikhaylenko
739f681076 headerbar: Rename custom-title to title-widget 
Now that all the other title-related properties are gone, custom title can
have a more mundane name.
 2020-05-01 20:11:19 +05:00
Alexander Mikhaylenko
c2e4e1af73 headerbar: Remove user-settable title 
Use window title, or custom title widget if it's set. Remove 'title'
property.

Update demos and tests to set the title on the window instead of
headerbar.
 2020-05-01 19:48:05 +05:00
Alexander Mikhaylenko
35d50f88c8 headerbar: Remove subtitle 
Also remove the box containing title and subtitle, as there's only one
label now.
 2020-05-01 19:48:05 +05:00
Alexander Mikhaylenko
43a453e465 headerbar: Remove has-subtitle property 
Subtitle will go too in the next commit, but has-subtitle goes first as
it's broken right now anyway.
 2020-05-01 19:48:05 +05:00
Matthias Clasen
74dcbae1f3 docs: Some revisions of the input overview 
Remove some less than accurate details, and add
an illustration.
 2020-05-01 09:26:06 -04:00
Matthias Clasen
5f01f6f36b Drop GtkStack:homogeneous 
We have hhomogeneous and vhomogeneous properties
that can be set individually.

Fixes: #2673
 2020-04-28 20:00:12 -04:00
Matthias Clasen
7f1e82d1bc Merge branch 'wip/exalm/titlebuttons' into 'master' 
GtkWindowControls + GtkHeaderBar cleanups

See merge request GNOME/gtk!1755
 2020-04-26 13:09:35 +00:00
Alexander Mikhaylenko
b5d61eb2c8 docs: Add GtkWindowControls to docs 2020-04-26 15:13:15 +05:00
Matthias Clasen
b2deab6adf Drop gtk_widget_has_grab 
This was just a leftover in our public api.
All other grab-related apis are gone.
 2020-04-23 14:10:44 -04:00
Matthias Clasen
94906d076a Drop gtk_widget_reset_style 
There was a single call left that should not be necessary.
Also drop no longer used attached-window functionality.
 2020-04-22 19:30:48 -04:00
Matthias Clasen
723d57eeb5 widget: Add a system_setting_changed vfunc 
This gives us a hook to walk the widget tree whenever a global
setting changes and do per-widget invalidations. This will
replace gtk_style_context_reset_widgets().
 2020-04-22 19:29:15 -04:00
Matthias Clasen
2ddff872cd css: Drop the -gtk-icon-theme property 
We want to always use the current icon theme, and only
have the minimum amount of custom properties.
 2020-04-22 12:35:30 -04:00
Claudio Saavedra
e818bf8514 docs: migration guide fixes 2020-04-21 15:37:45 +03:00
Claudio Saavedra
0af16a77fc docs: fix typo 2020-04-21 14:49:13 +03:00
Matthias Clasen
b55195fa2e Move the idle sizer to GtkWindow 
This was only living in gtkcontainer.c for historic
reasons. Move it closer to where it belongs, and
rename it from 'idle' to 'layout', since it is
really about the layout phase of the frame clock,
nowadays.
 2020-04-20 16:30:45 -04:00
Matthias Clasen
b4c79bad34 Assorted documentation fixes 2020-04-20 00:38:58 -04:00
Matthias Clasen
013cc09651 widget: Remove some leftovers 
gtk_widget_can_activate_accel is gone, so remove the
vfunc and declaration.
 2020-04-19 23:44:50 -04:00
Matthias Clasen
dbf12d87a1 Add GtkShortcutLabel to the docs 2020-04-19 15:41:51 -04:00
Matthias Clasen
0b6af3bf23 Add GtkCenterLayout to the docs 2020-04-19 15:38:31 -04:00
Matthias Clasen
bc7da45902 docs: Restructure a bit 
Split the overview sections off into its own "concepts part.
 2020-04-19 13:15:05 -04:00
Matthias Clasen
3c987f073e Remove GdkGeometry from public API 
The api to configure surfaces is now GdkToplevelLayout
and GdkPopupLayout. Unfortunately, there's still quite
a bit of internal use of GdkGeometry that will take some
time to clean up, so move it go gdkinternals.h for now.
 2020-04-19 10:41:18 -04:00
Matthias Clasen
1e7c56db19 Merge branch 'focus-adjustment' into 'master' 
Drop container focus adjustments

See merge request GNOME/gtk!1716
 2020-04-18 20:59:50 +00:00
Matthias Clasen
b55b1773c0 docs: Mention focus adjustments in the migration guide 2020-04-18 14:59:52 -04:00
Matthias Clasen
1c472cca00 Drop gtk_container_set_focus_[hv]adjustment 
This functionality should be provided by scrollables, see
for example by the recently added GtkViewport:scroll-to-focus.
 2020-04-18 14:59:44 -04:00
Matthias Clasen
84fd7cf704 Shorten CSS docs 
Fold the two CSS chapters into one, make more compact
tables of selectors and properties, and stop explaining
general CSS syntax.
 2020-04-18 12:34:17 -04:00
Matthias Clasen
49f2012d24 migration docs: Updates 
Mention shadow type, relief, aspect frame.
 2020-04-17 18:46:12 -04:00
Matthias Clasen
19dbbf6fa5 aspectframe: Modernize 
Make GtkAspectFrame not derive from GtkFrame anymore,
since frames now always draw, well, a frame. Also,
add proper setters for the properties of GtkAspectFrame.

Update our sole user.

Fixes: https://gitlab.gnome.org/GNOME/gtk/-/issues/2627
 2020-04-17 17:38:52 -04:00
Matthias Clasen
909120ec78 Drop GtkReliefStyle 
We are not using this enum anymore.
 2020-04-17 10:57:36 -04:00
Matthias Clasen
12d5fdd457 menubutton: Drop relief 
We are only using this as a boolean, so change it
to a boolean property named has-frame.
 2020-04-17 10:57:36 -04:00
Matthias Clasen
df1816a29c button: Drop relief 
We are only using this as a boolean, so change it
to a boolean property named has-frame.
 2020-04-17 10:57:36 -04:00
Matthias Clasen
fdbbef863d Drop GtkShadowType 
We are not using this enum anymore.
 2020-04-17 10:57:36 -04:00
Matthias Clasen
47ac0db66c viewport: Drop shadow-type 
The viewport draws a frame at the same place as
the scrolled window, so there is really no need
to have that ability in both. Just drop the frame
from viewports.
 2020-04-17 10:57:36 -04:00
Matthias Clasen
edae2a8dc5 frame: Drop shadow-type 
Frames that don't draw frames are not very useful,
so just drop the shadow-type property.
 2020-04-17 10:57:36 -04:00
Matthias Clasen
285aa226e5 scrolledwindow: Drop shadow-type 
We were only using this as a boolean, so change it
to a boolean property named has-frame.
 2020-04-17 10:57:36 -04:00
Emmanuele Bassi
f28aa1ba02 Restructure the GdkEvent type hierarchy 
GdkEvent has been a "I-can't-believe-this-is-not-OOP" type for ages,
using a union of sub-types. This has always been problematic when it
comes to implementing accessor functions: either you get generic API
that takes a GdkEvent and uses a massive switch() to determine which
event types have the data you're looking for; or you create namespaced
accessors, but break language bindings horribly, as boxed types cannot
have derived types.

The recent conversion of GskRenderNode (which had similar issues) to
GTypeInstance, and the fact that GdkEvent is now a completely opaque
type, provide us with the chance of moving GdkEvent to GTypeInstance,
and have sub-types for GdkEvent.

The change from boxed type to GTypeInstance is pretty small, all things
considered, but ends up cascading to a larger commit, as we still have
backends and code in GTK trying to access GdkEvent structures directly.
Additionally, the naming of the public getter functions requires
renaming all the data structures to conform to the namespace/type-name
pattern.
 2020-04-16 19:54:02 +01:00
Matthias Clasen
e83d87c20a Add :focus-visible to css docs 2020-04-15 23:14:34 -04:00
Matthias Clasen
71f8649f7f docs: Small revision of input handling overview 
Remove a vestigial touch events section.
 2020-04-15 08:08:12 -04:00
Matthias Clasen
1205f74106 Always use gtk-doc as a subproject for now 
We need the support for actions syntax, among
other things.
 2020-04-13 16:40:57 -04:00
Matthias Clasen
9194b7388f Add a GtkAppChooserButton:modal property 
Nowadays, dialogs are expected to be attached, typically,
and that only happens when they are marked as modal.
 2020-04-13 00:43:19 -04:00
Matthias Clasen
800f1c03d5 Add a GtkFontButton:modal property 
Nowadays, dialogs are expected to be attached, typically,
and that only happens when they are marked as modal.
 2020-04-13 00:28:34 -04:00
Matthias Clasen
15d58a868a Add a GtkColorButton:modal property 
Nowadays, dialogs are expected to be attached, typically,
and that only happens when they are marked as modal.
 2020-04-13 00:17:00 -04:00
Matthias Clasen
2aa136a19c Add a GtkFileChooserButton:modal property 
Nowadays, dialogs are expected to be attached, typically,
and that only happens when they are marked as modal.
 2020-04-12 23:45:03 -04:00
Matthias Clasen
703f18ce66 Redo gtk_show_uri_on_window 
Make this a full async function, and add a simple wrapper.

Call gtk_show_uri_full() if you need control over the
results, and use gtk_show_uri() if you are fine with
ignoring any errors.
 2020-04-11 21:56:32 -04:00
Matthias Clasen
feee281cf8 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 17:29:27 -04:00
Matthias Clasen
bd56bc9055 Add gtk_event_controller_get_current_event[_state] 
For now these are private, to replace internal uses
of gtk_get_current_event[_state], but we may want to
make them public.
 2020-04-11 17:29:27 -04:00
Matthias Clasen
c5b4066714 gdk: Small documentation fixes 2020-04-11 10:07:31 -04:00
Matthias Clasen
a6a31827bc Remove gtk_style_context_reset_widgets 
This should never be necessary to call from the outside.
Whenever we fail to update styles properly, it is a bug.
 2020-04-10 12:45:28 -04:00
Matthias Clasen
394ea32e93 Use gtk_widget_add/remove_css_class more 
Replace most uses of gtk_style_context_add/remove_class
by the new APIs. The only remaining uses of the old API
are in save/restore situations.
 2020-04-10 12:09:57 -04:00
Matthias Clasen
f16c829190 Mention focus changes in the migration guide 2020-04-09 18:26:31 -04:00
Matthias Clasen
e7a8a4eb06 Update migration guide 
Rewrite the sections about keymaps and menus, and add
hints about modifiers.
 2020-04-06 16:32:03 -04:00
Matthias Clasen
1de7719e34 Drop gtk_accelerator_set_default_mod_mask 
Our new approach to modifiers works with a fixed set,
there is really no need to customize the modifier
masks if the backends are all supposed to deliver
the same modifiers.
 2020-04-06 16:32:03 -04:00
Matthias Clasen
3419d9c04f gtk: Drop gtk_widget_get_modifier_mask 
This is not used anymore.
 2020-04-06 16:32:03 -04:00
Matthias Clasen
89ad7893ad gdk: Make GdkKeymap a private api 
We have replacement apis in GdkDevice and GdkDisplay.
 2020-04-06 16:32:03 -04:00
Matthias Clasen
3300686bef gdk: Clean up GdkModifierType 
Remove MOD2..MOD5. Backends are expected to just set
the named modifiers.
 2020-04-06 15:13:54 -04:00
Matthias Clasen
0a96a483c6 gdk: Redo key events 
Add all of the keyboard translation results in the key event,
so we can translate the keyboard state at the time the event
is created, and avoid doing state translation at match time.

We actually need to carry two sets of translation results,
since we ignore CapsLock when matching accelerators, in
gdk_event_matches().

At the same time, drop the scancode field - it is only ever
set on win32, and is basically unused in GTK.

Update all callers.
 2020-04-06 15:13:54 -04:00
Matthias Clasen
00b25d5594 Move keymap mapping functions to GdkDisplay 
We want to stop exposing GdkKeymap, so this
functionality needs a new home.
 2020-04-06 01:40:40 -04:00
Matthias Clasen
c9aef3fc4d Add gdk_event_get_match 
This is a counterpart to gdk_event_matches() that can
be used to obtain a shortcut matching an event.
 2020-04-05 23:37:13 -04:00
Matthias Clasen
e8330c5eec Add gdk_event_matches 
Move the elaborate key event matching code from
GtkShortcutTrigger to GdkEvent, which greatly reduces
the amount of keymap api use outside of GDK.
 2020-04-05 23:37:13 -04:00
Matthias Clasen
ec854fc503 shortcuts: documentation fixes 
Update symbol lists, and add examples for parsing triggers
and actions.
 2020-04-04 12:22:43 -04:00
Matthias Clasen
5bf030413b Add new api to the docs 2020-03-30 14:12:14 -04:00
Matthias Clasen
d07e22dc03 Some documentation fixes 2020-03-25 23:14:45 -04:00
Matthias Clasen
ce22ef18f9 docs: Update the overview input chapter 
Update the wording around events to reflect current
usage, and add information about shortcuts and the
shortcut controller.
 2020-03-25 23:14:45 -04:00
Emmanuele Bassi
6e8c78714d Turn GtkShortcutAction into a GObject 
Just like we did for GtkShortcutTrigger.

This allows language bindings to properly deal with all the actions.
 2020-03-25 23:14:45 -04:00
Benjamin Otte
bb4fbe3d8f accels: Remove GtkAccelGroup 2020-03-25 23:14:44 -04:00
Benjamin Otte
4c45410d43 widget: Remove gtk_widget_add_accelerator() 
People should use shortcut controllers instead (global, capture).

A side effect of this is that GtkAccelLabel now lost its method to
magically look up accelerators to display. Somebody needs to add that
back later.
 2020-03-25 23:14:28 -04:00
Benjamin Otte
8e9218df03 doc tools: Create AccelLabel image without using GtkAccelGroup 2020-03-25 23:14:28 -04:00
Benjamin Otte
7974751e24 shortcuttrigger: Add gtk_shortcut_triger_new_parse_string() 
And hook it up into the GtkBuilder infrastructure.
 2020-03-25 23:14:28 -04:00
Benjamin Otte
fb6a8f5fc1 shortcuttrigger: Add hash(), equal(), and compare() functions 
Those are useful for putting triggers in hash tables or getting sorted
output.
 2020-03-25 23:14:28 -04:00
Benjamin Otte
4c5d8547be shortcutaction: Add gtk_shortcut_action_to_string() 
For all but the callback action, we can print something useful.
 2020-03-25 23:14:27 -04:00
Benjamin Otte
a1e9ae5259 shortcutcontroller: Add gtk_shortcut_controller_new_for_model() 
This is mainly for internal use, but I can't see a reason to not have it
public for people who want to maintain their own lists.

I'm sure gnome-builder will never ever find a way to misuse it.
 2020-03-25 23:14:27 -04:00
Benjamin Otte
92e20deca1 shortcut: Change the API for creating shortcuts 
When creating shortcuts, there almost always are a trigger and an action
available for use. So make gtk_shortcut_new() take those as arguments.

Also add gtk_shortcut_new_with_arguments() so people can easily pass
those in, too.
 2020-03-25 23:14:27 -04:00
Benjamin Otte
cd0332aad5 shortcut: Add GtkShortcutAction 
Similar to GtkShortcutTrigger, GtkShortCutAction provides all the
different ways to activate a shortcut.

So far, these different ways are supported:

 - do nothing
 - Call a user-provided callback
 - Call gtk_widget_activate()
 - Call gtk_widget_mnemonic_activate()
 - Emit an action signal
 - Activate an action from the widget's action muxer
 2020-03-25 23:14:27 -04:00
Benjamin Otte
cdd33bbee6 accelgroup: Remove unneeded APIs 
After the removal of GtkAccelMap, these things are no longer necessary.
 2020-03-25 23:14:27 -04:00
Emmanuele Bassi
bca1f6b64f gtk: Remove GtkAccelMap 
Now that accel paths are gone, the object managing them isn't needed
anymore either.
 2020-03-25 23:14:27 -04:00
Benjamin Otte
9b99b89807 gtk: Remove accel paths 
It's an outdated technology now that everybody is using GActionGroups.

If somebody wanted to support changeable shortcuts, they'd need to
reintroduce it in another way.
 2020-03-25 23:14:27 -04:00
Emmanuele Bassi
2c62cde780 window: Remove all old mnemonic handling API 2020-03-25 23:14:27 -04:00
Emmanuele Bassi
aab10ea43b Add GtkShortcutManager 
This adds an interface for taking care of shortcut controllers with
managed scope.

Only GtkWindow currently implements this interface, so we need to ensure
that we check if any top-level widget we reach is a shortcuts manager
before we call into it.
 2020-03-25 23:14:27 -04:00
Benjamin Otte
bde4cbe377 shortcuttrigger: Add support for mnemonics 
Mnemonics need to be triggered with help from the controllers (who
determine the modifiers). Support for that has been added, too.

Mnemonics do not use this yet though.
 2020-03-25 23:14:27 -04:00
Benjamin Otte
e398f63bf6 window: Get rid of public APIs that shouldn't be 
Event controllers should have replaced all of them.
And if they haven't, apps need to fix their code (I'm
looking at you Gimp).
 2020-03-25 23:14:27 -04:00
Benjamin Otte
730154df7d shortcutcontroller: Add GtkShortcutScope 
Allow setting the scope for a controller. The scope determines at what
point in event propagation the shortcuts will be activated.

Local scope is the usual activation, global scope means that the root
widget activates the shortcuts - ie they are activated at the very
start of event propagation (for global capture events) or the very end
(for global bubble events).
Managed scope so far is unimplemented.

This is supposed to be used to replace accelerators and mnemonics.
 2020-03-25 23:14:27 -04:00
Benjamin Otte
2309e1dd38 shortcuttrigger: Add gtk_shortcut_trigger_to_label() 
Provide a user-presentable string.
 2020-03-25 23:14:27 -04:00
Benjamin Otte
9a03c8b4d8 gtk: Remove bindings 
The whole binding functionality is now handled by shortcuts.
 2020-03-25 23:14:27 -04:00
Benjamin Otte
58e8f2332d shortcutcontroller: Add gtk_shortcut_controller_add_shortcut() 
... and gtk_shortcut_controller_remove_shortcut().
 2020-03-25 22:36:03 -04:00
Benjamin Otte
d4bba7de88 shortcut: Add gtk_shortcut_set_callback() 
... and gtk_widget_class_add_binding() to go with it.

This allows shortcuts to invoke manually added callbacks.
 2020-03-25 22:36:03 -04:00
Matthias Clasen
6d452f1eb8 shortcut: Add GtkShortcutTrigger 
Triggers are meant to describe how to trigger a shortcut.
So far only a keyval + modifiers trigger exists.
 2020-03-25 22:36:03 -04:00
Benjamin Otte
0eb1228902 widget: Add gtk_widget_class_add_shortcut() 
This allows adding shortcuts as a replacement for keybindings.
 2020-03-25 22:36:03 -04:00
Benjamin Otte
d8603864a9 gtk: Add GtkShortcut 
This is the base class for what is about to take over all sorts of
keyboard shortcuts. The initial version barely deals with keybindings.
 2020-03-25 22:36:03 -04:00
Benjamin Otte
a232107122 shortcutcontroller: Introduce 
This is a very barebones controller that currently does nothing but
activate the binding signals. Yay.

And because we have bindings on every widget (Yes, a GtkGrid has a
keybinding - 2 in fact), we need that controller everywhere.
 2020-03-25 22:36:03 -04:00