detached dfb3f40

Gir Spec: Update Adwaita

commit
dfb3f401f06e8b56eb0751b695f252bd2b28d1b0
author
Jeroen Wijenbergh · · 2025-04-07 12:37 UTC
committer
Jeroen Wijenbergh · · 2025-04-07 12:41 UTC
parent
850b37a
signature
unsigned
1 file · +28485 -13417
Unified
UnifiedSplit
M internal/gir/spec/Adw-1.gir +28485 -13417
@@ -15,39 +15,39 @@ and/or use gtk-doc annotations. -->
1515 shared-library="libadwaita-1.so.0"
1616 c:identifier-prefixes="Adw"
1717 c:symbol-prefixes="adw">
18- <class name="AboutWindow"
19- c:symbol-prefix="about_window"
20- c:type="AdwAboutWindow"
21- version="1.2"
22- parent="Window"
18+ <class name="AboutDialog"
19+ c:symbol-prefix="about_dialog"
20+ c:type="AdwAboutDialog"
21+ version="1.5"
22+ parent="Dialog"
2323 final="1"
24- glib:type-name="AdwAboutWindow"
25- glib:get-type="adw_about_window_get_type"
26- glib:type-struct="AboutWindowClass">
24+ glib:type-name="AdwAboutDialog"
25+ glib:get-type="adw_about_dialog_get_type"
26+ glib:type-struct="AboutDialogClass">
2727 <doc xml:space="preserve"
28- filename="src/adw-about-window.c"
29- line="19">A window showing information about the application.
28+ filename="src/adw-about-dialog.c"
29+ line="22">A dialog showing information about the application.
3030
3131 &lt;picture&gt;
32- &lt;source srcset="about-window-dark.png" media="(prefers-color-scheme: dark)"&gt;
33- &lt;img src="about-window.png" alt="about-window"&gt;
32+ &lt;source srcset="about-dialog-dark.png" media="(prefers-color-scheme: dark)"&gt;
33+ &lt;img src="about-dialog.png" alt="about-dialog"&gt;
3434 &lt;/picture&gt;
3535
36-An about window is typically opened when the user activates the `About …`
37-item in the application's primary menu. All parts of the window are optional.
36+an about dialog is typically opened when the user activates the `About …`
37+item in the application's primary menu. All parts of the dialog are optional.
3838
3939 ## Main page
4040
41-`AdwAboutWindow` prominently displays the application's icon, name, developer
42-name and version. They can be set with the [property@AboutWindow:application-icon],
43-[property@AboutWindow:application-name],
44-[property@AboutWindow:developer-name] and [property@AboutWindow:version]
41+`AdwAboutDialog` prominently displays the application's icon, name, developer
42+name and version. They can be set with the [property@AboutDialog:application-icon],
43+[property@AboutDialog:application-name],
44+[property@AboutDialog:developer-name] and [property@AboutDialog:version]
4545 respectively.
4646
4747 ## What's New
4848
49-`AdwAboutWindow` provides a way for applications to display their release
50-notes, set with the [property@AboutWindow:release-notes] property.
49+`AdwAboutDialog` provides a way for applications to display their release
50+notes, set with the [property@AboutDialog:release-notes] property.
5151
5252 Release notes are formatted the same way as
5353 [AppStream descriptions](https://freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-description).
@@ -67,50 +67,50 @@ Any text outside paragraphs or list items is ignored.
6767 Nested lists are not supported.
6868
6969 Only one version can be shown at a time. By default, the displayed version
70-number matches [property@AboutWindow:version]. Use
71-[property@AboutWindow:release-notes-version] to override it.
70+number matches [property@AboutDialog:version]. Use
71+[property@AboutDialog:release-notes-version] to override it.
7272
7373 ## Details
7474
7575 The Details page displays the application comments and links.
7676
77-The comments can be set with the [property@AboutWindow:comments] property.
77+The comments can be set with the [property@AboutDialog:comments] property.
7878 Unlike [property@Gtk.AboutDialog:comments], this string can be long and
7979 detailed. It can also contain links and Pango markup.
8080
81-To set the application website, use [property@AboutWindow:website].
82-To add extra links below the website, use [method@AboutWindow.add_link].
81+To set the application website, use [property@AboutDialog:website].
82+To add extra links below the website, use [method@AboutDialog.add_link].
8383
8484 If the Details page doesn't have any other content besides website, the
8585 website will be displayed on the main page instead.
8686
8787 ## Troubleshooting
8888
89-`AdwAboutWindow` displays the following two links on the main page:
89+`AdwAboutDialog` displays the following two links on the main page:
9090
91-* Support Questions, set with the [property@AboutWindow:support-url] property,
92-* Report an Issue, set with the [property@AboutWindow:issue-url] property.
91+* Support Questions, set with the [property@AboutDialog:support-url] property,
92+* Report an Issue, set with the [property@AboutDialog:issue-url] property.
9393
9494 Additionally, applications can provide debugging information. It will be
9595 shown separately on the Troubleshooting page. Use the
96-[property@AboutWindow:debug-info] property to specify it.
96+[property@AboutDialog:debug-info] property to specify it.
9797
9898 It's intended to be attached to issue reports when reporting issues against
9999 the application. As such, it cannot contain markup or links.
100100
101-`AdwAboutWindow` provides a quick way to save debug information to a file.
102-When saving, [property@AboutWindow:debug-info-filename] would be used as
101+`AdwAboutDialog` provides a quick way to save debug information to a file.
102+When saving, [property@AboutDialog:debug-info-filename] would be used as
103103 the suggested filename.
104104
105105 ## Credits and Acknowledgements
106106
107107 The Credits page has the following default sections:
108108
109-* Developers, set with the [property@AboutWindow:developers] property,
110-* Designers, set with the [property@AboutWindow:designers] property,
111-* Artists, set with the [property@AboutWindow:artists] property,
112-* Documenters, set with the [property@AboutWindow:documenters] property,
113-* Translators, set with the [property@AboutWindow:translator-credits] property.
109+* Developers, set with the [property@AboutDialog:developers] property,
110+* Designers, set with the [property@AboutDialog:designers] property,
111+* Artists, set with the [property@AboutDialog:artists] property,
112+* Documenters, set with the [property@AboutDialog:documenters] property,
113+* Translators, set with the [property@AboutDialog:translator-credits] property.
114114
115115 When setting translator credits, use the strings `"translator-credits"` or
116116 `"translator_credits"` and mark them as translatable.
@@ -118,11 +118,11 @@ When setting translator credits, use the strings `"translator-credits"` or
118118 The default sections that don't contain any names won't be displayed.
119119
120120 The Credits page can also contain an arbitrary number of extra sections below
121-the default ones. Use [method@AboutWindow.add_credit_section] to add them.
121+the default ones. Use [method@AboutDialog.add_credit_section] to add them.
122122
123123 The Acknowledgements page can be used to acknowledge additional people and
124124 organizations for their non-development contributions. Use
125-[method@AboutWindow.add_acknowledgement_section] to add sections to it. For
125+[method@AboutDialog.add_acknowledgement_section] to add sections to it. For
126126 example, it can be used to list backers in a crowdfunded project or to give
127127 special thanks.
128128
@@ -132,8 +132,8 @@ specified. To add a email address, use a string like
132132 string like `The GNOME Project https://www.gnome.org`:
133133
134134 &lt;picture&gt;
135- &lt;source srcset="about-window-credits-dark.png" media="(prefers-color-scheme: dark)"&gt;
136- &lt;img src="about-window-credits.png" alt="about-window-credits"&gt;
135+ &lt;source srcset="about-dialog-credits-dark.png" media="(prefers-color-scheme: dark)"&gt;
136+ &lt;img src="about-dialog-credits.png" alt="about-dialog-credits"&gt;
137137 &lt;/picture&gt;
138138
139139 ## Legal
@@ -141,23 +141,23 @@ string like `The GNOME Project https://www.gnome.org`:
141141 The Legal page displays the copyright and licensing information for the
142142 application and other modules.
143143
144-The copyright string is set with the [property@AboutWindow:copyright]
144+The copyright string is set with the [property@AboutDialog:copyright]
145145 property and should be a short string of one or two lines, for example:
146146 `© 2022 Example`.
147147
148148 Licensing information can be quickly set from a list of known licenses with
149-the [property@AboutWindow:license-type] property. If the application's
150-license is not in the list, [property@AboutWindow:license] can be used
149+the [property@AboutDialog:license-type] property. If the application's
150+license is not in the list, [property@AboutDialog:license] can be used
151151 instead.
152152
153153 To add information about other modules, such as application dependencies or
154-data, use [method@AboutWindow.add_legal_section].
154+data, use [method@AboutDialog.add_legal_section].
155155
156156 ## Constructing
157157
158-To make constructing an `AdwAboutWindow` as convenient as possible, you can
159-use the function [func@show_about_window] which constructs and shows a
160-window.
158+To make constructing an `AdwAboutDialog` as convenient as possible, you can
159+use the function [func@show_about_dialog] which constructs and shows a
160+dialog.
161161
162162 ```c
163163 static void
@@ -173,12 +173,12 @@ show_about (GtkApplication *app)
173173 NULL
174174 };
175175
176- adw_show_about_window (gtk_application_get_active_window (app),
176+ adw_show_about_dialog (GTK_WIDGET (gtk_application_get_active_window (app)),
177177 "application-name", _("Example"),
178178 "application-icon", "org.example.App",
179179 "version", "1.2.3",
180180 "copyright", "© 2022 Angela Avery",
181- "issue-url", "https://gitlab.gnome.org/example/example/-/issues/new",
181+ "issue-url", "https://gitlab.gnome.org/example/example/-/issues/",
182182 "license-type", GTK_LICENSE_GPL_3_0,
183183 "developers", developers,
184184 "designers", designers,
@@ -189,35 +189,83 @@ show_about (GtkApplication *app)
189189
190190 ## CSS nodes
191191
192-`AdwAboutWindow` has a main CSS node with the name `window` and the
192+`AdwAboutDialog` has a main CSS node with the name `dialog` and the
193193 style class `.about`.</doc>
194- <source-position filename="src/adw-about-window.h" line="23"/>
194+ <source-position filename="src/adw-about-dialog.h" line="25"/>
195195 <implements name="Gtk.Accessible"/>
196196 <implements name="Gtk.Buildable"/>
197197 <implements name="Gtk.ConstraintTarget"/>
198- <implements name="Gtk.Native"/>
199- <implements name="Gtk.Root"/>
200- <implements name="Gtk.ShortcutManager"/>
201198 <constructor name="new"
202- c:identifier="adw_about_window_new"
203- version="1.2">
199+ c:identifier="adw_about_dialog_new"
200+ version="1.5">
204201 <doc xml:space="preserve"
205- filename="src/adw-about-window.c"
206- line="1941">Creates a new `AdwAboutWindow`.</doc>
207- <source-position filename="src/adw-about-window.h" line="26"/>
202+ filename="src/adw-about-dialog.c"
203+ line="1952">Creates a new `AdwAboutDialog`.</doc>
204+ <source-position filename="src/adw-about-dialog.h" line="28"/>
208205 <return-value transfer-ownership="none">
209206 <doc xml:space="preserve"
210- filename="src/adw-about-window.c"
211- line="1946">the newly created `AdwAboutWindow`</doc>
212- <type name="Gtk.Widget" c:type="GtkWidget*"/>
207+ filename="src/adw-about-dialog.c"
208+ line="1957">the newly created `AdwAboutDialog`</doc>
209+ <type name="Dialog" c:type="AdwDialog*"/>
210+ </return-value>
211+ </constructor>
212+ <constructor name="new_from_appdata"
213+ c:identifier="adw_about_dialog_new_from_appdata"
214+ version="1.5">
215+ <doc xml:space="preserve"
216+ filename="src/adw-about-dialog.c"
217+ line="1967">Creates a new `AdwAboutDialog` using AppStream metadata.
218+
219+This automatically sets the following properties with the following AppStream
220+values:
221+
222+* [property@AboutDialog:application-icon] is set from the `&lt;id&gt;`
223+* [property@AboutDialog:application-name] is set from the `&lt;name&gt;`
224+* [property@AboutDialog:developer-name] is set from the `&lt;name&gt;` within
225+ `&lt;developer&gt;`
226+* [property@AboutDialog:version] is set from the version of the latest release
227+* [property@AboutDialog:website] is set from the `&lt;url type="homepage"&gt;`
228+* [property@AboutDialog:support-url] is set from the `&lt;url type="help"&gt;`
229+* [property@AboutDialog:issue-url] is set from the `&lt;url type="bugtracker"&gt;`
230+* [property@AboutDialog:license-type] is set from the `&lt;project_license&gt;`.
231+ If the license type retrieved from AppStream is not listed in
232+ [enum@Gtk.License], it will be set to `GTK_LICENCE_CUSTOM`.
233+
234+If @release_notes_version is not `NULL`,
235+[property@AboutDialog:release-notes-version] is set to match it, while
236+[property@AboutDialog:release-notes] is set from the AppStream release
237+description for that version.</doc>
238+ <source-position filename="src/adw-about-dialog.h" line="31"/>
239+ <return-value transfer-ownership="none">
240+ <doc xml:space="preserve"
241+ filename="src/adw-about-dialog.c"
242+ line="1994">the newly created `AdwAboutDialog`</doc>
243+ <type name="Dialog" c:type="AdwDialog*"/>
213244 </return-value>
245+ <parameters>
246+ <parameter name="resource_path" transfer-ownership="none">
247+ <doc xml:space="preserve"
248+ filename="src/adw-about-dialog.c"
249+ line="1969">The resource to use</doc>
250+ <type name="utf8" c:type="const char*"/>
251+ </parameter>
252+ <parameter name="release_notes_version"
253+ transfer-ownership="none"
254+ nullable="1"
255+ allow-none="1">
256+ <doc xml:space="preserve"
257+ filename="src/adw-about-dialog.c"
258+ line="1970">The version to retrieve release notes for</doc>
259+ <type name="utf8" c:type="const char*"/>
260+ </parameter>
261+ </parameters>
214262 </constructor>
215263 <method name="add_acknowledgement_section"
216- c:identifier="adw_about_window_add_acknowledgement_section"
217- version="1.2">
264+ c:identifier="adw_about_dialog_add_acknowledgement_section"
265+ version="1.5">
218266 <doc xml:space="preserve"
219- filename="src/adw-about-window.c"
220- line="2962">Adds a section to the Acknowledgements page.
267+ filename="src/adw-about-dialog.c"
268+ line="3120">Adds a section to the Acknowledgements page.
221269
222270 This can be used to acknowledge additional people and organizations for their
223271 non-development contributions - for example, backers in a crowdfunded
@@ -228,36 +276,36 @@ details.
228276
229277 See also:
230278
231-* [property@AboutWindow:developers]
232-* [property@AboutWindow:designers]
233-* [property@AboutWindow:artists]
234-* [property@AboutWindow:documenters]
235-* [property@AboutWindow:translator-credits]
236-* [method@AboutWindow.add_credit_section]</doc>
237- <source-position filename="src/adw-about-window.h" line="141"/>
279+* [property@AboutDialog:developers]
280+* [property@AboutDialog:designers]
281+* [property@AboutDialog:artists]
282+* [property@AboutDialog:documenters]
283+* [property@AboutDialog:translator-credits]
284+* [method@AboutDialog.add_credit_section]</doc>
285+ <source-position filename="src/adw-about-dialog.h" line="147"/>
238286 <return-value transfer-ownership="none">
239287 <type name="none" c:type="void"/>
240288 </return-value>
241289 <parameters>
242290 <instance-parameter name="self" transfer-ownership="none">
243291 <doc xml:space="preserve"
244- filename="src/adw-about-window.c"
245- line="2964">an about window</doc>
246- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
292+ filename="src/adw-about-dialog.c"
293+ line="3122">an about dialog</doc>
294+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
247295 </instance-parameter>
248296 <parameter name="name"
249297 transfer-ownership="none"
250298 nullable="1"
251299 allow-none="1">
252300 <doc xml:space="preserve"
253- filename="src/adw-about-window.c"
254- line="2965">the section name</doc>
301+ filename="src/adw-about-dialog.c"
302+ line="3123">the section name</doc>
255303 <type name="utf8" c:type="const char*"/>
256304 </parameter>
257305 <parameter name="people" transfer-ownership="none">
258306 <doc xml:space="preserve"
259- filename="src/adw-about-window.c"
260- line="2966">the list of names</doc>
307+ filename="src/adw-about-dialog.c"
308+ line="3124">the list of names</doc>
261309 <array c:type="const char**">
262310 <type name="utf8" c:type="char*"/>
263311 </array>
@@ -265,11 +313,11 @@ See also:
265313 </parameters>
266314 </method>
267315 <method name="add_credit_section"
268- c:identifier="adw_about_window_add_credit_section"
269- version="1.2">
316+ c:identifier="adw_about_dialog_add_credit_section"
317+ version="1.5">
270318 <doc xml:space="preserve"
271- filename="src/adw-about-window.c"
272- line="2919">Adds an extra section to the Credits page.
319+ filename="src/adw-about-dialog.c"
320+ line="3077">Adds an extra section to the Credits page.
273321
274322 Extra sections are displayed below the standard categories.
275323
@@ -278,36 +326,36 @@ details.
278326
279327 See also:
280328
281-* [property@AboutWindow:developers]
282-* [property@AboutWindow:designers]
283-* [property@AboutWindow:artists]
284-* [property@AboutWindow:documenters]
285-* [property@AboutWindow:translator-credits]
286-* [method@AboutWindow.add_acknowledgement_section]</doc>
287- <source-position filename="src/adw-about-window.h" line="136"/>
329+* [property@AboutDialog:developers]
330+* [property@AboutDialog:designers]
331+* [property@AboutDialog:artists]
332+* [property@AboutDialog:documenters]
333+* [property@AboutDialog:translator-credits]
334+* [method@AboutDialog.add_acknowledgement_section]</doc>
335+ <source-position filename="src/adw-about-dialog.h" line="142"/>
288336 <return-value transfer-ownership="none">
289337 <type name="none" c:type="void"/>
290338 </return-value>
291339 <parameters>
292340 <instance-parameter name="self" transfer-ownership="none">
293341 <doc xml:space="preserve"
294- filename="src/adw-about-window.c"
295- line="2921">an about window</doc>
296- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
342+ filename="src/adw-about-dialog.c"
343+ line="3079">an about dialog</doc>
344+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
297345 </instance-parameter>
298346 <parameter name="name"
299347 transfer-ownership="none"
300348 nullable="1"
301349 allow-none="1">
302350 <doc xml:space="preserve"
303- filename="src/adw-about-window.c"
304- line="2922">the section name</doc>
351+ filename="src/adw-about-dialog.c"
352+ line="3080">the section name</doc>
305353 <type name="utf8" c:type="const char*"/>
306354 </parameter>
307355 <parameter name="people" transfer-ownership="none">
308356 <doc xml:space="preserve"
309- filename="src/adw-about-window.c"
310- line="2923">the list of names</doc>
357+ filename="src/adw-about-dialog.c"
358+ line="3081">the list of names</doc>
311359 <array c:type="const char**">
312360 <type name="utf8" c:type="char*"/>
313361 </array>
@@ -315,17 +363,17 @@ See also:
315363 </parameters>
316364 </method>
317365 <method name="add_legal_section"
318- c:identifier="adw_about_window_add_legal_section"
319- version="1.2">
366+ c:identifier="adw_about_dialog_add_legal_section"
367+ version="1.5">
320368 <doc xml:space="preserve"
321- filename="src/adw-about-window.c"
322- line="3188">Adds an extra section to the Legal page.
369+ filename="src/adw-about-dialog.c"
370+ line="3340">Adds an extra section to the Legal page.
323371
324372 Extra sections will be displayed below the application's own information.
325373
326374 The parameters @copyright, @license_type and @license will be used to present
327-the it the same way as [property@AboutWindow:copyright],
328-[property@AboutWindow:license-type] and [property@AboutWindow:license] are
375+the it the same way as [property@AboutDialog:copyright],
376+[property@AboutDialog:license-type] and [property@AboutDialog:license] are
329377 for the application's own information.
330378
331379 See those properties for more details.
@@ -335,45 +383,45 @@ This can be useful to attribute the application dependencies or data.
335383 Examples:
336384
337385 ```c
338-adw_about_window_add_legal_section (ADW_ABOUT_WINDOW (about),
386+adw_about_dialog_add_legal_section (ADW_ABOUT_DIALOG (about),
339387 _("Copyright and a known license"),
340388 "© 2022 Example",
341389 GTK_LICENSE_LGPL_2_1,
342390 NULL);
343391
344-adw_about_window_add_legal_section (ADW_ABOUT_WINDOW (about),
392+adw_about_dialog_add_legal_section (ADW_ABOUT_DIALOG (about),
345393 _("Copyright and custom license"),
346394 "© 2022 Example",
347395 GTK_LICENSE_CUSTOM,
348396 "Custom license text");
349397
350-adw_about_window_add_legal_section (ADW_ABOUT_WINDOW (about),
398+adw_about_dialog_add_legal_section (ADW_ABOUT_DIALOG (about),
351399 _("Copyright only"),
352400 "© 2022 Example",
353401 GTK_LICENSE_UNKNOWN,
354402 NULL);
355403
356-adw_about_window_add_legal_section (ADW_ABOUT_WINDOW (about),
404+adw_about_dialog_add_legal_section (ADW_ABOUT_DIALOG (about),
357405 _("Custom license only"),
358406 NULL,
359407 GTK_LICENSE_CUSTOM,
360408 "Something completely custom here.");
361409 ```</doc>
362- <source-position filename="src/adw-about-window.h" line="164"/>
410+ <source-position filename="src/adw-about-dialog.h" line="170"/>
363411 <return-value transfer-ownership="none">
364412 <type name="none" c:type="void"/>
365413 </return-value>
366414 <parameters>
367415 <instance-parameter name="self" transfer-ownership="none">
368416 <doc xml:space="preserve"
369- filename="src/adw-about-window.c"
370- line="3190">an about window</doc>
371- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
417+ filename="src/adw-about-dialog.c"
418+ line="3342">an about dialog</doc>
419+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
372420 </instance-parameter>
373421 <parameter name="title" transfer-ownership="none">
374422 <doc xml:space="preserve"
375- filename="src/adw-about-window.c"
376- line="3191">the name of the section</doc>
423+ filename="src/adw-about-dialog.c"
424+ line="3343">the name of the section</doc>
377425 <type name="utf8" c:type="const char*"/>
378426 </parameter>
379427 <parameter name="copyright"
@@ -381,14 +429,14 @@ adw_about_window_add_legal_section (ADW_ABOUT_WINDOW (about),
381429 nullable="1"
382430 allow-none="1">
383431 <doc xml:space="preserve"
384- filename="src/adw-about-window.c"
385- line="3192">a copyright string</doc>
432+ filename="src/adw-about-dialog.c"
433+ line="3344">a copyright string</doc>
386434 <type name="utf8" c:type="const char*"/>
387435 </parameter>
388436 <parameter name="license_type" transfer-ownership="none">
389437 <doc xml:space="preserve"
390- filename="src/adw-about-window.c"
391- line="3193">the type of license</doc>
438+ filename="src/adw-about-dialog.c"
439+ line="3345">the type of license</doc>
392440 <type name="Gtk.License" c:type="GtkLicense"/>
393441 </parameter>
394442 <parameter name="license"
@@ -396,112 +444,107 @@ adw_about_window_add_legal_section (ADW_ABOUT_WINDOW (about),
396444 nullable="1"
397445 allow-none="1">
398446 <doc xml:space="preserve"
399- filename="src/adw-about-window.c"
400- line="3194">custom license information</doc>
447+ filename="src/adw-about-dialog.c"
448+ line="3346">custom license information</doc>
401449 <type name="utf8" c:type="const char*"/>
402450 </parameter>
403451 </parameters>
404452 </method>
405453 <method name="add_link"
406- c:identifier="adw_about_window_add_link"
407- version="1.2">
454+ c:identifier="adw_about_dialog_add_link"
455+ version="1.5">
408456 <doc xml:space="preserve"
409- filename="src/adw-about-window.c"
410- line="2475">Adds an extra link to the Details page.
457+ filename="src/adw-about-dialog.c"
458+ line="2638">Adds an extra link to the Details page.
411459
412460 Extra links are displayed under the comment and website.
413461
414462 Underlines in @title will be interpreted as indicating a mnemonic.
415463
416-See [property@AboutWindow:website].</doc>
417- <source-position filename="src/adw-about-window.h" line="89"/>
464+See [property@AboutDialog:website].</doc>
465+ <source-position filename="src/adw-about-dialog.h" line="95"/>
418466 <return-value transfer-ownership="none">
419467 <type name="none" c:type="void"/>
420468 </return-value>
421469 <parameters>
422470 <instance-parameter name="self" transfer-ownership="none">
423471 <doc xml:space="preserve"
424- filename="src/adw-about-window.c"
425- line="2477">an about window</doc>
426- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
472+ filename="src/adw-about-dialog.c"
473+ line="2640">an about dialog</doc>
474+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
427475 </instance-parameter>
428476 <parameter name="title" transfer-ownership="none">
429477 <doc xml:space="preserve"
430- filename="src/adw-about-window.c"
431- line="2478">the link title</doc>
478+ filename="src/adw-about-dialog.c"
479+ line="2641">the link title</doc>
432480 <type name="utf8" c:type="const char*"/>
433481 </parameter>
434482 <parameter name="url" transfer-ownership="none">
435483 <doc xml:space="preserve"
436- filename="src/adw-about-window.c"
437- line="2479">the link URL</doc>
484+ filename="src/adw-about-dialog.c"
485+ line="2642">the link URL</doc>
438486 <type name="utf8" c:type="const char*"/>
439487 </parameter>
440488 </parameters>
441489 </method>
442490 <method name="get_application_icon"
443- c:identifier="adw_about_window_get_application_icon"
491+ c:identifier="adw_about_dialog_get_application_icon"
444492 glib:get-property="application-icon"
445- version="1.2">
446- <attribute name="org.gtk.Method.get_property"
447- value="application-icon"/>
493+ version="1.5">
448494 <doc xml:space="preserve"
449- filename="src/adw-about-window.c"
450- line="1956">Gets the name of the application icon for @self.</doc>
451- <source-position filename="src/adw-about-window.h" line="35"/>
495+ filename="src/adw-about-dialog.c"
496+ line="2149">Gets the name of the application icon for @self.</doc>
497+ <source-position filename="src/adw-about-dialog.h" line="41"/>
452498 <return-value transfer-ownership="none">
453499 <doc xml:space="preserve"
454- filename="src/adw-about-window.c"
455- line="1962">the application icon name</doc>
500+ filename="src/adw-about-dialog.c"
501+ line="2155">the application icon name</doc>
456502 <type name="utf8" c:type="const char*"/>
457503 </return-value>
458504 <parameters>
459505 <instance-parameter name="self" transfer-ownership="none">
460506 <doc xml:space="preserve"
461- filename="src/adw-about-window.c"
462- line="1958">an about window</doc>
463- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
507+ filename="src/adw-about-dialog.c"
508+ line="2151">an about dialog</doc>
509+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
464510 </instance-parameter>
465511 </parameters>
466512 </method>
467513 <method name="get_application_name"
468- c:identifier="adw_about_window_get_application_name"
514+ c:identifier="adw_about_dialog_get_application_name"
469515 glib:get-property="application-name"
470- version="1.2">
471- <attribute name="org.gtk.Method.get_property"
472- value="application-name"/>
516+ version="1.5">
473517 <doc xml:space="preserve"
474- filename="src/adw-about-window.c"
475- line="2004">Gets the application name for @self.</doc>
476- <source-position filename="src/adw-about-window.h" line="29"/>
518+ filename="src/adw-about-dialog.c"
519+ line="2194">Gets the application name for @self.</doc>
520+ <source-position filename="src/adw-about-dialog.h" line="35"/>
477521 <return-value transfer-ownership="none">
478522 <doc xml:space="preserve"
479- filename="src/adw-about-window.c"
480- line="2010">the application name</doc>
523+ filename="src/adw-about-dialog.c"
524+ line="2200">the application name</doc>
481525 <type name="utf8" c:type="const char*"/>
482526 </return-value>
483527 <parameters>
484528 <instance-parameter name="self" transfer-ownership="none">
485529 <doc xml:space="preserve"
486- filename="src/adw-about-window.c"
487- line="2006">an about window</doc>
488- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
530+ filename="src/adw-about-dialog.c"
531+ line="2196">an about dialog</doc>
532+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
489533 </instance-parameter>
490534 </parameters>
491535 </method>
492536 <method name="get_artists"
493- c:identifier="adw_about_window_get_artists"
537+ c:identifier="adw_about_dialog_get_artists"
494538 glib:get-property="artists"
495- version="1.2">
496- <attribute name="org.gtk.Method.get_property" value="artists"/>
539+ version="1.5">
497540 <doc xml:space="preserve"
498- filename="src/adw-about-window.c"
499- line="2741">Gets the list of artists of the application.</doc>
500- <source-position filename="src/adw-about-window.h" line="118"/>
541+ filename="src/adw-about-dialog.c"
542+ line="2902">Gets the list of artists of the application.</doc>
543+ <source-position filename="src/adw-about-dialog.h" line="124"/>
501544 <return-value transfer-ownership="none" nullable="1">
502545 <doc xml:space="preserve"
503- filename="src/adw-about-window.c"
504- line="2747">The list of artists</doc>
546+ filename="src/adw-about-dialog.c"
547+ line="2908">The list of artists</doc>
505548 <array c:type="const char* const*">
506549 <type name="utf8"/>
507550 </array>
@@ -509,122 +552,116 @@ See [property@AboutWindow:website].</doc>
509552 <parameters>
510553 <instance-parameter name="self" transfer-ownership="none">
511554 <doc xml:space="preserve"
512- filename="src/adw-about-window.c"
513- line="2743">an about window</doc>
514- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
555+ filename="src/adw-about-dialog.c"
556+ line="2904">an about dialog</doc>
557+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
515558 </instance-parameter>
516559 </parameters>
517560 </method>
518561 <method name="get_comments"
519- c:identifier="adw_about_window_get_comments"
562+ c:identifier="adw_about_dialog_get_comments"
520563 glib:get-property="comments"
521- version="1.2">
522- <attribute name="org.gtk.Method.get_property" value="comments"/>
564+ version="1.5">
523565 <doc xml:space="preserve"
524- filename="src/adw-about-window.c"
525- line="2281">Gets the comments about the application.</doc>
526- <source-position filename="src/adw-about-window.h" line="65"/>
566+ filename="src/adw-about-dialog.c"
567+ line="2456">Gets the comments about the application.</doc>
568+ <source-position filename="src/adw-about-dialog.h" line="71"/>
527569 <return-value transfer-ownership="none">
528570 <doc xml:space="preserve"
529- filename="src/adw-about-window.c"
530- line="2287">the comments</doc>
571+ filename="src/adw-about-dialog.c"
572+ line="2462">the comments</doc>
531573 <type name="utf8" c:type="const char*"/>
532574 </return-value>
533575 <parameters>
534576 <instance-parameter name="self" transfer-ownership="none">
535577 <doc xml:space="preserve"
536- filename="src/adw-about-window.c"
537- line="2283">an about window</doc>
538- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
578+ filename="src/adw-about-dialog.c"
579+ line="2458">an about dialog</doc>
580+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
539581 </instance-parameter>
540582 </parameters>
541583 </method>
542584 <method name="get_copyright"
543- c:identifier="adw_about_window_get_copyright"
585+ c:identifier="adw_about_dialog_get_copyright"
544586 glib:get-property="copyright"
545- version="1.2">
546- <attribute name="org.gtk.Method.get_property" value="copyright"/>
587+ version="1.5">
547588 <doc xml:space="preserve"
548- filename="src/adw-about-window.c"
549- line="3003">Gets the copyright information for @self.</doc>
550- <source-position filename="src/adw-about-window.h" line="146"/>
589+ filename="src/adw-about-dialog.c"
590+ line="3161">Gets the copyright information for @self.</doc>
591+ <source-position filename="src/adw-about-dialog.h" line="152"/>
551592 <return-value transfer-ownership="none">
552593 <doc xml:space="preserve"
553- filename="src/adw-about-window.c"
554- line="3009">the copyright information</doc>
594+ filename="src/adw-about-dialog.c"
595+ line="3167">the copyright information</doc>
555596 <type name="utf8" c:type="const char*"/>
556597 </return-value>
557598 <parameters>
558599 <instance-parameter name="self" transfer-ownership="none">
559600 <doc xml:space="preserve"
560- filename="src/adw-about-window.c"
561- line="3005">an about window</doc>
562- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
601+ filename="src/adw-about-dialog.c"
602+ line="3163">an about dialog</doc>
603+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
563604 </instance-parameter>
564605 </parameters>
565606 </method>
566607 <method name="get_debug_info"
567- c:identifier="adw_about_window_get_debug_info"
608+ c:identifier="adw_about_dialog_get_debug_info"
568609 glib:get-property="debug-info"
569- version="1.2">
570- <attribute name="org.gtk.Method.get_property" value="debug-info"/>
610+ version="1.5">
571611 <doc xml:space="preserve"
572- filename="src/adw-about-window.c"
573- line="2522">Gets the debug information for @self.</doc>
574- <source-position filename="src/adw-about-window.h" line="94"/>
612+ filename="src/adw-about-dialog.c"
613+ line="2689">Gets the debug information for @self.</doc>
614+ <source-position filename="src/adw-about-dialog.h" line="100"/>
575615 <return-value transfer-ownership="none">
576616 <doc xml:space="preserve"
577- filename="src/adw-about-window.c"
578- line="2528">the debug information</doc>
617+ filename="src/adw-about-dialog.c"
618+ line="2695">the debug information</doc>
579619 <type name="utf8" c:type="const char*"/>
580620 </return-value>
581621 <parameters>
582622 <instance-parameter name="self" transfer-ownership="none">
583623 <doc xml:space="preserve"
584- filename="src/adw-about-window.c"
585- line="2524">an about window</doc>
586- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
624+ filename="src/adw-about-dialog.c"
625+ line="2691">an about dialog</doc>
626+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
587627 </instance-parameter>
588628 </parameters>
589629 </method>
590630 <method name="get_debug_info_filename"
591- c:identifier="adw_about_window_get_debug_info_filename"
631+ c:identifier="adw_about_dialog_get_debug_info_filename"
592632 glib:get-property="debug-info-filename"
593- version="1.2">
594- <attribute name="org.gtk.Method.get_property"
595- value="debug-info-filename"/>
633+ version="1.5">
596634 <doc xml:space="preserve"
597- filename="src/adw-about-window.c"
598- line="2577">Gets the debug information filename for @self.</doc>
599- <source-position filename="src/adw-about-window.h" line="100"/>
635+ filename="src/adw-about-dialog.c"
636+ line="2741">Gets the debug information filename for @self.</doc>
637+ <source-position filename="src/adw-about-dialog.h" line="106"/>
600638 <return-value transfer-ownership="none">
601639 <doc xml:space="preserve"
602- filename="src/adw-about-window.c"
603- line="2583">the debug information filename</doc>
640+ filename="src/adw-about-dialog.c"
641+ line="2747">the debug information filename</doc>
604642 <type name="utf8" c:type="const char*"/>
605643 </return-value>
606644 <parameters>
607645 <instance-parameter name="self" transfer-ownership="none">
608646 <doc xml:space="preserve"
609- filename="src/adw-about-window.c"
610- line="2579">an about window</doc>
611- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
647+ filename="src/adw-about-dialog.c"
648+ line="2743">an about dialog</doc>
649+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
612650 </instance-parameter>
613651 </parameters>
614652 </method>
615653 <method name="get_designers"
616- c:identifier="adw_about_window_get_designers"
654+ c:identifier="adw_about_dialog_get_designers"
617655 glib:get-property="designers"
618- version="1.2">
619- <attribute name="org.gtk.Method.get_property" value="designers"/>
656+ version="1.5">
620657 <doc xml:space="preserve"
621- filename="src/adw-about-window.c"
622- line="2683">Gets the list of designers of the application.</doc>
623- <source-position filename="src/adw-about-window.h" line="112"/>
658+ filename="src/adw-about-dialog.c"
659+ line="2844">Gets the list of designers of the application.</doc>
660+ <source-position filename="src/adw-about-dialog.h" line="118"/>
624661 <return-value transfer-ownership="none" nullable="1">
625662 <doc xml:space="preserve"
626- filename="src/adw-about-window.c"
627- line="2689">The list of designers</doc>
663+ filename="src/adw-about-dialog.c"
664+ line="2850">The list of designers</doc>
628665 <array c:type="const char* const*">
629666 <type name="utf8"/>
630667 </array>
@@ -632,49 +669,47 @@ See [property@AboutWindow:website].</doc>
632669 <parameters>
633670 <instance-parameter name="self" transfer-ownership="none">
634671 <doc xml:space="preserve"
635- filename="src/adw-about-window.c"
636- line="2685">an about window</doc>
637- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
672+ filename="src/adw-about-dialog.c"
673+ line="2846">an about dialog</doc>
674+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
638675 </instance-parameter>
639676 </parameters>
640677 </method>
641678 <method name="get_developer_name"
642- c:identifier="adw_about_window_get_developer_name"
679+ c:identifier="adw_about_dialog_get_developer_name"
643680 glib:get-property="developer-name"
644- version="1.2">
645- <attribute name="org.gtk.Method.get_property" value="developer-name"/>
681+ version="1.5">
646682 <doc xml:space="preserve"
647- filename="src/adw-about-window.c"
648- line="2052">Gets the developer name for @self.</doc>
649- <source-position filename="src/adw-about-window.h" line="41"/>
683+ filename="src/adw-about-dialog.c"
684+ line="2239">Gets the developer name for @self.</doc>
685+ <source-position filename="src/adw-about-dialog.h" line="47"/>
650686 <return-value transfer-ownership="none">
651687 <doc xml:space="preserve"
652- filename="src/adw-about-window.c"
653- line="2058">the developer_name</doc>
688+ filename="src/adw-about-dialog.c"
689+ line="2245">the developer_name</doc>
654690 <type name="utf8" c:type="const char*"/>
655691 </return-value>
656692 <parameters>
657693 <instance-parameter name="self" transfer-ownership="none">
658694 <doc xml:space="preserve"
659- filename="src/adw-about-window.c"
660- line="2054">an about window</doc>
661- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
695+ filename="src/adw-about-dialog.c"
696+ line="2241">an about dialog</doc>
697+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
662698 </instance-parameter>
663699 </parameters>
664700 </method>
665701 <method name="get_developers"
666- c:identifier="adw_about_window_get_developers"
702+ c:identifier="adw_about_dialog_get_developers"
667703 glib:get-property="developers"
668- version="1.2">
669- <attribute name="org.gtk.Method.get_property" value="developers"/>
704+ version="1.5">
670705 <doc xml:space="preserve"
671- filename="src/adw-about-window.c"
672- line="2625">Gets the list of developers of the application.</doc>
673- <source-position filename="src/adw-about-window.h" line="106"/>
706+ filename="src/adw-about-dialog.c"
707+ line="2786">Gets the list of developers of the application.</doc>
708+ <source-position filename="src/adw-about-dialog.h" line="112"/>
674709 <return-value transfer-ownership="none" nullable="1">
675710 <doc xml:space="preserve"
676- filename="src/adw-about-window.c"
677- line="2631">The list of developers</doc>
711+ filename="src/adw-about-dialog.c"
712+ line="2792">The list of developers</doc>
678713 <array c:type="const char* const*">
679714 <type name="utf8"/>
680715 </array>
@@ -682,25 +717,24 @@ See [property@AboutWindow:website].</doc>
682717 <parameters>
683718 <instance-parameter name="self" transfer-ownership="none">
684719 <doc xml:space="preserve"
685- filename="src/adw-about-window.c"
686- line="2627">an about window</doc>
687- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
720+ filename="src/adw-about-dialog.c"
721+ line="2788">an about dialog</doc>
722+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
688723 </instance-parameter>
689724 </parameters>
690725 </method>
691726 <method name="get_documenters"
692- c:identifier="adw_about_window_get_documenters"
727+ c:identifier="adw_about_dialog_get_documenters"
693728 glib:get-property="documenters"
694- version="1.2">
695- <attribute name="org.gtk.Method.get_property" value="documenters"/>
729+ version="1.5">
696730 <doc xml:space="preserve"
697- filename="src/adw-about-window.c"
698- line="2799">Gets the list of documenters of the application.</doc>
699- <source-position filename="src/adw-about-window.h" line="124"/>
731+ filename="src/adw-about-dialog.c"
732+ line="2960">Gets the list of documenters of the application.</doc>
733+ <source-position filename="src/adw-about-dialog.h" line="130"/>
700734 <return-value transfer-ownership="none" nullable="1">
701735 <doc xml:space="preserve"
702- filename="src/adw-about-window.c"
703- line="2805">The list of documenters</doc>
736+ filename="src/adw-about-dialog.c"
737+ line="2966">The list of documenters</doc>
704738 <array c:type="const char* const*">
705739 <type name="utf8"/>
706740 </array>
@@ -708,298 +742,282 @@ See [property@AboutWindow:website].</doc>
708742 <parameters>
709743 <instance-parameter name="self" transfer-ownership="none">
710744 <doc xml:space="preserve"
711- filename="src/adw-about-window.c"
712- line="2801">an about window</doc>
713- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
745+ filename="src/adw-about-dialog.c"
746+ line="2962">an about dialog</doc>
747+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
714748 </instance-parameter>
715749 </parameters>
716750 </method>
717751 <method name="get_issue_url"
718- c:identifier="adw_about_window_get_issue_url"
752+ c:identifier="adw_about_dialog_get_issue_url"
719753 glib:get-property="issue-url"
720- version="1.2">
721- <attribute name="org.gtk.Method.get_property" value="issue-url"/>
754+ version="1.5">
722755 <doc xml:space="preserve"
723- filename="src/adw-about-window.c"
724- line="2428">Gets the issue tracker URL for @self.</doc>
725- <source-position filename="src/adw-about-window.h" line="83"/>
756+ filename="src/adw-about-dialog.c"
757+ line="2594">Gets the issue tracker URL for @self.</doc>
758+ <source-position filename="src/adw-about-dialog.h" line="89"/>
726759 <return-value transfer-ownership="none">
727760 <doc xml:space="preserve"
728- filename="src/adw-about-window.c"
729- line="2434">the issue tracker URL</doc>
761+ filename="src/adw-about-dialog.c"
762+ line="2600">the issue tracker URL</doc>
730763 <type name="utf8" c:type="const char*"/>
731764 </return-value>
732765 <parameters>
733766 <instance-parameter name="self" transfer-ownership="none">
734767 <doc xml:space="preserve"
735- filename="src/adw-about-window.c"
736- line="2430">an about window</doc>
737- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
768+ filename="src/adw-about-dialog.c"
769+ line="2596">an about dialog</doc>
770+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
738771 </instance-parameter>
739772 </parameters>
740773 </method>
741774 <method name="get_license"
742- c:identifier="adw_about_window_get_license"
775+ c:identifier="adw_about_dialog_get_license"
743776 glib:get-property="license"
744- version="1.2">
745- <attribute name="org.gtk.Method.get_property" value="license"/>
777+ version="1.5">
746778 <doc xml:space="preserve"
747- filename="src/adw-about-window.c"
748- line="3123">Gets the license for @self.</doc>
749- <source-position filename="src/adw-about-window.h" line="158"/>
779+ filename="src/adw-about-dialog.c"
780+ line="3276">Gets the license for @self.</doc>
781+ <source-position filename="src/adw-about-dialog.h" line="164"/>
750782 <return-value transfer-ownership="none">
751783 <doc xml:space="preserve"
752- filename="src/adw-about-window.c"
753- line="3129">the license</doc>
784+ filename="src/adw-about-dialog.c"
785+ line="3282">the license</doc>
754786 <type name="utf8" c:type="const char*"/>
755787 </return-value>
756788 <parameters>
757789 <instance-parameter name="self" transfer-ownership="none">
758790 <doc xml:space="preserve"
759- filename="src/adw-about-window.c"
760- line="3125">an about window</doc>
761- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
791+ filename="src/adw-about-dialog.c"
792+ line="3278">an about dialog</doc>
793+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
762794 </instance-parameter>
763795 </parameters>
764796 </method>
765797 <method name="get_license_type"
766- c:identifier="adw_about_window_get_license_type"
798+ c:identifier="adw_about_dialog_get_license_type"
767799 glib:get-property="license-type"
768- version="1.2">
769- <attribute name="org.gtk.Method.get_property" value="license-type"/>
800+ version="1.5">
770801 <doc xml:space="preserve"
771- filename="src/adw-about-window.c"
772- line="3057">Gets the license type for @self.</doc>
773- <source-position filename="src/adw-about-window.h" line="152"/>
802+ filename="src/adw-about-dialog.c"
803+ line="3212">Gets the license type for @self.</doc>
804+ <source-position filename="src/adw-about-dialog.h" line="158"/>
774805 <return-value transfer-ownership="none">
775806 <doc xml:space="preserve"
776- filename="src/adw-about-window.c"
777- line="3063">the license type</doc>
807+ filename="src/adw-about-dialog.c"
808+ line="3218">the license type</doc>
778809 <type name="Gtk.License" c:type="GtkLicense"/>
779810 </return-value>
780811 <parameters>
781812 <instance-parameter name="self" transfer-ownership="none">
782813 <doc xml:space="preserve"
783- filename="src/adw-about-window.c"
784- line="3059">an about window</doc>
785- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
814+ filename="src/adw-about-dialog.c"
815+ line="3214">an about dialog</doc>
816+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
786817 </instance-parameter>
787818 </parameters>
788819 </method>
789820 <method name="get_release_notes"
790- c:identifier="adw_about_window_get_release_notes"
821+ c:identifier="adw_about_dialog_get_release_notes"
791822 glib:get-property="release-notes"
792- version="1.2">
793- <attribute name="org.gtk.Method.get_property" value="release-notes"/>
823+ version="1.5">
794824 <doc xml:space="preserve"
795- filename="src/adw-about-window.c"
796- line="2212">Gets the release notes for @self.</doc>
797- <source-position filename="src/adw-about-window.h" line="59"/>
825+ filename="src/adw-about-dialog.c"
826+ line="2390">Gets the release notes for @self.</doc>
827+ <source-position filename="src/adw-about-dialog.h" line="65"/>
798828 <return-value transfer-ownership="none">
799829 <doc xml:space="preserve"
800- filename="src/adw-about-window.c"
801- line="2218">the release notes</doc>
830+ filename="src/adw-about-dialog.c"
831+ line="2396">the release notes</doc>
802832 <type name="utf8" c:type="const char*"/>
803833 </return-value>
804834 <parameters>
805835 <instance-parameter name="self" transfer-ownership="none">
806836 <doc xml:space="preserve"
807- filename="src/adw-about-window.c"
808- line="2214">an about window</doc>
809- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
837+ filename="src/adw-about-dialog.c"
838+ line="2392">an about dialog</doc>
839+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
810840 </instance-parameter>
811841 </parameters>
812842 </method>
813843 <method name="get_release_notes_version"
814- c:identifier="adw_about_window_get_release_notes_version"
844+ c:identifier="adw_about_dialog_get_release_notes_version"
815845 glib:get-property="release-notes-version"
816- version="1.2">
817- <attribute name="org.gtk.Method.get_property"
818- value="release-notes-version"/>
846+ version="1.5">
819847 <doc xml:space="preserve"
820- filename="src/adw-about-window.c"
821- line="2155">Gets the version described by the application's release notes.</doc>
822- <source-position filename="src/adw-about-window.h" line="53"/>
848+ filename="src/adw-about-dialog.c"
849+ line="2336">Gets the version described by the application's release notes.</doc>
850+ <source-position filename="src/adw-about-dialog.h" line="59"/>
823851 <return-value transfer-ownership="none">
824852 <doc xml:space="preserve"
825- filename="src/adw-about-window.c"
826- line="2161">the release notes version</doc>
853+ filename="src/adw-about-dialog.c"
854+ line="2342">the release notes version</doc>
827855 <type name="utf8" c:type="const char*"/>
828856 </return-value>
829857 <parameters>
830858 <instance-parameter name="self" transfer-ownership="none">
831859 <doc xml:space="preserve"
832- filename="src/adw-about-window.c"
833- line="2157">an about window</doc>
834- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
860+ filename="src/adw-about-dialog.c"
861+ line="2338">an about dialog</doc>
862+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
835863 </instance-parameter>
836864 </parameters>
837865 </method>
838866 <method name="get_support_url"
839- c:identifier="adw_about_window_get_support_url"
867+ c:identifier="adw_about_dialog_get_support_url"
840868 glib:get-property="support-url"
841- version="1.2">
842- <attribute name="org.gtk.Method.get_property" value="support-url"/>
869+ version="1.5">
843870 <doc xml:space="preserve"
844- filename="src/adw-about-window.c"
845- line="2381">Gets the URL of the support page for @self.</doc>
846- <source-position filename="src/adw-about-window.h" line="77"/>
871+ filename="src/adw-about-dialog.c"
872+ line="2550">Gets the URL of the support page for @self.</doc>
873+ <source-position filename="src/adw-about-dialog.h" line="83"/>
847874 <return-value transfer-ownership="none">
848875 <doc xml:space="preserve"
849- filename="src/adw-about-window.c"
850- line="2387">the support page URL</doc>
876+ filename="src/adw-about-dialog.c"
877+ line="2556">the support page URL</doc>
851878 <type name="utf8" c:type="const char*"/>
852879 </return-value>
853880 <parameters>
854881 <instance-parameter name="self" transfer-ownership="none">
855882 <doc xml:space="preserve"
856- filename="src/adw-about-window.c"
857- line="2383">an about window</doc>
858- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
883+ filename="src/adw-about-dialog.c"
884+ line="2552">an about dialog</doc>
885+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
859886 </instance-parameter>
860887 </parameters>
861888 </method>
862889 <method name="get_translator_credits"
863- c:identifier="adw_about_window_get_translator_credits"
890+ c:identifier="adw_about_dialog_get_translator_credits"
864891 glib:get-property="translator-credits"
865- version="1.2">
866- <attribute name="org.gtk.Method.get_property"
867- value="translator-credits"/>
892+ version="1.5">
868893 <doc xml:space="preserve"
869- filename="src/adw-about-window.c"
870- line="2857">Gets the translator credits string.</doc>
871- <source-position filename="src/adw-about-window.h" line="130"/>
894+ filename="src/adw-about-dialog.c"
895+ line="3018">Gets the translator credits string.</doc>
896+ <source-position filename="src/adw-about-dialog.h" line="136"/>
872897 <return-value transfer-ownership="none">
873898 <doc xml:space="preserve"
874- filename="src/adw-about-window.c"
875- line="2863">The translator credits string</doc>
899+ filename="src/adw-about-dialog.c"
900+ line="3024">The translator credits string</doc>
876901 <type name="utf8" c:type="const char*"/>
877902 </return-value>
878903 <parameters>
879904 <instance-parameter name="self" transfer-ownership="none">
880905 <doc xml:space="preserve"
881- filename="src/adw-about-window.c"
882- line="2859">an about window</doc>
883- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
906+ filename="src/adw-about-dialog.c"
907+ line="3020">an about dialog</doc>
908+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
884909 </instance-parameter>
885910 </parameters>
886911 </method>
887912 <method name="get_version"
888- c:identifier="adw_about_window_get_version"
913+ c:identifier="adw_about_dialog_get_version"
889914 glib:get-property="version"
890- version="1.2">
891- <attribute name="org.gtk.Method.get_property" value="version"/>
915+ version="1.5">
892916 <doc xml:space="preserve"
893- filename="src/adw-about-window.c"
894- line="2105">Gets the version for @self.</doc>
895- <source-position filename="src/adw-about-window.h" line="47"/>
917+ filename="src/adw-about-dialog.c"
918+ line="2289">Gets the version for @self.</doc>
919+ <source-position filename="src/adw-about-dialog.h" line="53"/>
896920 <return-value transfer-ownership="none">
897921 <doc xml:space="preserve"
898- filename="src/adw-about-window.c"
899- line="2111">the version</doc>
922+ filename="src/adw-about-dialog.c"
923+ line="2295">the version</doc>
900924 <type name="utf8" c:type="const char*"/>
901925 </return-value>
902926 <parameters>
903927 <instance-parameter name="self" transfer-ownership="none">
904928 <doc xml:space="preserve"
905- filename="src/adw-about-window.c"
906- line="2107">an about window</doc>
907- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
929+ filename="src/adw-about-dialog.c"
930+ line="2291">an about dialog</doc>
931+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
908932 </instance-parameter>
909933 </parameters>
910934 </method>
911935 <method name="get_website"
912- c:identifier="adw_about_window_get_website"
936+ c:identifier="adw_about_dialog_get_website"
913937 glib:get-property="website"
914- version="1.2">
915- <attribute name="org.gtk.Method.get_property" value="website"/>
938+ version="1.5">
916939 <doc xml:space="preserve"
917- filename="src/adw-about-window.c"
918- line="2331">Gets the application website URL for @self.</doc>
919- <source-position filename="src/adw-about-window.h" line="71"/>
940+ filename="src/adw-about-dialog.c"
941+ line="2503">Gets the application website URL for @self.</doc>
942+ <source-position filename="src/adw-about-dialog.h" line="77"/>
920943 <return-value transfer-ownership="none">
921944 <doc xml:space="preserve"
922- filename="src/adw-about-window.c"
923- line="2337">the website URL</doc>
945+ filename="src/adw-about-dialog.c"
946+ line="2509">the website URL</doc>
924947 <type name="utf8" c:type="const char*"/>
925948 </return-value>
926949 <parameters>
927950 <instance-parameter name="self" transfer-ownership="none">
928951 <doc xml:space="preserve"
929- filename="src/adw-about-window.c"
930- line="2333">an about window</doc>
931- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
952+ filename="src/adw-about-dialog.c"
953+ line="2505">an about dialog</doc>
954+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
932955 </instance-parameter>
933956 </parameters>
934957 </method>
935958 <method name="set_application_icon"
936- c:identifier="adw_about_window_set_application_icon"
959+ c:identifier="adw_about_dialog_set_application_icon"
937960 glib:set-property="application-icon"
938- version="1.2">
939- <attribute name="org.gtk.Method.set_property"
940- value="application-icon"/>
961+ version="1.5">
941962 <doc xml:space="preserve"
942- filename="src/adw-about-window.c"
943- line="1974">Sets the name of the application icon for @self.
963+ filename="src/adw-about-dialog.c"
964+ line="2167">Sets the name of the application icon for @self.
944965
945966 The icon is displayed at the top of the main page.</doc>
946- <source-position filename="src/adw-about-window.h" line="37"/>
967+ <source-position filename="src/adw-about-dialog.h" line="43"/>
947968 <return-value transfer-ownership="none">
948969 <type name="none" c:type="void"/>
949970 </return-value>
950971 <parameters>
951972 <instance-parameter name="self" transfer-ownership="none">
952973 <doc xml:space="preserve"
953- filename="src/adw-about-window.c"
954- line="1976">an about window</doc>
955- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
974+ filename="src/adw-about-dialog.c"
975+ line="2169">an about dialog</doc>
976+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
956977 </instance-parameter>
957978 <parameter name="application_icon" transfer-ownership="none">
958979 <doc xml:space="preserve"
959- filename="src/adw-about-window.c"
960- line="1977">the application icon name</doc>
980+ filename="src/adw-about-dialog.c"
981+ line="2170">the application icon name</doc>
961982 <type name="utf8" c:type="const char*"/>
962983 </parameter>
963984 </parameters>
964985 </method>
965986 <method name="set_application_name"
966- c:identifier="adw_about_window_set_application_name"
987+ c:identifier="adw_about_dialog_set_application_name"
967988 glib:set-property="application-name"
968- version="1.2">
969- <attribute name="org.gtk.Method.set_property"
970- value="application-name"/>
989+ version="1.5">
971990 <doc xml:space="preserve"
972- filename="src/adw-about-window.c"
973- line="2022">Sets the application name for @self.
991+ filename="src/adw-about-dialog.c"
992+ line="2212">Sets the application name for @self.
974993
975994 The name is displayed at the top of the main page.</doc>
976- <source-position filename="src/adw-about-window.h" line="31"/>
995+ <source-position filename="src/adw-about-dialog.h" line="37"/>
977996 <return-value transfer-ownership="none">
978997 <type name="none" c:type="void"/>
979998 </return-value>
980999 <parameters>
9811000 <instance-parameter name="self" transfer-ownership="none">
9821001 <doc xml:space="preserve"
983- filename="src/adw-about-window.c"
984- line="2024">an about window</doc>
985- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
1002+ filename="src/adw-about-dialog.c"
1003+ line="2214">an about dialog</doc>
1004+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
9861005 </instance-parameter>
9871006 <parameter name="application_name" transfer-ownership="none">
9881007 <doc xml:space="preserve"
989- filename="src/adw-about-window.c"
990- line="2025">the application name</doc>
1008+ filename="src/adw-about-dialog.c"
1009+ line="2215">the application name</doc>
9911010 <type name="utf8" c:type="const char*"/>
9921011 </parameter>
9931012 </parameters>
9941013 </method>
9951014 <method name="set_artists"
996- c:identifier="adw_about_window_set_artists"
1015+ c:identifier="adw_about_dialog_set_artists"
9971016 glib:set-property="artists"
998- version="1.2">
999- <attribute name="org.gtk.Method.set_property" value="artists"/>
1017+ version="1.5">
10001018 <doc xml:space="preserve"
1001- filename="src/adw-about-window.c"
1002- line="2759">Sets the list of artists of the application.
1019+ filename="src/adw-about-dialog.c"
1020+ line="2920">Sets the list of artists of the application.
10031021
10041022 It will be displayed on the Credits page.
10051023
@@ -1008,30 +1026,30 @@ details.
10081026
10091027 See also:
10101028
1011-* [property@AboutWindow:developers]
1012-* [property@AboutWindow:designers]
1013-* [property@AboutWindow:documenters]
1014-* [property@AboutWindow:translator-credits]
1015-* [method@AboutWindow.add_credit_section]
1016-* [method@AboutWindow.add_acknowledgement_section]</doc>
1017- <source-position filename="src/adw-about-window.h" line="120"/>
1029+* [property@AboutDialog:developers]
1030+* [property@AboutDialog:designers]
1031+* [property@AboutDialog:documenters]
1032+* [property@AboutDialog:translator-credits]
1033+* [method@AboutDialog.add_credit_section]
1034+* [method@AboutDialog.add_acknowledgement_section]</doc>
1035+ <source-position filename="src/adw-about-dialog.h" line="126"/>
10181036 <return-value transfer-ownership="none">
10191037 <type name="none" c:type="void"/>
10201038 </return-value>
10211039 <parameters>
10221040 <instance-parameter name="self" transfer-ownership="none">
10231041 <doc xml:space="preserve"
1024- filename="src/adw-about-window.c"
1025- line="2761">an about window</doc>
1026- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
1042+ filename="src/adw-about-dialog.c"
1043+ line="2922">an about dialog</doc>
1044+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
10271045 </instance-parameter>
10281046 <parameter name="artists"
10291047 transfer-ownership="none"
10301048 nullable="1"
10311049 allow-none="1">
10321050 <doc xml:space="preserve"
1033- filename="src/adw-about-window.c"
1034- line="2762">the list of artists</doc>
1051+ filename="src/adw-about-dialog.c"
1052+ line="2923">the list of artists</doc>
10351053 <array c:type="const char**">
10361054 <type name="utf8" c:type="char*"/>
10371055 </array>
@@ -1039,45 +1057,43 @@ See also:
10391057 </parameters>
10401058 </method>
10411059 <method name="set_comments"
1042- c:identifier="adw_about_window_set_comments"
1060+ c:identifier="adw_about_dialog_set_comments"
10431061 glib:set-property="comments"
1044- version="1.2">
1045- <attribute name="org.gtk.Method.set_property" value="comments"/>
1062+ version="1.5">
10461063 <doc xml:space="preserve"
1047- filename="src/adw-about-window.c"
1048- line="2299">Sets the comments about the application.
1064+ filename="src/adw-about-dialog.c"
1065+ line="2474">Sets the comments about the application.
10491066
10501067 Comments will be shown on the Details page, above links.
10511068
10521069 Unlike [property@Gtk.AboutDialog:comments], this string can be long and
10531070 detailed. It can also contain links and Pango markup.</doc>
1054- <source-position filename="src/adw-about-window.h" line="67"/>
1071+ <source-position filename="src/adw-about-dialog.h" line="73"/>
10551072 <return-value transfer-ownership="none">
10561073 <type name="none" c:type="void"/>
10571074 </return-value>
10581075 <parameters>
10591076 <instance-parameter name="self" transfer-ownership="none">
10601077 <doc xml:space="preserve"
1061- filename="src/adw-about-window.c"
1062- line="2301">an about window</doc>
1063- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
1078+ filename="src/adw-about-dialog.c"
1079+ line="2476">an about dialog</doc>
1080+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
10641081 </instance-parameter>
10651082 <parameter name="comments" transfer-ownership="none">
10661083 <doc xml:space="preserve"
1067- filename="src/adw-about-window.c"
1068- line="2302">the comments</doc>
1084+ filename="src/adw-about-dialog.c"
1085+ line="2477">the comments</doc>
10691086 <type name="utf8" c:type="const char*"/>
10701087 </parameter>
10711088 </parameters>
10721089 </method>
10731090 <method name="set_copyright"
1074- c:identifier="adw_about_window_set_copyright"
1091+ c:identifier="adw_about_dialog_set_copyright"
10751092 glib:set-property="copyright"
1076- version="1.2">
1077- <attribute name="org.gtk.Method.set_property" value="copyright"/>
1093+ version="1.5">
10781094 <doc xml:space="preserve"
1079- filename="src/adw-about-window.c"
1080- line="3021">Sets the copyright information for @self.
1095+ filename="src/adw-about-dialog.c"
1096+ line="3179">Sets the copyright information for @self.
10811097
10821098 This should be a short string of one or two lines, for example:
10831099 `© 2022 Example`.
@@ -1085,104 +1101,101 @@ This should be a short string of one or two lines, for example:
10851101 The copyright information will be displayed on the Legal page, before the
10861102 application license.
10871103
1088-[method@AboutWindow.add_legal_section] can be used to add copyright
1104+[method@AboutDialog.add_legal_section] can be used to add copyright
10891105 information for the application dependencies or other components.</doc>
1090- <source-position filename="src/adw-about-window.h" line="148"/>
1106+ <source-position filename="src/adw-about-dialog.h" line="154"/>
10911107 <return-value transfer-ownership="none">
10921108 <type name="none" c:type="void"/>
10931109 </return-value>
10941110 <parameters>
10951111 <instance-parameter name="self" transfer-ownership="none">
10961112 <doc xml:space="preserve"
1097- filename="src/adw-about-window.c"
1098- line="3023">an about window</doc>
1099- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
1113+ filename="src/adw-about-dialog.c"
1114+ line="3181">an about dialog</doc>
1115+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
11001116 </instance-parameter>
11011117 <parameter name="copyright" transfer-ownership="none">
11021118 <doc xml:space="preserve"
1103- filename="src/adw-about-window.c"
1104- line="3024">the copyright information</doc>
1119+ filename="src/adw-about-dialog.c"
1120+ line="3182">the copyright information</doc>
11051121 <type name="utf8" c:type="const char*"/>
11061122 </parameter>
11071123 </parameters>
11081124 </method>
11091125 <method name="set_debug_info"
1110- c:identifier="adw_about_window_set_debug_info"
1126+ c:identifier="adw_about_dialog_set_debug_info"
11111127 glib:set-property="debug-info"
1112- version="1.2">
1113- <attribute name="org.gtk.Method.set_property" value="debug-info"/>
1128+ version="1.5">
11141129 <doc xml:space="preserve"
1115- filename="src/adw-about-window.c"
1116- line="2540">Sets the debug information for @self.
1130+ filename="src/adw-about-dialog.c"
1131+ line="2707">Sets the debug information for @self.
11171132
11181133 Debug information will be shown on the Troubleshooting page. It's intended
11191134 to be attached to issue reports when reporting issues against the
11201135 application.
11211136
1122-`AdwAboutWindow` provides a quick way to save debug information to a file.
1123-When saving, [property@AboutWindow:debug-info-filename] would be used as
1137+`AdwAboutDialog` provides a quick way to save debug information to a file.
1138+When saving, [property@AboutDialog:debug-info-filename] would be used as
11241139 the suggested filename.
11251140
11261141 Debug information cannot contain markup or links.</doc>
1127- <source-position filename="src/adw-about-window.h" line="96"/>
1142+ <source-position filename="src/adw-about-dialog.h" line="102"/>
11281143 <return-value transfer-ownership="none">
11291144 <type name="none" c:type="void"/>
11301145 </return-value>
11311146 <parameters>
11321147 <instance-parameter name="self" transfer-ownership="none">
11331148 <doc xml:space="preserve"
1134- filename="src/adw-about-window.c"
1135- line="2542">an about window</doc>
1136- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
1149+ filename="src/adw-about-dialog.c"
1150+ line="2709">an about dialog</doc>
1151+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
11371152 </instance-parameter>
11381153 <parameter name="debug_info" transfer-ownership="none">
11391154 <doc xml:space="preserve"
1140- filename="src/adw-about-window.c"
1141- line="2543">the debug information</doc>
1155+ filename="src/adw-about-dialog.c"
1156+ line="2710">the debug information</doc>
11421157 <type name="utf8" c:type="const char*"/>
11431158 </parameter>
11441159 </parameters>
11451160 </method>
11461161 <method name="set_debug_info_filename"
1147- c:identifier="adw_about_window_set_debug_info_filename"
1162+ c:identifier="adw_about_dialog_set_debug_info_filename"
11481163 glib:set-property="debug-info-filename"
1149- version="1.2">
1150- <attribute name="org.gtk.Method.set_property" value="debug-info"/>
1164+ version="1.5">
11511165 <doc xml:space="preserve"
1152- filename="src/adw-about-window.c"
1153- line="2595">Sets the debug information filename for @self.
1166+ filename="src/adw-about-dialog.c"
1167+ line="2759">Sets the debug information filename for @self.
11541168
11551169 It will be used as the suggested filename when saving debug information to a
11561170 file.
11571171
1158-See [property@AboutWindow:debug-info].</doc>
1159- <source-position filename="src/adw-about-window.h" line="102"/>
1172+See [property@AboutDialog:debug-info].</doc>
1173+ <source-position filename="src/adw-about-dialog.h" line="108"/>
11601174 <return-value transfer-ownership="none">
11611175 <type name="none" c:type="void"/>
11621176 </return-value>
11631177 <parameters>
11641178 <instance-parameter name="self" transfer-ownership="none">
11651179 <doc xml:space="preserve"
1166- filename="src/adw-about-window.c"
1167- line="2597">an about window</doc>
1168- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
1180+ filename="src/adw-about-dialog.c"
1181+ line="2761">an about dialog</doc>
1182+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
11691183 </instance-parameter>
11701184 <parameter name="filename" transfer-ownership="none">
11711185 <doc xml:space="preserve"
1172- filename="src/adw-about-window.c"
1173- line="2598">the debug info filename</doc>
1186+ filename="src/adw-about-dialog.c"
1187+ line="2762">the debug info filename</doc>
11741188 <type name="utf8" c:type="const char*"/>
11751189 </parameter>
11761190 </parameters>
11771191 </method>
11781192 <method name="set_designers"
1179- c:identifier="adw_about_window_set_designers"
1193+ c:identifier="adw_about_dialog_set_designers"
11801194 glib:set-property="designers"
1181- version="1.2">
1182- <attribute name="org.gtk.Method.set_property" value="designers"/>
1195+ version="1.5">
11831196 <doc xml:space="preserve"
1184- filename="src/adw-about-window.c"
1185- line="2701">Sets the list of designers of the application.
1197+ filename="src/adw-about-dialog.c"
1198+ line="2862">Sets the list of designers of the application.
11861199
11871200 It will be displayed on the Credits page.
11881201
@@ -1191,30 +1204,30 @@ details.
11911204
11921205 See also:
11931206
1194-* [property@AboutWindow:developers]
1195-* [property@AboutWindow:artists]
1196-* [property@AboutWindow:documenters]
1197-* [property@AboutWindow:translator-credits]
1198-* [method@AboutWindow.add_credit_section]
1199-* [method@AboutWindow.add_acknowledgement_section]</doc>
1200- <source-position filename="src/adw-about-window.h" line="114"/>
1207+* [property@AboutDialog:developers]
1208+* [property@AboutDialog:artists]
1209+* [property@AboutDialog:documenters]
1210+* [property@AboutDialog:translator-credits]
1211+* [method@AboutDialog.add_credit_section]
1212+* [method@AboutDialog.add_acknowledgement_section]</doc>
1213+ <source-position filename="src/adw-about-dialog.h" line="120"/>
12011214 <return-value transfer-ownership="none">
12021215 <type name="none" c:type="void"/>
12031216 </return-value>
12041217 <parameters>
12051218 <instance-parameter name="self" transfer-ownership="none">
12061219 <doc xml:space="preserve"
1207- filename="src/adw-about-window.c"
1208- line="2703">an about window</doc>
1209- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
1220+ filename="src/adw-about-dialog.c"
1221+ line="2864">an about dialog</doc>
1222+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
12101223 </instance-parameter>
12111224 <parameter name="designers"
12121225 transfer-ownership="none"
12131226 nullable="1"
12141227 allow-none="1">
12151228 <doc xml:space="preserve"
1216- filename="src/adw-about-window.c"
1217- line="2704">the list of designers</doc>
1229+ filename="src/adw-about-dialog.c"
1230+ line="2865">the list of designers</doc>
12181231 <array c:type="const char**">
12191232 <type name="utf8" c:type="char*"/>
12201233 </array>
@@ -1222,47 +1235,45 @@ See also:
12221235 </parameters>
12231236 </method>
12241237 <method name="set_developer_name"
1225- c:identifier="adw_about_window_set_developer_name"
1238+ c:identifier="adw_about_dialog_set_developer_name"
12261239 glib:set-property="developer-name"
1227- version="1.2">
1228- <attribute name="org.gtk.Method.set_property" value="developer-name"/>
1240+ version="1.5">
12291241 <doc xml:space="preserve"
1230- filename="src/adw-about-window.c"
1231- line="2070">Sets the developer name for @self.
1242+ filename="src/adw-about-dialog.c"
1243+ line="2257">Sets the developer name for @self.
12321244
12331245 The developer name is displayed on the main page, under the application name.
12341246
12351247 If the application is developed by multiple people, the developer name can be
12361248 set to values like "AppName team", "AppName developers" or
12371249 "The AppName project", and the individual contributors can be listed on the
1238-Credits page, with [property@AboutWindow:developers] and related properties.</doc>
1239- <source-position filename="src/adw-about-window.h" line="43"/>
1250+Credits page, with [property@AboutDialog:developers] and related properties.</doc>
1251+ <source-position filename="src/adw-about-dialog.h" line="49"/>
12401252 <return-value transfer-ownership="none">
12411253 <type name="none" c:type="void"/>
12421254 </return-value>
12431255 <parameters>
12441256 <instance-parameter name="self" transfer-ownership="none">
12451257 <doc xml:space="preserve"
1246- filename="src/adw-about-window.c"
1247- line="2072">an about window</doc>
1248- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
1258+ filename="src/adw-about-dialog.c"
1259+ line="2259">an about dialog</doc>
1260+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
12491261 </instance-parameter>
12501262 <parameter name="developer_name" transfer-ownership="none">
12511263 <doc xml:space="preserve"
1252- filename="src/adw-about-window.c"
1253- line="2073">the developer name</doc>
1264+ filename="src/adw-about-dialog.c"
1265+ line="2260">the developer name</doc>
12541266 <type name="utf8" c:type="const char*"/>
12551267 </parameter>
12561268 </parameters>
12571269 </method>
12581270 <method name="set_developers"
1259- c:identifier="adw_about_window_set_developers"
1271+ c:identifier="adw_about_dialog_set_developers"
12601272 glib:set-property="developers"
1261- version="1.2">
1262- <attribute name="org.gtk.Method.set_property" value="developers"/>
1273+ version="1.5">
12631274 <doc xml:space="preserve"
1264- filename="src/adw-about-window.c"
1265- line="2643">Sets the list of developers of the application.
1275+ filename="src/adw-about-dialog.c"
1276+ line="2804">Sets the list of developers of the application.
12661277
12671278 It will be displayed on the Credits page.
12681279
@@ -1271,30 +1282,30 @@ details.
12711282
12721283 See also:
12731284
1274-* [property@AboutWindow:designers]
1275-* [property@AboutWindow:artists]
1276-* [property@AboutWindow:documenters]
1277-* [property@AboutWindow:translator-credits]
1278-* [method@AboutWindow.add_credit_section]
1279-* [method@AboutWindow.add_acknowledgement_section]</doc>
1280- <source-position filename="src/adw-about-window.h" line="108"/>
1285+* [property@AboutDialog:designers]
1286+* [property@AboutDialog:artists]
1287+* [property@AboutDialog:documenters]
1288+* [property@AboutDialog:translator-credits]
1289+* [method@AboutDialog.add_credit_section]
1290+* [method@AboutDialog.add_acknowledgement_section]</doc>
1291+ <source-position filename="src/adw-about-dialog.h" line="114"/>
12811292 <return-value transfer-ownership="none">
12821293 <type name="none" c:type="void"/>
12831294 </return-value>
12841295 <parameters>
12851296 <instance-parameter name="self" transfer-ownership="none">
12861297 <doc xml:space="preserve"
1287- filename="src/adw-about-window.c"
1288- line="2645">an about window</doc>
1289- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
1298+ filename="src/adw-about-dialog.c"
1299+ line="2806">an about dialog</doc>
1300+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
12901301 </instance-parameter>
12911302 <parameter name="developers"
12921303 transfer-ownership="none"
12931304 nullable="1"
12941305 allow-none="1">
12951306 <doc xml:space="preserve"
1296- filename="src/adw-about-window.c"
1297- line="2646">the list of developers</doc>
1307+ filename="src/adw-about-dialog.c"
1308+ line="2807">the list of developers</doc>
12981309 <array c:type="const char**">
12991310 <type name="utf8" c:type="char*"/>
13001311 </array>
@@ -1302,13 +1313,12 @@ See also:
13021313 </parameters>
13031314 </method>
13041315 <method name="set_documenters"
1305- c:identifier="adw_about_window_set_documenters"
1316+ c:identifier="adw_about_dialog_set_documenters"
13061317 glib:set-property="documenters"
1307- version="1.2">
1308- <attribute name="org.gtk.Method.set_property" value="documenters"/>
1318+ version="1.5">
13091319 <doc xml:space="preserve"
1310- filename="src/adw-about-window.c"
1311- line="2817">Sets the list of documenters of the application.
1320+ filename="src/adw-about-dialog.c"
1321+ line="2978">Sets the list of documenters of the application.
13121322
13131323 It will be displayed on the Credits page.
13141324
@@ -1317,30 +1327,30 @@ details.
13171327
13181328 See also:
13191329
1320-* [property@AboutWindow:developers]
1321-* [property@AboutWindow:designers]
1322-* [property@AboutWindow:artists]
1323-* [property@AboutWindow:translator-credits]
1324-* [method@AboutWindow.add_credit_section]
1325-* [method@AboutWindow.add_acknowledgement_section]</doc>
1326- <source-position filename="src/adw-about-window.h" line="126"/>
1330+* [property@AboutDialog:developers]
1331+* [property@AboutDialog:designers]
1332+* [property@AboutDialog:artists]
1333+* [property@AboutDialog:translator-credits]
1334+* [method@AboutDialog.add_credit_section]
1335+* [method@AboutDialog.add_acknowledgement_section]</doc>
1336+ <source-position filename="src/adw-about-dialog.h" line="132"/>
13271337 <return-value transfer-ownership="none">
13281338 <type name="none" c:type="void"/>
13291339 </return-value>
13301340 <parameters>
13311341 <instance-parameter name="self" transfer-ownership="none">
13321342 <doc xml:space="preserve"
1333- filename="src/adw-about-window.c"
1334- line="2819">an about window</doc>
1335- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
1343+ filename="src/adw-about-dialog.c"
1344+ line="2980">an about dialog</doc>
1345+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
13361346 </instance-parameter>
13371347 <parameter name="documenters"
13381348 transfer-ownership="none"
13391349 nullable="1"
13401350 allow-none="1">
13411351 <doc xml:space="preserve"
1342- filename="src/adw-about-window.c"
1343- line="2820">the list of documenters</doc>
1352+ filename="src/adw-about-dialog.c"
1353+ line="2981">the list of documenters</doc>
13441354 <array c:type="const char**">
13451355 <type name="utf8" c:type="char*"/>
13461356 </array>
@@ -1348,47 +1358,45 @@ See also:
13481358 </parameters>
13491359 </method>
13501360 <method name="set_issue_url"
1351- c:identifier="adw_about_window_set_issue_url"
1361+ c:identifier="adw_about_dialog_set_issue_url"
13521362 glib:set-property="issue-url"
1353- version="1.2">
1354- <attribute name="org.gtk.Method.set_property" value="issue-url"/>
1363+ version="1.5">
13551364 <doc xml:space="preserve"
1356- filename="src/adw-about-window.c"
1357- line="2446">Sets the issue tracker URL for @self.
1365+ filename="src/adw-about-dialog.c"
1366+ line="2612">Sets the issue tracker URL for @self.
13581367
13591368 The issue tracker link is displayed on the main page.</doc>
1360- <source-position filename="src/adw-about-window.h" line="85"/>
1369+ <source-position filename="src/adw-about-dialog.h" line="91"/>
13611370 <return-value transfer-ownership="none">
13621371 <type name="none" c:type="void"/>
13631372 </return-value>
13641373 <parameters>
13651374 <instance-parameter name="self" transfer-ownership="none">
13661375 <doc xml:space="preserve"
1367- filename="src/adw-about-window.c"
1368- line="2448">an about window</doc>
1369- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
1376+ filename="src/adw-about-dialog.c"
1377+ line="2614">an about dialog</doc>
1378+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
13701379 </instance-parameter>
13711380 <parameter name="issue_url" transfer-ownership="none">
13721381 <doc xml:space="preserve"
1373- filename="src/adw-about-window.c"
1374- line="2449">the issue tracker URL</doc>
1382+ filename="src/adw-about-dialog.c"
1383+ line="2615">the issue tracker URL</doc>
13751384 <type name="utf8" c:type="const char*"/>
13761385 </parameter>
13771386 </parameters>
13781387 </method>
13791388 <method name="set_license"
1380- c:identifier="adw_about_window_set_license"
1389+ c:identifier="adw_about_dialog_set_license"
13811390 glib:set-property="license"
1382- version="1.2">
1383- <attribute name="org.gtk.Method.set_property" value="license"/>
1391+ version="1.5">
13841392 <doc xml:space="preserve"
1385- filename="src/adw-about-window.c"
1386- line="3141">Sets the license for @self.
1393+ filename="src/adw-about-dialog.c"
1394+ line="3294">Sets the license for @self.
13871395
13881396 This can be used to set a custom text for the license if it can't be set via
1389-[property@AboutWindow:license-type].
1397+[property@AboutDialog:license-type].
13901398
1391-When set, [property@AboutWindow:license-type] will be set to
1399+When set, [property@AboutDialog:license-type] will be set to
13921400 `GTK_LICENSE_CUSTOM`.
13931401
13941402 The license text will be displayed on the Legal page, below the copyright
@@ -1396,77 +1404,75 @@ information.
13961404
13971405 License text can contain Pango markup and links.
13981406
1399-[method@AboutWindow.add_legal_section] can be used to add license information
1407+[method@AboutDialog.add_legal_section] can be used to add license information
14001408 for the application dependencies or other components.</doc>
1401- <source-position filename="src/adw-about-window.h" line="160"/>
1409+ <source-position filename="src/adw-about-dialog.h" line="166"/>
14021410 <return-value transfer-ownership="none">
14031411 <type name="none" c:type="void"/>
14041412 </return-value>
14051413 <parameters>
14061414 <instance-parameter name="self" transfer-ownership="none">
14071415 <doc xml:space="preserve"
1408- filename="src/adw-about-window.c"
1409- line="3143">an about window</doc>
1410- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
1416+ filename="src/adw-about-dialog.c"
1417+ line="3296">an about dialog</doc>
1418+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
14111419 </instance-parameter>
14121420 <parameter name="license" transfer-ownership="none">
14131421 <doc xml:space="preserve"
1414- filename="src/adw-about-window.c"
1415- line="3144">the license</doc>
1422+ filename="src/adw-about-dialog.c"
1423+ line="3297">the license</doc>
14161424 <type name="utf8" c:type="const char*"/>
14171425 </parameter>
14181426 </parameters>
14191427 </method>
14201428 <method name="set_license_type"
1421- c:identifier="adw_about_window_set_license_type"
1429+ c:identifier="adw_about_dialog_set_license_type"
14221430 glib:set-property="license-type"
1423- version="1.2">
1424- <attribute name="org.gtk.Method.set_property" value="license-type"/>
1431+ version="1.5">
14251432 <doc xml:space="preserve"
1426- filename="src/adw-about-window.c"
1427- line="3075">Sets the license for @self from a list of known licenses.
1433+ filename="src/adw-about-dialog.c"
1434+ line="3230">Sets the license for @self from a list of known licenses.
14281435
14291436 If the application's license is not in the list,
1430-[property@AboutWindow:license] can be used instead. The license type will be
1437+[property@AboutDialog:license] can be used instead. The license type will be
14311438 automatically set to `GTK_LICENSE_CUSTOM` in that case.
14321439
14331440 If @license_type is `GTK_LICENSE_UNKNOWN`, no information will be displayed.
14341441
14351442 If @license_type is different from `GTK_LICENSE_CUSTOM`.
1436-[property@AboutWindow:license] will be cleared out.
1443+[property@AboutDialog:license] will be cleared out.
14371444
14381445 The license description will be displayed on the Legal page, below the
14391446 copyright information.
14401447
1441-[method@AboutWindow.add_legal_section] can be used to add license information
1448+[method@AboutDialog.add_legal_section] can be used to add license information
14421449 for the application dependencies or other components.</doc>
1443- <source-position filename="src/adw-about-window.h" line="154"/>
1450+ <source-position filename="src/adw-about-dialog.h" line="160"/>
14441451 <return-value transfer-ownership="none">
14451452 <type name="none" c:type="void"/>
14461453 </return-value>
14471454 <parameters>
14481455 <instance-parameter name="self" transfer-ownership="none">
14491456 <doc xml:space="preserve"
1450- filename="src/adw-about-window.c"
1451- line="3077">an about window</doc>
1452- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
1457+ filename="src/adw-about-dialog.c"
1458+ line="3232">an about dialog</doc>
1459+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
14531460 </instance-parameter>
14541461 <parameter name="license_type" transfer-ownership="none">
14551462 <doc xml:space="preserve"
1456- filename="src/adw-about-window.c"
1457- line="3078">the license type</doc>
1463+ filename="src/adw-about-dialog.c"
1464+ line="3233">the license type</doc>
14581465 <type name="Gtk.License" c:type="GtkLicense"/>
14591466 </parameter>
14601467 </parameters>
14611468 </method>
14621469 <method name="set_release_notes"
1463- c:identifier="adw_about_window_set_release_notes"
1470+ c:identifier="adw_about_dialog_set_release_notes"
14641471 glib:set-property="release-notes"
1465- version="1.2">
1466- <attribute name="org.gtk.Method.set_property" value="release-notes"/>
1472+ version="1.5">
14671473 <doc xml:space="preserve"
1468- filename="src/adw-about-window.c"
1469- line="2230">Sets the release notes for @self.
1474+ filename="src/adw-about-dialog.c"
1475+ line="2408">Sets the release notes for @self.
14701476
14711477 Release notes are displayed on the the What's New page.
14721478
@@ -1487,105 +1493,100 @@ Any text outside paragraphs or list items is ignored.
14871493
14881494 Nested lists are not supported.
14891495
1490-`AdwAboutWindow` displays the version above the release notes. If set, the
1491-[property@AboutWindow:release-notes-version] of the property will be used
1492-as the version; otherwise, [property@AboutWindow:version] is used.</doc>
1493- <source-position filename="src/adw-about-window.h" line="61"/>
1496+`AdwAboutDialog` displays the version above the release notes. If set, the
1497+[property@AboutDialog:release-notes-version] of the property will be used
1498+as the version; otherwise, [property@AboutDialog:version] is used.</doc>
1499+ <source-position filename="src/adw-about-dialog.h" line="67"/>
14941500 <return-value transfer-ownership="none">
14951501 <type name="none" c:type="void"/>
14961502 </return-value>
14971503 <parameters>
14981504 <instance-parameter name="self" transfer-ownership="none">
14991505 <doc xml:space="preserve"
1500- filename="src/adw-about-window.c"
1501- line="2232">an about window</doc>
1502- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
1506+ filename="src/adw-about-dialog.c"
1507+ line="2410">an about dialog</doc>
1508+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
15031509 </instance-parameter>
15041510 <parameter name="release_notes" transfer-ownership="none">
15051511 <doc xml:space="preserve"
1506- filename="src/adw-about-window.c"
1507- line="2233">the release notes</doc>
1512+ filename="src/adw-about-dialog.c"
1513+ line="2411">the release notes</doc>
15081514 <type name="utf8" c:type="const char*"/>
15091515 </parameter>
15101516 </parameters>
15111517 </method>
15121518 <method name="set_release_notes_version"
1513- c:identifier="adw_about_window_set_release_notes_version"
1519+ c:identifier="adw_about_dialog_set_release_notes_version"
15141520 glib:set-property="release-notes-version"
1515- version="1.2">
1516- <attribute name="org.gtk.Method.set_property"
1517- value="release-notes-version"/>
1521+ version="1.5">
15181522 <doc xml:space="preserve"
1519- filename="src/adw-about-window.c"
1520- line="2173">Sets the version described by the application's release notes.
1523+ filename="src/adw-about-dialog.c"
1524+ line="2354">Sets the version described by the application's release notes.
15211525
15221526 The release notes version is displayed on the What's New page, above the
15231527 release notes.
15241528
1525-If not set, [property@AboutWindow:version] will be used instead.
1529+If not set, [property@AboutDialog:version] will be used instead.
15261530
15271531 For example, an application with the current version 2.0.2 might want to
15281532 keep the release notes from 2.0.0, and set the release notes version
15291533 accordingly.
15301534
1531-See [property@AboutWindow:release-notes].</doc>
1532- <source-position filename="src/adw-about-window.h" line="55"/>
1535+See [property@AboutDialog:release-notes].</doc>
1536+ <source-position filename="src/adw-about-dialog.h" line="61"/>
15331537 <return-value transfer-ownership="none">
15341538 <type name="none" c:type="void"/>
15351539 </return-value>
15361540 <parameters>
15371541 <instance-parameter name="self" transfer-ownership="none">
15381542 <doc xml:space="preserve"
1539- filename="src/adw-about-window.c"
1540- line="2175">an about window</doc>
1541- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
1543+ filename="src/adw-about-dialog.c"
1544+ line="2356">an about dialog</doc>
1545+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
15421546 </instance-parameter>
15431547 <parameter name="version" transfer-ownership="none">
15441548 <doc xml:space="preserve"
1545- filename="src/adw-about-window.c"
1546- line="2176">the release notes version</doc>
1549+ filename="src/adw-about-dialog.c"
1550+ line="2357">the release notes version</doc>
15471551 <type name="utf8" c:type="const char*"/>
15481552 </parameter>
15491553 </parameters>
15501554 </method>
15511555 <method name="set_support_url"
1552- c:identifier="adw_about_window_set_support_url"
1556+ c:identifier="adw_about_dialog_set_support_url"
15531557 glib:set-property="support-url"
1554- version="1.2">
1555- <attribute name="org.gtk.Method.set_property" value="support-url"/>
1558+ version="1.5">
15561559 <doc xml:space="preserve"
1557- filename="src/adw-about-window.c"
1558- line="2399">Sets the URL of the support page for @self.
1560+ filename="src/adw-about-dialog.c"
1561+ line="2568">Sets the URL of the support page for @self.
15591562
15601563 The support page link is displayed on the main page.</doc>
1561- <source-position filename="src/adw-about-window.h" line="79"/>
1564+ <source-position filename="src/adw-about-dialog.h" line="85"/>
15621565 <return-value transfer-ownership="none">
15631566 <type name="none" c:type="void"/>
15641567 </return-value>
15651568 <parameters>
15661569 <instance-parameter name="self" transfer-ownership="none">
15671570 <doc xml:space="preserve"
1568- filename="src/adw-about-window.c"
1569- line="2401">an about window</doc>
1570- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
1571+ filename="src/adw-about-dialog.c"
1572+ line="2570">an about dialog</doc>
1573+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
15711574 </instance-parameter>
15721575 <parameter name="support_url" transfer-ownership="none">
15731576 <doc xml:space="preserve"
1574- filename="src/adw-about-window.c"
1575- line="2402">the support page URL</doc>
1577+ filename="src/adw-about-dialog.c"
1578+ line="2571">the support page URL</doc>
15761579 <type name="utf8" c:type="const char*"/>
15771580 </parameter>
15781581 </parameters>
15791582 </method>
15801583 <method name="set_translator_credits"
1581- c:identifier="adw_about_window_set_translator_credits"
1584+ c:identifier="adw_about_dialog_set_translator_credits"
15821585 glib:set-property="translator-credits"
1583- version="1.2">
1584- <attribute name="org.gtk.Method.set_property"
1585- value="translator-credits"/>
1586+ version="1.5">
15861587 <doc xml:space="preserve"
1587- filename="src/adw-about-window.c"
1588- line="2875">Sets the translator credits string.
1588+ filename="src/adw-about-dialog.c"
1589+ line="3036">Sets the translator credits string.
15891590
15901591 It will be displayed on the Credits page.
15911592
@@ -1597,142 +1598,128 @@ more details.
15971598
15981599 See also:
15991600
1600-* [property@AboutWindow:developers]
1601-* [property@AboutWindow:designers]
1602-* [property@AboutWindow:artists]
1603-* [property@AboutWindow:documenters]
1604-* [method@AboutWindow.add_credit_section]
1605-* [method@AboutWindow.add_acknowledgement_section]</doc>
1606- <source-position filename="src/adw-about-window.h" line="132"/>
1601+* [property@AboutDialog:developers]
1602+* [property@AboutDialog:designers]
1603+* [property@AboutDialog:artists]
1604+* [property@AboutDialog:documenters]
1605+* [method@AboutDialog.add_credit_section]
1606+* [method@AboutDialog.add_acknowledgement_section]</doc>
1607+ <source-position filename="src/adw-about-dialog.h" line="138"/>
16071608 <return-value transfer-ownership="none">
16081609 <type name="none" c:type="void"/>
16091610 </return-value>
16101611 <parameters>
16111612 <instance-parameter name="self" transfer-ownership="none">
16121613 <doc xml:space="preserve"
1613- filename="src/adw-about-window.c"
1614- line="2877">an about window</doc>
1615- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
1614+ filename="src/adw-about-dialog.c"
1615+ line="3038">an about dialog</doc>
1616+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
16161617 </instance-parameter>
16171618 <parameter name="translator_credits" transfer-ownership="none">
16181619 <doc xml:space="preserve"
1619- filename="src/adw-about-window.c"
1620- line="2878">the translator credits</doc>
1620+ filename="src/adw-about-dialog.c"
1621+ line="3039">the translator credits</doc>
16211622 <type name="utf8" c:type="const char*"/>
16221623 </parameter>
16231624 </parameters>
16241625 </method>
16251626 <method name="set_version"
1626- c:identifier="adw_about_window_set_version"
1627+ c:identifier="adw_about_dialog_set_version"
16271628 glib:set-property="version"
1628- version="1.2">
1629- <attribute name="org.gtk.Method.set_property" value="version"/>
1629+ version="1.5">
16301630 <doc xml:space="preserve"
1631- filename="src/adw-about-window.c"
1632- line="2123">Sets the version for @self.
1631+ filename="src/adw-about-dialog.c"
1632+ line="2307">Sets the version for @self.
16331633
16341634 The version is displayed on the main page.
16351635
1636-If [property@AboutWindow:release-notes-version] is not set, the version will
1636+If [property@AboutDialog:release-notes-version] is not set, the version will
16371637 also be displayed above the release notes on the What's New page.</doc>
1638- <source-position filename="src/adw-about-window.h" line="49"/>
1638+ <source-position filename="src/adw-about-dialog.h" line="55"/>
16391639 <return-value transfer-ownership="none">
16401640 <type name="none" c:type="void"/>
16411641 </return-value>
16421642 <parameters>
16431643 <instance-parameter name="self" transfer-ownership="none">
16441644 <doc xml:space="preserve"
1645- filename="src/adw-about-window.c"
1646- line="2125">an about window</doc>
1647- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
1645+ filename="src/adw-about-dialog.c"
1646+ line="2309">an about dialog</doc>
1647+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
16481648 </instance-parameter>
16491649 <parameter name="version" transfer-ownership="none">
16501650 <doc xml:space="preserve"
1651- filename="src/adw-about-window.c"
1652- line="2126">the version</doc>
1651+ filename="src/adw-about-dialog.c"
1652+ line="2310">the version</doc>
16531653 <type name="utf8" c:type="const char*"/>
16541654 </parameter>
16551655 </parameters>
16561656 </method>
16571657 <method name="set_website"
1658- c:identifier="adw_about_window_set_website"
1658+ c:identifier="adw_about_dialog_set_website"
16591659 glib:set-property="website"
1660- version="1.2">
1661- <attribute name="org.gtk.Method.set_property" value="website"/>
1660+ version="1.5">
16621661 <doc xml:space="preserve"
1663- filename="src/adw-about-window.c"
1664- line="2349">Sets the application website URL for @self.
1662+ filename="src/adw-about-dialog.c"
1663+ line="2521">Sets the application website URL for @self.
16651664
16661665 Website is displayed on the Details page, below comments, or on the main page
16671666 if the Details page doesn't have any other content.
16681667
1669-Applications can add other links below, see [method@AboutWindow.add_link].</doc>
1670- <source-position filename="src/adw-about-window.h" line="73"/>
1668+Applications can add other links below, see [method@AboutDialog.add_link].</doc>
1669+ <source-position filename="src/adw-about-dialog.h" line="79"/>
16711670 <return-value transfer-ownership="none">
16721671 <type name="none" c:type="void"/>
16731672 </return-value>
16741673 <parameters>
16751674 <instance-parameter name="self" transfer-ownership="none">
16761675 <doc xml:space="preserve"
1677- filename="src/adw-about-window.c"
1678- line="2351">an about window</doc>
1679- <type name="AboutWindow" c:type="AdwAboutWindow*"/>
1676+ filename="src/adw-about-dialog.c"
1677+ line="2523">an about dialog</doc>
1678+ <type name="AboutDialog" c:type="AdwAboutDialog*"/>
16801679 </instance-parameter>
16811680 <parameter name="website" transfer-ownership="none">
16821681 <doc xml:space="preserve"
1683- filename="src/adw-about-window.c"
1684- line="2352">the website URL</doc>
1682+ filename="src/adw-about-dialog.c"
1683+ line="2524">the website URL</doc>
16851684 <type name="utf8" c:type="const char*"/>
16861685 </parameter>
16871686 </parameters>
16881687 </method>
16891688 <property name="application-icon"
1690- version="1.2"
1689+ version="1.5"
16911690 writable="1"
16921691 transfer-ownership="none"
16931692 setter="set_application_icon"
16941693 getter="get_application_icon">
1695- <attribute name="org.gtk.Property.get"
1696- value="adw_about_window_get_application_icon"/>
1697- <attribute name="org.gtk.Property.set"
1698- value="adw_about_window_set_application_icon"/>
16991694 <doc xml:space="preserve"
1700- filename="src/adw-about-window.c"
1701- line="1372">The name of the application icon.
1695+ filename="src/adw-about-dialog.c"
1696+ line="1387">The name of the application icon.
17021697
17031698 The icon is displayed at the top of the main page.</doc>
17041699 <type name="utf8" c:type="gchar*"/>
17051700 </property>
17061701 <property name="application-name"
1707- version="1.2"
1702+ version="1.5"
17081703 writable="1"
17091704 transfer-ownership="none"
17101705 setter="set_application_name"
17111706 getter="get_application_name">
1712- <attribute name="org.gtk.Property.get"
1713- value="adw_about_window_get_application_name"/>
1714- <attribute name="org.gtk.Property.set"
1715- value="adw_about_window_set_application_name"/>
17161707 <doc xml:space="preserve"
1717- filename="src/adw-about-window.c"
1718- line="1386">The name of the application.
1708+ filename="src/adw-about-dialog.c"
1709+ line="1401">The name of the application.
17191710
17201711 The name is displayed at the top of the main page.</doc>
17211712 <type name="utf8" c:type="gchar*"/>
17221713 </property>
17231714 <property name="artists"
1724- version="1.2"
1715+ version="1.5"
17251716 writable="1"
17261717 transfer-ownership="none"
17271718 setter="set_artists"
17281719 getter="get_artists">
1729- <attribute name="org.gtk.Property.get"
1730- value="adw_about_window_get_artists"/>
1731- <attribute name="org.gtk.Property.set"
1732- value="adw_about_window_set_artists"/>
17331720 <doc xml:space="preserve"
1734- filename="src/adw-about-window.c"
1735- line="1649">The list of artists of the application.
1721+ filename="src/adw-about-dialog.c"
1722+ line="1664">The list of artists of the application.
17361723
17371724 It will be displayed on the Credits page.
17381725
@@ -1741,29 +1728,25 @@ more details.
17411728
17421729 See also:
17431730
1744-* [property@AboutWindow:developers]
1745-* [property@AboutWindow:designers]
1746-* [property@AboutWindow:documenters]
1747-* [property@AboutWindow:translator-credits]
1748-* [method@AboutWindow.add_credit_section]
1749-* [method@AboutWindow.add_acknowledgement_section]</doc>
1731+* [property@AboutDialog:developers]
1732+* [property@AboutDialog:designers]
1733+* [property@AboutDialog:documenters]
1734+* [property@AboutDialog:translator-credits]
1735+* [method@AboutDialog.add_credit_section]
1736+* [method@AboutDialog.add_acknowledgement_section]</doc>
17501737 <array>
17511738 <type name="utf8"/>
17521739 </array>
17531740 </property>
17541741 <property name="comments"
1755- version="1.2"
1742+ version="1.5"
17561743 writable="1"
17571744 transfer-ownership="none"
17581745 setter="set_comments"
17591746 getter="get_comments">
1760- <attribute name="org.gtk.Property.get"
1761- value="adw_about_window_get_comments"/>
1762- <attribute name="org.gtk.Property.set"
1763- value="adw_about_window_set_comments"/>
17641747 <doc xml:space="preserve"
1765- filename="src/adw-about-window.c"
1766- line="1496">The comments about the application.
1748+ filename="src/adw-about-dialog.c"
1749+ line="1511">The comments about the application.
17671750
17681751 Comments will be shown on the Details page, above links.
17691752
@@ -1772,18 +1755,14 @@ detailed. It can also contain links and Pango markup.</doc>
17721755 <type name="utf8" c:type="gchar*"/>
17731756 </property>
17741757 <property name="copyright"
1775- version="1.2"
1758+ version="1.5"
17761759 writable="1"
17771760 transfer-ownership="none"
17781761 setter="set_copyright"
17791762 getter="get_copyright">
1780- <attribute name="org.gtk.Property.get"
1781- value="adw_about_window_get_copyright"/>
1782- <attribute name="org.gtk.Property.set"
1783- value="adw_about_window_set_copyright"/>
17841763 <doc xml:space="preserve"
1785- filename="src/adw-about-window.c"
1786- line="1730">The copyright information.
1764+ filename="src/adw-about-dialog.c"
1765+ line="1745">The copyright information.
17871766
17881767 This should be a short string of one or two lines, for example:
17891768 `© 2022 Example`.
@@ -1791,68 +1770,56 @@ This should be a short string of one or two lines, for example:
17911770 The copyright information will be displayed on the Legal page, above the
17921771 application license.
17931772
1794-[method@AboutWindow.add_legal_section] can be used to add copyright
1773+[method@AboutDialog.add_legal_section] can be used to add copyright
17951774 information for the application dependencies or other components.</doc>
17961775 <type name="utf8" c:type="gchar*"/>
17971776 </property>
17981777 <property name="debug-info"
1799- version="1.2"
1778+ version="1.5"
18001779 writable="1"
18011780 transfer-ownership="none"
18021781 setter="set_debug_info"
18031782 getter="get_debug_info">
1804- <attribute name="org.gtk.Property.get"
1805- value="adw_about_window_get_debug_info"/>
1806- <attribute name="org.gtk.Property.set"
1807- value="adw_about_window_set_debug_info"/>
18081783 <doc xml:space="preserve"
1809- filename="src/adw-about-window.c"
1810- line="1558">The debug information.
1784+ filename="src/adw-about-dialog.c"
1785+ line="1573">The debug information.
18111786
18121787 Debug information will be shown on the Troubleshooting page. It's intended
18131788 to be attached to issue reports when reporting issues against the
18141789 application.
18151790
1816-`AdwAboutWindow` provides a quick way to save debug information to a file.
1817-When saving, [property@AboutWindow:debug-info-filename] would be used as
1791+`AdwAboutDialog` provides a quick way to save debug information to a file.
1792+When saving, [property@AboutDialog:debug-info-filename] would be used as
18181793 the suggested filename.
18191794
18201795 Debug information cannot contain markup or links.</doc>
18211796 <type name="utf8" c:type="gchar*"/>
18221797 </property>
18231798 <property name="debug-info-filename"
1824- version="1.2"
1799+ version="1.5"
18251800 writable="1"
18261801 transfer-ownership="none"
18271802 setter="set_debug_info_filename"
18281803 getter="get_debug_info_filename">
1829- <attribute name="org.gtk.Property.get"
1830- value="adw_about_window_get_debug_info_filename"/>
1831- <attribute name="org.gtk.Property.set"
1832- value="adw_about_window_set_debug_info_filename"/>
18331804 <doc xml:space="preserve"
1834- filename="src/adw-about-window.c"
1835- line="1580">The debug information filename.
1805+ filename="src/adw-about-dialog.c"
1806+ line="1595">The debug information filename.
18361807
18371808 It will be used as the suggested filename when saving debug information to
18381809 a file.
18391810
1840-See [property@AboutWindow:debug-info].</doc>
1811+See [property@AboutDialog:debug-info].</doc>
18411812 <type name="utf8" c:type="gchar*"/>
18421813 </property>
18431814 <property name="designers"
1844- version="1.2"
1815+ version="1.5"
18451816 writable="1"
18461817 transfer-ownership="none"
18471818 setter="set_designers"
18481819 getter="get_designers">
1849- <attribute name="org.gtk.Property.get"
1850- value="adw_about_window_get_designers"/>
1851- <attribute name="org.gtk.Property.set"
1852- value="adw_about_window_set_designers"/>
18531820 <doc xml:space="preserve"
1854- filename="src/adw-about-window.c"
1855- line="1623">The list of designers of the application.
1821+ filename="src/adw-about-dialog.c"
1822+ line="1638">The list of designers of the application.
18561823
18571824 It will be displayed on the Credits page.
18581825
@@ -1861,29 +1828,25 @@ more details.
18611828
18621829 See also:
18631830
1864-* [property@AboutWindow:developers]
1865-* [property@AboutWindow:artists]
1866-* [property@AboutWindow:documenters]
1867-* [property@AboutWindow:translator-credits]
1868-* [method@AboutWindow.add_credit_section]
1869-* [method@AboutWindow.add_acknowledgement_section]</doc>
1831+* [property@AboutDialog:developers]
1832+* [property@AboutDialog:artists]
1833+* [property@AboutDialog:documenters]
1834+* [property@AboutDialog:translator-credits]
1835+* [method@AboutDialog.add_credit_section]
1836+* [method@AboutDialog.add_acknowledgement_section]</doc>
18701837 <array>
18711838 <type name="utf8"/>
18721839 </array>
18731840 </property>
18741841 <property name="developer-name"
1875- version="1.2"
1842+ version="1.5"
18761843 writable="1"
18771844 transfer-ownership="none"
18781845 setter="set_developer_name"
18791846 getter="get_developer_name">
1880- <attribute name="org.gtk.Property.get"
1881- value="adw_about_window_get_developer_name"/>
1882- <attribute name="org.gtk.Property.set"
1883- value="adw_about_window_set_developer_name"/>
18841847 <doc xml:space="preserve"
1885- filename="src/adw-about-window.c"
1886- line="1400">The developer name.
1848+ filename="src/adw-about-dialog.c"
1849+ line="1415">The developer name.
18871850
18881851 The developer name is displayed on the main page, under the application
18891852 name.
@@ -1891,23 +1854,19 @@ name.
18911854 If the application is developed by multiple people, the developer name can
18921855 be set to values like "AppName team", "AppName developers" or
18931856 "The AppName project", and the individual contributors can be listed on the
1894-Credits page, with [property@AboutWindow:developers] and related
1857+Credits page, with [property@AboutDialog:developers] and related
18951858 properties.</doc>
18961859 <type name="utf8" c:type="gchar*"/>
18971860 </property>
18981861 <property name="developers"
1899- version="1.2"
1862+ version="1.5"
19001863 writable="1"
19011864 transfer-ownership="none"
19021865 setter="set_developers"
19031866 getter="get_developers">
1904- <attribute name="org.gtk.Property.get"
1905- value="adw_about_window_get_developers"/>
1906- <attribute name="org.gtk.Property.set"
1907- value="adw_about_window_set_developers"/>
19081867 <doc xml:space="preserve"
1909- filename="src/adw-about-window.c"
1910- line="1597">The list of developers of the application.
1868+ filename="src/adw-about-dialog.c"
1869+ line="1612">The list of developers of the application.
19111870
19121871 It will be displayed on the Credits page.
19131872
@@ -1916,29 +1875,25 @@ more details.
19161875
19171876 See also:
19181877
1919-* [property@AboutWindow:designers]
1920-* [property@AboutWindow:artists]
1921-* [property@AboutWindow:documenters]
1922-* [property@AboutWindow:translator-credits]
1923-* [method@AboutWindow.add_credit_section]
1924-* [method@AboutWindow.add_acknowledgement_section]</doc>
1878+* [property@AboutDialog:designers]
1879+* [property@AboutDialog:artists]
1880+* [property@AboutDialog:documenters]
1881+* [property@AboutDialog:translator-credits]
1882+* [method@AboutDialog.add_credit_section]
1883+* [method@AboutDialog.add_acknowledgement_section]</doc>
19251884 <array>
19261885 <type name="utf8"/>
19271886 </array>
19281887 </property>
19291888 <property name="documenters"
1930- version="1.2"
1889+ version="1.5"
19311890 writable="1"
19321891 transfer-ownership="none"
19331892 setter="set_documenters"
19341893 getter="get_documenters">
1935- <attribute name="org.gtk.Property.get"
1936- value="adw_about_window_get_documenters"/>
1937- <attribute name="org.gtk.Property.set"
1938- value="adw_about_window_set_documenters"/>
19391894 <doc xml:space="preserve"
1940- filename="src/adw-about-window.c"
1941- line="1675">The list of documenters of the application.
1895+ filename="src/adw-about-dialog.c"
1896+ line="1690">The list of documenters of the application.
19421897
19431898 It will be displayed on the Credits page.
19441899
@@ -1947,51 +1902,43 @@ more details.
19471902
19481903 See also:
19491904
1950-* [property@AboutWindow:developers]
1951-* [property@AboutWindow:designers]
1952-* [property@AboutWindow:artists]
1953-* [property@AboutWindow:translator-credits]
1954-* [method@AboutWindow.add_credit_section]
1955-* [method@AboutWindow.add_acknowledgement_section]</doc>
1905+* [property@AboutDialog:developers]
1906+* [property@AboutDialog:designers]
1907+* [property@AboutDialog:artists]
1908+* [property@AboutDialog:translator-credits]
1909+* [method@AboutDialog.add_credit_section]
1910+* [method@AboutDialog.add_acknowledgement_section]</doc>
19561911 <array>
19571912 <type name="utf8"/>
19581913 </array>
19591914 </property>
19601915 <property name="issue-url"
1961- version="1.2"
1916+ version="1.5"
19621917 writable="1"
19631918 transfer-ownership="none"
19641919 setter="set_issue_url"
19651920 getter="get_issue_url">
1966- <attribute name="org.gtk.Property.get"
1967- value="adw_about_window_get_issue_url"/>
1968- <attribute name="org.gtk.Property.set"
1969- value="adw_about_window_set_issue_url"/>
19701921 <doc xml:space="preserve"
1971- filename="src/adw-about-window.c"
1972- line="1544">The URL for the application's issue tracker.
1922+ filename="src/adw-about-dialog.c"
1923+ line="1559">The URL for the application's issue tracker.
19731924
19741925 The issue tracker link is displayed on the main page.</doc>
19751926 <type name="utf8" c:type="gchar*"/>
19761927 </property>
19771928 <property name="license"
1978- version="1.2"
1929+ version="1.5"
19791930 writable="1"
19801931 transfer-ownership="none"
19811932 setter="set_license"
19821933 getter="get_license">
1983- <attribute name="org.gtk.Property.get"
1984- value="adw_about_window_get_license"/>
1985- <attribute name="org.gtk.Property.set"
1986- value="adw_about_window_set_license"/>
19871934 <doc xml:space="preserve"
1988- filename="src/adw-about-window.c"
1989- line="1781">The license text.
1935+ filename="src/adw-about-dialog.c"
1936+ line="1796">The license text.
19901937
19911938 This can be used to set a custom text for the license if it can't be set
1992-via [property@AboutWindow:license-type].
1939+via [property@AboutDialog:license-type].
19931940
1994-When set, [property@AboutWindow:license-type] will be set to
1941+When set, [property@AboutDialog:license-type] will be set to
19951942 `GTK_LICENSE_CUSTOM`.
19961943
19971944 The license text will be displayed on the Legal page, below the copyright
@@ -1999,56 +1946,48 @@ information.
19991946
20001947 License text can contain Pango markup and links.
20011948
2002-[method@AboutWindow.add_legal_section] can be used to add license
1949+[method@AboutDialog.add_legal_section] can be used to add license
20031950 information for the application dependencies or other components.</doc>
20041951 <type name="utf8" c:type="gchar*"/>
20051952 </property>
20061953 <property name="license-type"
2007- version="1.2"
1954+ version="1.5"
20081955 writable="1"
20091956 transfer-ownership="none"
20101957 setter="set_license_type"
20111958 getter="get_license_type"
20121959 default-value="GTK_LICENSE_UNKNOWN">
2013- <attribute name="org.gtk.Property.get"
2014- value="adw_about_window_get_license_type"/>
2015- <attribute name="org.gtk.Property.set"
2016- value="adw_about_window_set_license_type"/>
20171960 <doc xml:space="preserve"
2018- filename="src/adw-about-window.c"
2019- line="1751">The license type.
1961+ filename="src/adw-about-dialog.c"
1962+ line="1766">The license type.
20201963
20211964 Allows to set the application's license froma list of known licenses.
20221965
20231966 If the application's license is not in the list,
2024-[property@AboutWindow:license] can be used instead. The license type will
1967+[property@AboutDialog:license] can be used instead. The license type will
20251968 be automatically set to `GTK_LICENSE_CUSTOM` in that case.
20261969
20271970 If set to `GTK_LICENSE_UNKNOWN`, no information will be displayed.
20281971
20291972 If the license type is different from `GTK_LICENSE_CUSTOM`.
2030-[property@AboutWindow:license] will be cleared out.
1973+[property@AboutDialog:license] will be cleared out.
20311974
20321975 The license description will be displayed on the Legal page, below the
20331976 copyright information.
20341977
2035-[method@AboutWindow.add_legal_section] can be used to add license
1978+[method@AboutDialog.add_legal_section] can be used to add license
20361979 information for the application dependencies or other components.</doc>
20371980 <type name="Gtk.License"/>
20381981 </property>
20391982 <property name="release-notes"
2040- version="1.2"
1983+ version="1.5"
20411984 writable="1"
20421985 transfer-ownership="none"
20431986 setter="set_release_notes"
20441987 getter="get_release_notes">
2045- <attribute name="org.gtk.Property.get"
2046- value="adw_about_window_get_release_notes"/>
2047- <attribute name="org.gtk.Property.set"
2048- value="adw_about_window_set_release_notes"/>
20491988 <doc xml:space="preserve"
2050- filename="src/adw-about-window.c"
2051- line="1461">The release notes of the application.
1989+ filename="src/adw-about-dialog.c"
1990+ line="1476">The release notes of the application.
20521991
20531992 Release notes are displayed on the the What's New page.
20541993
@@ -2069,67 +2008,55 @@ Any text outside paragraphs or list items is ignored.
20692008
20702009 Nested lists are not supported.
20712010
2072-`AdwAboutWindow` displays the version above the release notes. If set, the
2073-[property@AboutWindow:release-notes-version] of the property will be used
2074-as the version; otherwise, [property@AboutWindow:version] is used.</doc>
2011+`AdwAboutDialog` displays the version above the release notes. If set, the
2012+[property@AboutDialog:release-notes-version] of the property will be used
2013+as the version; otherwise, [property@AboutDialog:version] is used.</doc>
20752014 <type name="utf8" c:type="gchar*"/>
20762015 </property>
20772016 <property name="release-notes-version"
2078- version="1.2"
2017+ version="1.5"
20792018 writable="1"
20802019 transfer-ownership="none"
20812020 setter="set_release_notes_version"
20822021 getter="get_release_notes_version">
2083- <attribute name="org.gtk.Property.get"
2084- value="adw_about_window_get_release_notes_version"/>
2085- <attribute name="org.gtk.Property.set"
2086- value="adw_about_window_set_release_notes_version"/>
20872022 <doc xml:space="preserve"
2088- filename="src/adw-about-window.c"
2089- line="1438">The version described by the application's release notes.
2023+ filename="src/adw-about-dialog.c"
2024+ line="1453">The version described by the application's release notes.
20902025
20912026 The release notes version is displayed on the What's New page, above the
20922027 release notes.
20932028
2094-If not set, [property@AboutWindow:version] will be used instead.
2029+If not set, [property@AboutDialog:version] will be used instead.
20952030
20962031 For example, an application with the current version 2.0.2 might want to
20972032 keep the release notes from 2.0.0, and set the release notes version
20982033 accordingly.
20992034
2100-See [property@AboutWindow:release-notes].</doc>
2035+See [property@AboutDialog:release-notes].</doc>
21012036 <type name="utf8" c:type="gchar*"/>
21022037 </property>
21032038 <property name="support-url"
2104- version="1.2"
2039+ version="1.5"
21052040 writable="1"
21062041 transfer-ownership="none"
21072042 setter="set_support_url"
21082043 getter="get_support_url">
2109- <attribute name="org.gtk.Property.get"
2110- value="adw_about_window_get_support_url"/>
2111- <attribute name="org.gtk.Property.set"
2112- value="adw_about_window_set_support_url"/>
21132044 <doc xml:space="preserve"
2114- filename="src/adw-about-window.c"
2115- line="1530">The URL of the application's support page.
2045+ filename="src/adw-about-dialog.c"
2046+ line="1545">The URL of the application's support page.
21162047
21172048 The support page link is displayed on the main page.</doc>
21182049 <type name="utf8" c:type="gchar*"/>
21192050 </property>
21202051 <property name="translator-credits"
2121- version="1.2"
2052+ version="1.5"
21222053 writable="1"
21232054 transfer-ownership="none"
21242055 setter="set_translator_credits"
21252056 getter="get_translator_credits">
2126- <attribute name="org.gtk.Property.get"
2127- value="adw_about_window_get_translator_credits"/>
2128- <attribute name="org.gtk.Property.set"
2129- value="adw_about_window_set_translator_credits"/>
21302057 <doc xml:space="preserve"
2131- filename="src/adw-about-window.c"
2132- line="1701">The translator credits string.
2058+ filename="src/adw-about-dialog.c"
2059+ line="1716">The translator credits string.
21332060
21342061 It will be displayed on the Credits page.
21352062
@@ -2141,11988 +2068,25015 @@ more details.
21412068
21422069 See also:
21432070
2144-* [property@AboutWindow:developers]
2145-* [property@AboutWindow:designers]
2146-* [property@AboutWindow:artists]
2147-* [property@AboutWindow:documenters]
2148-* [method@AboutWindow.add_credit_section]
2149-* [method@AboutWindow.add_acknowledgement_section]</doc>
2071+* [property@AboutDialog:developers]
2072+* [property@AboutDialog:designers]
2073+* [property@AboutDialog:artists]
2074+* [property@AboutDialog:documenters]
2075+* [method@AboutDialog.add_credit_section]
2076+* [method@AboutDialog.add_acknowledgement_section]</doc>
21502077 <type name="utf8" c:type="gchar*"/>
21512078 </property>
21522079 <property name="version"
2153- version="1.2"
2080+ version="1.5"
21542081 writable="1"
21552082 transfer-ownership="none"
21562083 setter="set_version"
21572084 getter="get_version">
2158- <attribute name="org.gtk.Property.get"
2159- value="adw_about_window_get_version"/>
2160- <attribute name="org.gtk.Property.set"
2161- value="adw_about_window_set_version"/>
21622085 <doc xml:space="preserve"
2163- filename="src/adw-about-window.c"
2164- line="1421">The version of the application.
2086+ filename="src/adw-about-dialog.c"
2087+ line="1436">The version of the application.
21652088
21662089 The version is displayed on the main page.
21672090
2168-If [property@AboutWindow:release-notes-version] is not set, the version
2091+If [property@AboutDialog:release-notes-version] is not set, the version
21692092 will also be displayed above the release notes on the What's New page.</doc>
21702093 <type name="utf8" c:type="gchar*"/>
21712094 </property>
21722095 <property name="website"
2173- version="1.2"
2096+ version="1.5"
21742097 writable="1"
21752098 transfer-ownership="none"
21762099 setter="set_website"
21772100 getter="get_website">
2178- <attribute name="org.gtk.Property.get"
2179- value="adw_about_window_get_website"/>
2180- <attribute name="org.gtk.Property.set"
2181- value="adw_about_window_set_website"/>
21822101 <doc xml:space="preserve"
2183- filename="src/adw-about-window.c"
2184- line="1513">The URL of the application's website.
2102+ filename="src/adw-about-dialog.c"
2103+ line="1528">The URL of the application's website.
21852104
21862105 Website is displayed on the Details page, below comments, or on the main
21872106 page if the Details page doesn't have any other content.
21882107
2189-Applications can add other links below, see [method@AboutWindow.add_link].</doc>
2108+Applications can add other links below, see [method@AboutDialog.add_link].</doc>
21902109 <type name="utf8" c:type="gchar*"/>
21912110 </property>
2192- <glib:signal name="activate-link" when="last" version="1.2">
2111+ <glib:signal name="activate-link" when="last" version="1.5">
21932112 <doc xml:space="preserve"
2194- filename="src/adw-about-window.c"
2195- line="1809">Emitted when a URL is activated.
2113+ filename="src/adw-about-dialog.c"
2114+ line="1824">Emitted when a URL is activated.
21962115
21972116 Applications may connect to it to override the default behavior, which is
21982117 to call [func@Gtk.show_uri].</doc>
21992118 <return-value transfer-ownership="none">
22002119 <doc xml:space="preserve"
2201- filename="src/adw-about-window.c"
2202- line="1819">`TRUE` if the link has been activated</doc>
2120+ filename="src/adw-about-dialog.c"
2121+ line="1834">`TRUE` if the link has been activated</doc>
22032122 <type name="gboolean" c:type="gboolean"/>
22042123 </return-value>
22052124 <parameters>
22062125 <parameter name="uri" transfer-ownership="none">
22072126 <doc xml:space="preserve"
2208- filename="src/adw-about-window.c"
2209- line="1812">the URI to activate</doc>
2127+ filename="src/adw-about-dialog.c"
2128+ line="1827">the URI to activate</doc>
22102129 <type name="utf8" c:type="gchar*"/>
22112130 </parameter>
22122131 </parameters>
22132132 </glib:signal>
22142133 </class>
2215- <record name="AboutWindowClass"
2216- c:type="AdwAboutWindowClass"
2217- glib:is-gtype-struct-for="AboutWindow">
2218- <source-position filename="src/adw-about-window.h" line="23"/>
2134+ <record name="AboutDialogClass"
2135+ c:type="AdwAboutDialogClass"
2136+ glib:is-gtype-struct-for="AboutDialog">
2137+ <source-position filename="src/adw-about-dialog.h" line="25"/>
22192138 <field name="parent_class">
2220- <type name="WindowClass" c:type="AdwWindowClass"/>
2139+ <type name="DialogClass" c:type="AdwDialogClass"/>
22212140 </field>
22222141 </record>
2223- <class name="ActionRow"
2224- c:symbol-prefix="action_row"
2225- c:type="AdwActionRow"
2226- parent="PreferencesRow"
2227- glib:type-name="AdwActionRow"
2228- glib:get-type="adw_action_row_get_type"
2229- glib:type-struct="ActionRowClass">
2142+ <class name="AboutWindow"
2143+ c:symbol-prefix="about_window"
2144+ c:type="AdwAboutWindow"
2145+ version="1.2"
2146+ deprecated="1"
2147+ deprecated-version="1.6"
2148+ parent="Window"
2149+ final="1"
2150+ glib:type-name="AdwAboutWindow"
2151+ glib:get-type="adw_about_window_get_type"
2152+ glib:type-struct="AboutWindowClass">
22302153 <doc xml:space="preserve"
2231- filename="src/adw-action-row.c"
2232- line="13">A [class@Gtk.ListBoxRow] used to present actions.
2154+ filename="src/adw-about-window.c"
2155+ line="21">A window showing information about the application.
22332156
22342157 &lt;picture&gt;
2235- &lt;source srcset="action-row-dark.png" media="(prefers-color-scheme: dark)"&gt;
2236- &lt;img src="action-row.png" alt="action-row"&gt;
2158+ &lt;source srcset="about-window-dark.png" media="(prefers-color-scheme: dark)"&gt;
2159+ &lt;img src="about-window.png" alt="about-window"&gt;
22372160 &lt;/picture&gt;
22382161
2239-The `AdwActionRow` widget can have a title, a subtitle and an icon. The row
2240-can receive additional widgets at its end, or prefix widgets at its start.
2162+An about window is typically opened when the user activates the `About …`
2163+item in the application's primary menu. All parts of the window are optional.
22412164
2242-It is convenient to present a preference and its related actions.
2165+## Main page
22432166
2244-`AdwActionRow` is unactivatable by default, giving it an activatable widget
2245-will automatically make it activatable, but unsetting it won't change the
2246-row's activatability.
2167+`AdwAboutWindow` prominently displays the application's icon, name, developer
2168+name and version. They can be set with the [property@AboutWindow:application-icon],
2169+[property@AboutWindow:application-name],
2170+[property@AboutWindow:developer-name] and [property@AboutWindow:version]
2171+respectively.
22472172
2248-## AdwActionRow as GtkBuildable
2173+## What's New
22492174
2250-The `AdwActionRow` implementation of the [iface@Gtk.Buildable] interface
2251-supports adding a child at its end by specifying “suffix” or omitting the
2252-“type” attribute of a &lt;child&gt; element.
2175+`AdwAboutWindow` provides a way for applications to display their release
2176+notes, set with the [property@AboutWindow:release-notes] property.
22532177
2254-It also supports adding a child as a prefix widget by specifying “prefix” as
2255-the “type” attribute of a &lt;child&gt; element.
2178+Release notes are formatted the same way as
2179+[AppStream descriptions](https://freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-description).
22562180
2257-## CSS nodes
2181+The supported formatting options are:
22582182
2259-`AdwActionRow` has a main CSS node with name `row`.
2183+* Paragraph (`&lt;p&gt;`)
2184+* Ordered list (`&lt;ol&gt;`), with list items (`&lt;li&gt;`)
2185+* Unordered list (`&lt;ul&gt;`), with list items (`&lt;li&gt;`)
22602186
2261-It contains the subnode `box.header` for its main horizontal box, and
2262-`box.title` for the vertical box containing the title and subtitle labels.
2187+Within paragraphs and list items, emphasis (`&lt;em&gt;`) and inline code
2188+(`&lt;code&gt;`) text styles are supported. The emphasis is rendered in italic,
2189+while inline code is shown in a monospaced font.
22632190
2264-It contains subnodes `label.title` and `label.subtitle` representing
2265-respectively the title label and subtitle label.</doc>
2266- <source-position filename="src/adw-action-row.h" line="37"/>
2191+Any text outside paragraphs or list items is ignored.
2192+
2193+Nested lists are not supported.
2194+
2195+Only one version can be shown at a time. By default, the displayed version
2196+number matches [property@AboutWindow:version]. Use
2197+[property@AboutWindow:release-notes-version] to override it.
2198+
2199+## Details
2200+
2201+The Details page displays the application comments and links.
2202+
2203+The comments can be set with the [property@AboutWindow:comments] property.
2204+Unlike [property@Gtk.AboutDialog:comments], this string can be long and
2205+detailed. It can also contain links and Pango markup.
2206+
2207+To set the application website, use [property@AboutWindow:website].
2208+To add extra links below the website, use [method@AboutWindow.add_link].
2209+
2210+If the Details page doesn't have any other content besides website, the
2211+website will be displayed on the main page instead.
2212+
2213+## Troubleshooting
2214+
2215+`AdwAboutWindow` displays the following two links on the main page:
2216+
2217+* Support Questions, set with the [property@AboutWindow:support-url] property,
2218+* Report an Issue, set with the [property@AboutWindow:issue-url] property.
2219+
2220+Additionally, applications can provide debugging information. It will be
2221+shown separately on the Troubleshooting page. Use the
2222+[property@AboutWindow:debug-info] property to specify it.
2223+
2224+It's intended to be attached to issue reports when reporting issues against
2225+the application. As such, it cannot contain markup or links.
2226+
2227+`AdwAboutWindow` provides a quick way to save debug information to a file.
2228+When saving, [property@AboutWindow:debug-info-filename] would be used as
2229+the suggested filename.
2230+
2231+## Credits and Acknowledgements
2232+
2233+The Credits page has the following default sections:
2234+
2235+* Developers, set with the [property@AboutWindow:developers] property,
2236+* Designers, set with the [property@AboutWindow:designers] property,
2237+* Artists, set with the [property@AboutWindow:artists] property,
2238+* Documenters, set with the [property@AboutWindow:documenters] property,
2239+* Translators, set with the [property@AboutWindow:translator-credits] property.
2240+
2241+When setting translator credits, use the strings `"translator-credits"` or
2242+`"translator_credits"` and mark them as translatable.
2243+
2244+The default sections that don't contain any names won't be displayed.
2245+
2246+The Credits page can also contain an arbitrary number of extra sections below
2247+the default ones. Use [method@AboutWindow.add_credit_section] to add them.
2248+
2249+The Acknowledgements page can be used to acknowledge additional people and
2250+organizations for their non-development contributions. Use
2251+[method@AboutWindow.add_acknowledgement_section] to add sections to it. For
2252+example, it can be used to list backers in a crowdfunded project or to give
2253+special thanks.
2254+
2255+Each of the people or organizations can have an email address or a website
2256+specified. To add a email address, use a string like
2257+`Edgar Allan Poe &lt;edgar@poe.com&gt;`. To specify a website with a title, use a
2258+string like `The GNOME Project https://www.gnome.org`:
2259+
2260+&lt;picture&gt;
2261+ &lt;source srcset="about-window-credits-dark.png" media="(prefers-color-scheme: dark)"&gt;
2262+ &lt;img src="about-window-credits.png" alt="about-window-credits"&gt;
2263+&lt;/picture&gt;
2264+
2265+## Legal
2266+
2267+The Legal page displays the copyright and licensing information for the
2268+application and other modules.
2269+
2270+The copyright string is set with the [property@AboutWindow:copyright]
2271+property and should be a short string of one or two lines, for example:
2272+`© 2022 Example`.
2273+
2274+Licensing information can be quickly set from a list of known licenses with
2275+the [property@AboutWindow:license-type] property. If the application's
2276+license is not in the list, [property@AboutWindow:license] can be used
2277+instead.
2278+
2279+To add information about other modules, such as application dependencies or
2280+data, use [method@AboutWindow.add_legal_section].
2281+
2282+## Constructing
2283+
2284+To make constructing an `AdwAboutWindow` as convenient as possible, you can
2285+use the function [func@show_about_window] which constructs and shows a
2286+window.
2287+
2288+```c
2289+static void
2290+show_about (GtkApplication *app)
2291+{
2292+ const char *developers[] = {
2293+ "Angela Avery",
2294+ NULL
2295+ };
2296+
2297+ const char *designers[] = {
2298+ "GNOME Design Team",
2299+ NULL
2300+ };
2301+
2302+ adw_show_about_window (gtk_application_get_active_window (app),
2303+ "application-name", _("Example"),
2304+ "application-icon", "org.example.App",
2305+ "version", "1.2.3",
2306+ "copyright", "© 2022 Angela Avery",
2307+ "issue-url", "https://gitlab.gnome.org/example/example/-/issues/",
2308+ "license-type", GTK_LICENSE_GPL_3_0,
2309+ "developers", developers,
2310+ "designers", designers,
2311+ "translator-credits", _("translator-credits"),
2312+ NULL);
2313+}
2314+```
2315+
2316+## CSS nodes
2317+
2318+`AdwAboutWindow` has a main CSS node with the name `window` and the
2319+style class `.about`.</doc>
2320+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
2321+ <source-position filename="src/adw-about-window.h" line="23"/>
22672322 <implements name="Gtk.Accessible"/>
2268- <implements name="Gtk.Actionable"/>
22692323 <implements name="Gtk.Buildable"/>
22702324 <implements name="Gtk.ConstraintTarget"/>
2271- <constructor name="new" c:identifier="adw_action_row_new">
2325+ <implements name="Gtk.Native"/>
2326+ <implements name="Gtk.Root"/>
2327+ <implements name="Gtk.ShortcutManager"/>
2328+ <constructor name="new"
2329+ c:identifier="adw_about_window_new"
2330+ version="1.2"
2331+ deprecated="1"
2332+ deprecated-version="1.6">
22722333 <doc xml:space="preserve"
2273- filename="src/adw-action-row.c"
2274- line="389">Creates a new `AdwActionRow`.</doc>
2275- <source-position filename="src/adw-action-row.h" line="40"/>
2334+ filename="src/adw-about-window.c"
2335+ line="1973">Creates a new `AdwAboutWindow`.</doc>
2336+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
2337+ <source-position filename="src/adw-about-window.h" line="26"/>
22762338 <return-value transfer-ownership="none">
22772339 <doc xml:space="preserve"
2278- filename="src/adw-action-row.c"
2279- line="394">the newly created `AdwActionRow`</doc>
2340+ filename="src/adw-about-window.c"
2341+ line="1978">the newly created `AdwAboutWindow`</doc>
22802342 <type name="Gtk.Widget" c:type="GtkWidget*"/>
22812343 </return-value>
22822344 </constructor>
2283- <virtual-method name="activate" invoker="activate">
2345+ <constructor name="new_from_appdata"
2346+ c:identifier="adw_about_window_new_from_appdata"
2347+ version="1.4"
2348+ deprecated="1"
2349+ deprecated-version="1.6">
22842350 <doc xml:space="preserve"
2285- filename="src/adw-action-row.c"
2286- line="827">Activates @self.</doc>
2287- <source-position filename="src/adw-action-row.h" line="33"/>
2351+ filename="src/adw-about-window.c"
2352+ line="1989">Creates a new `AdwAboutWindow` using AppStream metadata.
2353+
2354+This automatically sets the following properties with the following AppStream
2355+values:
2356+
2357+* [property@AboutWindow:application-icon] is set from the `&lt;id&gt;`
2358+* [property@AboutWindow:application-name] is set from the `&lt;name&gt;`
2359+* [property@AboutWindow:developer-name] is set from the `&lt;name&gt;` within
2360+ `&lt;developer&gt;`
2361+* [property@AboutWindow:version] is set from the version of the latest release
2362+* [property@AboutWindow:website] is set from the `&lt;url type="homepage"&gt;`
2363+* [property@AboutWindow:support-url] is set from the `&lt;url type="help"&gt;`
2364+* [property@AboutWindow:issue-url] is set from the `&lt;url type="bugtracker"&gt;`
2365+* [property@AboutWindow:license-type] is set from the `&lt;project_license&gt;`.
2366+ If the license type retrieved from AppStream is not listed in
2367+ [enum@Gtk.License], it will be set to `GTK_LICENCE_CUSTOM`.
2368+
2369+If @release_notes_version is not `NULL`,
2370+[property@AboutWindow:release-notes-version] is set to match it, while
2371+[property@AboutWindow:release-notes] is set from the AppStream release
2372+description for that version.</doc>
2373+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
2374+ <source-position filename="src/adw-about-window.h" line="29"/>
22882375 <return-value transfer-ownership="none">
2289- <type name="none" c:type="void"/>
2376+ <doc xml:space="preserve"
2377+ filename="src/adw-about-window.c"
2378+ line="2016">the newly created `AdwAboutWindow`</doc>
2379+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
22902380 </return-value>
22912381 <parameters>
2292- <instance-parameter name="self" transfer-ownership="none">
2382+ <parameter name="resource_path" transfer-ownership="none">
22932383 <doc xml:space="preserve"
2294- filename="src/adw-action-row.c"
2295- line="829">an action row</doc>
2296- <type name="ActionRow" c:type="AdwActionRow*"/>
2297- </instance-parameter>
2384+ filename="src/adw-about-window.c"
2385+ line="1991">The resource to use</doc>
2386+ <type name="utf8" c:type="const char*"/>
2387+ </parameter>
2388+ <parameter name="release_notes_version"
2389+ transfer-ownership="none"
2390+ nullable="1"
2391+ allow-none="1">
2392+ <doc xml:space="preserve"
2393+ filename="src/adw-about-window.c"
2394+ line="1992">The version to retrieve release notes for</doc>
2395+ <type name="utf8" c:type="const char*"/>
2396+ </parameter>
22982397 </parameters>
2299- </virtual-method>
2300- <method name="activate" c:identifier="adw_action_row_activate">
2398+ </constructor>
2399+ <method name="add_acknowledgement_section"
2400+ c:identifier="adw_about_window_add_acknowledgement_section"
2401+ version="1.2"
2402+ deprecated="1"
2403+ deprecated-version="1.6">
23012404 <doc xml:space="preserve"
2302- filename="src/adw-action-row.c"
2303- line="827">Activates @self.</doc>
2304- <source-position filename="src/adw-action-row.h" line="90"/>
2405+ filename="src/adw-about-window.c"
2406+ line="3179">Adds a section to the Acknowledgements page.
2407+
2408+This can be used to acknowledge additional people and organizations for their
2409+non-development contributions - for example, backers in a crowdfunded
2410+project.
2411+
2412+Each name may contain email addresses and URLs, see the introduction for more
2413+details.
2414+
2415+See also:
2416+
2417+* [property@AboutWindow:developers]
2418+* [property@AboutWindow:designers]
2419+* [property@AboutWindow:artists]
2420+* [property@AboutWindow:documenters]
2421+* [property@AboutWindow:translator-credits]
2422+* [method@AboutWindow.add_credit_section]</doc>
2423+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
2424+ <source-position filename="src/adw-about-window.h" line="145"/>
23052425 <return-value transfer-ownership="none">
23062426 <type name="none" c:type="void"/>
23072427 </return-value>
23082428 <parameters>
23092429 <instance-parameter name="self" transfer-ownership="none">
23102430 <doc xml:space="preserve"
2311- filename="src/adw-action-row.c"
2312- line="829">an action row</doc>
2313- <type name="ActionRow" c:type="AdwActionRow*"/>
2431+ filename="src/adw-about-window.c"
2432+ line="3181">an about window</doc>
2433+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
23142434 </instance-parameter>
2435+ <parameter name="name"
2436+ transfer-ownership="none"
2437+ nullable="1"
2438+ allow-none="1">
2439+ <doc xml:space="preserve"
2440+ filename="src/adw-about-window.c"
2441+ line="3182">the section name</doc>
2442+ <type name="utf8" c:type="const char*"/>
2443+ </parameter>
2444+ <parameter name="people" transfer-ownership="none">
2445+ <doc xml:space="preserve"
2446+ filename="src/adw-about-window.c"
2447+ line="3183">the list of names</doc>
2448+ <array c:type="const char**">
2449+ <type name="utf8" c:type="char*"/>
2450+ </array>
2451+ </parameter>
23152452 </parameters>
23162453 </method>
2317- <method name="add_prefix" c:identifier="adw_action_row_add_prefix">
2454+ <method name="add_credit_section"
2455+ c:identifier="adw_about_window_add_credit_section"
2456+ version="1.2"
2457+ deprecated="1"
2458+ deprecated-version="1.6">
23182459 <doc xml:space="preserve"
2319- filename="src/adw-action-row.c"
2320- line="402">Adds a prefix widget to @self.</doc>
2321- <source-position filename="src/adw-action-row.h" line="43"/>
2460+ filename="src/adw-about-window.c"
2461+ line="3135">Adds an extra section to the Credits page.
2462+
2463+Extra sections are displayed below the standard categories.
2464+
2465+Each name may contain email addresses and URLs, see the introduction for more
2466+details.
2467+
2468+See also:
2469+
2470+* [property@AboutWindow:developers]
2471+* [property@AboutWindow:designers]
2472+* [property@AboutWindow:artists]
2473+* [property@AboutWindow:documenters]
2474+* [property@AboutWindow:translator-credits]
2475+* [method@AboutWindow.add_acknowledgement_section]</doc>
2476+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
2477+ <source-position filename="src/adw-about-window.h" line="140"/>
23222478 <return-value transfer-ownership="none">
23232479 <type name="none" c:type="void"/>
23242480 </return-value>
23252481 <parameters>
23262482 <instance-parameter name="self" transfer-ownership="none">
23272483 <doc xml:space="preserve"
2328- filename="src/adw-action-row.c"
2329- line="404">an action row</doc>
2330- <type name="ActionRow" c:type="AdwActionRow*"/>
2484+ filename="src/adw-about-window.c"
2485+ line="3137">an about window</doc>
2486+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
23312487 </instance-parameter>
2332- <parameter name="widget" transfer-ownership="none">
2488+ <parameter name="name"
2489+ transfer-ownership="none"
2490+ nullable="1"
2491+ allow-none="1">
23332492 <doc xml:space="preserve"
2334- filename="src/adw-action-row.c"
2335- line="405">a widget</doc>
2336- <type name="Gtk.Widget" c:type="GtkWidget*"/>
2493+ filename="src/adw-about-window.c"
2494+ line="3138">the section name</doc>
2495+ <type name="utf8" c:type="const char*"/>
2496+ </parameter>
2497+ <parameter name="people" transfer-ownership="none">
2498+ <doc xml:space="preserve"
2499+ filename="src/adw-about-window.c"
2500+ line="3139">the list of names</doc>
2501+ <array c:type="const char**">
2502+ <type name="utf8" c:type="char*"/>
2503+ </array>
23372504 </parameter>
23382505 </parameters>
23392506 </method>
2340- <method name="add_suffix" c:identifier="adw_action_row_add_suffix">
2507+ <method name="add_legal_section"
2508+ c:identifier="adw_about_window_add_legal_section"
2509+ version="1.2"
2510+ deprecated="1"
2511+ deprecated-version="1.6">
23412512 <doc xml:space="preserve"
2342- filename="src/adw-action-row.c"
2343- line="424">Adds a suffix widget to @self.</doc>
2344- <source-position filename="src/adw-action-row.h" line="46"/>
2513+ filename="src/adw-about-window.c"
2514+ line="3406">Adds an extra section to the Legal page.
2515+
2516+Extra sections will be displayed below the application's own information.
2517+
2518+The parameters @copyright, @license_type and @license will be used to present
2519+the it the same way as [property@AboutWindow:copyright],
2520+[property@AboutWindow:license-type] and [property@AboutWindow:license] are
2521+for the application's own information.
2522+
2523+See those properties for more details.
2524+
2525+This can be useful to attribute the application dependencies or data.
2526+
2527+Examples:
2528+
2529+```c
2530+adw_about_window_add_legal_section (ADW_ABOUT_WINDOW (about),
2531+ _("Copyright and a known license"),
2532+ "© 2022 Example",
2533+ GTK_LICENSE_LGPL_2_1,
2534+ NULL);
2535+
2536+adw_about_window_add_legal_section (ADW_ABOUT_WINDOW (about),
2537+ _("Copyright and custom license"),
2538+ "© 2022 Example",
2539+ GTK_LICENSE_CUSTOM,
2540+ "Custom license text");
2541+
2542+adw_about_window_add_legal_section (ADW_ABOUT_WINDOW (about),
2543+ _("Copyright only"),
2544+ "© 2022 Example",
2545+ GTK_LICENSE_UNKNOWN,
2546+ NULL);
2547+
2548+adw_about_window_add_legal_section (ADW_ABOUT_WINDOW (about),
2549+ _("Custom license only"),
2550+ NULL,
2551+ GTK_LICENSE_CUSTOM,
2552+ "Something completely custom here.");
2553+```</doc>
2554+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
2555+ <source-position filename="src/adw-about-window.h" line="168"/>
23452556 <return-value transfer-ownership="none">
23462557 <type name="none" c:type="void"/>
23472558 </return-value>
23482559 <parameters>
23492560 <instance-parameter name="self" transfer-ownership="none">
23502561 <doc xml:space="preserve"
2351- filename="src/adw-action-row.c"
2352- line="426">an action row</doc>
2353- <type name="ActionRow" c:type="AdwActionRow*"/>
2562+ filename="src/adw-about-window.c"
2563+ line="3408">an about window</doc>
2564+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
23542565 </instance-parameter>
2355- <parameter name="widget" transfer-ownership="none">
2566+ <parameter name="title" transfer-ownership="none">
23562567 <doc xml:space="preserve"
2357- filename="src/adw-action-row.c"
2358- line="427">a widget</doc>
2359- <type name="Gtk.Widget" c:type="GtkWidget*"/>
2568+ filename="src/adw-about-window.c"
2569+ line="3409">the name of the section</doc>
2570+ <type name="utf8" c:type="const char*"/>
2571+ </parameter>
2572+ <parameter name="copyright"
2573+ transfer-ownership="none"
2574+ nullable="1"
2575+ allow-none="1">
2576+ <doc xml:space="preserve"
2577+ filename="src/adw-about-window.c"
2578+ line="3410">a copyright string</doc>
2579+ <type name="utf8" c:type="const char*"/>
2580+ </parameter>
2581+ <parameter name="license_type" transfer-ownership="none">
2582+ <doc xml:space="preserve"
2583+ filename="src/adw-about-window.c"
2584+ line="3411">the type of license</doc>
2585+ <type name="Gtk.License" c:type="GtkLicense"/>
2586+ </parameter>
2587+ <parameter name="license"
2588+ transfer-ownership="none"
2589+ nullable="1"
2590+ allow-none="1">
2591+ <doc xml:space="preserve"
2592+ filename="src/adw-about-window.c"
2593+ line="3412">custom license information</doc>
2594+ <type name="utf8" c:type="const char*"/>
23602595 </parameter>
23612596 </parameters>
23622597 </method>
2363- <method name="get_activatable_widget"
2364- c:identifier="adw_action_row_get_activatable_widget"
2365- glib:get-property="activatable-widget">
2366- <attribute name="org.gtk.Method.get_property"
2367- value="activatable-widget"/>
2598+ <method name="add_link"
2599+ c:identifier="adw_about_window_add_link"
2600+ version="1.2"
2601+ deprecated="1"
2602+ deprecated-version="1.6">
23682603 <doc xml:space="preserve"
2369- filename="src/adw-action-row.c"
2370- line="575">Gets the widget activated when @self is activated.</doc>
2371- <source-position filename="src/adw-action-row.h" line="65"/>
2372- <return-value transfer-ownership="none" nullable="1">
2373- <doc xml:space="preserve"
2374- filename="src/adw-action-row.c"
2375- line="581">the activatable widget for @self</doc>
2376- <type name="Gtk.Widget" c:type="GtkWidget*"/>
2604+ filename="src/adw-about-window.c"
2605+ line="2681">Adds an extra link to the Details page.
2606+
2607+Extra links are displayed under the comment and website.
2608+
2609+Underlines in @title will be interpreted as indicating a mnemonic.
2610+
2611+See [property@AboutWindow:website].</doc>
2612+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
2613+ <source-position filename="src/adw-about-window.h" line="93"/>
2614+ <return-value transfer-ownership="none">
2615+ <type name="none" c:type="void"/>
23772616 </return-value>
23782617 <parameters>
23792618 <instance-parameter name="self" transfer-ownership="none">
23802619 <doc xml:space="preserve"
2381- filename="src/adw-action-row.c"
2382- line="577">an action row</doc>
2383- <type name="ActionRow" c:type="AdwActionRow*"/>
2620+ filename="src/adw-about-window.c"
2621+ line="2683">an about window</doc>
2622+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
23842623 </instance-parameter>
2624+ <parameter name="title" transfer-ownership="none">
2625+ <doc xml:space="preserve"
2626+ filename="src/adw-about-window.c"
2627+ line="2684">the link title</doc>
2628+ <type name="utf8" c:type="const char*"/>
2629+ </parameter>
2630+ <parameter name="url" transfer-ownership="none">
2631+ <doc xml:space="preserve"
2632+ filename="src/adw-about-window.c"
2633+ line="2685">the link URL</doc>
2634+ <type name="utf8" c:type="const char*"/>
2635+ </parameter>
23852636 </parameters>
23862637 </method>
2387- <method name="get_icon_name"
2388- c:identifier="adw_action_row_get_icon_name"
2389- glib:get-property="icon-name"
2638+ <method name="get_application_icon"
2639+ c:identifier="adw_about_window_get_application_icon"
2640+ glib:get-property="application-icon"
2641+ version="1.2"
23902642 deprecated="1"
2391- deprecated-version="1.3">
2392- <attribute name="org.gtk.Method.get_property" value="icon-name"/>
2643+ deprecated-version="1.6">
23932644 <doc xml:space="preserve"
2394- filename="src/adw-action-row.c"
2395- line="524">Gets the icon name for @self.</doc>
2396- <doc-deprecated xml:space="preserve">Use [method@ActionRow.add_prefix] to add an icon.</doc-deprecated>
2397- <source-position filename="src/adw-action-row.h" line="59"/>
2398- <return-value transfer-ownership="none" nullable="1">
2645+ filename="src/adw-about-window.c"
2646+ line="2172">Gets the name of the application icon for @self.</doc>
2647+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
2648+ <source-position filename="src/adw-about-window.h" line="39"/>
2649+ <return-value transfer-ownership="none">
23992650 <doc xml:space="preserve"
2400- filename="src/adw-action-row.c"
2401- line="530">the icon name for @self</doc>
2651+ filename="src/adw-about-window.c"
2652+ line="2178">the application icon name</doc>
24022653 <type name="utf8" c:type="const char*"/>
24032654 </return-value>
24042655 <parameters>
24052656 <instance-parameter name="self" transfer-ownership="none">
24062657 <doc xml:space="preserve"
2407- filename="src/adw-action-row.c"
2408- line="526">an action row</doc>
2409- <type name="ActionRow" c:type="AdwActionRow*"/>
2658+ filename="src/adw-about-window.c"
2659+ line="2174">an about window</doc>
2660+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
24102661 </instance-parameter>
24112662 </parameters>
24122663 </method>
2413- <method name="get_subtitle"
2414- c:identifier="adw_action_row_get_subtitle"
2415- glib:get-property="subtitle">
2416- <attribute name="org.gtk.Method.get_property" value="subtitle"/>
2664+ <method name="get_application_name"
2665+ c:identifier="adw_about_window_get_application_name"
2666+ glib:get-property="application-name"
2667+ version="1.2"
2668+ deprecated="1"
2669+ deprecated-version="1.6">
24172670 <doc xml:space="preserve"
2418- filename="src/adw-action-row.c"
2419- line="476">Gets the subtitle for @self.</doc>
2420- <source-position filename="src/adw-action-row.h" line="53"/>
2421- <return-value transfer-ownership="none" nullable="1">
2671+ filename="src/adw-about-window.c"
2672+ line="2219">Gets the application name for @self.</doc>
2673+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
2674+ <source-position filename="src/adw-about-window.h" line="33"/>
2675+ <return-value transfer-ownership="none">
24222676 <doc xml:space="preserve"
2423- filename="src/adw-action-row.c"
2424- line="482">the subtitle for @self</doc>
2677+ filename="src/adw-about-window.c"
2678+ line="2225">the application name</doc>
24252679 <type name="utf8" c:type="const char*"/>
24262680 </return-value>
24272681 <parameters>
24282682 <instance-parameter name="self" transfer-ownership="none">
24292683 <doc xml:space="preserve"
2430- filename="src/adw-action-row.c"
2431- line="478">an action row</doc>
2432- <type name="ActionRow" c:type="AdwActionRow*"/>
2684+ filename="src/adw-about-window.c"
2685+ line="2221">an about window</doc>
2686+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
24332687 </instance-parameter>
24342688 </parameters>
24352689 </method>
2436- <method name="get_subtitle_lines"
2437- c:identifier="adw_action_row_get_subtitle_lines"
2438- glib:get-property="subtitle-lines">
2439- <attribute name="org.gtk.Method.get_property" value="subtitle-lines"/>
2690+ <method name="get_artists"
2691+ c:identifier="adw_about_window_get_artists"
2692+ glib:get-property="artists"
2693+ version="1.2"
2694+ deprecated="1"
2695+ deprecated-version="1.6">
24402696 <doc xml:space="preserve"
2441- filename="src/adw-action-row.c"
2442- line="724">Gets the number of lines at the end of which the subtitle label will be
2443-ellipsized.</doc>
2444- <source-position filename="src/adw-action-row.h" line="77"/>
2445- <return-value transfer-ownership="none">
2697+ filename="src/adw-about-window.c"
2698+ line="2954">Gets the list of artists of the application.</doc>
2699+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
2700+ <source-position filename="src/adw-about-window.h" line="122"/>
2701+ <return-value transfer-ownership="none" nullable="1">
24462702 <doc xml:space="preserve"
2447- filename="src/adw-action-row.c"
2448- line="731">the number of lines at the end of which the subtitle label will be
2449- ellipsized</doc>
2450- <type name="gint" c:type="int"/>
2703+ filename="src/adw-about-window.c"
2704+ line="2960">The list of artists</doc>
2705+ <array c:type="const char* const*">
2706+ <type name="utf8"/>
2707+ </array>
24512708 </return-value>
24522709 <parameters>
24532710 <instance-parameter name="self" transfer-ownership="none">
24542711 <doc xml:space="preserve"
2455- filename="src/adw-action-row.c"
2456- line="726">an action row</doc>
2457- <type name="ActionRow" c:type="AdwActionRow*"/>
2712+ filename="src/adw-about-window.c"
2713+ line="2956">an about window</doc>
2714+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
24582715 </instance-parameter>
24592716 </parameters>
24602717 </method>
2461- <method name="get_subtitle_selectable"
2462- c:identifier="adw_action_row_get_subtitle_selectable"
2463- glib:get-property="subtitle-selectable"
2464- version="1.3">
2465- <attribute name="org.gtk.Method.get_property"
2466- value="subtitle-selectable"/>
2718+ <method name="get_comments"
2719+ c:identifier="adw_about_window_get_comments"
2720+ glib:get-property="comments"
2721+ version="1.2"
2722+ deprecated="1"
2723+ deprecated-version="1.6">
24672724 <doc xml:space="preserve"
2468- filename="src/adw-action-row.c"
2469- line="778">Gets whether the user can copy the subtitle from the label</doc>
2470- <source-position filename="src/adw-action-row.h" line="83"/>
2725+ filename="src/adw-about-window.c"
2726+ line="2491">Gets the comments about the application.</doc>
2727+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
2728+ <source-position filename="src/adw-about-window.h" line="69"/>
24712729 <return-value transfer-ownership="none">
24722730 <doc xml:space="preserve"
2473- filename="src/adw-action-row.c"
2474- line="784">whether the user can copy the subtitle from the label</doc>
2475- <type name="gboolean" c:type="gboolean"/>
2731+ filename="src/adw-about-window.c"
2732+ line="2497">the comments</doc>
2733+ <type name="utf8" c:type="const char*"/>
24762734 </return-value>
24772735 <parameters>
24782736 <instance-parameter name="self" transfer-ownership="none">
24792737 <doc xml:space="preserve"
2480- filename="src/adw-action-row.c"
2481- line="780">a `AdwActionRow`</doc>
2482- <type name="ActionRow" c:type="AdwActionRow*"/>
2738+ filename="src/adw-about-window.c"
2739+ line="2493">an about window</doc>
2740+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
24832741 </instance-parameter>
24842742 </parameters>
24852743 </method>
2486- <method name="get_title_lines"
2487- c:identifier="adw_action_row_get_title_lines"
2488- glib:get-property="title-lines">
2489- <attribute name="org.gtk.Method.get_property" value="title-lines"/>
2744+ <method name="get_copyright"
2745+ c:identifier="adw_about_window_get_copyright"
2746+ glib:get-property="copyright"
2747+ version="1.2"
2748+ deprecated="1"
2749+ deprecated-version="1.6">
24902750 <doc xml:space="preserve"
2491- filename="src/adw-action-row.c"
2492- line="670">Gets the number of lines at the end of which the title label will be
2493-ellipsized.</doc>
2494- <source-position filename="src/adw-action-row.h" line="71"/>
2751+ filename="src/adw-about-window.c"
2752+ line="3221">Gets the copyright information for @self.</doc>
2753+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
2754+ <source-position filename="src/adw-about-window.h" line="150"/>
24952755 <return-value transfer-ownership="none">
24962756 <doc xml:space="preserve"
2497- filename="src/adw-action-row.c"
2498- line="677">the number of lines at the end of which the title label will be
2499- ellipsized</doc>
2500- <type name="gint" c:type="int"/>
2757+ filename="src/adw-about-window.c"
2758+ line="3227">the copyright information</doc>
2759+ <type name="utf8" c:type="const char*"/>
25012760 </return-value>
25022761 <parameters>
25032762 <instance-parameter name="self" transfer-ownership="none">
25042763 <doc xml:space="preserve"
2505- filename="src/adw-action-row.c"
2506- line="672">an action row</doc>
2507- <type name="ActionRow" c:type="AdwActionRow*"/>
2764+ filename="src/adw-about-window.c"
2765+ line="3223">an about window</doc>
2766+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
25082767 </instance-parameter>
25092768 </parameters>
25102769 </method>
2511- <method name="remove" c:identifier="adw_action_row_remove">
2770+ <method name="get_debug_info"
2771+ c:identifier="adw_about_window_get_debug_info"
2772+ glib:get-property="debug-info"
2773+ version="1.2"
2774+ deprecated="1"
2775+ deprecated-version="1.6">
25122776 <doc xml:space="preserve"
2513- filename="src/adw-action-row.c"
2514- line="446">Removes a child from @self.</doc>
2515- <source-position filename="src/adw-action-row.h" line="49"/>
2777+ filename="src/adw-about-window.c"
2778+ line="2733">Gets the debug information for @self.</doc>
2779+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
2780+ <source-position filename="src/adw-about-window.h" line="98"/>
25162781 <return-value transfer-ownership="none">
2517- <type name="none" c:type="void"/>
2782+ <doc xml:space="preserve"
2783+ filename="src/adw-about-window.c"
2784+ line="2739">the debug information</doc>
2785+ <type name="utf8" c:type="const char*"/>
25182786 </return-value>
25192787 <parameters>
25202788 <instance-parameter name="self" transfer-ownership="none">
25212789 <doc xml:space="preserve"
2522- filename="src/adw-action-row.c"
2523- line="448">an action row</doc>
2524- <type name="ActionRow" c:type="AdwActionRow*"/>
2790+ filename="src/adw-about-window.c"
2791+ line="2735">an about window</doc>
2792+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
25252793 </instance-parameter>
2526- <parameter name="widget" transfer-ownership="none">
2527- <doc xml:space="preserve"
2528- filename="src/adw-action-row.c"
2529- line="449">the child to be removed</doc>
2530- <type name="Gtk.Widget" c:type="GtkWidget*"/>
2531- </parameter>
25322794 </parameters>
25332795 </method>
2534- <method name="set_activatable_widget"
2535- c:identifier="adw_action_row_set_activatable_widget"
2536- glib:set-property="activatable-widget">
2537- <attribute name="org.gtk.Method.set_property"
2538- value="activatable-widget"/>
2796+ <method name="get_debug_info_filename"
2797+ c:identifier="adw_about_window_get_debug_info_filename"
2798+ glib:get-property="debug-info-filename"
2799+ version="1.2"
2800+ deprecated="1"
2801+ deprecated-version="1.6">
25392802 <doc xml:space="preserve"
2540- filename="src/adw-action-row.c"
2541- line="608">Sets the widget to activate when @self is activated.
2542-
2543-The row can be activated either by clicking on it, calling
2544-[method@ActionRow.activate], or via mnemonics in the title.
2545-See the [property@PreferencesRow:use-underline] property to enable mnemonics.
2546-
2547-The target widget will be activated by emitting the
2548-[signal@Gtk.Widget::mnemonic-activate] signal on it.</doc>
2549- <source-position filename="src/adw-action-row.h" line="67"/>
2803+ filename="src/adw-about-window.c"
2804+ line="2787">Gets the debug information filename for @self.</doc>
2805+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
2806+ <source-position filename="src/adw-about-window.h" line="104"/>
25502807 <return-value transfer-ownership="none">
2551- <type name="none" c:type="void"/>
2808+ <doc xml:space="preserve"
2809+ filename="src/adw-about-window.c"
2810+ line="2793">the debug information filename</doc>
2811+ <type name="utf8" c:type="const char*"/>
25522812 </return-value>
25532813 <parameters>
25542814 <instance-parameter name="self" transfer-ownership="none">
25552815 <doc xml:space="preserve"
2556- filename="src/adw-action-row.c"
2557- line="610">an action row</doc>
2558- <type name="ActionRow" c:type="AdwActionRow*"/>
2816+ filename="src/adw-about-window.c"
2817+ line="2789">an about window</doc>
2818+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
25592819 </instance-parameter>
2560- <parameter name="widget"
2561- transfer-ownership="none"
2562- nullable="1"
2563- allow-none="1">
2564- <doc xml:space="preserve"
2565- filename="src/adw-action-row.c"
2566- line="611">the target widget</doc>
2567- <type name="Gtk.Widget" c:type="GtkWidget*"/>
2568- </parameter>
25692820 </parameters>
25702821 </method>
2571- <method name="set_icon_name"
2572- c:identifier="adw_action_row_set_icon_name"
2573- glib:set-property="icon-name"
2822+ <method name="get_designers"
2823+ c:identifier="adw_about_window_get_designers"
2824+ glib:get-property="designers"
2825+ version="1.2"
25742826 deprecated="1"
2575- deprecated-version="1.3">
2576- <attribute name="org.gtk.Method.set_property" value="icon-name"/>
2827+ deprecated-version="1.6">
25772828 <doc xml:space="preserve"
2578- filename="src/adw-action-row.c"
2579- line="546">Sets the icon name for @self.</doc>
2580- <doc-deprecated xml:space="preserve">Use [method@ActionRow.add_prefix] to add an icon.</doc-deprecated>
2581- <source-position filename="src/adw-action-row.h" line="61"/>
2582- <return-value transfer-ownership="none">
2583- <type name="none" c:type="void"/>
2829+ filename="src/adw-about-window.c"
2830+ line="2894">Gets the list of designers of the application.</doc>
2831+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
2832+ <source-position filename="src/adw-about-window.h" line="116"/>
2833+ <return-value transfer-ownership="none" nullable="1">
2834+ <doc xml:space="preserve"
2835+ filename="src/adw-about-window.c"
2836+ line="2900">The list of designers</doc>
2837+ <array c:type="const char* const*">
2838+ <type name="utf8"/>
2839+ </array>
25842840 </return-value>
25852841 <parameters>
25862842 <instance-parameter name="self" transfer-ownership="none">
25872843 <doc xml:space="preserve"
2588- filename="src/adw-action-row.c"
2589- line="548">an action row</doc>
2590- <type name="ActionRow" c:type="AdwActionRow*"/>
2844+ filename="src/adw-about-window.c"
2845+ line="2896">an about window</doc>
2846+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
25912847 </instance-parameter>
2592- <parameter name="icon_name"
2593- transfer-ownership="none"
2594- nullable="1"
2595- allow-none="1">
2596- <doc xml:space="preserve"
2597- filename="src/adw-action-row.c"
2598- line="549">the icon name</doc>
2599- <type name="utf8" c:type="const char*"/>
2600- </parameter>
26012848 </parameters>
26022849 </method>
2603- <method name="set_subtitle"
2604- c:identifier="adw_action_row_set_subtitle"
2605- glib:set-property="subtitle">
2606- <attribute name="org.gtk.Method.set_property" value="subtitle"/>
2850+ <method name="get_developer_name"
2851+ c:identifier="adw_about_window_get_developer_name"
2852+ glib:get-property="developer-name"
2853+ version="1.2"
2854+ deprecated="1"
2855+ deprecated-version="1.6">
26072856 <doc xml:space="preserve"
2608- filename="src/adw-action-row.c"
2609- line="496">Sets the subtitle for @self.
2610-
2611-The subtitle is interpreted as Pango markup unless
2612-[property@PreferencesRow:use-markup] is set to `FALSE`.</doc>
2613- <source-position filename="src/adw-action-row.h" line="55"/>
2857+ filename="src/adw-about-window.c"
2858+ line="2266">Gets the developer name for @self.</doc>
2859+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
2860+ <source-position filename="src/adw-about-window.h" line="45"/>
26142861 <return-value transfer-ownership="none">
2615- <type name="none" c:type="void"/>
2862+ <doc xml:space="preserve"
2863+ filename="src/adw-about-window.c"
2864+ line="2272">the developer_name</doc>
2865+ <type name="utf8" c:type="const char*"/>
26162866 </return-value>
26172867 <parameters>
26182868 <instance-parameter name="self" transfer-ownership="none">
26192869 <doc xml:space="preserve"
2620- filename="src/adw-action-row.c"
2621- line="498">an action row</doc>
2622- <type name="ActionRow" c:type="AdwActionRow*"/>
2870+ filename="src/adw-about-window.c"
2871+ line="2268">an about window</doc>
2872+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
26232873 </instance-parameter>
2624- <parameter name="subtitle" transfer-ownership="none">
2625- <doc xml:space="preserve"
2626- filename="src/adw-action-row.c"
2627- line="499">the subtitle</doc>
2628- <type name="utf8" c:type="const char*"/>
2629- </parameter>
26302874 </parameters>
26312875 </method>
2632- <method name="set_subtitle_lines"
2633- c:identifier="adw_action_row_set_subtitle_lines"
2634- glib:set-property="subtitle-lines">
2635- <attribute name="org.gtk.Method.set_property" value="subtitle-lines"/>
2876+ <method name="get_developers"
2877+ c:identifier="adw_about_window_get_developers"
2878+ glib:get-property="developers"
2879+ version="1.2"
2880+ deprecated="1"
2881+ deprecated-version="1.6">
26362882 <doc xml:space="preserve"
2637- filename="src/adw-action-row.c"
2638- line="746">Sets the number of lines at the end of which the subtitle label will be
2639-ellipsized.
2640-
2641-If the value is 0, the number of lines won't be limited.</doc>
2642- <source-position filename="src/adw-action-row.h" line="79"/>
2643- <return-value transfer-ownership="none">
2644- <type name="none" c:type="void"/>
2883+ filename="src/adw-about-window.c"
2884+ line="2834">Gets the list of developers of the application.</doc>
2885+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
2886+ <source-position filename="src/adw-about-window.h" line="110"/>
2887+ <return-value transfer-ownership="none" nullable="1">
2888+ <doc xml:space="preserve"
2889+ filename="src/adw-about-window.c"
2890+ line="2840">The list of developers</doc>
2891+ <array c:type="const char* const*">
2892+ <type name="utf8"/>
2893+ </array>
26452894 </return-value>
26462895 <parameters>
26472896 <instance-parameter name="self" transfer-ownership="none">
26482897 <doc xml:space="preserve"
2649- filename="src/adw-action-row.c"
2650- line="748">an action row</doc>
2651- <type name="ActionRow" c:type="AdwActionRow*"/>
2898+ filename="src/adw-about-window.c"
2899+ line="2836">an about window</doc>
2900+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
26522901 </instance-parameter>
2653- <parameter name="subtitle_lines" transfer-ownership="none">
2654- <doc xml:space="preserve"
2655- filename="src/adw-action-row.c"
2656- line="749">the number of lines at the end of which the subtitle label will be ellipsized</doc>
2657- <type name="gint" c:type="int"/>
2658- </parameter>
26592902 </parameters>
26602903 </method>
2661- <method name="set_subtitle_selectable"
2662- c:identifier="adw_action_row_set_subtitle_selectable"
2663- glib:set-property="subtitle-selectable"
2664- version="1.3">
2665- <attribute name="org.gtk.Method.set_property"
2666- value="subtitle-selectable"/>
2904+ <method name="get_documenters"
2905+ c:identifier="adw_about_window_get_documenters"
2906+ glib:get-property="documenters"
2907+ version="1.2"
2908+ deprecated="1"
2909+ deprecated-version="1.6">
26672910 <doc xml:space="preserve"
2668- filename="src/adw-action-row.c"
2669- line="798">Sets whether the user can copy the subtitle from the label
2670-
2671-See also [property@Gtk.Label:selectable].</doc>
2672- <source-position filename="src/adw-action-row.h" line="86"/>
2673- <return-value transfer-ownership="none">
2674- <type name="none" c:type="void"/>
2911+ filename="src/adw-about-window.c"
2912+ line="3014">Gets the list of documenters of the application.</doc>
2913+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
2914+ <source-position filename="src/adw-about-window.h" line="128"/>
2915+ <return-value transfer-ownership="none" nullable="1">
2916+ <doc xml:space="preserve"
2917+ filename="src/adw-about-window.c"
2918+ line="3020">The list of documenters</doc>
2919+ <array c:type="const char* const*">
2920+ <type name="utf8"/>
2921+ </array>
26752922 </return-value>
26762923 <parameters>
26772924 <instance-parameter name="self" transfer-ownership="none">
26782925 <doc xml:space="preserve"
2679- filename="src/adw-action-row.c"
2680- line="800">a `AdwActionRow`</doc>
2681- <type name="ActionRow" c:type="AdwActionRow*"/>
2926+ filename="src/adw-about-window.c"
2927+ line="3016">an about window</doc>
2928+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
26822929 </instance-parameter>
2683- <parameter name="subtitle_selectable" transfer-ownership="none">
2684- <doc xml:space="preserve"
2685- filename="src/adw-action-row.c"
2686- line="801">`TRUE` if the user can copy the subtitle from the label</doc>
2687- <type name="gboolean" c:type="gboolean"/>
2688- </parameter>
26892930 </parameters>
26902931 </method>
2691- <method name="set_title_lines"
2692- c:identifier="adw_action_row_set_title_lines"
2693- glib:set-property="title-lines">
2694- <attribute name="org.gtk.Method.set_property" value="title-lines"/>
2932+ <method name="get_issue_url"
2933+ c:identifier="adw_about_window_get_issue_url"
2934+ glib:get-property="issue-url"
2935+ version="1.2"
2936+ deprecated="1"
2937+ deprecated-version="1.6">
26952938 <doc xml:space="preserve"
2696- filename="src/adw-action-row.c"
2697- line="692">Sets the number of lines at the end of which the title label will be
2698-ellipsized.
2699-
2700-If the value is 0, the number of lines won't be limited.</doc>
2701- <source-position filename="src/adw-action-row.h" line="73"/>
2939+ filename="src/adw-about-window.c"
2940+ line="2635">Gets the issue tracker URL for @self.</doc>
2941+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
2942+ <source-position filename="src/adw-about-window.h" line="87"/>
27022943 <return-value transfer-ownership="none">
2703- <type name="none" c:type="void"/>
2944+ <doc xml:space="preserve"
2945+ filename="src/adw-about-window.c"
2946+ line="2641">the issue tracker URL</doc>
2947+ <type name="utf8" c:type="const char*"/>
27042948 </return-value>
27052949 <parameters>
27062950 <instance-parameter name="self" transfer-ownership="none">
27072951 <doc xml:space="preserve"
2708- filename="src/adw-action-row.c"
2709- line="694">an action row</doc>
2710- <type name="ActionRow" c:type="AdwActionRow*"/>
2952+ filename="src/adw-about-window.c"
2953+ line="2637">an about window</doc>
2954+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
27112955 </instance-parameter>
2712- <parameter name="title_lines" transfer-ownership="none">
2713- <doc xml:space="preserve"
2714- filename="src/adw-action-row.c"
2715- line="695">the number of lines at the end of which the title label will be ellipsized</doc>
2716- <type name="gint" c:type="int"/>
2717- </parameter>
27182956 </parameters>
27192957 </method>
2720- <property name="activatable-widget"
2721- writable="1"
2722- transfer-ownership="none"
2723- setter="set_activatable_widget"
2724- getter="get_activatable_widget">
2725- <attribute name="org.gtk.Property.get"
2726- value="adw_action_row_get_activatable_widget"/>
2727- <attribute name="org.gtk.Property.set"
2728- value="adw_action_row_set_activatable_widget"/>
2958+ <method name="get_license"
2959+ c:identifier="adw_about_window_get_license"
2960+ glib:get-property="license"
2961+ version="1.2"
2962+ deprecated="1"
2963+ deprecated-version="1.6">
27292964 <doc xml:space="preserve"
2730- filename="src/adw-action-row.c"
2731- line="262">The widget to activate when the row is activated.
2732-
2733-The row can be activated either by clicking on it, calling
2734-[method@ActionRow.activate], or via mnemonics in the title.
2735-See the [property@PreferencesRow:use-underline] property to enable
2736-mnemonics.
2737-
2738-The target widget will be activated by emitting the
2739-[signal@Gtk.Widget::mnemonic-activate] signal on it.</doc>
2740- <type name="Gtk.Widget"/>
2741- </property>
2742- <property name="icon-name"
2743- deprecated="1"
2744- deprecated-version="1.3"
2745- writable="1"
2746- transfer-ownership="none"
2747- setter="set_icon_name"
2748- getter="get_icon_name">
2749- <attribute name="org.gtk.Property.get"
2750- value="adw_action_row_get_icon_name"/>
2751- <attribute name="org.gtk.Property.set"
2752- value="adw_action_row_set_icon_name"/>
2753- <doc xml:space="preserve"
2754- filename="src/adw-action-row.c"
2755- line="250">The icon name for this row.</doc>
2756- <doc-deprecated xml:space="preserve">Use [method@ActionRow.add_prefix] to add an icon.</doc-deprecated>
2757- <type name="utf8" c:type="gchar*"/>
2758- </property>
2759- <property name="subtitle"
2760- writable="1"
2761- transfer-ownership="none"
2762- setter="set_subtitle"
2763- getter="get_subtitle">
2764- <attribute name="org.gtk.Property.get"
2765- value="adw_action_row_get_subtitle"/>
2766- <attribute name="org.gtk.Property.set"
2767- value="adw_action_row_set_subtitle"/>
2768- <doc xml:space="preserve"
2769- filename="src/adw-action-row.c"
2770- line="237">The subtitle for this row.
2771-
2772-The subtitle is interpreted as Pango markup unless
2773-[property@PreferencesRow:use-markup] is set to `FALSE`.</doc>
2774- <type name="utf8" c:type="gchar*"/>
2775- </property>
2776- <property name="subtitle-lines"
2777- writable="1"
2778- transfer-ownership="none"
2779- setter="set_subtitle_lines"
2780- getter="get_subtitle_lines"
2781- default-value="0">
2782- <attribute name="org.gtk.Property.get"
2783- value="adw_action_row_get_subtitle_lines"/>
2784- <attribute name="org.gtk.Property.set"
2785- value="adw_action_row_set_subtitle_lines"/>
2786- <doc xml:space="preserve"
2787- filename="src/adw-action-row.c"
2788- line="293">The number of lines at the end of which the subtitle label will be
2789-ellipsized.
2790-
2791-If the value is 0, the number of lines won't be limited.</doc>
2792- <type name="gint" c:type="gint"/>
2793- </property>
2794- <property name="subtitle-selectable"
2795- version="1.3"
2796- writable="1"
2797- transfer-ownership="none"
2798- setter="set_subtitle_selectable"
2799- getter="get_subtitle_selectable"
2800- default-value="FALSE">
2801- <attribute name="org.gtk.Property.get"
2802- value="adw_action_row_get_subtitle_selectable"/>
2803- <attribute name="org.gtk.Property.set"
2804- value="adw_action_row_set_subtitle_selectable"/>
2805- <doc xml:space="preserve"
2806- filename="src/adw-action-row.c"
2807- line="307">Whether the user can copy the subtitle from the label.
2808-
2809-See also [property@Gtk.Label:selectable].</doc>
2810- <type name="gboolean" c:type="gboolean"/>
2811- </property>
2812- <property name="title-lines"
2813- writable="1"
2814- transfer-ownership="none"
2815- setter="set_title_lines"
2816- getter="get_title_lines"
2817- default-value="0">
2818- <attribute name="org.gtk.Property.get"
2819- value="adw_action_row_get_title_lines"/>
2820- <attribute name="org.gtk.Property.set"
2821- value="adw_action_row_set_title_lines"/>
2822- <doc xml:space="preserve"
2823- filename="src/adw-action-row.c"
2824- line="280">The number of lines at the end of which the title label will be ellipsized.
2825-
2826-If the value is 0, the number of lines won't be limited.</doc>
2827- <type name="gint" c:type="gint"/>
2828- </property>
2829- <field name="parent_instance">
2830- <type name="PreferencesRow" c:type="AdwPreferencesRow"/>
2831- </field>
2832- <glib:signal name="activated" when="last">
2833- <doc xml:space="preserve"
2834- filename="src/adw-action-row.c"
2835- line="323">This signal is emitted after the row has been activated.</doc>
2836- <return-value transfer-ownership="none">
2837- <type name="none" c:type="void"/>
2838- </return-value>
2839- </glib:signal>
2840- </class>
2841- <record name="ActionRowClass"
2842- c:type="AdwActionRowClass"
2843- glib:is-gtype-struct-for="ActionRow">
2844- <source-position filename="src/adw-action-row.h" line="37"/>
2845- <field name="parent_class">
2846- <doc xml:space="preserve"
2847- filename="src/adw-action-row.h"
2848- line="26">The parent class</doc>
2849- <type name="PreferencesRowClass" c:type="AdwPreferencesRowClass"/>
2850- </field>
2851- <field name="activate">
2852- <callback name="activate">
2853- <source-position filename="src/adw-action-row.h" line="33"/>
2854- <return-value transfer-ownership="none">
2855- <type name="none" c:type="void"/>
2856- </return-value>
2857- <parameters>
2858- <parameter name="self" transfer-ownership="none">
2859- <doc xml:space="preserve"
2860- filename="src/adw-action-row.c"
2861- line="829">an action row</doc>
2862- <type name="ActionRow" c:type="AdwActionRow*"/>
2863- </parameter>
2864- </parameters>
2865- </callback>
2866- </field>
2867- <field name="padding" readable="0" private="1">
2868- <array zero-terminated="0" fixed-size="4">
2869- <type name="gpointer" c:type="gpointer"/>
2870- </array>
2871- </field>
2872- </record>
2873- <class name="Animation"
2874- c:symbol-prefix="animation"
2875- c:type="AdwAnimation"
2876- parent="GObject.Object"
2877- abstract="1"
2878- glib:type-name="AdwAnimation"
2879- glib:get-type="adw_animation_get_type"
2880- glib:type-struct="AnimationClass">
2881- <doc xml:space="preserve"
2882- filename="src/adw-animation.c"
2883- line="16">A base class for animations.
2884-
2885-`AdwAnimation` represents an animation on a widget. It has a target that
2886-provides a value to animate, and a state indicating whether the
2887-animation hasn't been started yet, is playing, paused or finished.
2888-
2889-Currently there are two concrete animation types:
2890-[class@TimedAnimation] and [class@SpringAnimation].
2891-
2892-`AdwAnimation` will automatically skip the animation if
2893-[property@Animation:widget] is unmapped, or if
2894-[property@Gtk.Settings:gtk-enable-animations] is `FALSE`.
2895-
2896-The [signal@Animation::done] signal can be used to perform an action after
2897-the animation ends, for example hiding a widget after animating its
2898-[property@Gtk.Widget:opacity] to 0.
2899-
2900-`AdwAnimation` will be kept alive while the animation is playing. As such,
2901-it's safe to create an animation, start it and immediately unref it:
2902-A fire-and-forget animation:
2903-
2904-```c
2905-static void
2906-animation_cb (double value,
2907- MyObject *self)
2908-{
2909- // Do something with @value
2910-}
2911-
2912-static void
2913-my_object_animate (MyObject *self)
2914-{
2915- AdwAnimationTarget *target =
2916- adw_callback_animation_target_new ((AdwAnimationTargetFunc) animation_cb,
2917- self, NULL);
2918- g_autoptr (AdwAnimation) animation =
2919- adw_timed_animation_new (widget, 0, 1, 250, target);
2920-
2921- adw_animation_play (animation);
2922-}
2923-```
2924-
2925-If there's a chance the previous animation for the same target hasn't yet
2926-finished, the previous animation should be stopped first, or the existing
2927-`AdwAnimation` object can be reused.</doc>
2928- <source-position filename="src/adw-animation.h" line="36"/>
2929- <method name="get_follow_enable_animations_setting"
2930- c:identifier="adw_animation_get_follow_enable_animations_setting"
2931- glib:get-property="follow-enable-animations-setting"
2932- version="1.3">
2933- <attribute name="org.gtk.Method.get_property"
2934- value="follow-enable-animations-setting"/>
2935- <doc xml:space="preserve"
2936- filename="src/adw-animation.c"
2937- line="762">Gets whether @self should be skipped when animations are globally disabled.</doc>
2938- <source-position filename="src/adw-animation.h" line="72"/>
2965+ filename="src/adw-about-window.c"
2966+ line="3340">Gets the license for @self.</doc>
2967+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
2968+ <source-position filename="src/adw-about-window.h" line="162"/>
29392969 <return-value transfer-ownership="none">
29402970 <doc xml:space="preserve"
2941- filename="src/adw-animation.c"
2942- line="768">whether to follow the global setting</doc>
2943- <type name="gboolean" c:type="gboolean"/>
2971+ filename="src/adw-about-window.c"
2972+ line="3346">the license</doc>
2973+ <type name="utf8" c:type="const char*"/>
29442974 </return-value>
29452975 <parameters>
29462976 <instance-parameter name="self" transfer-ownership="none">
29472977 <doc xml:space="preserve"
2948- filename="src/adw-animation.c"
2949- line="764">an animation</doc>
2950- <type name="Animation" c:type="AdwAnimation*"/>
2978+ filename="src/adw-about-window.c"
2979+ line="3342">an about window</doc>
2980+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
29512981 </instance-parameter>
29522982 </parameters>
29532983 </method>
2954- <method name="get_state"
2955- c:identifier="adw_animation_get_state"
2956- glib:get-property="state">
2957- <attribute name="org.gtk.Method.get_property" value="state"/>
2984+ <method name="get_license_type"
2985+ c:identifier="adw_about_window_get_license_type"
2986+ glib:get-property="license-type"
2987+ version="1.2"
2988+ deprecated="1"
2989+ deprecated-version="1.6">
29582990 <doc xml:space="preserve"
2959- filename="src/adw-animation.c"
2960- line="549">Gets the current value of @self.
2961-
2962-The state indicates whether @self is currently playing, paused, finished or
2963-hasn't been started yet.</doc>
2964- <source-position filename="src/adw-animation.h" line="58"/>
2991+ filename="src/adw-about-window.c"
2992+ line="3274">Gets the license type for @self.</doc>
2993+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
2994+ <source-position filename="src/adw-about-window.h" line="156"/>
29652995 <return-value transfer-ownership="none">
29662996 <doc xml:space="preserve"
2967- filename="src/adw-animation.c"
2968- line="558">the animation value</doc>
2969- <type name="AnimationState" c:type="AdwAnimationState"/>
2997+ filename="src/adw-about-window.c"
2998+ line="3280">the license type</doc>
2999+ <type name="Gtk.License" c:type="GtkLicense"/>
29703000 </return-value>
29713001 <parameters>
29723002 <instance-parameter name="self" transfer-ownership="none">
29733003 <doc xml:space="preserve"
2974- filename="src/adw-animation.c"
2975- line="551">an animation</doc>
2976- <type name="Animation" c:type="AdwAnimation*"/>
3004+ filename="src/adw-about-window.c"
3005+ line="3276">an about window</doc>
3006+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
29773007 </instance-parameter>
29783008 </parameters>
29793009 </method>
2980- <method name="get_target"
2981- c:identifier="adw_animation_get_target"
2982- glib:get-property="target">
2983- <attribute name="org.gtk.Method.get_property" value="target"/>
3010+ <method name="get_release_notes"
3011+ c:identifier="adw_about_window_get_release_notes"
3012+ glib:get-property="release-notes"
3013+ version="1.2"
3014+ deprecated="1"
3015+ deprecated-version="1.6">
29843016 <doc xml:space="preserve"
2985- filename="src/adw-animation.c"
2986- line="483">Gets the target @self animates.</doc>
2987- <source-position filename="src/adw-animation.h" line="49"/>
3017+ filename="src/adw-about-window.c"
3018+ line="2423">Gets the release notes for @self.</doc>
3019+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
3020+ <source-position filename="src/adw-about-window.h" line="63"/>
29883021 <return-value transfer-ownership="none">
29893022 <doc xml:space="preserve"
2990- filename="src/adw-animation.c"
2991- line="489">the animation target</doc>
2992- <type name="AnimationTarget" c:type="AdwAnimationTarget*"/>
3023+ filename="src/adw-about-window.c"
3024+ line="2429">the release notes</doc>
3025+ <type name="utf8" c:type="const char*"/>
29933026 </return-value>
29943027 <parameters>
29953028 <instance-parameter name="self" transfer-ownership="none">
29963029 <doc xml:space="preserve"
2997- filename="src/adw-animation.c"
2998- line="485">an animation</doc>
2999- <type name="Animation" c:type="AdwAnimation*"/>
3030+ filename="src/adw-about-window.c"
3031+ line="2425">an about window</doc>
3032+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
30003033 </instance-parameter>
30013034 </parameters>
30023035 </method>
3003- <method name="get_value"
3004- c:identifier="adw_animation_get_value"
3005- glib:get-property="value">
3006- <attribute name="org.gtk.Method.get_property" value="value"/>
3036+ <method name="get_release_notes_version"
3037+ c:identifier="adw_about_window_get_release_notes_version"
3038+ glib:get-property="release-notes-version"
3039+ version="1.2"
3040+ deprecated="1"
3041+ deprecated-version="1.6">
30073042 <doc xml:space="preserve"
3008- filename="src/adw-animation.c"
3009- line="529">Gets the current value of @self.</doc>
3010- <source-position filename="src/adw-animation.h" line="55"/>
3043+ filename="src/adw-about-window.c"
3044+ line="2367">Gets the version described by the application's release notes.</doc>
3045+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
3046+ <source-position filename="src/adw-about-window.h" line="57"/>
30113047 <return-value transfer-ownership="none">
30123048 <doc xml:space="preserve"
3013- filename="src/adw-animation.c"
3014- line="535">the current value</doc>
3015- <type name="gdouble" c:type="double"/>
3049+ filename="src/adw-about-window.c"
3050+ line="2373">the release notes version</doc>
3051+ <type name="utf8" c:type="const char*"/>
30163052 </return-value>
30173053 <parameters>
30183054 <instance-parameter name="self" transfer-ownership="none">
30193055 <doc xml:space="preserve"
3020- filename="src/adw-animation.c"
3021- line="531">an animation</doc>
3022- <type name="Animation" c:type="AdwAnimation*"/>
3056+ filename="src/adw-about-window.c"
3057+ line="2369">an about window</doc>
3058+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
30233059 </instance-parameter>
30243060 </parameters>
30253061 </method>
3026- <method name="get_widget"
3027- c:identifier="adw_animation_get_widget"
3028- glib:get-property="widget">
3029- <attribute name="org.gtk.Method.get_property" value="widget"/>
3062+ <method name="get_support_url"
3063+ c:identifier="adw_about_window_get_support_url"
3064+ glib:get-property="support-url"
3065+ version="1.2"
3066+ deprecated="1"
3067+ deprecated-version="1.6">
30303068 <doc xml:space="preserve"
3031- filename="src/adw-animation.c"
3032- line="456">Gets the widget @self was created for.
3033-
3034-It provides the frame clock for the animation. It's not strictly necessary
3035-for this widget to be same as the one being animated.
3036-
3037-The widget must be mapped in order for the animation to work. If it's not
3038-mapped, or if it gets unmapped during an ongoing animation, the animation
3039-will be automatically skipped.</doc>
3040- <source-position filename="src/adw-animation.h" line="46"/>
3069+ filename="src/adw-about-window.c"
3070+ line="2589">Gets the URL of the support page for @self.</doc>
3071+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
3072+ <source-position filename="src/adw-about-window.h" line="81"/>
30413073 <return-value transfer-ownership="none">
30423074 <doc xml:space="preserve"
3043- filename="src/adw-animation.c"
3044- line="469">the animation widget</doc>
3045- <type name="Gtk.Widget" c:type="GtkWidget*"/>
3075+ filename="src/adw-about-window.c"
3076+ line="2595">the support page URL</doc>
3077+ <type name="utf8" c:type="const char*"/>
30463078 </return-value>
30473079 <parameters>
30483080 <instance-parameter name="self" transfer-ownership="none">
30493081 <doc xml:space="preserve"
3050- filename="src/adw-animation.c"
3051- line="458">an animation</doc>
3052- <type name="Animation" c:type="AdwAnimation*"/>
3082+ filename="src/adw-about-window.c"
3083+ line="2591">an about window</doc>
3084+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
30533085 </instance-parameter>
30543086 </parameters>
30553087 </method>
3056- <method name="pause" c:identifier="adw_animation_pause">
3088+ <method name="get_translator_credits"
3089+ c:identifier="adw_about_window_get_translator_credits"
3090+ glib:get-property="translator-credits"
3091+ version="1.2"
3092+ deprecated="1"
3093+ deprecated-version="1.6">
30573094 <doc xml:space="preserve"
3058- filename="src/adw-animation.c"
3059- line="610">Pauses a playing animation for @self.
3060-
3061-Does nothing if the current state of @self isn't `ADW_ANIMATION_PLAYING`.
3062-
3063-Sets [property@Animation:state] to `ADW_ANIMATION_PAUSED`.</doc>
3064- <source-position filename="src/adw-animation.h" line="63"/>
3095+ filename="src/adw-about-window.c"
3096+ line="3074">Gets the translator credits string.</doc>
3097+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
3098+ <source-position filename="src/adw-about-window.h" line="134"/>
30653099 <return-value transfer-ownership="none">
3066- <type name="none" c:type="void"/>
3100+ <doc xml:space="preserve"
3101+ filename="src/adw-about-window.c"
3102+ line="3080">The translator credits string</doc>
3103+ <type name="utf8" c:type="const char*"/>
30673104 </return-value>
30683105 <parameters>
30693106 <instance-parameter name="self" transfer-ownership="none">
30703107 <doc xml:space="preserve"
3071- filename="src/adw-animation.c"
3072- line="612">an animation</doc>
3073- <type name="Animation" c:type="AdwAnimation*"/>
3108+ filename="src/adw-about-window.c"
3109+ line="3076">an about window</doc>
3110+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
30743111 </instance-parameter>
30753112 </parameters>
30763113 </method>
3077- <method name="play" c:identifier="adw_animation_play">
3114+ <method name="get_version"
3115+ c:identifier="adw_about_window_get_version"
3116+ glib:get-property="version"
3117+ version="1.2"
3118+ deprecated="1"
3119+ deprecated-version="1.6">
30783120 <doc xml:space="preserve"
3079- filename="src/adw-animation.c"
3080- line="572">Starts the animation for @self.
3081-
3082-If the animation is playing, paused or has been completed, restarts it from
3083-the beginning. This allows to easily play an animation regardless of whether
3084-it's already playing or not.
3085-
3086-Sets [property@Animation:state] to `ADW_ANIMATION_PLAYING`.
3087-
3088-The animation will be automatically skipped if [property@Animation:widget] is
3089-unmapped, or if [property@Gtk.Settings:gtk-enable-animations] is `FALSE`.
3090-
3091-As such, it's not guaranteed that the animation will actually run. For
3092-example, when using [func@GLib.idle_add] and starting an animation
3093-immediately afterwards, it's entirely possible that the idle callback will
3094-run after the animation has already finished, and not while it's playing.</doc>
3095- <source-position filename="src/adw-animation.h" line="61"/>
3121+ filename="src/adw-about-window.c"
3122+ line="2318">Gets the version for @self.</doc>
3123+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
3124+ <source-position filename="src/adw-about-window.h" line="51"/>
30963125 <return-value transfer-ownership="none">
3097- <type name="none" c:type="void"/>
3126+ <doc xml:space="preserve"
3127+ filename="src/adw-about-window.c"
3128+ line="2324">the version</doc>
3129+ <type name="utf8" c:type="const char*"/>
30983130 </return-value>
30993131 <parameters>
31003132 <instance-parameter name="self" transfer-ownership="none">
31013133 <doc xml:space="preserve"
3102- filename="src/adw-animation.c"
3103- line="574">an animation</doc>
3104- <type name="Animation" c:type="AdwAnimation*"/>
3134+ filename="src/adw-about-window.c"
3135+ line="2320">an about window</doc>
3136+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
31053137 </instance-parameter>
31063138 </parameters>
31073139 </method>
3108- <method name="reset" c:identifier="adw_animation_reset">
3140+ <method name="get_website"
3141+ c:identifier="adw_about_window_get_website"
3142+ glib:get-property="website"
3143+ version="1.2"
3144+ deprecated="1"
3145+ deprecated-version="1.6">
31093146 <doc xml:space="preserve"
3110- filename="src/adw-animation.c"
3111- line="722">Resets the animation for @self.
3112-
3113-Sets [property@Animation:state] to `ADW_ANIMATION_IDLE`.</doc>
3114- <source-position filename="src/adw-animation.h" line="67"/>
3147+ filename="src/adw-about-window.c"
3148+ line="2540">Gets the application website URL for @self.</doc>
3149+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
3150+ <source-position filename="src/adw-about-window.h" line="75"/>
31153151 <return-value transfer-ownership="none">
3116- <type name="none" c:type="void"/>
3152+ <doc xml:space="preserve"
3153+ filename="src/adw-about-window.c"
3154+ line="2546">the website URL</doc>
3155+ <type name="utf8" c:type="const char*"/>
31173156 </return-value>
31183157 <parameters>
31193158 <instance-parameter name="self" transfer-ownership="none">
31203159 <doc xml:space="preserve"
3121- filename="src/adw-animation.c"
3122- line="724">an animation</doc>
3123- <type name="Animation" c:type="AdwAnimation*"/>
3160+ filename="src/adw-about-window.c"
3161+ line="2542">an about window</doc>
3162+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
31243163 </instance-parameter>
31253164 </parameters>
31263165 </method>
3127- <method name="resume" c:identifier="adw_animation_resume">
3166+ <method name="set_application_icon"
3167+ c:identifier="adw_about_window_set_application_icon"
3168+ glib:set-property="application-icon"
3169+ version="1.2"
3170+ deprecated="1"
3171+ deprecated-version="1.6">
31283172 <doc xml:space="preserve"
3129- filename="src/adw-animation.c"
3130- line="646">Resumes a paused animation for @self.
3131-
3132-This function must only be used if the animation has been paused with
3133-[method@Animation.pause].
3173+ filename="src/adw-about-window.c"
3174+ line="2191">Sets the name of the application icon for @self.
31343175
3135-Sets [property@Animation:state] to `ADW_ANIMATION_PLAYING`.</doc>
3136- <source-position filename="src/adw-animation.h" line="65"/>
3176+The icon is displayed at the top of the main page.</doc>
3177+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
3178+ <source-position filename="src/adw-about-window.h" line="41"/>
31373179 <return-value transfer-ownership="none">
31383180 <type name="none" c:type="void"/>
31393181 </return-value>
31403182 <parameters>
31413183 <instance-parameter name="self" transfer-ownership="none">
31423184 <doc xml:space="preserve"
3143- filename="src/adw-animation.c"
3144- line="648">an animation</doc>
3145- <type name="Animation" c:type="AdwAnimation*"/>
3185+ filename="src/adw-about-window.c"
3186+ line="2193">an about window</doc>
3187+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
31463188 </instance-parameter>
3189+ <parameter name="application_icon" transfer-ownership="none">
3190+ <doc xml:space="preserve"
3191+ filename="src/adw-about-window.c"
3192+ line="2194">the application icon name</doc>
3193+ <type name="utf8" c:type="const char*"/>
3194+ </parameter>
31473195 </parameters>
31483196 </method>
3149- <method name="set_follow_enable_animations_setting"
3150- c:identifier="adw_animation_set_follow_enable_animations_setting"
3151- glib:set-property="follow-enable-animations-setting"
3152- version="1.3">
3153- <attribute name="org.gtk.Method.set_property"
3154- value="follow-enable-animations-setting"/>
3197+ <method name="set_application_name"
3198+ c:identifier="adw_about_window_set_application_name"
3199+ glib:set-property="application-name"
3200+ version="1.2"
3201+ deprecated="1"
3202+ deprecated-version="1.6">
31553203 <doc xml:space="preserve"
3156- filename="src/adw-animation.c"
3157- line="784">Sets whether to skip @self when animations are globally disabled.
3158-
3159-The default behavior is to skip the animation. Set to `FALSE` to disable this
3160-behavior.
3161-
3162-This can be useful for cases where animation is essential, like spinners, or
3163-in demo applications. Most other animations should keep it enabled.
3204+ filename="src/adw-about-window.c"
3205+ line="2238">Sets the application name for @self.
31643206
3165-See [property@Gtk.Settings:gtk-enable-animations].</doc>
3166- <source-position filename="src/adw-animation.h" line="74"/>
3207+The name is displayed at the top of the main page.</doc>
3208+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
3209+ <source-position filename="src/adw-about-window.h" line="35"/>
31673210 <return-value transfer-ownership="none">
31683211 <type name="none" c:type="void"/>
31693212 </return-value>
31703213 <parameters>
31713214 <instance-parameter name="self" transfer-ownership="none">
31723215 <doc xml:space="preserve"
3173- filename="src/adw-animation.c"
3174- line="786">an animation</doc>
3175- <type name="Animation" c:type="AdwAnimation*"/>
3216+ filename="src/adw-about-window.c"
3217+ line="2240">an about window</doc>
3218+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
31763219 </instance-parameter>
3177- <parameter name="setting" transfer-ownership="none">
3220+ <parameter name="application_name" transfer-ownership="none">
31783221 <doc xml:space="preserve"
3179- filename="src/adw-animation.c"
3180- line="787">whether to follow the global setting</doc>
3181- <type name="gboolean" c:type="gboolean"/>
3222+ filename="src/adw-about-window.c"
3223+ line="2241">the application name</doc>
3224+ <type name="utf8" c:type="const char*"/>
31823225 </parameter>
31833226 </parameters>
31843227 </method>
3185- <method name="set_target"
3186- c:identifier="adw_animation_set_target"
3187- glib:set-property="target">
3188- <attribute name="org.gtk.Method.set_property" value="target"/>
3228+ <method name="set_artists"
3229+ c:identifier="adw_about_window_set_artists"
3230+ glib:set-property="artists"
3231+ version="1.2"
3232+ deprecated="1"
3233+ deprecated-version="1.6">
31893234 <doc xml:space="preserve"
3190- filename="src/adw-animation.c"
3191- line="503">Sets the target @self animates to @target.</doc>
3192- <source-position filename="src/adw-animation.h" line="51"/>
3235+ filename="src/adw-about-window.c"
3236+ line="2973">Sets the list of artists of the application.
3237+
3238+It will be displayed on the Credits page.
3239+
3240+Each name may contain email addresses and URLs, see the introduction for more
3241+details.
3242+
3243+See also:
3244+
3245+* [property@AboutWindow:developers]
3246+* [property@AboutWindow:designers]
3247+* [property@AboutWindow:documenters]
3248+* [property@AboutWindow:translator-credits]
3249+* [method@AboutWindow.add_credit_section]
3250+* [method@AboutWindow.add_acknowledgement_section]</doc>
3251+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
3252+ <source-position filename="src/adw-about-window.h" line="124"/>
31933253 <return-value transfer-ownership="none">
31943254 <type name="none" c:type="void"/>
31953255 </return-value>
31963256 <parameters>
31973257 <instance-parameter name="self" transfer-ownership="none">
31983258 <doc xml:space="preserve"
3199- filename="src/adw-animation.c"
3200- line="505">an animation</doc>
3201- <type name="Animation" c:type="AdwAnimation*"/>
3259+ filename="src/adw-about-window.c"
3260+ line="2975">an about window</doc>
3261+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
32023262 </instance-parameter>
3203- <parameter name="target" transfer-ownership="none">
3263+ <parameter name="artists"
3264+ transfer-ownership="none"
3265+ nullable="1"
3266+ allow-none="1">
32043267 <doc xml:space="preserve"
3205- filename="src/adw-animation.c"
3206- line="506">an animation target</doc>
3207- <type name="AnimationTarget" c:type="AdwAnimationTarget*"/>
3268+ filename="src/adw-about-window.c"
3269+ line="2976">the list of artists</doc>
3270+ <array c:type="const char**">
3271+ <type name="utf8" c:type="char*"/>
3272+ </array>
32083273 </parameter>
32093274 </parameters>
32103275 </method>
3211- <method name="skip" c:identifier="adw_animation_skip">
3276+ <method name="set_comments"
3277+ c:identifier="adw_about_window_set_comments"
3278+ glib:set-property="comments"
3279+ version="1.2"
3280+ deprecated="1"
3281+ deprecated-version="1.6">
32123282 <doc xml:space="preserve"
3213- filename="src/adw-animation.c"
3214- line="675">Skips the animation for @self.
3283+ filename="src/adw-about-window.c"
3284+ line="2510">Sets the comments about the application.
32153285
3216-If the animation hasn't been started yet, is playing, or is paused, instantly
3217-skips the animation to the end and causes [signal@Animation::done] to be
3218-emitted.
3286+Comments will be shown on the Details page, above links.
32193287
3220-Sets [property@Animation:state] to `ADW_ANIMATION_FINISHED`.</doc>
3221- <source-position filename="src/adw-animation.h" line="69"/>
3288+Unlike [property@Gtk.AboutDialog:comments], this string can be long and
3289+detailed. It can also contain links and Pango markup.</doc>
3290+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
3291+ <source-position filename="src/adw-about-window.h" line="71"/>
32223292 <return-value transfer-ownership="none">
32233293 <type name="none" c:type="void"/>
32243294 </return-value>
32253295 <parameters>
32263296 <instance-parameter name="self" transfer-ownership="none">
32273297 <doc xml:space="preserve"
3228- filename="src/adw-animation.c"
3229- line="677">an animation</doc>
3230- <type name="Animation" c:type="AdwAnimation*"/>
3298+ filename="src/adw-about-window.c"
3299+ line="2512">an about window</doc>
3300+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
32313301 </instance-parameter>
3302+ <parameter name="comments" transfer-ownership="none">
3303+ <doc xml:space="preserve"
3304+ filename="src/adw-about-window.c"
3305+ line="2513">the comments</doc>
3306+ <type name="utf8" c:type="const char*"/>
3307+ </parameter>
32323308 </parameters>
32333309 </method>
3234- <property name="follow-enable-animations-setting"
3235- version="1.3"
3236- writable="1"
3237- transfer-ownership="none"
3238- setter="set_follow_enable_animations_setting"
3239- getter="get_follow_enable_animations_setting"
3240- default-value="TRUE">
3241- <attribute name="org.gtk.Property.get"
3242- value="adw_animation_get_follow_enable_animations_setting"/>
3243- <attribute name="org.gtk.Property.set"
3244- value="adw_animation_set_follow_enable_animations_setting"/>
3310+ <method name="set_copyright"
3311+ c:identifier="adw_about_window_set_copyright"
3312+ glib:set-property="copyright"
3313+ version="1.2"
3314+ deprecated="1"
3315+ deprecated-version="1.6">
32453316 <doc xml:space="preserve"
3246- filename="src/adw-animation.c"
3247- line="405">Whether to skip the animation when animations are globally disabled.
3317+ filename="src/adw-about-window.c"
3318+ line="3240">Sets the copyright information for @self.
32483319
3249-The default behavior is to skip the animation. Set to `FALSE` to disable
3250-this behavior.
3320+This should be a short string of one or two lines, for example:
3321+`© 2022 Example`.
32513322
3252-This can be useful for cases where animation is essential, like spinners,
3253-or in demo applications. Most other animations should keep it enabled.
3323+The copyright information will be displayed on the Legal page, before the
3324+application license.
32543325
3255-See [property@Gtk.Settings:gtk-enable-animations].</doc>
3256- <type name="gboolean" c:type="gboolean"/>
3257- </property>
3258- <property name="state"
3259- transfer-ownership="none"
3260- getter="get_state"
3261- default-value="ADW_ANIMATION_IDLE">
3262- <attribute name="org.gtk.Property.get"
3263- value="adw_animation_get_state"/>
3326+[method@AboutWindow.add_legal_section] can be used to add copyright
3327+information for the application dependencies or other components.</doc>
3328+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
3329+ <source-position filename="src/adw-about-window.h" line="152"/>
3330+ <return-value transfer-ownership="none">
3331+ <type name="none" c:type="void"/>
3332+ </return-value>
3333+ <parameters>
3334+ <instance-parameter name="self" transfer-ownership="none">
3335+ <doc xml:space="preserve"
3336+ filename="src/adw-about-window.c"
3337+ line="3242">an about window</doc>
3338+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
3339+ </instance-parameter>
3340+ <parameter name="copyright" transfer-ownership="none">
3341+ <doc xml:space="preserve"
3342+ filename="src/adw-about-window.c"
3343+ line="3243">the copyright information</doc>
3344+ <type name="utf8" c:type="const char*"/>
3345+ </parameter>
3346+ </parameters>
3347+ </method>
3348+ <method name="set_debug_info"
3349+ c:identifier="adw_about_window_set_debug_info"
3350+ glib:set-property="debug-info"
3351+ version="1.2"
3352+ deprecated="1"
3353+ deprecated-version="1.6">
32643354 <doc xml:space="preserve"
3265- filename="src/adw-animation.c"
3266- line="391">The animation state.
3355+ filename="src/adw-about-window.c"
3356+ line="2752">Sets the debug information for @self.
32673357
3268-The state indicates whether the animation is currently playing, paused,
3269-finished or hasn't been started yet.</doc>
3270- <type name="AnimationState"/>
3271- </property>
3272- <property name="target"
3273- writable="1"
3274- construct="1"
3275- transfer-ownership="none"
3276- setter="set_target"
3277- getter="get_target">
3278- <attribute name="org.gtk.Property.get"
3279- value="adw_animation_get_target"/>
3280- <attribute name="org.gtk.Property.set"
3281- value="adw_animation_set_target"/>
3282- <doc xml:space="preserve"
3283- filename="src/adw-animation.c"
3284- line="369">The target to animate.</doc>
3285- <type name="AnimationTarget"/>
3286- </property>
3287- <property name="value"
3288- transfer-ownership="none"
3289- getter="get_value"
3290- default-value="0.000000">
3291- <attribute name="org.gtk.Property.get"
3292- value="adw_animation_get_value"/>
3293- <doc xml:space="preserve"
3294- filename="src/adw-animation.c"
3295- line="379">The current value of the animation.</doc>
3296- <type name="gdouble" c:type="gdouble"/>
3297- </property>
3298- <property name="widget"
3299- writable="1"
3300- construct-only="1"
3301- transfer-ownership="none"
3302- getter="get_widget">
3303- <attribute name="org.gtk.Property.get"
3304- value="adw_animation_get_widget"/>
3305- <doc xml:space="preserve"
3306- filename="src/adw-animation.c"
3307- line="352">The animation widget.
3358+Debug information will be shown on the Troubleshooting page. It's intended
3359+to be attached to issue reports when reporting issues against the
3360+application.
33083361
3309-It provides the frame clock for the animation. It's not strictly necessary
3310-for this widget to be same as the one being animated.
3362+`AdwAboutWindow` provides a quick way to save debug information to a file.
3363+When saving, [property@AboutWindow:debug-info-filename] would be used as
3364+the suggested filename.
33113365
3312-The widget must be mapped in order for the animation to work. If it's not
3313-mapped, or if it gets unmapped during an ongoing animation, the animation
3314-will be automatically skipped.</doc>
3315- <type name="Gtk.Widget"/>
3316- </property>
3317- <field name="parent_instance">
3318- <type name="GObject.Object" c:type="GObject"/>
3319- </field>
3320- <glib:signal name="done" when="last">
3321- <doc xml:space="preserve"
3322- filename="src/adw-animation.c"
3323- line="427">This signal is emitted when the animation has been completed, either on its
3324-own or via calling [method@Animation.skip].</doc>
3366+Debug information cannot contain markup or links.</doc>
3367+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
3368+ <source-position filename="src/adw-about-window.h" line="100"/>
33253369 <return-value transfer-ownership="none">
33263370 <type name="none" c:type="void"/>
33273371 </return-value>
3328- </glib:signal>
3329- </class>
3330- <record name="AnimationClass"
3331- c:type="AdwAnimationClass"
3332- disguised="1"
3333- opaque="1"
3334- glib:is-gtype-struct-for="Animation">
3335- <source-position filename="src/adw-animation.h" line="36"/>
3336- </record>
3337- <enumeration name="AnimationState"
3338- glib:type-name="AdwAnimationState"
3339- glib:get-type="adw_animation_state_get_type"
3340- c:type="AdwAnimationState">
3341- <doc xml:space="preserve"
3342- filename="src/adw-animation.c"
3343- line="66">Describes the possible states of an [class@Animation].
3372+ <parameters>
3373+ <instance-parameter name="self" transfer-ownership="none">
3374+ <doc xml:space="preserve"
3375+ filename="src/adw-about-window.c"
3376+ line="2754">an about window</doc>
3377+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
3378+ </instance-parameter>
3379+ <parameter name="debug_info" transfer-ownership="none">
3380+ <doc xml:space="preserve"
3381+ filename="src/adw-about-window.c"
3382+ line="2755">the debug information</doc>
3383+ <type name="utf8" c:type="const char*"/>
3384+ </parameter>
3385+ </parameters>
3386+ </method>
3387+ <method name="set_debug_info_filename"
3388+ c:identifier="adw_about_window_set_debug_info_filename"
3389+ glib:set-property="debug-info-filename"
3390+ version="1.2"
3391+ deprecated="1"
3392+ deprecated-version="1.6">
3393+ <doc xml:space="preserve"
3394+ filename="src/adw-about-window.c"
3395+ line="2806">Sets the debug information filename for @self.
33443396
3345-The state can be controlled with [method@Animation.play],
3346-[method@Animation.pause], [method@Animation.resume],
3347-[method@Animation.reset] and [method@Animation.skip].</doc>
3348- <member name="idle"
3349- value="0"
3350- c:identifier="ADW_ANIMATION_IDLE"
3351- glib:nick="idle"
3352- glib:name="ADW_ANIMATION_IDLE">
3397+It will be used as the suggested filename when saving debug information to a
3398+file.
3399+
3400+See [property@AboutWindow:debug-info].</doc>
3401+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
3402+ <source-position filename="src/adw-about-window.h" line="106"/>
3403+ <return-value transfer-ownership="none">
3404+ <type name="none" c:type="void"/>
3405+ </return-value>
3406+ <parameters>
3407+ <instance-parameter name="self" transfer-ownership="none">
3408+ <doc xml:space="preserve"
3409+ filename="src/adw-about-window.c"
3410+ line="2808">an about window</doc>
3411+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
3412+ </instance-parameter>
3413+ <parameter name="filename" transfer-ownership="none">
3414+ <doc xml:space="preserve"
3415+ filename="src/adw-about-window.c"
3416+ line="2809">the debug info filename</doc>
3417+ <type name="utf8" c:type="const char*"/>
3418+ </parameter>
3419+ </parameters>
3420+ </method>
3421+ <method name="set_designers"
3422+ c:identifier="adw_about_window_set_designers"
3423+ glib:set-property="designers"
3424+ version="1.2"
3425+ deprecated="1"
3426+ deprecated-version="1.6">
33533427 <doc xml:space="preserve"
3354- filename="src/adw-animation.c"
3355- line="68">The animation hasn't started yet.</doc>
3356- </member>
3357- <member name="paused"
3358- value="1"
3359- c:identifier="ADW_ANIMATION_PAUSED"
3360- glib:nick="paused"
3361- glib:name="ADW_ANIMATION_PAUSED">
3428+ filename="src/adw-about-window.c"
3429+ line="2913">Sets the list of designers of the application.
3430+
3431+It will be displayed on the Credits page.
3432+
3433+Each name may contain email addresses and URLs, see the introduction for more
3434+details.
3435+
3436+See also:
3437+
3438+* [property@AboutWindow:developers]
3439+* [property@AboutWindow:artists]
3440+* [property@AboutWindow:documenters]
3441+* [property@AboutWindow:translator-credits]
3442+* [method@AboutWindow.add_credit_section]
3443+* [method@AboutWindow.add_acknowledgement_section]</doc>
3444+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
3445+ <source-position filename="src/adw-about-window.h" line="118"/>
3446+ <return-value transfer-ownership="none">
3447+ <type name="none" c:type="void"/>
3448+ </return-value>
3449+ <parameters>
3450+ <instance-parameter name="self" transfer-ownership="none">
3451+ <doc xml:space="preserve"
3452+ filename="src/adw-about-window.c"
3453+ line="2915">an about window</doc>
3454+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
3455+ </instance-parameter>
3456+ <parameter name="designers"
3457+ transfer-ownership="none"
3458+ nullable="1"
3459+ allow-none="1">
3460+ <doc xml:space="preserve"
3461+ filename="src/adw-about-window.c"
3462+ line="2916">the list of designers</doc>
3463+ <array c:type="const char**">
3464+ <type name="utf8" c:type="char*"/>
3465+ </array>
3466+ </parameter>
3467+ </parameters>
3468+ </method>
3469+ <method name="set_developer_name"
3470+ c:identifier="adw_about_window_set_developer_name"
3471+ glib:set-property="developer-name"
3472+ version="1.2"
3473+ deprecated="1"
3474+ deprecated-version="1.6">
33623475 <doc xml:space="preserve"
3363- filename="src/adw-animation.c"
3364- line="69">The animation has been paused.</doc>
3365- </member>
3366- <member name="playing"
3367- value="2"
3368- c:identifier="ADW_ANIMATION_PLAYING"
3369- glib:nick="playing"
3370- glib:name="ADW_ANIMATION_PLAYING">
3476+ filename="src/adw-about-window.c"
3477+ line="2285">Sets the developer name for @self.
3478+
3479+The developer name is displayed on the main page, under the application name.
3480+
3481+If the application is developed by multiple people, the developer name can be
3482+set to values like "AppName team", "AppName developers" or
3483+"The AppName project", and the individual contributors can be listed on the
3484+Credits page, with [property@AboutWindow:developers] and related properties.</doc>
3485+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
3486+ <source-position filename="src/adw-about-window.h" line="47"/>
3487+ <return-value transfer-ownership="none">
3488+ <type name="none" c:type="void"/>
3489+ </return-value>
3490+ <parameters>
3491+ <instance-parameter name="self" transfer-ownership="none">
3492+ <doc xml:space="preserve"
3493+ filename="src/adw-about-window.c"
3494+ line="2287">an about window</doc>
3495+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
3496+ </instance-parameter>
3497+ <parameter name="developer_name" transfer-ownership="none">
3498+ <doc xml:space="preserve"
3499+ filename="src/adw-about-window.c"
3500+ line="2288">the developer name</doc>
3501+ <type name="utf8" c:type="const char*"/>
3502+ </parameter>
3503+ </parameters>
3504+ </method>
3505+ <method name="set_developers"
3506+ c:identifier="adw_about_window_set_developers"
3507+ glib:set-property="developers"
3508+ version="1.2"
3509+ deprecated="1"
3510+ deprecated-version="1.6">
33713511 <doc xml:space="preserve"
3372- filename="src/adw-animation.c"
3373- line="70">The animation is currently playing.</doc>
3374- </member>
3375- <member name="finished"
3376- value="3"
3377- c:identifier="ADW_ANIMATION_FINISHED"
3378- glib:nick="finished"
3379- glib:name="ADW_ANIMATION_FINISHED">
3380- <doc xml:space="preserve"
3381- filename="src/adw-animation.c"
3382- line="71">The animation has finished.</doc>
3383- </member>
3384- </enumeration>
3385- <class name="AnimationTarget"
3386- c:symbol-prefix="animation_target"
3387- c:type="AdwAnimationTarget"
3388- parent="GObject.Object"
3389- abstract="1"
3390- glib:type-name="AdwAnimationTarget"
3391- glib:get-type="adw_animation_target_get_type"
3392- glib:type-struct="AnimationTargetClass">
3393- <doc xml:space="preserve"
3394- filename="src/adw-animation-target.c"
3395- line="11">Represents a value [class@Animation] can animate.</doc>
3396- <source-position filename="src/adw-animation-target.h" line="22"/>
3397- </class>
3398- <record name="AnimationTargetClass"
3399- c:type="AdwAnimationTargetClass"
3400- disguised="1"
3401- opaque="1"
3402- glib:is-gtype-struct-for="AnimationTarget">
3403- <source-position filename="src/adw-animation-target.h" line="22"/>
3404- </record>
3405- <callback name="AnimationTargetFunc" c:type="AdwAnimationTargetFunc">
3406- <doc xml:space="preserve"
3407- filename="src/adw-animation-target.h"
3408- line="25">Prototype for animation targets based on user callbacks.</doc>
3409- <source-position filename="src/adw-animation-target.h" line="32"/>
3410- <return-value transfer-ownership="none">
3411- <type name="none" c:type="void"/>
3412- </return-value>
3413- <parameters>
3414- <parameter name="value" transfer-ownership="none">
3415- <doc xml:space="preserve"
3416- filename="src/adw-animation-target.h"
3417- line="27">The animation value</doc>
3418- <type name="gdouble" c:type="double"/>
3419- </parameter>
3420- <parameter name="user_data"
3421- transfer-ownership="none"
3422- nullable="1"
3423- allow-none="1"
3424- closure="1">
3425- <doc xml:space="preserve"
3426- filename="src/adw-animation-target.h"
3427- line="28">The user data provided when creating the target</doc>
3428- <type name="gpointer" c:type="gpointer"/>
3429- </parameter>
3430- </parameters>
3431- </callback>
3432- <class name="Application"
3433- c:symbol-prefix="application"
3434- c:type="AdwApplication"
3435- parent="Gtk.Application"
3436- glib:type-name="AdwApplication"
3437- glib:get-type="adw_application_get_type"
3438- glib:type-struct="ApplicationClass">
3439- <doc xml:space="preserve"
3440- filename="src/adw-application.c"
3441- line="11">A base class for Adwaita applications.
3442-
3443-`AdwApplication` handles library initialization by calling [func@init] in the
3444-default [signal@Gio.Application::startup] signal handler, in turn chaining up
3445-as required by [class@Gtk.Application]. Therefore, any subclass of
3446-`AdwApplication` should always chain up its `startup` handler before using
3447-any Adwaita or GTK API.
3448-
3449-## Automatic Resources
3512+ filename="src/adw-about-window.c"
3513+ line="2853">Sets the list of developers of the application.
34503514
3451-`AdwApplication` will automatically load stylesheets located in the
3452-application's resource base path (see
3453-[method@Gio.Application.set_resource_base_path], if they're present.
3515+It will be displayed on the Credits page.
34543516
3455-They can be used to add custom styles to the application, as follows:
3517+Each name may contain email addresses and URLs, see the introduction for more
3518+details.
34563519
3457-- `style.css` contains styles that are always present.
3520+See also:
34583521
3459-- `style-dark.css` contains styles only used when
3460-[property@StyleManager:dark] is `TRUE`.
3522+* [property@AboutWindow:designers]
3523+* [property@AboutWindow:artists]
3524+* [property@AboutWindow:documenters]
3525+* [property@AboutWindow:translator-credits]
3526+* [method@AboutWindow.add_credit_section]
3527+* [method@AboutWindow.add_acknowledgement_section]</doc>
3528+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
3529+ <source-position filename="src/adw-about-window.h" line="112"/>
3530+ <return-value transfer-ownership="none">
3531+ <type name="none" c:type="void"/>
3532+ </return-value>
3533+ <parameters>
3534+ <instance-parameter name="self" transfer-ownership="none">
3535+ <doc xml:space="preserve"
3536+ filename="src/adw-about-window.c"
3537+ line="2855">an about window</doc>
3538+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
3539+ </instance-parameter>
3540+ <parameter name="developers"
3541+ transfer-ownership="none"
3542+ nullable="1"
3543+ allow-none="1">
3544+ <doc xml:space="preserve"
3545+ filename="src/adw-about-window.c"
3546+ line="2856">the list of developers</doc>
3547+ <array c:type="const char**">
3548+ <type name="utf8" c:type="char*"/>
3549+ </array>
3550+ </parameter>
3551+ </parameters>
3552+ </method>
3553+ <method name="set_documenters"
3554+ c:identifier="adw_about_window_set_documenters"
3555+ glib:set-property="documenters"
3556+ version="1.2"
3557+ deprecated="1"
3558+ deprecated-version="1.6">
3559+ <doc xml:space="preserve"
3560+ filename="src/adw-about-window.c"
3561+ line="3033">Sets the list of documenters of the application.
34613562
3462-- `style-hc.css` contains styles used when the system high contrast
3463- preference is enabled.
3563+It will be displayed on the Credits page.
34643564
3465-- `style-hc-dark.css` contains styles used when the system high contrast
3466- preference is enabled and [property@StyleManager:dark] is `TRUE`.</doc>
3467- <source-position filename="src/adw-application.h" line="36"/>
3468- <implements name="Gio.ActionGroup"/>
3469- <implements name="Gio.ActionMap"/>
3470- <constructor name="new" c:identifier="adw_application_new">
3471- <doc xml:space="preserve"
3472- filename="src/adw-application.c"
3473- line="248">Creates a new `AdwApplication`.
3565+Each name may contain email addresses and URLs, see the introduction for more
3566+details.
34743567
3475-If `application_id` is not `NULL`, then it must be valid. See
3476-[func@Gio.Application.id_is_valid].
3568+See also:
34773569
3478-If no application ID is given then some features (most notably application
3479-uniqueness) will be disabled.</doc>
3480- <source-position filename="src/adw-application.h" line="39"/>
3481- <return-value transfer-ownership="full">
3482- <doc xml:space="preserve"
3483- filename="src/adw-application.c"
3484- line="261">the newly created `AdwApplication`</doc>
3485- <type name="Application" c:type="AdwApplication*"/>
3570+* [property@AboutWindow:developers]
3571+* [property@AboutWindow:designers]
3572+* [property@AboutWindow:artists]
3573+* [property@AboutWindow:translator-credits]
3574+* [method@AboutWindow.add_credit_section]
3575+* [method@AboutWindow.add_acknowledgement_section]</doc>
3576+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
3577+ <source-position filename="src/adw-about-window.h" line="130"/>
3578+ <return-value transfer-ownership="none">
3579+ <type name="none" c:type="void"/>
34863580 </return-value>
34873581 <parameters>
3488- <parameter name="application_id"
3582+ <instance-parameter name="self" transfer-ownership="none">
3583+ <doc xml:space="preserve"
3584+ filename="src/adw-about-window.c"
3585+ line="3035">an about window</doc>
3586+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
3587+ </instance-parameter>
3588+ <parameter name="documenters"
34893589 transfer-ownership="none"
34903590 nullable="1"
34913591 allow-none="1">
34923592 <doc xml:space="preserve"
3493- filename="src/adw-application.c"
3494- line="250">The application ID</doc>
3495- <type name="utf8" c:type="const char*"/>
3593+ filename="src/adw-about-window.c"
3594+ line="3036">the list of documenters</doc>
3595+ <array c:type="const char**">
3596+ <type name="utf8" c:type="char*"/>
3597+ </array>
34963598 </parameter>
3497- <parameter name="flags" transfer-ownership="none">
3599+ </parameters>
3600+ </method>
3601+ <method name="set_issue_url"
3602+ c:identifier="adw_about_window_set_issue_url"
3603+ glib:set-property="issue-url"
3604+ version="1.2"
3605+ deprecated="1"
3606+ deprecated-version="1.6">
3607+ <doc xml:space="preserve"
3608+ filename="src/adw-about-window.c"
3609+ line="2654">Sets the issue tracker URL for @self.
3610+
3611+The issue tracker link is displayed on the main page.</doc>
3612+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
3613+ <source-position filename="src/adw-about-window.h" line="89"/>
3614+ <return-value transfer-ownership="none">
3615+ <type name="none" c:type="void"/>
3616+ </return-value>
3617+ <parameters>
3618+ <instance-parameter name="self" transfer-ownership="none">
34983619 <doc xml:space="preserve"
3499- filename="src/adw-application.c"
3500- line="251">The application flags</doc>
3501- <type name="Gio.ApplicationFlags" c:type="GApplicationFlags"/>
3620+ filename="src/adw-about-window.c"
3621+ line="2656">an about window</doc>
3622+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
3623+ </instance-parameter>
3624+ <parameter name="issue_url" transfer-ownership="none">
3625+ <doc xml:space="preserve"
3626+ filename="src/adw-about-window.c"
3627+ line="2657">the issue tracker URL</doc>
3628+ <type name="utf8" c:type="const char*"/>
35023629 </parameter>
35033630 </parameters>
3504- </constructor>
3505- <method name="get_style_manager"
3506- c:identifier="adw_application_get_style_manager"
3507- glib:get-property="style-manager">
3508- <attribute name="org.gtk.Method.get_property" value="style-manager"/>
3631+ </method>
3632+ <method name="set_license"
3633+ c:identifier="adw_about_window_set_license"
3634+ glib:set-property="license"
3635+ version="1.2"
3636+ deprecated="1"
3637+ deprecated-version="1.6">
35093638 <doc xml:space="preserve"
3510- filename="src/adw-application.c"
3511- line="273">Gets the style manager for @self.
3639+ filename="src/adw-about-window.c"
3640+ line="3359">Sets the license for @self.
35123641
3513-This is a convenience property allowing to access `AdwStyleManager` through
3514-property bindings or expressions.</doc>
3515- <source-position filename="src/adw-application.h" line="43"/>
3642+This can be used to set a custom text for the license if it can't be set via
3643+[property@AboutWindow:license-type].
3644+
3645+When set, [property@AboutWindow:license-type] will be set to
3646+`GTK_LICENSE_CUSTOM`.
3647+
3648+The license text will be displayed on the Legal page, below the copyright
3649+information.
3650+
3651+License text can contain Pango markup and links.
3652+
3653+[method@AboutWindow.add_legal_section] can be used to add license information
3654+for the application dependencies or other components.</doc>
3655+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
3656+ <source-position filename="src/adw-about-window.h" line="164"/>
35163657 <return-value transfer-ownership="none">
3517- <doc xml:space="preserve"
3518- filename="src/adw-application.c"
3519- line="282">the style manager</doc>
3520- <type name="StyleManager" c:type="AdwStyleManager*"/>
3658+ <type name="none" c:type="void"/>
35213659 </return-value>
35223660 <parameters>
35233661 <instance-parameter name="self" transfer-ownership="none">
35243662 <doc xml:space="preserve"
3525- filename="src/adw-application.c"
3526- line="275">an application</doc>
3527- <type name="Application" c:type="AdwApplication*"/>
3663+ filename="src/adw-about-window.c"
3664+ line="3361">an about window</doc>
3665+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
35283666 </instance-parameter>
3667+ <parameter name="license" transfer-ownership="none">
3668+ <doc xml:space="preserve"
3669+ filename="src/adw-about-window.c"
3670+ line="3362">the license</doc>
3671+ <type name="utf8" c:type="const char*"/>
3672+ </parameter>
35293673 </parameters>
35303674 </method>
3531- <property name="style-manager"
3532- transfer-ownership="none"
3533- getter="get_style_manager">
3534- <attribute name="org.gtk.Property.get"
3535- value="adw_application_get_style_manager"/>
3675+ <method name="set_license_type"
3676+ c:identifier="adw_about_window_set_license_type"
3677+ glib:set-property="license-type"
3678+ version="1.2"
3679+ deprecated="1"
3680+ deprecated-version="1.6">
35363681 <doc xml:space="preserve"
3537- filename="src/adw-application.c"
3538- line="227">The style manager for this application.
3682+ filename="src/adw-about-window.c"
3683+ line="3293">Sets the license for @self from a list of known licenses.
35393684
3540-This is a convenience property allowing to access `AdwStyleManager` through
3541-property bindings or expressions.</doc>
3542- <type name="StyleManager"/>
3543- </property>
3544- <field name="parent_instance">
3545- <type name="Gtk.Application" c:type="GtkApplication"/>
3546- </field>
3547- </class>
3548- <record name="ApplicationClass"
3549- c:type="AdwApplicationClass"
3550- glib:is-gtype-struct-for="Application">
3551- <source-position filename="src/adw-application.h" line="36"/>
3552- <field name="parent_class">
3553- <doc xml:space="preserve"
3554- filename="src/adw-application.h"
3555- line="28">The parent class</doc>
3556- <type name="Gtk.ApplicationClass" c:type="GtkApplicationClass"/>
3557- </field>
3558- <field name="padding" readable="0" private="1">
3559- <array zero-terminated="0" fixed-size="4">
3560- <type name="gpointer" c:type="gpointer"/>
3561- </array>
3562- </field>
3563- </record>
3564- <class name="ApplicationWindow"
3565- c:symbol-prefix="application_window"
3566- c:type="AdwApplicationWindow"
3567- parent="Gtk.ApplicationWindow"
3568- glib:type-name="AdwApplicationWindow"
3569- glib:get-type="adw_application_window_get_type"
3570- glib:type-struct="ApplicationWindowClass">
3571- <doc xml:space="preserve"
3572- filename="src/adw-application-window.c"
3573- line="12">A freeform application window.
3685+If the application's license is not in the list,
3686+[property@AboutWindow:license] can be used instead. The license type will be
3687+automatically set to `GTK_LICENSE_CUSTOM` in that case.
35743688
3575-&lt;picture&gt;
3576- &lt;source srcset="application-window-dark.png" media="(prefers-color-scheme: dark)"&gt;
3577- &lt;img src="application-window.png" alt="application-window"&gt;
3578-&lt;/picture&gt;
3689+If @license_type is `GTK_LICENSE_UNKNOWN`, no information will be displayed.
35793690
3580-`AdwApplicationWindow` is a [class@Gtk.ApplicationWindow] subclass providing
3581-the same features as [class@Window].
3691+If @license_type is different from `GTK_LICENSE_CUSTOM`.
3692+[property@AboutWindow:license] will be cleared out.
35823693
3583-See [class@Window] for details.
3694+The license description will be displayed on the Legal page, below the
3695+copyright information.
35843696
3585-Using [property@Gtk.Application:menubar] is not supported and may result in
3586-visual glitches.</doc>
3587- <source-position filename="src/adw-application-window.h" line="30"/>
3588- <implements name="Gio.ActionGroup"/>
3589- <implements name="Gio.ActionMap"/>
3590- <implements name="Gtk.Accessible"/>
3591- <implements name="Gtk.Buildable"/>
3592- <implements name="Gtk.ConstraintTarget"/>
3593- <implements name="Gtk.Native"/>
3594- <implements name="Gtk.Root"/>
3595- <implements name="Gtk.ShortcutManager"/>
3596- <constructor name="new" c:identifier="adw_application_window_new">
3597- <doc xml:space="preserve"
3598- filename="src/adw-application-window.c"
3599- line="169">Creates a new `AdwApplicationWindow` for @app.</doc>
3600- <source-position filename="src/adw-application-window.h" line="33"/>
3697+[method@AboutWindow.add_legal_section] can be used to add license information
3698+for the application dependencies or other components.</doc>
3699+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
3700+ <source-position filename="src/adw-about-window.h" line="158"/>
36013701 <return-value transfer-ownership="none">
3602- <doc xml:space="preserve"
3603- filename="src/adw-application-window.c"
3604- line="175">the newly created `AdwApplicationWindow`</doc>
3605- <type name="Gtk.Widget" c:type="GtkWidget*"/>
3606- </return-value>
3607- <parameters>
3608- <parameter name="app" transfer-ownership="none">
3609- <doc xml:space="preserve"
3610- filename="src/adw-application-window.c"
3611- line="171">an application instance</doc>
3612- <type name="Gtk.Application" c:type="GtkApplication*"/>
3613- </parameter>
3614- </parameters>
3615- </constructor>
3616- <method name="get_content"
3617- c:identifier="adw_application_window_get_content"
3618- glib:get-property="content">
3619- <attribute name="org.gtk.Method.get_property" value="content"/>
3620- <doc xml:space="preserve"
3621- filename="src/adw-application-window.c"
3622- line="209">Gets the content widget of @self.
3623-
3624-This method should always be used instead of [method@Gtk.Window.get_child].</doc>
3625- <source-position filename="src/adw-application-window.h" line="39"/>
3626- <return-value transfer-ownership="none" nullable="1">
3627- <doc xml:space="preserve"
3628- filename="src/adw-application-window.c"
3629- line="217">the content widget of @self</doc>
3630- <type name="Gtk.Widget" c:type="GtkWidget*"/>
3702+ <type name="none" c:type="void"/>
36313703 </return-value>
36323704 <parameters>
36333705 <instance-parameter name="self" transfer-ownership="none">
36343706 <doc xml:space="preserve"
3635- filename="src/adw-application-window.c"
3636- line="211">an application window</doc>
3637- <type name="ApplicationWindow" c:type="AdwApplicationWindow*"/>
3707+ filename="src/adw-about-window.c"
3708+ line="3295">an about window</doc>
3709+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
36383710 </instance-parameter>
3711+ <parameter name="license_type" transfer-ownership="none">
3712+ <doc xml:space="preserve"
3713+ filename="src/adw-about-window.c"
3714+ line="3296">the license type</doc>
3715+ <type name="Gtk.License" c:type="GtkLicense"/>
3716+ </parameter>
36393717 </parameters>
36403718 </method>
3641- <method name="set_content"
3642- c:identifier="adw_application_window_set_content"
3643- glib:set-property="content">
3644- <attribute name="org.gtk.Method.set_property" value="content"/>
3719+ <method name="set_release_notes"
3720+ c:identifier="adw_about_window_set_release_notes"
3721+ glib:set-property="release-notes"
3722+ version="1.2"
3723+ deprecated="1"
3724+ deprecated-version="1.6">
36453725 <doc xml:space="preserve"
3646- filename="src/adw-application-window.c"
3647- line="185">Sets the content widget of @self.
3726+ filename="src/adw-about-window.c"
3727+ line="2442">Sets the release notes for @self.
36483728
3649-This method should always be used instead of [method@Gtk.Window.set_child].</doc>
3650- <source-position filename="src/adw-application-window.h" line="36"/>
3729+Release notes are displayed on the the What's New page.
3730+
3731+Release notes are formatted the same way as
3732+[AppStream descriptions](https://freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-description).
3733+
3734+The supported formatting options are:
3735+
3736+* Paragraph (`&lt;p&gt;`)
3737+* Ordered list (`&lt;ol&gt;`), with list items (`&lt;li&gt;`)
3738+* Unordered list (`&lt;ul&gt;`), with list items (`&lt;li&gt;`)
3739+
3740+Within paragraphs and list items, emphasis (`&lt;em&gt;`) and inline code
3741+(`&lt;code&gt;`) text styles are supported. The emphasis is rendered in italic,
3742+while inline code is shown in a monospaced font.
3743+
3744+Any text outside paragraphs or list items is ignored.
3745+
3746+Nested lists are not supported.
3747+
3748+`AdwAboutWindow` displays the version above the release notes. If set, the
3749+[property@AboutWindow:release-notes-version] of the property will be used
3750+as the version; otherwise, [property@AboutWindow:version] is used.</doc>
3751+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
3752+ <source-position filename="src/adw-about-window.h" line="65"/>
36513753 <return-value transfer-ownership="none">
36523754 <type name="none" c:type="void"/>
36533755 </return-value>
36543756 <parameters>
36553757 <instance-parameter name="self" transfer-ownership="none">
36563758 <doc xml:space="preserve"
3657- filename="src/adw-application-window.c"
3658- line="187">an application window</doc>
3659- <type name="ApplicationWindow" c:type="AdwApplicationWindow*"/>
3759+ filename="src/adw-about-window.c"
3760+ line="2444">an about window</doc>
3761+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
36603762 </instance-parameter>
3661- <parameter name="content"
3662- transfer-ownership="none"
3663- nullable="1"
3664- allow-none="1">
3763+ <parameter name="release_notes" transfer-ownership="none">
36653764 <doc xml:space="preserve"
3666- filename="src/adw-application-window.c"
3667- line="188">the content widget</doc>
3668- <type name="Gtk.Widget" c:type="GtkWidget*"/>
3765+ filename="src/adw-about-window.c"
3766+ line="2445">the release notes</doc>
3767+ <type name="utf8" c:type="const char*"/>
36693768 </parameter>
36703769 </parameters>
36713770 </method>
3672- <property name="content"
3673- writable="1"
3674- transfer-ownership="none"
3675- setter="set_content"
3676- getter="get_content">
3677- <attribute name="org.gtk.Property.get"
3678- value="adw_application_window_get_content"/>
3679- <attribute name="org.gtk.Property.set"
3680- value="adw_application_window_set_content"/>
3771+ <method name="set_release_notes_version"
3772+ c:identifier="adw_about_window_set_release_notes_version"
3773+ glib:set-property="release-notes-version"
3774+ version="1.2"
3775+ deprecated="1"
3776+ deprecated-version="1.6">
36813777 <doc xml:space="preserve"
3682- filename="src/adw-application-window.c"
3683- line="122">The content widget.
3684-
3685-This property should always be used instead of [property@Gtk.Window:child].</doc>
3686- <type name="Gtk.Widget"/>
3687- </property>
3688- <field name="parent_instance">
3689- <type name="Gtk.ApplicationWindow" c:type="GtkApplicationWindow"/>
3690- </field>
3691- </class>
3692- <record name="ApplicationWindowClass"
3693- c:type="AdwApplicationWindowClass"
3694- glib:is-gtype-struct-for="ApplicationWindow">
3695- <source-position filename="src/adw-application-window.h" line="30"/>
3696- <field name="parent_class">
3697- <type name="Gtk.ApplicationWindowClass"
3698- c:type="GtkApplicationWindowClass"/>
3699- </field>
3700- <field name="padding" readable="0" private="1">
3701- <array zero-terminated="0" fixed-size="4">
3702- <type name="gpointer" c:type="gpointer"/>
3703- </array>
3704- </field>
3705- </record>
3706- <class name="Avatar"
3707- c:symbol-prefix="avatar"
3708- c:type="AdwAvatar"
3709- parent="Gtk.Widget"
3710- final="1"
3711- glib:type-name="AdwAvatar"
3712- glib:get-type="adw_avatar_get_type"
3713- glib:type-struct="AvatarClass">
3714- <doc xml:space="preserve"
3715- filename="src/adw-avatar.c"
3716- line="21">A widget displaying an image, with a generated fallback.
3717-
3718-&lt;picture&gt;
3719- &lt;source srcset="avatar-dark.png" media="(prefers-color-scheme: dark)"&gt;
3720- &lt;img src="avatar.png" alt="avatar"&gt;
3721-&lt;/picture&gt;
3722-
3723-`AdwAvatar` is a widget that shows a round avatar.
3724-
3725-`AdwAvatar` generates an avatar with the initials of the
3726-[property@Avatar:text] on top of a colored background.
3727-
3728-The color is picked based on the hash of the [property@Avatar:text].
3778+ filename="src/adw-about-window.c"
3779+ line="2386">Sets the version described by the application's release notes.
37293780
3730-If [property@Avatar:show-initials] is set to `FALSE`,
3731-[property@Avatar:icon-name] or `avatar-default-symbolic` is shown instead of
3732-the initials.
3781+The release notes version is displayed on the What's New page, above the
3782+release notes.
37333783
3734-Use [property@Avatar:custom-image] to set a custom image.
3784+If not set, [property@AboutWindow:version] will be used instead.
37353785
3736-## CSS nodes
3786+For example, an application with the current version 2.0.2 might want to
3787+keep the release notes from 2.0.0, and set the release notes version
3788+accordingly.
37373789
3738-`AdwAvatar` has a single CSS node with name `avatar`.</doc>
3739- <source-position filename="src/adw-avatar.h" line="22"/>
3740- <implements name="Gtk.Accessible"/>
3741- <implements name="Gtk.Buildable"/>
3742- <implements name="Gtk.ConstraintTarget"/>
3743- <constructor name="new" c:identifier="adw_avatar_new">
3744- <doc xml:space="preserve"
3745- filename="src/adw-avatar.c"
3746- line="473">Creates a new `AdwAvatar`.</doc>
3747- <source-position filename="src/adw-avatar.h" line="25"/>
3790+See [property@AboutWindow:release-notes].</doc>
3791+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
3792+ <source-position filename="src/adw-about-window.h" line="59"/>
37483793 <return-value transfer-ownership="none">
3749- <doc xml:space="preserve"
3750- filename="src/adw-avatar.c"
3751- line="481">the newly created `AdwAvatar`</doc>
3752- <type name="Gtk.Widget" c:type="GtkWidget*"/>
3794+ <type name="none" c:type="void"/>
37533795 </return-value>
37543796 <parameters>
3755- <parameter name="size" transfer-ownership="none">
3797+ <instance-parameter name="self" transfer-ownership="none">
37563798 <doc xml:space="preserve"
3757- filename="src/adw-avatar.c"
3758- line="475">The size of the avatar</doc>
3759- <type name="gint" c:type="int"/>
3760- </parameter>
3761- <parameter name="text"
3762- transfer-ownership="none"
3763- nullable="1"
3764- allow-none="1">
3799+ filename="src/adw-about-window.c"
3800+ line="2388">an about window</doc>
3801+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
3802+ </instance-parameter>
3803+ <parameter name="version" transfer-ownership="none">
37653804 <doc xml:space="preserve"
3766- filename="src/adw-avatar.c"
3767- line="476">the text used to get the initials and color</doc>
3805+ filename="src/adw-about-window.c"
3806+ line="2389">the release notes version</doc>
37683807 <type name="utf8" c:type="const char*"/>
37693808 </parameter>
3770- <parameter name="show_initials" transfer-ownership="none">
3771- <doc xml:space="preserve"
3772- filename="src/adw-avatar.c"
3773- line="477">whether to use initials instead of an icon as fallback</doc>
3774- <type name="gboolean" c:type="gboolean"/>
3775- </parameter>
37763809 </parameters>
3777- </constructor>
3778- <method name="draw_to_texture" c:identifier="adw_avatar_draw_to_texture">
3810+ </method>
3811+ <method name="set_support_url"
3812+ c:identifier="adw_about_window_set_support_url"
3813+ glib:set-property="support-url"
3814+ version="1.2"
3815+ deprecated="1"
3816+ deprecated-version="1.6">
37793817 <doc xml:space="preserve"
3780- filename="src/adw-avatar.c"
3781- line="744">Renders @self into a [class@Gdk.Texture] at @scale_factor.
3782-
3783-This can be used to export the fallback avatar.</doc>
3784- <source-position filename="src/adw-avatar.h" line="60"/>
3785- <return-value transfer-ownership="full">
3786- <doc xml:space="preserve"
3787- filename="src/adw-avatar.c"
3788- line="753">the texture</doc>
3789- <type name="Gdk.Texture" c:type="GdkTexture*"/>
3790- </return-value>
3791- <parameters>
3792- <instance-parameter name="self" transfer-ownership="none">
3793- <doc xml:space="preserve"
3794- filename="src/adw-avatar.c"
3795- line="746">an avatar</doc>
3796- <type name="Avatar" c:type="AdwAvatar*"/>
3797- </instance-parameter>
3798- <parameter name="scale_factor" transfer-ownership="none">
3799- <doc xml:space="preserve"
3800- filename="src/adw-avatar.c"
3801- line="747">The scale factor</doc>
3802- <type name="gint" c:type="int"/>
3803- </parameter>
3804- </parameters>
3805- </method>
3806- <method name="get_custom_image"
3807- c:identifier="adw_avatar_get_custom_image"
3808- glib:get-property="custom-image">
3809- <attribute name="org.gtk.Method.get_property" value="custom-image"/>
3810- <doc xml:space="preserve"
3811- filename="src/adw-avatar.c"
3812- line="628">Gets the custom image paintable.</doc>
3813- <source-position filename="src/adw-avatar.h" line="48"/>
3814- <return-value transfer-ownership="none" nullable="1">
3815- <doc xml:space="preserve"
3816- filename="src/adw-avatar.c"
3817- line="634">the custom image</doc>
3818- <type name="Gdk.Paintable" c:type="GdkPaintable*"/>
3819- </return-value>
3820- <parameters>
3821- <instance-parameter name="self" transfer-ownership="none">
3822- <doc xml:space="preserve"
3823- filename="src/adw-avatar.c"
3824- line="630">an avatar</doc>
3825- <type name="Avatar" c:type="AdwAvatar*"/>
3826- </instance-parameter>
3827- </parameters>
3828- </method>
3829- <method name="get_icon_name"
3830- c:identifier="adw_avatar_get_icon_name"
3831- glib:get-property="icon-name">
3832- <attribute name="org.gtk.Method.get_property" value="icon-name"/>
3833- <doc xml:space="preserve"
3834- filename="src/adw-avatar.c"
3835- line="495">Gets the name of an icon to use as a fallback.</doc>
3836- <source-position filename="src/adw-avatar.h" line="30"/>
3837- <return-value transfer-ownership="none" nullable="1">
3838- <doc xml:space="preserve"
3839- filename="src/adw-avatar.c"
3840- line="501">the icon name</doc>
3841- <type name="utf8" c:type="const char*"/>
3842- </return-value>
3843- <parameters>
3844- <instance-parameter name="self" transfer-ownership="none">
3845- <doc xml:space="preserve"
3846- filename="src/adw-avatar.c"
3847- line="497">an avatar</doc>
3848- <type name="Avatar" c:type="AdwAvatar*"/>
3849- </instance-parameter>
3850- </parameters>
3851- </method>
3852- <method name="get_show_initials"
3853- c:identifier="adw_avatar_get_show_initials"
3854- glib:get-property="show-initials">
3855- <attribute name="org.gtk.Method.get_property" value="show-initials"/>
3856- <doc xml:space="preserve"
3857- filename="src/adw-avatar.c"
3858- line="585">Gets whether initials are used instead of an icon on the fallback avatar.</doc>
3859- <source-position filename="src/adw-avatar.h" line="42"/>
3860- <return-value transfer-ownership="none">
3861- <doc xml:space="preserve"
3862- filename="src/adw-avatar.c"
3863- line="591">whether initials are used instead of an icon as fallback</doc>
3864- <type name="gboolean" c:type="gboolean"/>
3865- </return-value>
3866- <parameters>
3867- <instance-parameter name="self" transfer-ownership="none">
3868- <doc xml:space="preserve"
3869- filename="src/adw-avatar.c"
3870- line="587">an avatar</doc>
3871- <type name="Avatar" c:type="AdwAvatar*"/>
3872- </instance-parameter>
3873- </parameters>
3874- </method>
3875- <method name="get_size"
3876- c:identifier="adw_avatar_get_size"
3877- glib:get-property="size">
3878- <attribute name="org.gtk.Method.get_property" value="size"/>
3879- <doc xml:space="preserve"
3880- filename="src/adw-avatar.c"
3881- line="694">Gets the size of the avatar.</doc>
3882- <source-position filename="src/adw-avatar.h" line="54"/>
3883- <return-value transfer-ownership="none">
3884- <doc xml:space="preserve"
3885- filename="src/adw-avatar.c"
3886- line="700">the size of the avatar</doc>
3887- <type name="gint" c:type="int"/>
3888- </return-value>
3889- <parameters>
3890- <instance-parameter name="self" transfer-ownership="none">
3891- <doc xml:space="preserve"
3892- filename="src/adw-avatar.c"
3893- line="696">an avatar</doc>
3894- <type name="Avatar" c:type="AdwAvatar*"/>
3895- </instance-parameter>
3896- </parameters>
3897- </method>
3898- <method name="get_text"
3899- c:identifier="adw_avatar_get_text"
3900- glib:get-property="text">
3901- <attribute name="org.gtk.Method.get_property" value="text"/>
3902- <doc xml:space="preserve"
3903- filename="src/adw-avatar.c"
3904- line="537">Gets the text used to generate the fallback initials and color.</doc>
3905- <source-position filename="src/adw-avatar.h" line="36"/>
3906- <return-value transfer-ownership="none" nullable="1">
3907- <doc xml:space="preserve"
3908- filename="src/adw-avatar.c"
3909- line="543">the text used to generate the fallback initials and
3910- color</doc>
3911- <type name="utf8" c:type="const char*"/>
3912- </return-value>
3913- <parameters>
3914- <instance-parameter name="self" transfer-ownership="none">
3915- <doc xml:space="preserve"
3916- filename="src/adw-avatar.c"
3917- line="539">an avatar</doc>
3918- <type name="Avatar" c:type="AdwAvatar*"/>
3919- </instance-parameter>
3920- </parameters>
3921- </method>
3922- <method name="set_custom_image"
3923- c:identifier="adw_avatar_set_custom_image"
3924- glib:set-property="custom-image">
3925- <attribute name="org.gtk.Method.set_property" value="custom-image"/>
3926- <doc xml:space="preserve"
3927- filename="src/adw-avatar.c"
3928- line="644">Sets the custom image paintable.
3818+ filename="src/adw-about-window.c"
3819+ line="2608">Sets the URL of the support page for @self.
39293820
3930-Custom image is displayed instead of initials or icon.</doc>
3931- <source-position filename="src/adw-avatar.h" line="50"/>
3821+The support page link is displayed on the main page.</doc>
3822+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
3823+ <source-position filename="src/adw-about-window.h" line="83"/>
39323824 <return-value transfer-ownership="none">
39333825 <type name="none" c:type="void"/>
39343826 </return-value>
39353827 <parameters>
39363828 <instance-parameter name="self" transfer-ownership="none">
39373829 <doc xml:space="preserve"
3938- filename="src/adw-avatar.c"
3939- line="646">an avatar</doc>
3940- <type name="Avatar" c:type="AdwAvatar*"/>
3830+ filename="src/adw-about-window.c"
3831+ line="2610">an about window</doc>
3832+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
39413833 </instance-parameter>
3942- <parameter name="custom_image"
3943- transfer-ownership="none"
3944- nullable="1"
3945- allow-none="1">
3834+ <parameter name="support_url" transfer-ownership="none">
39463835 <doc xml:space="preserve"
3947- filename="src/adw-avatar.c"
3948- line="647">a custom image</doc>
3949- <type name="Gdk.Paintable" c:type="GdkPaintable*"/>
3836+ filename="src/adw-about-window.c"
3837+ line="2611">the support page URL</doc>
3838+ <type name="utf8" c:type="const char*"/>
39503839 </parameter>
39513840 </parameters>
39523841 </method>
3953- <method name="set_icon_name"
3954- c:identifier="adw_avatar_set_icon_name"
3955- glib:set-property="icon-name">
3956- <attribute name="org.gtk.Method.set_property" value="icon-name"/>
3842+ <method name="set_translator_credits"
3843+ c:identifier="adw_about_window_set_translator_credits"
3844+ glib:set-property="translator-credits"
3845+ version="1.2"
3846+ deprecated="1"
3847+ deprecated-version="1.6">
39573848 <doc xml:space="preserve"
3958- filename="src/adw-avatar.c"
3959- line="511">Sets the name of an icon to use as a fallback.
3849+ filename="src/adw-about-window.c"
3850+ line="3093">Sets the translator credits string.
39603851
3961-If no name is set, `avatar-default-symbolic` will be used.</doc>
3962- <source-position filename="src/adw-avatar.h" line="32"/>
3852+It will be displayed on the Credits page.
3853+
3854+This string should be `"translator-credits"` or `"translator_credits"` and
3855+should be marked as translatable.
3856+
3857+The string may contain email addresses and URLs, see the introduction for
3858+more details.
3859+
3860+See also:
3861+
3862+* [property@AboutWindow:developers]
3863+* [property@AboutWindow:designers]
3864+* [property@AboutWindow:artists]
3865+* [property@AboutWindow:documenters]
3866+* [method@AboutWindow.add_credit_section]
3867+* [method@AboutWindow.add_acknowledgement_section]</doc>
3868+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
3869+ <source-position filename="src/adw-about-window.h" line="136"/>
39633870 <return-value transfer-ownership="none">
39643871 <type name="none" c:type="void"/>
39653872 </return-value>
39663873 <parameters>
39673874 <instance-parameter name="self" transfer-ownership="none">
39683875 <doc xml:space="preserve"
3969- filename="src/adw-avatar.c"
3970- line="513">an avatar</doc>
3971- <type name="Avatar" c:type="AdwAvatar*"/>
3876+ filename="src/adw-about-window.c"
3877+ line="3095">an about window</doc>
3878+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
39723879 </instance-parameter>
3973- <parameter name="icon_name"
3974- transfer-ownership="none"
3975- nullable="1"
3976- allow-none="1">
3880+ <parameter name="translator_credits" transfer-ownership="none">
39773881 <doc xml:space="preserve"
3978- filename="src/adw-avatar.c"
3979- line="514">the icon name</doc>
3882+ filename="src/adw-about-window.c"
3883+ line="3096">the translator credits</doc>
39803884 <type name="utf8" c:type="const char*"/>
39813885 </parameter>
39823886 </parameters>
39833887 </method>
3984- <method name="set_show_initials"
3985- c:identifier="adw_avatar_set_show_initials"
3986- glib:set-property="show-initials">
3987- <attribute name="org.gtk.Method.set_property" value="show-initials"/>
3888+ <method name="set_version"
3889+ c:identifier="adw_about_window_set_version"
3890+ glib:set-property="version"
3891+ version="1.2"
3892+ deprecated="1"
3893+ deprecated-version="1.6">
39883894 <doc xml:space="preserve"
3989- filename="src/adw-avatar.c"
3990- line="601">Sets whether to use initials instead of an icon on the fallback avatar.
3895+ filename="src/adw-about-window.c"
3896+ line="2337">Sets the version for @self.
39913897
3992-See [property@Avatar:icon-name] for how to change the fallback icon.</doc>
3993- <source-position filename="src/adw-avatar.h" line="44"/>
3898+The version is displayed on the main page.
3899+
3900+If [property@AboutWindow:release-notes-version] is not set, the version will
3901+also be displayed above the release notes on the What's New page.</doc>
3902+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
3903+ <source-position filename="src/adw-about-window.h" line="53"/>
39943904 <return-value transfer-ownership="none">
39953905 <type name="none" c:type="void"/>
39963906 </return-value>
39973907 <parameters>
39983908 <instance-parameter name="self" transfer-ownership="none">
39993909 <doc xml:space="preserve"
4000- filename="src/adw-avatar.c"
4001- line="603">an avatar</doc>
4002- <type name="Avatar" c:type="AdwAvatar*"/>
3910+ filename="src/adw-about-window.c"
3911+ line="2339">an about window</doc>
3912+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
40033913 </instance-parameter>
4004- <parameter name="show_initials" transfer-ownership="none">
3914+ <parameter name="version" transfer-ownership="none">
40053915 <doc xml:space="preserve"
4006- filename="src/adw-avatar.c"
4007- line="604">whether to use initials instead of an icon as fallback</doc>
4008- <type name="gboolean" c:type="gboolean"/>
3916+ filename="src/adw-about-window.c"
3917+ line="2340">the version</doc>
3918+ <type name="utf8" c:type="const char*"/>
40093919 </parameter>
40103920 </parameters>
40113921 </method>
4012- <method name="set_size"
4013- c:identifier="adw_avatar_set_size"
4014- glib:set-property="size">
4015- <attribute name="org.gtk.Method.set_property" value="size"/>
3922+ <method name="set_website"
3923+ c:identifier="adw_about_window_set_website"
3924+ glib:set-property="website"
3925+ version="1.2"
3926+ deprecated="1"
3927+ deprecated-version="1.6">
40163928 <doc xml:space="preserve"
4017- filename="src/adw-avatar.c"
4018- line="710">Sets the size of the avatar.</doc>
4019- <source-position filename="src/adw-avatar.h" line="56"/>
3929+ filename="src/adw-about-window.c"
3930+ line="2559">Sets the application website URL for @self.
3931+
3932+Website is displayed on the Details page, below comments, or on the main page
3933+if the Details page doesn't have any other content.
3934+
3935+Applications can add other links below, see [method@AboutWindow.add_link].</doc>
3936+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
3937+ <source-position filename="src/adw-about-window.h" line="77"/>
40203938 <return-value transfer-ownership="none">
40213939 <type name="none" c:type="void"/>
40223940 </return-value>
40233941 <parameters>
40243942 <instance-parameter name="self" transfer-ownership="none">
40253943 <doc xml:space="preserve"
4026- filename="src/adw-avatar.c"
4027- line="712">an avatar</doc>
4028- <type name="Avatar" c:type="AdwAvatar*"/>
3944+ filename="src/adw-about-window.c"
3945+ line="2561">an about window</doc>
3946+ <type name="AboutWindow" c:type="AdwAboutWindow*"/>
40293947 </instance-parameter>
4030- <parameter name="size" transfer-ownership="none">
3948+ <parameter name="website" transfer-ownership="none">
40313949 <doc xml:space="preserve"
4032- filename="src/adw-avatar.c"
4033- line="713">The size of the avatar</doc>
4034- <type name="gint" c:type="int"/>
3950+ filename="src/adw-about-window.c"
3951+ line="2562">the website URL</doc>
3952+ <type name="utf8" c:type="const char*"/>
40353953 </parameter>
40363954 </parameters>
40373955 </method>
4038- <method name="set_text"
4039- c:identifier="adw_avatar_set_text"
4040- glib:set-property="text">
4041- <attribute name="org.gtk.Method.set_property" value="text"/>
3956+ <property name="application-icon"
3957+ version="1.2"
3958+ deprecated="1"
3959+ deprecated-version="1.6"
3960+ writable="1"
3961+ transfer-ownership="none"
3962+ setter="set_application_icon"
3963+ getter="get_application_icon">
40423964 <doc xml:space="preserve"
4043- filename="src/adw-avatar.c"
4044- line="554">Sets the text used to generate the fallback initials and color.
3965+ filename="src/adw-about-window.c"
3966+ line="1386">The name of the application icon.
40453967
4046-It's only used to generate the color if [property@Avatar:show-initials] is
4047-`FALSE`.</doc>
4048- <source-position filename="src/adw-avatar.h" line="38"/>
4049- <return-value transfer-ownership="none">
4050- <type name="none" c:type="void"/>
4051- </return-value>
4052- <parameters>
4053- <instance-parameter name="self" transfer-ownership="none">
4054- <doc xml:space="preserve"
4055- filename="src/adw-avatar.c"
4056- line="556">an avatar</doc>
4057- <type name="Avatar" c:type="AdwAvatar*"/>
4058- </instance-parameter>
4059- <parameter name="text"
4060- transfer-ownership="none"
4061- nullable="1"
4062- allow-none="1">
4063- <doc xml:space="preserve"
4064- filename="src/adw-avatar.c"
4065- line="557">the text used to get the initials and color</doc>
4066- <type name="utf8" c:type="const char*"/>
4067- </parameter>
4068- </parameters>
4069- </method>
4070- <property name="custom-image"
3968+The icon is displayed at the top of the main page.</doc>
3969+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
3970+ <type name="utf8" c:type="gchar*"/>
3971+ </property>
3972+ <property name="application-name"
3973+ version="1.2"
3974+ deprecated="1"
3975+ deprecated-version="1.6"
40713976 writable="1"
40723977 transfer-ownership="none"
4073- setter="set_custom_image"
4074- getter="get_custom_image">
4075- <attribute name="org.gtk.Property.get"
4076- value="adw_avatar_get_custom_image"/>
4077- <attribute name="org.gtk.Property.set"
4078- value="adw_avatar_set_custom_image"/>
3978+ setter="set_application_name"
3979+ getter="get_application_name">
40793980 <doc xml:space="preserve"
4080- filename="src/adw-avatar.c"
4081- line="415">A custom image paintable.
3981+ filename="src/adw-about-window.c"
3982+ line="1401">The name of the application.
40823983
4083-Custom image is displayed instead of initials or icon.</doc>
4084- <type name="Gdk.Paintable"/>
3984+The name is displayed at the top of the main page.</doc>
3985+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
3986+ <type name="utf8" c:type="gchar*"/>
40853987 </property>
4086- <property name="icon-name"
3988+ <property name="artists"
3989+ version="1.2"
3990+ deprecated="1"
3991+ deprecated-version="1.6"
40873992 writable="1"
40883993 transfer-ownership="none"
4089- setter="set_icon_name"
4090- getter="get_icon_name"
4091- default-value="NULL">
4092- <attribute name="org.gtk.Property.get"
4093- value="adw_avatar_get_icon_name"/>
4094- <attribute name="org.gtk.Property.set"
4095- value="adw_avatar_set_icon_name"/>
3994+ setter="set_artists"
3995+ getter="get_artists">
40963996 <doc xml:space="preserve"
4097- filename="src/adw-avatar.c"
4098- line="378">The name of an icon to use as a fallback.
3997+ filename="src/adw-about-window.c"
3998+ line="1677">The list of artists of the application.
40993999
4100-If no name is set, `avatar-default-symbolic` will be used.</doc>
4000+It will be displayed on the Credits page.
4001+
4002+Each name may contain email addresses and URLs, see the introduction for
4003+more details.
4004+
4005+See also:
4006+
4007+* [property@AboutWindow:developers]
4008+* [property@AboutWindow:designers]
4009+* [property@AboutWindow:documenters]
4010+* [property@AboutWindow:translator-credits]
4011+* [method@AboutWindow.add_credit_section]
4012+* [method@AboutWindow.add_acknowledgement_section]</doc>
4013+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
4014+ <array>
4015+ <type name="utf8"/>
4016+ </array>
4017+ </property>
4018+ <property name="comments"
4019+ version="1.2"
4020+ deprecated="1"
4021+ deprecated-version="1.6"
4022+ writable="1"
4023+ transfer-ownership="none"
4024+ setter="set_comments"
4025+ getter="get_comments">
4026+ <doc xml:space="preserve"
4027+ filename="src/adw-about-window.c"
4028+ line="1516">The comments about the application.
4029+
4030+Comments will be shown on the Details page, above links.
4031+
4032+Unlike [property@Gtk.AboutDialog:comments], this string can be long and
4033+detailed. It can also contain links and Pango markup.</doc>
4034+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
41014035 <type name="utf8" c:type="gchar*"/>
41024036 </property>
4103- <property name="show-initials"
4037+ <property name="copyright"
4038+ version="1.2"
4039+ deprecated="1"
4040+ deprecated-version="1.6"
41044041 writable="1"
41054042 transfer-ownership="none"
4106- setter="set_show_initials"
4107- getter="get_show_initials"
4108- default-value="FALSE">
4109- <attribute name="org.gtk.Property.get"
4110- value="adw_avatar_get_show_initials"/>
4111- <attribute name="org.gtk.Property.set"
4112- value="adw_avatar_set_show_initials"/>
4043+ setter="set_copyright"
4044+ getter="get_copyright">
41134045 <doc xml:space="preserve"
4114- filename="src/adw-avatar.c"
4115- line="403">Whether initials are used instead of an icon on the fallback avatar.
4046+ filename="src/adw-about-window.c"
4047+ line="1761">The copyright information.
41164048
4117-See [property@Avatar:icon-name] for how to change the fallback icon.</doc>
4118- <type name="gboolean" c:type="gboolean"/>
4049+This should be a short string of one or two lines, for example:
4050+`© 2022 Example`.
4051+
4052+The copyright information will be displayed on the Legal page, above the
4053+application license.
4054+
4055+[method@AboutWindow.add_legal_section] can be used to add copyright
4056+information for the application dependencies or other components.</doc>
4057+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
4058+ <type name="utf8" c:type="gchar*"/>
41194059 </property>
4120- <property name="size"
4060+ <property name="debug-info"
4061+ version="1.2"
4062+ deprecated="1"
4063+ deprecated-version="1.6"
41214064 writable="1"
41224065 transfer-ownership="none"
4123- setter="set_size"
4124- getter="get_size"
4125- default-value="-1">
4126- <attribute name="org.gtk.Property.get" value="adw_avatar_get_size"/>
4127- <attribute name="org.gtk.Property.set" value="adw_avatar_set_size"/>
4066+ setter="set_debug_info"
4067+ getter="get_debug_info">
41284068 <doc xml:space="preserve"
4129- filename="src/adw-avatar.c"
4130- line="427">The size of the avatar.</doc>
4131- <type name="gint" c:type="gint"/>
4069+ filename="src/adw-about-window.c"
4070+ line="1582">The debug information.
4071+
4072+Debug information will be shown on the Troubleshooting page. It's intended
4073+to be attached to issue reports when reporting issues against the
4074+application.
4075+
4076+`AdwAboutWindow` provides a quick way to save debug information to a file.
4077+When saving, [property@AboutWindow:debug-info-filename] would be used as
4078+the suggested filename.
4079+
4080+Debug information cannot contain markup or links.</doc>
4081+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
4082+ <type name="utf8" c:type="gchar*"/>
41324083 </property>
4133- <property name="text"
4084+ <property name="debug-info-filename"
4085+ version="1.2"
4086+ deprecated="1"
4087+ deprecated-version="1.6"
41344088 writable="1"
41354089 transfer-ownership="none"
4136- setter="set_text"
4137- getter="get_text">
4138- <attribute name="org.gtk.Property.get" value="adw_avatar_get_text"/>
4139- <attribute name="org.gtk.Property.set" value="adw_avatar_set_text"/>
4090+ setter="set_debug_info_filename"
4091+ getter="get_debug_info_filename">
41404092 <doc xml:space="preserve"
4141- filename="src/adw-avatar.c"
4142- line="390">Sets the text used to generate the fallback initials and color.
4093+ filename="src/adw-about-window.c"
4094+ line="1605">The debug information filename.
41434095
4144-It's only used to generate the color if [property@Avatar:show-initials] is
4145-`FALSE`.</doc>
4096+It will be used as the suggested filename when saving debug information to
4097+a file.
4098+
4099+See [property@AboutWindow:debug-info].</doc>
4100+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
41464101 <type name="utf8" c:type="gchar*"/>
41474102 </property>
4148- </class>
4149- <record name="AvatarClass"
4150- c:type="AdwAvatarClass"
4151- glib:is-gtype-struct-for="Avatar">
4152- <source-position filename="src/adw-avatar.h" line="22"/>
4153- <field name="parent_class">
4154- <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
4155- </field>
4156- </record>
4157- <class name="Banner"
4158- c:symbol-prefix="banner"
4159- c:type="AdwBanner"
4160- version="1.3"
4161- parent="Gtk.Widget"
4162- final="1"
4163- glib:type-name="AdwBanner"
4164- glib:get-type="adw_banner_get_type"
4165- glib:type-struct="BannerClass">
4166- <doc xml:space="preserve"
4167- filename="src/adw-banner.c"
4168- line="23">A bar with contextual information.
4103+ <property name="designers"
4104+ version="1.2"
4105+ deprecated="1"
4106+ deprecated-version="1.6"
4107+ writable="1"
4108+ transfer-ownership="none"
4109+ setter="set_designers"
4110+ getter="get_designers">
4111+ <doc xml:space="preserve"
4112+ filename="src/adw-about-window.c"
4113+ line="1650">The list of designers of the application.
41694114
4170-&lt;picture&gt;
4171- &lt;source srcset="banner-dark.png" media="(prefers-color-scheme: dark)"&gt;
4172- &lt;img src="banner.png" alt="banner"&gt;
4173-&lt;/picture&gt;
4115+It will be displayed on the Credits page.
41744116
4175-Banners are hidden by default, use [property@Banner:revealed] to show them.
4117+Each name may contain email addresses and URLs, see the introduction for
4118+more details.
41764119
4177-Banners have a title, set with [property@Banner:title]. Titles can be marked
4178-up with Pango markup, use [property@Banner:use-markup] to enable it.
4120+See also:
41794121
4180-The title will be shown centered or left-aligned depending on available
4181-space.
4122+* [property@AboutWindow:developers]
4123+* [property@AboutWindow:artists]
4124+* [property@AboutWindow:documenters]
4125+* [property@AboutWindow:translator-credits]
4126+* [method@AboutWindow.add_credit_section]
4127+* [method@AboutWindow.add_acknowledgement_section]</doc>
4128+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
4129+ <array>
4130+ <type name="utf8"/>
4131+ </array>
4132+ </property>
4133+ <property name="developer-name"
4134+ version="1.2"
4135+ deprecated="1"
4136+ deprecated-version="1.6"
4137+ writable="1"
4138+ transfer-ownership="none"
4139+ setter="set_developer_name"
4140+ getter="get_developer_name">
4141+ <doc xml:space="preserve"
4142+ filename="src/adw-about-window.c"
4143+ line="1416">The developer name.
41824144
4183-Banners can optionally have a button with text on it, set through
4184-[property@Banner:button-label]. The button can be used with a `GAction`,
4185-or with the [signal@Banner::button-clicked] signal.
4145+The developer name is displayed on the main page, under the application
4146+name.
41864147
4187-## CSS nodes
4148+If the application is developed by multiple people, the developer name can
4149+be set to values like "AppName team", "AppName developers" or
4150+"The AppName project", and the individual contributors can be listed on the
4151+Credits page, with [property@AboutWindow:developers] and related
4152+properties.</doc>
4153+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
4154+ <type name="utf8" c:type="gchar*"/>
4155+ </property>
4156+ <property name="developers"
4157+ version="1.2"
4158+ deprecated="1"
4159+ deprecated-version="1.6"
4160+ writable="1"
4161+ transfer-ownership="none"
4162+ setter="set_developers"
4163+ getter="get_developers">
4164+ <doc xml:space="preserve"
4165+ filename="src/adw-about-window.c"
4166+ line="1623">The list of developers of the application.
41884167
4189-`AdwBanner` has a main CSS node with the name `banner`.</doc>
4190- <source-position filename="src/adw-banner.h" line="23"/>
4191- <implements name="Gtk.Accessible"/>
4192- <implements name="Gtk.Actionable"/>
4193- <implements name="Gtk.Buildable"/>
4194- <implements name="Gtk.ConstraintTarget"/>
4195- <constructor name="new" c:identifier="adw_banner_new" version="1.3">
4168+It will be displayed on the Credits page.
4169+
4170+Each name may contain email addresses and URLs, see the introduction for
4171+more details.
4172+
4173+See also:
4174+
4175+* [property@AboutWindow:designers]
4176+* [property@AboutWindow:artists]
4177+* [property@AboutWindow:documenters]
4178+* [property@AboutWindow:translator-credits]
4179+* [method@AboutWindow.add_credit_section]
4180+* [method@AboutWindow.add_acknowledgement_section]</doc>
4181+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
4182+ <array>
4183+ <type name="utf8"/>
4184+ </array>
4185+ </property>
4186+ <property name="documenters"
4187+ version="1.2"
4188+ deprecated="1"
4189+ deprecated-version="1.6"
4190+ writable="1"
4191+ transfer-ownership="none"
4192+ setter="set_documenters"
4193+ getter="get_documenters">
41964194 <doc xml:space="preserve"
4197- filename="src/adw-banner.c"
4198- line="507">Creates a new `AdwBanner`.</doc>
4199- <source-position filename="src/adw-banner.h" line="26"/>
4200- <return-value transfer-ownership="none">
4201- <doc xml:space="preserve"
4202- filename="src/adw-banner.c"
4203- line="513">the newly created `AdwBanner`</doc>
4204- <type name="Gtk.Widget" c:type="GtkWidget*"/>
4205- </return-value>
4206- <parameters>
4207- <parameter name="title" transfer-ownership="none">
4208- <doc xml:space="preserve"
4209- filename="src/adw-banner.c"
4210- line="509">the banner title</doc>
4211- <type name="utf8" c:type="const char*"/>
4212- </parameter>
4213- </parameters>
4214- </constructor>
4215- <method name="get_button_label"
4216- c:identifier="adw_banner_get_button_label"
4217- glib:get-property="button-label"
4218- version="1.3">
4219- <attribute name="org.gtk.Method.get_property" value="button-label"/>
4220- <doc xml:space="preserve"
4221- filename="src/adw-banner.c"
4222- line="571">Gets the button label for @self.</doc>
4223- <source-position filename="src/adw-banner.h" line="35"/>
4224- <return-value transfer-ownership="none" nullable="1">
4225- <doc xml:space="preserve"
4226- filename="src/adw-banner.c"
4227- line="577">the button label for @self</doc>
4228- <type name="utf8" c:type="const char*"/>
4229- </return-value>
4230- <parameters>
4231- <instance-parameter name="self" transfer-ownership="none">
4232- <doc xml:space="preserve"
4233- filename="src/adw-banner.c"
4234- line="573">a banner</doc>
4235- <type name="Banner" c:type="AdwBanner*"/>
4236- </instance-parameter>
4237- </parameters>
4238- </method>
4239- <method name="get_revealed"
4240- c:identifier="adw_banner_get_revealed"
4241- glib:get-property="revealed"
4242- version="1.3">
4243- <attribute name="org.gtk.Method.get_property" value="revealed"/>
4244- <doc xml:space="preserve"
4245- filename="src/adw-banner.c"
4246- line="664">Gets if a banner is revealed</doc>
4247- <source-position filename="src/adw-banner.h" line="41"/>
4248- <return-value transfer-ownership="none">
4249- <doc xml:space="preserve"
4250- filename="src/adw-banner.c"
4251- line="670">Whether a banner is revealed</doc>
4252- <type name="gboolean" c:type="gboolean"/>
4253- </return-value>
4254- <parameters>
4255- <instance-parameter name="self" transfer-ownership="none">
4256- <doc xml:space="preserve"
4257- filename="src/adw-banner.c"
4258- line="666">a banner</doc>
4259- <type name="Banner" c:type="AdwBanner*"/>
4260- </instance-parameter>
4261- </parameters>
4262- </method>
4263- <method name="get_title"
4264- c:identifier="adw_banner_get_title"
4265- glib:get-property="title"
4266- version="1.3">
4267- <attribute name="org.gtk.Method.get_property" value="title"/>
4268- <doc xml:space="preserve"
4269- filename="src/adw-banner.c"
4270- line="527">Gets the title for @self.</doc>
4271- <source-position filename="src/adw-banner.h" line="29"/>
4272- <return-value transfer-ownership="none">
4273- <doc xml:space="preserve"
4274- filename="src/adw-banner.c"
4275- line="533">the title for @self</doc>
4276- <type name="utf8" c:type="const char*"/>
4277- </return-value>
4278- <parameters>
4279- <instance-parameter name="self" transfer-ownership="none">
4280- <doc xml:space="preserve"
4281- filename="src/adw-banner.c"
4282- line="529">a banner</doc>
4283- <type name="Banner" c:type="AdwBanner*"/>
4284- </instance-parameter>
4285- </parameters>
4286- </method>
4287- <method name="get_use_markup"
4288- c:identifier="adw_banner_get_use_markup"
4289- glib:get-property="use-markup"
4290- version="1.3">
4291- <attribute name="org.gtk.Method.get_property" value="use-markup"/>
4292- <doc xml:space="preserve"
4293- filename="src/adw-banner.c"
4294- line="619">Gets whether to use Pango markup for the banner title.</doc>
4295- <source-position filename="src/adw-banner.h" line="47"/>
4296- <return-value transfer-ownership="none">
4297- <doc xml:space="preserve"
4298- filename="src/adw-banner.c"
4299- line="625">whether to use markup</doc>
4300- <type name="gboolean" c:type="gboolean"/>
4301- </return-value>
4302- <parameters>
4303- <instance-parameter name="self" transfer-ownership="none">
4304- <doc xml:space="preserve"
4305- filename="src/adw-banner.c"
4306- line="621">a banner</doc>
4307- <type name="Banner" c:type="AdwBanner*"/>
4308- </instance-parameter>
4309- </parameters>
4310- </method>
4311- <method name="set_button_label"
4312- c:identifier="adw_banner_set_button_label"
4313- glib:set-property="button-label"
4314- version="1.3">
4315- <attribute name="org.gtk.Method.set_property" value="button-label"/>
4316- <doc xml:space="preserve"
4317- filename="src/adw-banner.c"
4318- line="589">Sets the button label for @self.
4195+ filename="src/adw-about-window.c"
4196+ line="1704">The list of documenters of the application.
43194197
4320-If set to `""` or `NULL`, the button won't be shown.
4198+It will be displayed on the Credits page.
43214199
4322-The button can be used with a `GAction`, or with the
4323-[signal@Banner::button-clicked] signal.</doc>
4324- <source-position filename="src/adw-banner.h" line="37"/>
4325- <return-value transfer-ownership="none">
4326- <type name="none" c:type="void"/>
4327- </return-value>
4328- <parameters>
4329- <instance-parameter name="self" transfer-ownership="none">
4330- <doc xml:space="preserve"
4331- filename="src/adw-banner.c"
4332- line="591">a banner</doc>
4333- <type name="Banner" c:type="AdwBanner*"/>
4334- </instance-parameter>
4335- <parameter name="label"
4336- transfer-ownership="none"
4337- nullable="1"
4338- allow-none="1">
4339- <doc xml:space="preserve"
4340- filename="src/adw-banner.c"
4341- line="592">the label</doc>
4342- <type name="utf8" c:type="const char*"/>
4343- </parameter>
4344- </parameters>
4345- </method>
4346- <method name="set_revealed"
4347- c:identifier="adw_banner_set_revealed"
4348- glib:set-property="revealed"
4349- version="1.3">
4350- <attribute name="org.gtk.Method.get_property" value="revealed"/>
4351- <doc xml:space="preserve"
4352- filename="src/adw-banner.c"
4353- line="682">Sets whether a banner should be revealed</doc>
4354- <source-position filename="src/adw-banner.h" line="43"/>
4355- <return-value transfer-ownership="none">
4356- <type name="none" c:type="void"/>
4357- </return-value>
4358- <parameters>
4359- <instance-parameter name="self" transfer-ownership="none">
4360- <doc xml:space="preserve"
4361- filename="src/adw-banner.c"
4362- line="684">a banner</doc>
4363- <type name="Banner" c:type="AdwBanner*"/>
4364- </instance-parameter>
4365- <parameter name="revealed" transfer-ownership="none">
4366- <doc xml:space="preserve"
4367- filename="src/adw-banner.c"
4368- line="685">whether a banner should be revealed</doc>
4369- <type name="gboolean" c:type="gboolean"/>
4370- </parameter>
4371- </parameters>
4372- </method>
4373- <method name="set_title"
4374- c:identifier="adw_banner_set_title"
4375- glib:set-property="title"
4376- version="1.3">
4377- <attribute name="org.gtk.Method.set_property" value="title"/>
4378- <doc xml:space="preserve"
4379- filename="src/adw-banner.c"
4380- line="545">Sets the title for this banner.
4200+Each name may contain email addresses and URLs, see the introduction for
4201+more details.
43814202
4382-See also: [property@Banner:use-markup].</doc>
4383- <source-position filename="src/adw-banner.h" line="31"/>
4384- <return-value transfer-ownership="none">
4385- <type name="none" c:type="void"/>
4386- </return-value>
4387- <parameters>
4388- <instance-parameter name="self" transfer-ownership="none">
4389- <doc xml:space="preserve"
4390- filename="src/adw-banner.c"
4391- line="547">a banner</doc>
4392- <type name="Banner" c:type="AdwBanner*"/>
4393- </instance-parameter>
4394- <parameter name="title" transfer-ownership="none">
4395- <doc xml:space="preserve"
4396- filename="src/adw-banner.c"
4397- line="548">the title</doc>
4398- <type name="utf8" c:type="const char*"/>
4399- </parameter>
4400- </parameters>
4401- </method>
4402- <method name="set_use_markup"
4403- c:identifier="adw_banner_set_use_markup"
4404- glib:set-property="use-markup"
4405- version="1.3">
4406- <attribute name="org.gtk.Method.set_property" value="use-markup"/>
4407- <doc xml:space="preserve"
4408- filename="src/adw-banner.c"
4409- line="637">Sets whether to use Pango markup for the banner title.
4203+See also:
44104204
4411-See also [func@Pango.parse_markup].</doc>
4412- <source-position filename="src/adw-banner.h" line="49"/>
4413- <return-value transfer-ownership="none">
4414- <type name="none" c:type="void"/>
4415- </return-value>
4416- <parameters>
4417- <instance-parameter name="self" transfer-ownership="none">
4418- <doc xml:space="preserve"
4419- filename="src/adw-banner.c"
4420- line="639">a banner</doc>
4421- <type name="Banner" c:type="AdwBanner*"/>
4422- </instance-parameter>
4423- <parameter name="use_markup" transfer-ownership="none">
4424- <doc xml:space="preserve"
4425- filename="src/adw-banner.c"
4426- line="640">whether to use markup</doc>
4427- <type name="gboolean" c:type="gboolean"/>
4428- </parameter>
4429- </parameters>
4430- </method>
4431- <property name="button-label"
4432- version="1.3"
4205+* [property@AboutWindow:developers]
4206+* [property@AboutWindow:designers]
4207+* [property@AboutWindow:artists]
4208+* [property@AboutWindow:translator-credits]
4209+* [method@AboutWindow.add_credit_section]
4210+* [method@AboutWindow.add_acknowledgement_section]</doc>
4211+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
4212+ <array>
4213+ <type name="utf8"/>
4214+ </array>
4215+ </property>
4216+ <property name="issue-url"
4217+ version="1.2"
4218+ deprecated="1"
4219+ deprecated-version="1.6"
44334220 writable="1"
44344221 transfer-ownership="none"
4435- setter="set_button_label"
4436- getter="get_button_label">
4437- <attribute name="org.gtk.Property.get"
4438- value="adw_banner_get_button_label"/>
4439- <attribute name="org.gtk.Property.set"
4440- value="adw_banner_set_button_label"/>
4222+ setter="set_issue_url"
4223+ getter="get_issue_url">
44414224 <doc xml:space="preserve"
4442- filename="src/adw-banner.c"
4443- line="367">The label to show on the button.
4444-
4445-If set to `""` or `NULL`, the button won't be shown.
4225+ filename="src/adw-about-window.c"
4226+ line="1567">The URL for the application's issue tracker.
44464227
4447-The button can be used with a `GAction`, or with the
4448-[signal@Banner::button-clicked] signal.</doc>
4228+The issue tracker link is displayed on the main page.</doc>
4229+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
44494230 <type name="utf8" c:type="gchar*"/>
44504231 </property>
4451- <property name="revealed"
4452- version="1.3"
4453- writable="1"
4454- transfer-ownership="none"
4455- setter="set_revealed"
4456- getter="get_revealed"
4457- default-value="FALSE">
4458- <attribute name="org.gtk.Property.get"
4459- value="adw_banner_get_revealed"/>
4460- <attribute name="org.gtk.Property.set"
4461- value="adw_banner_set_revealed"/>
4462- <doc xml:space="preserve"
4463- filename="src/adw-banner.c"
4464- line="398">Whether the banner is currently revealed.</doc>
4465- <type name="gboolean" c:type="gboolean"/>
4466- </property>
4467- <property name="title"
4468- version="1.3"
4232+ <property name="license"
4233+ version="1.2"
4234+ deprecated="1"
4235+ deprecated-version="1.6"
44694236 writable="1"
44704237 transfer-ownership="none"
4471- setter="set_title"
4472- getter="get_title">
4473- <attribute name="org.gtk.Property.get" value="adw_banner_get_title"/>
4474- <attribute name="org.gtk.Property.set" value="adw_banner_set_title"/>
4238+ setter="set_license"
4239+ getter="get_license">
44754240 <doc xml:space="preserve"
4476- filename="src/adw-banner.c"
4477- line="353">The title for this banner.
4241+ filename="src/adw-about-window.c"
4242+ line="1814">The license text.
44784243
4479-See also: [property@Banner:use-markup].</doc>
4244+This can be used to set a custom text for the license if it can't be set
4245+via [property@AboutWindow:license-type].
4246+
4247+When set, [property@AboutWindow:license-type] will be set to
4248+`GTK_LICENSE_CUSTOM`.
4249+
4250+The license text will be displayed on the Legal page, below the copyright
4251+information.
4252+
4253+License text can contain Pango markup and links.
4254+
4255+[method@AboutWindow.add_legal_section] can be used to add license
4256+information for the application dependencies or other components.</doc>
4257+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
44804258 <type name="utf8" c:type="gchar*"/>
44814259 </property>
4482- <property name="use-markup"
4483- version="1.3"
4260+ <property name="license-type"
4261+ version="1.2"
4262+ deprecated="1"
4263+ deprecated-version="1.6"
44844264 writable="1"
44854265 transfer-ownership="none"
4486- setter="set_use_markup"
4487- getter="get_use_markup"
4488- default-value="TRUE">
4489- <attribute name="org.gtk.Property.get"
4490- value="adw_banner_get_use_markup"/>
4491- <attribute name="org.gtk.Property.set"
4492- value="adw_banner_set_use_markup"/>
4266+ setter="set_license_type"
4267+ getter="get_license_type"
4268+ default-value="GTK_LICENSE_UNKNOWN">
44934269 <doc xml:space="preserve"
4494- filename="src/adw-banner.c"
4495- line="384">Whether to use Pango markup for the banner title.
4270+ filename="src/adw-about-window.c"
4271+ line="1783">The license type.
44964272
4497-See also [func@Pango.parse_markup].</doc>
4498- <type name="gboolean" c:type="gboolean"/>
4499- </property>
4500- <glib:signal name="button-clicked" when="last" version="1.3">
4501- <doc xml:space="preserve"
4502- filename="src/adw-banner.c"
4503- line="410">This signal is emitted after the action button has been clicked.
4273+Allows to set the application's license froma list of known licenses.
45044274
4505-It can be used as an alternative to setting an action.</doc>
4506- <return-value transfer-ownership="none">
4507- <type name="none" c:type="void"/>
4508- </return-value>
4509- </glib:signal>
4510- </class>
4511- <record name="BannerClass"
4512- c:type="AdwBannerClass"
4513- glib:is-gtype-struct-for="Banner">
4514- <source-position filename="src/adw-banner.h" line="23"/>
4515- <field name="parent_class">
4516- <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
4517- </field>
4518- </record>
4519- <class name="Bin"
4520- c:symbol-prefix="bin"
4521- c:type="AdwBin"
4522- parent="Gtk.Widget"
4523- glib:type-name="AdwBin"
4524- glib:get-type="adw_bin_get_type"
4525- glib:type-struct="BinClass">
4526- <doc xml:space="preserve"
4527- filename="src/adw-bin.c"
4528- line="14">A widget with one child.
4275+If the application's license is not in the list,
4276+[property@AboutWindow:license] can be used instead. The license type will
4277+be automatically set to `GTK_LICENSE_CUSTOM` in that case.
45294278
4530-&lt;picture&gt;
4531- &lt;source srcset="bin-dark.png" media="(prefers-color-scheme: dark)"&gt;
4532- &lt;img src="bin.png" alt="bin"&gt;
4533-&lt;/picture&gt;
4279+If set to `GTK_LICENSE_UNKNOWN`, no information will be displayed.
45344280
4535-The `AdwBin` widget has only one child, set with the [property@Bin:child]
4536-property.
4281+If the license type is different from `GTK_LICENSE_CUSTOM`.
4282+[property@AboutWindow:license] will be cleared out.
45374283
4538-It is useful for deriving subclasses, since it provides common code needed
4539-for handling a single child widget.</doc>
4540- <source-position filename="src/adw-bin.h" line="29"/>
4541- <implements name="Gtk.Accessible"/>
4542- <implements name="Gtk.Buildable"/>
4543- <implements name="Gtk.ConstraintTarget"/>
4544- <constructor name="new" c:identifier="adw_bin_new">
4545- <doc xml:space="preserve"
4546- filename="src/adw-bin.c"
4547- line="149">Creates a new `AdwBin`.</doc>
4548- <source-position filename="src/adw-bin.h" line="32"/>
4549- <return-value transfer-ownership="none">
4550- <doc xml:space="preserve"
4551- filename="src/adw-bin.c"
4552- line="154">the new created `AdwBin`</doc>
4553- <type name="Gtk.Widget" c:type="GtkWidget*"/>
4554- </return-value>
4555- </constructor>
4556- <method name="get_child"
4557- c:identifier="adw_bin_get_child"
4558- glib:get-property="child">
4559- <attribute name="org.gtk.Method.get_property" value="child"/>
4560- <doc xml:space="preserve"
4561- filename="src/adw-bin.c"
4562- line="162">Gets the child widget of @self.</doc>
4563- <source-position filename="src/adw-bin.h" line="35"/>
4564- <return-value transfer-ownership="none" nullable="1">
4565- <doc xml:space="preserve"
4566- filename="src/adw-bin.c"
4567- line="168">the child widget of @self</doc>
4568- <type name="Gtk.Widget" c:type="GtkWidget*"/>
4569- </return-value>
4570- <parameters>
4571- <instance-parameter name="self" transfer-ownership="none">
4572- <doc xml:space="preserve"
4573- filename="src/adw-bin.c"
4574- line="164">a bin</doc>
4575- <type name="Bin" c:type="AdwBin*"/>
4576- </instance-parameter>
4577- </parameters>
4578- </method>
4579- <method name="set_child"
4580- c:identifier="adw_bin_set_child"
4581- glib:set-property="child">
4582- <attribute name="org.gtk.Method.set_property" value="child"/>
4583- <doc xml:space="preserve"
4584- filename="src/adw-bin.c"
4585- line="182">Sets the child widget of @self.</doc>
4586- <source-position filename="src/adw-bin.h" line="37"/>
4587- <return-value transfer-ownership="none">
4588- <type name="none" c:type="void"/>
4589- </return-value>
4590- <parameters>
4591- <instance-parameter name="self" transfer-ownership="none">
4592- <doc xml:space="preserve"
4593- filename="src/adw-bin.c"
4594- line="184">a bin</doc>
4595- <type name="Bin" c:type="AdwBin*"/>
4596- </instance-parameter>
4597- <parameter name="child"
4598- transfer-ownership="none"
4599- nullable="1"
4600- allow-none="1">
4601- <doc xml:space="preserve"
4602- filename="src/adw-bin.c"
4603- line="185">the child widget</doc>
4604- <type name="Gtk.Widget" c:type="GtkWidget*"/>
4605- </parameter>
4606- </parameters>
4607- </method>
4608- <property name="child"
4284+The license description will be displayed on the Legal page, below the
4285+copyright information.
4286+
4287+[method@AboutWindow.add_legal_section] can be used to add license
4288+information for the application dependencies or other components.</doc>
4289+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
4290+ <type name="Gtk.License"/>
4291+ </property>
4292+ <property name="release-notes"
4293+ version="1.2"
4294+ deprecated="1"
4295+ deprecated-version="1.6"
46094296 writable="1"
46104297 transfer-ownership="none"
4611- setter="set_child"
4612- getter="get_child">
4613- <attribute name="org.gtk.Property.get" value="adw_bin_get_child"/>
4614- <attribute name="org.gtk.Property.set" value="adw_bin_set_child"/>
4298+ setter="set_release_notes"
4299+ getter="get_release_notes">
46154300 <doc xml:space="preserve"
4616- filename="src/adw-bin.c"
4617- line="109">The child widget of the `AdwBin`.</doc>
4618- <type name="Gtk.Widget"/>
4619- </property>
4620- <field name="parent_instance">
4621- <type name="Gtk.Widget" c:type="GtkWidget"/>
4622- </field>
4623- </class>
4624- <record name="BinClass"
4625- c:type="AdwBinClass"
4626- glib:is-gtype-struct-for="Bin">
4627- <source-position filename="src/adw-bin.h" line="29"/>
4628- <field name="parent_class">
4629- <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
4630- </field>
4631- </record>
4632- <class name="ButtonContent"
4633- c:symbol-prefix="button_content"
4634- c:type="AdwButtonContent"
4635- parent="Gtk.Widget"
4636- final="1"
4637- glib:type-name="AdwButtonContent"
4638- glib:get-type="adw_button_content_get_type"
4639- glib:type-struct="ButtonContentClass">
4640- <doc xml:space="preserve"
4641- filename="src/adw-button-content.c"
4642- line="14">A helper widget for creating buttons.
4301+ filename="src/adw-about-window.c"
4302+ line="1480">The release notes of the application.
46434303
4644-&lt;picture&gt;
4645- &lt;source srcset="button-content-dark.png" media="(prefers-color-scheme: dark)"&gt;
4646- &lt;img src="button-content.png" alt="button-content"&gt;
4647-&lt;/picture&gt;
4304+Release notes are displayed on the the What's New page.
46484305
4649-`AdwButtonContent` is a box-like widget with an icon and a label.
4306+Release notes are formatted the same way as
4307+[AppStream descriptions](https://freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-description).
46504308
4651-It's intended to be used as a direct child of [class@Gtk.Button],
4652-[class@Gtk.MenuButton] or [class@SplitButton], when they need to have both an
4653-icon and a label, as follows:
4309+The supported formatting options are:
46544310
4655-```xml
4656-&lt;object class="GtkButton"&gt;
4657- &lt;property name="child"&gt;
4658- &lt;object class="AdwButtonContent"&gt;
4659- &lt;property name="icon-name"&gt;document-open-symbolic&lt;/property&gt;
4660- &lt;property name="label" translatable="yes"&gt;_Open&lt;/property&gt;
4661- &lt;property name="use-underline"&gt;True&lt;/property&gt;
4662- &lt;/object&gt;
4663- &lt;/property&gt;
4664-&lt;/object&gt;
4665-```
4311+* Paragraph (`&lt;p&gt;`)
4312+* Ordered list (`&lt;ol&gt;`), with list items (`&lt;li&gt;`)
4313+* Unordered list (`&lt;ul&gt;`), with list items (`&lt;li&gt;`)
46664314
4667-`AdwButtonContent` handles style classes and connecting the mnemonic to the
4668-button automatically.
4315+Within paragraphs and list items, emphasis (`&lt;em&gt;`) and inline code
4316+(`&lt;code&gt;`) text styles are supported. The emphasis is rendered in italic,
4317+while inline code is shown in a monospaced font.
46694318
4670-## CSS nodes
4319+Any text outside paragraphs or list items is ignored.
46714320
4672-```
4673-buttoncontent
4674-├── image
4675-╰── label
4676-```
4321+Nested lists are not supported.
46774322
4678-`AdwButtonContent`'s CSS node is called `buttoncontent`. It contains the
4679-subnodes `image` and `label`.
4323+`AdwAboutWindow` displays the version above the release notes. If set, the
4324+[property@AboutWindow:release-notes-version] of the property will be used
4325+as the version; otherwise, [property@AboutWindow:version] is used.</doc>
4326+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
4327+ <type name="utf8" c:type="gchar*"/>
4328+ </property>
4329+ <property name="release-notes-version"
4330+ version="1.2"
4331+ deprecated="1"
4332+ deprecated-version="1.6"
4333+ writable="1"
4334+ transfer-ownership="none"
4335+ setter="set_release_notes_version"
4336+ getter="get_release_notes_version">
4337+ <doc xml:space="preserve"
4338+ filename="src/adw-about-window.c"
4339+ line="1456">The version described by the application's release notes.
46804340
4681-When inside a `GtkButton` or `AdwSplitButton`, the button will receive the
4682-`.image-text-button` style class. When inside a `GtkMenuButton`, the
4683-internal `GtkButton` will receive it instead.
4341+The release notes version is displayed on the What's New page, above the
4342+release notes.
46844343
4685-## Accessibility
4344+If not set, [property@AboutWindow:version] will be used instead.
46864345
4687-`AdwButtonContent` uses the `GTK_ACCESSIBLE_ROLE_GROUP` role.</doc>
4688- <source-position filename="src/adw-button-content.h" line="24"/>
4689- <implements name="Gtk.Accessible"/>
4690- <implements name="Gtk.Buildable"/>
4691- <implements name="Gtk.ConstraintTarget"/>
4692- <constructor name="new" c:identifier="adw_button_content_new">
4346+For example, an application with the current version 2.0.2 might want to
4347+keep the release notes from 2.0.0, and set the release notes version
4348+accordingly.
4349+
4350+See [property@AboutWindow:release-notes].</doc>
4351+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
4352+ <type name="utf8" c:type="gchar*"/>
4353+ </property>
4354+ <property name="support-url"
4355+ version="1.2"
4356+ deprecated="1"
4357+ deprecated-version="1.6"
4358+ writable="1"
4359+ transfer-ownership="none"
4360+ setter="set_support_url"
4361+ getter="get_support_url">
46934362 <doc xml:space="preserve"
4694- filename="src/adw-button-content.c"
4695- line="276">Creates a new `AdwButtonContent`.</doc>
4696- <source-position filename="src/adw-button-content.h" line="27"/>
4697- <return-value transfer-ownership="none">
4698- <doc xml:space="preserve"
4699- filename="src/adw-button-content.c"
4700- line="281">the new created `AdwButtonContent`</doc>
4701- <type name="Gtk.Widget" c:type="GtkWidget*"/>
4702- </return-value>
4703- </constructor>
4704- <method name="get_icon_name"
4705- c:identifier="adw_button_content_get_icon_name"
4706- glib:get-property="icon-name">
4707- <attribute name="org.gtk.Method.get_property" value="icon-name"/>
4363+ filename="src/adw-about-window.c"
4364+ line="1552">The URL of the application's support page.
4365+
4366+The support page link is displayed on the main page.</doc>
4367+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
4368+ <type name="utf8" c:type="gchar*"/>
4369+ </property>
4370+ <property name="translator-credits"
4371+ version="1.2"
4372+ deprecated="1"
4373+ deprecated-version="1.6"
4374+ writable="1"
4375+ transfer-ownership="none"
4376+ setter="set_translator_credits"
4377+ getter="get_translator_credits">
47084378 <doc xml:space="preserve"
4709- filename="src/adw-button-content.c"
4710- line="289">Gets the name of the displayed icon.</doc>
4711- <source-position filename="src/adw-button-content.h" line="36"/>
4712- <return-value transfer-ownership="none">
4713- <doc xml:space="preserve"
4714- filename="src/adw-button-content.c"
4715- line="295">the icon name</doc>
4716- <type name="utf8" c:type="const char*"/>
4717- </return-value>
4718- <parameters>
4719- <instance-parameter name="self" transfer-ownership="none">
4720- <doc xml:space="preserve"
4721- filename="src/adw-button-content.c"
4722- line="291">a button content</doc>
4723- <type name="ButtonContent" c:type="AdwButtonContent*"/>
4724- </instance-parameter>
4725- </parameters>
4726- </method>
4727- <method name="get_label"
4728- c:identifier="adw_button_content_get_label"
4729- glib:get-property="label">
4730- <attribute name="org.gtk.Method.get_property" value="label"/>
4379+ filename="src/adw-about-window.c"
4380+ line="1731">The translator credits string.
4381+
4382+It will be displayed on the Credits page.
4383+
4384+This string should be `"translator-credits"` or `"translator_credits"` and
4385+should be marked as translatable.
4386+
4387+The string may contain email addresses and URLs, see the introduction for
4388+more details.
4389+
4390+See also:
4391+
4392+* [property@AboutWindow:developers]
4393+* [property@AboutWindow:designers]
4394+* [property@AboutWindow:artists]
4395+* [property@AboutWindow:documenters]
4396+* [method@AboutWindow.add_credit_section]
4397+* [method@AboutWindow.add_acknowledgement_section]</doc>
4398+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
4399+ <type name="utf8" c:type="gchar*"/>
4400+ </property>
4401+ <property name="version"
4402+ version="1.2"
4403+ deprecated="1"
4404+ deprecated-version="1.6"
4405+ writable="1"
4406+ transfer-ownership="none"
4407+ setter="set_version"
4408+ getter="get_version">
47314409 <doc xml:space="preserve"
4732- filename="src/adw-button-content.c"
4733- line="335">Gets the displayed label.</doc>
4734- <source-position filename="src/adw-button-content.h" line="30"/>
4735- <return-value transfer-ownership="none">
4736- <doc xml:space="preserve"
4737- filename="src/adw-button-content.c"
4738- line="341">the label</doc>
4739- <type name="utf8" c:type="const char*"/>
4740- </return-value>
4741- <parameters>
4742- <instance-parameter name="self" transfer-ownership="none">
4743- <doc xml:space="preserve"
4744- filename="src/adw-button-content.c"
4745- line="337">a button content</doc>
4746- <type name="ButtonContent" c:type="AdwButtonContent*"/>
4747- </instance-parameter>
4748- </parameters>
4749- </method>
4750- <method name="get_use_underline"
4751- c:identifier="adw_button_content_get_use_underline"
4752- glib:get-property="use-underline">
4753- <attribute name="org.gtk.Method.get_property" value="use-underline"/>
4410+ filename="src/adw-about-window.c"
4411+ line="1438">The version of the application.
4412+
4413+The version is displayed on the main page.
4414+
4415+If [property@AboutWindow:release-notes-version] is not set, the version
4416+will also be displayed above the release notes on the What's New page.</doc>
4417+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
4418+ <type name="utf8" c:type="gchar*"/>
4419+ </property>
4420+ <property name="website"
4421+ version="1.2"
4422+ deprecated="1"
4423+ deprecated-version="1.6"
4424+ writable="1"
4425+ transfer-ownership="none"
4426+ setter="set_website"
4427+ getter="get_website">
47544428 <doc xml:space="preserve"
4755- filename="src/adw-button-content.c"
4756- line="376">Gets whether an underline in the text indicates a mnemonic.</doc>
4757- <source-position filename="src/adw-button-content.h" line="42"/>
4429+ filename="src/adw-about-window.c"
4430+ line="1534">The URL of the application's website.
4431+
4432+Website is displayed on the Details page, below comments, or on the main
4433+page if the Details page doesn't have any other content.
4434+
4435+Applications can add other links below, see [method@AboutWindow.add_link].</doc>
4436+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
4437+ <type name="utf8" c:type="gchar*"/>
4438+ </property>
4439+ <glib:signal name="activate-link"
4440+ when="last"
4441+ version="1.2"
4442+ deprecated="1"
4443+ deprecated-version="1.6">
4444+ <doc xml:space="preserve"
4445+ filename="src/adw-about-window.c"
4446+ line="1843">Emitted when a URL is activated.
4447+
4448+Applications may connect to it to override the default behavior, which is
4449+to call [func@Gtk.show_uri].</doc>
4450+ <doc-deprecated xml:space="preserve">Use [class@AboutDialog].</doc-deprecated>
47584451 <return-value transfer-ownership="none">
47594452 <doc xml:space="preserve"
4760- filename="src/adw-button-content.c"
4761- line="382">whether an underline in the text indicates a mnemonic</doc>
4453+ filename="src/adw-about-window.c"
4454+ line="1853">`TRUE` if the link has been activated</doc>
47624455 <type name="gboolean" c:type="gboolean"/>
47634456 </return-value>
47644457 <parameters>
4765- <instance-parameter name="self" transfer-ownership="none">
4458+ <parameter name="uri" transfer-ownership="none">
47664459 <doc xml:space="preserve"
4767- filename="src/adw-button-content.c"
4768- line="378">a button content</doc>
4769- <type name="ButtonContent" c:type="AdwButtonContent*"/>
4770- </instance-parameter>
4460+ filename="src/adw-about-window.c"
4461+ line="1846">the URI to activate</doc>
4462+ <type name="utf8" c:type="gchar*"/>
4463+ </parameter>
47714464 </parameters>
4772- </method>
4773- <method name="set_icon_name"
4774- c:identifier="adw_button_content_set_icon_name"
4775- glib:set-property="icon-name">
4776- <attribute name="org.gtk.Method.set_property" value="icon-name"/>
4465+ </glib:signal>
4466+ </class>
4467+ <record name="AboutWindowClass"
4468+ c:type="AdwAboutWindowClass"
4469+ glib:is-gtype-struct-for="AboutWindow">
4470+ <source-position filename="src/adw-about-window.h" line="23"/>
4471+ <field name="parent_class">
4472+ <type name="WindowClass" c:type="AdwWindowClass"/>
4473+ </field>
4474+ </record>
4475+ <enumeration name="AccentColor"
4476+ version="1.6"
4477+ glib:type-name="AdwAccentColor"
4478+ glib:get-type="adw_accent_color_get_type"
4479+ c:type="AdwAccentColor">
4480+ <doc xml:space="preserve"
4481+ filename="src/adw-accent-color.c"
4482+ line="14">Describes the available system accent colors.</doc>
4483+ <member name="blue"
4484+ value="0"
4485+ c:identifier="ADW_ACCENT_COLOR_BLUE"
4486+ glib:nick="blue"
4487+ glib:name="ADW_ACCENT_COLOR_BLUE">
47774488 <doc xml:space="preserve"
4778- filename="src/adw-button-content.c"
4779- line="305">Sets the name of the displayed icon.
4489+ filename="src/adw-accent-color.c"
4490+ line="16">Use a blue color (`#3584e4`). This is the default value.</doc>
4491+ </member>
4492+ <member name="teal"
4493+ value="1"
4494+ c:identifier="ADW_ACCENT_COLOR_TEAL"
4495+ glib:nick="teal"
4496+ glib:name="ADW_ACCENT_COLOR_TEAL">
4497+ <doc xml:space="preserve"
4498+ filename="src/adw-accent-color.c"
4499+ line="17">Use a teal color (`#2190a4`).</doc>
4500+ </member>
4501+ <member name="green"
4502+ value="2"
4503+ c:identifier="ADW_ACCENT_COLOR_GREEN"
4504+ glib:nick="green"
4505+ glib:name="ADW_ACCENT_COLOR_GREEN">
4506+ <doc xml:space="preserve"
4507+ filename="src/adw-accent-color.c"
4508+ line="18">Use a green color (`#3a944a`).</doc>
4509+ </member>
4510+ <member name="yellow"
4511+ value="3"
4512+ c:identifier="ADW_ACCENT_COLOR_YELLOW"
4513+ glib:nick="yellow"
4514+ glib:name="ADW_ACCENT_COLOR_YELLOW">
4515+ <doc xml:space="preserve"
4516+ filename="src/adw-accent-color.c"
4517+ line="19">Use a yellow color (`#c88800`).</doc>
4518+ </member>
4519+ <member name="orange"
4520+ value="4"
4521+ c:identifier="ADW_ACCENT_COLOR_ORANGE"
4522+ glib:nick="orange"
4523+ glib:name="ADW_ACCENT_COLOR_ORANGE">
4524+ <doc xml:space="preserve"
4525+ filename="src/adw-accent-color.c"
4526+ line="20">Use a orange color (`#ed5b00`).</doc>
4527+ </member>
4528+ <member name="red"
4529+ value="5"
4530+ c:identifier="ADW_ACCENT_COLOR_RED"
4531+ glib:nick="red"
4532+ glib:name="ADW_ACCENT_COLOR_RED">
4533+ <doc xml:space="preserve"
4534+ filename="src/adw-accent-color.c"
4535+ line="21">Use a red color (`#e62d42`).</doc>
4536+ </member>
4537+ <member name="pink"
4538+ value="6"
4539+ c:identifier="ADW_ACCENT_COLOR_PINK"
4540+ glib:nick="pink"
4541+ glib:name="ADW_ACCENT_COLOR_PINK">
4542+ <doc xml:space="preserve"
4543+ filename="src/adw-accent-color.c"
4544+ line="22">Use a pink color (`#d56199`).</doc>
4545+ </member>
4546+ <member name="purple"
4547+ value="7"
4548+ c:identifier="ADW_ACCENT_COLOR_PURPLE"
4549+ glib:nick="purple"
4550+ glib:name="ADW_ACCENT_COLOR_PURPLE">
4551+ <doc xml:space="preserve"
4552+ filename="src/adw-accent-color.c"
4553+ line="23">Use a purple color (`#9141ac`).</doc>
4554+ </member>
4555+ <member name="slate"
4556+ value="8"
4557+ c:identifier="ADW_ACCENT_COLOR_SLATE"
4558+ glib:nick="slate"
4559+ glib:name="ADW_ACCENT_COLOR_SLATE">
4560+ <doc xml:space="preserve"
4561+ filename="src/adw-accent-color.c"
4562+ line="24">Use a slate color (`#6f8396`).</doc>
4563+ </member>
4564+ <function name="to_rgba"
4565+ c:identifier="adw_accent_color_to_rgba"
4566+ version="1.6">
4567+ <doc xml:space="preserve"
4568+ filename="src/adw-accent-color.c"
4569+ line="31">Converts @self to a `GdkRGBA` representing its background color.
47804570
4781-If empty, the icon is not shown.</doc>
4782- <source-position filename="src/adw-button-content.h" line="38"/>
4571+The matching foreground color is white.</doc>
4572+ <source-position filename="src/adw-accent-color.h" line="32"/>
47834573 <return-value transfer-ownership="none">
47844574 <type name="none" c:type="void"/>
47854575 </return-value>
47864576 <parameters>
4787- <instance-parameter name="self" transfer-ownership="none">
4788- <doc xml:space="preserve"
4789- filename="src/adw-button-content.c"
4790- line="307">a button content</doc>
4791- <type name="ButtonContent" c:type="AdwButtonContent*"/>
4792- </instance-parameter>
4793- <parameter name="icon_name" transfer-ownership="none">
4577+ <parameter name="self" transfer-ownership="none">
47944578 <doc xml:space="preserve"
4795- filename="src/adw-button-content.c"
4796- line="308">the new icon name</doc>
4797- <type name="utf8" c:type="const char*"/>
4579+ filename="src/adw-accent-color.c"
4580+ line="33">an accent color</doc>
4581+ <type name="AccentColor" c:type="AdwAccentColor"/>
47984582 </parameter>
4799- </parameters>
4800- </method>
4801- <method name="set_label"
4802- c:identifier="adw_button_content_set_label"
4803- glib:set-property="label">
4804- <attribute name="org.gtk.Method.set_property" value="label"/>
4805- <doc xml:space="preserve"
4806- filename="src/adw-button-content.c"
4807- line="351">Sets the displayed label.</doc>
4808- <source-position filename="src/adw-button-content.h" line="32"/>
4809- <return-value transfer-ownership="none">
4810- <type name="none" c:type="void"/>
4811- </return-value>
4812- <parameters>
4813- <instance-parameter name="self" transfer-ownership="none">
4814- <doc xml:space="preserve"
4815- filename="src/adw-button-content.c"
4816- line="353">a button content</doc>
4817- <type name="ButtonContent" c:type="AdwButtonContent*"/>
4818- </instance-parameter>
4819- <parameter name="label" transfer-ownership="none">
4583+ <parameter name="rgba"
4584+ direction="out"
4585+ caller-allocates="1"
4586+ transfer-ownership="none">
48204587 <doc xml:space="preserve"
4821- filename="src/adw-button-content.c"
4822- line="354">the new label</doc>
4823- <type name="utf8" c:type="const char*"/>
4588+ filename="src/adw-accent-color.c"
4589+ line="34">return location for the color</doc>
4590+ <type name="Gdk.RGBA" c:type="GdkRGBA*"/>
48244591 </parameter>
48254592 </parameters>
4826- </method>
4827- <method name="set_use_underline"
4828- c:identifier="adw_button_content_set_use_underline"
4829- glib:set-property="use-underline">
4830- <attribute name="org.gtk.Method.set_property" value="use-underline"/>
4593+ </function>
4594+ <function name="to_standalone_rgba"
4595+ c:identifier="adw_accent_color_to_standalone_rgba"
4596+ version="1.6">
48314597 <doc xml:space="preserve"
4832- filename="src/adw-button-content.c"
4833- line="392">Sets whether an underline in the text indicates a mnemonic.
4834-
4835-The mnemonic can be used to activate the parent button.
4598+ filename="src/adw-accent-color.c"
4599+ line="88">Converts @self to a `GdkRGBA` representing its standalone color.
48364600
4837-See [property@ButtonContent:label].</doc>
4838- <source-position filename="src/adw-button-content.h" line="44"/>
4601+It will typically be darker for light background, and lighter for dark
4602+background, ensuring contrast.</doc>
4603+ <source-position filename="src/adw-accent-color.h" line="36"/>
48394604 <return-value transfer-ownership="none">
48404605 <type name="none" c:type="void"/>
48414606 </return-value>
48424607 <parameters>
4843- <instance-parameter name="self" transfer-ownership="none">
4608+ <parameter name="self" transfer-ownership="none">
48444609 <doc xml:space="preserve"
4845- filename="src/adw-button-content.c"
4846- line="394">a button content</doc>
4847- <type name="ButtonContent" c:type="AdwButtonContent*"/>
4848- </instance-parameter>
4849- <parameter name="use_underline" transfer-ownership="none">
4610+ filename="src/adw-accent-color.c"
4611+ line="90">an accent color</doc>
4612+ <type name="AccentColor" c:type="AdwAccentColor"/>
4613+ </parameter>
4614+ <parameter name="dark" transfer-ownership="none">
48504615 <doc xml:space="preserve"
4851- filename="src/adw-button-content.c"
4852- line="395">whether an underline in the text indicates a mnemonic</doc>
4616+ filename="src/adw-accent-color.c"
4617+ line="91">Whether to calculate standalone color for light or dark background</doc>
48534618 <type name="gboolean" c:type="gboolean"/>
48544619 </parameter>
4620+ <parameter name="rgba"
4621+ direction="out"
4622+ caller-allocates="1"
4623+ transfer-ownership="none">
4624+ <doc xml:space="preserve"
4625+ filename="src/adw-accent-color.c"
4626+ line="92">return location for the color</doc>
4627+ <type name="Gdk.RGBA" c:type="GdkRGBA*"/>
4628+ </parameter>
48554629 </parameters>
4856- </method>
4857- <property name="icon-name"
4858- writable="1"
4859- transfer-ownership="none"
4860- setter="set_icon_name"
4861- getter="get_icon_name">
4862- <attribute name="org.gtk.Property.get"
4863- value="adw_button_content_get_icon_name"/>
4864- <attribute name="org.gtk.Property.set"
4865- value="adw_button_content_set_icon_name"/>
4866- <doc xml:space="preserve"
4867- filename="src/adw-button-content.c"
4868- line="211">The name of the displayed icon.
4869-
4870-If empty, the icon is not shown.</doc>
4871- <type name="utf8" c:type="gchar*"/>
4872- </property>
4873- <property name="label"
4874- writable="1"
4875- transfer-ownership="none"
4876- setter="set_label"
4877- getter="get_label">
4878- <attribute name="org.gtk.Property.get"
4879- value="adw_button_content_get_label"/>
4880- <attribute name="org.gtk.Property.set"
4881- value="adw_button_content_set_label"/>
4882- <doc xml:space="preserve"
4883- filename="src/adw-button-content.c"
4884- line="223">The displayed label.</doc>
4885- <type name="utf8" c:type="gchar*"/>
4886- </property>
4887- <property name="use-underline"
4888- writable="1"
4889- transfer-ownership="none"
4890- setter="set_use_underline"
4891- getter="get_use_underline"
4892- default-value="FALSE">
4893- <attribute name="org.gtk.Property.get"
4894- value="adw_button_content_get_use_underline"/>
4895- <attribute name="org.gtk.Property.set"
4896- value="adw_button_content_set_use_underline"/>
4897- <doc xml:space="preserve"
4898- filename="src/adw-button-content.c"
4899- line="233">Whether an underline in the text indicates a mnemonic.
4900-
4901-The mnemonic can be used to activate the parent button.
4902-
4903-See [property@ButtonContent:label].</doc>
4904- <type name="gboolean" c:type="gboolean"/>
4905- </property>
4906- </class>
4907- <record name="ButtonContentClass"
4908- c:type="AdwButtonContentClass"
4909- glib:is-gtype-struct-for="ButtonContent">
4910- <source-position filename="src/adw-button-content.h" line="24"/>
4911- <field name="parent_class">
4912- <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
4913- </field>
4914- </record>
4915- <function-macro name="CHECK_VERSION"
4916- c:identifier="ADW_CHECK_VERSION"
4917- introspectable="0">
4918- <doc xml:space="preserve"
4919- filename="src/adw-version.h"
4920- line="65">Compile-time version checking. Evaluates to `TRUE` if the version
4921-of Adwaita is greater than the required one.</doc>
4922- <source-position filename="src/adw-version.h" line="73"/>
4923- <parameters>
4924- <parameter name="major">
4925- <doc xml:space="preserve"
4926- filename="src/adw-version.h"
4927- line="67">required major version</doc>
4928- </parameter>
4929- <parameter name="minor">
4930- <doc xml:space="preserve"
4931- filename="src/adw-version.h"
4932- line="68">required minor version</doc>
4933- </parameter>
4934- <parameter name="micro">
4935- <doc xml:space="preserve"
4936- filename="src/adw-version.h"
4937- line="69">required micro version</doc>
4938- </parameter>
4939- </parameters>
4940- </function-macro>
4941- <class name="CallbackAnimationTarget"
4942- c:symbol-prefix="callback_animation_target"
4943- c:type="AdwCallbackAnimationTarget"
4944- parent="AnimationTarget"
4945- final="1"
4946- glib:type-name="AdwCallbackAnimationTarget"
4947- glib:get-type="adw_callback_animation_target_get_type"
4948- glib:type-struct="CallbackAnimationTargetClass">
4949- <doc xml:space="preserve"
4950- filename="src/adw-animation-target.c"
4951- line="17">An [class@AnimationTarget] that calls a given callback during the
4952-animation.</doc>
4953- <source-position filename="src/adw-animation-target.h" line="38"/>
4954- <constructor name="new" c:identifier="adw_callback_animation_target_new">
4955- <doc xml:space="preserve"
4956- filename="src/adw-animation-target.c"
4957- line="119">Creates a new `AdwAnimationTarget` that calls the given @callback during
4958-the animation.</doc>
4959- <source-position filename="src/adw-animation-target.h" line="41"/>
4960- <return-value transfer-ownership="full">
4961- <doc xml:space="preserve"
4962- filename="src/adw-animation-target.c"
4963- line="129">the newly created callback target</doc>
4964- <type name="AnimationTarget" c:type="AdwAnimationTarget*"/>
4965- </return-value>
4966- <parameters>
4967- <parameter name="callback"
4968- transfer-ownership="none"
4969- scope="notified"
4970- closure="1"
4971- destroy="2">
4972- <doc xml:space="preserve"
4973- filename="src/adw-animation-target.c"
4974- line="121">the callback to call</doc>
4975- <type name="AnimationTargetFunc" c:type="AdwAnimationTargetFunc"/>
4976- </parameter>
4977- <parameter name="user_data"
4978- transfer-ownership="none"
4979- nullable="1"
4980- allow-none="1"
4981- scope="notified"
4982- closure="0">
4983- <doc xml:space="preserve"
4984- filename="src/adw-animation-target.c"
4985- line="122">the data to be passed to @callback</doc>
4986- <type name="gpointer" c:type="gpointer"/>
4987- </parameter>
4988- <parameter name="destroy"
4989- transfer-ownership="none"
4990- scope="async"
4991- destroy="1">
4992- <doc xml:space="preserve"
4993- filename="src/adw-animation-target.c"
4994- line="123">the function to be called when the
4995- callback action is finalized</doc>
4996- <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
4997- </parameter>
4998- </parameters>
4999- </constructor>
5000- </class>
5001- <record name="CallbackAnimationTargetClass"
5002- c:type="AdwCallbackAnimationTargetClass"
5003- disguised="1"
5004- opaque="1"
5005- glib:is-gtype-struct-for="CallbackAnimationTarget">
5006- <source-position filename="src/adw-animation-target.h" line="38"/>
5007- </record>
5008- <class name="Carousel"
5009- c:symbol-prefix="carousel"
5010- c:type="AdwCarousel"
5011- parent="Gtk.Widget"
5012- final="1"
5013- glib:type-name="AdwCarousel"
5014- glib:get-type="adw_carousel_get_type"
5015- glib:type-struct="CarouselClass">
4630+ </function>
4631+ </enumeration>
4632+ <class name="ActionRow"
4633+ c:symbol-prefix="action_row"
4634+ c:type="AdwActionRow"
4635+ parent="PreferencesRow"
4636+ glib:type-name="AdwActionRow"
4637+ glib:get-type="adw_action_row_get_type"
4638+ glib:type-struct="ActionRowClass">
50164639 <doc xml:space="preserve"
5017- filename="src/adw-carousel.c"
5018- line="24">A paginated scrolling widget.
4640+ filename="src/adw-action-row.c"
4641+ line="13">A [class@Gtk.ListBoxRow] used to present actions.
50194642
50204643 &lt;picture&gt;
5021- &lt;source srcset="carousel-dark.png" media="(prefers-color-scheme: dark)"&gt;
5022- &lt;img src="carousel.png" alt="carousel"&gt;
4644+ &lt;source srcset="action-row-dark.png" media="(prefers-color-scheme: dark)"&gt;
4645+ &lt;img src="action-row.png" alt="action-row"&gt;
50234646 &lt;/picture&gt;
50244647
5025-The `AdwCarousel` widget can be used to display a set of pages with
5026-swipe-based navigation between them.
4648+The `AdwActionRow` widget can have a title, a subtitle and an icon. The row
4649+can receive additional widgets at its end, or prefix widgets at its start.
50274650
5028-[class@CarouselIndicatorDots] and [class@CarouselIndicatorLines] can be used
5029-to provide page indicators for `AdwCarousel`.
4651+It is convenient to present a preference and its related actions.
4652+
4653+`AdwActionRow` is unactivatable by default, giving it an activatable widget
4654+will automatically make it activatable, but unsetting it won't change the
4655+row's activatability.
4656+
4657+## AdwActionRow as GtkBuildable
4658+
4659+The `AdwActionRow` implementation of the [iface@Gtk.Buildable] interface
4660+supports adding a child at its end by specifying “suffix” or omitting the
4661+“type” attribute of a &lt;child&gt; element.
4662+
4663+It also supports adding a child as a prefix widget by specifying “prefix” as
4664+the “type” attribute of a &lt;child&gt; element.
50304665
50314666 ## CSS nodes
50324667
5033-`AdwCarousel` has a single CSS node with name `carousel`.</doc>
5034- <source-position filename="src/adw-carousel.h" line="24"/>
5035- <implements name="Swipeable"/>
4668+`AdwActionRow` has a main CSS node with name `row`.
4669+
4670+It contains the subnode `box.header` for its main horizontal box, and
4671+`box.title` for the vertical box containing the title and subtitle labels.
4672+
4673+It contains subnodes `label.title` and `label.subtitle` representing
4674+respectively the title label and subtitle label.
4675+
4676+## Style classes
4677+
4678+`AdwActionRow` can use the [`.property`](style-classes.html#property-rows)
4679+style class to emphasize the row subtitle instead of the row title, which is
4680+useful for displaying read-only properties.
4681+
4682+&lt;picture&gt;
4683+ &lt;source srcset="property-row-dark.png" media="(prefers-color-scheme: dark)"&gt;
4684+ &lt;img src="property-row.png" alt="property-row"&gt;
4685+&lt;/picture&gt;
4686+
4687+When used together with the `.monospace` style class, only the subtitle
4688+becomes monospace, not the title or any extra widgets.</doc>
4689+ <source-position filename="src/adw-action-row.h" line="37"/>
50364690 <implements name="Gtk.Accessible"/>
4691+ <implements name="Gtk.Actionable"/>
50374692 <implements name="Gtk.Buildable"/>
50384693 <implements name="Gtk.ConstraintTarget"/>
5039- <implements name="Gtk.Orientable"/>
5040- <constructor name="new" c:identifier="adw_carousel_new">
4694+ <constructor name="new" c:identifier="adw_action_row_new">
50414695 <doc xml:space="preserve"
5042- filename="src/adw-carousel.c"
5043- line="1151">Creates a new `AdwCarousel`.</doc>
5044- <source-position filename="src/adw-carousel.h" line="27"/>
4696+ filename="src/adw-action-row.c"
4697+ line="445">Creates a new `AdwActionRow`.</doc>
4698+ <source-position filename="src/adw-action-row.h" line="40"/>
50454699 <return-value transfer-ownership="none">
50464700 <doc xml:space="preserve"
5047- filename="src/adw-carousel.c"
5048- line="1156">the newly created `AdwCarousel`</doc>
4701+ filename="src/adw-action-row.c"
4702+ line="450">the newly created `AdwActionRow`</doc>
50494703 <type name="Gtk.Widget" c:type="GtkWidget*"/>
50504704 </return-value>
50514705 </constructor>
5052- <method name="append" c:identifier="adw_carousel_append">
4706+ <virtual-method name="activate" invoker="activate">
50534707 <doc xml:space="preserve"
5054- filename="src/adw-carousel.c"
5055- line="1181">Appends @child to @self.</doc>
5056- <source-position filename="src/adw-carousel.h" line="33"/>
4708+ filename="src/adw-action-row.c"
4709+ line="885">Activates @self.</doc>
4710+ <source-position filename="src/adw-action-row.h" line="33"/>
50574711 <return-value transfer-ownership="none">
50584712 <type name="none" c:type="void"/>
50594713 </return-value>
50604714 <parameters>
50614715 <instance-parameter name="self" transfer-ownership="none">
50624716 <doc xml:space="preserve"
5063- filename="src/adw-carousel.c"
5064- line="1183">a carousel</doc>
5065- <type name="Carousel" c:type="AdwCarousel*"/>
4717+ filename="src/adw-action-row.c"
4718+ line="887">an action row</doc>
4719+ <type name="ActionRow" c:type="AdwActionRow*"/>
50664720 </instance-parameter>
5067- <parameter name="child" transfer-ownership="none">
5068- <doc xml:space="preserve"
5069- filename="src/adw-carousel.c"
5070- line="1184">a widget to add</doc>
5071- <type name="Gtk.Widget" c:type="GtkWidget*"/>
5072- </parameter>
50734721 </parameters>
5074- </method>
5075- <method name="get_allow_long_swipes"
5076- c:identifier="adw_carousel_get_allow_long_swipes"
5077- glib:get-property="allow-long-swipes">
5078- <attribute name="org.gtk.Method.get_property"
5079- value="allow-long-swipes"/>
4722+ </virtual-method>
4723+ <method name="activate" c:identifier="adw_action_row_activate">
50804724 <doc xml:space="preserve"
5081- filename="src/adw-carousel.c"
5082- line="1717">Gets whether to allow swiping for more than one page at a time.</doc>
5083- <source-position filename="src/adw-carousel.h" line="93"/>
4725+ filename="src/adw-action-row.c"
4726+ line="885">Activates @self.</doc>
4727+ <source-position filename="src/adw-action-row.h" line="90"/>
50844728 <return-value transfer-ownership="none">
5085- <doc xml:space="preserve"
5086- filename="src/adw-carousel.c"
5087- line="1723">`TRUE` if long swipes are allowed</doc>
5088- <type name="gboolean" c:type="gboolean"/>
4729+ <type name="none" c:type="void"/>
50894730 </return-value>
50904731 <parameters>
50914732 <instance-parameter name="self" transfer-ownership="none">
50924733 <doc xml:space="preserve"
5093- filename="src/adw-carousel.c"
5094- line="1719">a carousel</doc>
5095- <type name="Carousel" c:type="AdwCarousel*"/>
4734+ filename="src/adw-action-row.c"
4735+ line="887">an action row</doc>
4736+ <type name="ActionRow" c:type="AdwActionRow*"/>
50964737 </instance-parameter>
50974738 </parameters>
50984739 </method>
5099- <method name="get_allow_mouse_drag"
5100- c:identifier="adw_carousel_get_allow_mouse_drag"
5101- glib:get-property="allow-mouse-drag">
5102- <attribute name="org.gtk.Method.get_property"
5103- value="allow-mouse-drag"/>
4740+ <method name="add_prefix" c:identifier="adw_action_row_add_prefix">
51044741 <doc xml:space="preserve"
5105- filename="src/adw-carousel.c"
5106- line="1635">Sets whether @self can be dragged with mouse pointer.</doc>
5107- <source-position filename="src/adw-carousel.h" line="81"/>
4742+ filename="src/adw-action-row.c"
4743+ line="458">Adds a prefix widget to @self.</doc>
4744+ <source-position filename="src/adw-action-row.h" line="43"/>
51084745 <return-value transfer-ownership="none">
5109- <doc xml:space="preserve"
5110- filename="src/adw-carousel.c"
5111- line="1641">whether @self can be dragged with mouse pointer</doc>
5112- <type name="gboolean" c:type="gboolean"/>
4746+ <type name="none" c:type="void"/>
51134747 </return-value>
51144748 <parameters>
51154749 <instance-parameter name="self" transfer-ownership="none">
51164750 <doc xml:space="preserve"
5117- filename="src/adw-carousel.c"
5118- line="1637">a carousel</doc>
5119- <type name="Carousel" c:type="AdwCarousel*"/>
4751+ filename="src/adw-action-row.c"
4752+ line="460">an action row</doc>
4753+ <type name="ActionRow" c:type="AdwActionRow*"/>
51204754 </instance-parameter>
4755+ <parameter name="widget" transfer-ownership="none">
4756+ <doc xml:space="preserve"
4757+ filename="src/adw-action-row.c"
4758+ line="461">a widget</doc>
4759+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
4760+ </parameter>
51214761 </parameters>
51224762 </method>
5123- <method name="get_allow_scroll_wheel"
5124- c:identifier="adw_carousel_get_allow_scroll_wheel"
5125- glib:get-property="allow-scroll-wheel">
5126- <attribute name="org.gtk.Method.get_property"
5127- value="allow-scroll-wheel"/>
4763+ <method name="add_suffix" c:identifier="adw_action_row_add_suffix">
51284764 <doc xml:space="preserve"
5129- filename="src/adw-carousel.c"
5130- line="1676">Gets whether @self will respond to scroll wheel events.</doc>
5131- <source-position filename="src/adw-carousel.h" line="87"/>
4765+ filename="src/adw-action-row.c"
4766+ line="481">Adds a suffix widget to @self.</doc>
4767+ <source-position filename="src/adw-action-row.h" line="46"/>
51324768 <return-value transfer-ownership="none">
5133- <doc xml:space="preserve"
5134- filename="src/adw-carousel.c"
5135- line="1682">`TRUE` if @self will respond to scroll wheel events</doc>
5136- <type name="gboolean" c:type="gboolean"/>
4769+ <type name="none" c:type="void"/>
51374770 </return-value>
51384771 <parameters>
51394772 <instance-parameter name="self" transfer-ownership="none">
51404773 <doc xml:space="preserve"
5141- filename="src/adw-carousel.c"
5142- line="1678">a carousel</doc>
5143- <type name="Carousel" c:type="AdwCarousel*"/>
4774+ filename="src/adw-action-row.c"
4775+ line="483">an action row</doc>
4776+ <type name="ActionRow" c:type="AdwActionRow*"/>
51444777 </instance-parameter>
4778+ <parameter name="widget" transfer-ownership="none">
4779+ <doc xml:space="preserve"
4780+ filename="src/adw-action-row.c"
4781+ line="484">a widget</doc>
4782+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
4783+ </parameter>
51454784 </parameters>
51464785 </method>
5147- <method name="get_interactive"
5148- c:identifier="adw_carousel_get_interactive"
5149- glib:get-property="interactive">
5150- <attribute name="org.gtk.Method.get_property" value="interactive"/>
4786+ <method name="get_activatable_widget"
4787+ c:identifier="adw_action_row_get_activatable_widget"
4788+ glib:get-property="activatable-widget">
51514789 <doc xml:space="preserve"
5152- filename="src/adw-carousel.c"
5153- line="1511">Gets whether @self can be navigated.</doc>
5154- <source-position filename="src/adw-carousel.h" line="63"/>
5155- <return-value transfer-ownership="none">
4790+ filename="src/adw-action-row.c"
4791+ line="633">Gets the widget activated when @self is activated.</doc>
4792+ <source-position filename="src/adw-action-row.h" line="65"/>
4793+ <return-value transfer-ownership="none" nullable="1">
51564794 <doc xml:space="preserve"
5157- filename="src/adw-carousel.c"
5158- line="1517">whether @self can be navigated</doc>
5159- <type name="gboolean" c:type="gboolean"/>
4795+ filename="src/adw-action-row.c"
4796+ line="639">the activatable widget for @self</doc>
4797+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
51604798 </return-value>
51614799 <parameters>
51624800 <instance-parameter name="self" transfer-ownership="none">
51634801 <doc xml:space="preserve"
5164- filename="src/adw-carousel.c"
5165- line="1513">a carousel</doc>
5166- <type name="Carousel" c:type="AdwCarousel*"/>
4802+ filename="src/adw-action-row.c"
4803+ line="635">an action row</doc>
4804+ <type name="ActionRow" c:type="AdwActionRow*"/>
51674805 </instance-parameter>
51684806 </parameters>
51694807 </method>
5170- <method name="get_n_pages"
5171- c:identifier="adw_carousel_get_n_pages"
5172- glib:get-property="n-pages">
5173- <attribute name="org.gtk.Method.get_property" value="n-pages"/>
4808+ <method name="get_icon_name"
4809+ c:identifier="adw_action_row_get_icon_name"
4810+ glib:get-property="icon-name"
4811+ deprecated="1"
4812+ deprecated-version="1.3">
51744813 <doc xml:space="preserve"
5175- filename="src/adw-carousel.c"
5176- line="1466">Gets the number of pages in @self.</doc>
5177- <source-position filename="src/adw-carousel.h" line="58"/>
5178- <return-value transfer-ownership="none">
4814+ filename="src/adw-action-row.c"
4815+ line="582">Gets the icon name for @self.</doc>
4816+ <doc-deprecated xml:space="preserve">Use [method@ActionRow.add_prefix] to add an icon.</doc-deprecated>
4817+ <source-position filename="src/adw-action-row.h" line="59"/>
4818+ <return-value transfer-ownership="none" nullable="1">
51794819 <doc xml:space="preserve"
5180- filename="src/adw-carousel.c"
5181- line="1472">the number of pages in @self</doc>
5182- <type name="guint" c:type="guint"/>
4820+ filename="src/adw-action-row.c"
4821+ line="588">the icon name for @self</doc>
4822+ <type name="utf8" c:type="const char*"/>
51834823 </return-value>
51844824 <parameters>
51854825 <instance-parameter name="self" transfer-ownership="none">
51864826 <doc xml:space="preserve"
5187- filename="src/adw-carousel.c"
5188- line="1468">a carousel</doc>
5189- <type name="Carousel" c:type="AdwCarousel*"/>
4827+ filename="src/adw-action-row.c"
4828+ line="584">an action row</doc>
4829+ <type name="ActionRow" c:type="AdwActionRow*"/>
51904830 </instance-parameter>
51914831 </parameters>
51924832 </method>
5193- <method name="get_nth_page" c:identifier="adw_carousel_get_nth_page">
4833+ <method name="get_subtitle"
4834+ c:identifier="adw_action_row_get_subtitle"
4835+ glib:get-property="subtitle">
51944836 <doc xml:space="preserve"
5195- filename="src/adw-carousel.c"
5196- line="1443">Gets the page at position @n.</doc>
5197- <source-position filename="src/adw-carousel.h" line="55"/>
5198- <return-value transfer-ownership="none">
4837+ filename="src/adw-action-row.c"
4838+ line="534">Gets the subtitle for @self.</doc>
4839+ <source-position filename="src/adw-action-row.h" line="53"/>
4840+ <return-value transfer-ownership="none" nullable="1">
51994841 <doc xml:space="preserve"
5200- filename="src/adw-carousel.c"
5201- line="1450">the page</doc>
5202- <type name="Gtk.Widget" c:type="GtkWidget*"/>
4842+ filename="src/adw-action-row.c"
4843+ line="540">the subtitle for @self</doc>
4844+ <type name="utf8" c:type="const char*"/>
52034845 </return-value>
52044846 <parameters>
52054847 <instance-parameter name="self" transfer-ownership="none">
52064848 <doc xml:space="preserve"
5207- filename="src/adw-carousel.c"
5208- line="1445">a carousel</doc>
5209- <type name="Carousel" c:type="AdwCarousel*"/>
4849+ filename="src/adw-action-row.c"
4850+ line="536">an action row</doc>
4851+ <type name="ActionRow" c:type="AdwActionRow*"/>
52104852 </instance-parameter>
5211- <parameter name="n" transfer-ownership="none">
5212- <doc xml:space="preserve"
5213- filename="src/adw-carousel.c"
5214- line="1446">index of the page</doc>
5215- <type name="guint" c:type="guint"/>
5216- </parameter>
52174853 </parameters>
52184854 </method>
5219- <method name="get_position"
5220- c:identifier="adw_carousel_get_position"
5221- glib:get-property="position">
5222- <attribute name="org.gtk.Method.get_property" value="position"/>
4855+ <method name="get_subtitle_lines"
4856+ c:identifier="adw_action_row_get_subtitle_lines"
4857+ glib:get-property="subtitle-lines">
52234858 <doc xml:space="preserve"
5224- filename="src/adw-carousel.c"
5225- line="1493">Gets current scroll position in @self, unitless.
5226-
5227-1 matches 1 page. Use [method@Carousel.scroll_to] for changing it.</doc>
5228- <source-position filename="src/adw-carousel.h" line="60"/>
4859+ filename="src/adw-action-row.c"
4860+ line="782">Gets the number of lines at the end of which the subtitle label will be
4861+ellipsized.</doc>
4862+ <source-position filename="src/adw-action-row.h" line="77"/>
52294863 <return-value transfer-ownership="none">
52304864 <doc xml:space="preserve"
5231- filename="src/adw-carousel.c"
5232- line="1501">the scroll position</doc>
5233- <type name="gdouble" c:type="double"/>
4865+ filename="src/adw-action-row.c"
4866+ line="789">the number of lines at the end of which the subtitle label will be
4867+ ellipsized</doc>
4868+ <type name="gint" c:type="int"/>
52344869 </return-value>
52354870 <parameters>
52364871 <instance-parameter name="self" transfer-ownership="none">
52374872 <doc xml:space="preserve"
5238- filename="src/adw-carousel.c"
5239- line="1495">a carousel</doc>
5240- <type name="Carousel" c:type="AdwCarousel*"/>
4873+ filename="src/adw-action-row.c"
4874+ line="784">an action row</doc>
4875+ <type name="ActionRow" c:type="AdwActionRow*"/>
52414876 </instance-parameter>
52424877 </parameters>
52434878 </method>
5244- <method name="get_reveal_duration"
5245- c:identifier="adw_carousel_get_reveal_duration"
5246- glib:get-property="reveal-duration">
5247- <attribute name="org.gtk.Method.get_property" value="reveal-duration"/>
4879+ <method name="get_subtitle_selectable"
4880+ c:identifier="adw_action_row_get_subtitle_selectable"
4881+ glib:get-property="subtitle-selectable"
4882+ version="1.3">
52484883 <doc xml:space="preserve"
5249- filename="src/adw-carousel.c"
5250- line="1759">Gets the page reveal duration, in milliseconds.</doc>
5251- <source-position filename="src/adw-carousel.h" line="99"/>
4884+ filename="src/adw-action-row.c"
4885+ line="836">Gets whether the user can copy the subtitle from the label</doc>
4886+ <source-position filename="src/adw-action-row.h" line="83"/>
52524887 <return-value transfer-ownership="none">
52534888 <doc xml:space="preserve"
5254- filename="src/adw-carousel.c"
5255- line="1765">the duration</doc>
5256- <type name="guint" c:type="guint"/>
4889+ filename="src/adw-action-row.c"
4890+ line="842">whether the user can copy the subtitle from the label</doc>
4891+ <type name="gboolean" c:type="gboolean"/>
52574892 </return-value>
52584893 <parameters>
52594894 <instance-parameter name="self" transfer-ownership="none">
52604895 <doc xml:space="preserve"
5261- filename="src/adw-carousel.c"
5262- line="1761">a carousel</doc>
5263- <type name="Carousel" c:type="AdwCarousel*"/>
4896+ filename="src/adw-action-row.c"
4897+ line="838">an action row</doc>
4898+ <type name="ActionRow" c:type="AdwActionRow*"/>
52644899 </instance-parameter>
52654900 </parameters>
52664901 </method>
5267- <method name="get_scroll_params"
5268- c:identifier="adw_carousel_get_scroll_params"
5269- glib:get-property="scroll-params">
5270- <attribute name="org.gtk.Method.get_property" value="scroll-params"/>
4902+ <method name="get_title_lines"
4903+ c:identifier="adw_action_row_get_title_lines"
4904+ glib:get-property="title-lines">
52714905 <doc xml:space="preserve"
5272- filename="src/adw-carousel.c"
5273- line="1591">Gets the scroll animation spring parameters for @self.</doc>
5274- <source-position filename="src/adw-carousel.h" line="75"/>
5275- <return-value transfer-ownership="full">
4906+ filename="src/adw-action-row.c"
4907+ line="728">Gets the number of lines at the end of which the title label will be
4908+ellipsized.</doc>
4909+ <source-position filename="src/adw-action-row.h" line="71"/>
4910+ <return-value transfer-ownership="none">
52764911 <doc xml:space="preserve"
5277- filename="src/adw-carousel.c"
5278- line="1597">the animation parameters</doc>
5279- <type name="SpringParams" c:type="AdwSpringParams*"/>
4912+ filename="src/adw-action-row.c"
4913+ line="735">the number of lines at the end of which the title label will be
4914+ ellipsized</doc>
4915+ <type name="gint" c:type="int"/>
52804916 </return-value>
52814917 <parameters>
52824918 <instance-parameter name="self" transfer-ownership="none">
52834919 <doc xml:space="preserve"
5284- filename="src/adw-carousel.c"
5285- line="1593">a carousel</doc>
5286- <type name="Carousel" c:type="AdwCarousel*"/>
4920+ filename="src/adw-action-row.c"
4921+ line="730">an action row</doc>
4922+ <type name="ActionRow" c:type="AdwActionRow*"/>
52874923 </instance-parameter>
52884924 </parameters>
52894925 </method>
5290- <method name="get_spacing"
5291- c:identifier="adw_carousel_get_spacing"
5292- glib:get-property="spacing">
5293- <attribute name="org.gtk.Method.get_property" value="spacing"/>
4926+ <method name="remove" c:identifier="adw_action_row_remove">
52944927 <doc xml:space="preserve"
5295- filename="src/adw-carousel.c"
5296- line="1553">Gets spacing between pages in pixels.</doc>
5297- <source-position filename="src/adw-carousel.h" line="69"/>
4928+ filename="src/adw-action-row.c"
4929+ line="504">Removes a child from @self.</doc>
4930+ <source-position filename="src/adw-action-row.h" line="49"/>
52984931 <return-value transfer-ownership="none">
5299- <doc xml:space="preserve"
5300- filename="src/adw-carousel.c"
5301- line="1559">spacing between pages</doc>
5302- <type name="guint" c:type="guint"/>
4932+ <type name="none" c:type="void"/>
53034933 </return-value>
53044934 <parameters>
53054935 <instance-parameter name="self" transfer-ownership="none">
53064936 <doc xml:space="preserve"
5307- filename="src/adw-carousel.c"
5308- line="1555">a carousel</doc>
5309- <type name="Carousel" c:type="AdwCarousel*"/>
4937+ filename="src/adw-action-row.c"
4938+ line="506">an action row</doc>
4939+ <type name="ActionRow" c:type="AdwActionRow*"/>
53104940 </instance-parameter>
4941+ <parameter name="widget" transfer-ownership="none">
4942+ <doc xml:space="preserve"
4943+ filename="src/adw-action-row.c"
4944+ line="507">the child to be removed</doc>
4945+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
4946+ </parameter>
53114947 </parameters>
53124948 </method>
5313- <method name="insert" c:identifier="adw_carousel_insert">
4949+ <method name="set_activatable_widget"
4950+ c:identifier="adw_action_row_set_activatable_widget"
4951+ glib:set-property="activatable-widget">
53144952 <doc xml:space="preserve"
5315- filename="src/adw-carousel.c"
5316- line="1198">Inserts @child into @self at position @position.
4953+ filename="src/adw-action-row.c"
4954+ line="666">Sets the widget to activate when @self is activated.
53174955
5318-If position is -1, or larger than the number of pages,
5319-@child will be appended to the end.</doc>
5320- <source-position filename="src/adw-carousel.h" line="36"/>
4956+The row can be activated either by clicking on it, calling
4957+[method@ActionRow.activate], or via mnemonics in the title.
4958+See the [property@PreferencesRow:use-underline] property to enable mnemonics.
4959+
4960+The target widget will be activated by emitting the
4961+[signal@Gtk.Widget::mnemonic-activate] signal on it.</doc>
4962+ <source-position filename="src/adw-action-row.h" line="67"/>
53214963 <return-value transfer-ownership="none">
53224964 <type name="none" c:type="void"/>
53234965 </return-value>
53244966 <parameters>
53254967 <instance-parameter name="self" transfer-ownership="none">
53264968 <doc xml:space="preserve"
5327- filename="src/adw-carousel.c"
5328- line="1200">a carousel</doc>
5329- <type name="Carousel" c:type="AdwCarousel*"/>
4969+ filename="src/adw-action-row.c"
4970+ line="668">an action row</doc>
4971+ <type name="ActionRow" c:type="AdwActionRow*"/>
53304972 </instance-parameter>
5331- <parameter name="child" transfer-ownership="none">
4973+ <parameter name="widget"
4974+ transfer-ownership="none"
4975+ nullable="1"
4976+ allow-none="1">
53324977 <doc xml:space="preserve"
5333- filename="src/adw-carousel.c"
5334- line="1201">a widget to add</doc>
4978+ filename="src/adw-action-row.c"
4979+ line="669">the target widget</doc>
53354980 <type name="Gtk.Widget" c:type="GtkWidget*"/>
53364981 </parameter>
5337- <parameter name="position" transfer-ownership="none">
5338- <doc xml:space="preserve"
5339- filename="src/adw-carousel.c"
5340- line="1202">the position to insert @child at</doc>
5341- <type name="gint" c:type="int"/>
5342- </parameter>
53434982 </parameters>
53444983 </method>
5345- <method name="prepend" c:identifier="adw_carousel_prepend">
4984+ <method name="set_icon_name"
4985+ c:identifier="adw_action_row_set_icon_name"
4986+ glib:set-property="icon-name"
4987+ deprecated="1"
4988+ deprecated-version="1.3">
53464989 <doc xml:space="preserve"
5347- filename="src/adw-carousel.c"
5348- line="1164">Prepends @child to @self.</doc>
5349- <source-position filename="src/adw-carousel.h" line="30"/>
4990+ filename="src/adw-action-row.c"
4991+ line="604">Sets the icon name for @self.</doc>
4992+ <doc-deprecated xml:space="preserve">Use [method@ActionRow.add_prefix] to add an icon.</doc-deprecated>
4993+ <source-position filename="src/adw-action-row.h" line="61"/>
53504994 <return-value transfer-ownership="none">
53514995 <type name="none" c:type="void"/>
53524996 </return-value>
53534997 <parameters>
53544998 <instance-parameter name="self" transfer-ownership="none">
53554999 <doc xml:space="preserve"
5356- filename="src/adw-carousel.c"
5357- line="1166">a carousel</doc>
5358- <type name="Carousel" c:type="AdwCarousel*"/>
5000+ filename="src/adw-action-row.c"
5001+ line="606">an action row</doc>
5002+ <type name="ActionRow" c:type="AdwActionRow*"/>
53595003 </instance-parameter>
5360- <parameter name="child" transfer-ownership="none">
5004+ <parameter name="icon_name"
5005+ transfer-ownership="none"
5006+ nullable="1"
5007+ allow-none="1">
53615008 <doc xml:space="preserve"
5362- filename="src/adw-carousel.c"
5363- line="1167">a widget to add</doc>
5364- <type name="Gtk.Widget" c:type="GtkWidget*"/>
5009+ filename="src/adw-action-row.c"
5010+ line="607">the icon name</doc>
5011+ <type name="utf8" c:type="const char*"/>
53655012 </parameter>
53665013 </parameters>
53675014 </method>
5368- <method name="remove" c:identifier="adw_carousel_remove">
5015+ <method name="set_subtitle"
5016+ c:identifier="adw_action_row_set_subtitle"
5017+ glib:set-property="subtitle">
53695018 <doc xml:space="preserve"
5370- filename="src/adw-carousel.c"
5371- line="1338">Removes @child from @self.</doc>
5372- <source-position filename="src/adw-carousel.h" line="46"/>
5019+ filename="src/adw-action-row.c"
5020+ line="554">Sets the subtitle for @self.
5021+
5022+The subtitle is interpreted as Pango markup unless
5023+[property@PreferencesRow:use-markup] is set to `FALSE`.</doc>
5024+ <source-position filename="src/adw-action-row.h" line="55"/>
53735025 <return-value transfer-ownership="none">
53745026 <type name="none" c:type="void"/>
53755027 </return-value>
53765028 <parameters>
53775029 <instance-parameter name="self" transfer-ownership="none">
53785030 <doc xml:space="preserve"
5379- filename="src/adw-carousel.c"
5380- line="1340">a carousel</doc>
5381- <type name="Carousel" c:type="AdwCarousel*"/>
5031+ filename="src/adw-action-row.c"
5032+ line="556">an action row</doc>
5033+ <type name="ActionRow" c:type="AdwActionRow*"/>
53825034 </instance-parameter>
5383- <parameter name="child" transfer-ownership="none">
5035+ <parameter name="subtitle" transfer-ownership="none">
53845036 <doc xml:space="preserve"
5385- filename="src/adw-carousel.c"
5386- line="1341">a widget to remove</doc>
5387- <type name="Gtk.Widget" c:type="GtkWidget*"/>
5037+ filename="src/adw-action-row.c"
5038+ line="557">the subtitle</doc>
5039+ <type name="utf8" c:type="const char*"/>
53885040 </parameter>
53895041 </parameters>
53905042 </method>
5391- <method name="reorder" c:identifier="adw_carousel_reorder">
5043+ <method name="set_subtitle_lines"
5044+ c:identifier="adw_action_row_set_subtitle_lines"
5045+ glib:set-property="subtitle-lines">
53925046 <doc xml:space="preserve"
5393- filename="src/adw-carousel.c"
5394- line="1246">Moves @child into position @position.
5047+ filename="src/adw-action-row.c"
5048+ line="804">Sets the number of lines at the end of which the subtitle label will be
5049+ellipsized.
53955050
5396-If position is -1, or larger than the number of pages, @child will be moved
5397-at the end.</doc>
5398- <source-position filename="src/adw-carousel.h" line="41"/>
5051+If the value is 0, the number of lines won't be limited.</doc>
5052+ <source-position filename="src/adw-action-row.h" line="79"/>
53995053 <return-value transfer-ownership="none">
54005054 <type name="none" c:type="void"/>
54015055 </return-value>
54025056 <parameters>
54035057 <instance-parameter name="self" transfer-ownership="none">
54045058 <doc xml:space="preserve"
5405- filename="src/adw-carousel.c"
5406- line="1248">a carousel</doc>
5407- <type name="Carousel" c:type="AdwCarousel*"/>
5059+ filename="src/adw-action-row.c"
5060+ line="806">an action row</doc>
5061+ <type name="ActionRow" c:type="AdwActionRow*"/>
54085062 </instance-parameter>
5409- <parameter name="child" transfer-ownership="none">
5410- <doc xml:space="preserve"
5411- filename="src/adw-carousel.c"
5412- line="1249">a widget to add</doc>
5413- <type name="Gtk.Widget" c:type="GtkWidget*"/>
5414- </parameter>
5415- <parameter name="position" transfer-ownership="none">
5063+ <parameter name="subtitle_lines" transfer-ownership="none">
54165064 <doc xml:space="preserve"
5417- filename="src/adw-carousel.c"
5418- line="1250">the position to move @child to</doc>
5065+ filename="src/adw-action-row.c"
5066+ line="807">the number of lines at the end of which the subtitle label will be ellipsized</doc>
54195067 <type name="gint" c:type="int"/>
54205068 </parameter>
54215069 </parameters>
54225070 </method>
5423- <method name="scroll_to" c:identifier="adw_carousel_scroll_to">
5071+ <method name="set_subtitle_selectable"
5072+ c:identifier="adw_action_row_set_subtitle_selectable"
5073+ glib:set-property="subtitle-selectable"
5074+ version="1.3">
54245075 <doc xml:space="preserve"
5425- filename="src/adw-carousel.c"
5426- line="1400">Scrolls to @widget.
5076+ filename="src/adw-action-row.c"
5077+ line="856">Sets whether the user can copy the subtitle from the label
54275078
5428-If @animate is `TRUE`, the transition will be animated.</doc>
5429- <source-position filename="src/adw-carousel.h" line="50"/>
5079+See also [property@Gtk.Label:selectable].</doc>
5080+ <source-position filename="src/adw-action-row.h" line="86"/>
54305081 <return-value transfer-ownership="none">
54315082 <type name="none" c:type="void"/>
54325083 </return-value>
54335084 <parameters>
54345085 <instance-parameter name="self" transfer-ownership="none">
54355086 <doc xml:space="preserve"
5436- filename="src/adw-carousel.c"
5437- line="1402">a carousel</doc>
5438- <type name="Carousel" c:type="AdwCarousel*"/>
5087+ filename="src/adw-action-row.c"
5088+ line="858">an action row</doc>
5089+ <type name="ActionRow" c:type="AdwActionRow*"/>
54395090 </instance-parameter>
5440- <parameter name="widget" transfer-ownership="none">
5441- <doc xml:space="preserve"
5442- filename="src/adw-carousel.c"
5443- line="1403">a child of @self</doc>
5444- <type name="Gtk.Widget" c:type="GtkWidget*"/>
5445- </parameter>
5446- <parameter name="animate" transfer-ownership="none">
5091+ <parameter name="subtitle_selectable" transfer-ownership="none">
54475092 <doc xml:space="preserve"
5448- filename="src/adw-carousel.c"
5449- line="1404">whether to animate the transition</doc>
5093+ filename="src/adw-action-row.c"
5094+ line="859">`TRUE` if the user can copy the subtitle from the label</doc>
54505095 <type name="gboolean" c:type="gboolean"/>
54515096 </parameter>
54525097 </parameters>
54535098 </method>
5454- <method name="set_allow_long_swipes"
5455- c:identifier="adw_carousel_set_allow_long_swipes"
5456- glib:set-property="allow-long-swipes">
5457- <attribute name="org.gtk.Method.set_property"
5458- value="allow-long-swipes"/>
5099+ <method name="set_title_lines"
5100+ c:identifier="adw_action_row_set_title_lines"
5101+ glib:set-property="title-lines">
54595102 <doc xml:space="preserve"
5460- filename="src/adw-carousel.c"
5461- line="1733">Sets whether to allow swiping for more than one page at a time.
5103+ filename="src/adw-action-row.c"
5104+ line="750">Sets the number of lines at the end of which the title label will be
5105+ellipsized.
54625106
5463-If @allow_long_swipes is `FALSE`, each swipe can only move to the adjacent
5464-pages.</doc>
5465- <source-position filename="src/adw-carousel.h" line="95"/>
5107+If the value is 0, the number of lines won't be limited.</doc>
5108+ <source-position filename="src/adw-action-row.h" line="73"/>
54665109 <return-value transfer-ownership="none">
54675110 <type name="none" c:type="void"/>
54685111 </return-value>
54695112 <parameters>
54705113 <instance-parameter name="self" transfer-ownership="none">
54715114 <doc xml:space="preserve"
5472- filename="src/adw-carousel.c"
5473- line="1735">a carousel</doc>
5474- <type name="Carousel" c:type="AdwCarousel*"/>
5115+ filename="src/adw-action-row.c"
5116+ line="752">an action row</doc>
5117+ <type name="ActionRow" c:type="AdwActionRow*"/>
54755118 </instance-parameter>
5476- <parameter name="allow_long_swipes" transfer-ownership="none">
5119+ <parameter name="title_lines" transfer-ownership="none">
54775120 <doc xml:space="preserve"
5478- filename="src/adw-carousel.c"
5479- line="1736">whether to allow long swipes</doc>
5480- <type name="gboolean" c:type="gboolean"/>
5121+ filename="src/adw-action-row.c"
5122+ line="753">the number of lines at the end of which the title label will be ellipsized</doc>
5123+ <type name="gint" c:type="int"/>
54815124 </parameter>
54825125 </parameters>
54835126 </method>
5484- <method name="set_allow_mouse_drag"
5485- c:identifier="adw_carousel_set_allow_mouse_drag"
5486- glib:set-property="allow-mouse-drag">
5487- <attribute name="org.gtk.Method.set_property"
5488- value="allow-mouse-drag"/>
5127+ <property name="activatable-widget"
5128+ writable="1"
5129+ transfer-ownership="none"
5130+ setter="set_activatable_widget"
5131+ getter="get_activatable_widget">
54895132 <doc xml:space="preserve"
5490- filename="src/adw-carousel.c"
5491- line="1651">Sets whether @self can be dragged with mouse pointer.
5133+ filename="src/adw-action-row.c"
5134+ line="317">The widget to activate when the row is activated.
54925135
5493-If @allow_mouse_drag is `FALSE`, dragging is only available on touch.</doc>
5494- <source-position filename="src/adw-carousel.h" line="83"/>
5495- <return-value transfer-ownership="none">
5496- <type name="none" c:type="void"/>
5497- </return-value>
5498- <parameters>
5499- <instance-parameter name="self" transfer-ownership="none">
5500- <doc xml:space="preserve"
5501- filename="src/adw-carousel.c"
5502- line="1653">a carousel</doc>
5503- <type name="Carousel" c:type="AdwCarousel*"/>
5504- </instance-parameter>
5505- <parameter name="allow_mouse_drag" transfer-ownership="none">
5506- <doc xml:space="preserve"
5507- filename="src/adw-carousel.c"
5508- line="1654">whether @self can be dragged with mouse pointer</doc>
5509- <type name="gboolean" c:type="gboolean"/>
5510- </parameter>
5511- </parameters>
5512- </method>
5513- <method name="set_allow_scroll_wheel"
5514- c:identifier="adw_carousel_set_allow_scroll_wheel"
5515- glib:set-property="allow-scroll-wheel">
5516- <attribute name="org.gtk.Method.set_property"
5517- value="allow-scroll-wheel"/>
5518- <doc xml:space="preserve"
5519- filename="src/adw-carousel.c"
5520- line="1692">Sets whether @self will respond to scroll wheel events.
5136+The row can be activated either by clicking on it, calling
5137+[method@ActionRow.activate], or via mnemonics in the title.
5138+See the [property@PreferencesRow:use-underline] property to enable
5139+mnemonics.
55215140
5522-If @allow_scroll_wheel is `FALSE`, wheel events will be ignored.</doc>
5523- <source-position filename="src/adw-carousel.h" line="89"/>
5524- <return-value transfer-ownership="none">
5525- <type name="none" c:type="void"/>
5526- </return-value>
5527- <parameters>
5528- <instance-parameter name="self" transfer-ownership="none">
5529- <doc xml:space="preserve"
5530- filename="src/adw-carousel.c"
5531- line="1694">a carousel</doc>
5532- <type name="Carousel" c:type="AdwCarousel*"/>
5533- </instance-parameter>
5534- <parameter name="allow_scroll_wheel" transfer-ownership="none">
5535- <doc xml:space="preserve"
5536- filename="src/adw-carousel.c"
5537- line="1695">whether @self will respond to scroll wheel events</doc>
5538- <type name="gboolean" c:type="gboolean"/>
5539- </parameter>
5540- </parameters>
5541- </method>
5542- <method name="set_interactive"
5543- c:identifier="adw_carousel_set_interactive"
5544- glib:set-property="interactive">
5545- <attribute name="org.gtk.Method.set_property" value="interactive"/>
5141+The target widget will be activated by emitting the
5142+[signal@Gtk.Widget::mnemonic-activate] signal on it.</doc>
5143+ <type name="Gtk.Widget"/>
5144+ </property>
5145+ <property name="icon-name"
5146+ deprecated="1"
5147+ deprecated-version="1.3"
5148+ writable="1"
5149+ transfer-ownership="none"
5150+ setter="set_icon_name"
5151+ getter="get_icon_name">
55465152 <doc xml:space="preserve"
5547- filename="src/adw-carousel.c"
5548- line="1527">Sets whether @self can be navigated.
5549-
5550-This can be used to temporarily disable the carousel to only allow navigating
5551-it in a certain state.</doc>
5552- <source-position filename="src/adw-carousel.h" line="65"/>
5553- <return-value transfer-ownership="none">
5554- <type name="none" c:type="void"/>
5555- </return-value>
5556- <parameters>
5557- <instance-parameter name="self" transfer-ownership="none">
5558- <doc xml:space="preserve"
5559- filename="src/adw-carousel.c"
5560- line="1529">a carousel</doc>
5561- <type name="Carousel" c:type="AdwCarousel*"/>
5562- </instance-parameter>
5563- <parameter name="interactive" transfer-ownership="none">
5564- <doc xml:space="preserve"
5565- filename="src/adw-carousel.c"
5566- line="1530">whether @self can be navigated</doc>
5567- <type name="gboolean" c:type="gboolean"/>
5568- </parameter>
5569- </parameters>
5570- </method>
5571- <method name="set_reveal_duration"
5572- c:identifier="adw_carousel_set_reveal_duration"
5573- glib:set-property="reveal-duration">
5574- <attribute name="org.gtk.Method.set_property" value="reveal-duration"/>
5153+ filename="src/adw-action-row.c"
5154+ line="305">The icon name for this row.</doc>
5155+ <doc-deprecated xml:space="preserve">Use [method@ActionRow.add_prefix] to add an icon.</doc-deprecated>
5156+ <type name="utf8" c:type="gchar*"/>
5157+ </property>
5158+ <property name="subtitle"
5159+ writable="1"
5160+ transfer-ownership="none"
5161+ setter="set_subtitle"
5162+ getter="get_subtitle">
55755163 <doc xml:space="preserve"
5576- filename="src/adw-carousel.c"
5577- line="1775">Sets the page reveal duration, in milliseconds.
5164+ filename="src/adw-action-row.c"
5165+ line="292">The subtitle for this row.
55785166
5579-Reveal duration is used when animating adding or removing pages.</doc>
5580- <source-position filename="src/adw-carousel.h" line="101"/>
5581- <return-value transfer-ownership="none">
5582- <type name="none" c:type="void"/>
5583- </return-value>
5584- <parameters>
5585- <instance-parameter name="self" transfer-ownership="none">
5586- <doc xml:space="preserve"
5587- filename="src/adw-carousel.c"
5588- line="1777">a carousel</doc>
5589- <type name="Carousel" c:type="AdwCarousel*"/>
5590- </instance-parameter>
5591- <parameter name="reveal_duration" transfer-ownership="none">
5592- <doc xml:space="preserve"
5593- filename="src/adw-carousel.c"
5594- line="1778">the new reveal duration value</doc>
5595- <type name="guint" c:type="guint"/>
5596- </parameter>
5597- </parameters>
5598- </method>
5599- <method name="set_scroll_params"
5600- c:identifier="adw_carousel_set_scroll_params"
5601- glib:set-property="scroll-params">
5602- <attribute name="org.gtk.Method.set_property" value="scroll-params"/>
5167+The subtitle is interpreted as Pango markup unless
5168+[property@PreferencesRow:use-markup] is set to `FALSE`.</doc>
5169+ <type name="utf8" c:type="gchar*"/>
5170+ </property>
5171+ <property name="subtitle-lines"
5172+ writable="1"
5173+ transfer-ownership="none"
5174+ setter="set_subtitle_lines"
5175+ getter="get_subtitle_lines"
5176+ default-value="0">
56035177 <doc xml:space="preserve"
5604- filename="src/adw-carousel.c"
5605- line="1607">Sets the scroll animation spring parameters for @self.
5606-
5607-The default value is equivalent to:
5178+ filename="src/adw-action-row.c"
5179+ line="348">The number of lines at the end of which the subtitle label will be
5180+ellipsized.
56085181
5609-```c
5610-adw_spring_params_new (1, 0.5, 500)
5611-```</doc>
5612- <source-position filename="src/adw-carousel.h" line="77"/>
5613- <return-value transfer-ownership="none">
5614- <type name="none" c:type="void"/>
5615- </return-value>
5616- <parameters>
5617- <instance-parameter name="self" transfer-ownership="none">
5618- <doc xml:space="preserve"
5619- filename="src/adw-carousel.c"
5620- line="1609">a carousel</doc>
5621- <type name="Carousel" c:type="AdwCarousel*"/>
5622- </instance-parameter>
5623- <parameter name="params" transfer-ownership="none">
5624- <doc xml:space="preserve"
5625- filename="src/adw-carousel.c"
5626- line="1610">the new parameters</doc>
5627- <type name="SpringParams" c:type="AdwSpringParams*"/>
5628- </parameter>
5629- </parameters>
5630- </method>
5631- <method name="set_spacing"
5632- c:identifier="adw_carousel_set_spacing"
5633- glib:set-property="spacing">
5634- <attribute name="org.gtk.Method.set_property" value="spacing"/>
5635- <doc xml:space="preserve"
5636- filename="src/adw-carousel.c"
5637- line="1569">Sets spacing between pages in pixels.</doc>
5638- <source-position filename="src/adw-carousel.h" line="71"/>
5639- <return-value transfer-ownership="none">
5640- <type name="none" c:type="void"/>
5641- </return-value>
5642- <parameters>
5643- <instance-parameter name="self" transfer-ownership="none">
5644- <doc xml:space="preserve"
5645- filename="src/adw-carousel.c"
5646- line="1571">a carousel</doc>
5647- <type name="Carousel" c:type="AdwCarousel*"/>
5648- </instance-parameter>
5649- <parameter name="spacing" transfer-ownership="none">
5650- <doc xml:space="preserve"
5651- filename="src/adw-carousel.c"
5652- line="1572">the new spacing value</doc>
5653- <type name="guint" c:type="guint"/>
5654- </parameter>
5655- </parameters>
5656- </method>
5657- <property name="allow-long-swipes"
5182+If the value is 0, the number of lines won't be limited.</doc>
5183+ <type name="gint" c:type="gint"/>
5184+ </property>
5185+ <property name="subtitle-selectable"
5186+ version="1.3"
56585187 writable="1"
56595188 transfer-ownership="none"
5660- setter="set_allow_long_swipes"
5661- getter="get_allow_long_swipes"
5189+ setter="set_subtitle_selectable"
5190+ getter="get_subtitle_selectable"
56625191 default-value="FALSE">
5663- <attribute name="org.gtk.Property.get"
5664- value="adw_carousel_get_allow_long_swipes"/>
5665- <attribute name="org.gtk.Property.set"
5666- value="adw_carousel_set_allow_long_swipes"/>
56675192 <doc xml:space="preserve"
5668- filename="src/adw-carousel.c"
5669- line="975">Whether to allow swiping for more than one page at a time.
5193+ filename="src/adw-action-row.c"
5194+ line="362">Whether the user can copy the subtitle from the label.
56705195
5671-If the value is `FALSE`, each swipe can only move to the adjacent pages.</doc>
5196+See also [property@Gtk.Label:selectable].</doc>
56725197 <type name="gboolean" c:type="gboolean"/>
56735198 </property>
5674- <property name="allow-mouse-drag"
5199+ <property name="title-lines"
56755200 writable="1"
56765201 transfer-ownership="none"
5677- setter="set_allow_mouse_drag"
5678- getter="get_allow_mouse_drag"
5679- default-value="TRUE">
5680- <attribute name="org.gtk.Property.get"
5681- value="adw_carousel_get_allow_mouse_drag"/>
5682- <attribute name="org.gtk.Property.set"
5683- value="adw_carousel_set_allow_mouse_drag"/>
5684- <doc xml:space="preserve"
5685- filename="src/adw-carousel.c"
5686- line="951">Sets whether the `AdwCarousel` can be dragged with mouse pointer.
5687-
5688-If the value is `FALSE`, dragging is only available on touch.</doc>
5689- <type name="gboolean" c:type="gboolean"/>
5690- </property>
5691- <property name="allow-scroll-wheel"
5692- writable="1"
5693- transfer-ownership="none"
5694- setter="set_allow_scroll_wheel"
5695- getter="get_allow_scroll_wheel"
5696- default-value="TRUE">
5697- <attribute name="org.gtk.Property.get"
5698- value="adw_carousel_get_allow_scroll_wheel"/>
5699- <attribute name="org.gtk.Property.set"
5700- value="adw_carousel_set_allow_scroll_wheel"/>
5701- <doc xml:space="preserve"
5702- filename="src/adw-carousel.c"
5703- line="963">Whether the widget will respond to scroll wheel events.
5704-
5705-If the value is `FALSE`, wheel events will be ignored.</doc>
5706- <type name="gboolean" c:type="gboolean"/>
5707- </property>
5708- <property name="interactive"
5709- writable="1"
5710- transfer-ownership="none"
5711- setter="set_interactive"
5712- getter="get_interactive"
5713- default-value="TRUE">
5714- <attribute name="org.gtk.Property.get"
5715- value="adw_carousel_get_interactive"/>
5716- <attribute name="org.gtk.Property.set"
5717- value="adw_carousel_set_interactive"/>
5718- <doc xml:space="preserve"
5719- filename="src/adw-carousel.c"
5720- line="910">Whether the carousel can be navigated.
5721-
5722-This can be used to temporarily disable the carousel to only allow
5723-navigating it in a certain state.</doc>
5724- <type name="gboolean" c:type="gboolean"/>
5725- </property>
5726- <property name="n-pages"
5727- transfer-ownership="none"
5728- getter="get_n_pages"
5729- default-value="0">
5730- <attribute name="org.gtk.Property.get"
5731- value="adw_carousel_get_n_pages"/>
5732- <doc xml:space="preserve"
5733- filename="src/adw-carousel.c"
5734- line="884">The number of pages in a `AdwCarousel`.</doc>
5735- <type name="guint" c:type="guint"/>
5736- </property>
5737- <property name="position"
5738- transfer-ownership="none"
5739- getter="get_position"
5740- default-value="0.000000">
5741- <attribute name="org.gtk.Property.get"
5742- value="adw_carousel_get_position"/>
5743- <doc xml:space="preserve"
5744- filename="src/adw-carousel.c"
5745- line="896">Current scrolling position, unitless.
5746-
5747-1 matches 1 page. Use [method@Carousel.scroll_to] for changing it.</doc>
5748- <type name="gdouble" c:type="gdouble"/>
5749- </property>
5750- <property name="reveal-duration"
5751- writable="1"
5752- transfer-ownership="none"
5753- setter="set_reveal_duration"
5754- getter="get_reveal_duration"
5202+ setter="set_title_lines"
5203+ getter="get_title_lines"
57555204 default-value="0">
57565205 <doc xml:space="preserve"
5757- filename="src/adw-carousel.c"
5758- line="987">Page reveal duration, in milliseconds.
5759-
5760-Reveal duration is used when animating adding or removing pages.</doc>
5761- <type name="guint" c:type="guint"/>
5762- </property>
5763- <property name="scroll-params"
5764- writable="1"
5765- transfer-ownership="none"
5766- setter="set_scroll_params"
5767- getter="get_scroll_params">
5768- <attribute name="org.gtk.Property.get"
5769- value="adw_carousel_get_scroll_params"/>
5770- <attribute name="org.gtk.Property.set"
5771- value="adw_carousel_set_scroll_params"/>
5772- <doc xml:space="preserve"
5773- filename="src/adw-carousel.c"
5774- line="935">Scroll animation spring parameters.
5775-
5776-The default value is equivalent to:
5206+ filename="src/adw-action-row.c"
5207+ line="335">The number of lines at the end of which the title label will be ellipsized.
57775208
5778-```c
5779-adw_spring_params_new (1, 0.5, 500)
5780-```</doc>
5781- <type name="SpringParams"/>
5782- </property>
5783- <property name="spacing"
5784- writable="1"
5785- transfer-ownership="none"
5786- setter="set_spacing"
5787- getter="get_spacing"
5788- default-value="0">
5789- <attribute name="org.gtk.Property.get"
5790- value="adw_carousel_get_spacing"/>
5791- <attribute name="org.gtk.Property.set"
5792- value="adw_carousel_set_spacing"/>
5793- <doc xml:space="preserve"
5794- filename="src/adw-carousel.c"
5795- line="923">Spacing between pages in pixels.</doc>
5796- <type name="guint" c:type="guint"/>
5209+If the value is 0, the number of lines won't be limited.</doc>
5210+ <type name="gint" c:type="gint"/>
57975211 </property>
5798- <glib:signal name="page-changed" when="last">
5212+ <field name="parent_instance">
5213+ <type name="PreferencesRow" c:type="AdwPreferencesRow"/>
5214+ </field>
5215+ <glib:signal name="activated" when="last">
57995216 <doc xml:space="preserve"
5800- filename="src/adw-carousel.c"
5801- line="1007">This signal is emitted after a page has been changed.
5802-
5803-It can be used to implement "infinite scrolling" by amending the pages
5804-after every scroll. Note that an empty carousel is indicated by
5805-`(int)index == -1`.</doc>
5217+ filename="src/adw-action-row.c"
5218+ line="378">This signal is emitted after the row has been activated.</doc>
58065219 <return-value transfer-ownership="none">
58075220 <type name="none" c:type="void"/>
58085221 </return-value>
5809- <parameters>
5810- <parameter name="index" transfer-ownership="none">
5811- <doc xml:space="preserve"
5812- filename="src/adw-carousel.c"
5813- line="1010">current page</doc>
5814- <type name="guint" c:type="guint"/>
5815- </parameter>
5816- </parameters>
58175222 </glib:signal>
58185223 </class>
5819- <record name="CarouselClass"
5820- c:type="AdwCarouselClass"
5821- glib:is-gtype-struct-for="Carousel">
5822- <source-position filename="src/adw-carousel.h" line="24"/>
5224+ <record name="ActionRowClass"
5225+ c:type="AdwActionRowClass"
5226+ glib:is-gtype-struct-for="ActionRow">
5227+ <source-position filename="src/adw-action-row.h" line="37"/>
58235228 <field name="parent_class">
5824- <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
5229+ <doc xml:space="preserve"
5230+ filename="src/adw-action-row.h"
5231+ line="26">The parent class</doc>
5232+ <type name="PreferencesRowClass" c:type="AdwPreferencesRowClass"/>
5233+ </field>
5234+ <field name="activate">
5235+ <doc xml:space="preserve"
5236+ filename="src/adw-action-row.h"
5237+ line="27">Activates the row to trigger its main action.</doc>
5238+ <callback name="activate">
5239+ <source-position filename="src/adw-action-row.h" line="33"/>
5240+ <return-value transfer-ownership="none">
5241+ <type name="none" c:type="void"/>
5242+ </return-value>
5243+ <parameters>
5244+ <parameter name="self" transfer-ownership="none">
5245+ <doc xml:space="preserve"
5246+ filename="src/adw-action-row.c"
5247+ line="887">an action row</doc>
5248+ <type name="ActionRow" c:type="AdwActionRow*"/>
5249+ </parameter>
5250+ </parameters>
5251+ </callback>
5252+ </field>
5253+ <field name="padding" readable="0" private="1">
5254+ <array zero-terminated="0" fixed-size="4">
5255+ <type name="gpointer" c:type="gpointer"/>
5256+ </array>
58255257 </field>
58265258 </record>
5827- <class name="CarouselIndicatorDots"
5828- c:symbol-prefix="carousel_indicator_dots"
5829- c:type="AdwCarouselIndicatorDots"
5830- parent="Gtk.Widget"
5831- final="1"
5832- glib:type-name="AdwCarouselIndicatorDots"
5833- glib:get-type="adw_carousel_indicator_dots_get_type"
5834- glib:type-struct="CarouselIndicatorDotsClass">
5259+ <class name="AlertDialog"
5260+ c:symbol-prefix="alert_dialog"
5261+ c:type="AdwAlertDialog"
5262+ version="1.5"
5263+ parent="Dialog"
5264+ glib:type-name="AdwAlertDialog"
5265+ glib:get-type="adw_alert_dialog_get_type"
5266+ glib:type-struct="AlertDialogClass">
58355267 <doc xml:space="preserve"
5836- filename="src/adw-carousel-indicator-dots.c"
5837- line="24">A dots indicator for [class@Carousel].
5268+ filename="src/adw-alert-dialog.c"
5269+ line="22">A dialog presenting a message or a question.
58385270
58395271 &lt;picture&gt;
5840- &lt;source srcset="carousel-indicator-dots-dark.png" media="(prefers-color-scheme: dark)"&gt;
5841- &lt;img src="carousel-indicator-dots.png" alt="carousel-indicator-dots"&gt;
5272+ &lt;source srcset="alert-dialog-dark.png" media="(prefers-color-scheme: dark)"&gt;
5273+ &lt;img src="alert-dialog.png" alt="alert-dialog"&gt;
58425274 &lt;/picture&gt;
58435275
5844-The `AdwCarouselIndicatorDots` widget shows a set of dots for each page of a
5845-given [class@Carousel]. The dot representing the carousel's active page is
5846-larger and more opaque than the others, the transition to the active and
5847-inactive state is gradual to match the carousel's position.
5276+Alert dialogs have a heading, a body, an optional child widget, and one or
5277+multiple responses, each presented as a button.
58485278
5849-See also [class@CarouselIndicatorLines].
5279+Each response has a unique string ID, and a button label. Additionally, each
5280+response can be enabled or disabled, and can have a suggested or destructive
5281+appearance.
58505282
5851-## CSS nodes
5283+When one of the responses is activated, or the dialog is closed, the
5284+[signal@AlertDialog::response] signal will be emitted. This signal is
5285+detailed, and the detail, as well as the `response` parameter will be set to
5286+the ID of the activated response, or to the value of the
5287+[property@AlertDialog:close-response] property if the dialog had been closed
5288+without activating any of the responses.
58525289
5853-`AdwCarouselIndicatorDots` has a single CSS node with name
5854-`carouselindicatordots`.</doc>
5855- <source-position filename="src/adw-carousel-indicator-dots.h" line="23"/>
5290+Response buttons can be presented horizontally or vertically depending on
5291+available space.
5292+
5293+When a response is activated, `AdwAlertDialog` is closed automatically.
5294+
5295+An example of using an alert dialog:
5296+
5297+```c
5298+AdwDialog *dialog;
5299+
5300+dialog = adw_alert_dialog_new (_("Replace File?"), NULL);
5301+
5302+adw_alert_dialog_format_body (ADW_ALERT_DIALOG (dialog),
5303+ _("A file named “%s” already exists. Do you want to replace it?"),
5304+ filename);
5305+
5306+adw_alert_dialog_add_responses (ADW_ALERT_DIALOG (dialog),
5307+ "cancel", _("_Cancel"),
5308+ "replace", _("_Replace"),
5309+ NULL);
5310+
5311+adw_alert_dialog_set_response_appearance (ADW_ALERT_DIALOG (dialog),
5312+ "replace",
5313+ ADW_RESPONSE_DESTRUCTIVE);
5314+
5315+adw_alert_dialog_set_default_response (ADW_ALERT_DIALOG (dialog), "cancel");
5316+adw_alert_dialog_set_close_response (ADW_ALERT_DIALOG (dialog), "cancel");
5317+
5318+g_signal_connect (dialog, "response", G_CALLBACK (response_cb), self);
5319+
5320+adw_dialog_present (dialog, parent);
5321+```
5322+
5323+## Async API
5324+
5325+`AdwAlertDialog` can also be used via the [method@AlertDialog.choose] method.
5326+This API follows the GIO async pattern, for example:
5327+
5328+```c
5329+static void
5330+dialog_cb (AdwAlertDialog *dialog,
5331+ GAsyncResult *result,
5332+ MyWindow *self)
5333+{
5334+ const char *response = adw_alert_dialog_choose_finish (dialog, result);
5335+
5336+ // ...
5337+}
5338+
5339+static void
5340+show_dialog (MyWindow *self)
5341+{
5342+ AdwDialog *dialog;
5343+
5344+ dialog = adw_alert_dialog_new (_("Replace File?"), NULL);
5345+
5346+ adw_alert_dialog_format_body (ADW_ALERT_DIALOG (dialog),
5347+ _("A file named “%s” already exists. Do you want to replace it?"),
5348+ filename);
5349+
5350+ adw_alert_dialog_add_responses (ADW_ALERT_DIALOG (dialog),
5351+ "cancel", _("_Cancel"),
5352+ "replace", _("_Replace"),
5353+ NULL);
5354+
5355+ adw_alert_dialog_set_response_appearance (ADW_ALERT_DIALOG (dialog),
5356+ "replace",
5357+ ADW_RESPONSE_DESTRUCTIVE);
5358+
5359+ adw_alert_dialog_set_default_response (ADW_ALERT_DIALOG (dialog), "cancel");
5360+ adw_alert_dialog_set_close_response (ADW_ALERT_DIALOG (dialog), "cancel");
5361+
5362+ adw_alert_dialog_choose (ADW_ALERT_DIALOG (dialog), GTK_WIDGET (self),
5363+ NULL, (GAsyncReadyCallback) dialog_cb, self);
5364+}
5365+```
5366+
5367+## AdwAlertDialog as GtkBuildable
5368+
5369+`AdwAlertDialog` supports adding responses in UI definitions by via the
5370+`&lt;responses&gt;` element that may contain multiple `&lt;response&gt;` elements, each
5371+representing a response.
5372+
5373+Each of the `&lt;response&gt;` elements must have the `id` attribute specifying the
5374+response ID. The contents of the element are used as the response label.
5375+
5376+Response labels can be translated with the usual `translatable`, `context`
5377+and `comments` attributes.
5378+
5379+The `&lt;response&gt;` elements can also have `enabled` and/or `appearance`
5380+attributes. See [method@AlertDialog.set_response_enabled] and
5381+[method@AlertDialog.set_response_appearance] for details.
5382+
5383+Example of an `AdwAlertDialog` UI definition:
5384+
5385+```xml
5386+&lt;object class="AdwAlertDialog" id="dialog"&gt;
5387+ &lt;property name="heading" translatable="yes"&gt;Save Changes?&lt;/property&gt;
5388+ &lt;property name="body" translatable="yes"&gt;Open documents contain unsaved changes. Changes which are not saved will be permanently lost.&lt;/property&gt;
5389+ &lt;property name="default-response"&gt;save&lt;/property&gt;
5390+ &lt;property name="close-response"&gt;cancel&lt;/property&gt;
5391+ &lt;signal name="response" handler="response_cb"/&gt;
5392+ &lt;responses&gt;
5393+ &lt;response id="cancel" translatable="yes"&gt;_Cancel&lt;/response&gt;
5394+ &lt;response id="discard" translatable="yes" appearance="destructive"&gt;_Discard&lt;/response&gt;
5395+ &lt;response id="save" translatable="yes" appearance="suggested" enabled="false"&gt;_Save&lt;/response&gt;
5396+ &lt;/responses&gt;
5397+&lt;/object&gt;
5398+```</doc>
5399+ <source-position filename="src/adw-alert-dialog.h" line="45"/>
58565400 <implements name="Gtk.Accessible"/>
58575401 <implements name="Gtk.Buildable"/>
58585402 <implements name="Gtk.ConstraintTarget"/>
5859- <implements name="Gtk.Orientable"/>
5860- <constructor name="new" c:identifier="adw_carousel_indicator_dots_new">
5403+ <constructor name="new"
5404+ c:identifier="adw_alert_dialog_new"
5405+ version="1.5">
58615406 <doc xml:space="preserve"
5862- filename="src/adw-carousel-indicator-dots.c"
5863- line="364">Creates a new `AdwCarouselIndicatorDots`.</doc>
5864- <source-position filename="src/adw-carousel-indicator-dots.h"
5865- line="26"/>
5407+ filename="src/adw-alert-dialog.c"
5408+ line="1339">Creates a new `AdwAlertDialog`.
5409+
5410+@heading and @body can be set to `NULL`. This can be useful if they need to
5411+be formatted or use markup. In that case, set them to `NULL` and call
5412+[method@AlertDialog.format_body] or similar methods afterwards:
5413+
5414+```c
5415+AdwDialog *dialog;
5416+
5417+dialog = adw_alert_dialog_new (_("Replace File?"), NULL);
5418+adw_alert_dialog_format_body (ADW_ALERT_DIALOG (dialog),
5419+ _("A file named “%s” already exists. Do you want to replace it?"),
5420+ filename);
5421+```</doc>
5422+ <source-position filename="src/adw-alert-dialog.h" line="48"/>
58665423 <return-value transfer-ownership="none">
58675424 <doc xml:space="preserve"
5868- filename="src/adw-carousel-indicator-dots.c"
5869- line="369">the newly created `AdwCarouselIndicatorDots`</doc>
5870- <type name="Gtk.Widget" c:type="GtkWidget*"/>
5425+ filename="src/adw-alert-dialog.c"
5426+ line="1359">the newly created `AdwAlertDialog`</doc>
5427+ <type name="Dialog" c:type="AdwDialog*"/>
58715428 </return-value>
5872- </constructor>
5873- <method name="get_carousel"
5874- c:identifier="adw_carousel_indicator_dots_get_carousel"
5875- glib:get-property="carousel">
5876- <attribute name="org.gtk.Method.get_property" value="carousel"/>
5877- <doc xml:space="preserve"
5878- filename="src/adw-carousel-indicator-dots.c"
5879- line="377">Gets the displayed carousel.</doc>
5880- <source-position filename="src/adw-carousel-indicator-dots.h"
5881- line="29"/>
5882- <return-value transfer-ownership="none" nullable="1">
5883- <doc xml:space="preserve"
5884- filename="src/adw-carousel-indicator-dots.c"
5885- line="383">the displayed carousel</doc>
5886- <type name="Carousel" c:type="AdwCarousel*"/>
5429+ <parameters>
5430+ <parameter name="heading"
5431+ transfer-ownership="none"
5432+ nullable="1"
5433+ allow-none="1">
5434+ <doc xml:space="preserve"
5435+ filename="src/adw-alert-dialog.c"
5436+ line="1341">the heading</doc>
5437+ <type name="utf8" c:type="const char*"/>
5438+ </parameter>
5439+ <parameter name="body"
5440+ transfer-ownership="none"
5441+ nullable="1"
5442+ allow-none="1">
5443+ <doc xml:space="preserve"
5444+ filename="src/adw-alert-dialog.c"
5445+ line="1342">the body text</doc>
5446+ <type name="utf8" c:type="const char*"/>
5447+ </parameter>
5448+ </parameters>
5449+ </constructor>
5450+ <virtual-method name="response">
5451+ <source-position filename="src/adw-alert-dialog.h" line="40"/>
5452+ <return-value transfer-ownership="none">
5453+ <type name="none" c:type="void"/>
58875454 </return-value>
58885455 <parameters>
58895456 <instance-parameter name="self" transfer-ownership="none">
5890- <doc xml:space="preserve"
5891- filename="src/adw-carousel-indicator-dots.c"
5892- line="379">an indicator</doc>
5893- <type name="CarouselIndicatorDots"
5894- c:type="AdwCarouselIndicatorDots*"/>
5457+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
58955458 </instance-parameter>
5459+ <parameter name="response" transfer-ownership="none">
5460+ <type name="utf8" c:type="const char*"/>
5461+ </parameter>
58965462 </parameters>
5897- </method>
5898- <method name="set_carousel"
5899- c:identifier="adw_carousel_indicator_dots_set_carousel"
5900- glib:set-property="carousel">
5901- <attribute name="org.gtk.Method.set_property" value="carousel"/>
5463+ </virtual-method>
5464+ <method name="add_response"
5465+ c:identifier="adw_alert_dialog_add_response"
5466+ version="1.5">
59025467 <doc xml:space="preserve"
5903- filename="src/adw-carousel-indicator-dots.c"
5904- line="393">Sets the displayed carousel.</doc>
5905- <source-position filename="src/adw-carousel-indicator-dots.h"
5906- line="31"/>
5468+ filename="src/adw-alert-dialog.c"
5469+ line="1907">Adds a response with @id and @label to @self.
5470+
5471+Responses are represented as buttons in the dialog.
5472+
5473+Response ID must be unique. It will be used in [signal@AlertDialog::response]
5474+to tell which response had been activated, as well as to inspect and modify
5475+the response later.
5476+
5477+An embedded underline in @label indicates a mnemonic.
5478+
5479+[method@AlertDialog.set_response_label] can be used to change the response
5480+label after it had been added.
5481+
5482+[method@AlertDialog.set_response_enabled] and
5483+[method@AlertDialog.set_response_appearance] can be used to customize the
5484+responses further.</doc>
5485+ <source-position filename="src/adw-alert-dialog.h" line="108"/>
59075486 <return-value transfer-ownership="none">
59085487 <type name="none" c:type="void"/>
59095488 </return-value>
59105489 <parameters>
59115490 <instance-parameter name="self" transfer-ownership="none">
59125491 <doc xml:space="preserve"
5913- filename="src/adw-carousel-indicator-dots.c"
5914- line="395">an indicator</doc>
5915- <type name="CarouselIndicatorDots"
5916- c:type="AdwCarouselIndicatorDots*"/>
5492+ filename="src/adw-alert-dialog.c"
5493+ line="1909">an alert dialog</doc>
5494+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
59175495 </instance-parameter>
5918- <parameter name="carousel"
5919- transfer-ownership="none"
5920- nullable="1"
5921- allow-none="1">
5496+ <parameter name="id" transfer-ownership="none">
59225497 <doc xml:space="preserve"
5923- filename="src/adw-carousel-indicator-dots.c"
5924- line="396">a carousel</doc>
5925- <type name="Carousel" c:type="AdwCarousel*"/>
5498+ filename="src/adw-alert-dialog.c"
5499+ line="1910">the response ID</doc>
5500+ <type name="utf8" c:type="const char*"/>
5501+ </parameter>
5502+ <parameter name="label" transfer-ownership="none">
5503+ <doc xml:space="preserve"
5504+ filename="src/adw-alert-dialog.c"
5505+ line="1911">the response label</doc>
5506+ <type name="utf8" c:type="const char*"/>
59265507 </parameter>
59275508 </parameters>
59285509 </method>
5929- <property name="carousel"
5930- writable="1"
5931- transfer-ownership="none"
5932- setter="set_carousel"
5933- getter="get_carousel">
5934- <attribute name="org.gtk.Property.get"
5935- value="adw_carousel_indicator_dots_get_carousel"/>
5936- <attribute name="org.gtk.Property.set"
5937- value="adw_carousel_indicator_dots_set_carousel"/>
5510+ <method name="add_responses"
5511+ c:identifier="adw_alert_dialog_add_responses"
5512+ version="1.5"
5513+ introspectable="0">
59385514 <doc xml:space="preserve"
5939- filename="src/adw-carousel-indicator-dots.c"
5940- line="334">The displayed carousel.</doc>
5941- <type name="Carousel"/>
5942- </property>
5943- </class>
5944- <record name="CarouselIndicatorDotsClass"
5945- c:type="AdwCarouselIndicatorDotsClass"
5946- glib:is-gtype-struct-for="CarouselIndicatorDots">
5947- <source-position filename="src/adw-carousel-indicator-dots.h" line="23"/>
5948- <field name="parent_class">
5949- <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
5950- </field>
5951- </record>
5952- <class name="CarouselIndicatorLines"
5953- c:symbol-prefix="carousel_indicator_lines"
5954- c:type="AdwCarouselIndicatorLines"
5955- parent="Gtk.Widget"
5956- final="1"
5957- glib:type-name="AdwCarouselIndicatorLines"
5958- glib:get-type="adw_carousel_indicator_lines_get_type"
5959- glib:type-struct="CarouselIndicatorLinesClass">
5960- <doc xml:space="preserve"
5961- filename="src/adw-carousel-indicator-lines.c"
5962- line="23">A lines indicator for [class@Carousel].
5963-
5964-&lt;picture&gt;
5965- &lt;source srcset="carousel-indicator-dots-lines.png" media="(prefers-color-scheme: dark)"&gt;
5966- &lt;img src="carousel-indicator-lines.png" alt="carousel-indicator-lines"&gt;
5967-&lt;/picture&gt;
5968-
5969-The `AdwCarouselIndicatorLines` widget shows a set of lines for each page of
5970-a given [class@Carousel]. The carousel's active page is shown as another line
5971-that moves between them to match the carousel's position.
5515+ filename="src/adw-alert-dialog.c"
5516+ line="1970">Adds multiple responses to @self.
59725517
5973-See also [class@CarouselIndicatorDots].
5518+This is the same as calling [method@AlertDialog.add_response] repeatedly. The
5519+variable argument list should be `NULL`-terminated list of response IDs and
5520+labels.
59745521
5975-## CSS nodes
5522+Example:
59765523
5977-`AdwCarouselIndicatorLines` has a single CSS node with name
5978-`carouselindicatorlines`.</doc>
5979- <source-position filename="src/adw-carousel-indicator-lines.h"
5980- line="23"/>
5981- <implements name="Gtk.Accessible"/>
5982- <implements name="Gtk.Buildable"/>
5983- <implements name="Gtk.ConstraintTarget"/>
5984- <implements name="Gtk.Orientable"/>
5985- <constructor name="new" c:identifier="adw_carousel_indicator_lines_new">
5986- <doc xml:space="preserve"
5987- filename="src/adw-carousel-indicator-lines.c"
5988- line="349">Creates a new `AdwCarouselIndicatorLines`.</doc>
5989- <source-position filename="src/adw-carousel-indicator-lines.h"
5990- line="26"/>
5524+```c
5525+adw_alert_dialog_add_responses (dialog,
5526+ "cancel", _("_Cancel"),
5527+ "discard", _("_Discard"),
5528+ "save", _("_Save"),
5529+ NULL);
5530+```</doc>
5531+ <source-position filename="src/adw-alert-dialog.h" line="113"/>
59915532 <return-value transfer-ownership="none">
5992- <doc xml:space="preserve"
5993- filename="src/adw-carousel-indicator-lines.c"
5994- line="354">the newly created `AdwCarouselIndicatorLines`</doc>
5995- <type name="Gtk.Widget" c:type="GtkWidget*"/>
5996- </return-value>
5997- </constructor>
5998- <method name="get_carousel"
5999- c:identifier="adw_carousel_indicator_lines_get_carousel"
6000- glib:get-property="carousel">
6001- <attribute name="org.gtk.Method.get_property" value="carousel"/>
6002- <doc xml:space="preserve"
6003- filename="src/adw-carousel-indicator-lines.c"
6004- line="362">Gets the displayed carousel.</doc>
6005- <source-position filename="src/adw-carousel-indicator-lines.h"
6006- line="29"/>
6007- <return-value transfer-ownership="none" nullable="1">
6008- <doc xml:space="preserve"
6009- filename="src/adw-carousel-indicator-lines.c"
6010- line="368">the displayed carousel</doc>
6011- <type name="Carousel" c:type="AdwCarousel*"/>
5533+ <type name="none" c:type="void"/>
60125534 </return-value>
60135535 <parameters>
60145536 <instance-parameter name="self" transfer-ownership="none">
60155537 <doc xml:space="preserve"
6016- filename="src/adw-carousel-indicator-lines.c"
6017- line="364">an indicator</doc>
6018- <type name="CarouselIndicatorLines"
6019- c:type="AdwCarouselIndicatorLines*"/>
5538+ filename="src/adw-alert-dialog.c"
5539+ line="1972">an alert dialog</doc>
5540+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
60205541 </instance-parameter>
5542+ <parameter name="first_id" transfer-ownership="none">
5543+ <doc xml:space="preserve"
5544+ filename="src/adw-alert-dialog.c"
5545+ line="1973">response id</doc>
5546+ <type name="utf8" c:type="const char*"/>
5547+ </parameter>
5548+ <parameter name="..." transfer-ownership="none">
5549+ <doc xml:space="preserve"
5550+ filename="src/adw-alert-dialog.c"
5551+ line="1974">label for first response, then more id-label pairs</doc>
5552+ <varargs/>
5553+ </parameter>
60215554 </parameters>
60225555 </method>
6023- <method name="set_carousel"
6024- c:identifier="adw_carousel_indicator_lines_set_carousel"
6025- glib:set-property="carousel">
6026- <attribute name="org.gtk.Method.set_property" value="carousel"/>
5556+ <method name="choose"
5557+ c:identifier="adw_alert_dialog_choose"
5558+ version="1.5"
5559+ glib:finish-func="choose_finish">
60275560 <doc xml:space="preserve"
6028- filename="src/adw-carousel-indicator-lines.c"
6029- line="378">Sets the displayed carousel.</doc>
6030- <source-position filename="src/adw-carousel-indicator-lines.h"
6031- line="31"/>
5561+ filename="src/adw-alert-dialog.c"
5562+ line="2454">This function shows @self to the user.
5563+
5564+If the window is an [class@Window] or [class@ApplicationWindow], the dialog
5565+will be shown within it. Otherwise, it will be a separate window.</doc>
5566+ <source-position filename="src/adw-alert-dialog.h" line="162"/>
60325567 <return-value transfer-ownership="none">
60335568 <type name="none" c:type="void"/>
60345569 </return-value>
60355570 <parameters>
60365571 <instance-parameter name="self" transfer-ownership="none">
60375572 <doc xml:space="preserve"
6038- filename="src/adw-carousel-indicator-lines.c"
6039- line="380">an indicator</doc>
6040- <type name="CarouselIndicatorLines"
6041- c:type="AdwCarouselIndicatorLines*"/>
5573+ filename="src/adw-alert-dialog.c"
5574+ line="2456">an alert dialog</doc>
5575+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
60425576 </instance-parameter>
6043- <parameter name="carousel"
5577+ <parameter name="parent"
60445578 transfer-ownership="none"
60455579 nullable="1"
60465580 allow-none="1">
60475581 <doc xml:space="preserve"
6048- filename="src/adw-carousel-indicator-lines.c"
6049- line="381">a carousel</doc>
6050- <type name="Carousel" c:type="AdwCarousel*"/>
5582+ filename="src/adw-alert-dialog.c"
5583+ line="2457">the parent widget</doc>
5584+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
5585+ </parameter>
5586+ <parameter name="cancellable"
5587+ transfer-ownership="none"
5588+ nullable="1"
5589+ allow-none="1">
5590+ <doc xml:space="preserve"
5591+ filename="src/adw-alert-dialog.c"
5592+ line="2458">a `GCancellable` to cancel the operation</doc>
5593+ <type name="Gio.Cancellable" c:type="GCancellable*"/>
5594+ </parameter>
5595+ <parameter name="callback"
5596+ transfer-ownership="none"
5597+ nullable="1"
5598+ allow-none="1"
5599+ scope="async"
5600+ closure="3">
5601+ <doc xml:space="preserve"
5602+ filename="src/adw-alert-dialog.c"
5603+ line="2459">a callback to call when the operation is complete</doc>
5604+ <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
5605+ </parameter>
5606+ <parameter name="user_data"
5607+ transfer-ownership="none"
5608+ nullable="1"
5609+ allow-none="1">
5610+ <doc xml:space="preserve"
5611+ filename="src/adw-alert-dialog.c"
5612+ line="2460">data to pass to @callback</doc>
5613+ <type name="gpointer" c:type="gpointer"/>
60515614 </parameter>
60525615 </parameters>
60535616 </method>
6054- <property name="carousel"
6055- writable="1"
6056- transfer-ownership="none"
6057- setter="set_carousel"
6058- getter="get_carousel">
6059- <attribute name="org.gtk.Property.get"
6060- value="adw_carousel_indicator_lines_get_carousel"/>
6061- <attribute name="org.gtk.Property.set"
6062- value="adw_carousel_indicator_lines_set_carousel"/>
5617+ <method name="choose_finish"
5618+ c:identifier="adw_alert_dialog_choose_finish"
5619+ version="1.5">
60635620 <doc xml:space="preserve"
6064- filename="src/adw-carousel-indicator-lines.c"
6065- line="319">The displayed carousel.</doc>
6066- <type name="Carousel"/>
6067- </property>
6068- </class>
6069- <record name="CarouselIndicatorLinesClass"
6070- c:type="AdwCarouselIndicatorLinesClass"
6071- glib:is-gtype-struct-for="CarouselIndicatorLines">
6072- <source-position filename="src/adw-carousel-indicator-lines.h"
6073- line="23"/>
6074- <field name="parent_class">
6075- <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
6076- </field>
6077- </record>
6078- <enumeration name="CenteringPolicy"
6079- glib:type-name="AdwCenteringPolicy"
6080- glib:get-type="adw_centering_policy_get_type"
6081- c:type="AdwCenteringPolicy">
6082- <doc xml:space="preserve"
6083- filename="src/adw-header-bar.c"
6084- line="119">Describes title centering behavior of a [class@HeaderBar] widget.</doc>
6085- <member name="loose"
6086- value="0"
6087- c:identifier="ADW_CENTERING_POLICY_LOOSE"
6088- glib:nick="loose"
6089- glib:name="ADW_CENTERING_POLICY_LOOSE">
5621+ filename="src/adw-alert-dialog.c"
5622+ line="2492">Finishes the [method@AlertDialog.choose] call and returns the response ID.</doc>
5623+ <source-position filename="src/adw-alert-dialog.h" line="168"/>
5624+ <return-value transfer-ownership="none">
5625+ <doc xml:space="preserve"
5626+ filename="src/adw-alert-dialog.c"
5627+ line="2499">the ID of the response that was selected, or
5628+ [property@AlertDialog:close-response] if the call was cancelled.</doc>
5629+ <type name="utf8" c:type="const char*"/>
5630+ </return-value>
5631+ <parameters>
5632+ <instance-parameter name="self" transfer-ownership="none">
5633+ <doc xml:space="preserve"
5634+ filename="src/adw-alert-dialog.c"
5635+ line="2494">an alert dialog</doc>
5636+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
5637+ </instance-parameter>
5638+ <parameter name="result" transfer-ownership="none">
5639+ <doc xml:space="preserve"
5640+ filename="src/adw-alert-dialog.c"
5641+ line="2495">a `GAsyncResult`</doc>
5642+ <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
5643+ </parameter>
5644+ </parameters>
5645+ </method>
5646+ <method name="format_body"
5647+ c:identifier="adw_alert_dialog_format_body"
5648+ version="1.5"
5649+ introspectable="0">
60905650 <doc xml:space="preserve"
6091- filename="src/adw-header-bar.c"
6092- line="121">Keep the title centered when possible</doc>
6093- </member>
6094- <member name="strict"
6095- value="1"
6096- c:identifier="ADW_CENTERING_POLICY_STRICT"
6097- glib:nick="strict"
6098- glib:name="ADW_CENTERING_POLICY_STRICT">
5651+ filename="src/adw-alert-dialog.c"
5652+ line="1702">Sets the formatted body text of @self.
5653+
5654+See [property@AlertDialog:body].</doc>
5655+ <source-position filename="src/adw-alert-dialog.h" line="86"/>
5656+ <return-value transfer-ownership="none">
5657+ <type name="none" c:type="void"/>
5658+ </return-value>
5659+ <parameters>
5660+ <instance-parameter name="self" transfer-ownership="none">
5661+ <doc xml:space="preserve"
5662+ filename="src/adw-alert-dialog.c"
5663+ line="1704">an alert dialog</doc>
5664+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
5665+ </instance-parameter>
5666+ <parameter name="format" transfer-ownership="none">
5667+ <doc xml:space="preserve"
5668+ filename="src/adw-alert-dialog.c"
5669+ line="1705">the formatted string for the body text</doc>
5670+ <type name="utf8" c:type="const char*"/>
5671+ </parameter>
5672+ <parameter name="..." transfer-ownership="none">
5673+ <doc xml:space="preserve"
5674+ filename="src/adw-alert-dialog.c"
5675+ line="1706">the parameters to insert into @format</doc>
5676+ <varargs/>
5677+ </parameter>
5678+ </parameters>
5679+ </method>
5680+ <method name="format_body_markup"
5681+ c:identifier="adw_alert_dialog_format_body_markup"
5682+ version="1.5"
5683+ introspectable="0">
60995684 <doc xml:space="preserve"
6100- filename="src/adw-header-bar.c"
6101- line="122">Keep the title centered at all cost</doc>
6102- </member>
6103- </enumeration>
6104- <class name="Clamp"
6105- c:symbol-prefix="clamp"
6106- c:type="AdwClamp"
6107- parent="Gtk.Widget"
6108- final="1"
6109- glib:type-name="AdwClamp"
6110- glib:get-type="adw_clamp_get_type"
6111- glib:type-struct="ClampClass">
6112- <doc xml:space="preserve"
6113- filename="src/adw-clamp.c"
6114- line="13">A widget constraining its child to a given size.
5685+ filename="src/adw-alert-dialog.c"
5686+ line="1745">Sets the formatted body text of @self with Pango markup.
61155687
6116-&lt;picture&gt;
6117- &lt;source srcset="clamp-wide-dark.png" media="(prefers-color-scheme: dark)"&gt;
6118- &lt;img src="clamp-wide.png" alt="clamp-wide"&gt;
6119-&lt;/picture&gt;
6120-&lt;picture&gt;
6121- &lt;source srcset="clamp-narrow-dark.png" media="(prefers-color-scheme: dark)"&gt;
6122- &lt;img src="clamp-narrow.png" alt="clamp-narrow"&gt;
6123-&lt;/picture&gt;
5688+The @format is assumed to contain Pango markup.
61245689
6125-The `AdwClamp` widget constrains the size of the widget it contains to a
6126-given maximum size. It will constrain the width if it is horizontal, or the
6127-height if it is vertical. The expansion of the child from its minimum to its
6128-maximum size is eased out for a smooth transition.
5690+Special XML characters in the `printf()` arguments passed to this function
5691+will automatically be escaped as necessary, see
5692+[func@GLib.markup_printf_escaped].
61295693
6130-If the child requires more than the requested maximum size, it will be
6131-allocated the minimum size it can fit in instead.
5694+See [property@AlertDialog:body].</doc>
5695+ <source-position filename="src/adw-alert-dialog.h" line="91"/>
5696+ <return-value transfer-ownership="none">
5697+ <type name="none" c:type="void"/>
5698+ </return-value>
5699+ <parameters>
5700+ <instance-parameter name="self" transfer-ownership="none">
5701+ <doc xml:space="preserve"
5702+ filename="src/adw-alert-dialog.c"
5703+ line="1747">an alert dialog</doc>
5704+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
5705+ </instance-parameter>
5706+ <parameter name="format" transfer-ownership="none">
5707+ <doc xml:space="preserve"
5708+ filename="src/adw-alert-dialog.c"
5709+ line="1748">the formatted string for the body text with Pango markup</doc>
5710+ <type name="utf8" c:type="const char*"/>
5711+ </parameter>
5712+ <parameter name="..." transfer-ownership="none">
5713+ <doc xml:space="preserve"
5714+ filename="src/adw-alert-dialog.c"
5715+ line="1749">the parameters to insert into @format</doc>
5716+ <varargs/>
5717+ </parameter>
5718+ </parameters>
5719+ </method>
5720+ <method name="format_heading"
5721+ c:identifier="adw_alert_dialog_format_heading"
5722+ version="1.5"
5723+ introspectable="0">
5724+ <doc xml:space="preserve"
5725+ filename="src/adw-alert-dialog.c"
5726+ line="1499">Sets the formatted heading of @self.
61325727
6133-## CSS nodes
5728+See [property@AlertDialog:heading].</doc>
5729+ <source-position filename="src/adw-alert-dialog.h" line="64"/>
5730+ <return-value transfer-ownership="none">
5731+ <type name="none" c:type="void"/>
5732+ </return-value>
5733+ <parameters>
5734+ <instance-parameter name="self" transfer-ownership="none">
5735+ <doc xml:space="preserve"
5736+ filename="src/adw-alert-dialog.c"
5737+ line="1501">an alert dialog</doc>
5738+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
5739+ </instance-parameter>
5740+ <parameter name="format" transfer-ownership="none">
5741+ <doc xml:space="preserve"
5742+ filename="src/adw-alert-dialog.c"
5743+ line="1502">the formatted string for the heading</doc>
5744+ <type name="utf8" c:type="const char*"/>
5745+ </parameter>
5746+ <parameter name="..." transfer-ownership="none">
5747+ <doc xml:space="preserve"
5748+ filename="src/adw-alert-dialog.c"
5749+ line="1503">the parameters to insert into @format</doc>
5750+ <varargs/>
5751+ </parameter>
5752+ </parameters>
5753+ </method>
5754+ <method name="format_heading_markup"
5755+ c:identifier="adw_alert_dialog_format_heading_markup"
5756+ version="1.5"
5757+ introspectable="0">
5758+ <doc xml:space="preserve"
5759+ filename="src/adw-alert-dialog.c"
5760+ line="1542">Sets the formatted heading of @self with Pango markup.
61345761
6135-`AdwClamp` has a single CSS node with name `clamp`.
5762+The @format is assumed to contain Pango markup.
61365763
6137-Its children will receive the style classes `.large` when the child reached
6138-its maximum size, `.small` when the clamp allocates its full size to the
6139-child, `.medium` in-between, or none if it hasn't computed its size yet.</doc>
6140- <source-position filename="src/adw-clamp.h" line="22"/>
6141- <implements name="Gtk.Accessible"/>
6142- <implements name="Gtk.Buildable"/>
6143- <implements name="Gtk.ConstraintTarget"/>
6144- <implements name="Gtk.Orientable"/>
6145- <constructor name="new" c:identifier="adw_clamp_new">
5764+Special XML characters in the `printf()` arguments passed to this function
5765+will automatically be escaped as necessary, see
5766+[func@GLib.markup_printf_escaped].
5767+
5768+See [property@AlertDialog:heading].</doc>
5769+ <source-position filename="src/adw-alert-dialog.h" line="69"/>
5770+ <return-value transfer-ownership="none">
5771+ <type name="none" c:type="void"/>
5772+ </return-value>
5773+ <parameters>
5774+ <instance-parameter name="self" transfer-ownership="none">
5775+ <doc xml:space="preserve"
5776+ filename="src/adw-alert-dialog.c"
5777+ line="1544">an alert dialog</doc>
5778+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
5779+ </instance-parameter>
5780+ <parameter name="format" transfer-ownership="none">
5781+ <doc xml:space="preserve"
5782+ filename="src/adw-alert-dialog.c"
5783+ line="1545">the formatted string for the heading with Pango markup</doc>
5784+ <type name="utf8" c:type="const char*"/>
5785+ </parameter>
5786+ <parameter name="..." transfer-ownership="none">
5787+ <doc xml:space="preserve"
5788+ filename="src/adw-alert-dialog.c"
5789+ line="1546">the parameters to insert into @format</doc>
5790+ <varargs/>
5791+ </parameter>
5792+ </parameters>
5793+ </method>
5794+ <method name="get_body"
5795+ c:identifier="adw_alert_dialog_get_body"
5796+ glib:get-property="body"
5797+ version="1.5">
61465798 <doc xml:space="preserve"
6147- filename="src/adw-clamp.c"
6148- line="246">Creates a new `AdwClamp`.</doc>
6149- <source-position filename="src/adw-clamp.h" line="25"/>
5799+ filename="src/adw-alert-dialog.c"
5800+ line="1591">Gets the body text of @self.</doc>
5801+ <source-position filename="src/adw-alert-dialog.h" line="74"/>
61505802 <return-value transfer-ownership="none">
61515803 <doc xml:space="preserve"
6152- filename="src/adw-clamp.c"
6153- line="251">the newly created `AdwClamp`</doc>
6154- <type name="Gtk.Widget" c:type="GtkWidget*"/>
5804+ filename="src/adw-alert-dialog.c"
5805+ line="1597">the body of @self.</doc>
5806+ <type name="utf8" c:type="const char*"/>
61555807 </return-value>
6156- </constructor>
6157- <method name="get_child"
6158- c:identifier="adw_clamp_get_child"
6159- glib:get-property="child">
6160- <attribute name="org.gtk.Method.get_property" value="child"/>
5808+ <parameters>
5809+ <instance-parameter name="self" transfer-ownership="none">
5810+ <doc xml:space="preserve"
5811+ filename="src/adw-alert-dialog.c"
5812+ line="1593">an alert dialog</doc>
5813+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
5814+ </instance-parameter>
5815+ </parameters>
5816+ </method>
5817+ <method name="get_body_use_markup"
5818+ c:identifier="adw_alert_dialog_get_body_use_markup"
5819+ glib:get-property="body-use-markup"
5820+ version="1.5">
61615821 <doc xml:space="preserve"
6162- filename="src/adw-clamp.c"
6163- line="259">Gets the child widget of @self.</doc>
6164- <source-position filename="src/adw-clamp.h" line="28"/>
6165- <return-value transfer-ownership="none" nullable="1">
5822+ filename="src/adw-alert-dialog.c"
5823+ line="1647">Gets whether the body text of @self includes Pango markup.</doc>
5824+ <source-position filename="src/adw-alert-dialog.h" line="80"/>
5825+ <return-value transfer-ownership="none">
61665826 <doc xml:space="preserve"
6167- filename="src/adw-clamp.c"
6168- line="265">the child widget of @self</doc>
6169- <type name="Gtk.Widget" c:type="GtkWidget*"/>
5827+ filename="src/adw-alert-dialog.c"
5828+ line="1653">whether @self uses markup for body text</doc>
5829+ <type name="gboolean" c:type="gboolean"/>
61705830 </return-value>
61715831 <parameters>
61725832 <instance-parameter name="self" transfer-ownership="none">
61735833 <doc xml:space="preserve"
6174- filename="src/adw-clamp.c"
6175- line="261">a clamp</doc>
6176- <type name="Clamp" c:type="AdwClamp*"/>
5834+ filename="src/adw-alert-dialog.c"
5835+ line="1649">an alert dialog</doc>
5836+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
61775837 </instance-parameter>
61785838 </parameters>
61795839 </method>
6180- <method name="get_maximum_size"
6181- c:identifier="adw_clamp_get_maximum_size"
6182- glib:get-property="maximum-size">
6183- <attribute name="org.gtk.Method.get_property" value="maximum-size"/>
5840+ <method name="get_close_response"
5841+ c:identifier="adw_alert_dialog_get_close_response"
5842+ glib:get-property="close-response"
5843+ version="1.5">
61845844 <doc xml:space="preserve"
6185- filename="src/adw-clamp.c"
6186- line="302">Gets the maximum size allocated to the child.</doc>
6187- <source-position filename="src/adw-clamp.h" line="34"/>
5845+ filename="src/adw-alert-dialog.c"
5846+ line="2345">Gets the ID of the close response of @self.</doc>
5847+ <source-position filename="src/adw-alert-dialog.h" line="152"/>
61885848 <return-value transfer-ownership="none">
61895849 <doc xml:space="preserve"
6190- filename="src/adw-clamp.c"
6191- line="308">the maximum size to allocate to the child</doc>
6192- <type name="gint" c:type="int"/>
5850+ filename="src/adw-alert-dialog.c"
5851+ line="2351">the close response ID</doc>
5852+ <type name="utf8" c:type="const char*"/>
61935853 </return-value>
61945854 <parameters>
61955855 <instance-parameter name="self" transfer-ownership="none">
61965856 <doc xml:space="preserve"
6197- filename="src/adw-clamp.c"
6198- line="304">a clamp</doc>
6199- <type name="Clamp" c:type="AdwClamp*"/>
5857+ filename="src/adw-alert-dialog.c"
5858+ line="2347">an alert dialog</doc>
5859+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
62005860 </instance-parameter>
62015861 </parameters>
62025862 </method>
6203- <method name="get_tightening_threshold"
6204- c:identifier="adw_clamp_get_tightening_threshold"
6205- glib:get-property="tightening-threshold">
6206- <attribute name="org.gtk.Method.get_property"
6207- value="tightening-threshold"/>
5863+ <method name="get_default_response"
5864+ c:identifier="adw_alert_dialog_get_default_response"
5865+ glib:get-property="default-response"
5866+ version="1.5">
62085867 <doc xml:space="preserve"
6209- filename="src/adw-clamp.c"
6210- line="349">Gets the size above which the child is clamped.</doc>
6211- <source-position filename="src/adw-clamp.h" line="40"/>
6212- <return-value transfer-ownership="none">
5868+ filename="src/adw-alert-dialog.c"
5869+ line="2280">Gets the ID of the default response of @self.</doc>
5870+ <source-position filename="src/adw-alert-dialog.h" line="146"/>
5871+ <return-value transfer-ownership="none" nullable="1">
62135872 <doc xml:space="preserve"
6214- filename="src/adw-clamp.c"
6215- line="355">the size above which the child is clamped</doc>
6216- <type name="gint" c:type="int"/>
5873+ filename="src/adw-alert-dialog.c"
5874+ line="2286">the default response ID</doc>
5875+ <type name="utf8" c:type="const char*"/>
62175876 </return-value>
62185877 <parameters>
62195878 <instance-parameter name="self" transfer-ownership="none">
62205879 <doc xml:space="preserve"
6221- filename="src/adw-clamp.c"
6222- line="351">a clamp</doc>
6223- <type name="Clamp" c:type="AdwClamp*"/>
5880+ filename="src/adw-alert-dialog.c"
5881+ line="2282">an alert dialog</doc>
5882+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
62245883 </instance-parameter>
62255884 </parameters>
62265885 </method>
6227- <method name="set_child"
6228- c:identifier="adw_clamp_set_child"
6229- glib:set-property="child">
6230- <attribute name="org.gtk.Method.set_property" value="child"/>
5886+ <method name="get_extra_child"
5887+ c:identifier="adw_alert_dialog_get_extra_child"
5888+ glib:get-property="extra-child"
5889+ version="1.5">
62315890 <doc xml:space="preserve"
6232- filename="src/adw-clamp.c"
6233- line="275">Sets the child widget of @self.</doc>
6234- <source-position filename="src/adw-clamp.h" line="30"/>
6235- <return-value transfer-ownership="none">
6236- <type name="none" c:type="void"/>
5891+ filename="src/adw-alert-dialog.c"
5892+ line="1794">Gets the child widget of @self.</doc>
5893+ <source-position filename="src/adw-alert-dialog.h" line="96"/>
5894+ <return-value transfer-ownership="none" nullable="1">
5895+ <doc xml:space="preserve"
5896+ filename="src/adw-alert-dialog.c"
5897+ line="1800">the child widget of @self.</doc>
5898+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
62375899 </return-value>
62385900 <parameters>
62395901 <instance-parameter name="self" transfer-ownership="none">
62405902 <doc xml:space="preserve"
6241- filename="src/adw-clamp.c"
6242- line="277">a clamp</doc>
6243- <type name="Clamp" c:type="AdwClamp*"/>
5903+ filename="src/adw-alert-dialog.c"
5904+ line="1796">an alert dialog</doc>
5905+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
62445906 </instance-parameter>
6245- <parameter name="child"
6246- transfer-ownership="none"
6247- nullable="1"
6248- allow-none="1">
5907+ </parameters>
5908+ </method>
5909+ <method name="get_heading"
5910+ c:identifier="adw_alert_dialog_get_heading"
5911+ glib:get-property="heading"
5912+ version="1.5">
5913+ <doc xml:space="preserve"
5914+ filename="src/adw-alert-dialog.c"
5915+ line="1380">Gets the heading of @self.</doc>
5916+ <source-position filename="src/adw-alert-dialog.h" line="52"/>
5917+ <return-value transfer-ownership="none" nullable="1">
5918+ <doc xml:space="preserve"
5919+ filename="src/adw-alert-dialog.c"
5920+ line="1386">the heading of @self.</doc>
5921+ <type name="utf8" c:type="const char*"/>
5922+ </return-value>
5923+ <parameters>
5924+ <instance-parameter name="self" transfer-ownership="none">
62495925 <doc xml:space="preserve"
6250- filename="src/adw-clamp.c"
6251- line="278">the child widget</doc>
6252- <type name="Gtk.Widget" c:type="GtkWidget*"/>
6253- </parameter>
5926+ filename="src/adw-alert-dialog.c"
5927+ line="1382">an alert dialog</doc>
5928+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
5929+ </instance-parameter>
62545930 </parameters>
62555931 </method>
6256- <method name="set_maximum_size"
6257- c:identifier="adw_clamp_set_maximum_size"
6258- glib:set-property="maximum-size">
6259- <attribute name="org.gtk.Method.set_property" value="maximum-size"/>
5932+ <method name="get_heading_use_markup"
5933+ c:identifier="adw_alert_dialog_get_heading_use_markup"
5934+ glib:get-property="heading-use-markup"
5935+ version="1.5">
62605936 <doc xml:space="preserve"
6261- filename="src/adw-clamp.c"
6262- line="322">Sets the maximum size allocated to the child.
6263-
6264-It is the width if the clamp is horizontal, or the height if it is vertical.</doc>
6265- <source-position filename="src/adw-clamp.h" line="36"/>
5937+ filename="src/adw-alert-dialog.c"
5938+ line="1440">Gets whether the heading of @self includes Pango markup.</doc>
5939+ <source-position filename="src/adw-alert-dialog.h" line="58"/>
62665940 <return-value transfer-ownership="none">
6267- <type name="none" c:type="void"/>
5941+ <doc xml:space="preserve"
5942+ filename="src/adw-alert-dialog.c"
5943+ line="1446">whether @self uses markup for heading</doc>
5944+ <type name="gboolean" c:type="gboolean"/>
62685945 </return-value>
62695946 <parameters>
62705947 <instance-parameter name="self" transfer-ownership="none">
62715948 <doc xml:space="preserve"
6272- filename="src/adw-clamp.c"
6273- line="324">a clamp</doc>
6274- <type name="Clamp" c:type="AdwClamp*"/>
5949+ filename="src/adw-alert-dialog.c"
5950+ line="1442">an alert dialog</doc>
5951+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
62755952 </instance-parameter>
6276- <parameter name="maximum_size" transfer-ownership="none">
6277- <doc xml:space="preserve"
6278- filename="src/adw-clamp.c"
6279- line="325">the maximum size</doc>
6280- <type name="gint" c:type="int"/>
6281- </parameter>
62825953 </parameters>
62835954 </method>
6284- <method name="set_tightening_threshold"
6285- c:identifier="adw_clamp_set_tightening_threshold"
6286- glib:set-property="tightening-threshold">
6287- <attribute name="org.gtk.Method.set_property"
6288- value="tightening-threshold"/>
5955+ <method name="get_prefer_wide_layout"
5956+ c:identifier="adw_alert_dialog_get_prefer_wide_layout"
5957+ glib:get-property="prefer-wide-layout"
5958+ version="1.5">
62895959 <doc xml:space="preserve"
6290- filename="src/adw-clamp.c"
6291- line="369">Sets the size above which the child is clamped.
6292-
6293-Starting from this size, the clamp will tighten its grip on the child, slowly
6294-allocating less and less of the available size up to the maximum allocated
6295-size. Below that threshold and below the maximum size, the child will be
6296-allocated all the available size.
6297-
6298-If the threshold is greater than the maximum size to allocate to the child,
6299-the child will be allocated all the size up to the maximum. If the threshold
6300-is lower than the minimum size to allocate to the child, that size will be
6301-used as the tightening threshold.
6302-
6303-Effectively, tightening the grip on the child before it reaches its maximum
6304-size makes transitions to and from the maximum size smoother when resizing.</doc>
6305- <source-position filename="src/adw-clamp.h" line="42"/>
5960+ filename="src/adw-alert-dialog.c"
5961+ line="1851">Gets whether @self prefers wide layout.</doc>
5962+ <source-position filename="src/adw-alert-dialog.h" line="102"/>
63065963 <return-value transfer-ownership="none">
6307- <type name="none" c:type="void"/>
5964+ <doc xml:space="preserve"
5965+ filename="src/adw-alert-dialog.c"
5966+ line="1857">whether to prefer wide layout</doc>
5967+ <type name="gboolean" c:type="gboolean"/>
63085968 </return-value>
63095969 <parameters>
63105970 <instance-parameter name="self" transfer-ownership="none">
63115971 <doc xml:space="preserve"
6312- filename="src/adw-clamp.c"
6313- line="371">a clamp</doc>
6314- <type name="Clamp" c:type="AdwClamp*"/>
5972+ filename="src/adw-alert-dialog.c"
5973+ line="1853">an alert dialog</doc>
5974+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
63155975 </instance-parameter>
6316- <parameter name="tightening_threshold" transfer-ownership="none">
6317- <doc xml:space="preserve"
6318- filename="src/adw-clamp.c"
6319- line="372">the tightening threshold</doc>
6320- <type name="gint" c:type="int"/>
6321- </parameter>
63225976 </parameters>
63235977 </method>
6324- <property name="child"
6325- writable="1"
6326- transfer-ownership="none"
6327- setter="set_child"
6328- getter="get_child">
6329- <attribute name="org.gtk.Property.get" value="adw_clamp_get_child"/>
6330- <attribute name="org.gtk.Property.set" value="adw_clamp_set_child"/>
6331- <doc xml:space="preserve"
6332- filename="src/adw-clamp.c"
6333- line="169">The child widget of the `AdwClamp`.</doc>
6334- <type name="Gtk.Widget"/>
6335- </property>
6336- <property name="maximum-size"
6337- writable="1"
6338- transfer-ownership="none"
6339- setter="set_maximum_size"
6340- getter="get_maximum_size"
6341- default-value="600">
6342- <attribute name="org.gtk.Property.get"
6343- value="adw_clamp_get_maximum_size"/>
6344- <attribute name="org.gtk.Property.set"
6345- value="adw_clamp_set_maximum_size"/>
5978+ <method name="get_response_appearance"
5979+ c:identifier="adw_alert_dialog_get_response_appearance"
5980+ version="1.5">
63465981 <doc xml:space="preserve"
6347- filename="src/adw-clamp.c"
6348- line="179">The maximum size allocated to the child.
5982+ filename="src/adw-alert-dialog.c"
5983+ line="2125">Gets the appearance of @response.
63495984
6350-It is the width if the clamp is horizontal, or the height if it is vertical.</doc>
6351- <type name="gint" c:type="gint"/>
6352- </property>
6353- <property name="tightening-threshold"
6354- writable="1"
6355- transfer-ownership="none"
6356- setter="set_tightening_threshold"
6357- getter="get_tightening_threshold"
6358- default-value="400">
6359- <attribute name="org.gtk.Property.get"
6360- value="adw_clamp_get_tightening_threshold"/>
6361- <attribute name="org.gtk.Property.set"
6362- value="adw_clamp_set_tightening_threshold"/>
5985+See [method@AlertDialog.set_response_appearance].</doc>
5986+ <source-position filename="src/adw-alert-dialog.h" line="130"/>
5987+ <return-value transfer-ownership="none">
5988+ <doc xml:space="preserve"
5989+ filename="src/adw-alert-dialog.c"
5990+ line="2134">the appearance of @response</doc>
5991+ <type name="ResponseAppearance" c:type="AdwResponseAppearance"/>
5992+ </return-value>
5993+ <parameters>
5994+ <instance-parameter name="self" transfer-ownership="none">
5995+ <doc xml:space="preserve"
5996+ filename="src/adw-alert-dialog.c"
5997+ line="2127">an alert dialog</doc>
5998+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
5999+ </instance-parameter>
6000+ <parameter name="response" transfer-ownership="none">
6001+ <doc xml:space="preserve"
6002+ filename="src/adw-alert-dialog.c"
6003+ line="2128">a response ID</doc>
6004+ <type name="utf8" c:type="const char*"/>
6005+ </parameter>
6006+ </parameters>
6007+ </method>
6008+ <method name="get_response_enabled"
6009+ c:identifier="adw_alert_dialog_get_response_enabled"
6010+ version="1.5">
63636011 <doc xml:space="preserve"
6364- filename="src/adw-clamp.c"
6365- line="191">The size above which the child is clamped.
6366-
6367-Starting from this size, the clamp will tighten its grip on the child,
6368-slowly allocating less and less of the available size up to the maximum
6369-allocated size. Below that threshold and below the maximum size, the child
6370-will be allocated all the available size.
6371-
6372-If the threshold is greater than the maximum size to allocate to the child,
6373-the child will be allocated all the size up to the maximum.
6374-If the threshold is lower than the minimum size to allocate to the child,
6375-that size will be used as the tightening threshold.
6376-
6377-Effectively, tightening the grip on the child before it reaches its maximum
6378-size makes transitions to and from the maximum size smoother when resizing.</doc>
6379- <type name="gint" c:type="gint"/>
6380- </property>
6381- </class>
6382- <record name="ClampClass"
6383- c:type="AdwClampClass"
6384- glib:is-gtype-struct-for="Clamp">
6385- <source-position filename="src/adw-clamp.h" line="22"/>
6386- <field name="parent_class">
6387- <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
6388- </field>
6389- </record>
6390- <class name="ClampLayout"
6391- c:symbol-prefix="clamp_layout"
6392- c:type="AdwClampLayout"
6393- parent="Gtk.LayoutManager"
6394- final="1"
6395- glib:type-name="AdwClampLayout"
6396- glib:get-type="adw_clamp_layout_get_type"
6397- glib:type-struct="ClampLayoutClass">
6398- <doc xml:space="preserve"
6399- filename="src/adw-clamp-layout.c"
6400- line="15">A layout manager constraining its children to a given size.
6401-
6402-&lt;picture&gt;
6403- &lt;source srcset="clamp-wide-dark.png" media="(prefers-color-scheme: dark)"&gt;
6404- &lt;img src="clamp-wide.png" alt="clamp-wide"&gt;
6405-&lt;/picture&gt;
6406-&lt;picture&gt;
6407- &lt;source srcset="clamp-narrow-dark.png" media="(prefers-color-scheme: dark)"&gt;
6408- &lt;img src="clamp-narrow.png" alt="clamp-narrow"&gt;
6409-&lt;/picture&gt;
6410-
6411-`AdwClampLayout` constraints the size of the widgets it contains to a given
6412-maximum size. It will constrain the width if it is horizontal, or the height
6413-if it is vertical. The expansion of the children from their minimum to their
6414-maximum size is eased out for a smooth transition.
6415-
6416-If a child requires more than the requested maximum size, it will be
6417-allocated the minimum size it can fit in instead.
6012+ filename="src/adw-alert-dialog.c"
6013+ line="2210">Gets whether @response is enabled.
64186014
6419-Each child will get the style classes .large when it reached its maximum
6420-size, .small when it's allocated the full size, .medium in-between, or none
6421-if it hasn't been allocated yet.</doc>
6422- <source-position filename="src/adw-clamp-layout.h" line="22"/>
6423- <implements name="Gtk.Orientable"/>
6424- <constructor name="new" c:identifier="adw_clamp_layout_new">
6425- <doc xml:space="preserve"
6426- filename="src/adw-clamp-layout.c"
6427- line="388">Creates a new `AdwClampLayout`.</doc>
6428- <source-position filename="src/adw-clamp-layout.h" line="25"/>
6429- <return-value transfer-ownership="full">
6015+See [method@AlertDialog.set_response_enabled].</doc>
6016+ <source-position filename="src/adw-alert-dialog.h" line="138"/>
6017+ <return-value transfer-ownership="none">
64306018 <doc xml:space="preserve"
6431- filename="src/adw-clamp-layout.c"
6432- line="393">the newly created `AdwClampLayout`</doc>
6433- <type name="Gtk.LayoutManager" c:type="GtkLayoutManager*"/>
6019+ filename="src/adw-alert-dialog.c"
6020+ line="2219">whether @response is enabled</doc>
6021+ <type name="gboolean" c:type="gboolean"/>
64346022 </return-value>
6435- </constructor>
6436- <method name="get_maximum_size"
6437- c:identifier="adw_clamp_layout_get_maximum_size"
6438- glib:get-property="maximum-size">
6439- <attribute name="org.gtk.Method.get_property" value="maximum-size"/>
6023+ <parameters>
6024+ <instance-parameter name="self" transfer-ownership="none">
6025+ <doc xml:space="preserve"
6026+ filename="src/adw-alert-dialog.c"
6027+ line="2212">an alert dialog</doc>
6028+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
6029+ </instance-parameter>
6030+ <parameter name="response" transfer-ownership="none">
6031+ <doc xml:space="preserve"
6032+ filename="src/adw-alert-dialog.c"
6033+ line="2213">a response ID</doc>
6034+ <type name="utf8" c:type="const char*"/>
6035+ </parameter>
6036+ </parameters>
6037+ </method>
6038+ <method name="get_response_label"
6039+ c:identifier="adw_alert_dialog_get_response_label"
6040+ version="1.5">
64406041 <doc xml:space="preserve"
6441- filename="src/adw-clamp-layout.c"
6442- line="401">Gets the maximum size allocated to the children.</doc>
6443- <source-position filename="src/adw-clamp-layout.h" line="28"/>
6042+ filename="src/adw-alert-dialog.c"
6043+ line="2065">Gets the label of @response.
6044+
6045+See [method@AlertDialog.set_response_label].</doc>
6046+ <source-position filename="src/adw-alert-dialog.h" line="122"/>
64446047 <return-value transfer-ownership="none">
64456048 <doc xml:space="preserve"
6446- filename="src/adw-clamp-layout.c"
6447- line="407">the maximum size to allocate to the children</doc>
6448- <type name="gint" c:type="int"/>
6049+ filename="src/adw-alert-dialog.c"
6050+ line="2074">the label of @response</doc>
6051+ <type name="utf8" c:type="const char*"/>
64496052 </return-value>
64506053 <parameters>
64516054 <instance-parameter name="self" transfer-ownership="none">
64526055 <doc xml:space="preserve"
6453- filename="src/adw-clamp-layout.c"
6454- line="403">a clamp layout</doc>
6455- <type name="ClampLayout" c:type="AdwClampLayout*"/>
6056+ filename="src/adw-alert-dialog.c"
6057+ line="2067">an alert dialog</doc>
6058+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
64566059 </instance-parameter>
6060+ <parameter name="response" transfer-ownership="none">
6061+ <doc xml:space="preserve"
6062+ filename="src/adw-alert-dialog.c"
6063+ line="2068">a response ID</doc>
6064+ <type name="utf8" c:type="const char*"/>
6065+ </parameter>
64576066 </parameters>
64586067 </method>
6459- <method name="get_tightening_threshold"
6460- c:identifier="adw_clamp_layout_get_tightening_threshold"
6461- glib:get-property="tightening-threshold">
6462- <attribute name="org.gtk.Method.get_property"
6463- value="tightening-threshold"/>
6068+ <method name="has_response"
6069+ c:identifier="adw_alert_dialog_has_response"
6070+ version="1.5">
64646071 <doc xml:space="preserve"
6465- filename="src/adw-clamp-layout.c"
6466- line="442">Gets the size above which the children are clamped.</doc>
6467- <source-position filename="src/adw-clamp-layout.h" line="34"/>
6072+ filename="src/adw-alert-dialog.c"
6073+ line="2404">Gets whether @self has a response with the ID @response.</doc>
6074+ <source-position filename="src/adw-alert-dialog.h" line="158"/>
64686075 <return-value transfer-ownership="none">
64696076 <doc xml:space="preserve"
6470- filename="src/adw-clamp-layout.c"
6471- line="448">the size above which the children are clamped</doc>
6472- <type name="gint" c:type="int"/>
6077+ filename="src/adw-alert-dialog.c"
6078+ line="2411">whether @self has a response with the ID @response.</doc>
6079+ <type name="gboolean" c:type="gboolean"/>
64736080 </return-value>
64746081 <parameters>
64756082 <instance-parameter name="self" transfer-ownership="none">
64766083 <doc xml:space="preserve"
6477- filename="src/adw-clamp-layout.c"
6478- line="444">a clamp layout</doc>
6479- <type name="ClampLayout" c:type="AdwClampLayout*"/>
6084+ filename="src/adw-alert-dialog.c"
6085+ line="2406">an alert dialog</doc>
6086+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
64806087 </instance-parameter>
6088+ <parameter name="response" transfer-ownership="none">
6089+ <doc xml:space="preserve"
6090+ filename="src/adw-alert-dialog.c"
6091+ line="2407">response ID</doc>
6092+ <type name="utf8" c:type="const char*"/>
6093+ </parameter>
64816094 </parameters>
64826095 </method>
6483- <method name="set_maximum_size"
6484- c:identifier="adw_clamp_layout_set_maximum_size"
6485- glib:set-property="maximum-size">
6486- <attribute name="org.gtk.Method.set_property" value="maximum-size"/>
6096+ <method name="remove_response"
6097+ c:identifier="adw_alert_dialog_remove_response"
6098+ version="1.5">
64876099 <doc xml:space="preserve"
6488- filename="src/adw-clamp-layout.c"
6489- line="417">Sets the maximum size allocated to the children.
6100+ filename="src/adw-alert-dialog.c"
6101+ line="2025">Removes a response from @self.</doc>
6102+ <source-position filename="src/adw-alert-dialog.h" line="118"/>
6103+ <return-value transfer-ownership="none">
6104+ <type name="none" c:type="void"/>
6105+ </return-value>
6106+ <parameters>
6107+ <instance-parameter name="self" transfer-ownership="none">
6108+ <doc xml:space="preserve"
6109+ filename="src/adw-alert-dialog.c"
6110+ line="2027">an alert dialog</doc>
6111+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
6112+ </instance-parameter>
6113+ <parameter name="id" transfer-ownership="none">
6114+ <doc xml:space="preserve"
6115+ filename="src/adw-alert-dialog.c"
6116+ line="2028">the response ID</doc>
6117+ <type name="utf8" c:type="const char*"/>
6118+ </parameter>
6119+ </parameters>
6120+ </method>
6121+ <method name="set_body"
6122+ c:identifier="adw_alert_dialog_set_body"
6123+ glib:set-property="body"
6124+ version="1.5">
6125+ <doc xml:space="preserve"
6126+ filename="src/adw-alert-dialog.c"
6127+ line="1613">Sets the body text of @self.</doc>
6128+ <source-position filename="src/adw-alert-dialog.h" line="76"/>
6129+ <return-value transfer-ownership="none">
6130+ <type name="none" c:type="void"/>
6131+ </return-value>
6132+ <parameters>
6133+ <instance-parameter name="self" transfer-ownership="none">
6134+ <doc xml:space="preserve"
6135+ filename="src/adw-alert-dialog.c"
6136+ line="1615">an alert dialog</doc>
6137+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
6138+ </instance-parameter>
6139+ <parameter name="body" transfer-ownership="none">
6140+ <doc xml:space="preserve"
6141+ filename="src/adw-alert-dialog.c"
6142+ line="1616">the body of @self</doc>
6143+ <type name="utf8" c:type="const char*"/>
6144+ </parameter>
6145+ </parameters>
6146+ </method>
6147+ <method name="set_body_use_markup"
6148+ c:identifier="adw_alert_dialog_set_body_use_markup"
6149+ glib:set-property="body-use-markup"
6150+ version="1.5">
6151+ <doc xml:space="preserve"
6152+ filename="src/adw-alert-dialog.c"
6153+ line="1669">Sets whether the body text of @self includes Pango markup.
64906154
6491-It is the width if the layout is horizontal, or the height if it is vertical.</doc>
6492- <source-position filename="src/adw-clamp-layout.h" line="30"/>
6155+See [func@Pango.parse_markup].</doc>
6156+ <source-position filename="src/adw-alert-dialog.h" line="82"/>
64936157 <return-value transfer-ownership="none">
64946158 <type name="none" c:type="void"/>
64956159 </return-value>
64966160 <parameters>
64976161 <instance-parameter name="self" transfer-ownership="none">
64986162 <doc xml:space="preserve"
6499- filename="src/adw-clamp-layout.c"
6500- line="419">a clamp layout</doc>
6501- <type name="ClampLayout" c:type="AdwClampLayout*"/>
6163+ filename="src/adw-alert-dialog.c"
6164+ line="1671">an alert dialog</doc>
6165+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
65026166 </instance-parameter>
6503- <parameter name="maximum_size" transfer-ownership="none">
6167+ <parameter name="use_markup" transfer-ownership="none">
65046168 <doc xml:space="preserve"
6505- filename="src/adw-clamp-layout.c"
6506- line="420">the maximum size</doc>
6507- <type name="gint" c:type="int"/>
6169+ filename="src/adw-alert-dialog.c"
6170+ line="1672">whether to use markup for body text</doc>
6171+ <type name="gboolean" c:type="gboolean"/>
65086172 </parameter>
65096173 </parameters>
65106174 </method>
6511- <method name="set_tightening_threshold"
6512- c:identifier="adw_clamp_layout_set_tightening_threshold"
6513- glib:set-property="tightening-threshold">
6514- <attribute name="org.gtk.Method.set_property"
6515- value="tightening-threshold"/>
6175+ <method name="set_close_response"
6176+ c:identifier="adw_alert_dialog_set_close_response"
6177+ glib:set-property="close-response"
6178+ version="1.5">
65166179 <doc xml:space="preserve"
6517- filename="src/adw-clamp-layout.c"
6518- line="458">Sets the size above which the children are clamped.
6180+ filename="src/adw-alert-dialog.c"
6181+ line="2367">Sets the ID of the close response of @self.
65196182
6520-Starting from this size, the layout will tighten its grip on the children,
6521-slowly allocating less and less of the available size up to the maximum
6522-allocated size. Below that threshold and below the maximum size, the children
6523-will be allocated all the available size.
6183+It will be passed to [signal@AlertDialog::response] if the dialog is closed
6184+by pressing &lt;kbd&gt;Escape&lt;/kbd&gt; or with a system action.
65246185
6525-If the threshold is greater than the maximum size to allocate to the
6526-children, they will be allocated the whole size up to the maximum. If the
6527-threshold is lower than the minimum size to allocate to the children, that
6528-size will be used as the tightening threshold.
6186+It doesn't have to correspond to any of the responses in the dialog.
65296187
6530-Effectively, tightening the grip on a child before it reaches its maximum
6531-size makes transitions to and from the maximum size smoother when resizing.</doc>
6532- <source-position filename="src/adw-clamp-layout.h" line="36"/>
6188+The default close response is `close`.</doc>
6189+ <source-position filename="src/adw-alert-dialog.h" line="154"/>
65336190 <return-value transfer-ownership="none">
65346191 <type name="none" c:type="void"/>
65356192 </return-value>
65366193 <parameters>
65376194 <instance-parameter name="self" transfer-ownership="none">
65386195 <doc xml:space="preserve"
6539- filename="src/adw-clamp-layout.c"
6540- line="460">a clamp layout</doc>
6541- <type name="ClampLayout" c:type="AdwClampLayout*"/>
6196+ filename="src/adw-alert-dialog.c"
6197+ line="2369">an alert dialog</doc>
6198+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
65426199 </instance-parameter>
6543- <parameter name="tightening_threshold" transfer-ownership="none">
6200+ <parameter name="response" transfer-ownership="none">
65446201 <doc xml:space="preserve"
6545- filename="src/adw-clamp-layout.c"
6546- line="461">the tightening threshold</doc>
6547- <type name="gint" c:type="int"/>
6202+ filename="src/adw-alert-dialog.c"
6203+ line="2370">the close response ID</doc>
6204+ <type name="utf8" c:type="const char*"/>
65486205 </parameter>
65496206 </parameters>
65506207 </method>
6551- <property name="maximum-size"
6552- writable="1"
6553- transfer-ownership="none"
6554- setter="set_maximum_size"
6555- getter="get_maximum_size"
6556- default-value="600">
6557- <attribute name="org.gtk.Property.get"
6558- value="adw_clamp_layout_get_maximum_size"/>
6559- <attribute name="org.gtk.Property.set"
6560- value="adw_clamp_layout_set_maximum_size"/>
6208+ <method name="set_default_response"
6209+ c:identifier="adw_alert_dialog_set_default_response"
6210+ glib:set-property="default-response"
6211+ version="1.5">
65616212 <doc xml:space="preserve"
6562- filename="src/adw-clamp-layout.c"
6563- line="342">The maximum size to allocate to the children.
6213+ filename="src/adw-alert-dialog.c"
6214+ line="2305">Sets the ID of the default response of @self.
65646215
6565-It is the width if the layout is horizontal, or the height if it is
6566-vertical.</doc>
6567- <type name="gint" c:type="gint"/>
6568- </property>
6569- <property name="tightening-threshold"
6570- writable="1"
6571- transfer-ownership="none"
6572- setter="set_tightening_threshold"
6573- getter="get_tightening_threshold"
6574- default-value="400">
6575- <attribute name="org.gtk.Property.get"
6576- value="adw_clamp_layout_get_tightening_threshold"/>
6577- <attribute name="org.gtk.Property.set"
6578- value="adw_clamp_layout_set_tightening_threshold"/>
6216+If set, pressing &lt;kbd&gt;Enter&lt;/kbd&gt; will activate the corresponding button.
6217+
6218+If set to `NULL` or to a non-existent response ID, pressing &lt;kbd&gt;Enter&lt;/kbd&gt;
6219+will do nothing.</doc>
6220+ <source-position filename="src/adw-alert-dialog.h" line="148"/>
6221+ <return-value transfer-ownership="none">
6222+ <type name="none" c:type="void"/>
6223+ </return-value>
6224+ <parameters>
6225+ <instance-parameter name="self" transfer-ownership="none">
6226+ <doc xml:space="preserve"
6227+ filename="src/adw-alert-dialog.c"
6228+ line="2307">an alert dialog</doc>
6229+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
6230+ </instance-parameter>
6231+ <parameter name="response"
6232+ transfer-ownership="none"
6233+ nullable="1"
6234+ allow-none="1">
6235+ <doc xml:space="preserve"
6236+ filename="src/adw-alert-dialog.c"
6237+ line="2308">the default response ID</doc>
6238+ <type name="utf8" c:type="const char*"/>
6239+ </parameter>
6240+ </parameters>
6241+ </method>
6242+ <method name="set_extra_child"
6243+ c:identifier="adw_alert_dialog_set_extra_child"
6244+ glib:set-property="extra-child"
6245+ version="1.5">
65796246 <doc xml:space="preserve"
6580- filename="src/adw-clamp-layout.c"
6581- line="355">The size above which the children are clamped.
6247+ filename="src/adw-alert-dialog.c"
6248+ line="1816">Sets the child widget of @self.
65826249
6583-Starting from this size, the layout will tighten its grip on the children,
6584-slowly allocating less and less of the available size up to the maximum
6585-allocated size. Below that threshold and below the maximum size, the
6586-children will be allocated all the available size.
6587-
6588-If the threshold is greater than the maximum size to allocate to the
6589-children, they will be allocated the whole size up to the maximum. If the
6590-threshold is lower than the minimum size to allocate to the children, that
6591-size will be used as the tightening threshold.
6592-
6593-Effectively, tightening the grip on a child before it reaches its maximum
6594-size makes transitions to and from the maximum size smoother when resizing.</doc>
6595- <type name="gint" c:type="gint"/>
6596- </property>
6597- </class>
6598- <record name="ClampLayoutClass"
6599- c:type="AdwClampLayoutClass"
6600- glib:is-gtype-struct-for="ClampLayout">
6601- <source-position filename="src/adw-clamp-layout.h" line="22"/>
6602- <field name="parent_class">
6603- <type name="Gtk.LayoutManagerClass" c:type="GtkLayoutManagerClass"/>
6604- </field>
6605- </record>
6606- <class name="ClampScrollable"
6607- c:symbol-prefix="clamp_scrollable"
6608- c:type="AdwClampScrollable"
6609- parent="Gtk.Widget"
6610- final="1"
6611- glib:type-name="AdwClampScrollable"
6612- glib:get-type="adw_clamp_scrollable_get_type"
6613- glib:type-struct="ClampScrollableClass">
6614- <doc xml:space="preserve"
6615- filename="src/adw-clamp-scrollable.c"
6616- line="13">A scrollable [class@Clamp].
6617-
6618-`AdwClampScrollable` is a variant of [class@Clamp] that implements the
6619-[iface@Gtk.Scrollable] interface.
6620-
6621-The primary use case for `AdwClampScrollable` is clamping
6622-[class@Gtk.ListView].</doc>
6623- <source-position filename="src/adw-clamp-scrollable.h" line="22"/>
6624- <implements name="Gtk.Accessible"/>
6625- <implements name="Gtk.Buildable"/>
6626- <implements name="Gtk.ConstraintTarget"/>
6627- <implements name="Gtk.Orientable"/>
6628- <implements name="Gtk.Scrollable"/>
6629- <constructor name="new" c:identifier="adw_clamp_scrollable_new">
6630- <doc xml:space="preserve"
6631- filename="src/adw-clamp-scrollable.c"
6632- line="329">Creates a new `AdwClampScrollable`.</doc>
6633- <source-position filename="src/adw-clamp-scrollable.h" line="25"/>
6250+The child widget is displayed below the heading and body.</doc>
6251+ <source-position filename="src/adw-alert-dialog.h" line="98"/>
66346252 <return-value transfer-ownership="none">
6635- <doc xml:space="preserve"
6636- filename="src/adw-clamp-scrollable.c"
6637- line="334">the newly created `AdwClampScrollable`</doc>
6638- <type name="Gtk.Widget" c:type="GtkWidget*"/>
6639- </return-value>
6640- </constructor>
6641- <method name="get_child"
6642- c:identifier="adw_clamp_scrollable_get_child"
6643- glib:get-property="child">
6644- <attribute name="org.gtk.Method.get_property" value="child"/>
6645- <doc xml:space="preserve"
6646- filename="src/adw-clamp-scrollable.c"
6647- line="342">Gets the child widget of @self.</doc>
6648- <source-position filename="src/adw-clamp-scrollable.h" line="28"/>
6649- <return-value transfer-ownership="none" nullable="1">
6650- <doc xml:space="preserve"
6651- filename="src/adw-clamp-scrollable.c"
6652- line="348">the child widget of @self</doc>
6653- <type name="Gtk.Widget" c:type="GtkWidget*"/>
6253+ <type name="none" c:type="void"/>
66546254 </return-value>
66556255 <parameters>
66566256 <instance-parameter name="self" transfer-ownership="none">
66576257 <doc xml:space="preserve"
6658- filename="src/adw-clamp-scrollable.c"
6659- line="344">a clamp scrollable</doc>
6660- <type name="ClampScrollable" c:type="AdwClampScrollable*"/>
6258+ filename="src/adw-alert-dialog.c"
6259+ line="1818">an alert dialog</doc>
6260+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
66616261 </instance-parameter>
6262+ <parameter name="child"
6263+ transfer-ownership="none"
6264+ nullable="1"
6265+ allow-none="1">
6266+ <doc xml:space="preserve"
6267+ filename="src/adw-alert-dialog.c"
6268+ line="1819">the child widget</doc>
6269+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
6270+ </parameter>
66626271 </parameters>
66636272 </method>
6664- <method name="get_maximum_size"
6665- c:identifier="adw_clamp_scrollable_get_maximum_size"
6666- glib:get-property="maximum-size">
6667- <attribute name="org.gtk.Method.get_property" value="maximum-size"/>
6273+ <method name="set_heading"
6274+ c:identifier="adw_alert_dialog_set_heading"
6275+ glib:set-property="heading"
6276+ version="1.5">
66686277 <doc xml:space="preserve"
6669- filename="src/adw-clamp-scrollable.c"
6670- line="410">Gets the maximum size allocated to the child.</doc>
6671- <source-position filename="src/adw-clamp-scrollable.h" line="34"/>
6278+ filename="src/adw-alert-dialog.c"
6279+ line="1402">Sets the heading of @self.</doc>
6280+ <source-position filename="src/adw-alert-dialog.h" line="54"/>
66726281 <return-value transfer-ownership="none">
6673- <doc xml:space="preserve"
6674- filename="src/adw-clamp-scrollable.c"
6675- line="416">the maximum size to allocate to the child</doc>
6676- <type name="gint" c:type="int"/>
6282+ <type name="none" c:type="void"/>
66776283 </return-value>
66786284 <parameters>
66796285 <instance-parameter name="self" transfer-ownership="none">
66806286 <doc xml:space="preserve"
6681- filename="src/adw-clamp-scrollable.c"
6682- line="412">a clamp scrollable</doc>
6683- <type name="ClampScrollable" c:type="AdwClampScrollable*"/>
6287+ filename="src/adw-alert-dialog.c"
6288+ line="1404">an alert dialog</doc>
6289+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
66846290 </instance-parameter>
6291+ <parameter name="heading"
6292+ transfer-ownership="none"
6293+ nullable="1"
6294+ allow-none="1">
6295+ <doc xml:space="preserve"
6296+ filename="src/adw-alert-dialog.c"
6297+ line="1405">the heading of @self</doc>
6298+ <type name="utf8" c:type="const char*"/>
6299+ </parameter>
66856300 </parameters>
66866301 </method>
6687- <method name="get_tightening_threshold"
6688- c:identifier="adw_clamp_scrollable_get_tightening_threshold"
6689- glib:get-property="tightening-threshold">
6690- <attribute name="org.gtk.Method.get_property"
6691- value="tightening-threshold"/>
6302+ <method name="set_heading_use_markup"
6303+ c:identifier="adw_alert_dialog_set_heading_use_markup"
6304+ glib:set-property="heading-use-markup"
6305+ version="1.5">
66926306 <doc xml:space="preserve"
6693- filename="src/adw-clamp-scrollable.c"
6694- line="457">Gets the size above which the child is clamped.</doc>
6695- <source-position filename="src/adw-clamp-scrollable.h" line="40"/>
6307+ filename="src/adw-alert-dialog.c"
6308+ line="1462">Sets whether the heading of @self includes Pango markup.
6309+
6310+See [func@Pango.parse_markup].</doc>
6311+ <source-position filename="src/adw-alert-dialog.h" line="60"/>
66966312 <return-value transfer-ownership="none">
6697- <doc xml:space="preserve"
6698- filename="src/adw-clamp-scrollable.c"
6699- line="463">the size above which the child is clamped</doc>
6700- <type name="gint" c:type="int"/>
6313+ <type name="none" c:type="void"/>
67016314 </return-value>
67026315 <parameters>
67036316 <instance-parameter name="self" transfer-ownership="none">
67046317 <doc xml:space="preserve"
6705- filename="src/adw-clamp-scrollable.c"
6706- line="459">a clamp scrollable</doc>
6707- <type name="ClampScrollable" c:type="AdwClampScrollable*"/>
6318+ filename="src/adw-alert-dialog.c"
6319+ line="1464">an alert dialog</doc>
6320+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
67086321 </instance-parameter>
6322+ <parameter name="use_markup" transfer-ownership="none">
6323+ <doc xml:space="preserve"
6324+ filename="src/adw-alert-dialog.c"
6325+ line="1465">whether to use markup for heading</doc>
6326+ <type name="gboolean" c:type="gboolean"/>
6327+ </parameter>
67096328 </parameters>
67106329 </method>
6711- <method name="set_child"
6712- c:identifier="adw_clamp_scrollable_set_child"
6713- glib:set-property="child">
6714- <attribute name="org.gtk.Method.set_property" value="child"/>
6330+ <method name="set_prefer_wide_layout"
6331+ c:identifier="adw_alert_dialog_set_prefer_wide_layout"
6332+ glib:set-property="prefer-wide-layout"
6333+ version="1.6">
67156334 <doc xml:space="preserve"
6716- filename="src/adw-clamp-scrollable.c"
6717- line="358">Sets the child widget of @self.</doc>
6718- <source-position filename="src/adw-clamp-scrollable.h" line="30"/>
6335+ filename="src/adw-alert-dialog.c"
6336+ line="1873">Sets whether @self prefers wide layout.
6337+
6338+Prefer horizontal button layout when possible, and wider dialog width
6339+otherwise.</doc>
6340+ <source-position filename="src/adw-alert-dialog.h" line="104"/>
67196341 <return-value transfer-ownership="none">
67206342 <type name="none" c:type="void"/>
67216343 </return-value>
67226344 <parameters>
67236345 <instance-parameter name="self" transfer-ownership="none">
67246346 <doc xml:space="preserve"
6725- filename="src/adw-clamp-scrollable.c"
6726- line="360">a clamp scrollable</doc>
6727- <type name="ClampScrollable" c:type="AdwClampScrollable*"/>
6347+ filename="src/adw-alert-dialog.c"
6348+ line="1875">an alert dialog</doc>
6349+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
67286350 </instance-parameter>
6729- <parameter name="child"
6730- transfer-ownership="none"
6731- nullable="1"
6732- allow-none="1">
6351+ <parameter name="prefer_wide_layout" transfer-ownership="none">
67336352 <doc xml:space="preserve"
6734- filename="src/adw-clamp-scrollable.c"
6735- line="361">the child widget</doc>
6736- <type name="Gtk.Widget" c:type="GtkWidget*"/>
6353+ filename="src/adw-alert-dialog.c"
6354+ line="1876">whether to prefer wide layout</doc>
6355+ <type name="gboolean" c:type="gboolean"/>
67376356 </parameter>
67386357 </parameters>
67396358 </method>
6740- <method name="set_maximum_size"
6741- c:identifier="adw_clamp_scrollable_set_maximum_size"
6742- glib:set-property="maximum-size">
6743- <attribute name="org.gtk.Method.set_property" value="maximum-size"/>
6359+ <method name="set_response_appearance"
6360+ c:identifier="adw_alert_dialog_set_response_appearance"
6361+ version="1.5">
67446362 <doc xml:space="preserve"
6745- filename="src/adw-clamp-scrollable.c"
6746- line="430">Sets the maximum size allocated to the child.
6363+ filename="src/adw-alert-dialog.c"
6364+ line="2153">Sets the appearance for @response.
67476365
6748-It is the width if the clamp is horizontal, or the height if it is vertical.</doc>
6749- <source-position filename="src/adw-clamp-scrollable.h" line="36"/>
6366+&lt;picture&gt;
6367+ &lt;source srcset="alert-dialog-appearance-dark.png" media="(prefers-color-scheme: dark)"&gt;
6368+ &lt;img src="alert-dialog-appearance.png" alt="alert-dialog-appearance"&gt;
6369+&lt;/picture&gt;
6370+
6371+Use `ADW_RESPONSE_SUGGESTED` to mark important responses such as the
6372+affirmative action, like the Save button in the example.
6373+
6374+Use `ADW_RESPONSE_DESTRUCTIVE` to draw attention to the potentially damaging
6375+consequences of using @response. This appearance acts as a warning to the
6376+user. The Discard button in the example is using this appearance.
6377+
6378+The default appearance is `ADW_RESPONSE_DEFAULT`.
6379+
6380+Negative responses like Cancel or Close should use the default appearance.</doc>
6381+ <source-position filename="src/adw-alert-dialog.h" line="133"/>
67506382 <return-value transfer-ownership="none">
67516383 <type name="none" c:type="void"/>
67526384 </return-value>
67536385 <parameters>
67546386 <instance-parameter name="self" transfer-ownership="none">
67556387 <doc xml:space="preserve"
6756- filename="src/adw-clamp-scrollable.c"
6757- line="432">a clamp scrollable</doc>
6758- <type name="ClampScrollable" c:type="AdwClampScrollable*"/>
6388+ filename="src/adw-alert-dialog.c"
6389+ line="2155">an alert dialog</doc>
6390+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
67596391 </instance-parameter>
6760- <parameter name="maximum_size" transfer-ownership="none">
6392+ <parameter name="response" transfer-ownership="none">
67616393 <doc xml:space="preserve"
6762- filename="src/adw-clamp-scrollable.c"
6763- line="433">the maximum size</doc>
6764- <type name="gint" c:type="int"/>
6394+ filename="src/adw-alert-dialog.c"
6395+ line="2156">a response ID</doc>
6396+ <type name="utf8" c:type="const char*"/>
6397+ </parameter>
6398+ <parameter name="appearance" transfer-ownership="none">
6399+ <doc xml:space="preserve"
6400+ filename="src/adw-alert-dialog.c"
6401+ line="2157">appearance for @response</doc>
6402+ <type name="ResponseAppearance" c:type="AdwResponseAppearance"/>
67656403 </parameter>
67666404 </parameters>
67676405 </method>
6768- <method name="set_tightening_threshold"
6769- c:identifier="adw_clamp_scrollable_set_tightening_threshold"
6770- glib:set-property="tightening-threshold">
6771- <attribute name="org.gtk.Method.set_property"
6772- value="tightening-threshold"/>
6406+ <method name="set_response_enabled"
6407+ c:identifier="adw_alert_dialog_set_response_enabled"
6408+ version="1.5">
67736409 <doc xml:space="preserve"
6774- filename="src/adw-clamp-scrollable.c"
6775- line="477">Sets the size above which the child is clamped.
6410+ filename="src/adw-alert-dialog.c"
6411+ line="2238">Sets whether @response is enabled.
67766412
6777-Starting from this size, the clamp will tighten its grip on the child, slowly
6778-allocating less and less of the available size up to the maximum allocated
6779-size. Below that threshold and below the maximum width, the child will be
6780-allocated all the available size.
6413+If @response is not enabled, the corresponding button will have
6414+[property@Gtk.Widget:sensitive] set to `FALSE` and it can't be activated as
6415+a default response.
67816416
6782-If the threshold is greater than the maximum size to allocate to the child,
6783-the child will be allocated all the width up to the maximum. If the threshold
6784-is lower than the minimum size to allocate to the child, that size will be
6785-used as the tightening threshold.
6417+@response can still be used as [property@AlertDialog:close-response] while
6418+it's not enabled.
67866419
6787-Effectively, tightening the grip on the child before it reaches its maximum
6788-size makes transitions to and from the maximum size smoother when resizing.</doc>
6789- <source-position filename="src/adw-clamp-scrollable.h" line="42"/>
6420+Responses are enabled by default.</doc>
6421+ <source-position filename="src/adw-alert-dialog.h" line="141"/>
67906422 <return-value transfer-ownership="none">
67916423 <type name="none" c:type="void"/>
67926424 </return-value>
67936425 <parameters>
67946426 <instance-parameter name="self" transfer-ownership="none">
67956427 <doc xml:space="preserve"
6796- filename="src/adw-clamp-scrollable.c"
6797- line="479">a clamp scrollable</doc>
6798- <type name="ClampScrollable" c:type="AdwClampScrollable*"/>
6428+ filename="src/adw-alert-dialog.c"
6429+ line="2240">an alert dialog</doc>
6430+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
67996431 </instance-parameter>
6800- <parameter name="tightening_threshold" transfer-ownership="none">
6432+ <parameter name="response" transfer-ownership="none">
68016433 <doc xml:space="preserve"
6802- filename="src/adw-clamp-scrollable.c"
6803- line="480">the tightening threshold</doc>
6804- <type name="gint" c:type="int"/>
6434+ filename="src/adw-alert-dialog.c"
6435+ line="2241">a response ID</doc>
6436+ <type name="utf8" c:type="const char*"/>
6437+ </parameter>
6438+ <parameter name="enabled" transfer-ownership="none">
6439+ <doc xml:space="preserve"
6440+ filename="src/adw-alert-dialog.c"
6441+ line="2242">whether to enable @response</doc>
6442+ <type name="gboolean" c:type="gboolean"/>
68056443 </parameter>
68066444 </parameters>
68076445 </method>
6808- <property name="child"
6446+ <method name="set_response_label"
6447+ c:identifier="adw_alert_dialog_set_response_label"
6448+ version="1.5">
6449+ <doc xml:space="preserve"
6450+ filename="src/adw-alert-dialog.c"
6451+ line="2093">Sets the label of @response to @label.
6452+
6453+Labels are displayed on the dialog buttons. An embedded underline in @label
6454+indicates a mnemonic.</doc>
6455+ <source-position filename="src/adw-alert-dialog.h" line="125"/>
6456+ <return-value transfer-ownership="none">
6457+ <type name="none" c:type="void"/>
6458+ </return-value>
6459+ <parameters>
6460+ <instance-parameter name="self" transfer-ownership="none">
6461+ <doc xml:space="preserve"
6462+ filename="src/adw-alert-dialog.c"
6463+ line="2095">an alert dialog</doc>
6464+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
6465+ </instance-parameter>
6466+ <parameter name="response" transfer-ownership="none">
6467+ <doc xml:space="preserve"
6468+ filename="src/adw-alert-dialog.c"
6469+ line="2096">a response ID</doc>
6470+ <type name="utf8" c:type="const char*"/>
6471+ </parameter>
6472+ <parameter name="label" transfer-ownership="none">
6473+ <doc xml:space="preserve"
6474+ filename="src/adw-alert-dialog.c"
6475+ line="2097">the label of @response</doc>
6476+ <type name="utf8" c:type="const char*"/>
6477+ </parameter>
6478+ </parameters>
6479+ </method>
6480+ <property name="body"
6481+ version="1.5"
68096482 writable="1"
68106483 transfer-ownership="none"
6811- setter="set_child"
6812- getter="get_child">
6813- <attribute name="org.gtk.Property.get"
6814- value="adw_clamp_scrollable_get_child"/>
6815- <attribute name="org.gtk.Property.set"
6816- value="adw_clamp_scrollable_set_child"/>
6484+ setter="set_body"
6485+ getter="get_body">
68176486 <doc xml:space="preserve"
6818- filename="src/adw-clamp-scrollable.c"
6819- line="253">The child widget of the `AdwClampScrollable`.</doc>
6820- <type name="Gtk.Widget"/>
6487+ filename="src/adw-alert-dialog.c"
6488+ line="915">The body text of the dialog.</doc>
6489+ <type name="utf8" c:type="gchar*"/>
68216490 </property>
6822- <property name="maximum-size"
6491+ <property name="body-use-markup"
6492+ version="1.5"
68236493 writable="1"
68246494 transfer-ownership="none"
6825- setter="set_maximum_size"
6826- getter="get_maximum_size"
6827- default-value="600">
6828- <attribute name="org.gtk.Property.get"
6829- value="adw_clamp_scrollable_get_maximum_size"/>
6830- <attribute name="org.gtk.Property.set"
6831- value="adw_clamp_scrollable_set_maximum_size"/>
6495+ setter="set_body_use_markup"
6496+ getter="get_body_use_markup"
6497+ default-value="FALSE">
68326498 <doc xml:space="preserve"
6833- filename="src/adw-clamp-scrollable.c"
6834- line="263">The maximum size allocated to the child.
6499+ filename="src/adw-alert-dialog.c"
6500+ line="927">Whether the body text includes Pango markup.
68356501
6836-It is the width if the clamp is horizontal, or the height if it is vertical.</doc>
6837- <type name="gint" c:type="gint"/>
6502+See [func@Pango.parse_markup].</doc>
6503+ <type name="gboolean" c:type="gboolean"/>
68386504 </property>
6839- <property name="tightening-threshold"
6505+ <property name="close-response"
6506+ version="1.5"
68406507 writable="1"
68416508 transfer-ownership="none"
6842- setter="set_tightening_threshold"
6843- getter="get_tightening_threshold"
6844- default-value="400">
6845- <attribute name="org.gtk.Property.get"
6846- value="adw_clamp_scrollable_get_tightening_threshold"/>
6847- <attribute name="org.gtk.Property.set"
6848- value="adw_clamp_scrollable_set_tightening_threshold"/>
6509+ setter="set_close_response"
6510+ getter="get_close_response"
6511+ default-value="close">
68496512 <doc xml:space="preserve"
6850- filename="src/adw-clamp-scrollable.c"
6851- line="275">The size above which the child is clamped.
6513+ filename="src/adw-alert-dialog.c"
6514+ line="987">The ID of the close response.
68526515
6853-Starting from this size, the clamp will tighten its grip on the child,
6854-slowly allocating less and less of the available size up to the maximum
6855-allocated size. Below that threshold and below the maximum width, the child
6856-will be allocated all the available size.
6516+It will be passed to [signal@AlertDialog::response] if the dialog is
6517+closed by pressing &lt;kbd&gt;Escape&lt;/kbd&gt; or with a system action.
68576518
6858-If the threshold is greater than the maximum size to allocate to the child,
6859-the child will be allocated all the width up to the maximum.
6860-If the threshold is lower than the minimum size to allocate to the child,
6861-that size will be used as the tightening threshold.
6519+It doesn't have to correspond to any of the responses in the dialog.
68626520
6863-Effectively, tightening the grip on the child before it reaches its maximum
6864-size makes transitions to and from the maximum size smoother when resizing.</doc>
6865- <type name="gint" c:type="gint"/>
6521+The default close response is `close`.</doc>
6522+ <type name="utf8" c:type="gchar*"/>
68666523 </property>
6867- </class>
6868- <record name="ClampScrollableClass"
6869- c:type="AdwClampScrollableClass"
6870- glib:is-gtype-struct-for="ClampScrollable">
6871- <source-position filename="src/adw-clamp-scrollable.h" line="22"/>
6872- <field name="parent_class">
6873- <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
6874- </field>
6875- </record>
6876- <enumeration name="ColorScheme"
6877- glib:type-name="AdwColorScheme"
6878- glib:get-type="adw_color_scheme_get_type"
6879- c:type="AdwColorScheme">
6880- <doc xml:space="preserve"
6881- filename="src/adw-style-manager.c"
6882- line="19">Application color schemes for [property@StyleManager:color-scheme].</doc>
6883- <member name="default"
6884- value="0"
6885- c:identifier="ADW_COLOR_SCHEME_DEFAULT"
6886- glib:nick="default"
6887- glib:name="ADW_COLOR_SCHEME_DEFAULT">
6524+ <property name="default-response"
6525+ version="1.5"
6526+ writable="1"
6527+ transfer-ownership="none"
6528+ setter="set_default_response"
6529+ getter="get_default_response"
6530+ default-value="NULL">
68886531 <doc xml:space="preserve"
6889- filename="src/adw-style-manager.c"
6890- line="21">Inherit the parent color-scheme. When set on the
6891- `AdwStyleManager` returned by [func@StyleManager.get_default], it's
6892- equivalent to `ADW_COLOR_SCHEME_PREFER_LIGHT`.</doc>
6893- </member>
6894- <member name="force_light"
6895- value="1"
6896- c:identifier="ADW_COLOR_SCHEME_FORCE_LIGHT"
6897- glib:nick="force-light"
6898- glib:name="ADW_COLOR_SCHEME_FORCE_LIGHT">
6532+ filename="src/adw-alert-dialog.c"
6533+ line="970">The response ID of the default response.
6534+
6535+If set, pressing &lt;kbd&gt;Enter&lt;/kbd&gt; will activate the corresponding button.
6536+
6537+If set to `NULL` or a non-existent response ID, pressing &lt;kbd&gt;Enter&lt;/kbd&gt;
6538+will do nothing.</doc>
6539+ <type name="utf8" c:type="gchar*"/>
6540+ </property>
6541+ <property name="extra-child"
6542+ version="1.5"
6543+ writable="1"
6544+ transfer-ownership="none"
6545+ setter="set_extra_child"
6546+ getter="get_extra_child">
68996547 <doc xml:space="preserve"
6900- filename="src/adw-style-manager.c"
6901- line="24">Always use light appearance.</doc>
6902- </member>
6903- <member name="prefer_light"
6904- value="2"
6905- c:identifier="ADW_COLOR_SCHEME_PREFER_LIGHT"
6906- glib:nick="prefer-light"
6907- glib:name="ADW_COLOR_SCHEME_PREFER_LIGHT">
6548+ filename="src/adw-alert-dialog.c"
6549+ line="941">The child widget.
6550+
6551+Displayed below the heading and body.</doc>
6552+ <type name="Gtk.Widget"/>
6553+ </property>
6554+ <property name="heading"
6555+ version="1.5"
6556+ writable="1"
6557+ transfer-ownership="none"
6558+ setter="set_heading"
6559+ getter="get_heading">
69086560 <doc xml:space="preserve"
6909- filename="src/adw-style-manager.c"
6910- line="25">Use light appearance unless the system
6911- prefers dark colors.</doc>
6912- </member>
6913- <member name="prefer_dark"
6914- value="3"
6915- c:identifier="ADW_COLOR_SCHEME_PREFER_DARK"
6916- glib:nick="prefer-dark"
6917- glib:name="ADW_COLOR_SCHEME_PREFER_DARK">
6561+ filename="src/adw-alert-dialog.c"
6562+ line="889">The heading of the dialog.</doc>
6563+ <type name="utf8" c:type="gchar*"/>
6564+ </property>
6565+ <property name="heading-use-markup"
6566+ version="1.5"
6567+ writable="1"
6568+ transfer-ownership="none"
6569+ setter="set_heading_use_markup"
6570+ getter="get_heading_use_markup"
6571+ default-value="FALSE">
69186572 <doc xml:space="preserve"
6919- filename="src/adw-style-manager.c"
6920- line="27">Use dark appearance unless the system prefers
6921- prefers light colors.</doc>
6922- </member>
6923- <member name="force_dark"
6924- value="4"
6925- c:identifier="ADW_COLOR_SCHEME_FORCE_DARK"
6926- glib:nick="force-dark"
6927- glib:name="ADW_COLOR_SCHEME_FORCE_DARK">
6573+ filename="src/adw-alert-dialog.c"
6574+ line="901">Whether the heading includes Pango markup.
6575+
6576+See [func@Pango.parse_markup].</doc>
6577+ <type name="gboolean" c:type="gboolean"/>
6578+ </property>
6579+ <property name="prefer-wide-layout"
6580+ version="1.6"
6581+ writable="1"
6582+ transfer-ownership="none"
6583+ setter="set_prefer_wide_layout"
6584+ getter="get_prefer_wide_layout"
6585+ default-value="FALSE">
69286586 <doc xml:space="preserve"
6929- filename="src/adw-style-manager.c"
6930- line="29">Always use dark appearance.</doc>
6931- </member>
6932- </enumeration>
6933- <class name="ComboRow"
6934- c:symbol-prefix="combo_row"
6935- c:type="AdwComboRow"
6936- parent="ActionRow"
6937- glib:type-name="AdwComboRow"
6938- glib:get-type="adw_combo_row_get_type"
6939- glib:type-struct="ComboRowClass">
6940- <doc xml:space="preserve"
6941- filename="src/adw-combo-row.c"
6942- line="16">A [class@Gtk.ListBoxRow] used to choose from a list of items.
6587+ filename="src/adw-alert-dialog.c"
6588+ line="955">Whether to prefer wide layout.
69436589
6944-&lt;picture&gt;
6945- &lt;source srcset="combo-row-dark.png" media="(prefers-color-scheme: dark)"&gt;
6946- &lt;img src="combo-row.png" alt="combo-row"&gt;
6947-&lt;/picture&gt;
6590+Prefer horizontal button layout when possible, and wider dialog width
6591+otherwise.</doc>
6592+ <type name="gboolean" c:type="gboolean"/>
6593+ </property>
6594+ <field name="parent_instance">
6595+ <type name="Dialog" c:type="AdwDialog"/>
6596+ </field>
6597+ <glib:signal name="response" when="last" detailed="1" version="1.5">
6598+ <doc xml:space="preserve"
6599+ filename="src/adw-alert-dialog.c"
6600+ line="1008">This signal is emitted when the dialog is closed.
69486601
6949-The `AdwComboRow` widget allows the user to choose from a list of valid
6950-choices. The row displays the selected choice. When activated, the row
6951-displays a popover which allows the user to make a new choice.
6602+@response will be set to the response ID of the button that had been
6603+activated.
69526604
6953-Example of an `AdwComboRow` UI definition:
6954-```xml
6955-&lt;object class="AdwComboRow"&gt;
6956- &lt;property name="title" translatable="yes"&gt;Combo Row&lt;/property&gt;
6957- &lt;property name="model"&gt;
6958- &lt;object class="GtkStringList"&gt;
6959- &lt;items&gt;
6960- &lt;item translatable="yes"&gt;Foo&lt;/item&gt;
6961- &lt;item translatable="yes"&gt;Bar&lt;/item&gt;
6962- &lt;item translatable="yes"&gt;Baz&lt;/item&gt;
6963- &lt;/items&gt;
6964- &lt;/object&gt;
6965- &lt;/property&gt;
6966-&lt;/object&gt;
6967-```
6605+if the dialog was closed by pressing &lt;kbd&gt;Escape&lt;/kbd&gt; or with a system
6606+action, @response will be set to the value of
6607+[property@AlertDialog:close-response].</doc>
6608+ <return-value transfer-ownership="none">
6609+ <type name="none" c:type="void"/>
6610+ </return-value>
6611+ <parameters>
6612+ <parameter name="response" transfer-ownership="none">
6613+ <doc xml:space="preserve"
6614+ filename="src/adw-alert-dialog.c"
6615+ line="1011">the response ID</doc>
6616+ <type name="utf8" c:type="gchar*"/>
6617+ </parameter>
6618+ </parameters>
6619+ </glib:signal>
6620+ </class>
6621+ <record name="AlertDialogClass"
6622+ c:type="AdwAlertDialogClass"
6623+ glib:is-gtype-struct-for="AlertDialog">
6624+ <source-position filename="src/adw-alert-dialog.h" line="45"/>
6625+ <field name="parent_class">
6626+ <type name="DialogClass" c:type="AdwDialogClass"/>
6627+ </field>
6628+ <field name="response">
6629+ <callback name="response">
6630+ <source-position filename="src/adw-alert-dialog.h" line="40"/>
6631+ <return-value transfer-ownership="none">
6632+ <type name="none" c:type="void"/>
6633+ </return-value>
6634+ <parameters>
6635+ <parameter name="self" transfer-ownership="none">
6636+ <type name="AlertDialog" c:type="AdwAlertDialog*"/>
6637+ </parameter>
6638+ <parameter name="response" transfer-ownership="none">
6639+ <type name="utf8" c:type="const char*"/>
6640+ </parameter>
6641+ </parameters>
6642+ </callback>
6643+ </field>
6644+ <field name="padding" readable="0" private="1">
6645+ <array zero-terminated="0" fixed-size="4">
6646+ <type name="gpointer" c:type="gpointer"/>
6647+ </array>
6648+ </field>
6649+ </record>
6650+ <class name="Animation"
6651+ c:symbol-prefix="animation"
6652+ c:type="AdwAnimation"
6653+ parent="GObject.Object"
6654+ abstract="1"
6655+ glib:type-name="AdwAnimation"
6656+ glib:get-type="adw_animation_get_type"
6657+ glib:type-struct="AnimationClass">
6658+ <doc xml:space="preserve"
6659+ filename="src/adw-animation.c"
6660+ line="16">A base class for animations.
69686661
6969-The [property@ComboRow:selected] and [property@ComboRow:selected-item]
6970-properties can be used to keep track of the selected item and react to their
6971-changes.
6662+`AdwAnimation` represents an animation on a widget. It has a target that
6663+provides a value to animate, and a state indicating whether the
6664+animation hasn't been started yet, is playing, paused or finished.
69726665
6973-`AdwComboRow` mirrors [class@Gtk.DropDown], see that widget for details.
6666+Currently there are two concrete animation types:
6667+[class@TimedAnimation] and [class@SpringAnimation].
69746668
6975-`AdwComboRow` is [property@Gtk.ListBoxRow:activatable] if a model is set.
6669+`AdwAnimation` will automatically skip the animation if
6670+[property@Animation:widget] is unmapped, or if
6671+[property@Gtk.Settings:gtk-enable-animations] is `FALSE`.
69766672
6977-## CSS nodes
6673+The [signal@Animation::done] signal can be used to perform an action after
6674+the animation ends, for example hiding a widget after animating its
6675+[property@Gtk.Widget:opacity] to 0.
69786676
6979-`AdwComboRow` has a main CSS node with name `row` and the `.combo` style
6980-class.
6677+`AdwAnimation` will be kept alive while the animation is playing. As such,
6678+it's safe to create an animation, start it and immediately unref it:
6679+A fire-and-forget animation:
69816680
6982-Its popover has the node named `popover` with the `.menu` style class, it
6983-contains a [class@Gtk.ScrolledWindow], which in turn contains a
6984-[class@Gtk.ListView], both are accessible via their regular nodes.
6681+```c
6682+static void
6683+animation_cb (double value,
6684+ MyObject *self)
6685+{
6686+ // Do something with @value
6687+}
69856688
6986-## Accessibility
6689+static void
6690+my_object_animate (MyObject *self)
6691+{
6692+ AdwAnimationTarget *target =
6693+ adw_callback_animation_target_new ((AdwAnimationTargetFunc) animation_cb,
6694+ self, NULL);
6695+ g_autoptr (AdwAnimation) animation =
6696+ adw_timed_animation_new (widget, 0, 1, 250, target);
69876697
6988-`AdwComboRow` uses the `GTK_ACCESSIBLE_ROLE_COMBO_BOX` role.</doc>
6989- <source-position filename="src/adw-combo-row.h" line="35"/>
6990- <implements name="Gtk.Accessible"/>
6991- <implements name="Gtk.Actionable"/>
6992- <implements name="Gtk.Buildable"/>
6993- <implements name="Gtk.ConstraintTarget"/>
6994- <constructor name="new" c:identifier="adw_combo_row_new">
6698+ adw_animation_play (animation);
6699+}
6700+```
6701+
6702+If there's a chance the previous animation for the same target hasn't yet
6703+finished, the previous animation should be stopped first, or the existing
6704+`AdwAnimation` object can be reused.</doc>
6705+ <source-position filename="src/adw-animation.h" line="36"/>
6706+ <method name="get_follow_enable_animations_setting"
6707+ c:identifier="adw_animation_get_follow_enable_animations_setting"
6708+ glib:get-property="follow-enable-animations-setting"
6709+ version="1.3">
69956710 <doc xml:space="preserve"
6996- filename="src/adw-combo-row.c"
6997- line="553">Creates a new `AdwComboRow`.</doc>
6998- <source-position filename="src/adw-combo-row.h" line="38"/>
6711+ filename="src/adw-animation.c"
6712+ line="762">Gets whether @self should be skipped when animations are globally disabled.</doc>
6713+ <source-position filename="src/adw-animation.h" line="72"/>
69996714 <return-value transfer-ownership="none">
70006715 <doc xml:space="preserve"
7001- filename="src/adw-combo-row.c"
7002- line="558">the newly created `AdwComboRow`</doc>
7003- <type name="Gtk.Widget" c:type="GtkWidget*"/>
7004- </return-value>
7005- </constructor>
7006- <method name="get_expression"
7007- c:identifier="adw_combo_row_get_expression"
7008- glib:get-property="expression">
7009- <attribute name="org.gtk.Method.get_property" value="expression"/>
7010- <doc xml:space="preserve"
7011- filename="src/adw-combo-row.c"
7012- line="825">Gets the expression used to obtain strings from items.</doc>
7013- <source-position filename="src/adw-combo-row.h" line="68"/>
7014- <return-value transfer-ownership="none" nullable="1">
7015- <doc xml:space="preserve"
7016- filename="src/adw-combo-row.c"
7017- line="831">the expression used to obtain strings from items</doc>
7018- <type name="Gtk.Expression" c:type="GtkExpression*"/>
6716+ filename="src/adw-animation.c"
6717+ line="768">whether to follow the global setting</doc>
6718+ <type name="gboolean" c:type="gboolean"/>
70196719 </return-value>
70206720 <parameters>
70216721 <instance-parameter name="self" transfer-ownership="none">
70226722 <doc xml:space="preserve"
7023- filename="src/adw-combo-row.c"
7024- line="827">a combo row</doc>
7025- <type name="ComboRow" c:type="AdwComboRow*"/>
6723+ filename="src/adw-animation.c"
6724+ line="764">an animation</doc>
6725+ <type name="Animation" c:type="AdwAnimation*"/>
70266726 </instance-parameter>
70276727 </parameters>
70286728 </method>
7029- <method name="get_factory"
7030- c:identifier="adw_combo_row_get_factory"
7031- glib:get-property="factory">
7032- <attribute name="org.gtk.Method.get_property" value="factory"/>
6729+ <method name="get_state"
6730+ c:identifier="adw_animation_get_state"
6731+ glib:get-property="state">
70336732 <doc xml:space="preserve"
7034- filename="src/adw-combo-row.c"
7035- line="722">Gets the factory for populating list items.</doc>
7036- <source-position filename="src/adw-combo-row.h" line="56"/>
7037- <return-value transfer-ownership="none" nullable="1">
6733+ filename="src/adw-animation.c"
6734+ line="549">Gets the current value of @self.
6735+
6736+The state indicates whether @self is currently playing, paused, finished or
6737+hasn't been started yet.</doc>
6738+ <source-position filename="src/adw-animation.h" line="58"/>
6739+ <return-value transfer-ownership="none">
70386740 <doc xml:space="preserve"
7039- filename="src/adw-combo-row.c"
7040- line="728">the factory in use</doc>
7041- <type name="Gtk.ListItemFactory" c:type="GtkListItemFactory*"/>
6741+ filename="src/adw-animation.c"
6742+ line="558">the animation value</doc>
6743+ <type name="AnimationState" c:type="AdwAnimationState"/>
70426744 </return-value>
70436745 <parameters>
70446746 <instance-parameter name="self" transfer-ownership="none">
70456747 <doc xml:space="preserve"
7046- filename="src/adw-combo-row.c"
7047- line="724">a combo row</doc>
7048- <type name="ComboRow" c:type="AdwComboRow*"/>
6748+ filename="src/adw-animation.c"
6749+ line="551">an animation</doc>
6750+ <type name="Animation" c:type="AdwAnimation*"/>
70496751 </instance-parameter>
70506752 </parameters>
70516753 </method>
7052- <method name="get_list_factory"
7053- c:identifier="adw_combo_row_get_list_factory"
7054- glib:get-property="list-factory">
7055- <attribute name="org.gtk.Method.get_property" value="list-factory"/>
6754+ <method name="get_target"
6755+ c:identifier="adw_animation_get_target"
6756+ glib:get-property="target">
70566757 <doc xml:space="preserve"
7057- filename="src/adw-combo-row.c"
7058- line="774">Gets the factory for populating list items in the popup.</doc>
7059- <source-position filename="src/adw-combo-row.h" line="62"/>
7060- <return-value transfer-ownership="none" nullable="1">
6758+ filename="src/adw-animation.c"
6759+ line="483">Gets the target @self animates.</doc>
6760+ <source-position filename="src/adw-animation.h" line="49"/>
6761+ <return-value transfer-ownership="none">
70616762 <doc xml:space="preserve"
7062- filename="src/adw-combo-row.c"
7063- line="780">the factory in use</doc>
7064- <type name="Gtk.ListItemFactory" c:type="GtkListItemFactory*"/>
6763+ filename="src/adw-animation.c"
6764+ line="489">the animation target</doc>
6765+ <type name="AnimationTarget" c:type="AdwAnimationTarget*"/>
70656766 </return-value>
70666767 <parameters>
70676768 <instance-parameter name="self" transfer-ownership="none">
70686769 <doc xml:space="preserve"
7069- filename="src/adw-combo-row.c"
7070- line="776">a combo row</doc>
7071- <type name="ComboRow" c:type="AdwComboRow*"/>
6770+ filename="src/adw-animation.c"
6771+ line="485">an animation</doc>
6772+ <type name="Animation" c:type="AdwAnimation*"/>
70726773 </instance-parameter>
70736774 </parameters>
70746775 </method>
7075- <method name="get_model"
7076- c:identifier="adw_combo_row_get_model"
7077- glib:get-property="model">
7078- <attribute name="org.gtk.Method.get_property" value="model"/>
6776+ <method name="get_value"
6777+ c:identifier="adw_animation_get_value"
6778+ glib:get-property="value">
70796779 <doc xml:space="preserve"
7080- filename="src/adw-combo-row.c"
7081- line="640">Gets the model that provides the displayed items.</doc>
7082- <source-position filename="src/adw-combo-row.h" line="41"/>
7083- <return-value transfer-ownership="none" nullable="1">
6780+ filename="src/adw-animation.c"
6781+ line="529">Gets the current value of @self.</doc>
6782+ <source-position filename="src/adw-animation.h" line="55"/>
6783+ <return-value transfer-ownership="none">
70846784 <doc xml:space="preserve"
7085- filename="src/adw-combo-row.c"
7086- line="646">The model in use</doc>
7087- <type name="Gio.ListModel" c:type="GListModel*"/>
6785+ filename="src/adw-animation.c"
6786+ line="535">the current value</doc>
6787+ <type name="gdouble" c:type="double"/>
70886788 </return-value>
70896789 <parameters>
70906790 <instance-parameter name="self" transfer-ownership="none">
70916791 <doc xml:space="preserve"
7092- filename="src/adw-combo-row.c"
7093- line="642">a combo row</doc>
7094- <type name="ComboRow" c:type="AdwComboRow*"/>
6792+ filename="src/adw-animation.c"
6793+ line="531">an animation</doc>
6794+ <type name="Animation" c:type="AdwAnimation*"/>
70956795 </instance-parameter>
70966796 </parameters>
70976797 </method>
7098- <method name="get_selected"
7099- c:identifier="adw_combo_row_get_selected"
7100- glib:get-property="selected">
7101- <attribute name="org.gtk.Method.get_property" value="selected"/>
6798+ <method name="get_widget"
6799+ c:identifier="adw_animation_get_widget"
6800+ glib:get-property="widget">
71026801 <doc xml:space="preserve"
7103- filename="src/adw-combo-row.c"
7104- line="593">Gets the position of the selected item.</doc>
7105- <source-position filename="src/adw-combo-row.h" line="47"/>
6802+ filename="src/adw-animation.c"
6803+ line="456">Gets the widget @self was created for.
6804+
6805+It provides the frame clock for the animation. It's not strictly necessary
6806+for this widget to be same as the one being animated.
6807+
6808+The widget must be mapped in order for the animation to work. If it's not
6809+mapped, or if it gets unmapped during an ongoing animation, the animation
6810+will be automatically skipped.</doc>
6811+ <source-position filename="src/adw-animation.h" line="46"/>
71066812 <return-value transfer-ownership="none">
71076813 <doc xml:space="preserve"
7108- filename="src/adw-combo-row.c"
7109- line="599">the position of the selected item, or
7110- [const@Gtk.INVALID_LIST_POSITION] if no item is selected</doc>
7111- <type name="guint" c:type="guint"/>
6814+ filename="src/adw-animation.c"
6815+ line="469">the animation widget</doc>
6816+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
71126817 </return-value>
71136818 <parameters>
71146819 <instance-parameter name="self" transfer-ownership="none">
71156820 <doc xml:space="preserve"
7116- filename="src/adw-combo-row.c"
7117- line="595">a combo row</doc>
7118- <type name="ComboRow" c:type="AdwComboRow*"/>
6821+ filename="src/adw-animation.c"
6822+ line="458">an animation</doc>
6823+ <type name="Animation" c:type="AdwAnimation*"/>
71196824 </instance-parameter>
71206825 </parameters>
71216826 </method>
7122- <method name="get_selected_item"
7123- c:identifier="adw_combo_row_get_selected_item"
7124- glib:get-property="selected-item">
7125- <attribute name="org.gtk.Method.get_property" value="selected-item"/>
6827+ <method name="pause" c:identifier="adw_animation_pause">
71266828 <doc xml:space="preserve"
7127- filename="src/adw-combo-row.c"
7128- line="617">Gets the selected item.</doc>
7129- <source-position filename="src/adw-combo-row.h" line="53"/>
7130- <return-value transfer-ownership="none" nullable="1">
7131- <doc xml:space="preserve"
7132- filename="src/adw-combo-row.c"
7133- line="623">the selected item</doc>
7134- <type name="GObject.Object" c:type="gpointer"/>
6829+ filename="src/adw-animation.c"
6830+ line="610">Pauses a playing animation for @self.
6831+
6832+Does nothing if the current state of @self isn't `ADW_ANIMATION_PLAYING`.
6833+
6834+Sets [property@Animation:state] to `ADW_ANIMATION_PAUSED`.</doc>
6835+ <source-position filename="src/adw-animation.h" line="63"/>
6836+ <return-value transfer-ownership="none">
6837+ <type name="none" c:type="void"/>
71356838 </return-value>
71366839 <parameters>
71376840 <instance-parameter name="self" transfer-ownership="none">
71386841 <doc xml:space="preserve"
7139- filename="src/adw-combo-row.c"
7140- line="619">a combo row</doc>
7141- <type name="ComboRow" c:type="AdwComboRow*"/>
6842+ filename="src/adw-animation.c"
6843+ line="612">an animation</doc>
6844+ <type name="Animation" c:type="AdwAnimation*"/>
71426845 </instance-parameter>
71436846 </parameters>
71446847 </method>
7145- <method name="get_use_subtitle"
7146- c:identifier="adw_combo_row_get_use_subtitle"
7147- glib:get-property="use-subtitle">
7148- <attribute name="org.gtk.Method.get_property" value="use-subtitle"/>
6848+ <method name="play" c:identifier="adw_animation_play">
71496849 <doc xml:space="preserve"
7150- filename="src/adw-combo-row.c"
7151- line="884">Gets whether to use the current value as the subtitle.</doc>
7152- <source-position filename="src/adw-combo-row.h" line="74"/>
6850+ filename="src/adw-animation.c"
6851+ line="572">Starts the animation for @self.
6852+
6853+If the animation is playing, paused or has been completed, restarts it from
6854+the beginning. This allows to easily play an animation regardless of whether
6855+it's already playing or not.
6856+
6857+Sets [property@Animation:state] to `ADW_ANIMATION_PLAYING`.
6858+
6859+The animation will be automatically skipped if [property@Animation:widget] is
6860+unmapped, or if [property@Gtk.Settings:gtk-enable-animations] is `FALSE`.
6861+
6862+As such, it's not guaranteed that the animation will actually run. For
6863+example, when using [func@GLib.idle_add] and starting an animation
6864+immediately afterwards, it's entirely possible that the idle callback will
6865+run after the animation has already finished, and not while it's playing.</doc>
6866+ <source-position filename="src/adw-animation.h" line="61"/>
71536867 <return-value transfer-ownership="none">
7154- <doc xml:space="preserve"
7155- filename="src/adw-combo-row.c"
7156- line="890">whether to use the current value as the subtitle</doc>
7157- <type name="gboolean" c:type="gboolean"/>
6868+ <type name="none" c:type="void"/>
71586869 </return-value>
71596870 <parameters>
71606871 <instance-parameter name="self" transfer-ownership="none">
71616872 <doc xml:space="preserve"
7162- filename="src/adw-combo-row.c"
7163- line="886">a combo row</doc>
7164- <type name="ComboRow" c:type="AdwComboRow*"/>
6873+ filename="src/adw-animation.c"
6874+ line="574">an animation</doc>
6875+ <type name="Animation" c:type="AdwAnimation*"/>
71656876 </instance-parameter>
71666877 </parameters>
71676878 </method>
7168- <method name="set_expression"
7169- c:identifier="adw_combo_row_set_expression"
7170- glib:set-property="expression">
7171- <attribute name="org.gtk.Method.set_property" value="expression"/>
6879+ <method name="reset" c:identifier="adw_animation_reset">
71726880 <doc xml:space="preserve"
7173- filename="src/adw-combo-row.c"
7174- line="845">Sets the expression used to obtain strings from items.
7175-
7176-The expression must have a value type of `G_TYPE_STRING`.
6881+ filename="src/adw-animation.c"
6882+ line="722">Resets the animation for @self.
71776883
7178-It's used to bind strings to labels produced by the default factory if
7179-[property@ComboRow:factory] is not set, or when
7180-[property@ComboRow:use-subtitle] is set to `TRUE`.</doc>
7181- <source-position filename="src/adw-combo-row.h" line="70"/>
6884+Sets [property@Animation:state] to `ADW_ANIMATION_IDLE`.</doc>
6885+ <source-position filename="src/adw-animation.h" line="67"/>
71826886 <return-value transfer-ownership="none">
71836887 <type name="none" c:type="void"/>
71846888 </return-value>
71856889 <parameters>
71866890 <instance-parameter name="self" transfer-ownership="none">
71876891 <doc xml:space="preserve"
7188- filename="src/adw-combo-row.c"
7189- line="847">a combo row</doc>
7190- <type name="ComboRow" c:type="AdwComboRow*"/>
6892+ filename="src/adw-animation.c"
6893+ line="724">an animation</doc>
6894+ <type name="Animation" c:type="AdwAnimation*"/>
71916895 </instance-parameter>
7192- <parameter name="expression"
7193- transfer-ownership="none"
7194- nullable="1"
7195- allow-none="1">
7196- <doc xml:space="preserve"
7197- filename="src/adw-combo-row.c"
7198- line="848">an expression</doc>
7199- <type name="Gtk.Expression" c:type="GtkExpression*"/>
7200- </parameter>
72016896 </parameters>
72026897 </method>
7203- <method name="set_factory"
7204- c:identifier="adw_combo_row_set_factory"
7205- glib:set-property="factory">
7206- <attribute name="org.gtk.Method.set_property" value="factory"/>
6898+ <method name="resume" c:identifier="adw_animation_resume">
72076899 <doc xml:space="preserve"
7208- filename="src/adw-combo-row.c"
7209- line="742">Sets the factory for populating list items.
6900+ filename="src/adw-animation.c"
6901+ line="646">Resumes a paused animation for @self.
72106902
7211-This factory is always used for the item in the row. It is also used for
7212-items in the popup unless [property@ComboRow:list-factory] is set.</doc>
7213- <source-position filename="src/adw-combo-row.h" line="58"/>
6903+This function must only be used if the animation has been paused with
6904+[method@Animation.pause].
6905+
6906+Sets [property@Animation:state] to `ADW_ANIMATION_PLAYING`.</doc>
6907+ <source-position filename="src/adw-animation.h" line="65"/>
72146908 <return-value transfer-ownership="none">
72156909 <type name="none" c:type="void"/>
72166910 </return-value>
72176911 <parameters>
72186912 <instance-parameter name="self" transfer-ownership="none">
72196913 <doc xml:space="preserve"
7220- filename="src/adw-combo-row.c"
7221- line="744">a combo row</doc>
7222- <type name="ComboRow" c:type="AdwComboRow*"/>
6914+ filename="src/adw-animation.c"
6915+ line="648">an animation</doc>
6916+ <type name="Animation" c:type="AdwAnimation*"/>
72236917 </instance-parameter>
7224- <parameter name="factory"
7225- transfer-ownership="none"
7226- nullable="1"
7227- allow-none="1">
7228- <doc xml:space="preserve"
7229- filename="src/adw-combo-row.c"
7230- line="745">the factory to use</doc>
7231- <type name="Gtk.ListItemFactory" c:type="GtkListItemFactory*"/>
7232- </parameter>
72336918 </parameters>
72346919 </method>
7235- <method name="set_list_factory"
7236- c:identifier="adw_combo_row_set_list_factory"
7237- glib:set-property="list-factory">
7238- <attribute name="org.gtk.Method.set_property" value="list-factory"/>
6920+ <method name="set_follow_enable_animations_setting"
6921+ c:identifier="adw_animation_set_follow_enable_animations_setting"
6922+ glib:set-property="follow-enable-animations-setting"
6923+ version="1.3">
72396924 <doc xml:space="preserve"
7240- filename="src/adw-combo-row.c"
7241- line="794">Sets the factory for populating list items in the popup.
6925+ filename="src/adw-animation.c"
6926+ line="784">Sets whether to skip @self when animations are globally disabled.
72426927
7243-If this is not set, [property@ComboRow:factory] is used.</doc>
7244- <source-position filename="src/adw-combo-row.h" line="64"/>
6928+The default behavior is to skip the animation. Set to `FALSE` to disable this
6929+behavior.
6930+
6931+This can be useful for cases where animation is essential, like spinners, or
6932+in demo applications. Most other animations should keep it enabled.
6933+
6934+See [property@Gtk.Settings:gtk-enable-animations].</doc>
6935+ <source-position filename="src/adw-animation.h" line="74"/>
72456936 <return-value transfer-ownership="none">
72466937 <type name="none" c:type="void"/>
72476938 </return-value>
72486939 <parameters>
72496940 <instance-parameter name="self" transfer-ownership="none">
72506941 <doc xml:space="preserve"
7251- filename="src/adw-combo-row.c"
7252- line="796">a combo row</doc>
7253- <type name="ComboRow" c:type="AdwComboRow*"/>
6942+ filename="src/adw-animation.c"
6943+ line="786">an animation</doc>
6944+ <type name="Animation" c:type="AdwAnimation*"/>
72546945 </instance-parameter>
7255- <parameter name="factory"
7256- transfer-ownership="none"
7257- nullable="1"
7258- allow-none="1">
6946+ <parameter name="setting" transfer-ownership="none">
72596947 <doc xml:space="preserve"
7260- filename="src/adw-combo-row.c"
7261- line="797">the factory to use</doc>
7262- <type name="Gtk.ListItemFactory" c:type="GtkListItemFactory*"/>
6948+ filename="src/adw-animation.c"
6949+ line="787">whether to follow the global setting</doc>
6950+ <type name="gboolean" c:type="gboolean"/>
72636951 </parameter>
72646952 </parameters>
72656953 </method>
7266- <method name="set_model"
7267- c:identifier="adw_combo_row_set_model"
7268- glib:set-property="model">
7269- <attribute name="org.gtk.Method.set_property" value="model"/>
7270- <doc xml:space="preserve"
7271- filename="src/adw-combo-row.c"
7272- line="660">Sets the model that provides the displayed items.</doc>
7273- <source-position filename="src/adw-combo-row.h" line="43"/>
7274- <return-value transfer-ownership="none">
7275- <type name="none" c:type="void"/>
7276- </return-value>
7277- <parameters>
7278- <instance-parameter name="self" transfer-ownership="none">
7279- <doc xml:space="preserve"
7280- filename="src/adw-combo-row.c"
7281- line="662">a combo row</doc>
7282- <type name="ComboRow" c:type="AdwComboRow*"/>
7283- </instance-parameter>
7284- <parameter name="model"
7285- transfer-ownership="none"
7286- nullable="1"
7287- allow-none="1">
7288- <doc xml:space="preserve"
7289- filename="src/adw-combo-row.c"
7290- line="663">the model to use</doc>
7291- <type name="Gio.ListModel" c:type="GListModel*"/>
7292- </parameter>
7293- </parameters>
7294- </method>
7295- <method name="set_selected"
7296- c:identifier="adw_combo_row_set_selected"
7297- glib:set-property="selected">
7298- <attribute name="org.gtk.Method.set_property" value="selected"/>
6954+ <method name="set_target"
6955+ c:identifier="adw_animation_set_target"
6956+ glib:set-property="target">
72996957 <doc xml:space="preserve"
7300- filename="src/adw-combo-row.c"
7301- line="566">Selects the item at the given position.</doc>
7302- <source-position filename="src/adw-combo-row.h" line="49"/>
6958+ filename="src/adw-animation.c"
6959+ line="503">Sets the target @self animates to @target.</doc>
6960+ <source-position filename="src/adw-animation.h" line="51"/>
73036961 <return-value transfer-ownership="none">
73046962 <type name="none" c:type="void"/>
73056963 </return-value>
73066964 <parameters>
73076965 <instance-parameter name="self" transfer-ownership="none">
73086966 <doc xml:space="preserve"
7309- filename="src/adw-combo-row.c"
7310- line="568">a combo row</doc>
7311- <type name="ComboRow" c:type="AdwComboRow*"/>
6967+ filename="src/adw-animation.c"
6968+ line="505">an animation</doc>
6969+ <type name="Animation" c:type="AdwAnimation*"/>
73126970 </instance-parameter>
7313- <parameter name="position" transfer-ownership="none">
6971+ <parameter name="target" transfer-ownership="none">
73146972 <doc xml:space="preserve"
7315- filename="src/adw-combo-row.c"
7316- line="569">the position of the item to select, or
7317- [const@Gtk.INVALID_LIST_POSITION]</doc>
7318- <type name="guint" c:type="guint"/>
6973+ filename="src/adw-animation.c"
6974+ line="506">an animation target</doc>
6975+ <type name="AnimationTarget" c:type="AdwAnimationTarget*"/>
73196976 </parameter>
73206977 </parameters>
73216978 </method>
7322- <method name="set_use_subtitle"
7323- c:identifier="adw_combo_row_set_use_subtitle"
7324- glib:set-property="use-subtitle">
7325- <attribute name="org.gtk.Method.set_property" value="use-subtitle"/>
6979+ <method name="skip" c:identifier="adw_animation_skip">
73266980 <doc xml:space="preserve"
7327- filename="src/adw-combo-row.c"
7328- line="904">Sets whether to use the current value as the subtitle.
7329-
7330-If you use a custom list item factory, you will need to give the row a
7331-name conversion expression with [property@ComboRow:expression].
6981+ filename="src/adw-animation.c"
6982+ line="675">Skips the animation for @self.
73326983
7333-If set to `TRUE`, you should not access [property@ActionRow:subtitle].
6984+If the animation hasn't been started yet, is playing, or is paused, instantly
6985+skips the animation to the end and causes [signal@Animation::done] to be
6986+emitted.
73346987
7335-The subtitle is interpreted as Pango markup if
7336-[property@PreferencesRow:use-markup] is set to `TRUE`.</doc>
7337- <source-position filename="src/adw-combo-row.h" line="76"/>
6988+Sets [property@Animation:state] to `ADW_ANIMATION_FINISHED`.</doc>
6989+ <source-position filename="src/adw-animation.h" line="69"/>
73386990 <return-value transfer-ownership="none">
73396991 <type name="none" c:type="void"/>
73406992 </return-value>
73416993 <parameters>
73426994 <instance-parameter name="self" transfer-ownership="none">
73436995 <doc xml:space="preserve"
7344- filename="src/adw-combo-row.c"
7345- line="906">a combo row</doc>
7346- <type name="ComboRow" c:type="AdwComboRow*"/>
6996+ filename="src/adw-animation.c"
6997+ line="677">an animation</doc>
6998+ <type name="Animation" c:type="AdwAnimation*"/>
73476999 </instance-parameter>
7348- <parameter name="use_subtitle" transfer-ownership="none">
7349- <doc xml:space="preserve"
7350- filename="src/adw-combo-row.c"
7351- line="907">whether to use the current value as the subtitle</doc>
7352- <type name="gboolean" c:type="gboolean"/>
7353- </parameter>
73547000 </parameters>
73557001 </method>
7356- <property name="expression"
7002+ <property name="follow-enable-animations-setting"
7003+ version="1.3"
73577004 writable="1"
73587005 transfer-ownership="none"
7359- setter="set_expression"
7360- getter="get_expression">
7361- <attribute name="org.gtk.Property.get"
7362- value="adw_combo_row_get_expression"/>
7363- <attribute name="org.gtk.Property.set"
7364- value="adw_combo_row_set_expression"/>
7006+ setter="set_follow_enable_animations_setting"
7007+ getter="get_follow_enable_animations_setting"
7008+ default-value="TRUE">
73657009 <doc xml:space="preserve"
7366- filename="src/adw-combo-row.c"
7367- line="494">An expression used to obtain strings from items.
7010+ filename="src/adw-animation.c"
7011+ line="405">Whether to skip the animation when animations are globally disabled.
73687012
7369-The expression must have a value type of `G_TYPE_STRING`.
7013+The default behavior is to skip the animation. Set to `FALSE` to disable
7014+this behavior.
73707015
7371-It's used to bind strings to labels produced by the default factory if
7372-[property@ComboRow:factory] is not set, or when
7373-[property@ComboRow:use-subtitle] is set to `TRUE`.</doc>
7374- <type name="Gtk.Expression"/>
7375- </property>
7376- <property name="factory"
7377- writable="1"
7378- transfer-ownership="none"
7379- setter="set_factory"
7380- getter="get_factory">
7381- <attribute name="org.gtk.Property.get"
7382- value="adw_combo_row_get_factory"/>
7383- <attribute name="org.gtk.Property.set"
7384- value="adw_combo_row_set_factory"/>
7385- <doc xml:space="preserve"
7386- filename="src/adw-combo-row.c"
7387- line="469">Factory for populating list items.
7016+This can be useful for cases where animation is essential, like spinners,
7017+or in demo applications. Most other animations should keep it enabled.
73887018
7389-This factory is always used for the item in the row. It is also used for
7390-items in the popup unless [property@ComboRow:list-factory] is set.</doc>
7391- <type name="Gtk.ListItemFactory"/>
7019+See [property@Gtk.Settings:gtk-enable-animations].</doc>
7020+ <type name="gboolean" c:type="gboolean"/>
73927021 </property>
7393- <property name="list-factory"
7394- writable="1"
7022+ <property name="state"
73957023 transfer-ownership="none"
7396- setter="set_list_factory"
7397- getter="get_list_factory">
7398- <attribute name="org.gtk.Property.get"
7399- value="adw_combo_row_get_list_factory"/>
7400- <attribute name="org.gtk.Property.set"
7401- value="adw_combo_row_set_list_factory"/>
7024+ getter="get_state"
7025+ default-value="ADW_ANIMATION_IDLE">
74027026 <doc xml:space="preserve"
7403- filename="src/adw-combo-row.c"
7404- line="482">The factory for populating list items in the popup.
7027+ filename="src/adw-animation.c"
7028+ line="391">The animation state.
74057029
7406-If this is not set, [property@ComboRow:factory] is used.</doc>
7407- <type name="Gtk.ListItemFactory"/>
7408- </property>
7409- <property name="model"
7410- writable="1"
7411- transfer-ownership="none"
7412- setter="set_model"
7413- getter="get_model">
7414- <attribute name="org.gtk.Property.get"
7415- value="adw_combo_row_get_model"/>
7416- <attribute name="org.gtk.Property.set"
7417- value="adw_combo_row_set_model"/>
7418- <doc xml:space="preserve"
7419- filename="src/adw-combo-row.c"
7420- line="459">The model that provides the displayed items.</doc>
7421- <type name="Gio.ListModel"/>
7030+The state indicates whether the animation is currently playing, paused,
7031+finished or hasn't been started yet.</doc>
7032+ <type name="AnimationState"/>
74227033 </property>
7423- <property name="selected"
7034+ <property name="target"
74247035 writable="1"
7036+ construct="1"
74257037 transfer-ownership="none"
7426- setter="set_selected"
7427- getter="get_selected"
7428- default-value="4294967295">
7429- <attribute name="org.gtk.Property.get"
7430- value="adw_combo_row_get_selected"/>
7431- <attribute name="org.gtk.Property.set"
7432- value="adw_combo_row_set_selected"/>
7038+ setter="set_target"
7039+ getter="get_target">
74337040 <doc xml:space="preserve"
7434- filename="src/adw-combo-row.c"
7435- line="436">The position of the selected item.
7436-
7437-If no item is selected, the property has the value
7438-[const@Gtk.INVALID_LIST_POSITION]</doc>
7439- <type name="guint" c:type="guint"/>
7041+ filename="src/adw-animation.c"
7042+ line="369">The target to animate.</doc>
7043+ <type name="AnimationTarget"/>
74407044 </property>
7441- <property name="selected-item"
7045+ <property name="value"
74427046 transfer-ownership="none"
7443- getter="get_selected_item">
7444- <attribute name="org.gtk.Property.get"
7445- value="adw_combo_row_get_selected_item"/>
7047+ getter="get_value"
7048+ default-value="0.000000">
74467049 <doc xml:space="preserve"
7447- filename="src/adw-combo-row.c"
7448- line="449">The selected item.</doc>
7449- <type name="GObject.Object"/>
7050+ filename="src/adw-animation.c"
7051+ line="379">The current value of the animation.</doc>
7052+ <type name="gdouble" c:type="gdouble"/>
74507053 </property>
7451- <property name="use-subtitle"
7054+ <property name="widget"
74527055 writable="1"
7056+ construct-only="1"
74537057 transfer-ownership="none"
7454- setter="set_use_subtitle"
7455- getter="get_use_subtitle"
7456- default-value="FALSE">
7457- <attribute name="org.gtk.Property.get"
7458- value="adw_combo_row_get_use_subtitle"/>
7459- <attribute name="org.gtk.Property.set"
7460- value="adw_combo_row_set_use_subtitle"/>
7058+ getter="get_widget">
74617059 <doc xml:space="preserve"
7462- filename="src/adw-combo-row.c"
7463- line="511">Whether to use the current value as the subtitle.
7464-
7465-If you use a custom list item factory, you will need to give the row a
7466-name conversion expression with [property@ComboRow:expression].
7060+ filename="src/adw-animation.c"
7061+ line="352">The animation widget.
74677062
7468-If set to `TRUE`, you should not access [property@ActionRow:subtitle].
7063+It provides the frame clock for the animation. It's not strictly necessary
7064+for this widget to be same as the one being animated.
74697065
7470-The subtitle is interpreted as Pango markup if
7471-[property@PreferencesRow:use-markup] is set to `TRUE`.</doc>
7472- <type name="gboolean" c:type="gboolean"/>
7066+The widget must be mapped in order for the animation to work. If it's not
7067+mapped, or if it gets unmapped during an ongoing animation, the animation
7068+will be automatically skipped.</doc>
7069+ <type name="Gtk.Widget"/>
74737070 </property>
74747071 <field name="parent_instance">
7475- <type name="ActionRow" c:type="AdwActionRow"/>
7072+ <type name="GObject.Object" c:type="GObject"/>
74767073 </field>
7477- </class>
7478- <record name="ComboRowClass"
7479- c:type="AdwComboRowClass"
7480- glib:is-gtype-struct-for="ComboRow">
7481- <source-position filename="src/adw-combo-row.h" line="35"/>
7482- <field name="parent_class">
7074+ <glib:signal name="done" when="last">
74837075 <doc xml:space="preserve"
7484- filename="src/adw-combo-row.h"
7485- line="27">The parent class</doc>
7486- <type name="ActionRowClass" c:type="AdwActionRowClass"/>
7487- </field>
7488- <field name="padding" readable="0" private="1">
7489- <array zero-terminated="0" fixed-size="4">
7490- <type name="gpointer" c:type="gpointer"/>
7491- </array>
7492- </field>
7076+ filename="src/adw-animation.c"
7077+ line="427">This signal is emitted when the animation has been completed, either on its
7078+own or via calling [method@Animation.skip].</doc>
7079+ <return-value transfer-ownership="none">
7080+ <type name="none" c:type="void"/>
7081+ </return-value>
7082+ </glib:signal>
7083+ </class>
7084+ <record name="AnimationClass"
7085+ c:type="AdwAnimationClass"
7086+ disguised="1"
7087+ opaque="1"
7088+ glib:is-gtype-struct-for="Animation">
7089+ <source-position filename="src/adw-animation.h" line="36"/>
74937090 </record>
7494- <function-macro name="DEPRECATED_IN_1_1_FOR"
7495- c:identifier="ADW_DEPRECATED_IN_1_1_FOR"
7496- introspectable="0">
7497- <source-position filename="src/adw-version.h" line="141"/>
7498- <parameters>
7499- <parameter name="f">
7500- </parameter>
7501- </parameters>
7502- </function-macro>
7503- <function-macro name="DEPRECATED_IN_1_2_FOR"
7504- c:identifier="ADW_DEPRECATED_IN_1_2_FOR"
7505- introspectable="0">
7506- <source-position filename="src/adw-version.h" line="159"/>
7507- <parameters>
7508- <parameter name="f">
7509- </parameter>
7510- </parameters>
7511- </function-macro>
7512- <function-macro name="DEPRECATED_IN_1_3_FOR"
7513- c:identifier="ADW_DEPRECATED_IN_1_3_FOR"
7514- introspectable="0">
7515- <source-position filename="src/adw-version.h" line="177"/>
7516- <parameters>
7517- <parameter name="f">
7518- </parameter>
7519- </parameters>
7520- </function-macro>
7521- <function-macro name="DEPRECATED_TYPE_IN_1_1_FOR"
7522- c:identifier="ADW_DEPRECATED_TYPE_IN_1_1_FOR"
7523- introspectable="0">
7524- <source-position filename="src/adw-version.h" line="143"/>
7525- <parameters>
7526- <parameter name="f">
7527- </parameter>
7528- </parameters>
7529- </function-macro>
7530- <function-macro name="DEPRECATED_TYPE_IN_1_2_FOR"
7531- c:identifier="ADW_DEPRECATED_TYPE_IN_1_2_FOR"
7532- introspectable="0">
7533- <source-position filename="src/adw-version.h" line="161"/>
7534- <parameters>
7535- <parameter name="f">
7536- </parameter>
7537- </parameters>
7538- </function-macro>
7539- <function-macro name="DEPRECATED_TYPE_IN_1_3_FOR"
7540- c:identifier="ADW_DEPRECATED_TYPE_IN_1_3_FOR"
7541- introspectable="0">
7542- <source-position filename="src/adw-version.h" line="179"/>
7543- <parameters>
7544- <parameter name="f">
7545- </parameter>
7546- </parameters>
7547- </function-macro>
7548- <constant name="DURATION_INFINITE"
7549- value="4294967295"
7550- c:type="ADW_DURATION_INFINITE">
7551- <doc xml:space="preserve"
7552- filename="src/adw-animation.h"
7553- line="23">Indicates an [class@Animation] with an infinite duration.
7554-
7555-This value is mostly used internally.</doc>
7556- <source-position filename="src/adw-animation.h" line="31"/>
7557- <type name="guint" c:type="guint"/>
7558- </constant>
7559- <function-macro name="ENCODE_VERSION"
7560- c:identifier="ADW_ENCODE_VERSION"
7561- introspectable="0">
7562- <source-position filename="src/adw-version.h" line="53"/>
7563- <parameters>
7564- <parameter name="major">
7565- </parameter>
7566- <parameter name="minor">
7567- </parameter>
7568- <parameter name="micro">
7569- </parameter>
7570- </parameters>
7571- </function-macro>
7572- <enumeration name="Easing"
7573- glib:type-name="AdwEasing"
7574- glib:get-type="adw_easing_get_type"
7575- c:type="AdwEasing">
7091+ <enumeration name="AnimationState"
7092+ glib:type-name="AdwAnimationState"
7093+ glib:get-type="adw_animation_state_get_type"
7094+ c:type="AdwAnimationState">
75767095 <doc xml:space="preserve"
7577- filename="src/adw-easing.c"
7578- line="22">Describes the available easing functions for use with
7579-[class@TimedAnimation].
7096+ filename="src/adw-animation.c"
7097+ line="66">Describes the possible states of an [class@Animation].
75807098
7581-New values may be added to this enumeration over time.</doc>
7582- <member name="linear"
7099+The state can be controlled with [method@Animation.play],
7100+[method@Animation.pause], [method@Animation.resume],
7101+[method@Animation.reset] and [method@Animation.skip].</doc>
7102+ <member name="idle"
75837103 value="0"
7584- c:identifier="ADW_LINEAR"
7585- glib:nick="linear"
7586- glib:name="ADW_LINEAR">
7104+ c:identifier="ADW_ANIMATION_IDLE"
7105+ glib:nick="idle"
7106+ glib:name="ADW_ANIMATION_IDLE">
75877107 <doc xml:space="preserve"
7588- filename="src/adw-easing.c"
7589- line="24">Linear tweening.</doc>
7108+ filename="src/adw-animation.c"
7109+ line="68">The animation hasn't started yet.</doc>
75907110 </member>
7591- <member name="ease_in_quad"
7111+ <member name="paused"
75927112 value="1"
7593- c:identifier="ADW_EASE_IN_QUAD"
7594- glib:nick="ease-in-quad"
7595- glib:name="ADW_EASE_IN_QUAD">
7113+ c:identifier="ADW_ANIMATION_PAUSED"
7114+ glib:nick="paused"
7115+ glib:name="ADW_ANIMATION_PAUSED">
75967116 <doc xml:space="preserve"
7597- filename="src/adw-easing.c"
7598- line="25">Quadratic tweening.</doc>
7117+ filename="src/adw-animation.c"
7118+ line="69">The animation has been paused.</doc>
75997119 </member>
7600- <member name="ease_out_quad"
7120+ <member name="playing"
76017121 value="2"
7602- c:identifier="ADW_EASE_OUT_QUAD"
7603- glib:nick="ease-out-quad"
7604- glib:name="ADW_EASE_OUT_QUAD">
7122+ c:identifier="ADW_ANIMATION_PLAYING"
7123+ glib:nick="playing"
7124+ glib:name="ADW_ANIMATION_PLAYING">
76057125 <doc xml:space="preserve"
7606- filename="src/adw-easing.c"
7607- line="26">Quadratic tweening, inverse of `ADW_EASE_IN_QUAD`.</doc>
7126+ filename="src/adw-animation.c"
7127+ line="70">The animation is currently playing.</doc>
76087128 </member>
7609- <member name="ease_in_out_quad"
7129+ <member name="finished"
76107130 value="3"
7611- c:identifier="ADW_EASE_IN_OUT_QUAD"
7612- glib:nick="ease-in-out-quad"
7613- glib:name="ADW_EASE_IN_OUT_QUAD">
7614- <doc xml:space="preserve"
7615- filename="src/adw-easing.c"
7616- line="27">Quadratic tweening, combining `ADW_EASE_IN_QUAD` and
7617- `ADW_EASE_OUT_QUAD`.</doc>
7618- </member>
7619- <member name="ease_in_cubic"
7620- value="4"
7621- c:identifier="ADW_EASE_IN_CUBIC"
7622- glib:nick="ease-in-cubic"
7623- glib:name="ADW_EASE_IN_CUBIC">
7624- <doc xml:space="preserve"
7625- filename="src/adw-easing.c"
7626- line="29">Cubic tweening.</doc>
7627- </member>
7628- <member name="ease_out_cubic"
7629- value="5"
7630- c:identifier="ADW_EASE_OUT_CUBIC"
7631- glib:nick="ease-out-cubic"
7632- glib:name="ADW_EASE_OUT_CUBIC">
7131+ c:identifier="ADW_ANIMATION_FINISHED"
7132+ glib:nick="finished"
7133+ glib:name="ADW_ANIMATION_FINISHED">
76337134 <doc xml:space="preserve"
7634- filename="src/adw-easing.c"
7635- line="30">Cubic tweening, inverse of `ADW_EASE_IN_CUBIC`.</doc>
7135+ filename="src/adw-animation.c"
7136+ line="71">The animation has finished.</doc>
76367137 </member>
7637- <member name="ease_in_out_cubic"
7638- value="6"
7639- c:identifier="ADW_EASE_IN_OUT_CUBIC"
7640- glib:nick="ease-in-out-cubic"
7641- glib:name="ADW_EASE_IN_OUT_CUBIC">
7138+ </enumeration>
7139+ <class name="AnimationTarget"
7140+ c:symbol-prefix="animation_target"
7141+ c:type="AdwAnimationTarget"
7142+ parent="GObject.Object"
7143+ abstract="1"
7144+ glib:type-name="AdwAnimationTarget"
7145+ glib:get-type="adw_animation_target_get_type"
7146+ glib:type-struct="AnimationTargetClass">
7147+ <doc xml:space="preserve"
7148+ filename="src/adw-animation-target.c"
7149+ line="11">Represents a value [class@Animation] can animate.</doc>
7150+ <source-position filename="src/adw-animation-target.h" line="22"/>
7151+ </class>
7152+ <record name="AnimationTargetClass"
7153+ c:type="AdwAnimationTargetClass"
7154+ disguised="1"
7155+ opaque="1"
7156+ glib:is-gtype-struct-for="AnimationTarget">
7157+ <source-position filename="src/adw-animation-target.h" line="22"/>
7158+ </record>
7159+ <callback name="AnimationTargetFunc" c:type="AdwAnimationTargetFunc">
7160+ <doc xml:space="preserve"
7161+ filename="src/adw-animation-target.h"
7162+ line="25">Prototype for animation targets based on user callbacks.</doc>
7163+ <source-position filename="src/adw-animation-target.h" line="32"/>
7164+ <return-value transfer-ownership="none">
7165+ <type name="none" c:type="void"/>
7166+ </return-value>
7167+ <parameters>
7168+ <parameter name="value" transfer-ownership="none">
7169+ <doc xml:space="preserve"
7170+ filename="src/adw-animation-target.h"
7171+ line="27">The animation value</doc>
7172+ <type name="gdouble" c:type="double"/>
7173+ </parameter>
7174+ <parameter name="user_data"
7175+ transfer-ownership="none"
7176+ nullable="1"
7177+ allow-none="1"
7178+ closure="1">
7179+ <doc xml:space="preserve"
7180+ filename="src/adw-animation-target.h"
7181+ line="28">The user data provided when creating the target</doc>
7182+ <type name="gpointer" c:type="gpointer"/>
7183+ </parameter>
7184+ </parameters>
7185+ </callback>
7186+ <class name="Application"
7187+ c:symbol-prefix="application"
7188+ c:type="AdwApplication"
7189+ parent="Gtk.Application"
7190+ glib:type-name="AdwApplication"
7191+ glib:get-type="adw_application_get_type"
7192+ glib:type-struct="ApplicationClass">
7193+ <doc xml:space="preserve"
7194+ filename="src/adw-application.c"
7195+ line="11">A base class for Adwaita applications.
7196+
7197+`AdwApplication` handles library initialization by calling [func@init] in the
7198+default [signal@Gio.Application::startup] signal handler, in turn chaining up
7199+as required by [class@Gtk.Application]. Therefore, any subclass of
7200+`AdwApplication` should always chain up its `startup` handler before using
7201+any Adwaita or GTK API.
7202+
7203+## Automatic Resources
7204+
7205+`AdwApplication` will automatically load stylesheets located in the
7206+application's resource base path (see
7207+[method@Gio.Application.set_resource_base_path], if they're present.
7208+
7209+They can be used to add custom styles to the application, as follows:
7210+
7211+- `style.css` contains styles that are always present.
7212+
7213+- `style-dark.css` contains styles only used when
7214+[property@StyleManager:dark] is `TRUE`.
7215+
7216+- `style-hc.css` contains styles used when the system high contrast
7217+ preference is enabled.
7218+
7219+- `style-hc-dark.css` contains styles used when the system high contrast
7220+ preference is enabled and [property@StyleManager:dark] is `TRUE`.</doc>
7221+ <source-position filename="src/adw-application.h" line="36"/>
7222+ <implements name="Gio.ActionGroup"/>
7223+ <implements name="Gio.ActionMap"/>
7224+ <constructor name="new" c:identifier="adw_application_new">
76427225 <doc xml:space="preserve"
7643- filename="src/adw-easing.c"
7644- line="31">Cubic tweening, combining `ADW_EASE_IN_CUBIC` and
7645- `ADW_EASE_OUT_CUBIC`.</doc>
7646- </member>
7647- <member name="ease_in_quart"
7648- value="7"
7649- c:identifier="ADW_EASE_IN_QUART"
7650- glib:nick="ease-in-quart"
7651- glib:name="ADW_EASE_IN_QUART">
7226+ filename="src/adw-application.c"
7227+ line="248">Creates a new `AdwApplication`.
7228+
7229+If `application_id` is not `NULL`, then it must be valid. See
7230+[func@Gio.Application.id_is_valid].
7231+
7232+If no application ID is given then some features (most notably application
7233+uniqueness) will be disabled.</doc>
7234+ <source-position filename="src/adw-application.h" line="39"/>
7235+ <return-value transfer-ownership="full">
7236+ <doc xml:space="preserve"
7237+ filename="src/adw-application.c"
7238+ line="261">the newly created `AdwApplication`</doc>
7239+ <type name="Application" c:type="AdwApplication*"/>
7240+ </return-value>
7241+ <parameters>
7242+ <parameter name="application_id"
7243+ transfer-ownership="none"
7244+ nullable="1"
7245+ allow-none="1">
7246+ <doc xml:space="preserve"
7247+ filename="src/adw-application.c"
7248+ line="250">The application ID</doc>
7249+ <type name="utf8" c:type="const char*"/>
7250+ </parameter>
7251+ <parameter name="flags" transfer-ownership="none">
7252+ <doc xml:space="preserve"
7253+ filename="src/adw-application.c"
7254+ line="251">The application flags</doc>
7255+ <type name="Gio.ApplicationFlags" c:type="GApplicationFlags"/>
7256+ </parameter>
7257+ </parameters>
7258+ </constructor>
7259+ <method name="get_style_manager"
7260+ c:identifier="adw_application_get_style_manager"
7261+ glib:get-property="style-manager">
76527262 <doc xml:space="preserve"
7653- filename="src/adw-easing.c"
7654- line="33">Quartic tweening.</doc>
7655- </member>
7656- <member name="ease_out_quart"
7657- value="8"
7658- c:identifier="ADW_EASE_OUT_QUART"
7659- glib:nick="ease-out-quart"
7660- glib:name="ADW_EASE_OUT_QUART">
7263+ filename="src/adw-application.c"
7264+ line="273">Gets the style manager for @self.
7265+
7266+This is a convenience property allowing to access `AdwStyleManager` through
7267+property bindings or expressions.</doc>
7268+ <source-position filename="src/adw-application.h" line="43"/>
7269+ <return-value transfer-ownership="none">
7270+ <doc xml:space="preserve"
7271+ filename="src/adw-application.c"
7272+ line="282">the style manager</doc>
7273+ <type name="StyleManager" c:type="AdwStyleManager*"/>
7274+ </return-value>
7275+ <parameters>
7276+ <instance-parameter name="self" transfer-ownership="none">
7277+ <doc xml:space="preserve"
7278+ filename="src/adw-application.c"
7279+ line="275">an application</doc>
7280+ <type name="Application" c:type="AdwApplication*"/>
7281+ </instance-parameter>
7282+ </parameters>
7283+ </method>
7284+ <property name="style-manager"
7285+ transfer-ownership="none"
7286+ getter="get_style_manager">
76617287 <doc xml:space="preserve"
7662- filename="src/adw-easing.c"
7663- line="34">Quartic tweening, inverse of `ADW_EASE_IN_QUART`.</doc>
7664- </member>
7665- <member name="ease_in_out_quart"
7666- value="9"
7667- c:identifier="ADW_EASE_IN_OUT_QUART"
7668- glib:nick="ease-in-out-quart"
7669- glib:name="ADW_EASE_IN_OUT_QUART">
7288+ filename="src/adw-application.c"
7289+ line="227">The style manager for this application.
7290+
7291+This is a convenience property allowing to access `AdwStyleManager` through
7292+property bindings or expressions.</doc>
7293+ <type name="StyleManager"/>
7294+ </property>
7295+ <field name="parent_instance">
7296+ <type name="Gtk.Application" c:type="GtkApplication"/>
7297+ </field>
7298+ </class>
7299+ <record name="ApplicationClass"
7300+ c:type="AdwApplicationClass"
7301+ glib:is-gtype-struct-for="Application">
7302+ <source-position filename="src/adw-application.h" line="36"/>
7303+ <field name="parent_class">
76707304 <doc xml:space="preserve"
7671- filename="src/adw-easing.c"
7672- line="35">Quartic tweening, combining `ADW_EASE_IN_QUART` and
7673- `ADW_EASE_OUT_QUART`.</doc>
7674- </member>
7675- <member name="ease_in_quint"
7676- value="10"
7677- c:identifier="ADW_EASE_IN_QUINT"
7678- glib:nick="ease-in-quint"
7679- glib:name="ADW_EASE_IN_QUINT">
7305+ filename="src/adw-application.h"
7306+ line="28">The parent class</doc>
7307+ <type name="Gtk.ApplicationClass" c:type="GtkApplicationClass"/>
7308+ </field>
7309+ <field name="padding" readable="0" private="1">
7310+ <array zero-terminated="0" fixed-size="4">
7311+ <type name="gpointer" c:type="gpointer"/>
7312+ </array>
7313+ </field>
7314+ </record>
7315+ <class name="ApplicationWindow"
7316+ c:symbol-prefix="application_window"
7317+ c:type="AdwApplicationWindow"
7318+ parent="Gtk.ApplicationWindow"
7319+ glib:type-name="AdwApplicationWindow"
7320+ glib:get-type="adw_application_window_get_type"
7321+ glib:type-struct="ApplicationWindowClass">
7322+ <doc xml:space="preserve"
7323+ filename="src/adw-application-window.c"
7324+ line="17">A freeform application window.
7325+
7326+&lt;picture&gt;
7327+ &lt;source srcset="application-window-dark.png" media="(prefers-color-scheme: dark)"&gt;
7328+ &lt;img src="application-window.png" alt="application-window"&gt;
7329+&lt;/picture&gt;
7330+
7331+`AdwApplicationWindow` is a [class@Gtk.ApplicationWindow] subclass providing
7332+the same features as [class@Window].
7333+
7334+See [class@Window] for details.
7335+
7336+Example of an `AdwApplicationWindow` UI definition:
7337+
7338+```xml
7339+&lt;object class="AdwApplicationWindow"&gt;
7340+ &lt;property name="content"&gt;
7341+ &lt;object class="AdwToolbarView"&gt;
7342+ &lt;child type="top"&gt;
7343+ &lt;object class="AdwHeaderBar"/&gt;
7344+ &lt;/child&gt;
7345+ &lt;property name="content"&gt;
7346+ &lt;!-- ... --&gt;
7347+ &lt;/property&gt;
7348+ &lt;/object&gt;
7349+ &lt;/property&gt;
7350+&lt;/object&gt;
7351+```
7352+
7353+Using [property@Gtk.Application:menubar] is not supported and may result in
7354+visual glitches.</doc>
7355+ <source-position filename="src/adw-application-window.h" line="33"/>
7356+ <implements name="Gio.ActionGroup"/>
7357+ <implements name="Gio.ActionMap"/>
7358+ <implements name="Gtk.Accessible"/>
7359+ <implements name="Gtk.Buildable"/>
7360+ <implements name="Gtk.ConstraintTarget"/>
7361+ <implements name="Gtk.Native"/>
7362+ <implements name="Gtk.Root"/>
7363+ <implements name="Gtk.ShortcutManager"/>
7364+ <constructor name="new" c:identifier="adw_application_window_new">
76807365 <doc xml:space="preserve"
7681- filename="src/adw-easing.c"
7682- line="37">Quintic tweening.</doc>
7683- </member>
7684- <member name="ease_out_quint"
7685- value="11"
7686- c:identifier="ADW_EASE_OUT_QUINT"
7687- glib:nick="ease-out-quint"
7688- glib:name="ADW_EASE_OUT_QUINT">
7366+ filename="src/adw-application-window.c"
7367+ line="271">Creates a new `AdwApplicationWindow` for @app.</doc>
7368+ <source-position filename="src/adw-application-window.h" line="36"/>
7369+ <return-value transfer-ownership="none">
7370+ <doc xml:space="preserve"
7371+ filename="src/adw-application-window.c"
7372+ line="277">the newly created `AdwApplicationWindow`</doc>
7373+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
7374+ </return-value>
7375+ <parameters>
7376+ <parameter name="app" transfer-ownership="none">
7377+ <doc xml:space="preserve"
7378+ filename="src/adw-application-window.c"
7379+ line="273">an application instance</doc>
7380+ <type name="Gtk.Application" c:type="GtkApplication*"/>
7381+ </parameter>
7382+ </parameters>
7383+ </constructor>
7384+ <method name="add_breakpoint"
7385+ c:identifier="adw_application_window_add_breakpoint"
7386+ version="1.4">
76897387 <doc xml:space="preserve"
7690- filename="src/adw-easing.c"
7691- line="38">Quintic tweening, inverse of `ADW_EASE_IN_QUINT`.</doc>
7692- </member>
7693- <member name="ease_in_out_quint"
7694- value="12"
7695- c:identifier="ADW_EASE_IN_OUT_QUINT"
7696- glib:nick="ease-in-out-quint"
7697- glib:name="ADW_EASE_IN_OUT_QUINT">
7388+ filename="src/adw-application-window.c"
7389+ line="340">Adds @breakpoint to @self.</doc>
7390+ <source-position filename="src/adw-application-window.h" line="45"/>
7391+ <return-value transfer-ownership="none">
7392+ <type name="none" c:type="void"/>
7393+ </return-value>
7394+ <parameters>
7395+ <instance-parameter name="self" transfer-ownership="none">
7396+ <doc xml:space="preserve"
7397+ filename="src/adw-application-window.c"
7398+ line="342">an application window</doc>
7399+ <type name="ApplicationWindow" c:type="AdwApplicationWindow*"/>
7400+ </instance-parameter>
7401+ <parameter name="breakpoint" transfer-ownership="full">
7402+ <doc xml:space="preserve"
7403+ filename="src/adw-application-window.c"
7404+ line="343">the breakpoint to add</doc>
7405+ <type name="Breakpoint" c:type="AdwBreakpoint*"/>
7406+ </parameter>
7407+ </parameters>
7408+ </method>
7409+ <method name="get_content"
7410+ c:identifier="adw_application_window_get_content"
7411+ glib:get-property="content">
76987412 <doc xml:space="preserve"
7699- filename="src/adw-easing.c"
7700- line="39">Quintic tweening, combining `ADW_EASE_IN_QUINT` and
7701- `ADW_EASE_OUT_QUINT`.</doc>
7702- </member>
7703- <member name="ease_in_sine"
7704- value="13"
7705- c:identifier="ADW_EASE_IN_SINE"
7706- glib:nick="ease-in-sine"
7707- glib:name="ADW_EASE_IN_SINE">
7413+ filename="src/adw-application-window.c"
7414+ line="318">Gets the content widget of @self.
7415+
7416+This method should always be used instead of [method@Gtk.Window.get_child].</doc>
7417+ <source-position filename="src/adw-application-window.h" line="42"/>
7418+ <return-value transfer-ownership="none" nullable="1">
7419+ <doc xml:space="preserve"
7420+ filename="src/adw-application-window.c"
7421+ line="326">the content widget of @self</doc>
7422+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
7423+ </return-value>
7424+ <parameters>
7425+ <instance-parameter name="self" transfer-ownership="none">
7426+ <doc xml:space="preserve"
7427+ filename="src/adw-application-window.c"
7428+ line="320">an application window</doc>
7429+ <type name="ApplicationWindow" c:type="AdwApplicationWindow*"/>
7430+ </instance-parameter>
7431+ </parameters>
7432+ </method>
7433+ <method name="get_current_breakpoint"
7434+ c:identifier="adw_application_window_get_current_breakpoint"
7435+ glib:get-property="current-breakpoint"
7436+ version="1.4">
77087437 <doc xml:space="preserve"
7709- filename="src/adw-easing.c"
7710- line="41">Sine wave tweening.</doc>
7711- </member>
7712- <member name="ease_out_sine"
7713- value="14"
7714- c:identifier="ADW_EASE_OUT_SINE"
7715- glib:nick="ease-out-sine"
7716- glib:name="ADW_EASE_OUT_SINE">
7438+ filename="src/adw-application-window.c"
7439+ line="363">Gets the current breakpoint.</doc>
7440+ <source-position filename="src/adw-application-window.h" line="49"/>
7441+ <return-value transfer-ownership="none" nullable="1">
7442+ <doc xml:space="preserve"
7443+ filename="src/adw-application-window.c"
7444+ line="369">the current breakpoint</doc>
7445+ <type name="Breakpoint" c:type="AdwBreakpoint*"/>
7446+ </return-value>
7447+ <parameters>
7448+ <instance-parameter name="self" transfer-ownership="none">
7449+ <doc xml:space="preserve"
7450+ filename="src/adw-application-window.c"
7451+ line="365">an application window</doc>
7452+ <type name="ApplicationWindow" c:type="AdwApplicationWindow*"/>
7453+ </instance-parameter>
7454+ </parameters>
7455+ </method>
7456+ <method name="get_dialogs"
7457+ c:identifier="adw_application_window_get_dialogs"
7458+ glib:get-property="dialogs"
7459+ version="1.5">
77177460 <doc xml:space="preserve"
7718- filename="src/adw-easing.c"
7719- line="42">Sine wave tweening, inverse of `ADW_EASE_IN_SINE`.</doc>
7720- </member>
7721- <member name="ease_in_out_sine"
7722- value="15"
7723- c:identifier="ADW_EASE_IN_OUT_SINE"
7724- glib:nick="ease-in-out-sine"
7725- glib:name="ADW_EASE_IN_OUT_SINE">
7461+ filename="src/adw-application-window.c"
7462+ line="385">Returns a [iface@Gio.ListModel] that contains the open dialogs of @self.
7463+
7464+This can be used to keep an up-to-date view.</doc>
7465+ <source-position filename="src/adw-application-window.h" line="52"/>
7466+ <return-value transfer-ownership="full">
7467+ <doc xml:space="preserve"
7468+ filename="src/adw-application-window.c"
7469+ line="393">a list model for the dialogs of @self</doc>
7470+ <type name="Gio.ListModel" c:type="GListModel*"/>
7471+ </return-value>
7472+ <parameters>
7473+ <instance-parameter name="self" transfer-ownership="none">
7474+ <doc xml:space="preserve"
7475+ filename="src/adw-application-window.c"
7476+ line="387">an application window</doc>
7477+ <type name="ApplicationWindow" c:type="AdwApplicationWindow*"/>
7478+ </instance-parameter>
7479+ </parameters>
7480+ </method>
7481+ <method name="get_visible_dialog"
7482+ c:identifier="adw_application_window_get_visible_dialog"
7483+ glib:get-property="visible-dialog"
7484+ version="1.5">
77267485 <doc xml:space="preserve"
7727- filename="src/adw-easing.c"
7728- line="43">Sine wave tweening, combining `ADW_EASE_IN_SINE` and
7729- `ADW_EASE_OUT_SINE`.</doc>
7730- </member>
7731- <member name="ease_in_expo"
7732- value="16"
7733- c:identifier="ADW_EASE_IN_EXPO"
7734- glib:nick="ease-in-expo"
7735- glib:name="ADW_EASE_IN_EXPO">
7486+ filename="src/adw-application-window.c"
7487+ line="409">Returns the currently visible dialog in @self, if there's one.</doc>
7488+ <source-position filename="src/adw-application-window.h" line="55"/>
7489+ <return-value transfer-ownership="none" nullable="1">
7490+ <doc xml:space="preserve"
7491+ filename="src/adw-application-window.c"
7492+ line="415">the visible dialog</doc>
7493+ <type name="Dialog" c:type="AdwDialog*"/>
7494+ </return-value>
7495+ <parameters>
7496+ <instance-parameter name="self" transfer-ownership="none">
7497+ <doc xml:space="preserve"
7498+ filename="src/adw-application-window.c"
7499+ line="411">an application window</doc>
7500+ <type name="ApplicationWindow" c:type="AdwApplicationWindow*"/>
7501+ </instance-parameter>
7502+ </parameters>
7503+ </method>
7504+ <method name="set_content"
7505+ c:identifier="adw_application_window_set_content"
7506+ glib:set-property="content">
77367507 <doc xml:space="preserve"
7737- filename="src/adw-easing.c"
7738- line="45">Exponential tweening.</doc>
7739- </member>
7740- <member name="ease_out_expo"
7741- value="17"
7742- c:identifier="ADW_EASE_OUT_EXPO"
7743- glib:nick="ease-out-expo"
7744- glib:name="ADW_EASE_OUT_EXPO">
7745- <doc xml:space="preserve"
7746- filename="src/adw-easing.c"
7747- line="46">Exponential tweening, inverse of `ADW_EASE_IN_EXPO`.</doc>
7748- </member>
7749- <member name="ease_in_out_expo"
7750- value="18"
7751- c:identifier="ADW_EASE_IN_OUT_EXPO"
7752- glib:nick="ease-in-out-expo"
7753- glib:name="ADW_EASE_IN_OUT_EXPO">
7754- <doc xml:space="preserve"
7755- filename="src/adw-easing.c"
7756- line="47">Exponential tweening, combining `ADW_EASE_IN_EXPO` and
7757- `ADW_EASE_OUT_EXPO`.</doc>
7758- </member>
7759- <member name="ease_in_circ"
7760- value="19"
7761- c:identifier="ADW_EASE_IN_CIRC"
7762- glib:nick="ease-in-circ"
7763- glib:name="ADW_EASE_IN_CIRC">
7508+ filename="src/adw-application-window.c"
7509+ line="287">Sets the content widget of @self.
7510+
7511+This method should always be used instead of [method@Gtk.Window.set_child].</doc>
7512+ <source-position filename="src/adw-application-window.h" line="39"/>
7513+ <return-value transfer-ownership="none">
7514+ <type name="none" c:type="void"/>
7515+ </return-value>
7516+ <parameters>
7517+ <instance-parameter name="self" transfer-ownership="none">
7518+ <doc xml:space="preserve"
7519+ filename="src/adw-application-window.c"
7520+ line="289">an application window</doc>
7521+ <type name="ApplicationWindow" c:type="AdwApplicationWindow*"/>
7522+ </instance-parameter>
7523+ <parameter name="content"
7524+ transfer-ownership="none"
7525+ nullable="1"
7526+ allow-none="1">
7527+ <doc xml:space="preserve"
7528+ filename="src/adw-application-window.c"
7529+ line="290">the content widget</doc>
7530+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
7531+ </parameter>
7532+ </parameters>
7533+ </method>
7534+ <property name="content"
7535+ writable="1"
7536+ transfer-ownership="none"
7537+ setter="set_content"
7538+ getter="get_content">
77647539 <doc xml:space="preserve"
7765- filename="src/adw-easing.c"
7766- line="49">Circular tweening.</doc>
7767- </member>
7768- <member name="ease_out_circ"
7769- value="20"
7770- c:identifier="ADW_EASE_OUT_CIRC"
7771- glib:nick="ease-out-circ"
7772- glib:name="ADW_EASE_OUT_CIRC">
7540+ filename="src/adw-application-window.c"
7541+ line="166">The content widget.
7542+
7543+This property should always be used instead of [property@Gtk.Window:child].</doc>
7544+ <type name="Gtk.Widget"/>
7545+ </property>
7546+ <property name="current-breakpoint"
7547+ version="1.4"
7548+ transfer-ownership="none"
7549+ getter="get_current_breakpoint">
77737550 <doc xml:space="preserve"
7774- filename="src/adw-easing.c"
7775- line="50">Circular tweening, inverse of `ADW_EASE_IN_CIRC`.</doc>
7776- </member>
7777- <member name="ease_in_out_circ"
7778- value="21"
7779- c:identifier="ADW_EASE_IN_OUT_CIRC"
7780- glib:nick="ease-in-out-circ"
7781- glib:name="ADW_EASE_IN_OUT_CIRC">
7551+ filename="src/adw-application-window.c"
7552+ line="178">The current breakpoint.</doc>
7553+ <type name="Breakpoint"/>
7554+ </property>
7555+ <property name="dialogs"
7556+ version="1.5"
7557+ transfer-ownership="none"
7558+ getter="get_dialogs">
77827559 <doc xml:space="preserve"
7783- filename="src/adw-easing.c"
7784- line="51">Circular tweening, combining `ADW_EASE_IN_CIRC` and
7785- `ADW_EASE_OUT_CIRC`.</doc>
7786- </member>
7787- <member name="ease_in_elastic"
7788- value="22"
7789- c:identifier="ADW_EASE_IN_ELASTIC"
7790- glib:nick="ease-in-elastic"
7791- glib:name="ADW_EASE_IN_ELASTIC">
7560+ filename="src/adw-application-window.c"
7561+ line="190">The open dialogs.</doc>
7562+ <type name="Gio.ListModel"/>
7563+ </property>
7564+ <property name="visible-dialog"
7565+ version="1.5"
7566+ transfer-ownership="none"
7567+ getter="get_visible_dialog">
77927568 <doc xml:space="preserve"
7793- filename="src/adw-easing.c"
7794- line="53">Elastic tweening, with offshoot on start.</doc>
7795- </member>
7796- <member name="ease_out_elastic"
7797- value="23"
7798- c:identifier="ADW_EASE_OUT_ELASTIC"
7799- glib:nick="ease-out-elastic"
7800- glib:name="ADW_EASE_OUT_ELASTIC">
7569+ filename="src/adw-application-window.c"
7570+ line="202">The currently visible dialog</doc>
7571+ <type name="Dialog"/>
7572+ </property>
7573+ <field name="parent_instance">
7574+ <type name="Gtk.ApplicationWindow" c:type="GtkApplicationWindow"/>
7575+ </field>
7576+ </class>
7577+ <record name="ApplicationWindowClass"
7578+ c:type="AdwApplicationWindowClass"
7579+ glib:is-gtype-struct-for="ApplicationWindow">
7580+ <source-position filename="src/adw-application-window.h" line="33"/>
7581+ <field name="parent_class">
7582+ <type name="Gtk.ApplicationWindowClass"
7583+ c:type="GtkApplicationWindowClass"/>
7584+ </field>
7585+ <field name="padding" readable="0" private="1">
7586+ <array zero-terminated="0" fixed-size="4">
7587+ <type name="gpointer" c:type="gpointer"/>
7588+ </array>
7589+ </field>
7590+ </record>
7591+ <class name="Avatar"
7592+ c:symbol-prefix="avatar"
7593+ c:type="AdwAvatar"
7594+ parent="Gtk.Widget"
7595+ final="1"
7596+ glib:type-name="AdwAvatar"
7597+ glib:get-type="adw_avatar_get_type"
7598+ glib:type-struct="AvatarClass">
7599+ <doc xml:space="preserve"
7600+ filename="src/adw-avatar.c"
7601+ line="21">A widget displaying an image, with a generated fallback.
7602+
7603+&lt;picture&gt;
7604+ &lt;source srcset="avatar-dark.png" media="(prefers-color-scheme: dark)"&gt;
7605+ &lt;img src="avatar.png" alt="avatar"&gt;
7606+&lt;/picture&gt;
7607+
7608+`AdwAvatar` is a widget that shows a round avatar.
7609+
7610+`AdwAvatar` generates an avatar with the initials of the
7611+[property@Avatar:text] on top of a colored background.
7612+
7613+The color is picked based on the hash of the [property@Avatar:text].
7614+
7615+If [property@Avatar:show-initials] is set to `FALSE`,
7616+[property@Avatar:icon-name] or `avatar-default-symbolic` is shown instead of
7617+the initials.
7618+
7619+Use [property@Avatar:custom-image] to set a custom image.
7620+
7621+## CSS nodes
7622+
7623+`AdwAvatar` has a single CSS node with name `avatar`.</doc>
7624+ <source-position filename="src/adw-avatar.h" line="22"/>
7625+ <implements name="Gtk.Accessible"/>
7626+ <implements name="Gtk.Buildable"/>
7627+ <implements name="Gtk.ConstraintTarget"/>
7628+ <constructor name="new" c:identifier="adw_avatar_new">
78017629 <doc xml:space="preserve"
7802- filename="src/adw-easing.c"
7803- line="54">Elastic tweening, with offshoot on end, inverse of
7804- `ADW_EASE_IN_ELASTIC`.</doc>
7805- </member>
7806- <member name="ease_in_out_elastic"
7807- value="24"
7808- c:identifier="ADW_EASE_IN_OUT_ELASTIC"
7809- glib:nick="ease-in-out-elastic"
7810- glib:name="ADW_EASE_IN_OUT_ELASTIC">
7630+ filename="src/adw-avatar.c"
7631+ line="474">Creates a new `AdwAvatar`.</doc>
7632+ <source-position filename="src/adw-avatar.h" line="25"/>
7633+ <return-value transfer-ownership="none">
7634+ <doc xml:space="preserve"
7635+ filename="src/adw-avatar.c"
7636+ line="482">the newly created `AdwAvatar`</doc>
7637+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
7638+ </return-value>
7639+ <parameters>
7640+ <parameter name="size" transfer-ownership="none">
7641+ <doc xml:space="preserve"
7642+ filename="src/adw-avatar.c"
7643+ line="476">The size of the avatar</doc>
7644+ <type name="gint" c:type="int"/>
7645+ </parameter>
7646+ <parameter name="text"
7647+ transfer-ownership="none"
7648+ nullable="1"
7649+ allow-none="1">
7650+ <doc xml:space="preserve"
7651+ filename="src/adw-avatar.c"
7652+ line="477">the text used to get the initials and color</doc>
7653+ <type name="utf8" c:type="const char*"/>
7654+ </parameter>
7655+ <parameter name="show_initials" transfer-ownership="none">
7656+ <doc xml:space="preserve"
7657+ filename="src/adw-avatar.c"
7658+ line="478">whether to use initials instead of an icon as fallback</doc>
7659+ <type name="gboolean" c:type="gboolean"/>
7660+ </parameter>
7661+ </parameters>
7662+ </constructor>
7663+ <method name="draw_to_texture" c:identifier="adw_avatar_draw_to_texture">
78117664 <doc xml:space="preserve"
7812- filename="src/adw-easing.c"
7813- line="56">Elastic tweening, with offshoot on both ends,
7814- combining `ADW_EASE_IN_ELASTIC` and `ADW_EASE_OUT_ELASTIC`.</doc>
7815- </member>
7816- <member name="ease_in_back"
7817- value="25"
7818- c:identifier="ADW_EASE_IN_BACK"
7819- glib:nick="ease-in-back"
7820- glib:name="ADW_EASE_IN_BACK">
7665+ filename="src/adw-avatar.c"
7666+ line="739">Renders @self into a [class@Gdk.Texture] at @scale_factor.
7667+
7668+This can be used to export the fallback avatar.</doc>
7669+ <source-position filename="src/adw-avatar.h" line="60"/>
7670+ <return-value transfer-ownership="full">
7671+ <doc xml:space="preserve"
7672+ filename="src/adw-avatar.c"
7673+ line="748">the texture</doc>
7674+ <type name="Gdk.Texture" c:type="GdkTexture*"/>
7675+ </return-value>
7676+ <parameters>
7677+ <instance-parameter name="self" transfer-ownership="none">
7678+ <doc xml:space="preserve"
7679+ filename="src/adw-avatar.c"
7680+ line="741">an avatar</doc>
7681+ <type name="Avatar" c:type="AdwAvatar*"/>
7682+ </instance-parameter>
7683+ <parameter name="scale_factor" transfer-ownership="none">
7684+ <doc xml:space="preserve"
7685+ filename="src/adw-avatar.c"
7686+ line="742">The scale factor</doc>
7687+ <type name="gint" c:type="int"/>
7688+ </parameter>
7689+ </parameters>
7690+ </method>
7691+ <method name="get_custom_image"
7692+ c:identifier="adw_avatar_get_custom_image"
7693+ glib:get-property="custom-image">
78217694 <doc xml:space="preserve"
7822- filename="src/adw-easing.c"
7823- line="58">Overshooting cubic tweening, with backtracking on start.</doc>
7824- </member>
7825- <member name="ease_out_back"
7826- value="26"
7827- c:identifier="ADW_EASE_OUT_BACK"
7828- glib:nick="ease-out-back"
7829- glib:name="ADW_EASE_OUT_BACK">
7695+ filename="src/adw-avatar.c"
7696+ line="623">Gets the custom image paintable.</doc>
7697+ <source-position filename="src/adw-avatar.h" line="48"/>
7698+ <return-value transfer-ownership="none" nullable="1">
7699+ <doc xml:space="preserve"
7700+ filename="src/adw-avatar.c"
7701+ line="629">the custom image</doc>
7702+ <type name="Gdk.Paintable" c:type="GdkPaintable*"/>
7703+ </return-value>
7704+ <parameters>
7705+ <instance-parameter name="self" transfer-ownership="none">
7706+ <doc xml:space="preserve"
7707+ filename="src/adw-avatar.c"
7708+ line="625">an avatar</doc>
7709+ <type name="Avatar" c:type="AdwAvatar*"/>
7710+ </instance-parameter>
7711+ </parameters>
7712+ </method>
7713+ <method name="get_icon_name"
7714+ c:identifier="adw_avatar_get_icon_name"
7715+ glib:get-property="icon-name">
78307716 <doc xml:space="preserve"
7831- filename="src/adw-easing.c"
7832- line="59">Overshooting cubic tweening, with backtracking on end,
7717+ filename="src/adw-avatar.c"
7718+ line="496">Gets the name of an icon to use as a fallback.</doc>
7719+ <source-position filename="src/adw-avatar.h" line="30"/>
7720+ <return-value transfer-ownership="none" nullable="1">
7721+ <doc xml:space="preserve"
7722+ filename="src/adw-avatar.c"
7723+ line="502">the icon name</doc>
7724+ <type name="utf8" c:type="const char*"/>
7725+ </return-value>
7726+ <parameters>
7727+ <instance-parameter name="self" transfer-ownership="none">
7728+ <doc xml:space="preserve"
7729+ filename="src/adw-avatar.c"
7730+ line="498">an avatar</doc>
7731+ <type name="Avatar" c:type="AdwAvatar*"/>
7732+ </instance-parameter>
7733+ </parameters>
7734+ </method>
7735+ <method name="get_show_initials"
7736+ c:identifier="adw_avatar_get_show_initials"
7737+ glib:get-property="show-initials">
7738+ <doc xml:space="preserve"
7739+ filename="src/adw-avatar.c"
7740+ line="580">Gets whether initials are used instead of an icon on the fallback avatar.</doc>
7741+ <source-position filename="src/adw-avatar.h" line="42"/>
7742+ <return-value transfer-ownership="none">
7743+ <doc xml:space="preserve"
7744+ filename="src/adw-avatar.c"
7745+ line="586">whether initials are used instead of an icon as fallback</doc>
7746+ <type name="gboolean" c:type="gboolean"/>
7747+ </return-value>
7748+ <parameters>
7749+ <instance-parameter name="self" transfer-ownership="none">
7750+ <doc xml:space="preserve"
7751+ filename="src/adw-avatar.c"
7752+ line="582">an avatar</doc>
7753+ <type name="Avatar" c:type="AdwAvatar*"/>
7754+ </instance-parameter>
7755+ </parameters>
7756+ </method>
7757+ <method name="get_size"
7758+ c:identifier="adw_avatar_get_size"
7759+ glib:get-property="size">
7760+ <doc xml:space="preserve"
7761+ filename="src/adw-avatar.c"
7762+ line="689">Gets the size of the avatar.</doc>
7763+ <source-position filename="src/adw-avatar.h" line="54"/>
7764+ <return-value transfer-ownership="none">
7765+ <doc xml:space="preserve"
7766+ filename="src/adw-avatar.c"
7767+ line="695">the size of the avatar</doc>
7768+ <type name="gint" c:type="int"/>
7769+ </return-value>
7770+ <parameters>
7771+ <instance-parameter name="self" transfer-ownership="none">
7772+ <doc xml:space="preserve"
7773+ filename="src/adw-avatar.c"
7774+ line="691">an avatar</doc>
7775+ <type name="Avatar" c:type="AdwAvatar*"/>
7776+ </instance-parameter>
7777+ </parameters>
7778+ </method>
7779+ <method name="get_text"
7780+ c:identifier="adw_avatar_get_text"
7781+ glib:get-property="text">
7782+ <doc xml:space="preserve"
7783+ filename="src/adw-avatar.c"
7784+ line="535">Gets the text used to generate the fallback initials and color.</doc>
7785+ <source-position filename="src/adw-avatar.h" line="36"/>
7786+ <return-value transfer-ownership="none" nullable="1">
7787+ <doc xml:space="preserve"
7788+ filename="src/adw-avatar.c"
7789+ line="541">the text used to generate the fallback initials and
7790+ color</doc>
7791+ <type name="utf8" c:type="const char*"/>
7792+ </return-value>
7793+ <parameters>
7794+ <instance-parameter name="self" transfer-ownership="none">
7795+ <doc xml:space="preserve"
7796+ filename="src/adw-avatar.c"
7797+ line="537">an avatar</doc>
7798+ <type name="Avatar" c:type="AdwAvatar*"/>
7799+ </instance-parameter>
7800+ </parameters>
7801+ </method>
7802+ <method name="set_custom_image"
7803+ c:identifier="adw_avatar_set_custom_image"
7804+ glib:set-property="custom-image">
7805+ <doc xml:space="preserve"
7806+ filename="src/adw-avatar.c"
7807+ line="639">Sets the custom image paintable.
7808+
7809+Custom image is displayed instead of initials or icon.</doc>
7810+ <source-position filename="src/adw-avatar.h" line="50"/>
7811+ <return-value transfer-ownership="none">
7812+ <type name="none" c:type="void"/>
7813+ </return-value>
7814+ <parameters>
7815+ <instance-parameter name="self" transfer-ownership="none">
7816+ <doc xml:space="preserve"
7817+ filename="src/adw-avatar.c"
7818+ line="641">an avatar</doc>
7819+ <type name="Avatar" c:type="AdwAvatar*"/>
7820+ </instance-parameter>
7821+ <parameter name="custom_image"
7822+ transfer-ownership="none"
7823+ nullable="1"
7824+ allow-none="1">
7825+ <doc xml:space="preserve"
7826+ filename="src/adw-avatar.c"
7827+ line="642">a custom image</doc>
7828+ <type name="Gdk.Paintable" c:type="GdkPaintable*"/>
7829+ </parameter>
7830+ </parameters>
7831+ </method>
7832+ <method name="set_icon_name"
7833+ c:identifier="adw_avatar_set_icon_name"
7834+ glib:set-property="icon-name">
7835+ <doc xml:space="preserve"
7836+ filename="src/adw-avatar.c"
7837+ line="512">Sets the name of an icon to use as a fallback.
7838+
7839+If no name is set, `avatar-default-symbolic` will be used.</doc>
7840+ <source-position filename="src/adw-avatar.h" line="32"/>
7841+ <return-value transfer-ownership="none">
7842+ <type name="none" c:type="void"/>
7843+ </return-value>
7844+ <parameters>
7845+ <instance-parameter name="self" transfer-ownership="none">
7846+ <doc xml:space="preserve"
7847+ filename="src/adw-avatar.c"
7848+ line="514">an avatar</doc>
7849+ <type name="Avatar" c:type="AdwAvatar*"/>
7850+ </instance-parameter>
7851+ <parameter name="icon_name"
7852+ transfer-ownership="none"
7853+ nullable="1"
7854+ allow-none="1">
7855+ <doc xml:space="preserve"
7856+ filename="src/adw-avatar.c"
7857+ line="515">the icon name</doc>
7858+ <type name="utf8" c:type="const char*"/>
7859+ </parameter>
7860+ </parameters>
7861+ </method>
7862+ <method name="set_show_initials"
7863+ c:identifier="adw_avatar_set_show_initials"
7864+ glib:set-property="show-initials">
7865+ <doc xml:space="preserve"
7866+ filename="src/adw-avatar.c"
7867+ line="596">Sets whether to use initials instead of an icon on the fallback avatar.
7868+
7869+See [property@Avatar:icon-name] for how to change the fallback icon.</doc>
7870+ <source-position filename="src/adw-avatar.h" line="44"/>
7871+ <return-value transfer-ownership="none">
7872+ <type name="none" c:type="void"/>
7873+ </return-value>
7874+ <parameters>
7875+ <instance-parameter name="self" transfer-ownership="none">
7876+ <doc xml:space="preserve"
7877+ filename="src/adw-avatar.c"
7878+ line="598">an avatar</doc>
7879+ <type name="Avatar" c:type="AdwAvatar*"/>
7880+ </instance-parameter>
7881+ <parameter name="show_initials" transfer-ownership="none">
7882+ <doc xml:space="preserve"
7883+ filename="src/adw-avatar.c"
7884+ line="599">whether to use initials instead of an icon as fallback</doc>
7885+ <type name="gboolean" c:type="gboolean"/>
7886+ </parameter>
7887+ </parameters>
7888+ </method>
7889+ <method name="set_size"
7890+ c:identifier="adw_avatar_set_size"
7891+ glib:set-property="size">
7892+ <doc xml:space="preserve"
7893+ filename="src/adw-avatar.c"
7894+ line="705">Sets the size of the avatar.</doc>
7895+ <source-position filename="src/adw-avatar.h" line="56"/>
7896+ <return-value transfer-ownership="none">
7897+ <type name="none" c:type="void"/>
7898+ </return-value>
7899+ <parameters>
7900+ <instance-parameter name="self" transfer-ownership="none">
7901+ <doc xml:space="preserve"
7902+ filename="src/adw-avatar.c"
7903+ line="707">an avatar</doc>
7904+ <type name="Avatar" c:type="AdwAvatar*"/>
7905+ </instance-parameter>
7906+ <parameter name="size" transfer-ownership="none">
7907+ <doc xml:space="preserve"
7908+ filename="src/adw-avatar.c"
7909+ line="708">The size of the avatar</doc>
7910+ <type name="gint" c:type="int"/>
7911+ </parameter>
7912+ </parameters>
7913+ </method>
7914+ <method name="set_text"
7915+ c:identifier="adw_avatar_set_text"
7916+ glib:set-property="text">
7917+ <doc xml:space="preserve"
7918+ filename="src/adw-avatar.c"
7919+ line="552">Sets the text used to generate the fallback initials and color.
7920+
7921+It's only used to generate the color if [property@Avatar:show-initials] is
7922+`FALSE`.</doc>
7923+ <source-position filename="src/adw-avatar.h" line="38"/>
7924+ <return-value transfer-ownership="none">
7925+ <type name="none" c:type="void"/>
7926+ </return-value>
7927+ <parameters>
7928+ <instance-parameter name="self" transfer-ownership="none">
7929+ <doc xml:space="preserve"
7930+ filename="src/adw-avatar.c"
7931+ line="554">an avatar</doc>
7932+ <type name="Avatar" c:type="AdwAvatar*"/>
7933+ </instance-parameter>
7934+ <parameter name="text"
7935+ transfer-ownership="none"
7936+ nullable="1"
7937+ allow-none="1">
7938+ <doc xml:space="preserve"
7939+ filename="src/adw-avatar.c"
7940+ line="555">the text used to get the initials and color</doc>
7941+ <type name="utf8" c:type="const char*"/>
7942+ </parameter>
7943+ </parameters>
7944+ </method>
7945+ <property name="custom-image"
7946+ writable="1"
7947+ transfer-ownership="none"
7948+ setter="set_custom_image"
7949+ getter="get_custom_image">
7950+ <doc xml:space="preserve"
7951+ filename="src/adw-avatar.c"
7952+ line="415">A custom image paintable.
7953+
7954+Custom image is displayed instead of initials or icon.</doc>
7955+ <type name="Gdk.Paintable"/>
7956+ </property>
7957+ <property name="icon-name"
7958+ writable="1"
7959+ transfer-ownership="none"
7960+ setter="set_icon_name"
7961+ getter="get_icon_name"
7962+ default-value="NULL">
7963+ <doc xml:space="preserve"
7964+ filename="src/adw-avatar.c"
7965+ line="378">The name of an icon to use as a fallback.
7966+
7967+If no name is set, `avatar-default-symbolic` will be used.</doc>
7968+ <type name="utf8" c:type="gchar*"/>
7969+ </property>
7970+ <property name="show-initials"
7971+ writable="1"
7972+ transfer-ownership="none"
7973+ setter="set_show_initials"
7974+ getter="get_show_initials"
7975+ default-value="FALSE">
7976+ <doc xml:space="preserve"
7977+ filename="src/adw-avatar.c"
7978+ line="403">Whether initials are used instead of an icon on the fallback avatar.
7979+
7980+See [property@Avatar:icon-name] for how to change the fallback icon.</doc>
7981+ <type name="gboolean" c:type="gboolean"/>
7982+ </property>
7983+ <property name="size"
7984+ writable="1"
7985+ transfer-ownership="none"
7986+ setter="set_size"
7987+ getter="get_size"
7988+ default-value="-1">
7989+ <doc xml:space="preserve"
7990+ filename="src/adw-avatar.c"
7991+ line="427">The size of the avatar.</doc>
7992+ <type name="gint" c:type="gint"/>
7993+ </property>
7994+ <property name="text"
7995+ writable="1"
7996+ transfer-ownership="none"
7997+ setter="set_text"
7998+ getter="get_text">
7999+ <doc xml:space="preserve"
8000+ filename="src/adw-avatar.c"
8001+ line="390">Sets the text used to generate the fallback initials and color.
8002+
8003+It's only used to generate the color if [property@Avatar:show-initials] is
8004+`FALSE`.</doc>
8005+ <type name="utf8" c:type="gchar*"/>
8006+ </property>
8007+ </class>
8008+ <record name="AvatarClass"
8009+ c:type="AdwAvatarClass"
8010+ glib:is-gtype-struct-for="Avatar">
8011+ <source-position filename="src/adw-avatar.h" line="22"/>
8012+ <field name="parent_class">
8013+ <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
8014+ </field>
8015+ </record>
8016+ <class name="Banner"
8017+ c:symbol-prefix="banner"
8018+ c:type="AdwBanner"
8019+ version="1.3"
8020+ parent="Gtk.Widget"
8021+ final="1"
8022+ glib:type-name="AdwBanner"
8023+ glib:get-type="adw_banner_get_type"
8024+ glib:type-struct="BannerClass">
8025+ <doc xml:space="preserve"
8026+ filename="src/adw-banner.c"
8027+ line="23">A bar with contextual information.
8028+
8029+&lt;picture&gt;
8030+ &lt;source srcset="banner-dark.png" media="(prefers-color-scheme: dark)"&gt;
8031+ &lt;img src="banner.png" alt="banner"&gt;
8032+&lt;/picture&gt;
8033+
8034+Banners are hidden by default, use [property@Banner:revealed] to show them.
8035+
8036+Banners have a title, set with [property@Banner:title]. Titles can be marked
8037+up with Pango markup, use [property@Banner:use-markup] to enable it.
8038+
8039+The title will be shown centered or left-aligned depending on available
8040+space.
8041+
8042+Banners can optionally have a button with text on it, set through
8043+[property@Banner:button-label]. The button can be used with a `GAction`,
8044+or with the [signal@Banner::button-clicked] signal.
8045+
8046+## CSS nodes
8047+
8048+`AdwBanner` has a main CSS node with the name `banner`.</doc>
8049+ <source-position filename="src/adw-banner.h" line="23"/>
8050+ <implements name="Gtk.Accessible"/>
8051+ <implements name="Gtk.Actionable"/>
8052+ <implements name="Gtk.Buildable"/>
8053+ <implements name="Gtk.ConstraintTarget"/>
8054+ <constructor name="new" c:identifier="adw_banner_new" version="1.3">
8055+ <doc xml:space="preserve"
8056+ filename="src/adw-banner.c"
8057+ line="507">Creates a new `AdwBanner`.</doc>
8058+ <source-position filename="src/adw-banner.h" line="26"/>
8059+ <return-value transfer-ownership="none">
8060+ <doc xml:space="preserve"
8061+ filename="src/adw-banner.c"
8062+ line="513">the newly created `AdwBanner`</doc>
8063+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
8064+ </return-value>
8065+ <parameters>
8066+ <parameter name="title" transfer-ownership="none">
8067+ <doc xml:space="preserve"
8068+ filename="src/adw-banner.c"
8069+ line="509">the banner title</doc>
8070+ <type name="utf8" c:type="const char*"/>
8071+ </parameter>
8072+ </parameters>
8073+ </constructor>
8074+ <method name="get_button_label"
8075+ c:identifier="adw_banner_get_button_label"
8076+ glib:get-property="button-label"
8077+ version="1.3">
8078+ <doc xml:space="preserve"
8079+ filename="src/adw-banner.c"
8080+ line="571">Gets the button label for @self.</doc>
8081+ <source-position filename="src/adw-banner.h" line="35"/>
8082+ <return-value transfer-ownership="none" nullable="1">
8083+ <doc xml:space="preserve"
8084+ filename="src/adw-banner.c"
8085+ line="577">the button label for @self</doc>
8086+ <type name="utf8" c:type="const char*"/>
8087+ </return-value>
8088+ <parameters>
8089+ <instance-parameter name="self" transfer-ownership="none">
8090+ <doc xml:space="preserve"
8091+ filename="src/adw-banner.c"
8092+ line="573">a banner</doc>
8093+ <type name="Banner" c:type="AdwBanner*"/>
8094+ </instance-parameter>
8095+ </parameters>
8096+ </method>
8097+ <method name="get_revealed"
8098+ c:identifier="adw_banner_get_revealed"
8099+ glib:get-property="revealed"
8100+ version="1.3">
8101+ <doc xml:space="preserve"
8102+ filename="src/adw-banner.c"
8103+ line="664">Gets if a banner is revealed</doc>
8104+ <source-position filename="src/adw-banner.h" line="41"/>
8105+ <return-value transfer-ownership="none">
8106+ <doc xml:space="preserve"
8107+ filename="src/adw-banner.c"
8108+ line="670">Whether a banner is revealed</doc>
8109+ <type name="gboolean" c:type="gboolean"/>
8110+ </return-value>
8111+ <parameters>
8112+ <instance-parameter name="self" transfer-ownership="none">
8113+ <doc xml:space="preserve"
8114+ filename="src/adw-banner.c"
8115+ line="666">a banner</doc>
8116+ <type name="Banner" c:type="AdwBanner*"/>
8117+ </instance-parameter>
8118+ </parameters>
8119+ </method>
8120+ <method name="get_title"
8121+ c:identifier="adw_banner_get_title"
8122+ glib:get-property="title"
8123+ version="1.3">
8124+ <doc xml:space="preserve"
8125+ filename="src/adw-banner.c"
8126+ line="527">Gets the title for @self.</doc>
8127+ <source-position filename="src/adw-banner.h" line="29"/>
8128+ <return-value transfer-ownership="none">
8129+ <doc xml:space="preserve"
8130+ filename="src/adw-banner.c"
8131+ line="533">the title for @self</doc>
8132+ <type name="utf8" c:type="const char*"/>
8133+ </return-value>
8134+ <parameters>
8135+ <instance-parameter name="self" transfer-ownership="none">
8136+ <doc xml:space="preserve"
8137+ filename="src/adw-banner.c"
8138+ line="529">a banner</doc>
8139+ <type name="Banner" c:type="AdwBanner*"/>
8140+ </instance-parameter>
8141+ </parameters>
8142+ </method>
8143+ <method name="get_use_markup"
8144+ c:identifier="adw_banner_get_use_markup"
8145+ glib:get-property="use-markup"
8146+ version="1.3">
8147+ <doc xml:space="preserve"
8148+ filename="src/adw-banner.c"
8149+ line="619">Gets whether to use Pango markup for the banner title.</doc>
8150+ <source-position filename="src/adw-banner.h" line="47"/>
8151+ <return-value transfer-ownership="none">
8152+ <doc xml:space="preserve"
8153+ filename="src/adw-banner.c"
8154+ line="625">whether to use markup</doc>
8155+ <type name="gboolean" c:type="gboolean"/>
8156+ </return-value>
8157+ <parameters>
8158+ <instance-parameter name="self" transfer-ownership="none">
8159+ <doc xml:space="preserve"
8160+ filename="src/adw-banner.c"
8161+ line="621">a banner</doc>
8162+ <type name="Banner" c:type="AdwBanner*"/>
8163+ </instance-parameter>
8164+ </parameters>
8165+ </method>
8166+ <method name="set_button_label"
8167+ c:identifier="adw_banner_set_button_label"
8168+ glib:set-property="button-label"
8169+ version="1.3">
8170+ <doc xml:space="preserve"
8171+ filename="src/adw-banner.c"
8172+ line="589">Sets the button label for @self.
8173+
8174+If set to `""` or `NULL`, the button won't be shown.
8175+
8176+The button can be used with a `GAction`, or with the
8177+[signal@Banner::button-clicked] signal.</doc>
8178+ <source-position filename="src/adw-banner.h" line="37"/>
8179+ <return-value transfer-ownership="none">
8180+ <type name="none" c:type="void"/>
8181+ </return-value>
8182+ <parameters>
8183+ <instance-parameter name="self" transfer-ownership="none">
8184+ <doc xml:space="preserve"
8185+ filename="src/adw-banner.c"
8186+ line="591">a banner</doc>
8187+ <type name="Banner" c:type="AdwBanner*"/>
8188+ </instance-parameter>
8189+ <parameter name="label"
8190+ transfer-ownership="none"
8191+ nullable="1"
8192+ allow-none="1">
8193+ <doc xml:space="preserve"
8194+ filename="src/adw-banner.c"
8195+ line="592">the label</doc>
8196+ <type name="utf8" c:type="const char*"/>
8197+ </parameter>
8198+ </parameters>
8199+ </method>
8200+ <method name="set_revealed"
8201+ c:identifier="adw_banner_set_revealed"
8202+ glib:set-property="revealed"
8203+ version="1.3">
8204+ <doc xml:space="preserve"
8205+ filename="src/adw-banner.c"
8206+ line="682">Sets whether a banner should be revealed</doc>
8207+ <source-position filename="src/adw-banner.h" line="43"/>
8208+ <return-value transfer-ownership="none">
8209+ <type name="none" c:type="void"/>
8210+ </return-value>
8211+ <parameters>
8212+ <instance-parameter name="self" transfer-ownership="none">
8213+ <doc xml:space="preserve"
8214+ filename="src/adw-banner.c"
8215+ line="684">a banner</doc>
8216+ <type name="Banner" c:type="AdwBanner*"/>
8217+ </instance-parameter>
8218+ <parameter name="revealed" transfer-ownership="none">
8219+ <doc xml:space="preserve"
8220+ filename="src/adw-banner.c"
8221+ line="685">whether a banner should be revealed</doc>
8222+ <type name="gboolean" c:type="gboolean"/>
8223+ </parameter>
8224+ </parameters>
8225+ </method>
8226+ <method name="set_title"
8227+ c:identifier="adw_banner_set_title"
8228+ glib:set-property="title"
8229+ version="1.3">
8230+ <doc xml:space="preserve"
8231+ filename="src/adw-banner.c"
8232+ line="545">Sets the title for this banner.
8233+
8234+See also: [property@Banner:use-markup].</doc>
8235+ <source-position filename="src/adw-banner.h" line="31"/>
8236+ <return-value transfer-ownership="none">
8237+ <type name="none" c:type="void"/>
8238+ </return-value>
8239+ <parameters>
8240+ <instance-parameter name="self" transfer-ownership="none">
8241+ <doc xml:space="preserve"
8242+ filename="src/adw-banner.c"
8243+ line="547">a banner</doc>
8244+ <type name="Banner" c:type="AdwBanner*"/>
8245+ </instance-parameter>
8246+ <parameter name="title" transfer-ownership="none">
8247+ <doc xml:space="preserve"
8248+ filename="src/adw-banner.c"
8249+ line="548">the title</doc>
8250+ <type name="utf8" c:type="const char*"/>
8251+ </parameter>
8252+ </parameters>
8253+ </method>
8254+ <method name="set_use_markup"
8255+ c:identifier="adw_banner_set_use_markup"
8256+ glib:set-property="use-markup"
8257+ version="1.3">
8258+ <doc xml:space="preserve"
8259+ filename="src/adw-banner.c"
8260+ line="637">Sets whether to use Pango markup for the banner title.
8261+
8262+See also [func@Pango.parse_markup].</doc>
8263+ <source-position filename="src/adw-banner.h" line="49"/>
8264+ <return-value transfer-ownership="none">
8265+ <type name="none" c:type="void"/>
8266+ </return-value>
8267+ <parameters>
8268+ <instance-parameter name="self" transfer-ownership="none">
8269+ <doc xml:space="preserve"
8270+ filename="src/adw-banner.c"
8271+ line="639">a banner</doc>
8272+ <type name="Banner" c:type="AdwBanner*"/>
8273+ </instance-parameter>
8274+ <parameter name="use_markup" transfer-ownership="none">
8275+ <doc xml:space="preserve"
8276+ filename="src/adw-banner.c"
8277+ line="640">whether to use markup</doc>
8278+ <type name="gboolean" c:type="gboolean"/>
8279+ </parameter>
8280+ </parameters>
8281+ </method>
8282+ <property name="button-label"
8283+ version="1.3"
8284+ writable="1"
8285+ transfer-ownership="none"
8286+ setter="set_button_label"
8287+ getter="get_button_label">
8288+ <doc xml:space="preserve"
8289+ filename="src/adw-banner.c"
8290+ line="367">The label to show on the button.
8291+
8292+If set to `""` or `NULL`, the button won't be shown.
8293+
8294+The button can be used with a `GAction`, or with the
8295+[signal@Banner::button-clicked] signal.</doc>
8296+ <type name="utf8" c:type="gchar*"/>
8297+ </property>
8298+ <property name="revealed"
8299+ version="1.3"
8300+ writable="1"
8301+ transfer-ownership="none"
8302+ setter="set_revealed"
8303+ getter="get_revealed"
8304+ default-value="FALSE">
8305+ <doc xml:space="preserve"
8306+ filename="src/adw-banner.c"
8307+ line="398">Whether the banner is currently revealed.</doc>
8308+ <type name="gboolean" c:type="gboolean"/>
8309+ </property>
8310+ <property name="title"
8311+ version="1.3"
8312+ writable="1"
8313+ transfer-ownership="none"
8314+ setter="set_title"
8315+ getter="get_title">
8316+ <doc xml:space="preserve"
8317+ filename="src/adw-banner.c"
8318+ line="353">The title for this banner.
8319+
8320+See also: [property@Banner:use-markup].</doc>
8321+ <type name="utf8" c:type="gchar*"/>
8322+ </property>
8323+ <property name="use-markup"
8324+ version="1.3"
8325+ writable="1"
8326+ transfer-ownership="none"
8327+ setter="set_use_markup"
8328+ getter="get_use_markup"
8329+ default-value="TRUE">
8330+ <doc xml:space="preserve"
8331+ filename="src/adw-banner.c"
8332+ line="384">Whether to use Pango markup for the banner title.
8333+
8334+See also [func@Pango.parse_markup].</doc>
8335+ <type name="gboolean" c:type="gboolean"/>
8336+ </property>
8337+ <glib:signal name="button-clicked" when="last" version="1.3">
8338+ <doc xml:space="preserve"
8339+ filename="src/adw-banner.c"
8340+ line="410">This signal is emitted after the action button has been clicked.
8341+
8342+It can be used as an alternative to setting an action.</doc>
8343+ <return-value transfer-ownership="none">
8344+ <type name="none" c:type="void"/>
8345+ </return-value>
8346+ </glib:signal>
8347+ </class>
8348+ <record name="BannerClass"
8349+ c:type="AdwBannerClass"
8350+ glib:is-gtype-struct-for="Banner">
8351+ <source-position filename="src/adw-banner.h" line="23"/>
8352+ <field name="parent_class">
8353+ <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
8354+ </field>
8355+ </record>
8356+ <class name="Bin"
8357+ c:symbol-prefix="bin"
8358+ c:type="AdwBin"
8359+ parent="Gtk.Widget"
8360+ glib:type-name="AdwBin"
8361+ glib:get-type="adw_bin_get_type"
8362+ glib:type-struct="BinClass">
8363+ <doc xml:space="preserve"
8364+ filename="src/adw-bin.c"
8365+ line="14">A widget with one child.
8366+
8367+&lt;picture&gt;
8368+ &lt;source srcset="bin-dark.png" media="(prefers-color-scheme: dark)"&gt;
8369+ &lt;img src="bin.png" alt="bin"&gt;
8370+&lt;/picture&gt;
8371+
8372+The `AdwBin` widget has only one child, set with the [property@Bin:child]
8373+property.
8374+
8375+It is useful for deriving subclasses, since it provides common code needed
8376+for handling a single child widget.</doc>
8377+ <source-position filename="src/adw-bin.h" line="29"/>
8378+ <implements name="Gtk.Accessible"/>
8379+ <implements name="Gtk.Buildable"/>
8380+ <implements name="Gtk.ConstraintTarget"/>
8381+ <constructor name="new" c:identifier="adw_bin_new">
8382+ <doc xml:space="preserve"
8383+ filename="src/adw-bin.c"
8384+ line="150">Creates a new `AdwBin`.</doc>
8385+ <source-position filename="src/adw-bin.h" line="32"/>
8386+ <return-value transfer-ownership="none">
8387+ <doc xml:space="preserve"
8388+ filename="src/adw-bin.c"
8389+ line="155">the new created `AdwBin`</doc>
8390+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
8391+ </return-value>
8392+ </constructor>
8393+ <method name="get_child"
8394+ c:identifier="adw_bin_get_child"
8395+ glib:get-property="child">
8396+ <doc xml:space="preserve"
8397+ filename="src/adw-bin.c"
8398+ line="163">Gets the child widget of @self.</doc>
8399+ <source-position filename="src/adw-bin.h" line="35"/>
8400+ <return-value transfer-ownership="none" nullable="1">
8401+ <doc xml:space="preserve"
8402+ filename="src/adw-bin.c"
8403+ line="169">the child widget of @self</doc>
8404+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
8405+ </return-value>
8406+ <parameters>
8407+ <instance-parameter name="self" transfer-ownership="none">
8408+ <doc xml:space="preserve"
8409+ filename="src/adw-bin.c"
8410+ line="165">a bin</doc>
8411+ <type name="Bin" c:type="AdwBin*"/>
8412+ </instance-parameter>
8413+ </parameters>
8414+ </method>
8415+ <method name="set_child"
8416+ c:identifier="adw_bin_set_child"
8417+ glib:set-property="child">
8418+ <doc xml:space="preserve"
8419+ filename="src/adw-bin.c"
8420+ line="183">Sets the child widget of @self.</doc>
8421+ <source-position filename="src/adw-bin.h" line="37"/>
8422+ <return-value transfer-ownership="none">
8423+ <type name="none" c:type="void"/>
8424+ </return-value>
8425+ <parameters>
8426+ <instance-parameter name="self" transfer-ownership="none">
8427+ <doc xml:space="preserve"
8428+ filename="src/adw-bin.c"
8429+ line="185">a bin</doc>
8430+ <type name="Bin" c:type="AdwBin*"/>
8431+ </instance-parameter>
8432+ <parameter name="child"
8433+ transfer-ownership="none"
8434+ nullable="1"
8435+ allow-none="1">
8436+ <doc xml:space="preserve"
8437+ filename="src/adw-bin.c"
8438+ line="186">the child widget</doc>
8439+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
8440+ </parameter>
8441+ </parameters>
8442+ </method>
8443+ <property name="child"
8444+ writable="1"
8445+ transfer-ownership="none"
8446+ setter="set_child"
8447+ getter="get_child">
8448+ <doc xml:space="preserve"
8449+ filename="src/adw-bin.c"
8450+ line="110">The child widget of the `AdwBin`.</doc>
8451+ <type name="Gtk.Widget"/>
8452+ </property>
8453+ <field name="parent_instance">
8454+ <type name="Gtk.Widget" c:type="GtkWidget"/>
8455+ </field>
8456+ </class>
8457+ <record name="BinClass"
8458+ c:type="AdwBinClass"
8459+ glib:is-gtype-struct-for="Bin">
8460+ <source-position filename="src/adw-bin.h" line="29"/>
8461+ <field name="parent_class">
8462+ <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
8463+ </field>
8464+ </record>
8465+ <class name="BottomSheet"
8466+ c:symbol-prefix="bottom_sheet"
8467+ c:type="AdwBottomSheet"
8468+ version="1.6"
8469+ parent="Gtk.Widget"
8470+ final="1"
8471+ glib:type-name="AdwBottomSheet"
8472+ glib:get-type="adw_bottom_sheet_get_type"
8473+ glib:type-struct="BottomSheetClass">
8474+ <doc xml:space="preserve"
8475+ filename="src/adw-bottom-sheet.c"
8476+ line="31">A bottom sheet with an optional bottom bar.
8477+
8478+&lt;picture&gt;
8479+ &lt;source srcset="bottom-sheet-dark.png" media="(prefers-color-scheme: dark)"&gt;
8480+ &lt;img src="bottom-sheet.png" alt="bottom-sheet"&gt;
8481+&lt;/picture&gt;
8482+
8483+`AdwBottomSheet` has three child widgets. [property@BottomSheet:content] is
8484+shown persistently. [property@BottomSheet:sheet] is displayed above it when
8485+it's open, and [property@BottomSheet:bottom-bar] is displayed when it's not.
8486+
8487+Bottom sheet and bottom bar are attached to the bottom edge of the widget.
8488+They take the full width by default, but can only take a portion of it if
8489+[property@BottomSheet:full-width] is set to `FALSE`. In this case,
8490+[property@BottomSheet:align] determines where along the bottom edge they are
8491+placed.
8492+
8493+`AdwBottomSheet` can be useful for applications such as music players, that
8494+want to have a persistent bottom bar that expands into a bottom sheet when
8495+clicked. It's meant for cases where a bottom sheet is tightly integrated into
8496+the UI. For more transient bottom sheets, see [class@Dialog].
8497+
8498+To open or close the bottom sheet, use the [property@BottomSheet:open]
8499+property.
8500+
8501+By default, the bottom sheet has an overlaid drag handle. It can be disabled
8502+by setting [property@BottomSheet:show-drag-handle] to `FALSE`. Note that the
8503+handle also controls whether the sheet can be dragged using a pointer.
8504+
8505+Bottom sheets are modal by default, meaning that the content is dimmed and
8506+cannot be accessed while the sheet is open. Set [property@BottomSheet:modal]
8507+to `FALSE` if this behavior is unwanted.
8508+
8509+To disable user interactions for opening or closing the bottom sheet (such as
8510+swipes or clicking the bottom bar or close button), set
8511+[property@BottomSheet:can-open] or [property@BottomSheet:can-close] to
8512+`FALSE`.
8513+
8514+In some cases, particularly when using a full-width bottom bar, it may be
8515+necessary to shift [property@BottomSheet:content] upwards. Use the
8516+[property@BottomSheet:bottom-bar-height] and
8517+[property@BottomSheet:sheet-height] for that.
8518+
8519+`AdwBottomSheet` is not adaptive, and for larger window sizes applications
8520+may want to replace it with another UI, such as a sidebar. This can be done
8521+using [class@MultiLayoutView].
8522+
8523+## Sizing
8524+
8525+Unlike [class@Dialog] presented as a bottom sheet, `AdwBottomSheet` just
8526+follows the content's natural size, and it's up to the applications to make
8527+sure their content provides one. For example, when using
8528+[class@Gtk.ScrolledWindow], make sure to set
8529+[property@Gtk.ScrolledWindow:propagate-natural-height] to `TRUE`.
8530+
8531+## Header Bar Integration
8532+
8533+When placed inside an `AdwBottomSheet`, [class@HeaderBar] will not show the
8534+title when [property@BottomSheet:show-drag-handle] is `TRUE`, regardless of
8535+[property@HeaderBar:show-title]. This only applies to the default title,
8536+titles set with [property@HeaderBar:title-widget] will still be shown.
8537+
8538+## `AdwBottomSheet` as `GtkBuildable`:
8539+
8540+The `AdwBottomSheet` implementation of the [iface@Gtk.Buildable] interface
8541+supports setting the sheet widget by specifying “sheet” as the “type”
8542+attribute of a `&lt;child&gt;` element, and the bottom bar by specifying
8543+“bottom-bar”. Specifying “content” or omitting the child type results in
8544+setting the content child.</doc>
8545+ <source-position filename="src/adw-bottom-sheet.h" line="24"/>
8546+ <implements name="Swipeable"/>
8547+ <implements name="Gtk.Accessible"/>
8548+ <implements name="Gtk.Buildable"/>
8549+ <implements name="Gtk.ConstraintTarget"/>
8550+ <constructor name="new"
8551+ c:identifier="adw_bottom_sheet_new"
8552+ version="1.6">
8553+ <doc xml:space="preserve"
8554+ filename="src/adw-bottom-sheet.c"
8555+ line="1335">Creates a new `AdwBottomSheet`.</doc>
8556+ <source-position filename="src/adw-bottom-sheet.h" line="27"/>
8557+ <return-value transfer-ownership="none">
8558+ <doc xml:space="preserve"
8559+ filename="src/adw-bottom-sheet.c"
8560+ line="1340">the new created `AdwBottomSheet`</doc>
8561+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
8562+ </return-value>
8563+ </constructor>
8564+ <method name="get_align"
8565+ c:identifier="adw_bottom_sheet_get_align"
8566+ glib:get-property="align"
8567+ version="1.6">
8568+ <doc xml:space="preserve"
8569+ filename="src/adw-bottom-sheet.c"
8570+ line="1657">Gets horizontal alignment of the bottom sheet.</doc>
8571+ <source-position filename="src/adw-bottom-sheet.h" line="54"/>
8572+ <return-value transfer-ownership="none">
8573+ <doc xml:space="preserve"
8574+ filename="src/adw-bottom-sheet.c"
8575+ line="1663">the horizontal alignment</doc>
8576+ <type name="gfloat" c:type="float"/>
8577+ </return-value>
8578+ <parameters>
8579+ <instance-parameter name="self" transfer-ownership="none">
8580+ <doc xml:space="preserve"
8581+ filename="src/adw-bottom-sheet.c"
8582+ line="1659">a bottom sheet</doc>
8583+ <type name="BottomSheet" c:type="AdwBottomSheet*"/>
8584+ </instance-parameter>
8585+ </parameters>
8586+ </method>
8587+ <method name="get_bottom_bar"
8588+ c:identifier="adw_bottom_sheet_get_bottom_bar"
8589+ glib:get-property="bottom-bar"
8590+ version="1.6">
8591+ <doc xml:space="preserve"
8592+ filename="src/adw-bottom-sheet.c"
8593+ line="1453">Gets the bottom bar widget for @self.</doc>
8594+ <source-position filename="src/adw-bottom-sheet.h" line="42"/>
8595+ <return-value transfer-ownership="none" nullable="1">
8596+ <doc xml:space="preserve"
8597+ filename="src/adw-bottom-sheet.c"
8598+ line="1459">the bottom bar widget</doc>
8599+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
8600+ </return-value>
8601+ <parameters>
8602+ <instance-parameter name="self" transfer-ownership="none">
8603+ <doc xml:space="preserve"
8604+ filename="src/adw-bottom-sheet.c"
8605+ line="1455">a bottom sheet</doc>
8606+ <type name="BottomSheet" c:type="AdwBottomSheet*"/>
8607+ </instance-parameter>
8608+ </parameters>
8609+ </method>
8610+ <method name="get_bottom_bar_height"
8611+ c:identifier="adw_bottom_sheet_get_bottom_bar_height"
8612+ glib:get-property="bottom-bar-height"
8613+ version="1.6">
8614+ <doc xml:space="preserve"
8615+ filename="src/adw-bottom-sheet.c"
8616+ line="1990">Gets the current bottom bar height.
8617+
8618+It can be used to shift the content upwards permanently to accommodate for
8619+the bottom bar.</doc>
8620+ <source-position filename="src/adw-bottom-sheet.h" line="92"/>
8621+ <return-value transfer-ownership="none">
8622+ <doc xml:space="preserve"
8623+ filename="src/adw-bottom-sheet.c"
8624+ line="1999">the bottom bar height</doc>
8625+ <type name="gint" c:type="int"/>
8626+ </return-value>
8627+ <parameters>
8628+ <instance-parameter name="self" transfer-ownership="none">
8629+ <doc xml:space="preserve"
8630+ filename="src/adw-bottom-sheet.c"
8631+ line="1992">a bottom sheet</doc>
8632+ <type name="BottomSheet" c:type="AdwBottomSheet*"/>
8633+ </instance-parameter>
8634+ </parameters>
8635+ </method>
8636+ <method name="get_can_close"
8637+ c:identifier="adw_bottom_sheet_get_can_close"
8638+ glib:get-property="can-close"
8639+ version="1.6">
8640+ <doc xml:space="preserve"
8641+ filename="src/adw-bottom-sheet.c"
8642+ line="1920">Gets whether the bottom sheet can be closed by user.</doc>
8643+ <source-position filename="src/adw-bottom-sheet.h" line="84"/>
8644+ <return-value transfer-ownership="none">
8645+ <doc xml:space="preserve"
8646+ filename="src/adw-bottom-sheet.c"
8647+ line="1926">whether the sheet can be closed by user</doc>
8648+ <type name="gboolean" c:type="gboolean"/>
8649+ </return-value>
8650+ <parameters>
8651+ <instance-parameter name="self" transfer-ownership="none">
8652+ <doc xml:space="preserve"
8653+ filename="src/adw-bottom-sheet.c"
8654+ line="1922">a bottom sheet</doc>
8655+ <type name="BottomSheet" c:type="AdwBottomSheet*"/>
8656+ </instance-parameter>
8657+ </parameters>
8658+ </method>
8659+ <method name="get_can_open"
8660+ c:identifier="adw_bottom_sheet_get_can_open"
8661+ glib:get-property="can-open"
8662+ version="1.6">
8663+ <doc xml:space="preserve"
8664+ filename="src/adw-bottom-sheet.c"
8665+ line="1864">Gets whether the bottom sheet can be opened by user.</doc>
8666+ <source-position filename="src/adw-bottom-sheet.h" line="78"/>
8667+ <return-value transfer-ownership="none">
8668+ <doc xml:space="preserve"
8669+ filename="src/adw-bottom-sheet.c"
8670+ line="1870">whether the sheet can be opened by user.</doc>
8671+ <type name="gboolean" c:type="gboolean"/>
8672+ </return-value>
8673+ <parameters>
8674+ <instance-parameter name="self" transfer-ownership="none">
8675+ <doc xml:space="preserve"
8676+ filename="src/adw-bottom-sheet.c"
8677+ line="1866">a bottom sheet</doc>
8678+ <type name="BottomSheet" c:type="AdwBottomSheet*"/>
8679+ </instance-parameter>
8680+ </parameters>
8681+ </method>
8682+ <method name="get_content"
8683+ c:identifier="adw_bottom_sheet_get_content"
8684+ glib:get-property="content"
8685+ version="1.6">
8686+ <doc xml:space="preserve"
8687+ filename="src/adw-bottom-sheet.c"
8688+ line="1350">Gets the content widget for @self.</doc>
8689+ <source-position filename="src/adw-bottom-sheet.h" line="30"/>
8690+ <return-value transfer-ownership="none" nullable="1">
8691+ <doc xml:space="preserve"
8692+ filename="src/adw-bottom-sheet.c"
8693+ line="1356">the content widget</doc>
8694+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
8695+ </return-value>
8696+ <parameters>
8697+ <instance-parameter name="self" transfer-ownership="none">
8698+ <doc xml:space="preserve"
8699+ filename="src/adw-bottom-sheet.c"
8700+ line="1352">a bottom sheet</doc>
8701+ <type name="BottomSheet" c:type="AdwBottomSheet*"/>
8702+ </instance-parameter>
8703+ </parameters>
8704+ </method>
8705+ <method name="get_full_width"
8706+ c:identifier="adw_bottom_sheet_get_full_width"
8707+ glib:get-property="full-width"
8708+ version="1.6">
8709+ <doc xml:space="preserve"
8710+ filename="src/adw-bottom-sheet.c"
8711+ line="1705">Gets whether the bottom sheet takes the full width.</doc>
8712+ <source-position filename="src/adw-bottom-sheet.h" line="60"/>
8713+ <return-value transfer-ownership="none">
8714+ <doc xml:space="preserve"
8715+ filename="src/adw-bottom-sheet.c"
8716+ line="1711">whether the sheet takes up the full width</doc>
8717+ <type name="gboolean" c:type="gboolean"/>
8718+ </return-value>
8719+ <parameters>
8720+ <instance-parameter name="self" transfer-ownership="none">
8721+ <doc xml:space="preserve"
8722+ filename="src/adw-bottom-sheet.c"
8723+ line="1707">a bottom sheet</doc>
8724+ <type name="BottomSheet" c:type="AdwBottomSheet*"/>
8725+ </instance-parameter>
8726+ </parameters>
8727+ </method>
8728+ <method name="get_modal"
8729+ c:identifier="adw_bottom_sheet_get_modal"
8730+ glib:get-property="modal"
8731+ version="1.6">
8732+ <doc xml:space="preserve"
8733+ filename="src/adw-bottom-sheet.c"
8734+ line="1812">Gets whether the bottom sheet is modal.</doc>
8735+ <source-position filename="src/adw-bottom-sheet.h" line="72"/>
8736+ <return-value transfer-ownership="none">
8737+ <doc xml:space="preserve"
8738+ filename="src/adw-bottom-sheet.c"
8739+ line="1818">whether the sheet is modal</doc>
8740+ <type name="gboolean" c:type="gboolean"/>
8741+ </return-value>
8742+ <parameters>
8743+ <instance-parameter name="self" transfer-ownership="none">
8744+ <doc xml:space="preserve"
8745+ filename="src/adw-bottom-sheet.c"
8746+ line="1814">a bottom sheet</doc>
8747+ <type name="BottomSheet" c:type="AdwBottomSheet*"/>
8748+ </instance-parameter>
8749+ </parameters>
8750+ </method>
8751+ <method name="get_open"
8752+ c:identifier="adw_bottom_sheet_get_open"
8753+ glib:get-property="open"
8754+ version="1.6">
8755+ <doc xml:space="preserve"
8756+ filename="src/adw-bottom-sheet.c"
8757+ line="1517">Gets whether the bottom sheet is open.</doc>
8758+ <source-position filename="src/adw-bottom-sheet.h" line="48"/>
8759+ <return-value transfer-ownership="none">
8760+ <doc xml:space="preserve"
8761+ filename="src/adw-bottom-sheet.c"
8762+ line="1523">whether the sheet is open</doc>
8763+ <type name="gboolean" c:type="gboolean"/>
8764+ </return-value>
8765+ <parameters>
8766+ <instance-parameter name="self" transfer-ownership="none">
8767+ <doc xml:space="preserve"
8768+ filename="src/adw-bottom-sheet.c"
8769+ line="1519">a bottom sheet</doc>
8770+ <type name="BottomSheet" c:type="AdwBottomSheet*"/>
8771+ </instance-parameter>
8772+ </parameters>
8773+ </method>
8774+ <method name="get_sheet"
8775+ c:identifier="adw_bottom_sheet_get_sheet"
8776+ glib:get-property="sheet"
8777+ version="1.6">
8778+ <doc xml:space="preserve"
8779+ filename="src/adw-bottom-sheet.c"
8780+ line="1400">Gets the bottom sheet widget for @self.</doc>
8781+ <source-position filename="src/adw-bottom-sheet.h" line="36"/>
8782+ <return-value transfer-ownership="none" nullable="1">
8783+ <doc xml:space="preserve"
8784+ filename="src/adw-bottom-sheet.c"
8785+ line="1406">the sheet widget</doc>
8786+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
8787+ </return-value>
8788+ <parameters>
8789+ <instance-parameter name="self" transfer-ownership="none">
8790+ <doc xml:space="preserve"
8791+ filename="src/adw-bottom-sheet.c"
8792+ line="1402">a bottom sheet</doc>
8793+ <type name="BottomSheet" c:type="AdwBottomSheet*"/>
8794+ </instance-parameter>
8795+ </parameters>
8796+ </method>
8797+ <method name="get_sheet_height"
8798+ c:identifier="adw_bottom_sheet_get_sheet_height"
8799+ glib:get-property="sheet-height"
8800+ version="1.6">
8801+ <doc xml:space="preserve"
8802+ filename="src/adw-bottom-sheet.c"
8803+ line="1970">Gets the current bottom sheet height.
8804+
8805+It can be used to shift the content upwards when the bottom sheet is open.</doc>
8806+ <source-position filename="src/adw-bottom-sheet.h" line="90"/>
8807+ <return-value transfer-ownership="none">
8808+ <doc xml:space="preserve"
8809+ filename="src/adw-bottom-sheet.c"
8810+ line="1978">the sheet height</doc>
8811+ <type name="gint" c:type="int"/>
8812+ </return-value>
8813+ <parameters>
8814+ <instance-parameter name="self" transfer-ownership="none">
8815+ <doc xml:space="preserve"
8816+ filename="src/adw-bottom-sheet.c"
8817+ line="1972">a bottom sheet</doc>
8818+ <type name="BottomSheet" c:type="AdwBottomSheet*"/>
8819+ </instance-parameter>
8820+ </parameters>
8821+ </method>
8822+ <method name="get_show_drag_handle"
8823+ c:identifier="adw_bottom_sheet_get_show_drag_handle"
8824+ glib:get-property="show-drag-handle"
8825+ version="1.6">
8826+ <doc xml:space="preserve"
8827+ filename="src/adw-bottom-sheet.c"
8828+ line="1752">Gets whether to show a drag handle in the bottom sheet.</doc>
8829+ <source-position filename="src/adw-bottom-sheet.h" line="66"/>
8830+ <return-value transfer-ownership="none">
8831+ <doc xml:space="preserve"
8832+ filename="src/adw-bottom-sheet.c"
8833+ line="1758">whether to show the drag handle</doc>
8834+ <type name="gboolean" c:type="gboolean"/>
8835+ </return-value>
8836+ <parameters>
8837+ <instance-parameter name="self" transfer-ownership="none">
8838+ <doc xml:space="preserve"
8839+ filename="src/adw-bottom-sheet.c"
8840+ line="1754">a bottom sheet</doc>
8841+ <type name="BottomSheet" c:type="AdwBottomSheet*"/>
8842+ </instance-parameter>
8843+ </parameters>
8844+ </method>
8845+ <method name="set_align"
8846+ c:identifier="adw_bottom_sheet_set_align"
8847+ glib:set-property="align"
8848+ version="1.6">
8849+ <doc xml:space="preserve"
8850+ filename="src/adw-bottom-sheet.c"
8851+ line="1675">Sets horizontal alignment of the bottom sheet.
8852+
8853+0 means the bottom sheet is flush with the start edge, 1 means it's flush
8854+with the end edge. 0.5 means it's centered.
8855+
8856+Only used when [property@BottomSheet:full-width] is set to `FALSE`.</doc>
8857+ <source-position filename="src/adw-bottom-sheet.h" line="56"/>
8858+ <return-value transfer-ownership="none">
8859+ <type name="none" c:type="void"/>
8860+ </return-value>
8861+ <parameters>
8862+ <instance-parameter name="self" transfer-ownership="none">
8863+ <doc xml:space="preserve"
8864+ filename="src/adw-bottom-sheet.c"
8865+ line="1677">a bottom sheet</doc>
8866+ <type name="BottomSheet" c:type="AdwBottomSheet*"/>
8867+ </instance-parameter>
8868+ <parameter name="align" transfer-ownership="none">
8869+ <doc xml:space="preserve"
8870+ filename="src/adw-bottom-sheet.c"
8871+ line="1678">the new alignment</doc>
8872+ <type name="gfloat" c:type="float"/>
8873+ </parameter>
8874+ </parameters>
8875+ </method>
8876+ <method name="set_bottom_bar"
8877+ c:identifier="adw_bottom_sheet_set_bottom_bar"
8878+ glib:set-property="bottom-bar"
8879+ version="1.6">
8880+ <doc xml:space="preserve"
8881+ filename="src/adw-bottom-sheet.c"
8882+ line="1471">Sets the bottom bar widget for @self.
8883+
8884+Shown when [property@BottomSheet:open] is `FALSE`. When open, morphs into
8885+the [property@BottomSheet:sheet].</doc>
8886+ <source-position filename="src/adw-bottom-sheet.h" line="44"/>
8887+ <return-value transfer-ownership="none">
8888+ <type name="none" c:type="void"/>
8889+ </return-value>
8890+ <parameters>
8891+ <instance-parameter name="self" transfer-ownership="none">
8892+ <doc xml:space="preserve"
8893+ filename="src/adw-bottom-sheet.c"
8894+ line="1473">a bottom sheet</doc>
8895+ <type name="BottomSheet" c:type="AdwBottomSheet*"/>
8896+ </instance-parameter>
8897+ <parameter name="bottom_bar"
8898+ transfer-ownership="none"
8899+ nullable="1"
8900+ allow-none="1">
8901+ <doc xml:space="preserve"
8902+ filename="src/adw-bottom-sheet.c"
8903+ line="1474">the bottom bar widget</doc>
8904+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
8905+ </parameter>
8906+ </parameters>
8907+ </method>
8908+ <method name="set_can_close"
8909+ c:identifier="adw_bottom_sheet_set_can_close"
8910+ glib:set-property="can-close"
8911+ version="1.6">
8912+ <doc xml:space="preserve"
8913+ filename="src/adw-bottom-sheet.c"
8914+ line="1938">Sets whether the bottom sheet can be closed by user.
8915+
8916+It can be closed via the close button, swiping down, pressing
8917+&lt;kbd&gt;Escape&lt;/kbd&gt; or clicking the content dimming (when modal).
8918+
8919+Bottom sheet can still be closed using [property@BottomSheet:open].</doc>
8920+ <source-position filename="src/adw-bottom-sheet.h" line="86"/>
8921+ <return-value transfer-ownership="none">
8922+ <type name="none" c:type="void"/>
8923+ </return-value>
8924+ <parameters>
8925+ <instance-parameter name="self" transfer-ownership="none">
8926+ <doc xml:space="preserve"
8927+ filename="src/adw-bottom-sheet.c"
8928+ line="1940">a bottom sheet</doc>
8929+ <type name="BottomSheet" c:type="AdwBottomSheet*"/>
8930+ </instance-parameter>
8931+ <parameter name="can_close" transfer-ownership="none">
8932+ <doc xml:space="preserve"
8933+ filename="src/adw-bottom-sheet.c"
8934+ line="1941">whether the sheet can be closed by user</doc>
8935+ <type name="gboolean" c:type="gboolean"/>
8936+ </parameter>
8937+ </parameters>
8938+ </method>
8939+ <method name="set_can_open"
8940+ c:identifier="adw_bottom_sheet_set_can_open"
8941+ glib:set-property="can-open"
8942+ version="1.6">
8943+ <doc xml:space="preserve"
8944+ filename="src/adw-bottom-sheet.c"
8945+ line="1882">Sets whether the bottom sheet can be opened by user.
8946+
8947+It can be opened via clicking or swiping up from the bottom bar.
8948+
8949+Does nothing if [property@BottomSheet:bottom-bar] is not set.
8950+
8951+Bottom sheet can still be opened using [property@BottomSheet:open].</doc>
8952+ <source-position filename="src/adw-bottom-sheet.h" line="80"/>
8953+ <return-value transfer-ownership="none">
8954+ <type name="none" c:type="void"/>
8955+ </return-value>
8956+ <parameters>
8957+ <instance-parameter name="self" transfer-ownership="none">
8958+ <doc xml:space="preserve"
8959+ filename="src/adw-bottom-sheet.c"
8960+ line="1884">a bottom sheet</doc>
8961+ <type name="BottomSheet" c:type="AdwBottomSheet*"/>
8962+ </instance-parameter>
8963+ <parameter name="can_open" transfer-ownership="none">
8964+ <doc xml:space="preserve"
8965+ filename="src/adw-bottom-sheet.c"
8966+ line="1885">whether the sheet can be opened by user.</doc>
8967+ <type name="gboolean" c:type="gboolean"/>
8968+ </parameter>
8969+ </parameters>
8970+ </method>
8971+ <method name="set_content"
8972+ c:identifier="adw_bottom_sheet_set_content"
8973+ glib:set-property="content"
8974+ version="1.6">
8975+ <doc xml:space="preserve"
8976+ filename="src/adw-bottom-sheet.c"
8977+ line="1368">Sets the content widget for @self.
8978+
8979+It's always shown, and the bottom sheet is overlaid over it.</doc>
8980+ <source-position filename="src/adw-bottom-sheet.h" line="32"/>
8981+ <return-value transfer-ownership="none">
8982+ <type name="none" c:type="void"/>
8983+ </return-value>
8984+ <parameters>
8985+ <instance-parameter name="self" transfer-ownership="none">
8986+ <doc xml:space="preserve"
8987+ filename="src/adw-bottom-sheet.c"
8988+ line="1370">a bottom sheet</doc>
8989+ <type name="BottomSheet" c:type="AdwBottomSheet*"/>
8990+ </instance-parameter>
8991+ <parameter name="content"
8992+ transfer-ownership="none"
8993+ nullable="1"
8994+ allow-none="1">
8995+ <doc xml:space="preserve"
8996+ filename="src/adw-bottom-sheet.c"
8997+ line="1371">the content widget</doc>
8998+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
8999+ </parameter>
9000+ </parameters>
9001+ </method>
9002+ <method name="set_full_width"
9003+ c:identifier="adw_bottom_sheet_set_full_width"
9004+ glib:set-property="full-width"
9005+ version="1.6">
9006+ <doc xml:space="preserve"
9007+ filename="src/adw-bottom-sheet.c"
9008+ line="1723">Sets whether the bottom sheet takes the full width.
9009+
9010+When full width, [property@BottomSheet:align] is ignored.</doc>
9011+ <source-position filename="src/adw-bottom-sheet.h" line="62"/>
9012+ <return-value transfer-ownership="none">
9013+ <type name="none" c:type="void"/>
9014+ </return-value>
9015+ <parameters>
9016+ <instance-parameter name="self" transfer-ownership="none">
9017+ <doc xml:space="preserve"
9018+ filename="src/adw-bottom-sheet.c"
9019+ line="1725">a bottom sheet</doc>
9020+ <type name="BottomSheet" c:type="AdwBottomSheet*"/>
9021+ </instance-parameter>
9022+ <parameter name="full_width" transfer-ownership="none">
9023+ <doc xml:space="preserve"
9024+ filename="src/adw-bottom-sheet.c"
9025+ line="1726">whether the sheet takes up the full width</doc>
9026+ <type name="gboolean" c:type="gboolean"/>
9027+ </parameter>
9028+ </parameters>
9029+ </method>
9030+ <method name="set_modal"
9031+ c:identifier="adw_bottom_sheet_set_modal"
9032+ glib:set-property="modal"
9033+ version="1.6">
9034+ <doc xml:space="preserve"
9035+ filename="src/adw-bottom-sheet.c"
9036+ line="1830">Sets whether the bottom sheet is modal.
9037+
9038+When modal, [property@BottomSheet:content] will be dimmed when the bottom
9039+sheet is open, and clicking it will close the bottom sheet. It also cannot be
9040+focused with keyboard.
9041+
9042+Otherwise, the content is accessible even when the bottom sheet is open.</doc>
9043+ <source-position filename="src/adw-bottom-sheet.h" line="74"/>
9044+ <return-value transfer-ownership="none">
9045+ <type name="none" c:type="void"/>
9046+ </return-value>
9047+ <parameters>
9048+ <instance-parameter name="self" transfer-ownership="none">
9049+ <doc xml:space="preserve"
9050+ filename="src/adw-bottom-sheet.c"
9051+ line="1832">a bottom sheet</doc>
9052+ <type name="BottomSheet" c:type="AdwBottomSheet*"/>
9053+ </instance-parameter>
9054+ <parameter name="modal" transfer-ownership="none">
9055+ <doc xml:space="preserve"
9056+ filename="src/adw-bottom-sheet.c"
9057+ line="1833">whether the sheet is modal</doc>
9058+ <type name="gboolean" c:type="gboolean"/>
9059+ </parameter>
9060+ </parameters>
9061+ </method>
9062+ <method name="set_open"
9063+ c:identifier="adw_bottom_sheet_set_open"
9064+ glib:set-property="open"
9065+ version="1.6">
9066+ <doc xml:space="preserve"
9067+ filename="src/adw-bottom-sheet.c"
9068+ line="1535">Sets whether the bottom sheet is open.</doc>
9069+ <source-position filename="src/adw-bottom-sheet.h" line="50"/>
9070+ <return-value transfer-ownership="none">
9071+ <type name="none" c:type="void"/>
9072+ </return-value>
9073+ <parameters>
9074+ <instance-parameter name="self" transfer-ownership="none">
9075+ <doc xml:space="preserve"
9076+ filename="src/adw-bottom-sheet.c"
9077+ line="1537">a bottom sheet</doc>
9078+ <type name="BottomSheet" c:type="AdwBottomSheet*"/>
9079+ </instance-parameter>
9080+ <parameter name="open" transfer-ownership="none">
9081+ <doc xml:space="preserve"
9082+ filename="src/adw-bottom-sheet.c"
9083+ line="1538">whether to open the sheet</doc>
9084+ <type name="gboolean" c:type="gboolean"/>
9085+ </parameter>
9086+ </parameters>
9087+ </method>
9088+ <method name="set_sheet"
9089+ c:identifier="adw_bottom_sheet_set_sheet"
9090+ glib:set-property="sheet"
9091+ version="1.6">
9092+ <doc xml:space="preserve"
9093+ filename="src/adw-bottom-sheet.c"
9094+ line="1418">Sets the bottom sheet widget for @self.
9095+
9096+Only shown when [property@BottomSheet:open] is `TRUE`.</doc>
9097+ <source-position filename="src/adw-bottom-sheet.h" line="38"/>
9098+ <return-value transfer-ownership="none">
9099+ <type name="none" c:type="void"/>
9100+ </return-value>
9101+ <parameters>
9102+ <instance-parameter name="self" transfer-ownership="none">
9103+ <doc xml:space="preserve"
9104+ filename="src/adw-bottom-sheet.c"
9105+ line="1420">a bottom sheet</doc>
9106+ <type name="BottomSheet" c:type="AdwBottomSheet*"/>
9107+ </instance-parameter>
9108+ <parameter name="sheet"
9109+ transfer-ownership="none"
9110+ nullable="1"
9111+ allow-none="1">
9112+ <doc xml:space="preserve"
9113+ filename="src/adw-bottom-sheet.c"
9114+ line="1421">the sheet widget</doc>
9115+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
9116+ </parameter>
9117+ </parameters>
9118+ </method>
9119+ <method name="set_show_drag_handle"
9120+ c:identifier="adw_bottom_sheet_set_show_drag_handle"
9121+ glib:set-property="show-drag-handle"
9122+ version="1.6">
9123+ <doc xml:space="preserve"
9124+ filename="src/adw-bottom-sheet.c"
9125+ line="1770">Sets whether to show a drag handle in the bottom sheet.
9126+
9127+The handle will be overlaid over [property@BottomSheet:sheet].
9128+
9129+When the handle is shown, [class@HeaderBar] will hide its default title, and
9130+[class@ToolbarView] will reserve space if there are no top bars.
9131+
9132+Showing drag handle also allows to swipe the bottom sheet down (and to swipe
9133+the bottom bar up) with a pointer, instead of just touchscreen.</doc>
9134+ <source-position filename="src/adw-bottom-sheet.h" line="68"/>
9135+ <return-value transfer-ownership="none">
9136+ <type name="none" c:type="void"/>
9137+ </return-value>
9138+ <parameters>
9139+ <instance-parameter name="self" transfer-ownership="none">
9140+ <doc xml:space="preserve"
9141+ filename="src/adw-bottom-sheet.c"
9142+ line="1772">a bottom sheet</doc>
9143+ <type name="BottomSheet" c:type="AdwBottomSheet*"/>
9144+ </instance-parameter>
9145+ <parameter name="show_drag_handle" transfer-ownership="none">
9146+ <doc xml:space="preserve"
9147+ filename="src/adw-bottom-sheet.c"
9148+ line="1773">whether to show the drag handle</doc>
9149+ <type name="gboolean" c:type="gboolean"/>
9150+ </parameter>
9151+ </parameters>
9152+ </method>
9153+ <property name="align"
9154+ version="1.6"
9155+ writable="1"
9156+ transfer-ownership="none"
9157+ setter="set_align"
9158+ getter="get_align"
9159+ default-value="0.500000">
9160+ <doc xml:space="preserve"
9161+ filename="src/adw-bottom-sheet.c"
9162+ line="786">Horizontal alignment of the bottom sheet.
9163+
9164+0 means the bottom sheet is flush with the start edge, 1 means it's flush
9165+with the end edge. 0.5 means it's centered.
9166+
9167+Only used when [property@BottomSheet:full-width] is set to `FALSE`.</doc>
9168+ <type name="gfloat" c:type="gfloat"/>
9169+ </property>
9170+ <property name="bottom-bar"
9171+ version="1.6"
9172+ writable="1"
9173+ transfer-ownership="none"
9174+ setter="set_bottom_bar"
9175+ getter="get_bottom_bar">
9176+ <doc xml:space="preserve"
9177+ filename="src/adw-bottom-sheet.c"
9178+ line="759">The bottom bar widget.
9179+
9180+Shown when [property@BottomSheet:open] is `FALSE`. When open, morphs into
9181+the [property@BottomSheet:sheet].</doc>
9182+ <type name="Gtk.Widget"/>
9183+ </property>
9184+ <property name="bottom-bar-height"
9185+ version="1.6"
9186+ transfer-ownership="none"
9187+ getter="get_bottom_bar_height"
9188+ default-value="0">
9189+ <doc xml:space="preserve"
9190+ filename="src/adw-bottom-sheet.c"
9191+ line="904">The current bottom bar height.
9192+
9193+It can be used to shift the content upwards permanently to accommodate for
9194+the bottom bar.</doc>
9195+ <type name="gint" c:type="gint"/>
9196+ </property>
9197+ <property name="can-close"
9198+ version="1.6"
9199+ writable="1"
9200+ transfer-ownership="none"
9201+ setter="set_can_close"
9202+ getter="get_can_close"
9203+ default-value="TRUE">
9204+ <doc xml:space="preserve"
9205+ filename="src/adw-bottom-sheet.c"
9206+ line="873">Whether the bottom sheet can be closed by user.
9207+
9208+It can be closed via the close button, swiping down, pressing
9209+&lt;kbd&gt;Escape&lt;/kbd&gt; or clicking the content dimming (when modal).
9210+
9211+Bottom sheet can still be closed using [property@BottomSheet:open].</doc>
9212+ <type name="gboolean" c:type="gboolean"/>
9213+ </property>
9214+ <property name="can-open"
9215+ version="1.6"
9216+ writable="1"
9217+ transfer-ownership="none"
9218+ setter="set_can_open"
9219+ getter="get_can_open"
9220+ default-value="TRUE">
9221+ <doc xml:space="preserve"
9222+ filename="src/adw-bottom-sheet.c"
9223+ line="855">Whether the bottom sheet can be opened by user.
9224+
9225+It can be opened via clicking or swiping up from the bottom bar.
9226+
9227+Does nothing if [property@BottomSheet:bottom-bar] is not set.
9228+
9229+Bottom sheet can still be opened using [property@BottomSheet:open].</doc>
9230+ <type name="gboolean" c:type="gboolean"/>
9231+ </property>
9232+ <property name="content"
9233+ version="1.6"
9234+ writable="1"
9235+ transfer-ownership="none"
9236+ setter="set_content"
9237+ getter="get_content">
9238+ <doc xml:space="preserve"
9239+ filename="src/adw-bottom-sheet.c"
9240+ line="731">The content widget.
9241+
9242+It's always shown, and the bottom sheet is overlaid over it.</doc>
9243+ <type name="Gtk.Widget"/>
9244+ </property>
9245+ <property name="full-width"
9246+ version="1.6"
9247+ writable="1"
9248+ transfer-ownership="none"
9249+ setter="set_full_width"
9250+ getter="get_full_width"
9251+ default-value="TRUE">
9252+ <doc xml:space="preserve"
9253+ filename="src/adw-bottom-sheet.c"
9254+ line="803">Whether the bottom sheet takes the full width.
9255+
9256+When full width, [property@BottomSheet:align] is ignored.</doc>
9257+ <type name="gboolean" c:type="gboolean"/>
9258+ </property>
9259+ <property name="modal"
9260+ version="1.6"
9261+ writable="1"
9262+ transfer-ownership="none"
9263+ setter="set_modal"
9264+ getter="get_modal"
9265+ default-value="TRUE">
9266+ <doc xml:space="preserve"
9267+ filename="src/adw-bottom-sheet.c"
9268+ line="837">Whether the bottom sheet is modal.
9269+
9270+When modal, [property@BottomSheet:content] will be dimmed when the bottom
9271+sheet is open, and clicking it will close the bottom sheet. It also cannot
9272+be focused with keyboard.
9273+
9274+Otherwise, the content is accessible even when the bottom sheet is open.</doc>
9275+ <type name="gboolean" c:type="gboolean"/>
9276+ </property>
9277+ <property name="open"
9278+ version="1.6"
9279+ writable="1"
9280+ transfer-ownership="none"
9281+ setter="set_open"
9282+ getter="get_open"
9283+ default-value="FALSE">
9284+ <doc xml:space="preserve"
9285+ filename="src/adw-bottom-sheet.c"
9286+ line="774">Whether the bottom sheet is open.</doc>
9287+ <type name="gboolean" c:type="gboolean"/>
9288+ </property>
9289+ <property name="sheet"
9290+ version="1.6"
9291+ writable="1"
9292+ transfer-ownership="none"
9293+ setter="set_sheet"
9294+ getter="get_sheet">
9295+ <doc xml:space="preserve"
9296+ filename="src/adw-bottom-sheet.c"
9297+ line="745">The bottom sheet widget.
9298+
9299+Only shown when [property@BottomSheet:open] is `TRUE`.</doc>
9300+ <type name="Gtk.Widget"/>
9301+ </property>
9302+ <property name="sheet-height"
9303+ version="1.6"
9304+ transfer-ownership="none"
9305+ getter="get_sheet_height"
9306+ default-value="0">
9307+ <doc xml:space="preserve"
9308+ filename="src/adw-bottom-sheet.c"
9309+ line="890">The current bottom sheet height.
9310+
9311+It can be used to shift the content upwards when the bottom sheet is open.</doc>
9312+ <type name="gint" c:type="gint"/>
9313+ </property>
9314+ <property name="show-drag-handle"
9315+ version="1.6"
9316+ writable="1"
9317+ transfer-ownership="none"
9318+ setter="set_show_drag_handle"
9319+ getter="get_show_drag_handle"
9320+ default-value="TRUE">
9321+ <doc xml:space="preserve"
9322+ filename="src/adw-bottom-sheet.c"
9323+ line="817">Whether to overlay a drag handle in the bottom sheet.
9324+
9325+The handle will be overlaid over [property@BottomSheet:sheet].
9326+
9327+When the handle is shown, [class@HeaderBar] will hide its default title,
9328+and [class@ToolbarView] will reserve space if there are no top bars.
9329+
9330+Showing drag handle also allows to swipe the bottom sheet down (and to
9331+swipe the bottom bar up) with a pointer, instead of just touchscreen.</doc>
9332+ <type name="gboolean" c:type="gboolean"/>
9333+ </property>
9334+ <glib:signal name="close-attempt" when="last" version="1.6">
9335+ <doc xml:space="preserve"
9336+ filename="src/adw-bottom-sheet.c"
9337+ line="921">Emitted when the close button or shortcut is used while
9338+[property@Dialog:can-close] is set to `FALSE`.</doc>
9339+ <return-value transfer-ownership="none">
9340+ <type name="none" c:type="void"/>
9341+ </return-value>
9342+ </glib:signal>
9343+ </class>
9344+ <record name="BottomSheetClass"
9345+ c:type="AdwBottomSheetClass"
9346+ glib:is-gtype-struct-for="BottomSheet">
9347+ <source-position filename="src/adw-bottom-sheet.h" line="24"/>
9348+ <field name="parent_class">
9349+ <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
9350+ </field>
9351+ </record>
9352+ <class name="Breakpoint"
9353+ c:symbol-prefix="breakpoint"
9354+ c:type="AdwBreakpoint"
9355+ version="1.4"
9356+ parent="GObject.Object"
9357+ final="1"
9358+ glib:type-name="AdwBreakpoint"
9359+ glib:get-type="adw_breakpoint_get_type"
9360+ glib:type-struct="BreakpointClass">
9361+ <doc xml:space="preserve"
9362+ filename="src/adw-breakpoint.c"
9363+ line="19">Describes a breakpoint for [class@Window] or [class@Dialog].
9364+
9365+Breakpoints are used to create adaptive UI, allowing to change the layout
9366+depending on available size.
9367+
9368+Breakpoint is a size threshold, specified by its condition, as well as one or
9369+more setters.
9370+
9371+Each setter has a target object, a property and a value. When a breakpoint
9372+is applied, each setter sets the target property on their target object to
9373+the specified value, and reset it back to the original value when it's
9374+unapplied.
9375+
9376+For more complicated scenarios, [signal@Breakpoint::apply] and
9377+[signal@Breakpoint::unapply] can be used instead.
9378+
9379+Breakpoints can be used within [class@Window], [class@ApplicationWindow],
9380+[class@Dialog] or [class@BreakpointBin].
9381+
9382+## `AdwBreakpoint` as `GtkBuildable`:
9383+
9384+`AdwBreakpoint` supports specifying its condition via the `&lt;condition&gt;`
9385+element. The contents of the element must be a string in a format accepted by
9386+[func@BreakpointCondition.parse].
9387+
9388+It also supports adding setters via the `&lt;setter&gt;` element. Each `&lt;setter&gt;`
9389+element must have the `object` attribute specifying the target object, and
9390+the `property` attribute specifying the property name. The contents of the
9391+element are used as the setter value.
9392+
9393+For `G_TYPE_OBJECT` and `G_TYPE_BOXED` derived properties, empty contents are
9394+treated as `NULL`.
9395+
9396+Setter values can be translated with the usual `translatable`, `context` and
9397+`comments` attributes.
9398+
9399+Example of an `AdwBreakpoint` UI definition:
9400+
9401+```xml
9402+&lt;object class="AdwBreakpoint"&gt;
9403+ &lt;condition&gt;max-width: 400px&lt;/condition&gt;
9404+ &lt;setter object="button" property="visible"&gt;True&lt;/setter&gt;
9405+ &lt;setter object="box" property="orientation"&gt;vertical&lt;/setter&gt;
9406+ &lt;setter object="page" property="title" translatable="yes"&gt;Example&lt;/setter&gt;
9407+&lt;/object&gt;
9408+```</doc>
9409+ <source-position filename="src/adw-breakpoint.h" line="76"/>
9410+ <implements name="Gtk.Buildable"/>
9411+ <constructor name="new" c:identifier="adw_breakpoint_new" version="1.4">
9412+ <doc xml:space="preserve"
9413+ filename="src/adw-breakpoint.c"
9414+ line="1462">Creates a new `AdwBreakpoint` with @condition.</doc>
9415+ <source-position filename="src/adw-breakpoint.h" line="79"/>
9416+ <return-value transfer-ownership="full">
9417+ <doc xml:space="preserve"
9418+ filename="src/adw-breakpoint.c"
9419+ line="1468">the newly created `AdwBreakpoint`</doc>
9420+ <type name="Breakpoint" c:type="AdwBreakpoint*"/>
9421+ </return-value>
9422+ <parameters>
9423+ <parameter name="condition" transfer-ownership="full">
9424+ <doc xml:space="preserve"
9425+ filename="src/adw-breakpoint.c"
9426+ line="1464">the condition</doc>
9427+ <type name="BreakpointCondition" c:type="AdwBreakpointCondition*"/>
9428+ </parameter>
9429+ </parameters>
9430+ </constructor>
9431+ <method name="add_setter"
9432+ c:identifier="adw_breakpoint_add_setter"
9433+ version="1.4">
9434+ <doc xml:space="preserve"
9435+ filename="src/adw-breakpoint.c"
9436+ line="1532">Adds a setter to @self.
9437+
9438+The setter will automatically set @property on @object to @value when
9439+applying the breakpoint, and set it back to its original value upon
9440+unapplying it.
9441+
9442+::: note
9443+ Setting properties to their original values does not work for properties
9444+ that have irreversible side effects. For example, changing
9445+ [property@Gtk.Button:label] while [property@Gtk.Button:icon-name] is set
9446+ will reset the icon. However, resetting the label will not set
9447+ `icon-name` to its original value.
9448+
9449+Use the [signal@Breakpoint::apply] and [signal@Breakpoint::unapply] signals
9450+for those properties instead, as follows:
9451+
9452+```c
9453+static void
9454+breakpoint_apply_cb (MyWidget *self)
9455+{
9456+ gtk_button_set_icon_name (self-&gt;button, "go-previous-symbolic");
9457+}
9458+
9459+static void
9460+breakpoint_apply_cb (MyWidget *self)
9461+{
9462+ gtk_button_set_label (self-&gt;button, _("_Back"));
9463+}
9464+
9465+// ...
9466+
9467+g_signal_connect_swapped (breakpoint, "apply",
9468+ G_CALLBACK (breakpoint_apply_cb), self);
9469+g_signal_connect_swapped (breakpoint, "unapply",
9470+ G_CALLBACK (breakpoint_unapply_cb), self);
9471+```</doc>
9472+ <source-position filename="src/adw-breakpoint.h" line="88"/>
9473+ <return-value transfer-ownership="none">
9474+ <type name="none" c:type="void"/>
9475+ </return-value>
9476+ <parameters>
9477+ <instance-parameter name="self" transfer-ownership="none">
9478+ <doc xml:space="preserve"
9479+ filename="src/adw-breakpoint.c"
9480+ line="1534">a breakpoint</doc>
9481+ <type name="Breakpoint" c:type="AdwBreakpoint*"/>
9482+ </instance-parameter>
9483+ <parameter name="object" transfer-ownership="none">
9484+ <doc xml:space="preserve"
9485+ filename="src/adw-breakpoint.c"
9486+ line="1535">the target object</doc>
9487+ <type name="GObject.Object" c:type="GObject*"/>
9488+ </parameter>
9489+ <parameter name="property" transfer-ownership="none">
9490+ <doc xml:space="preserve"
9491+ filename="src/adw-breakpoint.c"
9492+ line="1536">the target property</doc>
9493+ <type name="utf8" c:type="const char*"/>
9494+ </parameter>
9495+ <parameter name="value"
9496+ transfer-ownership="none"
9497+ nullable="1"
9498+ allow-none="1">
9499+ <doc xml:space="preserve"
9500+ filename="src/adw-breakpoint.c"
9501+ line="1537">the value to set</doc>
9502+ <type name="GObject.Value" c:type="const GValue*"/>
9503+ </parameter>
9504+ </parameters>
9505+ </method>
9506+ <method name="add_setters"
9507+ c:identifier="adw_breakpoint_add_setters"
9508+ shadowed-by="add_settersv"
9509+ version="1.4"
9510+ introspectable="0">
9511+ <doc xml:space="preserve"
9512+ filename="src/adw-breakpoint.c"
9513+ line="1649">Adds multiple setters to @self.
9514+
9515+See [method@Breakpoint.add_setter].
9516+
9517+Example:
9518+
9519+```c
9520+adw_breakpoint_add_setters (breakpoint,
9521+ G_OBJECT (box), "orientation", GTK_ORIENTATION_VERTICAL,
9522+ G_OBJECT (button), "halign", GTK_ALIGN_FILL,
9523+ G_OBJECT (button), "valign", GTK_ALIGN_END,
9524+ NULL);
9525+```</doc>
9526+ <source-position filename="src/adw-breakpoint.h" line="94"/>
9527+ <return-value transfer-ownership="none">
9528+ <type name="none" c:type="void"/>
9529+ </return-value>
9530+ <parameters>
9531+ <instance-parameter name="self" transfer-ownership="none">
9532+ <doc xml:space="preserve"
9533+ filename="src/adw-breakpoint.c"
9534+ line="1651">a breakpoint</doc>
9535+ <type name="Breakpoint" c:type="AdwBreakpoint*"/>
9536+ </instance-parameter>
9537+ <parameter name="first_object" transfer-ownership="none">
9538+ <doc xml:space="preserve"
9539+ filename="src/adw-breakpoint.c"
9540+ line="1652">the first target object</doc>
9541+ <type name="GObject.Object" c:type="GObject*"/>
9542+ </parameter>
9543+ <parameter name="first_property" transfer-ownership="none">
9544+ <doc xml:space="preserve"
9545+ filename="src/adw-breakpoint.c"
9546+ line="1653">the first target property</doc>
9547+ <type name="utf8" c:type="const char*"/>
9548+ </parameter>
9549+ <parameter name="..." transfer-ownership="none">
9550+ <doc xml:space="preserve"
9551+ filename="src/adw-breakpoint.c"
9552+ line="1654">the value of the first setter, followed by a list of object, property
9553+ and value triplets, terminated by `NULL`</doc>
9554+ <varargs/>
9555+ </parameter>
9556+ </parameters>
9557+ </method>
9558+ <method name="add_setters_valist"
9559+ c:identifier="adw_breakpoint_add_setters_valist"
9560+ version="1.4"
9561+ introspectable="0">
9562+ <doc xml:space="preserve"
9563+ filename="src/adw-breakpoint.c"
9564+ line="1723">Adds multiple setters to @self.
9565+
9566+See [method@Breakpoint.add_setters].</doc>
9567+ <source-position filename="src/adw-breakpoint.h" line="105"/>
9568+ <return-value transfer-ownership="none">
9569+ <type name="none" c:type="void"/>
9570+ </return-value>
9571+ <parameters>
9572+ <instance-parameter name="self" transfer-ownership="none">
9573+ <doc xml:space="preserve"
9574+ filename="src/adw-breakpoint.c"
9575+ line="1725">a breakpoint</doc>
9576+ <type name="Breakpoint" c:type="AdwBreakpoint*"/>
9577+ </instance-parameter>
9578+ <parameter name="first_object" transfer-ownership="none">
9579+ <doc xml:space="preserve"
9580+ filename="src/adw-breakpoint.c"
9581+ line="1726">the first target object</doc>
9582+ <type name="GObject.Object" c:type="GObject*"/>
9583+ </parameter>
9584+ <parameter name="first_property" transfer-ownership="none">
9585+ <doc xml:space="preserve"
9586+ filename="src/adw-breakpoint.c"
9587+ line="1727">the first target property</doc>
9588+ <type name="utf8" c:type="const char*"/>
9589+ </parameter>
9590+ <parameter name="args" transfer-ownership="none">
9591+ <doc xml:space="preserve"
9592+ filename="src/adw-breakpoint.c"
9593+ line="1728">the value of the first setter, followed by a list of object, property
9594+ and value triplets, terminated by `NULL`</doc>
9595+ <type name="va_list" c:type="va_list"/>
9596+ </parameter>
9597+ </parameters>
9598+ </method>
9599+ <method name="add_settersv"
9600+ c:identifier="adw_breakpoint_add_settersv"
9601+ shadows="add_setters"
9602+ version="1.4">
9603+ <doc xml:space="preserve"
9604+ filename="src/adw-breakpoint.c"
9605+ line="1690">Adds @n_setters setters to @self.
9606+
9607+This is a convenience function for adding multiple setters at once.
9608+
9609+See [method@Breakpoint.add_setter].
9610+
9611+This function is meant to be used by language bindings.</doc>
9612+ <source-position filename="src/adw-breakpoint.h" line="99"/>
9613+ <return-value transfer-ownership="none">
9614+ <type name="none" c:type="void"/>
9615+ </return-value>
9616+ <parameters>
9617+ <instance-parameter name="self" transfer-ownership="none">
9618+ <doc xml:space="preserve"
9619+ filename="src/adw-breakpoint.c"
9620+ line="1692">a breakpoint</doc>
9621+ <type name="Breakpoint" c:type="AdwBreakpoint*"/>
9622+ </instance-parameter>
9623+ <parameter name="n_setters" transfer-ownership="none">
9624+ <doc xml:space="preserve"
9625+ filename="src/adw-breakpoint.c"
9626+ line="1693">the number of setters to add</doc>
9627+ <type name="gint" c:type="int"/>
9628+ </parameter>
9629+ <parameter name="objects" transfer-ownership="none">
9630+ <doc xml:space="preserve"
9631+ filename="src/adw-breakpoint.c"
9632+ line="1694">setter target object</doc>
9633+ <array length="0" zero-terminated="0" c:type="GObject**">
9634+ <type name="GObject.Object" c:type="GObject*"/>
9635+ </array>
9636+ </parameter>
9637+ <parameter name="names" transfer-ownership="none">
9638+ <doc xml:space="preserve"
9639+ filename="src/adw-breakpoint.c"
9640+ line="1695">setter target properties</doc>
9641+ <array length="0" zero-terminated="0" c:type="const char**">
9642+ <type name="utf8" c:type="char*"/>
9643+ </array>
9644+ </parameter>
9645+ <parameter name="values" transfer-ownership="none">
9646+ <doc xml:space="preserve"
9647+ filename="src/adw-breakpoint.c"
9648+ line="1696">setter values</doc>
9649+ <array length="0" zero-terminated="0" c:type="const GValue**">
9650+ <type name="GObject.Value" c:type="GValue*"/>
9651+ </array>
9652+ </parameter>
9653+ </parameters>
9654+ </method>
9655+ <method name="get_condition"
9656+ c:identifier="adw_breakpoint_get_condition"
9657+ glib:get-property="condition"
9658+ version="1.4">
9659+ <doc xml:space="preserve"
9660+ filename="src/adw-breakpoint.c"
9661+ line="1488">Gets the condition for @self.</doc>
9662+ <source-position filename="src/adw-breakpoint.h" line="82"/>
9663+ <return-value transfer-ownership="none" nullable="1">
9664+ <doc xml:space="preserve"
9665+ filename="src/adw-breakpoint.c"
9666+ line="1494">the condition</doc>
9667+ <type name="BreakpointCondition" c:type="AdwBreakpointCondition*"/>
9668+ </return-value>
9669+ <parameters>
9670+ <instance-parameter name="self" transfer-ownership="none">
9671+ <doc xml:space="preserve"
9672+ filename="src/adw-breakpoint.c"
9673+ line="1490">a breakpoint</doc>
9674+ <type name="Breakpoint" c:type="AdwBreakpoint*"/>
9675+ </instance-parameter>
9676+ </parameters>
9677+ </method>
9678+ <method name="set_condition"
9679+ c:identifier="adw_breakpoint_set_condition"
9680+ glib:set-property="condition"
9681+ version="1.4">
9682+ <doc xml:space="preserve"
9683+ filename="src/adw-breakpoint.c"
9684+ line="1506">Sets the condition for @self.</doc>
9685+ <source-position filename="src/adw-breakpoint.h" line="84"/>
9686+ <return-value transfer-ownership="none">
9687+ <type name="none" c:type="void"/>
9688+ </return-value>
9689+ <parameters>
9690+ <instance-parameter name="self" transfer-ownership="none">
9691+ <doc xml:space="preserve"
9692+ filename="src/adw-breakpoint.c"
9693+ line="1508">a breakpoint</doc>
9694+ <type name="Breakpoint" c:type="AdwBreakpoint*"/>
9695+ </instance-parameter>
9696+ <parameter name="condition"
9697+ transfer-ownership="none"
9698+ nullable="1"
9699+ allow-none="1">
9700+ <doc xml:space="preserve"
9701+ filename="src/adw-breakpoint.c"
9702+ line="1509">the new condition</doc>
9703+ <type name="BreakpointCondition" c:type="AdwBreakpointCondition*"/>
9704+ </parameter>
9705+ </parameters>
9706+ </method>
9707+ <property name="condition"
9708+ version="1.4"
9709+ writable="1"
9710+ transfer-ownership="none"
9711+ setter="set_condition"
9712+ getter="get_condition">
9713+ <doc xml:space="preserve"
9714+ filename="src/adw-breakpoint.c"
9715+ line="1120">The breakpoint's condition.</doc>
9716+ <type name="BreakpointCondition"/>
9717+ </property>
9718+ <glib:signal name="apply" when="last" version="1.4">
9719+ <doc xml:space="preserve"
9720+ filename="src/adw-breakpoint.c"
9721+ line="1134">Emitted when the breakpoint is applied.
9722+
9723+This signal is emitted after the setters have been applied.</doc>
9724+ <return-value transfer-ownership="none">
9725+ <type name="none" c:type="void"/>
9726+ </return-value>
9727+ </glib:signal>
9728+ <glib:signal name="unapply" when="last" version="1.4">
9729+ <doc xml:space="preserve"
9730+ filename="src/adw-breakpoint.c"
9731+ line="1156">Emitted when the breakpoint is unapplied.
9732+
9733+This signal is emitted before resetting the setter values.</doc>
9734+ <return-value transfer-ownership="none">
9735+ <type name="none" c:type="void"/>
9736+ </return-value>
9737+ </glib:signal>
9738+ </class>
9739+ <class name="BreakpointBin"
9740+ c:symbol-prefix="breakpoint_bin"
9741+ c:type="AdwBreakpointBin"
9742+ version="1.4"
9743+ parent="Gtk.Widget"
9744+ glib:type-name="AdwBreakpointBin"
9745+ glib:get-type="adw_breakpoint_bin_get_type"
9746+ glib:type-struct="BreakpointBinClass">
9747+ <doc xml:space="preserve"
9748+ filename="src/adw-breakpoint-bin.c"
9749+ line="16">A widget that changes layout based on available size.
9750+
9751+&lt;picture&gt;
9752+ &lt;source srcset="breakpoint-bin-dark.png" media="(prefers-color-scheme: dark)"&gt;
9753+ &lt;img src="breakpoint-bin.png" alt="breakpoint-bin"&gt;
9754+&lt;/picture&gt;
9755+
9756+`AdwBreakpointBin` provides a way to use breakpoints without [class@Window],
9757+[class@ApplicationWindow] or [class@Dialog]. It can be useful for limiting
9758+breakpoints to a single page and similar purposes. Most applications
9759+shouldn't need it.
9760+
9761+`AdwBreakpointBin` is similar to [class@Bin]. It has one child, set via the
9762+[property@BreakpointBin:child] property.
9763+
9764+When `AdwBreakpointBin` is resized, its child widget can rearrange its layout
9765+at specific thresholds.
9766+
9767+The thresholds and layout changes are defined via [class@Breakpoint] objects.
9768+They can be added using [method@BreakpointBin.add_breakpoint].
9769+
9770+Each breakpoint has a condition, specifying the bin's size and/or aspect
9771+ratio, and setters that automatically set object properties when that
9772+happens. The [signal@Breakpoint::apply] and [signal@Breakpoint::unapply] can
9773+be used instead for more complex scenarios.
9774+
9775+Breakpoints are only allowed to modify widgets inside the `AdwBreakpointBin`,
9776+but not on the `AdwBreakpointBin` itself or any other widgets.
9777+
9778+If multiple breakpoints can be used for the current size, the last one is
9779+always picked. The current breakpoint can be tracked using the
9780+[property@BreakpointBin:current-breakpoint] property.
9781+
9782+If none of the breakpoints can be used, that property will be set to `NULL`,
9783+and the original property values will be used instead.
9784+
9785+## Minimum Size
9786+
9787+Adding a breakpoint to `AdwBreakpointBin` will result in it having no minimum
9788+size. The [property@Gtk.Widget:width-request] and
9789+[property@Gtk.Widget:height-request] properties must always be set when using
9790+breakpoints, indicating the smallest size you want to support.
9791+
9792+The minimum size and breakpoint conditions must be carefully selected so that
9793+the child widget completely fits. If it doesn't, it will overflow and a
9794+warning message will be printed.
9795+
9796+When choosing minimum size, consider translations and text scale factor
9797+changes. Make sure to leave enough space for text labels, and enable
9798+ellipsizing or wrapping if they might not fit.
9799+
9800+For [class@Gtk.Label] this can be done via [property@Gtk.Label:ellipsize], or
9801+via [property@Gtk.Label:wrap] together with [property@Gtk.Label:wrap-mode].
9802+
9803+For buttons, use [property@Gtk.Button:can-shrink],
9804+[property@Gtk.MenuButton:can-shrink], [property@Adw.SplitButton:can-shrink],
9805+or [property@Adw.ButtonContent:can-shrink].
9806+
9807+## Example
9808+
9809+```c
9810+GtkWidget *bin, *child;
9811+AdwBreakpoint *breakpoint;
9812+
9813+bin = adw_breakpoint_bin_new ();
9814+gtk_widget_set_size_request (bin, 150, 150);
9815+
9816+child = gtk_label_new ("Wide");
9817+gtk_label_set_ellipsize (GTK_LABEL (label), PANGO_ELLIPSIZE_END);
9818+gtk_widget_add_css_class (child, "title-1");
9819+adw_breakpoint_bin_set_child (ADW_BREAKPOINT_BIN (bin), child);
9820+
9821+breakpoint = adw_breakpoint_new (adw_breakpoint_condition_parse ("max-width: 200px"));
9822+adw_breakpoint_add_setters (breakpoint,
9823+ G_OBJECT (child), "label", "Narrow",
9824+ NULL);
9825+adw_breakpoint_bin_add_breakpoint (ADW_BREAKPOINT_BIN (bin), breakpoint);
9826+```
9827+
9828+The bin has a single label inside it, displaying "Wide". When the bin's width
9829+is smaller than or equal to 200px, it changes to "Narrow".
9830+
9831+## `AdwBreakpointBin` as `GtkBuildable`
9832+
9833+`AdwBreakpointBin` allows adding `AdwBreakpoint` objects as children.
9834+
9835+Example of an `AdwBreakpointBin` UI definition:
9836+
9837+```xml
9838+&lt;object class="AdwBreakpointBin"&gt;
9839+ &lt;property name="width-request"&gt;150&lt;/property&gt;
9840+ &lt;property name="height-request"&gt;150&lt;/property&gt;
9841+ &lt;property name="child"&gt;
9842+ &lt;object class="GtkLabel" id="child"&gt;
9843+ &lt;property name="label"&gt;Wide&lt;/property&gt;
9844+ &lt;property name="ellipsize"&gt;end&lt;/property&gt;
9845+ &lt;style&gt;
9846+ &lt;class name="title-1"/&gt;
9847+ &lt;/style&gt;
9848+ &lt;/object&gt;
9849+ &lt;/property&gt;
9850+ &lt;child&gt;
9851+ &lt;object class="AdwBreakpoint"&gt;
9852+ &lt;condition&gt;max-width: 200px&lt;/condition&gt;
9853+ &lt;setter object="child" property="label"&gt;Narrow&lt;/setter&gt;
9854+ &lt;/object&gt;
9855+ &lt;/child&gt;
9856+&lt;/object&gt;
9857+```
9858+
9859+See [class@Breakpoint] documentation for details.</doc>
9860+ <source-position filename="src/adw-breakpoint-bin.h" line="34"/>
9861+ <implements name="Gtk.Accessible"/>
9862+ <implements name="Gtk.Buildable"/>
9863+ <implements name="Gtk.ConstraintTarget"/>
9864+ <constructor name="new"
9865+ c:identifier="adw_breakpoint_bin_new"
9866+ version="1.4">
9867+ <doc xml:space="preserve"
9868+ filename="src/adw-breakpoint-bin.c"
9869+ line="642">Creates a new `AdwBreakpointBin`.</doc>
9870+ <source-position filename="src/adw-breakpoint-bin.h" line="37"/>
9871+ <return-value transfer-ownership="none">
9872+ <doc xml:space="preserve"
9873+ filename="src/adw-breakpoint-bin.c"
9874+ line="647">the newly created `AdwBreakpointBin`</doc>
9875+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
9876+ </return-value>
9877+ </constructor>
9878+ <method name="add_breakpoint"
9879+ c:identifier="adw_breakpoint_bin_add_breakpoint"
9880+ version="1.4">
9881+ <doc xml:space="preserve"
9882+ filename="src/adw-breakpoint-bin.c"
9883+ line="720">Adds @breakpoint to @self.</doc>
9884+ <source-position filename="src/adw-breakpoint-bin.h" line="46"/>
9885+ <return-value transfer-ownership="none">
9886+ <type name="none" c:type="void"/>
9887+ </return-value>
9888+ <parameters>
9889+ <instance-parameter name="self" transfer-ownership="none">
9890+ <doc xml:space="preserve"
9891+ filename="src/adw-breakpoint-bin.c"
9892+ line="722">a breakpoint bin</doc>
9893+ <type name="BreakpointBin" c:type="AdwBreakpointBin*"/>
9894+ </instance-parameter>
9895+ <parameter name="breakpoint" transfer-ownership="full">
9896+ <doc xml:space="preserve"
9897+ filename="src/adw-breakpoint-bin.c"
9898+ line="723">the breakpoint to add</doc>
9899+ <type name="Breakpoint" c:type="AdwBreakpoint*"/>
9900+ </parameter>
9901+ </parameters>
9902+ </method>
9903+ <method name="get_child"
9904+ c:identifier="adw_breakpoint_bin_get_child"
9905+ glib:get-property="child"
9906+ version="1.4">
9907+ <doc xml:space="preserve"
9908+ filename="src/adw-breakpoint-bin.c"
9909+ line="657">Gets the child widget of @self.</doc>
9910+ <source-position filename="src/adw-breakpoint-bin.h" line="40"/>
9911+ <return-value transfer-ownership="none" nullable="1">
9912+ <doc xml:space="preserve"
9913+ filename="src/adw-breakpoint-bin.c"
9914+ line="663">the child widget of @self</doc>
9915+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
9916+ </return-value>
9917+ <parameters>
9918+ <instance-parameter name="self" transfer-ownership="none">
9919+ <doc xml:space="preserve"
9920+ filename="src/adw-breakpoint-bin.c"
9921+ line="659">a breakpoint bin</doc>
9922+ <type name="BreakpointBin" c:type="AdwBreakpointBin*"/>
9923+ </instance-parameter>
9924+ </parameters>
9925+ </method>
9926+ <method name="get_current_breakpoint"
9927+ c:identifier="adw_breakpoint_bin_get_current_breakpoint"
9928+ glib:get-property="current-breakpoint"
9929+ version="1.4">
9930+ <doc xml:space="preserve"
9931+ filename="src/adw-breakpoint-bin.c"
9932+ line="775">Gets the current breakpoint.</doc>
9933+ <source-position filename="src/adw-breakpoint-bin.h" line="54"/>
9934+ <return-value transfer-ownership="none" nullable="1">
9935+ <doc xml:space="preserve"
9936+ filename="src/adw-breakpoint-bin.c"
9937+ line="781">the current breakpoint</doc>
9938+ <type name="Breakpoint" c:type="AdwBreakpoint*"/>
9939+ </return-value>
9940+ <parameters>
9941+ <instance-parameter name="self" transfer-ownership="none">
9942+ <doc xml:space="preserve"
9943+ filename="src/adw-breakpoint-bin.c"
9944+ line="777">a breakpoint bin</doc>
9945+ <type name="BreakpointBin" c:type="AdwBreakpointBin*"/>
9946+ </instance-parameter>
9947+ </parameters>
9948+ </method>
9949+ <method name="remove_breakpoint"
9950+ c:identifier="adw_breakpoint_bin_remove_breakpoint"
9951+ version="1.5">
9952+ <doc xml:space="preserve"
9953+ filename="src/adw-breakpoint-bin.c"
9954+ line="748">Removes @breakpoint from @self.</doc>
9955+ <source-position filename="src/adw-breakpoint-bin.h" line="50"/>
9956+ <return-value transfer-ownership="none">
9957+ <type name="none" c:type="void"/>
9958+ </return-value>
9959+ <parameters>
9960+ <instance-parameter name="self" transfer-ownership="none">
9961+ <doc xml:space="preserve"
9962+ filename="src/adw-breakpoint-bin.c"
9963+ line="750">a breakpoint bin</doc>
9964+ <type name="BreakpointBin" c:type="AdwBreakpointBin*"/>
9965+ </instance-parameter>
9966+ <parameter name="breakpoint" transfer-ownership="none">
9967+ <doc xml:space="preserve"
9968+ filename="src/adw-breakpoint-bin.c"
9969+ line="751">a breakpoint to remove</doc>
9970+ <type name="Breakpoint" c:type="AdwBreakpoint*"/>
9971+ </parameter>
9972+ </parameters>
9973+ </method>
9974+ <method name="set_child"
9975+ c:identifier="adw_breakpoint_bin_set_child"
9976+ glib:set-property="child"
9977+ version="1.4">
9978+ <doc xml:space="preserve"
9979+ filename="src/adw-breakpoint-bin.c"
9980+ line="679">Sets the child widget of @self.</doc>
9981+ <source-position filename="src/adw-breakpoint-bin.h" line="42"/>
9982+ <return-value transfer-ownership="none">
9983+ <type name="none" c:type="void"/>
9984+ </return-value>
9985+ <parameters>
9986+ <instance-parameter name="self" transfer-ownership="none">
9987+ <doc xml:space="preserve"
9988+ filename="src/adw-breakpoint-bin.c"
9989+ line="681">a breakpoint bin</doc>
9990+ <type name="BreakpointBin" c:type="AdwBreakpointBin*"/>
9991+ </instance-parameter>
9992+ <parameter name="child"
9993+ transfer-ownership="none"
9994+ nullable="1"
9995+ allow-none="1">
9996+ <doc xml:space="preserve"
9997+ filename="src/adw-breakpoint-bin.c"
9998+ line="682">the child widget</doc>
9999+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
10000+ </parameter>
10001+ </parameters>
10002+ </method>
10003+ <property name="child"
10004+ version="1.4"
10005+ writable="1"
10006+ transfer-ownership="none"
10007+ setter="set_child"
10008+ getter="get_child">
10009+ <doc xml:space="preserve"
10010+ filename="src/adw-breakpoint-bin.c"
10011+ line="577">The child widget.</doc>
10012+ <type name="Gtk.Widget"/>
10013+ </property>
10014+ <property name="current-breakpoint"
10015+ version="1.4"
10016+ transfer-ownership="none"
10017+ getter="get_current_breakpoint">
10018+ <doc xml:space="preserve"
10019+ filename="src/adw-breakpoint-bin.c"
10020+ line="589">The current breakpoint.</doc>
10021+ <type name="Breakpoint"/>
10022+ </property>
10023+ <field name="parent_instance">
10024+ <type name="Gtk.Widget" c:type="GtkWidget"/>
10025+ </field>
10026+ </class>
10027+ <record name="BreakpointBinClass"
10028+ c:type="AdwBreakpointBinClass"
10029+ glib:is-gtype-struct-for="BreakpointBin">
10030+ <source-position filename="src/adw-breakpoint-bin.h" line="34"/>
10031+ <field name="parent_class">
10032+ <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
10033+ </field>
10034+ <field name="padding" readable="0" private="1">
10035+ <array zero-terminated="0" fixed-size="4">
10036+ <type name="gpointer" c:type="gpointer"/>
10037+ </array>
10038+ </field>
10039+ </record>
10040+ <record name="BreakpointClass"
10041+ c:type="AdwBreakpointClass"
10042+ glib:is-gtype-struct-for="Breakpoint">
10043+ <source-position filename="src/adw-breakpoint.h" line="76"/>
10044+ <field name="parent_class">
10045+ <type name="GObject.ObjectClass" c:type="GObjectClass"/>
10046+ </field>
10047+ </record>
10048+ <record name="BreakpointCondition"
10049+ c:type="AdwBreakpointCondition"
10050+ opaque="1"
10051+ version="1.4"
10052+ glib:type-name="AdwBreakpointCondition"
10053+ glib:get-type="adw_breakpoint_condition_get_type"
10054+ c:symbol-prefix="breakpoint_condition">
10055+ <doc xml:space="preserve"
10056+ filename="src/adw-breakpoint.c"
10057+ line="72">Describes condition for an [class@Breakpoint].</doc>
10058+ <source-position filename="src/adw-breakpoint.h" line="37"/>
10059+ <constructor name="new_and"
10060+ c:identifier="adw_breakpoint_condition_new_and"
10061+ version="1.4">
10062+ <doc xml:space="preserve"
10063+ filename="src/adw-breakpoint.c"
10064+ line="287">Creates a condition that triggers when @condition_1 and @condition_2 are both
10065+true.</doc>
10066+ <source-position filename="src/adw-breakpoint.h" line="53"/>
10067+ <return-value transfer-ownership="full">
10068+ <doc xml:space="preserve"
10069+ filename="src/adw-breakpoint.c"
10070+ line="295">the newly created condition</doc>
10071+ <type name="BreakpointCondition" c:type="AdwBreakpointCondition*"/>
10072+ </return-value>
10073+ <parameters>
10074+ <parameter name="condition_1" transfer-ownership="full">
10075+ <doc xml:space="preserve"
10076+ filename="src/adw-breakpoint.c"
10077+ line="289">first condition</doc>
10078+ <type name="BreakpointCondition" c:type="AdwBreakpointCondition*"/>
10079+ </parameter>
10080+ <parameter name="condition_2" transfer-ownership="full">
10081+ <doc xml:space="preserve"
10082+ filename="src/adw-breakpoint.c"
10083+ line="290">second condition</doc>
10084+ <type name="BreakpointCondition" c:type="AdwBreakpointCondition*"/>
10085+ </parameter>
10086+ </parameters>
10087+ </constructor>
10088+ <constructor name="new_length"
10089+ c:identifier="adw_breakpoint_condition_new_length"
10090+ version="1.4">
10091+ <doc xml:space="preserve"
10092+ filename="src/adw-breakpoint.c"
10093+ line="219">Creates a condition that triggers on length changes.</doc>
10094+ <source-position filename="src/adw-breakpoint.h" line="43"/>
10095+ <return-value transfer-ownership="full">
10096+ <doc xml:space="preserve"
10097+ filename="src/adw-breakpoint.c"
10098+ line="227">the newly created condition</doc>
10099+ <type name="BreakpointCondition" c:type="AdwBreakpointCondition*"/>
10100+ </return-value>
10101+ <parameters>
10102+ <parameter name="type" transfer-ownership="none">
10103+ <doc xml:space="preserve"
10104+ filename="src/adw-breakpoint.c"
10105+ line="221">the length type</doc>
10106+ <type name="BreakpointConditionLengthType"
10107+ c:type="AdwBreakpointConditionLengthType"/>
10108+ </parameter>
10109+ <parameter name="value" transfer-ownership="none">
10110+ <doc xml:space="preserve"
10111+ filename="src/adw-breakpoint.c"
10112+ line="222">the length value</doc>
10113+ <type name="gdouble" c:type="double"/>
10114+ </parameter>
10115+ <parameter name="unit" transfer-ownership="none">
10116+ <doc xml:space="preserve"
10117+ filename="src/adw-breakpoint.c"
10118+ line="223">the length unit</doc>
10119+ <type name="LengthUnit" c:type="AdwLengthUnit"/>
10120+ </parameter>
10121+ </parameters>
10122+ </constructor>
10123+ <constructor name="new_or"
10124+ c:identifier="adw_breakpoint_condition_new_or"
10125+ version="1.4">
10126+ <doc xml:space="preserve"
10127+ filename="src/adw-breakpoint.c"
10128+ line="317">Creates a condition that triggers when either @condition_1 or @condition_2 is
10129+true.</doc>
10130+ <source-position filename="src/adw-breakpoint.h" line="57"/>
10131+ <return-value transfer-ownership="full">
10132+ <doc xml:space="preserve"
10133+ filename="src/adw-breakpoint.c"
10134+ line="325">the newly created condition</doc>
10135+ <type name="BreakpointCondition" c:type="AdwBreakpointCondition*"/>
10136+ </return-value>
10137+ <parameters>
10138+ <parameter name="condition_1" transfer-ownership="full">
10139+ <doc xml:space="preserve"
10140+ filename="src/adw-breakpoint.c"
10141+ line="319">first condition</doc>
10142+ <type name="BreakpointCondition" c:type="AdwBreakpointCondition*"/>
10143+ </parameter>
10144+ <parameter name="condition_2" transfer-ownership="full">
10145+ <doc xml:space="preserve"
10146+ filename="src/adw-breakpoint.c"
10147+ line="320">second condition</doc>
10148+ <type name="BreakpointCondition" c:type="AdwBreakpointCondition*"/>
10149+ </parameter>
10150+ </parameters>
10151+ </constructor>
10152+ <constructor name="new_ratio"
10153+ c:identifier="adw_breakpoint_condition_new_ratio"
10154+ version="1.4">
10155+ <doc xml:space="preserve"
10156+ filename="src/adw-breakpoint.c"
10157+ line="252">Creates a condition that triggers on ratio changes.
10158+
10159+The ratio is represented as @width divided by @height.</doc>
10160+ <source-position filename="src/adw-breakpoint.h" line="48"/>
10161+ <return-value transfer-ownership="full">
10162+ <doc xml:space="preserve"
10163+ filename="src/adw-breakpoint.c"
10164+ line="262">the newly created condition</doc>
10165+ <type name="BreakpointCondition" c:type="AdwBreakpointCondition*"/>
10166+ </return-value>
10167+ <parameters>
10168+ <parameter name="type" transfer-ownership="none">
10169+ <doc xml:space="preserve"
10170+ filename="src/adw-breakpoint.c"
10171+ line="254">the ratio type</doc>
10172+ <type name="BreakpointConditionRatioType"
10173+ c:type="AdwBreakpointConditionRatioType"/>
10174+ </parameter>
10175+ <parameter name="width" transfer-ownership="none">
10176+ <doc xml:space="preserve"
10177+ filename="src/adw-breakpoint.c"
10178+ line="255">ratio width</doc>
10179+ <type name="gint" c:type="int"/>
10180+ </parameter>
10181+ <parameter name="height" transfer-ownership="none">
10182+ <doc xml:space="preserve"
10183+ filename="src/adw-breakpoint.c"
10184+ line="256">ratio height</doc>
10185+ <type name="gint" c:type="int"/>
10186+ </parameter>
10187+ </parameters>
10188+ </constructor>
10189+ <method name="copy"
10190+ c:identifier="adw_breakpoint_condition_copy"
10191+ version="1.4">
10192+ <doc xml:space="preserve"
10193+ filename="src/adw-breakpoint.c"
10194+ line="347">Copies @self.</doc>
10195+ <source-position filename="src/adw-breakpoint.h" line="61"/>
10196+ <return-value transfer-ownership="full">
10197+ <doc xml:space="preserve"
10198+ filename="src/adw-breakpoint.c"
10199+ line="353">a copy of @self</doc>
10200+ <type name="BreakpointCondition" c:type="AdwBreakpointCondition*"/>
10201+ </return-value>
10202+ <parameters>
10203+ <instance-parameter name="self" transfer-ownership="none">
10204+ <doc xml:space="preserve"
10205+ filename="src/adw-breakpoint.c"
10206+ line="349">a breakpoint condition</doc>
10207+ <type name="BreakpointCondition" c:type="AdwBreakpointCondition*"/>
10208+ </instance-parameter>
10209+ </parameters>
10210+ </method>
10211+ <method name="free"
10212+ c:identifier="adw_breakpoint_condition_free"
10213+ version="1.4">
10214+ <doc xml:space="preserve"
10215+ filename="src/adw-breakpoint.c"
10216+ line="390">Frees @self.</doc>
10217+ <source-position filename="src/adw-breakpoint.h" line="63"/>
10218+ <return-value transfer-ownership="none">
10219+ <type name="none" c:type="void"/>
10220+ </return-value>
10221+ <parameters>
10222+ <instance-parameter name="self" transfer-ownership="none">
10223+ <doc xml:space="preserve"
10224+ filename="src/adw-breakpoint.c"
10225+ line="392">a breakpoint condition</doc>
10226+ <type name="BreakpointCondition" c:type="AdwBreakpointCondition*"/>
10227+ </instance-parameter>
10228+ </parameters>
10229+ </method>
10230+ <method name="to_string"
10231+ c:identifier="adw_breakpoint_condition_to_string"
10232+ version="1.4">
10233+ <doc xml:space="preserve"
10234+ filename="src/adw-breakpoint.c"
10235+ line="837">Returns a textual representation of @self.
10236+
10237+The returned string can be parsed by [func@BreakpointCondition.parse].</doc>
10238+ <source-position filename="src/adw-breakpoint.h" line="69"/>
10239+ <return-value transfer-ownership="full">
10240+ <doc xml:space="preserve"
10241+ filename="src/adw-breakpoint.c"
10242+ line="845">A newly allocated text string</doc>
10243+ <type name="utf8" c:type="char*"/>
10244+ </return-value>
10245+ <parameters>
10246+ <instance-parameter name="self" transfer-ownership="none">
10247+ <doc xml:space="preserve"
10248+ filename="src/adw-breakpoint.c"
10249+ line="839">a breakpoint condition</doc>
10250+ <type name="BreakpointCondition" c:type="AdwBreakpointCondition*"/>
10251+ </instance-parameter>
10252+ </parameters>
10253+ </method>
10254+ <function name="parse"
10255+ c:identifier="adw_breakpoint_condition_parse"
10256+ version="1.4">
10257+ <doc xml:space="preserve"
10258+ filename="src/adw-breakpoint.c"
10259+ line="709">Parses a condition from a string.
10260+
10261+Length conditions are specified as `&lt;type&gt;: &lt;value&gt;[&lt;unit&gt;]`, where:
10262+
10263+- `&lt;type&gt;` can be `min-width`, `max-width`, `min-height` or `max-height`
10264+- `&lt;value&gt;` is a fractional number
10265+- `&lt;unit&gt;` can be `px`, `pt` or `sp`
10266+
10267+If the unit is omitted, `px` is assumed.
10268+
10269+See [ctor@BreakpointCondition.new_length].
10270+
10271+Examples:
10272+
10273+- `min-width: 500px`
10274+- `min-height: 400pt`
10275+- `max-width: 100sp`
10276+- `max-height: 500`
10277+
10278+Ratio conditions are specified as `&lt;type&gt;: &lt;width&gt;[/&lt;height&gt;]`, where:
10279+
10280+- `&lt;type&gt;` can be `min-aspect-ratio` or `max-aspect-ratio`
10281+- `&lt;width&gt;` and `&lt;height&gt;` are integer numbers
10282+
10283+See [ctor@BreakpointCondition.new_ratio].
10284+
10285+The ratio is represented as `&lt;width&gt;` divided by `&lt;height&gt;`.
10286+
10287+If `&lt;height&gt;` is omitted, it's assumed to be 1.
10288+
10289+Examples:
10290+
10291+- `min-aspect-ratio: 4/3`
10292+- `max-aspect-ratio: 1`
10293+
10294+The logical operators `and`, `or` can be used to compose a complex condition
10295+as follows:
10296+
10297+- `&lt;condition&gt; and &lt;condition&gt;`: the condition is true when both
10298+ `&lt;condition&gt;`s are true, same as when using
10299+ [ctor@BreakpointCondition.new_and]
10300+- `&lt;condition&gt; or &lt;condition&gt;`: the condition is true when either of the
10301+ `&lt;condition&gt;`s is true, same as when using
10302+ [ctor@BreakpointCondition.new_or]
10303+
10304+Examples:
10305+
10306+- `min-width: 400px and max-aspect-ratio: 4/3`
10307+- `max-width: 360sp or max-width: 360px`
10308+
10309+Conditions can be further nested using parentheses, for example:
10310+
10311+- `min-width: 400px and (max-aspect-ratio: 4/3 or max-height: 400px)`
10312+
10313+If parentheses are omitted, the first operator takes priority.</doc>
10314+ <source-position filename="src/adw-breakpoint.h" line="66"/>
10315+ <return-value transfer-ownership="full">
10316+ <doc xml:space="preserve"
10317+ filename="src/adw-breakpoint.c"
10318+ line="769">the parsed condition</doc>
10319+ <type name="BreakpointCondition" c:type="AdwBreakpointCondition*"/>
10320+ </return-value>
10321+ <parameters>
10322+ <parameter name="str" transfer-ownership="none">
10323+ <doc xml:space="preserve"
10324+ filename="src/adw-breakpoint.c"
10325+ line="711">the string specifying the condition</doc>
10326+ <type name="utf8" c:type="const char*"/>
10327+ </parameter>
10328+ </parameters>
10329+ </function>
10330+ </record>
10331+ <enumeration name="BreakpointConditionLengthType"
10332+ version="1.4"
10333+ glib:type-name="AdwBreakpointConditionLengthType"
10334+ glib:get-type="adw_breakpoint_condition_length_type_get_type"
10335+ c:type="AdwBreakpointConditionLengthType">
10336+ <doc xml:space="preserve"
10337+ filename="src/adw-breakpoint.c"
10338+ line="80">Describes length types for [struct@BreakpointCondition].
10339+
10340+See [ctor@BreakpointCondition.new_length].
10341+
10342+New values may be added to this enumeration over time.</doc>
10343+ <member name="min_width"
10344+ value="0"
10345+ c:identifier="ADW_BREAKPOINT_CONDITION_MIN_WIDTH"
10346+ glib:nick="min-width"
10347+ glib:name="ADW_BREAKPOINT_CONDITION_MIN_WIDTH">
10348+ <doc xml:space="preserve"
10349+ filename="src/adw-breakpoint.c"
10350+ line="82">true if the width is greater than or
10351+ equal to the condition value</doc>
10352+ </member>
10353+ <member name="max_width"
10354+ value="1"
10355+ c:identifier="ADW_BREAKPOINT_CONDITION_MAX_WIDTH"
10356+ glib:nick="max-width"
10357+ glib:name="ADW_BREAKPOINT_CONDITION_MAX_WIDTH">
10358+ <doc xml:space="preserve"
10359+ filename="src/adw-breakpoint.c"
10360+ line="84">true if the width is less than or
10361+ equal to the condition value</doc>
10362+ </member>
10363+ <member name="min_height"
10364+ value="2"
10365+ c:identifier="ADW_BREAKPOINT_CONDITION_MIN_HEIGHT"
10366+ glib:nick="min-height"
10367+ glib:name="ADW_BREAKPOINT_CONDITION_MIN_HEIGHT">
10368+ <doc xml:space="preserve"
10369+ filename="src/adw-breakpoint.c"
10370+ line="86">true if the height is greater than or
10371+ equal to the condition value</doc>
10372+ </member>
10373+ <member name="max_height"
10374+ value="3"
10375+ c:identifier="ADW_BREAKPOINT_CONDITION_MAX_HEIGHT"
10376+ glib:nick="max-height"
10377+ glib:name="ADW_BREAKPOINT_CONDITION_MAX_HEIGHT">
10378+ <doc xml:space="preserve"
10379+ filename="src/adw-breakpoint.c"
10380+ line="88">true if the height is less than or
10381+ equal to the condition value</doc>
10382+ </member>
10383+ </enumeration>
10384+ <enumeration name="BreakpointConditionRatioType"
10385+ version="1.4"
10386+ glib:type-name="AdwBreakpointConditionRatioType"
10387+ glib:get-type="adw_breakpoint_condition_ratio_type_get_type"
10388+ c:type="AdwBreakpointConditionRatioType">
10389+ <doc xml:space="preserve"
10390+ filename="src/adw-breakpoint.c"
10391+ line="100">Describes ratio types for [struct@BreakpointCondition].
10392+
10393+See [ctor@BreakpointCondition.new_ratio].
10394+
10395+New values may be added to this enumeration over time.</doc>
10396+ <member name="min_aspect_ratio"
10397+ value="0"
10398+ c:identifier="ADW_BREAKPOINT_CONDITION_MIN_ASPECT_RATIO"
10399+ glib:nick="min-aspect-ratio"
10400+ glib:name="ADW_BREAKPOINT_CONDITION_MIN_ASPECT_RATIO">
10401+ <doc xml:space="preserve"
10402+ filename="src/adw-breakpoint.c"
10403+ line="102">true if the aspect ratio is
10404+ greater than or equal to the condition value</doc>
10405+ </member>
10406+ <member name="max_aspect_ratio"
10407+ value="1"
10408+ c:identifier="ADW_BREAKPOINT_CONDITION_MAX_ASPECT_RATIO"
10409+ glib:nick="max-aspect-ratio"
10410+ glib:name="ADW_BREAKPOINT_CONDITION_MAX_ASPECT_RATIO">
10411+ <doc xml:space="preserve"
10412+ filename="src/adw-breakpoint.c"
10413+ line="104">true if the aspect ratio is
10414+ less than or equal to the condition value</doc>
10415+ </member>
10416+ </enumeration>
10417+ <class name="ButtonContent"
10418+ c:symbol-prefix="button_content"
10419+ c:type="AdwButtonContent"
10420+ parent="Gtk.Widget"
10421+ final="1"
10422+ glib:type-name="AdwButtonContent"
10423+ glib:get-type="adw_button_content_get_type"
10424+ glib:type-struct="ButtonContentClass">
10425+ <doc xml:space="preserve"
10426+ filename="src/adw-button-content.c"
10427+ line="14">A helper widget for creating buttons.
10428+
10429+&lt;picture&gt;
10430+ &lt;source srcset="button-content-dark.png" media="(prefers-color-scheme: dark)"&gt;
10431+ &lt;img src="button-content.png" alt="button-content"&gt;
10432+&lt;/picture&gt;
10433+
10434+`AdwButtonContent` is a box-like widget with an icon and a label.
10435+
10436+It's intended to be used as a direct child of [class@Gtk.Button],
10437+[class@Gtk.MenuButton] or [class@SplitButton], when they need to have both an
10438+icon and a label, as follows:
10439+
10440+```xml
10441+&lt;object class="GtkButton"&gt;
10442+ &lt;property name="child"&gt;
10443+ &lt;object class="AdwButtonContent"&gt;
10444+ &lt;property name="icon-name"&gt;document-open-symbolic&lt;/property&gt;
10445+ &lt;property name="label" translatable="yes"&gt;_Open&lt;/property&gt;
10446+ &lt;property name="use-underline"&gt;True&lt;/property&gt;
10447+ &lt;/object&gt;
10448+ &lt;/property&gt;
10449+&lt;/object&gt;
10450+```
10451+
10452+`AdwButtonContent` handles style classes and connecting the mnemonic to the
10453+button automatically.
10454+
10455+## CSS nodes
10456+
10457+```
10458+buttoncontent
10459+╰── box
10460+ ├── image
10461+ ╰── label
10462+```
10463+
10464+`AdwButtonContent`'s CSS node is called `buttoncontent`. It contains a `box`
10465+subnode that serves as a container for the `image` and `label` nodes.
10466+
10467+When inside a `GtkButton` or `AdwSplitButton`, the button will receive the
10468+`.image-text-button` style class. When inside a `GtkMenuButton`, the
10469+internal `GtkButton` will receive it instead.
10470+
10471+## Accessibility
10472+
10473+`AdwButtonContent` uses the `GTK_ACCESSIBLE_ROLE_GROUP` role.</doc>
10474+ <source-position filename="src/adw-button-content.h" line="24"/>
10475+ <implements name="Gtk.Accessible"/>
10476+ <implements name="Gtk.Buildable"/>
10477+ <implements name="Gtk.ConstraintTarget"/>
10478+ <constructor name="new" c:identifier="adw_button_content_new">
10479+ <doc xml:space="preserve"
10480+ filename="src/adw-button-content.c"
10481+ line="307">Creates a new `AdwButtonContent`.</doc>
10482+ <source-position filename="src/adw-button-content.h" line="27"/>
10483+ <return-value transfer-ownership="none">
10484+ <doc xml:space="preserve"
10485+ filename="src/adw-button-content.c"
10486+ line="312">the new created `AdwButtonContent`</doc>
10487+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
10488+ </return-value>
10489+ </constructor>
10490+ <method name="get_can_shrink"
10491+ c:identifier="adw_button_content_get_can_shrink"
10492+ glib:get-property="can-shrink"
10493+ version="1.4">
10494+ <doc xml:space="preserve"
10495+ filename="src/adw-button-content.c"
10496+ line="447">gets whether the button can be smaller than the natural size of its contents.</doc>
10497+ <source-position filename="src/adw-button-content.h" line="48"/>
10498+ <return-value transfer-ownership="none">
10499+ <doc xml:space="preserve"
10500+ filename="src/adw-button-content.c"
10501+ line="453">whether the button can shrink</doc>
10502+ <type name="gboolean" c:type="gboolean"/>
10503+ </return-value>
10504+ <parameters>
10505+ <instance-parameter name="self" transfer-ownership="none">
10506+ <doc xml:space="preserve"
10507+ filename="src/adw-button-content.c"
10508+ line="449">a button content</doc>
10509+ <type name="ButtonContent" c:type="AdwButtonContent*"/>
10510+ </instance-parameter>
10511+ </parameters>
10512+ </method>
10513+ <method name="get_icon_name"
10514+ c:identifier="adw_button_content_get_icon_name"
10515+ glib:get-property="icon-name">
10516+ <doc xml:space="preserve"
10517+ filename="src/adw-button-content.c"
10518+ line="320">Gets the name of the displayed icon.</doc>
10519+ <source-position filename="src/adw-button-content.h" line="36"/>
10520+ <return-value transfer-ownership="none">
10521+ <doc xml:space="preserve"
10522+ filename="src/adw-button-content.c"
10523+ line="326">the icon name</doc>
10524+ <type name="utf8" c:type="const char*"/>
10525+ </return-value>
10526+ <parameters>
10527+ <instance-parameter name="self" transfer-ownership="none">
10528+ <doc xml:space="preserve"
10529+ filename="src/adw-button-content.c"
10530+ line="322">a button content</doc>
10531+ <type name="ButtonContent" c:type="AdwButtonContent*"/>
10532+ </instance-parameter>
10533+ </parameters>
10534+ </method>
10535+ <method name="get_label"
10536+ c:identifier="adw_button_content_get_label"
10537+ glib:get-property="label">
10538+ <doc xml:space="preserve"
10539+ filename="src/adw-button-content.c"
10540+ line="363">Gets the displayed label.</doc>
10541+ <source-position filename="src/adw-button-content.h" line="30"/>
10542+ <return-value transfer-ownership="none">
10543+ <doc xml:space="preserve"
10544+ filename="src/adw-button-content.c"
10545+ line="369">the label</doc>
10546+ <type name="utf8" c:type="const char*"/>
10547+ </return-value>
10548+ <parameters>
10549+ <instance-parameter name="self" transfer-ownership="none">
10550+ <doc xml:space="preserve"
10551+ filename="src/adw-button-content.c"
10552+ line="365">a button content</doc>
10553+ <type name="ButtonContent" c:type="AdwButtonContent*"/>
10554+ </instance-parameter>
10555+ </parameters>
10556+ </method>
10557+ <method name="get_use_underline"
10558+ c:identifier="adw_button_content_get_use_underline"
10559+ glib:get-property="use-underline">
10560+ <doc xml:space="preserve"
10561+ filename="src/adw-button-content.c"
10562+ line="404">Gets whether an underline in the text indicates a mnemonic.</doc>
10563+ <source-position filename="src/adw-button-content.h" line="42"/>
10564+ <return-value transfer-ownership="none">
10565+ <doc xml:space="preserve"
10566+ filename="src/adw-button-content.c"
10567+ line="410">whether an underline in the text indicates a mnemonic</doc>
10568+ <type name="gboolean" c:type="gboolean"/>
10569+ </return-value>
10570+ <parameters>
10571+ <instance-parameter name="self" transfer-ownership="none">
10572+ <doc xml:space="preserve"
10573+ filename="src/adw-button-content.c"
10574+ line="406">a button content</doc>
10575+ <type name="ButtonContent" c:type="AdwButtonContent*"/>
10576+ </instance-parameter>
10577+ </parameters>
10578+ </method>
10579+ <method name="set_can_shrink"
10580+ c:identifier="adw_button_content_set_can_shrink"
10581+ glib:set-property="can-shrink"
10582+ version="1.4">
10583+ <doc xml:space="preserve"
10584+ filename="src/adw-button-content.c"
10585+ line="465">Sets whether the button can be smaller than the natural size of its contents.
10586+
10587+If set to `TRUE`, the label will ellipsize.
10588+
10589+See [method@Gtk.Button.set_can_shrink].</doc>
10590+ <source-position filename="src/adw-button-content.h" line="50"/>
10591+ <return-value transfer-ownership="none">
10592+ <type name="none" c:type="void"/>
10593+ </return-value>
10594+ <parameters>
10595+ <instance-parameter name="self" transfer-ownership="none">
10596+ <doc xml:space="preserve"
10597+ filename="src/adw-button-content.c"
10598+ line="467">a button content</doc>
10599+ <type name="ButtonContent" c:type="AdwButtonContent*"/>
10600+ </instance-parameter>
10601+ <parameter name="can_shrink" transfer-ownership="none">
10602+ <doc xml:space="preserve"
10603+ filename="src/adw-button-content.c"
10604+ line="468">whether the button can shrink</doc>
10605+ <type name="gboolean" c:type="gboolean"/>
10606+ </parameter>
10607+ </parameters>
10608+ </method>
10609+ <method name="set_icon_name"
10610+ c:identifier="adw_button_content_set_icon_name"
10611+ glib:set-property="icon-name">
10612+ <doc xml:space="preserve"
10613+ filename="src/adw-button-content.c"
10614+ line="336">Sets the name of the displayed icon.
10615+
10616+If empty, the icon is not shown.</doc>
10617+ <source-position filename="src/adw-button-content.h" line="38"/>
10618+ <return-value transfer-ownership="none">
10619+ <type name="none" c:type="void"/>
10620+ </return-value>
10621+ <parameters>
10622+ <instance-parameter name="self" transfer-ownership="none">
10623+ <doc xml:space="preserve"
10624+ filename="src/adw-button-content.c"
10625+ line="338">a button content</doc>
10626+ <type name="ButtonContent" c:type="AdwButtonContent*"/>
10627+ </instance-parameter>
10628+ <parameter name="icon_name" transfer-ownership="none">
10629+ <doc xml:space="preserve"
10630+ filename="src/adw-button-content.c"
10631+ line="339">the new icon name</doc>
10632+ <type name="utf8" c:type="const char*"/>
10633+ </parameter>
10634+ </parameters>
10635+ </method>
10636+ <method name="set_label"
10637+ c:identifier="adw_button_content_set_label"
10638+ glib:set-property="label">
10639+ <doc xml:space="preserve"
10640+ filename="src/adw-button-content.c"
10641+ line="379">Sets the displayed label.</doc>
10642+ <source-position filename="src/adw-button-content.h" line="32"/>
10643+ <return-value transfer-ownership="none">
10644+ <type name="none" c:type="void"/>
10645+ </return-value>
10646+ <parameters>
10647+ <instance-parameter name="self" transfer-ownership="none">
10648+ <doc xml:space="preserve"
10649+ filename="src/adw-button-content.c"
10650+ line="381">a button content</doc>
10651+ <type name="ButtonContent" c:type="AdwButtonContent*"/>
10652+ </instance-parameter>
10653+ <parameter name="label" transfer-ownership="none">
10654+ <doc xml:space="preserve"
10655+ filename="src/adw-button-content.c"
10656+ line="382">the new label</doc>
10657+ <type name="utf8" c:type="const char*"/>
10658+ </parameter>
10659+ </parameters>
10660+ </method>
10661+ <method name="set_use_underline"
10662+ c:identifier="adw_button_content_set_use_underline"
10663+ glib:set-property="use-underline">
10664+ <doc xml:space="preserve"
10665+ filename="src/adw-button-content.c"
10666+ line="420">Sets whether an underline in the text indicates a mnemonic.
10667+
10668+The mnemonic can be used to activate the parent button.
10669+
10670+See [property@ButtonContent:label].</doc>
10671+ <source-position filename="src/adw-button-content.h" line="44"/>
10672+ <return-value transfer-ownership="none">
10673+ <type name="none" c:type="void"/>
10674+ </return-value>
10675+ <parameters>
10676+ <instance-parameter name="self" transfer-ownership="none">
10677+ <doc xml:space="preserve"
10678+ filename="src/adw-button-content.c"
10679+ line="422">a button content</doc>
10680+ <type name="ButtonContent" c:type="AdwButtonContent*"/>
10681+ </instance-parameter>
10682+ <parameter name="use_underline" transfer-ownership="none">
10683+ <doc xml:space="preserve"
10684+ filename="src/adw-button-content.c"
10685+ line="423">whether an underline in the text indicates a mnemonic</doc>
10686+ <type name="gboolean" c:type="gboolean"/>
10687+ </parameter>
10688+ </parameters>
10689+ </method>
10690+ <property name="can-shrink"
10691+ version="1.4"
10692+ writable="1"
10693+ transfer-ownership="none"
10694+ setter="set_can_shrink"
10695+ getter="get_can_shrink"
10696+ default-value="FALSE">
10697+ <doc xml:space="preserve"
10698+ filename="src/adw-button-content.c"
10699+ line="258">Whether the button can be smaller than the natural size of its contents.
10700+
10701+If set to `TRUE`, the label will ellipsize.
10702+
10703+See [property@Gtk.Button:can-shrink].</doc>
10704+ <type name="gboolean" c:type="gboolean"/>
10705+ </property>
10706+ <property name="icon-name"
10707+ writable="1"
10708+ transfer-ownership="none"
10709+ setter="set_icon_name"
10710+ getter="get_icon_name">
10711+ <doc xml:space="preserve"
10712+ filename="src/adw-button-content.c"
10713+ line="222">The name of the displayed icon.
10714+
10715+If empty, the icon is not shown.</doc>
10716+ <type name="utf8" c:type="gchar*"/>
10717+ </property>
10718+ <property name="label"
10719+ writable="1"
10720+ transfer-ownership="none"
10721+ setter="set_label"
10722+ getter="get_label">
10723+ <doc xml:space="preserve"
10724+ filename="src/adw-button-content.c"
10725+ line="234">The displayed label.</doc>
10726+ <type name="utf8" c:type="gchar*"/>
10727+ </property>
10728+ <property name="use-underline"
10729+ writable="1"
10730+ transfer-ownership="none"
10731+ setter="set_use_underline"
10732+ getter="get_use_underline"
10733+ default-value="FALSE">
10734+ <doc xml:space="preserve"
10735+ filename="src/adw-button-content.c"
10736+ line="244">Whether an underline in the text indicates a mnemonic.
10737+
10738+The mnemonic can be used to activate the parent button.
10739+
10740+See [property@ButtonContent:label].</doc>
10741+ <type name="gboolean" c:type="gboolean"/>
10742+ </property>
10743+ </class>
10744+ <record name="ButtonContentClass"
10745+ c:type="AdwButtonContentClass"
10746+ glib:is-gtype-struct-for="ButtonContent">
10747+ <source-position filename="src/adw-button-content.h" line="24"/>
10748+ <field name="parent_class">
10749+ <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
10750+ </field>
10751+ </record>
10752+ <class name="ButtonRow"
10753+ c:symbol-prefix="button_row"
10754+ c:type="AdwButtonRow"
10755+ version="1.6"
10756+ parent="PreferencesRow"
10757+ final="1"
10758+ glib:type-name="AdwButtonRow"
10759+ glib:get-type="adw_button_row_get_type"
10760+ glib:type-struct="ButtonRowClass">
10761+ <doc xml:space="preserve"
10762+ filename="src/adw-button-row.c"
10763+ line="15">A [class@Gtk.ListBoxRow] that looks like a button.
10764+
10765+&lt;picture&gt;
10766+ &lt;source srcset="button-rows-dark.png" media="(prefers-color-scheme: dark)"&gt;
10767+ &lt;img src="button-rows.png" alt="button-rows"&gt;
10768+&lt;/picture&gt;
10769+
10770+The `AdwButtonRow` widget has a title and two icons: before and after the
10771+title.
10772+
10773+It is convenient for presenting actions like "Delete" at the end of a boxed
10774+list.
10775+
10776+`AdwButtonRow` is always activatable.
10777+
10778+## CSS nodes
10779+
10780+`AdwButtonRow` has a main CSS node with name `row` and the style class
10781+`.button`.
10782+
10783+It contains the subnode `box` for its main horizontal box, which contains the
10784+nodes: `image.icon.start` for the start icon, `label.title` for the title,
10785+and `image.icon.end` for the end icon.
10786+
10787+## Style classes
10788+
10789+The [`.suggested-action`](style-classes.html#suggested-action) style class
10790+makes `AdwButtonRow` use accent color for its background. It should be used
10791+very sparingly to denote important buttons.
10792+
10793+&lt;picture&gt;
10794+ &lt;source srcset="button-row-suggested-action-dark.png" media="(prefers-color-scheme: dark)"&gt;
10795+ &lt;img src="button-row-suggested-action.png" alt="button-row-suggested-action"&gt;
10796+&lt;/picture&gt;
10797+
10798+The [`.destructive-action`](style-classes.html#destructive-action) style
10799+makes the row use destructive colors. It can be used to draw attention to the
10800+potentially damaging consequences of using it. This style acts as a warning
10801+to the user.
10802+
10803+&lt;picture&gt;
10804+ &lt;source srcset="button-row-destructive-action-dark.png" media="(prefers-color-scheme: dark)"&gt;
10805+ &lt;img src="button-row-destructive-action.png" alt="button-row-destructive-action"&gt;
10806+&lt;/picture&gt;</doc>
10807+ <source-position filename="src/adw-button-row.h" line="24"/>
10808+ <implements name="Gtk.Accessible"/>
10809+ <implements name="Gtk.Actionable"/>
10810+ <implements name="Gtk.Buildable"/>
10811+ <implements name="Gtk.ConstraintTarget"/>
10812+ <constructor name="new" c:identifier="adw_button_row_new" version="1.6">
10813+ <doc xml:space="preserve"
10814+ filename="src/adw-button-row.c"
10815+ line="264">Creates a new `AdwButtonRow`.</doc>
10816+ <source-position filename="src/adw-button-row.h" line="27"/>
10817+ <return-value transfer-ownership="none">
10818+ <doc xml:space="preserve"
10819+ filename="src/adw-button-row.c"
10820+ line="269">the newly created `AdwButtonRow`</doc>
10821+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
10822+ </return-value>
10823+ </constructor>
10824+ <method name="get_end_icon_name"
10825+ c:identifier="adw_button_row_get_end_icon_name"
10826+ glib:get-property="end-icon-name"
10827+ version="1.6">
10828+ <doc xml:space="preserve"
10829+ filename="src/adw-button-row.c"
10830+ line="318">Gets the end icon name for @self.</doc>
10831+ <source-position filename="src/adw-button-row.h" line="36"/>
10832+ <return-value transfer-ownership="none" nullable="1">
10833+ <doc xml:space="preserve"
10834+ filename="src/adw-button-row.c"
10835+ line="324">the end icon name for @self</doc>
10836+ <type name="utf8" c:type="const char*"/>
10837+ </return-value>
10838+ <parameters>
10839+ <instance-parameter name="self" transfer-ownership="none">
10840+ <doc xml:space="preserve"
10841+ filename="src/adw-button-row.c"
10842+ line="320">a button row</doc>
10843+ <type name="ButtonRow" c:type="AdwButtonRow*"/>
10844+ </instance-parameter>
10845+ </parameters>
10846+ </method>
10847+ <method name="get_start_icon_name"
10848+ c:identifier="adw_button_row_get_start_icon_name"
10849+ glib:get-property="start-icon-name"
10850+ version="1.6">
10851+ <doc xml:space="preserve"
10852+ filename="src/adw-button-row.c"
10853+ line="279">Gets the start icon name for @self.</doc>
10854+ <source-position filename="src/adw-button-row.h" line="30"/>
10855+ <return-value transfer-ownership="none" nullable="1">
10856+ <doc xml:space="preserve"
10857+ filename="src/adw-button-row.c"
10858+ line="285">the start icon name for @self</doc>
10859+ <type name="utf8" c:type="const char*"/>
10860+ </return-value>
10861+ <parameters>
10862+ <instance-parameter name="self" transfer-ownership="none">
10863+ <doc xml:space="preserve"
10864+ filename="src/adw-button-row.c"
10865+ line="281">a button row</doc>
10866+ <type name="ButtonRow" c:type="AdwButtonRow*"/>
10867+ </instance-parameter>
10868+ </parameters>
10869+ </method>
10870+ <method name="set_end_icon_name"
10871+ c:identifier="adw_button_row_set_end_icon_name"
10872+ glib:set-property="end-icon-name"
10873+ version="1.6">
10874+ <doc xml:space="preserve"
10875+ filename="src/adw-button-row.c"
10876+ line="336">Sets the end icon name for @self.</doc>
10877+ <source-position filename="src/adw-button-row.h" line="38"/>
10878+ <return-value transfer-ownership="none">
10879+ <type name="none" c:type="void"/>
10880+ </return-value>
10881+ <parameters>
10882+ <instance-parameter name="self" transfer-ownership="none">
10883+ <doc xml:space="preserve"
10884+ filename="src/adw-button-row.c"
10885+ line="338">a button row</doc>
10886+ <type name="ButtonRow" c:type="AdwButtonRow*"/>
10887+ </instance-parameter>
10888+ <parameter name="icon_name"
10889+ transfer-ownership="none"
10890+ nullable="1"
10891+ allow-none="1">
10892+ <doc xml:space="preserve"
10893+ filename="src/adw-button-row.c"
10894+ line="339">the end icon name</doc>
10895+ <type name="utf8" c:type="const char*"/>
10896+ </parameter>
10897+ </parameters>
10898+ </method>
10899+ <method name="set_start_icon_name"
10900+ c:identifier="adw_button_row_set_start_icon_name"
10901+ glib:set-property="start-icon-name"
10902+ version="1.6">
10903+ <doc xml:space="preserve"
10904+ filename="src/adw-button-row.c"
10905+ line="297">Sets the start icon name for @self.</doc>
10906+ <source-position filename="src/adw-button-row.h" line="32"/>
10907+ <return-value transfer-ownership="none">
10908+ <type name="none" c:type="void"/>
10909+ </return-value>
10910+ <parameters>
10911+ <instance-parameter name="self" transfer-ownership="none">
10912+ <doc xml:space="preserve"
10913+ filename="src/adw-button-row.c"
10914+ line="299">a button row</doc>
10915+ <type name="ButtonRow" c:type="AdwButtonRow*"/>
10916+ </instance-parameter>
10917+ <parameter name="icon_name"
10918+ transfer-ownership="none"
10919+ nullable="1"
10920+ allow-none="1">
10921+ <doc xml:space="preserve"
10922+ filename="src/adw-button-row.c"
10923+ line="300">the start icon name</doc>
10924+ <type name="utf8" c:type="const char*"/>
10925+ </parameter>
10926+ </parameters>
10927+ </method>
10928+ <property name="end-icon-name"
10929+ version="1.6"
10930+ writable="1"
10931+ transfer-ownership="none"
10932+ setter="set_end_icon_name"
10933+ getter="get_end_icon_name">
10934+ <doc xml:space="preserve"
10935+ filename="src/adw-button-row.c"
10936+ line="214">The icon name to show after the title.</doc>
10937+ <type name="utf8" c:type="gchar*"/>
10938+ </property>
10939+ <property name="start-icon-name"
10940+ version="1.6"
10941+ writable="1"
10942+ transfer-ownership="none"
10943+ setter="set_start_icon_name"
10944+ getter="get_start_icon_name">
10945+ <doc xml:space="preserve"
10946+ filename="src/adw-button-row.c"
10947+ line="202">The icon name to show before the title.</doc>
10948+ <type name="utf8" c:type="gchar*"/>
10949+ </property>
10950+ <glib:signal name="activated" when="last" version="1.6">
10951+ <doc xml:space="preserve"
10952+ filename="src/adw-button-row.c"
10953+ line="228">This signal is emitted after the row has been activated.</doc>
10954+ <return-value transfer-ownership="none">
10955+ <type name="none" c:type="void"/>
10956+ </return-value>
10957+ </glib:signal>
10958+ </class>
10959+ <record name="ButtonRowClass"
10960+ c:type="AdwButtonRowClass"
10961+ glib:is-gtype-struct-for="ButtonRow">
10962+ <source-position filename="src/adw-button-row.h" line="24"/>
10963+ <field name="parent_class">
10964+ <type name="PreferencesRowClass" c:type="AdwPreferencesRowClass"/>
10965+ </field>
10966+ </record>
10967+ <function-macro name="CHECK_VERSION"
10968+ c:identifier="ADW_CHECK_VERSION"
10969+ introspectable="0">
10970+ <doc xml:space="preserve"
10971+ filename="src/adw-version.h"
10972+ line="65">Compile-time version checking. Evaluates to `TRUE` if the version
10973+of Adwaita is greater than the required one.</doc>
10974+ <source-position filename="src/adw-version.h" line="73"/>
10975+ <parameters>
10976+ <parameter name="major">
10977+ <doc xml:space="preserve"
10978+ filename="src/adw-version.h"
10979+ line="67">required major version</doc>
10980+ </parameter>
10981+ <parameter name="minor">
10982+ <doc xml:space="preserve"
10983+ filename="src/adw-version.h"
10984+ line="68">required minor version</doc>
10985+ </parameter>
10986+ <parameter name="micro">
10987+ <doc xml:space="preserve"
10988+ filename="src/adw-version.h"
10989+ line="69">required micro version</doc>
10990+ </parameter>
10991+ </parameters>
10992+ </function-macro>
10993+ <class name="CallbackAnimationTarget"
10994+ c:symbol-prefix="callback_animation_target"
10995+ c:type="AdwCallbackAnimationTarget"
10996+ parent="AnimationTarget"
10997+ final="1"
10998+ glib:type-name="AdwCallbackAnimationTarget"
10999+ glib:get-type="adw_callback_animation_target_get_type"
11000+ glib:type-struct="CallbackAnimationTargetClass">
11001+ <doc xml:space="preserve"
11002+ filename="src/adw-animation-target.c"
11003+ line="17">An [class@AnimationTarget] that calls a given callback during the
11004+animation.</doc>
11005+ <source-position filename="src/adw-animation-target.h" line="38"/>
11006+ <constructor name="new" c:identifier="adw_callback_animation_target_new">
11007+ <doc xml:space="preserve"
11008+ filename="src/adw-animation-target.c"
11009+ line="119">Creates a new `AdwAnimationTarget` that calls the given @callback during
11010+the animation.</doc>
11011+ <source-position filename="src/adw-animation-target.h" line="41"/>
11012+ <return-value transfer-ownership="full">
11013+ <doc xml:space="preserve"
11014+ filename="src/adw-animation-target.c"
11015+ line="129">the newly created callback target</doc>
11016+ <type name="AnimationTarget" c:type="AdwAnimationTarget*"/>
11017+ </return-value>
11018+ <parameters>
11019+ <parameter name="callback"
11020+ transfer-ownership="none"
11021+ scope="notified"
11022+ closure="1"
11023+ destroy="2">
11024+ <doc xml:space="preserve"
11025+ filename="src/adw-animation-target.c"
11026+ line="121">the callback to call</doc>
11027+ <type name="AnimationTargetFunc" c:type="AdwAnimationTargetFunc"/>
11028+ </parameter>
11029+ <parameter name="user_data"
11030+ transfer-ownership="none"
11031+ nullable="1"
11032+ allow-none="1"
11033+ scope="notified">
11034+ <doc xml:space="preserve"
11035+ filename="src/adw-animation-target.c"
11036+ line="122">the data to be passed to @callback</doc>
11037+ <type name="gpointer" c:type="gpointer"/>
11038+ </parameter>
11039+ <parameter name="destroy"
11040+ transfer-ownership="none"
11041+ scope="async"
11042+ destroy="1">
11043+ <doc xml:space="preserve"
11044+ filename="src/adw-animation-target.c"
11045+ line="123">the function to be called when the
11046+ callback action is finalized</doc>
11047+ <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
11048+ </parameter>
11049+ </parameters>
11050+ </constructor>
11051+ </class>
11052+ <record name="CallbackAnimationTargetClass"
11053+ c:type="AdwCallbackAnimationTargetClass"
11054+ disguised="1"
11055+ opaque="1"
11056+ glib:is-gtype-struct-for="CallbackAnimationTarget">
11057+ <source-position filename="src/adw-animation-target.h" line="38"/>
11058+ </record>
11059+ <class name="Carousel"
11060+ c:symbol-prefix="carousel"
11061+ c:type="AdwCarousel"
11062+ parent="Gtk.Widget"
11063+ final="1"
11064+ glib:type-name="AdwCarousel"
11065+ glib:get-type="adw_carousel_get_type"
11066+ glib:type-struct="CarouselClass">
11067+ <doc xml:space="preserve"
11068+ filename="src/adw-carousel.c"
11069+ line="24">A paginated scrolling widget.
11070+
11071+&lt;picture&gt;
11072+ &lt;source srcset="carousel-dark.png" media="(prefers-color-scheme: dark)"&gt;
11073+ &lt;img src="carousel.png" alt="carousel"&gt;
11074+&lt;/picture&gt;
11075+
11076+The `AdwCarousel` widget can be used to display a set of pages with
11077+swipe-based navigation between them.
11078+
11079+[class@CarouselIndicatorDots] and [class@CarouselIndicatorLines] can be used
11080+to provide page indicators for `AdwCarousel`.
11081+
11082+## CSS nodes
11083+
11084+`AdwCarousel` has a single CSS node with name `carousel`.</doc>
11085+ <source-position filename="src/adw-carousel.h" line="24"/>
11086+ <implements name="Swipeable"/>
11087+ <implements name="Gtk.Accessible"/>
11088+ <implements name="Gtk.Buildable"/>
11089+ <implements name="Gtk.ConstraintTarget"/>
11090+ <implements name="Gtk.Orientable"/>
11091+ <constructor name="new" c:identifier="adw_carousel_new">
11092+ <doc xml:space="preserve"
11093+ filename="src/adw-carousel.c"
11094+ line="1154">Creates a new `AdwCarousel`.</doc>
11095+ <source-position filename="src/adw-carousel.h" line="27"/>
11096+ <return-value transfer-ownership="none">
11097+ <doc xml:space="preserve"
11098+ filename="src/adw-carousel.c"
11099+ line="1159">the newly created `AdwCarousel`</doc>
11100+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
11101+ </return-value>
11102+ </constructor>
11103+ <method name="append" c:identifier="adw_carousel_append">
11104+ <doc xml:space="preserve"
11105+ filename="src/adw-carousel.c"
11106+ line="1185">Appends @child to @self.</doc>
11107+ <source-position filename="src/adw-carousel.h" line="33"/>
11108+ <return-value transfer-ownership="none">
11109+ <type name="none" c:type="void"/>
11110+ </return-value>
11111+ <parameters>
11112+ <instance-parameter name="self" transfer-ownership="none">
11113+ <doc xml:space="preserve"
11114+ filename="src/adw-carousel.c"
11115+ line="1187">a carousel</doc>
11116+ <type name="Carousel" c:type="AdwCarousel*"/>
11117+ </instance-parameter>
11118+ <parameter name="child" transfer-ownership="none">
11119+ <doc xml:space="preserve"
11120+ filename="src/adw-carousel.c"
11121+ line="1188">a widget to add</doc>
11122+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
11123+ </parameter>
11124+ </parameters>
11125+ </method>
11126+ <method name="get_allow_long_swipes"
11127+ c:identifier="adw_carousel_get_allow_long_swipes"
11128+ glib:get-property="allow-long-swipes">
11129+ <doc xml:space="preserve"
11130+ filename="src/adw-carousel.c"
11131+ line="1718">Gets whether to allow swiping for more than one page at a time.</doc>
11132+ <source-position filename="src/adw-carousel.h" line="93"/>
11133+ <return-value transfer-ownership="none">
11134+ <doc xml:space="preserve"
11135+ filename="src/adw-carousel.c"
11136+ line="1724">`TRUE` if long swipes are allowed</doc>
11137+ <type name="gboolean" c:type="gboolean"/>
11138+ </return-value>
11139+ <parameters>
11140+ <instance-parameter name="self" transfer-ownership="none">
11141+ <doc xml:space="preserve"
11142+ filename="src/adw-carousel.c"
11143+ line="1720">a carousel</doc>
11144+ <type name="Carousel" c:type="AdwCarousel*"/>
11145+ </instance-parameter>
11146+ </parameters>
11147+ </method>
11148+ <method name="get_allow_mouse_drag"
11149+ c:identifier="adw_carousel_get_allow_mouse_drag"
11150+ glib:get-property="allow-mouse-drag">
11151+ <doc xml:space="preserve"
11152+ filename="src/adw-carousel.c"
11153+ line="1636">Sets whether @self can be dragged with mouse pointer.</doc>
11154+ <source-position filename="src/adw-carousel.h" line="81"/>
11155+ <return-value transfer-ownership="none">
11156+ <doc xml:space="preserve"
11157+ filename="src/adw-carousel.c"
11158+ line="1642">whether @self can be dragged with mouse pointer</doc>
11159+ <type name="gboolean" c:type="gboolean"/>
11160+ </return-value>
11161+ <parameters>
11162+ <instance-parameter name="self" transfer-ownership="none">
11163+ <doc xml:space="preserve"
11164+ filename="src/adw-carousel.c"
11165+ line="1638">a carousel</doc>
11166+ <type name="Carousel" c:type="AdwCarousel*"/>
11167+ </instance-parameter>
11168+ </parameters>
11169+ </method>
11170+ <method name="get_allow_scroll_wheel"
11171+ c:identifier="adw_carousel_get_allow_scroll_wheel"
11172+ glib:get-property="allow-scroll-wheel">
11173+ <doc xml:space="preserve"
11174+ filename="src/adw-carousel.c"
11175+ line="1677">Gets whether @self will respond to scroll wheel events.</doc>
11176+ <source-position filename="src/adw-carousel.h" line="87"/>
11177+ <return-value transfer-ownership="none">
11178+ <doc xml:space="preserve"
11179+ filename="src/adw-carousel.c"
11180+ line="1683">`TRUE` if @self will respond to scroll wheel events</doc>
11181+ <type name="gboolean" c:type="gboolean"/>
11182+ </return-value>
11183+ <parameters>
11184+ <instance-parameter name="self" transfer-ownership="none">
11185+ <doc xml:space="preserve"
11186+ filename="src/adw-carousel.c"
11187+ line="1679">a carousel</doc>
11188+ <type name="Carousel" c:type="AdwCarousel*"/>
11189+ </instance-parameter>
11190+ </parameters>
11191+ </method>
11192+ <method name="get_interactive"
11193+ c:identifier="adw_carousel_get_interactive"
11194+ glib:get-property="interactive">
11195+ <doc xml:space="preserve"
11196+ filename="src/adw-carousel.c"
11197+ line="1512">Gets whether @self can be navigated.</doc>
11198+ <source-position filename="src/adw-carousel.h" line="63"/>
11199+ <return-value transfer-ownership="none">
11200+ <doc xml:space="preserve"
11201+ filename="src/adw-carousel.c"
11202+ line="1518">whether @self can be navigated</doc>
11203+ <type name="gboolean" c:type="gboolean"/>
11204+ </return-value>
11205+ <parameters>
11206+ <instance-parameter name="self" transfer-ownership="none">
11207+ <doc xml:space="preserve"
11208+ filename="src/adw-carousel.c"
11209+ line="1514">a carousel</doc>
11210+ <type name="Carousel" c:type="AdwCarousel*"/>
11211+ </instance-parameter>
11212+ </parameters>
11213+ </method>
11214+ <method name="get_n_pages"
11215+ c:identifier="adw_carousel_get_n_pages"
11216+ glib:get-property="n-pages">
11217+ <doc xml:space="preserve"
11218+ filename="src/adw-carousel.c"
11219+ line="1467">Gets the number of pages in @self.</doc>
11220+ <source-position filename="src/adw-carousel.h" line="58"/>
11221+ <return-value transfer-ownership="none">
11222+ <doc xml:space="preserve"
11223+ filename="src/adw-carousel.c"
11224+ line="1473">the number of pages in @self</doc>
11225+ <type name="guint" c:type="guint"/>
11226+ </return-value>
11227+ <parameters>
11228+ <instance-parameter name="self" transfer-ownership="none">
11229+ <doc xml:space="preserve"
11230+ filename="src/adw-carousel.c"
11231+ line="1469">a carousel</doc>
11232+ <type name="Carousel" c:type="AdwCarousel*"/>
11233+ </instance-parameter>
11234+ </parameters>
11235+ </method>
11236+ <method name="get_nth_page" c:identifier="adw_carousel_get_nth_page">
11237+ <doc xml:space="preserve"
11238+ filename="src/adw-carousel.c"
11239+ line="1444">Gets the page at position @n.</doc>
11240+ <source-position filename="src/adw-carousel.h" line="55"/>
11241+ <return-value transfer-ownership="none">
11242+ <doc xml:space="preserve"
11243+ filename="src/adw-carousel.c"
11244+ line="1451">the page</doc>
11245+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
11246+ </return-value>
11247+ <parameters>
11248+ <instance-parameter name="self" transfer-ownership="none">
11249+ <doc xml:space="preserve"
11250+ filename="src/adw-carousel.c"
11251+ line="1446">a carousel</doc>
11252+ <type name="Carousel" c:type="AdwCarousel*"/>
11253+ </instance-parameter>
11254+ <parameter name="n" transfer-ownership="none">
11255+ <doc xml:space="preserve"
11256+ filename="src/adw-carousel.c"
11257+ line="1447">index of the page</doc>
11258+ <type name="guint" c:type="guint"/>
11259+ </parameter>
11260+ </parameters>
11261+ </method>
11262+ <method name="get_position"
11263+ c:identifier="adw_carousel_get_position"
11264+ glib:get-property="position">
11265+ <doc xml:space="preserve"
11266+ filename="src/adw-carousel.c"
11267+ line="1494">Gets current scroll position in @self, unitless.
11268+
11269+1 matches 1 page. Use [method@Carousel.scroll_to] for changing it.</doc>
11270+ <source-position filename="src/adw-carousel.h" line="60"/>
11271+ <return-value transfer-ownership="none">
11272+ <doc xml:space="preserve"
11273+ filename="src/adw-carousel.c"
11274+ line="1502">the scroll position</doc>
11275+ <type name="gdouble" c:type="double"/>
11276+ </return-value>
11277+ <parameters>
11278+ <instance-parameter name="self" transfer-ownership="none">
11279+ <doc xml:space="preserve"
11280+ filename="src/adw-carousel.c"
11281+ line="1496">a carousel</doc>
11282+ <type name="Carousel" c:type="AdwCarousel*"/>
11283+ </instance-parameter>
11284+ </parameters>
11285+ </method>
11286+ <method name="get_reveal_duration"
11287+ c:identifier="adw_carousel_get_reveal_duration"
11288+ glib:get-property="reveal-duration">
11289+ <doc xml:space="preserve"
11290+ filename="src/adw-carousel.c"
11291+ line="1760">Gets the page reveal duration, in milliseconds.</doc>
11292+ <source-position filename="src/adw-carousel.h" line="99"/>
11293+ <return-value transfer-ownership="none">
11294+ <doc xml:space="preserve"
11295+ filename="src/adw-carousel.c"
11296+ line="1766">the duration</doc>
11297+ <type name="guint" c:type="guint"/>
11298+ </return-value>
11299+ <parameters>
11300+ <instance-parameter name="self" transfer-ownership="none">
11301+ <doc xml:space="preserve"
11302+ filename="src/adw-carousel.c"
11303+ line="1762">a carousel</doc>
11304+ <type name="Carousel" c:type="AdwCarousel*"/>
11305+ </instance-parameter>
11306+ </parameters>
11307+ </method>
11308+ <method name="get_scroll_params"
11309+ c:identifier="adw_carousel_get_scroll_params"
11310+ glib:get-property="scroll-params">
11311+ <doc xml:space="preserve"
11312+ filename="src/adw-carousel.c"
11313+ line="1592">Gets the scroll animation spring parameters for @self.</doc>
11314+ <source-position filename="src/adw-carousel.h" line="75"/>
11315+ <return-value transfer-ownership="full">
11316+ <doc xml:space="preserve"
11317+ filename="src/adw-carousel.c"
11318+ line="1598">the animation parameters</doc>
11319+ <type name="SpringParams" c:type="AdwSpringParams*"/>
11320+ </return-value>
11321+ <parameters>
11322+ <instance-parameter name="self" transfer-ownership="none">
11323+ <doc xml:space="preserve"
11324+ filename="src/adw-carousel.c"
11325+ line="1594">a carousel</doc>
11326+ <type name="Carousel" c:type="AdwCarousel*"/>
11327+ </instance-parameter>
11328+ </parameters>
11329+ </method>
11330+ <method name="get_spacing"
11331+ c:identifier="adw_carousel_get_spacing"
11332+ glib:get-property="spacing">
11333+ <doc xml:space="preserve"
11334+ filename="src/adw-carousel.c"
11335+ line="1554">Gets spacing between pages in pixels.</doc>
11336+ <source-position filename="src/adw-carousel.h" line="69"/>
11337+ <return-value transfer-ownership="none">
11338+ <doc xml:space="preserve"
11339+ filename="src/adw-carousel.c"
11340+ line="1560">spacing between pages</doc>
11341+ <type name="guint" c:type="guint"/>
11342+ </return-value>
11343+ <parameters>
11344+ <instance-parameter name="self" transfer-ownership="none">
11345+ <doc xml:space="preserve"
11346+ filename="src/adw-carousel.c"
11347+ line="1556">a carousel</doc>
11348+ <type name="Carousel" c:type="AdwCarousel*"/>
11349+ </instance-parameter>
11350+ </parameters>
11351+ </method>
11352+ <method name="insert" c:identifier="adw_carousel_insert">
11353+ <doc xml:space="preserve"
11354+ filename="src/adw-carousel.c"
11355+ line="1203">Inserts @child into @self at position @position.
11356+
11357+If position is -1, or larger than the number of pages,
11358+@child will be appended to the end.</doc>
11359+ <source-position filename="src/adw-carousel.h" line="36"/>
11360+ <return-value transfer-ownership="none">
11361+ <type name="none" c:type="void"/>
11362+ </return-value>
11363+ <parameters>
11364+ <instance-parameter name="self" transfer-ownership="none">
11365+ <doc xml:space="preserve"
11366+ filename="src/adw-carousel.c"
11367+ line="1205">a carousel</doc>
11368+ <type name="Carousel" c:type="AdwCarousel*"/>
11369+ </instance-parameter>
11370+ <parameter name="child" transfer-ownership="none">
11371+ <doc xml:space="preserve"
11372+ filename="src/adw-carousel.c"
11373+ line="1206">a widget to add</doc>
11374+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
11375+ </parameter>
11376+ <parameter name="position" transfer-ownership="none">
11377+ <doc xml:space="preserve"
11378+ filename="src/adw-carousel.c"
11379+ line="1207">the position to insert @child at</doc>
11380+ <type name="gint" c:type="int"/>
11381+ </parameter>
11382+ </parameters>
11383+ </method>
11384+ <method name="prepend" c:identifier="adw_carousel_prepend">
11385+ <doc xml:space="preserve"
11386+ filename="src/adw-carousel.c"
11387+ line="1167">Prepends @child to @self.</doc>
11388+ <source-position filename="src/adw-carousel.h" line="30"/>
11389+ <return-value transfer-ownership="none">
11390+ <type name="none" c:type="void"/>
11391+ </return-value>
11392+ <parameters>
11393+ <instance-parameter name="self" transfer-ownership="none">
11394+ <doc xml:space="preserve"
11395+ filename="src/adw-carousel.c"
11396+ line="1169">a carousel</doc>
11397+ <type name="Carousel" c:type="AdwCarousel*"/>
11398+ </instance-parameter>
11399+ <parameter name="child" transfer-ownership="none">
11400+ <doc xml:space="preserve"
11401+ filename="src/adw-carousel.c"
11402+ line="1170">a widget to add</doc>
11403+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
11404+ </parameter>
11405+ </parameters>
11406+ </method>
11407+ <method name="remove" c:identifier="adw_carousel_remove">
11408+ <doc xml:space="preserve"
11409+ filename="src/adw-carousel.c"
11410+ line="1345">Removes @child from @self.</doc>
11411+ <source-position filename="src/adw-carousel.h" line="46"/>
11412+ <return-value transfer-ownership="none">
11413+ <type name="none" c:type="void"/>
11414+ </return-value>
11415+ <parameters>
11416+ <instance-parameter name="self" transfer-ownership="none">
11417+ <doc xml:space="preserve"
11418+ filename="src/adw-carousel.c"
11419+ line="1347">a carousel</doc>
11420+ <type name="Carousel" c:type="AdwCarousel*"/>
11421+ </instance-parameter>
11422+ <parameter name="child" transfer-ownership="none">
11423+ <doc xml:space="preserve"
11424+ filename="src/adw-carousel.c"
11425+ line="1348">a widget to remove</doc>
11426+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
11427+ </parameter>
11428+ </parameters>
11429+ </method>
11430+ <method name="reorder" c:identifier="adw_carousel_reorder">
11431+ <doc xml:space="preserve"
11432+ filename="src/adw-carousel.c"
11433+ line="1252">Moves @child into position @position.
11434+
11435+If position is -1, or larger than the number of pages, @child will be moved
11436+at the end.</doc>
11437+ <source-position filename="src/adw-carousel.h" line="41"/>
11438+ <return-value transfer-ownership="none">
11439+ <type name="none" c:type="void"/>
11440+ </return-value>
11441+ <parameters>
11442+ <instance-parameter name="self" transfer-ownership="none">
11443+ <doc xml:space="preserve"
11444+ filename="src/adw-carousel.c"
11445+ line="1254">a carousel</doc>
11446+ <type name="Carousel" c:type="AdwCarousel*"/>
11447+ </instance-parameter>
11448+ <parameter name="child" transfer-ownership="none">
11449+ <doc xml:space="preserve"
11450+ filename="src/adw-carousel.c"
11451+ line="1255">a widget to add</doc>
11452+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
11453+ </parameter>
11454+ <parameter name="position" transfer-ownership="none">
11455+ <doc xml:space="preserve"
11456+ filename="src/adw-carousel.c"
11457+ line="1256">the position to move @child to</doc>
11458+ <type name="gint" c:type="int"/>
11459+ </parameter>
11460+ </parameters>
11461+ </method>
11462+ <method name="scroll_to" c:identifier="adw_carousel_scroll_to">
11463+ <doc xml:space="preserve"
11464+ filename="src/adw-carousel.c"
11465+ line="1405">Scrolls to @widget.
11466+
11467+If @animate is `TRUE`, the transition will be animated.</doc>
11468+ <source-position filename="src/adw-carousel.h" line="50"/>
11469+ <return-value transfer-ownership="none">
11470+ <type name="none" c:type="void"/>
11471+ </return-value>
11472+ <parameters>
11473+ <instance-parameter name="self" transfer-ownership="none">
11474+ <doc xml:space="preserve"
11475+ filename="src/adw-carousel.c"
11476+ line="1407">a carousel</doc>
11477+ <type name="Carousel" c:type="AdwCarousel*"/>
11478+ </instance-parameter>
11479+ <parameter name="widget" transfer-ownership="none">
11480+ <doc xml:space="preserve"
11481+ filename="src/adw-carousel.c"
11482+ line="1408">a child of @self</doc>
11483+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
11484+ </parameter>
11485+ <parameter name="animate" transfer-ownership="none">
11486+ <doc xml:space="preserve"
11487+ filename="src/adw-carousel.c"
11488+ line="1409">whether to animate the transition</doc>
11489+ <type name="gboolean" c:type="gboolean"/>
11490+ </parameter>
11491+ </parameters>
11492+ </method>
11493+ <method name="set_allow_long_swipes"
11494+ c:identifier="adw_carousel_set_allow_long_swipes"
11495+ glib:set-property="allow-long-swipes">
11496+ <doc xml:space="preserve"
11497+ filename="src/adw-carousel.c"
11498+ line="1734">Sets whether to allow swiping for more than one page at a time.
11499+
11500+If @allow_long_swipes is `FALSE`, each swipe can only move to the adjacent
11501+pages.</doc>
11502+ <source-position filename="src/adw-carousel.h" line="95"/>
11503+ <return-value transfer-ownership="none">
11504+ <type name="none" c:type="void"/>
11505+ </return-value>
11506+ <parameters>
11507+ <instance-parameter name="self" transfer-ownership="none">
11508+ <doc xml:space="preserve"
11509+ filename="src/adw-carousel.c"
11510+ line="1736">a carousel</doc>
11511+ <type name="Carousel" c:type="AdwCarousel*"/>
11512+ </instance-parameter>
11513+ <parameter name="allow_long_swipes" transfer-ownership="none">
11514+ <doc xml:space="preserve"
11515+ filename="src/adw-carousel.c"
11516+ line="1737">whether to allow long swipes</doc>
11517+ <type name="gboolean" c:type="gboolean"/>
11518+ </parameter>
11519+ </parameters>
11520+ </method>
11521+ <method name="set_allow_mouse_drag"
11522+ c:identifier="adw_carousel_set_allow_mouse_drag"
11523+ glib:set-property="allow-mouse-drag">
11524+ <doc xml:space="preserve"
11525+ filename="src/adw-carousel.c"
11526+ line="1652">Sets whether @self can be dragged with mouse pointer.
11527+
11528+If @allow_mouse_drag is `FALSE`, dragging is only available on touch.</doc>
11529+ <source-position filename="src/adw-carousel.h" line="83"/>
11530+ <return-value transfer-ownership="none">
11531+ <type name="none" c:type="void"/>
11532+ </return-value>
11533+ <parameters>
11534+ <instance-parameter name="self" transfer-ownership="none">
11535+ <doc xml:space="preserve"
11536+ filename="src/adw-carousel.c"
11537+ line="1654">a carousel</doc>
11538+ <type name="Carousel" c:type="AdwCarousel*"/>
11539+ </instance-parameter>
11540+ <parameter name="allow_mouse_drag" transfer-ownership="none">
11541+ <doc xml:space="preserve"
11542+ filename="src/adw-carousel.c"
11543+ line="1655">whether @self can be dragged with mouse pointer</doc>
11544+ <type name="gboolean" c:type="gboolean"/>
11545+ </parameter>
11546+ </parameters>
11547+ </method>
11548+ <method name="set_allow_scroll_wheel"
11549+ c:identifier="adw_carousel_set_allow_scroll_wheel"
11550+ glib:set-property="allow-scroll-wheel">
11551+ <doc xml:space="preserve"
11552+ filename="src/adw-carousel.c"
11553+ line="1693">Sets whether @self will respond to scroll wheel events.
11554+
11555+If @allow_scroll_wheel is `FALSE`, wheel events will be ignored.</doc>
11556+ <source-position filename="src/adw-carousel.h" line="89"/>
11557+ <return-value transfer-ownership="none">
11558+ <type name="none" c:type="void"/>
11559+ </return-value>
11560+ <parameters>
11561+ <instance-parameter name="self" transfer-ownership="none">
11562+ <doc xml:space="preserve"
11563+ filename="src/adw-carousel.c"
11564+ line="1695">a carousel</doc>
11565+ <type name="Carousel" c:type="AdwCarousel*"/>
11566+ </instance-parameter>
11567+ <parameter name="allow_scroll_wheel" transfer-ownership="none">
11568+ <doc xml:space="preserve"
11569+ filename="src/adw-carousel.c"
11570+ line="1696">whether @self will respond to scroll wheel events</doc>
11571+ <type name="gboolean" c:type="gboolean"/>
11572+ </parameter>
11573+ </parameters>
11574+ </method>
11575+ <method name="set_interactive"
11576+ c:identifier="adw_carousel_set_interactive"
11577+ glib:set-property="interactive">
11578+ <doc xml:space="preserve"
11579+ filename="src/adw-carousel.c"
11580+ line="1528">Sets whether @self can be navigated.
11581+
11582+This can be used to temporarily disable the carousel to only allow navigating
11583+it in a certain state.</doc>
11584+ <source-position filename="src/adw-carousel.h" line="65"/>
11585+ <return-value transfer-ownership="none">
11586+ <type name="none" c:type="void"/>
11587+ </return-value>
11588+ <parameters>
11589+ <instance-parameter name="self" transfer-ownership="none">
11590+ <doc xml:space="preserve"
11591+ filename="src/adw-carousel.c"
11592+ line="1530">a carousel</doc>
11593+ <type name="Carousel" c:type="AdwCarousel*"/>
11594+ </instance-parameter>
11595+ <parameter name="interactive" transfer-ownership="none">
11596+ <doc xml:space="preserve"
11597+ filename="src/adw-carousel.c"
11598+ line="1531">whether @self can be navigated</doc>
11599+ <type name="gboolean" c:type="gboolean"/>
11600+ </parameter>
11601+ </parameters>
11602+ </method>
11603+ <method name="set_reveal_duration"
11604+ c:identifier="adw_carousel_set_reveal_duration"
11605+ glib:set-property="reveal-duration">
11606+ <doc xml:space="preserve"
11607+ filename="src/adw-carousel.c"
11608+ line="1776">Sets the page reveal duration, in milliseconds.
11609+
11610+Reveal duration is used when animating adding or removing pages.</doc>
11611+ <source-position filename="src/adw-carousel.h" line="101"/>
11612+ <return-value transfer-ownership="none">
11613+ <type name="none" c:type="void"/>
11614+ </return-value>
11615+ <parameters>
11616+ <instance-parameter name="self" transfer-ownership="none">
11617+ <doc xml:space="preserve"
11618+ filename="src/adw-carousel.c"
11619+ line="1778">a carousel</doc>
11620+ <type name="Carousel" c:type="AdwCarousel*"/>
11621+ </instance-parameter>
11622+ <parameter name="reveal_duration" transfer-ownership="none">
11623+ <doc xml:space="preserve"
11624+ filename="src/adw-carousel.c"
11625+ line="1779">the new reveal duration value</doc>
11626+ <type name="guint" c:type="guint"/>
11627+ </parameter>
11628+ </parameters>
11629+ </method>
11630+ <method name="set_scroll_params"
11631+ c:identifier="adw_carousel_set_scroll_params"
11632+ glib:set-property="scroll-params">
11633+ <doc xml:space="preserve"
11634+ filename="src/adw-carousel.c"
11635+ line="1608">Sets the scroll animation spring parameters for @self.
11636+
11637+The default value is equivalent to:
11638+
11639+```c
11640+adw_spring_params_new (1, 0.5, 500)
11641+```</doc>
11642+ <source-position filename="src/adw-carousel.h" line="77"/>
11643+ <return-value transfer-ownership="none">
11644+ <type name="none" c:type="void"/>
11645+ </return-value>
11646+ <parameters>
11647+ <instance-parameter name="self" transfer-ownership="none">
11648+ <doc xml:space="preserve"
11649+ filename="src/adw-carousel.c"
11650+ line="1610">a carousel</doc>
11651+ <type name="Carousel" c:type="AdwCarousel*"/>
11652+ </instance-parameter>
11653+ <parameter name="params" transfer-ownership="none">
11654+ <doc xml:space="preserve"
11655+ filename="src/adw-carousel.c"
11656+ line="1611">the new parameters</doc>
11657+ <type name="SpringParams" c:type="AdwSpringParams*"/>
11658+ </parameter>
11659+ </parameters>
11660+ </method>
11661+ <method name="set_spacing"
11662+ c:identifier="adw_carousel_set_spacing"
11663+ glib:set-property="spacing">
11664+ <doc xml:space="preserve"
11665+ filename="src/adw-carousel.c"
11666+ line="1570">Sets spacing between pages in pixels.</doc>
11667+ <source-position filename="src/adw-carousel.h" line="71"/>
11668+ <return-value transfer-ownership="none">
11669+ <type name="none" c:type="void"/>
11670+ </return-value>
11671+ <parameters>
11672+ <instance-parameter name="self" transfer-ownership="none">
11673+ <doc xml:space="preserve"
11674+ filename="src/adw-carousel.c"
11675+ line="1572">a carousel</doc>
11676+ <type name="Carousel" c:type="AdwCarousel*"/>
11677+ </instance-parameter>
11678+ <parameter name="spacing" transfer-ownership="none">
11679+ <doc xml:space="preserve"
11680+ filename="src/adw-carousel.c"
11681+ line="1573">the new spacing value</doc>
11682+ <type name="guint" c:type="guint"/>
11683+ </parameter>
11684+ </parameters>
11685+ </method>
11686+ <property name="allow-long-swipes"
11687+ writable="1"
11688+ transfer-ownership="none"
11689+ setter="set_allow_long_swipes"
11690+ getter="get_allow_long_swipes"
11691+ default-value="FALSE">
11692+ <doc xml:space="preserve"
11693+ filename="src/adw-carousel.c"
11694+ line="976">Whether to allow swiping for more than one page at a time.
11695+
11696+If the value is `FALSE`, each swipe can only move to the adjacent pages.</doc>
11697+ <type name="gboolean" c:type="gboolean"/>
11698+ </property>
11699+ <property name="allow-mouse-drag"
11700+ writable="1"
11701+ transfer-ownership="none"
11702+ setter="set_allow_mouse_drag"
11703+ getter="get_allow_mouse_drag"
11704+ default-value="TRUE">
11705+ <doc xml:space="preserve"
11706+ filename="src/adw-carousel.c"
11707+ line="952">Sets whether the `AdwCarousel` can be dragged with mouse pointer.
11708+
11709+If the value is `FALSE`, dragging is only available on touch.</doc>
11710+ <type name="gboolean" c:type="gboolean"/>
11711+ </property>
11712+ <property name="allow-scroll-wheel"
11713+ writable="1"
11714+ transfer-ownership="none"
11715+ setter="set_allow_scroll_wheel"
11716+ getter="get_allow_scroll_wheel"
11717+ default-value="TRUE">
11718+ <doc xml:space="preserve"
11719+ filename="src/adw-carousel.c"
11720+ line="964">Whether the widget will respond to scroll wheel events.
11721+
11722+If the value is `FALSE`, wheel events will be ignored.</doc>
11723+ <type name="gboolean" c:type="gboolean"/>
11724+ </property>
11725+ <property name="interactive"
11726+ writable="1"
11727+ transfer-ownership="none"
11728+ setter="set_interactive"
11729+ getter="get_interactive"
11730+ default-value="TRUE">
11731+ <doc xml:space="preserve"
11732+ filename="src/adw-carousel.c"
11733+ line="911">Whether the carousel can be navigated.
11734+
11735+This can be used to temporarily disable the carousel to only allow
11736+navigating it in a certain state.</doc>
11737+ <type name="gboolean" c:type="gboolean"/>
11738+ </property>
11739+ <property name="n-pages"
11740+ transfer-ownership="none"
11741+ getter="get_n_pages"
11742+ default-value="0">
11743+ <doc xml:space="preserve"
11744+ filename="src/adw-carousel.c"
11745+ line="885">The number of pages in a `AdwCarousel`.</doc>
11746+ <type name="guint" c:type="guint"/>
11747+ </property>
11748+ <property name="position"
11749+ transfer-ownership="none"
11750+ getter="get_position"
11751+ default-value="0.000000">
11752+ <doc xml:space="preserve"
11753+ filename="src/adw-carousel.c"
11754+ line="897">Current scrolling position, unitless.
11755+
11756+1 matches 1 page. Use [method@Carousel.scroll_to] for changing it.</doc>
11757+ <type name="gdouble" c:type="gdouble"/>
11758+ </property>
11759+ <property name="reveal-duration"
11760+ writable="1"
11761+ transfer-ownership="none"
11762+ setter="set_reveal_duration"
11763+ getter="get_reveal_duration"
11764+ default-value="0">
11765+ <doc xml:space="preserve"
11766+ filename="src/adw-carousel.c"
11767+ line="988">Page reveal duration, in milliseconds.
11768+
11769+Reveal duration is used when animating adding or removing pages.</doc>
11770+ <type name="guint" c:type="guint"/>
11771+ </property>
11772+ <property name="scroll-params"
11773+ writable="1"
11774+ transfer-ownership="none"
11775+ setter="set_scroll_params"
11776+ getter="get_scroll_params">
11777+ <doc xml:space="preserve"
11778+ filename="src/adw-carousel.c"
11779+ line="936">Scroll animation spring parameters.
11780+
11781+The default value is equivalent to:
11782+
11783+```c
11784+adw_spring_params_new (1, 0.5, 500)
11785+```</doc>
11786+ <type name="SpringParams"/>
11787+ </property>
11788+ <property name="spacing"
11789+ writable="1"
11790+ transfer-ownership="none"
11791+ setter="set_spacing"
11792+ getter="get_spacing"
11793+ default-value="0">
11794+ <doc xml:space="preserve"
11795+ filename="src/adw-carousel.c"
11796+ line="924">Spacing between pages in pixels.</doc>
11797+ <type name="guint" c:type="guint"/>
11798+ </property>
11799+ <glib:signal name="page-changed" when="last">
11800+ <doc xml:space="preserve"
11801+ filename="src/adw-carousel.c"
11802+ line="1008">This signal is emitted after a page has been changed.
11803+
11804+It can be used to implement "infinite scrolling" by amending the pages
11805+after every scroll.
11806+
11807+::: note
11808+ An empty carousel is indicated by `(int)index == -1`.</doc>
11809+ <return-value transfer-ownership="none">
11810+ <type name="none" c:type="void"/>
11811+ </return-value>
11812+ <parameters>
11813+ <parameter name="index" transfer-ownership="none">
11814+ <doc xml:space="preserve"
11815+ filename="src/adw-carousel.c"
11816+ line="1011">current page</doc>
11817+ <type name="guint" c:type="guint"/>
11818+ </parameter>
11819+ </parameters>
11820+ </glib:signal>
11821+ </class>
11822+ <record name="CarouselClass"
11823+ c:type="AdwCarouselClass"
11824+ glib:is-gtype-struct-for="Carousel">
11825+ <source-position filename="src/adw-carousel.h" line="24"/>
11826+ <field name="parent_class">
11827+ <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
11828+ </field>
11829+ </record>
11830+ <class name="CarouselIndicatorDots"
11831+ c:symbol-prefix="carousel_indicator_dots"
11832+ c:type="AdwCarouselIndicatorDots"
11833+ parent="Gtk.Widget"
11834+ final="1"
11835+ glib:type-name="AdwCarouselIndicatorDots"
11836+ glib:get-type="adw_carousel_indicator_dots_get_type"
11837+ glib:type-struct="CarouselIndicatorDotsClass">
11838+ <doc xml:space="preserve"
11839+ filename="src/adw-carousel-indicator-dots.c"
11840+ line="24">A dots indicator for [class@Carousel].
11841+
11842+&lt;picture&gt;
11843+ &lt;source srcset="carousel-indicator-dots-dark.png" media="(prefers-color-scheme: dark)"&gt;
11844+ &lt;img src="carousel-indicator-dots.png" alt="carousel-indicator-dots"&gt;
11845+&lt;/picture&gt;
11846+
11847+The `AdwCarouselIndicatorDots` widget shows a set of dots for each page of a
11848+given [class@Carousel]. The dot representing the carousel's active page is
11849+larger and more opaque than the others, the transition to the active and
11850+inactive state is gradual to match the carousel's position.
11851+
11852+See also [class@CarouselIndicatorLines].
11853+
11854+## CSS nodes
11855+
11856+`AdwCarouselIndicatorDots` has a single CSS node with name
11857+`carouselindicatordots`.</doc>
11858+ <source-position filename="src/adw-carousel-indicator-dots.h" line="23"/>
11859+ <implements name="Gtk.Accessible"/>
11860+ <implements name="Gtk.Buildable"/>
11861+ <implements name="Gtk.ConstraintTarget"/>
11862+ <implements name="Gtk.Orientable"/>
11863+ <constructor name="new" c:identifier="adw_carousel_indicator_dots_new">
11864+ <doc xml:space="preserve"
11865+ filename="src/adw-carousel-indicator-dots.c"
11866+ line="364">Creates a new `AdwCarouselIndicatorDots`.</doc>
11867+ <source-position filename="src/adw-carousel-indicator-dots.h"
11868+ line="26"/>
11869+ <return-value transfer-ownership="none">
11870+ <doc xml:space="preserve"
11871+ filename="src/adw-carousel-indicator-dots.c"
11872+ line="369">the newly created `AdwCarouselIndicatorDots`</doc>
11873+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
11874+ </return-value>
11875+ </constructor>
11876+ <method name="get_carousel"
11877+ c:identifier="adw_carousel_indicator_dots_get_carousel"
11878+ glib:get-property="carousel">
11879+ <doc xml:space="preserve"
11880+ filename="src/adw-carousel-indicator-dots.c"
11881+ line="377">Gets the displayed carousel.</doc>
11882+ <source-position filename="src/adw-carousel-indicator-dots.h"
11883+ line="29"/>
11884+ <return-value transfer-ownership="none" nullable="1">
11885+ <doc xml:space="preserve"
11886+ filename="src/adw-carousel-indicator-dots.c"
11887+ line="383">the displayed carousel</doc>
11888+ <type name="Carousel" c:type="AdwCarousel*"/>
11889+ </return-value>
11890+ <parameters>
11891+ <instance-parameter name="self" transfer-ownership="none">
11892+ <doc xml:space="preserve"
11893+ filename="src/adw-carousel-indicator-dots.c"
11894+ line="379">an indicator</doc>
11895+ <type name="CarouselIndicatorDots"
11896+ c:type="AdwCarouselIndicatorDots*"/>
11897+ </instance-parameter>
11898+ </parameters>
11899+ </method>
11900+ <method name="set_carousel"
11901+ c:identifier="adw_carousel_indicator_dots_set_carousel"
11902+ glib:set-property="carousel">
11903+ <doc xml:space="preserve"
11904+ filename="src/adw-carousel-indicator-dots.c"
11905+ line="393">Sets the displayed carousel.</doc>
11906+ <source-position filename="src/adw-carousel-indicator-dots.h"
11907+ line="31"/>
11908+ <return-value transfer-ownership="none">
11909+ <type name="none" c:type="void"/>
11910+ </return-value>
11911+ <parameters>
11912+ <instance-parameter name="self" transfer-ownership="none">
11913+ <doc xml:space="preserve"
11914+ filename="src/adw-carousel-indicator-dots.c"
11915+ line="395">an indicator</doc>
11916+ <type name="CarouselIndicatorDots"
11917+ c:type="AdwCarouselIndicatorDots*"/>
11918+ </instance-parameter>
11919+ <parameter name="carousel"
11920+ transfer-ownership="none"
11921+ nullable="1"
11922+ allow-none="1">
11923+ <doc xml:space="preserve"
11924+ filename="src/adw-carousel-indicator-dots.c"
11925+ line="396">a carousel</doc>
11926+ <type name="Carousel" c:type="AdwCarousel*"/>
11927+ </parameter>
11928+ </parameters>
11929+ </method>
11930+ <property name="carousel"
11931+ writable="1"
11932+ transfer-ownership="none"
11933+ setter="set_carousel"
11934+ getter="get_carousel">
11935+ <doc xml:space="preserve"
11936+ filename="src/adw-carousel-indicator-dots.c"
11937+ line="334">The displayed carousel.</doc>
11938+ <type name="Carousel"/>
11939+ </property>
11940+ </class>
11941+ <record name="CarouselIndicatorDotsClass"
11942+ c:type="AdwCarouselIndicatorDotsClass"
11943+ glib:is-gtype-struct-for="CarouselIndicatorDots">
11944+ <source-position filename="src/adw-carousel-indicator-dots.h" line="23"/>
11945+ <field name="parent_class">
11946+ <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
11947+ </field>
11948+ </record>
11949+ <class name="CarouselIndicatorLines"
11950+ c:symbol-prefix="carousel_indicator_lines"
11951+ c:type="AdwCarouselIndicatorLines"
11952+ parent="Gtk.Widget"
11953+ final="1"
11954+ glib:type-name="AdwCarouselIndicatorLines"
11955+ glib:get-type="adw_carousel_indicator_lines_get_type"
11956+ glib:type-struct="CarouselIndicatorLinesClass">
11957+ <doc xml:space="preserve"
11958+ filename="src/adw-carousel-indicator-lines.c"
11959+ line="23">A lines indicator for [class@Carousel].
11960+
11961+&lt;picture&gt;
11962+ &lt;source srcset="carousel-indicator-dots-lines.png" media="(prefers-color-scheme: dark)"&gt;
11963+ &lt;img src="carousel-indicator-lines.png" alt="carousel-indicator-lines"&gt;
11964+&lt;/picture&gt;
11965+
11966+The `AdwCarouselIndicatorLines` widget shows a set of lines for each page of
11967+a given [class@Carousel]. The carousel's active page is shown as another line
11968+that moves between them to match the carousel's position.
11969+
11970+See also [class@CarouselIndicatorDots].
11971+
11972+## CSS nodes
11973+
11974+`AdwCarouselIndicatorLines` has a single CSS node with name
11975+`carouselindicatorlines`.</doc>
11976+ <source-position filename="src/adw-carousel-indicator-lines.h"
11977+ line="23"/>
11978+ <implements name="Gtk.Accessible"/>
11979+ <implements name="Gtk.Buildable"/>
11980+ <implements name="Gtk.ConstraintTarget"/>
11981+ <implements name="Gtk.Orientable"/>
11982+ <constructor name="new" c:identifier="adw_carousel_indicator_lines_new">
11983+ <doc xml:space="preserve"
11984+ filename="src/adw-carousel-indicator-lines.c"
11985+ line="349">Creates a new `AdwCarouselIndicatorLines`.</doc>
11986+ <source-position filename="src/adw-carousel-indicator-lines.h"
11987+ line="26"/>
11988+ <return-value transfer-ownership="none">
11989+ <doc xml:space="preserve"
11990+ filename="src/adw-carousel-indicator-lines.c"
11991+ line="354">the newly created `AdwCarouselIndicatorLines`</doc>
11992+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
11993+ </return-value>
11994+ </constructor>
11995+ <method name="get_carousel"
11996+ c:identifier="adw_carousel_indicator_lines_get_carousel"
11997+ glib:get-property="carousel">
11998+ <doc xml:space="preserve"
11999+ filename="src/adw-carousel-indicator-lines.c"
12000+ line="362">Gets the displayed carousel.</doc>
12001+ <source-position filename="src/adw-carousel-indicator-lines.h"
12002+ line="29"/>
12003+ <return-value transfer-ownership="none" nullable="1">
12004+ <doc xml:space="preserve"
12005+ filename="src/adw-carousel-indicator-lines.c"
12006+ line="368">the displayed carousel</doc>
12007+ <type name="Carousel" c:type="AdwCarousel*"/>
12008+ </return-value>
12009+ <parameters>
12010+ <instance-parameter name="self" transfer-ownership="none">
12011+ <doc xml:space="preserve"
12012+ filename="src/adw-carousel-indicator-lines.c"
12013+ line="364">an indicator</doc>
12014+ <type name="CarouselIndicatorLines"
12015+ c:type="AdwCarouselIndicatorLines*"/>
12016+ </instance-parameter>
12017+ </parameters>
12018+ </method>
12019+ <method name="set_carousel"
12020+ c:identifier="adw_carousel_indicator_lines_set_carousel"
12021+ glib:set-property="carousel">
12022+ <doc xml:space="preserve"
12023+ filename="src/adw-carousel-indicator-lines.c"
12024+ line="378">Sets the displayed carousel.</doc>
12025+ <source-position filename="src/adw-carousel-indicator-lines.h"
12026+ line="31"/>
12027+ <return-value transfer-ownership="none">
12028+ <type name="none" c:type="void"/>
12029+ </return-value>
12030+ <parameters>
12031+ <instance-parameter name="self" transfer-ownership="none">
12032+ <doc xml:space="preserve"
12033+ filename="src/adw-carousel-indicator-lines.c"
12034+ line="380">an indicator</doc>
12035+ <type name="CarouselIndicatorLines"
12036+ c:type="AdwCarouselIndicatorLines*"/>
12037+ </instance-parameter>
12038+ <parameter name="carousel"
12039+ transfer-ownership="none"
12040+ nullable="1"
12041+ allow-none="1">
12042+ <doc xml:space="preserve"
12043+ filename="src/adw-carousel-indicator-lines.c"
12044+ line="381">a carousel</doc>
12045+ <type name="Carousel" c:type="AdwCarousel*"/>
12046+ </parameter>
12047+ </parameters>
12048+ </method>
12049+ <property name="carousel"
12050+ writable="1"
12051+ transfer-ownership="none"
12052+ setter="set_carousel"
12053+ getter="get_carousel">
12054+ <doc xml:space="preserve"
12055+ filename="src/adw-carousel-indicator-lines.c"
12056+ line="319">The displayed carousel.</doc>
12057+ <type name="Carousel"/>
12058+ </property>
12059+ </class>
12060+ <record name="CarouselIndicatorLinesClass"
12061+ c:type="AdwCarouselIndicatorLinesClass"
12062+ glib:is-gtype-struct-for="CarouselIndicatorLines">
12063+ <source-position filename="src/adw-carousel-indicator-lines.h"
12064+ line="23"/>
12065+ <field name="parent_class">
12066+ <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
12067+ </field>
12068+ </record>
12069+ <enumeration name="CenteringPolicy"
12070+ glib:type-name="AdwCenteringPolicy"
12071+ glib:get-type="adw_centering_policy_get_type"
12072+ c:type="AdwCenteringPolicy">
12073+ <doc xml:space="preserve"
12074+ filename="src/adw-header-bar.c"
12075+ line="138">Describes title centering behavior of a [class@HeaderBar] widget.</doc>
12076+ <member name="loose"
12077+ value="0"
12078+ c:identifier="ADW_CENTERING_POLICY_LOOSE"
12079+ glib:nick="loose"
12080+ glib:name="ADW_CENTERING_POLICY_LOOSE">
12081+ <doc xml:space="preserve"
12082+ filename="src/adw-header-bar.c"
12083+ line="140">Keep the title centered when possible</doc>
12084+ </member>
12085+ <member name="strict"
12086+ value="1"
12087+ c:identifier="ADW_CENTERING_POLICY_STRICT"
12088+ glib:nick="strict"
12089+ glib:name="ADW_CENTERING_POLICY_STRICT">
12090+ <doc xml:space="preserve"
12091+ filename="src/adw-header-bar.c"
12092+ line="141">Keep the title centered at all cost</doc>
12093+ </member>
12094+ </enumeration>
12095+ <class name="Clamp"
12096+ c:symbol-prefix="clamp"
12097+ c:type="AdwClamp"
12098+ parent="Gtk.Widget"
12099+ final="1"
12100+ glib:type-name="AdwClamp"
12101+ glib:get-type="adw_clamp_get_type"
12102+ glib:type-struct="ClampClass">
12103+ <doc xml:space="preserve"
12104+ filename="src/adw-clamp.c"
12105+ line="15">A widget constraining its child to a given size.
12106+
12107+&lt;picture&gt;
12108+ &lt;source srcset="clamp-wide-dark.png" media="(prefers-color-scheme: dark)"&gt;
12109+ &lt;img src="clamp-wide.png" alt="clamp-wide"&gt;
12110+&lt;/picture&gt;
12111+&lt;picture&gt;
12112+ &lt;source srcset="clamp-narrow-dark.png" media="(prefers-color-scheme: dark)"&gt;
12113+ &lt;img src="clamp-narrow.png" alt="clamp-narrow"&gt;
12114+&lt;/picture&gt;
12115+
12116+The `AdwClamp` widget constrains the size of the widget it contains to a
12117+given maximum size. It will constrain the width if it is horizontal, or the
12118+height if it is vertical. The expansion of the child from its minimum to its
12119+maximum size is eased out for a smooth transition.
12120+
12121+If the child requires more than the requested maximum size, it will be
12122+allocated the minimum size it can fit in instead.
12123+
12124+`AdwClamp` can scale with the text scale factor, use the
12125+[property@Clamp:unit] property to enable that behavior.
12126+
12127+See also: [class@ClampLayout], [class@ClampScrollable].
12128+
12129+## CSS nodes
12130+
12131+`AdwClamp` has a single CSS node with name `clamp`.</doc>
12132+ <source-position filename="src/adw-clamp.h" line="24"/>
12133+ <implements name="Gtk.Accessible"/>
12134+ <implements name="Gtk.Buildable"/>
12135+ <implements name="Gtk.ConstraintTarget"/>
12136+ <implements name="Gtk.Orientable"/>
12137+ <constructor name="new" c:identifier="adw_clamp_new">
12138+ <doc xml:space="preserve"
12139+ filename="src/adw-clamp.c"
12140+ line="271">Creates a new `AdwClamp`.</doc>
12141+ <source-position filename="src/adw-clamp.h" line="27"/>
12142+ <return-value transfer-ownership="none">
12143+ <doc xml:space="preserve"
12144+ filename="src/adw-clamp.c"
12145+ line="276">the newly created `AdwClamp`</doc>
12146+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
12147+ </return-value>
12148+ </constructor>
12149+ <method name="get_child"
12150+ c:identifier="adw_clamp_get_child"
12151+ glib:get-property="child">
12152+ <doc xml:space="preserve"
12153+ filename="src/adw-clamp.c"
12154+ line="284">Gets the child widget of @self.</doc>
12155+ <source-position filename="src/adw-clamp.h" line="30"/>
12156+ <return-value transfer-ownership="none" nullable="1">
12157+ <doc xml:space="preserve"
12158+ filename="src/adw-clamp.c"
12159+ line="290">the child widget of @self</doc>
12160+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
12161+ </return-value>
12162+ <parameters>
12163+ <instance-parameter name="self" transfer-ownership="none">
12164+ <doc xml:space="preserve"
12165+ filename="src/adw-clamp.c"
12166+ line="286">a clamp</doc>
12167+ <type name="Clamp" c:type="AdwClamp*"/>
12168+ </instance-parameter>
12169+ </parameters>
12170+ </method>
12171+ <method name="get_maximum_size"
12172+ c:identifier="adw_clamp_get_maximum_size"
12173+ glib:get-property="maximum-size">
12174+ <doc xml:space="preserve"
12175+ filename="src/adw-clamp.c"
12176+ line="330">Gets the maximum size allocated to the child.</doc>
12177+ <source-position filename="src/adw-clamp.h" line="36"/>
12178+ <return-value transfer-ownership="none">
12179+ <doc xml:space="preserve"
12180+ filename="src/adw-clamp.c"
12181+ line="336">the maximum size to allocate to the child</doc>
12182+ <type name="gint" c:type="int"/>
12183+ </return-value>
12184+ <parameters>
12185+ <instance-parameter name="self" transfer-ownership="none">
12186+ <doc xml:space="preserve"
12187+ filename="src/adw-clamp.c"
12188+ line="332">a clamp</doc>
12189+ <type name="Clamp" c:type="AdwClamp*"/>
12190+ </instance-parameter>
12191+ </parameters>
12192+ </method>
12193+ <method name="get_tightening_threshold"
12194+ c:identifier="adw_clamp_get_tightening_threshold"
12195+ glib:get-property="tightening-threshold">
12196+ <doc xml:space="preserve"
12197+ filename="src/adw-clamp.c"
12198+ line="377">Gets the size above which the child is clamped.</doc>
12199+ <source-position filename="src/adw-clamp.h" line="42"/>
12200+ <return-value transfer-ownership="none">
12201+ <doc xml:space="preserve"
12202+ filename="src/adw-clamp.c"
12203+ line="383">the size above which the child is clamped</doc>
12204+ <type name="gint" c:type="int"/>
12205+ </return-value>
12206+ <parameters>
12207+ <instance-parameter name="self" transfer-ownership="none">
12208+ <doc xml:space="preserve"
12209+ filename="src/adw-clamp.c"
12210+ line="379">a clamp</doc>
12211+ <type name="Clamp" c:type="AdwClamp*"/>
12212+ </instance-parameter>
12213+ </parameters>
12214+ </method>
12215+ <method name="get_unit"
12216+ c:identifier="adw_clamp_get_unit"
12217+ glib:get-property="unit"
12218+ version="1.4">
12219+ <doc xml:space="preserve"
12220+ filename="src/adw-clamp.c"
12221+ line="435">Gets the length unit for maximum size and tightening threshold.</doc>
12222+ <source-position filename="src/adw-clamp.h" line="48"/>
12223+ <return-value transfer-ownership="none">
12224+ <doc xml:space="preserve"
12225+ filename="src/adw-clamp.c"
12226+ line="441">the length unit</doc>
12227+ <type name="LengthUnit" c:type="AdwLengthUnit"/>
12228+ </return-value>
12229+ <parameters>
12230+ <instance-parameter name="self" transfer-ownership="none">
12231+ <doc xml:space="preserve"
12232+ filename="src/adw-clamp.c"
12233+ line="437">a clamp</doc>
12234+ <type name="Clamp" c:type="AdwClamp*"/>
12235+ </instance-parameter>
12236+ </parameters>
12237+ </method>
12238+ <method name="set_child"
12239+ c:identifier="adw_clamp_set_child"
12240+ glib:set-property="child">
12241+ <doc xml:space="preserve"
12242+ filename="src/adw-clamp.c"
12243+ line="300">Sets the child widget of @self.</doc>
12244+ <source-position filename="src/adw-clamp.h" line="32"/>
12245+ <return-value transfer-ownership="none">
12246+ <type name="none" c:type="void"/>
12247+ </return-value>
12248+ <parameters>
12249+ <instance-parameter name="self" transfer-ownership="none">
12250+ <doc xml:space="preserve"
12251+ filename="src/adw-clamp.c"
12252+ line="302">a clamp</doc>
12253+ <type name="Clamp" c:type="AdwClamp*"/>
12254+ </instance-parameter>
12255+ <parameter name="child"
12256+ transfer-ownership="none"
12257+ nullable="1"
12258+ allow-none="1">
12259+ <doc xml:space="preserve"
12260+ filename="src/adw-clamp.c"
12261+ line="303">the child widget</doc>
12262+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
12263+ </parameter>
12264+ </parameters>
12265+ </method>
12266+ <method name="set_maximum_size"
12267+ c:identifier="adw_clamp_set_maximum_size"
12268+ glib:set-property="maximum-size">
12269+ <doc xml:space="preserve"
12270+ filename="src/adw-clamp.c"
12271+ line="350">Sets the maximum size allocated to the child.
12272+
12273+It is the width if the clamp is horizontal, or the height if it is vertical.</doc>
12274+ <source-position filename="src/adw-clamp.h" line="38"/>
12275+ <return-value transfer-ownership="none">
12276+ <type name="none" c:type="void"/>
12277+ </return-value>
12278+ <parameters>
12279+ <instance-parameter name="self" transfer-ownership="none">
12280+ <doc xml:space="preserve"
12281+ filename="src/adw-clamp.c"
12282+ line="352">a clamp</doc>
12283+ <type name="Clamp" c:type="AdwClamp*"/>
12284+ </instance-parameter>
12285+ <parameter name="maximum_size" transfer-ownership="none">
12286+ <doc xml:space="preserve"
12287+ filename="src/adw-clamp.c"
12288+ line="353">the maximum size</doc>
12289+ <type name="gint" c:type="int"/>
12290+ </parameter>
12291+ </parameters>
12292+ </method>
12293+ <method name="set_tightening_threshold"
12294+ c:identifier="adw_clamp_set_tightening_threshold"
12295+ glib:set-property="tightening-threshold">
12296+ <doc xml:space="preserve"
12297+ filename="src/adw-clamp.c"
12298+ line="397">Sets the size above which the child is clamped.
12299+
12300+Starting from this size, the clamp will tighten its grip on the child, slowly
12301+allocating less and less of the available size up to the maximum allocated
12302+size. Below that threshold and below the maximum size, the child will be
12303+allocated all the available size.
12304+
12305+If the threshold is greater than the maximum size to allocate to the child,
12306+the child will be allocated all the size up to the maximum. If the threshold
12307+is lower than the minimum size to allocate to the child, that size will be
12308+used as the tightening threshold.
12309+
12310+Effectively, tightening the grip on the child before it reaches its maximum
12311+size makes transitions to and from the maximum size smoother when resizing.</doc>
12312+ <source-position filename="src/adw-clamp.h" line="44"/>
12313+ <return-value transfer-ownership="none">
12314+ <type name="none" c:type="void"/>
12315+ </return-value>
12316+ <parameters>
12317+ <instance-parameter name="self" transfer-ownership="none">
12318+ <doc xml:space="preserve"
12319+ filename="src/adw-clamp.c"
12320+ line="399">a clamp</doc>
12321+ <type name="Clamp" c:type="AdwClamp*"/>
12322+ </instance-parameter>
12323+ <parameter name="tightening_threshold" transfer-ownership="none">
12324+ <doc xml:space="preserve"
12325+ filename="src/adw-clamp.c"
12326+ line="400">the tightening threshold</doc>
12327+ <type name="gint" c:type="int"/>
12328+ </parameter>
12329+ </parameters>
12330+ </method>
12331+ <method name="set_unit"
12332+ c:identifier="adw_clamp_set_unit"
12333+ glib:set-property="unit"
12334+ version="1.4">
12335+ <doc xml:space="preserve"
12336+ filename="src/adw-clamp.c"
12337+ line="457">Sets the length unit for maximum size and tightening threshold.
12338+
12339+Allows the sizes to vary depending on the text scale factor.</doc>
12340+ <source-position filename="src/adw-clamp.h" line="50"/>
12341+ <return-value transfer-ownership="none">
12342+ <type name="none" c:type="void"/>
12343+ </return-value>
12344+ <parameters>
12345+ <instance-parameter name="self" transfer-ownership="none">
12346+ <doc xml:space="preserve"
12347+ filename="src/adw-clamp.c"
12348+ line="459">a clamp</doc>
12349+ <type name="Clamp" c:type="AdwClamp*"/>
12350+ </instance-parameter>
12351+ <parameter name="unit" transfer-ownership="none">
12352+ <doc xml:space="preserve"
12353+ filename="src/adw-clamp.c"
12354+ line="460">the length unit</doc>
12355+ <type name="LengthUnit" c:type="AdwLengthUnit"/>
12356+ </parameter>
12357+ </parameters>
12358+ </method>
12359+ <property name="child"
12360+ writable="1"
12361+ transfer-ownership="none"
12362+ setter="set_child"
12363+ getter="get_child">
12364+ <doc xml:space="preserve"
12365+ filename="src/adw-clamp.c"
12366+ line="179">The child widget of the `AdwClamp`.</doc>
12367+ <type name="Gtk.Widget"/>
12368+ </property>
12369+ <property name="maximum-size"
12370+ writable="1"
12371+ transfer-ownership="none"
12372+ setter="set_maximum_size"
12373+ getter="get_maximum_size"
12374+ default-value="600">
12375+ <doc xml:space="preserve"
12376+ filename="src/adw-clamp.c"
12377+ line="189">The maximum size allocated to the child.
12378+
12379+It is the width if the clamp is horizontal, or the height if it is vertical.</doc>
12380+ <type name="gint" c:type="gint"/>
12381+ </property>
12382+ <property name="tightening-threshold"
12383+ writable="1"
12384+ transfer-ownership="none"
12385+ setter="set_tightening_threshold"
12386+ getter="get_tightening_threshold"
12387+ default-value="400">
12388+ <doc xml:space="preserve"
12389+ filename="src/adw-clamp.c"
12390+ line="201">The size above which the child is clamped.
12391+
12392+Starting from this size, the clamp will tighten its grip on the child,
12393+slowly allocating less and less of the available size up to the maximum
12394+allocated size. Below that threshold and below the maximum size, the child
12395+will be allocated all the available size.
12396+
12397+If the threshold is greater than the maximum size to allocate to the child,
12398+the child will be allocated all the size up to the maximum.
12399+If the threshold is lower than the minimum size to allocate to the child,
12400+that size will be used as the tightening threshold.
12401+
12402+Effectively, tightening the grip on the child before it reaches its maximum
12403+size makes transitions to and from the maximum size smoother when resizing.</doc>
12404+ <type name="gint" c:type="gint"/>
12405+ </property>
12406+ <property name="unit"
12407+ version="1.4"
12408+ writable="1"
12409+ transfer-ownership="none"
12410+ setter="set_unit"
12411+ getter="get_unit"
12412+ default-value="ADW_LENGTH_UNIT_SP">
12413+ <doc xml:space="preserve"
12414+ filename="src/adw-clamp.c"
12415+ line="224">The length unit for maximum size and tightening threshold.
12416+
12417+Allows the sizes to vary depending on the text scale factor.</doc>
12418+ <type name="LengthUnit"/>
12419+ </property>
12420+ </class>
12421+ <record name="ClampClass"
12422+ c:type="AdwClampClass"
12423+ glib:is-gtype-struct-for="Clamp">
12424+ <source-position filename="src/adw-clamp.h" line="24"/>
12425+ <field name="parent_class">
12426+ <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
12427+ </field>
12428+ </record>
12429+ <class name="ClampLayout"
12430+ c:symbol-prefix="clamp_layout"
12431+ c:type="AdwClampLayout"
12432+ parent="Gtk.LayoutManager"
12433+ final="1"
12434+ glib:type-name="AdwClampLayout"
12435+ glib:get-type="adw_clamp_layout_get_type"
12436+ glib:type-struct="ClampLayoutClass">
12437+ <doc xml:space="preserve"
12438+ filename="src/adw-clamp-layout.c"
12439+ line="17">A layout manager constraining its children to a given size.
12440+
12441+&lt;picture&gt;
12442+ &lt;source srcset="clamp-wide-dark.png" media="(prefers-color-scheme: dark)"&gt;
12443+ &lt;img src="clamp-wide.png" alt="clamp-wide"&gt;
12444+&lt;/picture&gt;
12445+&lt;picture&gt;
12446+ &lt;source srcset="clamp-narrow-dark.png" media="(prefers-color-scheme: dark)"&gt;
12447+ &lt;img src="clamp-narrow.png" alt="clamp-narrow"&gt;
12448+&lt;/picture&gt;
12449+
12450+`AdwClampLayout` constraints the size of the widgets it contains to a given
12451+maximum size. It will constrain the width if it is horizontal, or the height
12452+if it is vertical. The expansion of the children from their minimum to their
12453+maximum size is eased out for a smooth transition.
12454+
12455+If a child requires more than the requested maximum size, it will be
12456+allocated the minimum size it can fit in instead.
12457+
12458+`AdwClampLayout` can scale with the text scale factor, use the
12459+[property@ClampLayout:unit] property to enable that behavior.
12460+
12461+See also: [class@Clamp], [class@ClampScrollable].</doc>
12462+ <source-position filename="src/adw-clamp-layout.h" line="24"/>
12463+ <implements name="Gtk.Orientable"/>
12464+ <constructor name="new" c:identifier="adw_clamp_layout_new">
12465+ <doc xml:space="preserve"
12466+ filename="src/adw-clamp-layout.c"
12467+ line="434">Creates a new `AdwClampLayout`.</doc>
12468+ <source-position filename="src/adw-clamp-layout.h" line="27"/>
12469+ <return-value transfer-ownership="full">
12470+ <doc xml:space="preserve"
12471+ filename="src/adw-clamp-layout.c"
12472+ line="439">the newly created `AdwClampLayout`</doc>
12473+ <type name="Gtk.LayoutManager" c:type="GtkLayoutManager*"/>
12474+ </return-value>
12475+ </constructor>
12476+ <method name="get_maximum_size"
12477+ c:identifier="adw_clamp_layout_get_maximum_size"
12478+ glib:get-property="maximum-size">
12479+ <doc xml:space="preserve"
12480+ filename="src/adw-clamp-layout.c"
12481+ line="447">Gets the maximum size allocated to the children.</doc>
12482+ <source-position filename="src/adw-clamp-layout.h" line="30"/>
12483+ <return-value transfer-ownership="none">
12484+ <doc xml:space="preserve"
12485+ filename="src/adw-clamp-layout.c"
12486+ line="453">the maximum size to allocate to the children</doc>
12487+ <type name="gint" c:type="int"/>
12488+ </return-value>
12489+ <parameters>
12490+ <instance-parameter name="self" transfer-ownership="none">
12491+ <doc xml:space="preserve"
12492+ filename="src/adw-clamp-layout.c"
12493+ line="449">a clamp layout</doc>
12494+ <type name="ClampLayout" c:type="AdwClampLayout*"/>
12495+ </instance-parameter>
12496+ </parameters>
12497+ </method>
12498+ <method name="get_tightening_threshold"
12499+ c:identifier="adw_clamp_layout_get_tightening_threshold"
12500+ glib:get-property="tightening-threshold">
12501+ <doc xml:space="preserve"
12502+ filename="src/adw-clamp-layout.c"
12503+ line="488">Gets the size above which the children are clamped.</doc>
12504+ <source-position filename="src/adw-clamp-layout.h" line="36"/>
12505+ <return-value transfer-ownership="none">
12506+ <doc xml:space="preserve"
12507+ filename="src/adw-clamp-layout.c"
12508+ line="494">the size above which the children are clamped</doc>
12509+ <type name="gint" c:type="int"/>
12510+ </return-value>
12511+ <parameters>
12512+ <instance-parameter name="self" transfer-ownership="none">
12513+ <doc xml:space="preserve"
12514+ filename="src/adw-clamp-layout.c"
12515+ line="490">a clamp layout</doc>
12516+ <type name="ClampLayout" c:type="AdwClampLayout*"/>
12517+ </instance-parameter>
12518+ </parameters>
12519+ </method>
12520+ <method name="get_unit"
12521+ c:identifier="adw_clamp_layout_get_unit"
12522+ glib:get-property="unit"
12523+ version="1.4">
12524+ <doc xml:space="preserve"
12525+ filename="src/adw-clamp-layout.c"
12526+ line="540">Gets the length unit for maximum size and tightening threshold.</doc>
12527+ <source-position filename="src/adw-clamp-layout.h" line="42"/>
12528+ <return-value transfer-ownership="none">
12529+ <doc xml:space="preserve"
12530+ filename="src/adw-clamp-layout.c"
12531+ line="546">the length unit</doc>
12532+ <type name="LengthUnit" c:type="AdwLengthUnit"/>
12533+ </return-value>
12534+ <parameters>
12535+ <instance-parameter name="self" transfer-ownership="none">
12536+ <doc xml:space="preserve"
12537+ filename="src/adw-clamp-layout.c"
12538+ line="542">a clamp layout</doc>
12539+ <type name="ClampLayout" c:type="AdwClampLayout*"/>
12540+ </instance-parameter>
12541+ </parameters>
12542+ </method>
12543+ <method name="set_maximum_size"
12544+ c:identifier="adw_clamp_layout_set_maximum_size"
12545+ glib:set-property="maximum-size">
12546+ <doc xml:space="preserve"
12547+ filename="src/adw-clamp-layout.c"
12548+ line="463">Sets the maximum size allocated to the children.
12549+
12550+It is the width if the layout is horizontal, or the height if it is vertical.</doc>
12551+ <source-position filename="src/adw-clamp-layout.h" line="32"/>
12552+ <return-value transfer-ownership="none">
12553+ <type name="none" c:type="void"/>
12554+ </return-value>
12555+ <parameters>
12556+ <instance-parameter name="self" transfer-ownership="none">
12557+ <doc xml:space="preserve"
12558+ filename="src/adw-clamp-layout.c"
12559+ line="465">a clamp layout</doc>
12560+ <type name="ClampLayout" c:type="AdwClampLayout*"/>
12561+ </instance-parameter>
12562+ <parameter name="maximum_size" transfer-ownership="none">
12563+ <doc xml:space="preserve"
12564+ filename="src/adw-clamp-layout.c"
12565+ line="466">the maximum size</doc>
12566+ <type name="gint" c:type="int"/>
12567+ </parameter>
12568+ </parameters>
12569+ </method>
12570+ <method name="set_tightening_threshold"
12571+ c:identifier="adw_clamp_layout_set_tightening_threshold"
12572+ glib:set-property="tightening-threshold">
12573+ <doc xml:space="preserve"
12574+ filename="src/adw-clamp-layout.c"
12575+ line="504">Sets the size above which the children are clamped.
12576+
12577+Starting from this size, the layout will tighten its grip on the children,
12578+slowly allocating less and less of the available size up to the maximum
12579+allocated size. Below that threshold and below the maximum size, the children
12580+will be allocated all the available size.
12581+
12582+If the threshold is greater than the maximum size to allocate to the
12583+children, they will be allocated the whole size up to the maximum. If the
12584+threshold is lower than the minimum size to allocate to the children, that
12585+size will be used as the tightening threshold.
12586+
12587+Effectively, tightening the grip on a child before it reaches its maximum
12588+size makes transitions to and from the maximum size smoother when resizing.</doc>
12589+ <source-position filename="src/adw-clamp-layout.h" line="38"/>
12590+ <return-value transfer-ownership="none">
12591+ <type name="none" c:type="void"/>
12592+ </return-value>
12593+ <parameters>
12594+ <instance-parameter name="self" transfer-ownership="none">
12595+ <doc xml:space="preserve"
12596+ filename="src/adw-clamp-layout.c"
12597+ line="506">a clamp layout</doc>
12598+ <type name="ClampLayout" c:type="AdwClampLayout*"/>
12599+ </instance-parameter>
12600+ <parameter name="tightening_threshold" transfer-ownership="none">
12601+ <doc xml:space="preserve"
12602+ filename="src/adw-clamp-layout.c"
12603+ line="507">the tightening threshold</doc>
12604+ <type name="gint" c:type="int"/>
12605+ </parameter>
12606+ </parameters>
12607+ </method>
12608+ <method name="set_unit"
12609+ c:identifier="adw_clamp_layout_set_unit"
12610+ glib:set-property="unit"
12611+ version="1.4">
12612+ <doc xml:space="preserve"
12613+ filename="src/adw-clamp-layout.c"
12614+ line="558">Sets the length unit for maximum size and tightening threshold.
12615+
12616+Allows the sizes to vary depending on the text scale factor.</doc>
12617+ <source-position filename="src/adw-clamp-layout.h" line="44"/>
12618+ <return-value transfer-ownership="none">
12619+ <type name="none" c:type="void"/>
12620+ </return-value>
12621+ <parameters>
12622+ <instance-parameter name="self" transfer-ownership="none">
12623+ <doc xml:space="preserve"
12624+ filename="src/adw-clamp-layout.c"
12625+ line="560">a clamp layout</doc>
12626+ <type name="ClampLayout" c:type="AdwClampLayout*"/>
12627+ </instance-parameter>
12628+ <parameter name="unit" transfer-ownership="none">
12629+ <doc xml:space="preserve"
12630+ filename="src/adw-clamp-layout.c"
12631+ line="561">the length unit</doc>
12632+ <type name="LengthUnit" c:type="AdwLengthUnit"/>
12633+ </parameter>
12634+ </parameters>
12635+ </method>
12636+ <property name="maximum-size"
12637+ writable="1"
12638+ transfer-ownership="none"
12639+ setter="set_maximum_size"
12640+ getter="get_maximum_size"
12641+ default-value="600">
12642+ <doc xml:space="preserve"
12643+ filename="src/adw-clamp-layout.c"
12644+ line="372">The maximum size to allocate to the children.
12645+
12646+It is the width if the layout is horizontal, or the height if it is
12647+vertical.</doc>
12648+ <type name="gint" c:type="gint"/>
12649+ </property>
12650+ <property name="tightening-threshold"
12651+ writable="1"
12652+ transfer-ownership="none"
12653+ setter="set_tightening_threshold"
12654+ getter="get_tightening_threshold"
12655+ default-value="400">
12656+ <doc xml:space="preserve"
12657+ filename="src/adw-clamp-layout.c"
12658+ line="385">The size above which the children are clamped.
12659+
12660+Starting from this size, the layout will tighten its grip on the children,
12661+slowly allocating less and less of the available size up to the maximum
12662+allocated size. Below that threshold and below the maximum size, the
12663+children will be allocated all the available size.
12664+
12665+If the threshold is greater than the maximum size to allocate to the
12666+children, they will be allocated the whole size up to the maximum. If the
12667+threshold is lower than the minimum size to allocate to the children, that
12668+size will be used as the tightening threshold.
12669+
12670+Effectively, tightening the grip on a child before it reaches its maximum
12671+size makes transitions to and from the maximum size smoother when resizing.</doc>
12672+ <type name="gint" c:type="gint"/>
12673+ </property>
12674+ <property name="unit"
12675+ version="1.4"
12676+ writable="1"
12677+ transfer-ownership="none"
12678+ setter="set_unit"
12679+ getter="get_unit"
12680+ default-value="ADW_LENGTH_UNIT_SP">
12681+ <doc xml:space="preserve"
12682+ filename="src/adw-clamp-layout.c"
12683+ line="408">The length unit for maximum size and tightening threshold.
12684+
12685+Allows the sizes to vary depending on the text scale factor.</doc>
12686+ <type name="LengthUnit"/>
12687+ </property>
12688+ </class>
12689+ <record name="ClampLayoutClass"
12690+ c:type="AdwClampLayoutClass"
12691+ glib:is-gtype-struct-for="ClampLayout">
12692+ <source-position filename="src/adw-clamp-layout.h" line="24"/>
12693+ <field name="parent_class">
12694+ <type name="Gtk.LayoutManagerClass" c:type="GtkLayoutManagerClass"/>
12695+ </field>
12696+ </record>
12697+ <class name="ClampScrollable"
12698+ c:symbol-prefix="clamp_scrollable"
12699+ c:type="AdwClampScrollable"
12700+ parent="Gtk.Widget"
12701+ final="1"
12702+ glib:type-name="AdwClampScrollable"
12703+ glib:get-type="adw_clamp_scrollable_get_type"
12704+ glib:type-struct="ClampScrollableClass">
12705+ <doc xml:space="preserve"
12706+ filename="src/adw-clamp-scrollable.c"
12707+ line="15">A scrollable [class@Clamp].
12708+
12709+`AdwClampScrollable` is a variant of [class@Clamp] that implements the
12710+[iface@Gtk.Scrollable] interface.
12711+
12712+The primary use case for `AdwClampScrollable` is clamping
12713+[class@Gtk.ListView].
12714+
12715+See also: [class@ClampLayout].</doc>
12716+ <source-position filename="src/adw-clamp-scrollable.h" line="24"/>
12717+ <implements name="Gtk.Accessible"/>
12718+ <implements name="Gtk.Buildable"/>
12719+ <implements name="Gtk.ConstraintTarget"/>
12720+ <implements name="Gtk.Orientable"/>
12721+ <implements name="Gtk.Scrollable"/>
12722+ <constructor name="new" c:identifier="adw_clamp_scrollable_new">
12723+ <doc xml:space="preserve"
12724+ filename="src/adw-clamp-scrollable.c"
12725+ line="355">Creates a new `AdwClampScrollable`.</doc>
12726+ <source-position filename="src/adw-clamp-scrollable.h" line="27"/>
12727+ <return-value transfer-ownership="none">
12728+ <doc xml:space="preserve"
12729+ filename="src/adw-clamp-scrollable.c"
12730+ line="360">the newly created `AdwClampScrollable`</doc>
12731+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
12732+ </return-value>
12733+ </constructor>
12734+ <method name="get_child"
12735+ c:identifier="adw_clamp_scrollable_get_child"
12736+ glib:get-property="child">
12737+ <doc xml:space="preserve"
12738+ filename="src/adw-clamp-scrollable.c"
12739+ line="368">Gets the child widget of @self.</doc>
12740+ <source-position filename="src/adw-clamp-scrollable.h" line="30"/>
12741+ <return-value transfer-ownership="none" nullable="1">
12742+ <doc xml:space="preserve"
12743+ filename="src/adw-clamp-scrollable.c"
12744+ line="374">the child widget of @self</doc>
12745+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
12746+ </return-value>
12747+ <parameters>
12748+ <instance-parameter name="self" transfer-ownership="none">
12749+ <doc xml:space="preserve"
12750+ filename="src/adw-clamp-scrollable.c"
12751+ line="370">a clamp scrollable</doc>
12752+ <type name="ClampScrollable" c:type="AdwClampScrollable*"/>
12753+ </instance-parameter>
12754+ </parameters>
12755+ </method>
12756+ <method name="get_maximum_size"
12757+ c:identifier="adw_clamp_scrollable_get_maximum_size"
12758+ glib:get-property="maximum-size">
12759+ <doc xml:space="preserve"
12760+ filename="src/adw-clamp-scrollable.c"
12761+ line="439">Gets the maximum size allocated to the child.</doc>
12762+ <source-position filename="src/adw-clamp-scrollable.h" line="36"/>
12763+ <return-value transfer-ownership="none">
12764+ <doc xml:space="preserve"
12765+ filename="src/adw-clamp-scrollable.c"
12766+ line="445">the maximum size to allocate to the child</doc>
12767+ <type name="gint" c:type="int"/>
12768+ </return-value>
12769+ <parameters>
12770+ <instance-parameter name="self" transfer-ownership="none">
12771+ <doc xml:space="preserve"
12772+ filename="src/adw-clamp-scrollable.c"
12773+ line="441">a clamp scrollable</doc>
12774+ <type name="ClampScrollable" c:type="AdwClampScrollable*"/>
12775+ </instance-parameter>
12776+ </parameters>
12777+ </method>
12778+ <method name="get_tightening_threshold"
12779+ c:identifier="adw_clamp_scrollable_get_tightening_threshold"
12780+ glib:get-property="tightening-threshold">
12781+ <doc xml:space="preserve"
12782+ filename="src/adw-clamp-scrollable.c"
12783+ line="486">Gets the size above which the child is clamped.</doc>
12784+ <source-position filename="src/adw-clamp-scrollable.h" line="42"/>
12785+ <return-value transfer-ownership="none">
12786+ <doc xml:space="preserve"
12787+ filename="src/adw-clamp-scrollable.c"
12788+ line="492">the size above which the child is clamped</doc>
12789+ <type name="gint" c:type="int"/>
12790+ </return-value>
12791+ <parameters>
12792+ <instance-parameter name="self" transfer-ownership="none">
12793+ <doc xml:space="preserve"
12794+ filename="src/adw-clamp-scrollable.c"
12795+ line="488">a clamp scrollable</doc>
12796+ <type name="ClampScrollable" c:type="AdwClampScrollable*"/>
12797+ </instance-parameter>
12798+ </parameters>
12799+ </method>
12800+ <method name="get_unit"
12801+ c:identifier="adw_clamp_scrollable_get_unit"
12802+ glib:get-property="unit"
12803+ version="1.4">
12804+ <doc xml:space="preserve"
12805+ filename="src/adw-clamp-scrollable.c"
12806+ line="544">Gets the length unit for maximum size and tightening threshold.</doc>
12807+ <source-position filename="src/adw-clamp-scrollable.h" line="48"/>
12808+ <return-value transfer-ownership="none">
12809+ <doc xml:space="preserve"
12810+ filename="src/adw-clamp-scrollable.c"
12811+ line="550">the length unit</doc>
12812+ <type name="LengthUnit" c:type="AdwLengthUnit"/>
12813+ </return-value>
12814+ <parameters>
12815+ <instance-parameter name="self" transfer-ownership="none">
12816+ <doc xml:space="preserve"
12817+ filename="src/adw-clamp-scrollable.c"
12818+ line="546">a clamp scrollable</doc>
12819+ <type name="ClampScrollable" c:type="AdwClampScrollable*"/>
12820+ </instance-parameter>
12821+ </parameters>
12822+ </method>
12823+ <method name="set_child"
12824+ c:identifier="adw_clamp_scrollable_set_child"
12825+ glib:set-property="child">
12826+ <doc xml:space="preserve"
12827+ filename="src/adw-clamp-scrollable.c"
12828+ line="384">Sets the child widget of @self.</doc>
12829+ <source-position filename="src/adw-clamp-scrollable.h" line="32"/>
12830+ <return-value transfer-ownership="none">
12831+ <type name="none" c:type="void"/>
12832+ </return-value>
12833+ <parameters>
12834+ <instance-parameter name="self" transfer-ownership="none">
12835+ <doc xml:space="preserve"
12836+ filename="src/adw-clamp-scrollable.c"
12837+ line="386">a clamp scrollable</doc>
12838+ <type name="ClampScrollable" c:type="AdwClampScrollable*"/>
12839+ </instance-parameter>
12840+ <parameter name="child"
12841+ transfer-ownership="none"
12842+ nullable="1"
12843+ allow-none="1">
12844+ <doc xml:space="preserve"
12845+ filename="src/adw-clamp-scrollable.c"
12846+ line="387">the child widget</doc>
12847+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
12848+ </parameter>
12849+ </parameters>
12850+ </method>
12851+ <method name="set_maximum_size"
12852+ c:identifier="adw_clamp_scrollable_set_maximum_size"
12853+ glib:set-property="maximum-size">
12854+ <doc xml:space="preserve"
12855+ filename="src/adw-clamp-scrollable.c"
12856+ line="459">Sets the maximum size allocated to the child.
12857+
12858+It is the width if the clamp is horizontal, or the height if it is vertical.</doc>
12859+ <source-position filename="src/adw-clamp-scrollable.h" line="38"/>
12860+ <return-value transfer-ownership="none">
12861+ <type name="none" c:type="void"/>
12862+ </return-value>
12863+ <parameters>
12864+ <instance-parameter name="self" transfer-ownership="none">
12865+ <doc xml:space="preserve"
12866+ filename="src/adw-clamp-scrollable.c"
12867+ line="461">a clamp scrollable</doc>
12868+ <type name="ClampScrollable" c:type="AdwClampScrollable*"/>
12869+ </instance-parameter>
12870+ <parameter name="maximum_size" transfer-ownership="none">
12871+ <doc xml:space="preserve"
12872+ filename="src/adw-clamp-scrollable.c"
12873+ line="462">the maximum size</doc>
12874+ <type name="gint" c:type="int"/>
12875+ </parameter>
12876+ </parameters>
12877+ </method>
12878+ <method name="set_tightening_threshold"
12879+ c:identifier="adw_clamp_scrollable_set_tightening_threshold"
12880+ glib:set-property="tightening-threshold">
12881+ <doc xml:space="preserve"
12882+ filename="src/adw-clamp-scrollable.c"
12883+ line="506">Sets the size above which the child is clamped.
12884+
12885+Starting from this size, the clamp will tighten its grip on the child, slowly
12886+allocating less and less of the available size up to the maximum allocated
12887+size. Below that threshold and below the maximum width, the child will be
12888+allocated all the available size.
12889+
12890+If the threshold is greater than the maximum size to allocate to the child,
12891+the child will be allocated all the width up to the maximum. If the threshold
12892+is lower than the minimum size to allocate to the child, that size will be
12893+used as the tightening threshold.
12894+
12895+Effectively, tightening the grip on the child before it reaches its maximum
12896+size makes transitions to and from the maximum size smoother when resizing.</doc>
12897+ <source-position filename="src/adw-clamp-scrollable.h" line="44"/>
12898+ <return-value transfer-ownership="none">
12899+ <type name="none" c:type="void"/>
12900+ </return-value>
12901+ <parameters>
12902+ <instance-parameter name="self" transfer-ownership="none">
12903+ <doc xml:space="preserve"
12904+ filename="src/adw-clamp-scrollable.c"
12905+ line="508">a clamp scrollable</doc>
12906+ <type name="ClampScrollable" c:type="AdwClampScrollable*"/>
12907+ </instance-parameter>
12908+ <parameter name="tightening_threshold" transfer-ownership="none">
12909+ <doc xml:space="preserve"
12910+ filename="src/adw-clamp-scrollable.c"
12911+ line="509">the tightening threshold</doc>
12912+ <type name="gint" c:type="int"/>
12913+ </parameter>
12914+ </parameters>
12915+ </method>
12916+ <method name="set_unit"
12917+ c:identifier="adw_clamp_scrollable_set_unit"
12918+ glib:set-property="unit"
12919+ version="1.4">
12920+ <doc xml:space="preserve"
12921+ filename="src/adw-clamp-scrollable.c"
12922+ line="566">Sets the length unit for maximum size and tightening threshold.
12923+
12924+Allows the sizes to vary depending on the text scale factor.</doc>
12925+ <source-position filename="src/adw-clamp-scrollable.h" line="50"/>
12926+ <return-value transfer-ownership="none">
12927+ <type name="none" c:type="void"/>
12928+ </return-value>
12929+ <parameters>
12930+ <instance-parameter name="self" transfer-ownership="none">
12931+ <doc xml:space="preserve"
12932+ filename="src/adw-clamp-scrollable.c"
12933+ line="568">a clamp</doc>
12934+ <type name="ClampScrollable" c:type="AdwClampScrollable*"/>
12935+ </instance-parameter>
12936+ <parameter name="unit" transfer-ownership="none">
12937+ <doc xml:space="preserve"
12938+ filename="src/adw-clamp-scrollable.c"
12939+ line="569">the length unit</doc>
12940+ <type name="LengthUnit" c:type="AdwLengthUnit"/>
12941+ </parameter>
12942+ </parameters>
12943+ </method>
12944+ <property name="child"
12945+ writable="1"
12946+ transfer-ownership="none"
12947+ setter="set_child"
12948+ getter="get_child">
12949+ <doc xml:space="preserve"
12950+ filename="src/adw-clamp-scrollable.c"
12951+ line="264">The child widget of the `AdwClampScrollable`.</doc>
12952+ <type name="Gtk.Widget"/>
12953+ </property>
12954+ <property name="maximum-size"
12955+ writable="1"
12956+ transfer-ownership="none"
12957+ setter="set_maximum_size"
12958+ getter="get_maximum_size"
12959+ default-value="600">
12960+ <doc xml:space="preserve"
12961+ filename="src/adw-clamp-scrollable.c"
12962+ line="274">The maximum size allocated to the child.
12963+
12964+It is the width if the clamp is horizontal, or the height if it is vertical.</doc>
12965+ <type name="gint" c:type="gint"/>
12966+ </property>
12967+ <property name="tightening-threshold"
12968+ writable="1"
12969+ transfer-ownership="none"
12970+ setter="set_tightening_threshold"
12971+ getter="get_tightening_threshold"
12972+ default-value="400">
12973+ <doc xml:space="preserve"
12974+ filename="src/adw-clamp-scrollable.c"
12975+ line="286">The size above which the child is clamped.
12976+
12977+Starting from this size, the clamp will tighten its grip on the child,
12978+slowly allocating less and less of the available size up to the maximum
12979+allocated size. Below that threshold and below the maximum width, the child
12980+will be allocated all the available size.
12981+
12982+If the threshold is greater than the maximum size to allocate to the child,
12983+the child will be allocated all the width up to the maximum.
12984+If the threshold is lower than the minimum size to allocate to the child,
12985+that size will be used as the tightening threshold.
12986+
12987+Effectively, tightening the grip on the child before it reaches its maximum
12988+size makes transitions to and from the maximum size smoother when resizing.</doc>
12989+ <type name="gint" c:type="gint"/>
12990+ </property>
12991+ <property name="unit"
12992+ version="1.4"
12993+ writable="1"
12994+ transfer-ownership="none"
12995+ setter="set_unit"
12996+ getter="get_unit"
12997+ default-value="ADW_LENGTH_UNIT_SP">
12998+ <doc xml:space="preserve"
12999+ filename="src/adw-clamp-scrollable.c"
13000+ line="309">The length unit for maximum size and tightening threshold.
13001+
13002+Allows the sizes to vary depending on the text scale factor.</doc>
13003+ <type name="LengthUnit"/>
13004+ </property>
13005+ </class>
13006+ <record name="ClampScrollableClass"
13007+ c:type="AdwClampScrollableClass"
13008+ glib:is-gtype-struct-for="ClampScrollable">
13009+ <source-position filename="src/adw-clamp-scrollable.h" line="24"/>
13010+ <field name="parent_class">
13011+ <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
13012+ </field>
13013+ </record>
13014+ <enumeration name="ColorScheme"
13015+ glib:type-name="AdwColorScheme"
13016+ glib:get-type="adw_color_scheme_get_type"
13017+ c:type="AdwColorScheme">
13018+ <doc xml:space="preserve"
13019+ filename="src/adw-style-manager.c"
13020+ line="20">Application color schemes for [property@StyleManager:color-scheme].</doc>
13021+ <member name="default"
13022+ value="0"
13023+ c:identifier="ADW_COLOR_SCHEME_DEFAULT"
13024+ glib:nick="default"
13025+ glib:name="ADW_COLOR_SCHEME_DEFAULT">
13026+ <doc xml:space="preserve"
13027+ filename="src/adw-style-manager.c"
13028+ line="22">Inherit the parent color-scheme. When set on the
13029+ `AdwStyleManager` returned by [func@StyleManager.get_default], it's
13030+ equivalent to `ADW_COLOR_SCHEME_PREFER_LIGHT`.</doc>
13031+ </member>
13032+ <member name="force_light"
13033+ value="1"
13034+ c:identifier="ADW_COLOR_SCHEME_FORCE_LIGHT"
13035+ glib:nick="force-light"
13036+ glib:name="ADW_COLOR_SCHEME_FORCE_LIGHT">
13037+ <doc xml:space="preserve"
13038+ filename="src/adw-style-manager.c"
13039+ line="25">Always use light appearance.</doc>
13040+ </member>
13041+ <member name="prefer_light"
13042+ value="2"
13043+ c:identifier="ADW_COLOR_SCHEME_PREFER_LIGHT"
13044+ glib:nick="prefer-light"
13045+ glib:name="ADW_COLOR_SCHEME_PREFER_LIGHT">
13046+ <doc xml:space="preserve"
13047+ filename="src/adw-style-manager.c"
13048+ line="26">Use light appearance unless the system
13049+ prefers dark colors.</doc>
13050+ </member>
13051+ <member name="prefer_dark"
13052+ value="3"
13053+ c:identifier="ADW_COLOR_SCHEME_PREFER_DARK"
13054+ glib:nick="prefer-dark"
13055+ glib:name="ADW_COLOR_SCHEME_PREFER_DARK">
13056+ <doc xml:space="preserve"
13057+ filename="src/adw-style-manager.c"
13058+ line="28">Use dark appearance unless the system prefers
13059+ prefers light colors.</doc>
13060+ </member>
13061+ <member name="force_dark"
13062+ value="4"
13063+ c:identifier="ADW_COLOR_SCHEME_FORCE_DARK"
13064+ glib:nick="force-dark"
13065+ glib:name="ADW_COLOR_SCHEME_FORCE_DARK">
13066+ <doc xml:space="preserve"
13067+ filename="src/adw-style-manager.c"
13068+ line="30">Always use dark appearance.</doc>
13069+ </member>
13070+ </enumeration>
13071+ <class name="ComboRow"
13072+ c:symbol-prefix="combo_row"
13073+ c:type="AdwComboRow"
13074+ parent="ActionRow"
13075+ glib:type-name="AdwComboRow"
13076+ glib:get-type="adw_combo_row_get_type"
13077+ glib:type-struct="ComboRowClass">
13078+ <doc xml:space="preserve"
13079+ filename="src/adw-combo-row.c"
13080+ line="16">A [class@Gtk.ListBoxRow] used to choose from a list of items.
13081+
13082+&lt;picture&gt;
13083+ &lt;source srcset="combo-row-dark.png" media="(prefers-color-scheme: dark)"&gt;
13084+ &lt;img src="combo-row.png" alt="combo-row"&gt;
13085+&lt;/picture&gt;
13086+
13087+The `AdwComboRow` widget allows the user to choose from a list of valid
13088+choices. The row displays the selected choice. When activated, the row
13089+displays a popover which allows the user to make a new choice.
13090+
13091+Example of an `AdwComboRow` UI definition:
13092+```xml
13093+&lt;object class="AdwComboRow"&gt;
13094+ &lt;property name="title" translatable="yes"&gt;Combo Row&lt;/property&gt;
13095+ &lt;property name="model"&gt;
13096+ &lt;object class="GtkStringList"&gt;
13097+ &lt;items&gt;
13098+ &lt;item translatable="yes"&gt;Foo&lt;/item&gt;
13099+ &lt;item translatable="yes"&gt;Bar&lt;/item&gt;
13100+ &lt;item translatable="yes"&gt;Baz&lt;/item&gt;
13101+ &lt;/items&gt;
13102+ &lt;/object&gt;
13103+ &lt;/property&gt;
13104+&lt;/object&gt;
13105+```
13106+
13107+The [property@ComboRow:selected] and [property@ComboRow:selected-item]
13108+properties can be used to keep track of the selected item and react to their
13109+changes.
13110+
13111+`AdwComboRow` mirrors [class@Gtk.DropDown], see that widget for details.
13112+
13113+`AdwComboRow` is [property@Gtk.ListBoxRow:activatable] if a model is set.
13114+
13115+## CSS nodes
13116+
13117+`AdwComboRow` has a main CSS node with name `row` and the `.combo` style
13118+class.
13119+
13120+Its popover has the node named `popover` with the `.menu` style class, it
13121+contains a [class@Gtk.ScrolledWindow], which in turn contains a
13122+[class@Gtk.ListView], both are accessible via their regular nodes.
13123+
13124+## Accessibility
13125+
13126+`AdwComboRow` uses the `GTK_ACCESSIBLE_ROLE_COMBO_BOX` role.</doc>
13127+ <source-position filename="src/adw-combo-row.h" line="35"/>
13128+ <implements name="Gtk.Accessible"/>
13129+ <implements name="Gtk.Actionable"/>
13130+ <implements name="Gtk.Buildable"/>
13131+ <implements name="Gtk.ConstraintTarget"/>
13132+ <constructor name="new" c:identifier="adw_combo_row_new">
13133+ <doc xml:space="preserve"
13134+ filename="src/adw-combo-row.c"
13135+ line="743">Creates a new `AdwComboRow`.</doc>
13136+ <source-position filename="src/adw-combo-row.h" line="38"/>
13137+ <return-value transfer-ownership="none">
13138+ <doc xml:space="preserve"
13139+ filename="src/adw-combo-row.c"
13140+ line="748">the newly created `AdwComboRow`</doc>
13141+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
13142+ </return-value>
13143+ </constructor>
13144+ <method name="get_enable_search"
13145+ c:identifier="adw_combo_row_get_enable_search"
13146+ glib:get-property="enable-search"
13147+ version="1.4">
13148+ <doc xml:space="preserve"
13149+ filename="src/adw-combo-row.c"
13150+ line="1186">Gets whether search is enabled.
13151+
13152+If set to `TRUE`, a search entry will be shown in the popup that
13153+allows to search for items in the list.
13154+
13155+Search requires [property@ComboRow:expression] to be set.</doc>
13156+ <source-position filename="src/adw-combo-row.h" line="86"/>
13157+ <return-value transfer-ownership="none">
13158+ <doc xml:space="preserve"
13159+ filename="src/adw-combo-row.c"
13160+ line="1197">whether the popup includes a search entry</doc>
13161+ <type name="gboolean" c:type="gboolean"/>
13162+ </return-value>
13163+ <parameters>
13164+ <instance-parameter name="self" transfer-ownership="none">
13165+ <doc xml:space="preserve"
13166+ filename="src/adw-combo-row.c"
13167+ line="1188">a combo row</doc>
13168+ <type name="ComboRow" c:type="AdwComboRow*"/>
13169+ </instance-parameter>
13170+ </parameters>
13171+ </method>
13172+ <method name="get_expression"
13173+ c:identifier="adw_combo_row_get_expression"
13174+ glib:get-property="expression">
13175+ <doc xml:space="preserve"
13176+ filename="src/adw-combo-row.c"
13177+ line="1064">Gets the expression used to obtain strings from items.</doc>
13178+ <source-position filename="src/adw-combo-row.h" line="74"/>
13179+ <return-value transfer-ownership="none" nullable="1">
13180+ <doc xml:space="preserve"
13181+ filename="src/adw-combo-row.c"
13182+ line="1070">the expression used to obtain strings from items</doc>
13183+ <type name="Gtk.Expression" c:type="GtkExpression*"/>
13184+ </return-value>
13185+ <parameters>
13186+ <instance-parameter name="self" transfer-ownership="none">
13187+ <doc xml:space="preserve"
13188+ filename="src/adw-combo-row.c"
13189+ line="1066">a combo row</doc>
13190+ <type name="ComboRow" c:type="AdwComboRow*"/>
13191+ </instance-parameter>
13192+ </parameters>
13193+ </method>
13194+ <method name="get_factory"
13195+ c:identifier="adw_combo_row_get_factory"
13196+ glib:get-property="factory">
13197+ <doc xml:space="preserve"
13198+ filename="src/adw-combo-row.c"
13199+ line="923">Gets the factory for populating list items.</doc>
13200+ <source-position filename="src/adw-combo-row.h" line="56"/>
13201+ <return-value transfer-ownership="none" nullable="1">
13202+ <doc xml:space="preserve"
13203+ filename="src/adw-combo-row.c"
13204+ line="929">the factory in use</doc>
13205+ <type name="Gtk.ListItemFactory" c:type="GtkListItemFactory*"/>
13206+ </return-value>
13207+ <parameters>
13208+ <instance-parameter name="self" transfer-ownership="none">
13209+ <doc xml:space="preserve"
13210+ filename="src/adw-combo-row.c"
13211+ line="925">a combo row</doc>
13212+ <type name="ComboRow" c:type="AdwComboRow*"/>
13213+ </instance-parameter>
13214+ </parameters>
13215+ </method>
13216+ <method name="get_header_factory"
13217+ c:identifier="adw_combo_row_get_header_factory"
13218+ glib:get-property="header-factory"
13219+ version="1.6">
13220+ <doc xml:space="preserve"
13221+ filename="src/adw-combo-row.c"
13222+ line="963">Gets the factory that's currently used to create header widgets for the popup.</doc>
13223+ <source-position filename="src/adw-combo-row.h" line="62"/>
13224+ <return-value transfer-ownership="none" nullable="1">
13225+ <doc xml:space="preserve"
13226+ filename="src/adw-combo-row.c"
13227+ line="969">The factory in use</doc>
13228+ <type name="Gtk.ListItemFactory" c:type="GtkListItemFactory*"/>
13229+ </return-value>
13230+ <parameters>
13231+ <instance-parameter name="self" transfer-ownership="none">
13232+ <doc xml:space="preserve"
13233+ filename="src/adw-combo-row.c"
13234+ line="965">a combo row</doc>
13235+ <type name="ComboRow" c:type="AdwComboRow*"/>
13236+ </instance-parameter>
13237+ </parameters>
13238+ </method>
13239+ <method name="get_list_factory"
13240+ c:identifier="adw_combo_row_get_list_factory"
13241+ glib:get-property="list-factory">
13242+ <doc xml:space="preserve"
13243+ filename="src/adw-combo-row.c"
13244+ line="1013">Gets the factory for populating list items in the popup.</doc>
13245+ <source-position filename="src/adw-combo-row.h" line="68"/>
13246+ <return-value transfer-ownership="none" nullable="1">
13247+ <doc xml:space="preserve"
13248+ filename="src/adw-combo-row.c"
13249+ line="1019">the factory in use</doc>
13250+ <type name="Gtk.ListItemFactory" c:type="GtkListItemFactory*"/>
13251+ </return-value>
13252+ <parameters>
13253+ <instance-parameter name="self" transfer-ownership="none">
13254+ <doc xml:space="preserve"
13255+ filename="src/adw-combo-row.c"
13256+ line="1015">a combo row</doc>
13257+ <type name="ComboRow" c:type="AdwComboRow*"/>
13258+ </instance-parameter>
13259+ </parameters>
13260+ </method>
13261+ <method name="get_model"
13262+ c:identifier="adw_combo_row_get_model"
13263+ glib:get-property="model">
13264+ <doc xml:space="preserve"
13265+ filename="src/adw-combo-row.c"
13266+ line="830">Gets the model that provides the displayed items.</doc>
13267+ <source-position filename="src/adw-combo-row.h" line="41"/>
13268+ <return-value transfer-ownership="none" nullable="1">
13269+ <doc xml:space="preserve"
13270+ filename="src/adw-combo-row.c"
13271+ line="836">The model in use</doc>
13272+ <type name="Gio.ListModel" c:type="GListModel*"/>
13273+ </return-value>
13274+ <parameters>
13275+ <instance-parameter name="self" transfer-ownership="none">
13276+ <doc xml:space="preserve"
13277+ filename="src/adw-combo-row.c"
13278+ line="832">a combo row</doc>
13279+ <type name="ComboRow" c:type="AdwComboRow*"/>
13280+ </instance-parameter>
13281+ </parameters>
13282+ </method>
13283+ <method name="get_search_match_mode"
13284+ c:identifier="adw_combo_row_get_search_match_mode"
13285+ glib:get-property="search-match-mode"
13286+ version="1.6">
13287+ <doc xml:space="preserve"
13288+ filename="src/adw-combo-row.c"
13289+ line="1250">Returns the match mode that the search filter is using.</doc>
13290+ <source-position filename="src/adw-combo-row.h" line="95"/>
13291+ <return-value transfer-ownership="none">
13292+ <doc xml:space="preserve"
13293+ filename="src/adw-combo-row.c"
13294+ line="1256">the match mode of the search filter</doc>
13295+ <type name="Gtk.StringFilterMatchMode"
13296+ c:type="GtkStringFilterMatchMode"/>
13297+ </return-value>
13298+ <parameters>
13299+ <instance-parameter name="self" transfer-ownership="none">
13300+ <doc xml:space="preserve"
13301+ filename="src/adw-combo-row.c"
13302+ line="1252">a combo row</doc>
13303+ <type name="ComboRow" c:type="AdwComboRow*"/>
13304+ </instance-parameter>
13305+ </parameters>
13306+ </method>
13307+ <method name="get_selected"
13308+ c:identifier="adw_combo_row_get_selected"
13309+ glib:get-property="selected">
13310+ <doc xml:space="preserve"
13311+ filename="src/adw-combo-row.c"
13312+ line="783">Gets the position of the selected item.</doc>
13313+ <source-position filename="src/adw-combo-row.h" line="47"/>
13314+ <return-value transfer-ownership="none">
13315+ <doc xml:space="preserve"
13316+ filename="src/adw-combo-row.c"
13317+ line="789">the position of the selected item, or
13318+ [const@Gtk.INVALID_LIST_POSITION] if no item is selected</doc>
13319+ <type name="guint" c:type="guint"/>
13320+ </return-value>
13321+ <parameters>
13322+ <instance-parameter name="self" transfer-ownership="none">
13323+ <doc xml:space="preserve"
13324+ filename="src/adw-combo-row.c"
13325+ line="785">a combo row</doc>
13326+ <type name="ComboRow" c:type="AdwComboRow*"/>
13327+ </instance-parameter>
13328+ </parameters>
13329+ </method>
13330+ <method name="get_selected_item"
13331+ c:identifier="adw_combo_row_get_selected_item"
13332+ glib:get-property="selected-item">
13333+ <doc xml:space="preserve"
13334+ filename="src/adw-combo-row.c"
13335+ line="807">Gets the selected item.</doc>
13336+ <source-position filename="src/adw-combo-row.h" line="53"/>
13337+ <return-value transfer-ownership="none" nullable="1">
13338+ <doc xml:space="preserve"
13339+ filename="src/adw-combo-row.c"
13340+ line="813">the selected item</doc>
13341+ <type name="GObject.Object" c:type="gpointer"/>
13342+ </return-value>
13343+ <parameters>
13344+ <instance-parameter name="self" transfer-ownership="none">
13345+ <doc xml:space="preserve"
13346+ filename="src/adw-combo-row.c"
13347+ line="809">a combo row</doc>
13348+ <type name="ComboRow" c:type="AdwComboRow*"/>
13349+ </instance-parameter>
13350+ </parameters>
13351+ </method>
13352+ <method name="get_use_subtitle"
13353+ c:identifier="adw_combo_row_get_use_subtitle"
13354+ glib:get-property="use-subtitle">
13355+ <doc xml:space="preserve"
13356+ filename="src/adw-combo-row.c"
13357+ line="1128">Gets whether to use the current value as the subtitle.</doc>
13358+ <source-position filename="src/adw-combo-row.h" line="80"/>
13359+ <return-value transfer-ownership="none">
13360+ <doc xml:space="preserve"
13361+ filename="src/adw-combo-row.c"
13362+ line="1134">whether to use the current value as the subtitle</doc>
13363+ <type name="gboolean" c:type="gboolean"/>
13364+ </return-value>
13365+ <parameters>
13366+ <instance-parameter name="self" transfer-ownership="none">
13367+ <doc xml:space="preserve"
13368+ filename="src/adw-combo-row.c"
13369+ line="1130">a combo row</doc>
13370+ <type name="ComboRow" c:type="AdwComboRow*"/>
13371+ </instance-parameter>
13372+ </parameters>
13373+ </method>
13374+ <method name="set_enable_search"
13375+ c:identifier="adw_combo_row_set_enable_search"
13376+ glib:set-property="enable-search"
13377+ version="1.4">
13378+ <doc xml:space="preserve"
13379+ filename="src/adw-combo-row.c"
13380+ line="1213">Sets whether to enable search.
13381+
13382+If set to `TRUE`, a search entry will be shown in the popup that
13383+allows to search for items in the list.
13384+
13385+Search requires [property@ComboRow:expression] to be set.</doc>
13386+ <source-position filename="src/adw-combo-row.h" line="88"/>
13387+ <return-value transfer-ownership="none">
13388+ <type name="none" c:type="void"/>
13389+ </return-value>
13390+ <parameters>
13391+ <instance-parameter name="self" transfer-ownership="none">
13392+ <doc xml:space="preserve"
13393+ filename="src/adw-combo-row.c"
13394+ line="1215">a combo row</doc>
13395+ <type name="ComboRow" c:type="AdwComboRow*"/>
13396+ </instance-parameter>
13397+ <parameter name="enable_search" transfer-ownership="none">
13398+ <doc xml:space="preserve"
13399+ filename="src/adw-combo-row.c"
13400+ line="1216">whether to enable search</doc>
13401+ <type name="gboolean" c:type="gboolean"/>
13402+ </parameter>
13403+ </parameters>
13404+ </method>
13405+ <method name="set_expression"
13406+ c:identifier="adw_combo_row_set_expression"
13407+ glib:set-property="expression">
13408+ <doc xml:space="preserve"
13409+ filename="src/adw-combo-row.c"
13410+ line="1084">Sets the expression used to obtain strings from items.
13411+
13412+The expression must have a value type of `G_TYPE_STRING`.
13413+
13414+It's used to bind strings to labels produced by the default factory if
13415+[property@ComboRow:factory] is not set, or when
13416+[property@ComboRow:use-subtitle] is set to `TRUE`.</doc>
13417+ <source-position filename="src/adw-combo-row.h" line="76"/>
13418+ <return-value transfer-ownership="none">
13419+ <type name="none" c:type="void"/>
13420+ </return-value>
13421+ <parameters>
13422+ <instance-parameter name="self" transfer-ownership="none">
13423+ <doc xml:space="preserve"
13424+ filename="src/adw-combo-row.c"
13425+ line="1086">a combo row</doc>
13426+ <type name="ComboRow" c:type="AdwComboRow*"/>
13427+ </instance-parameter>
13428+ <parameter name="expression"
13429+ transfer-ownership="none"
13430+ nullable="1"
13431+ allow-none="1">
13432+ <doc xml:space="preserve"
13433+ filename="src/adw-combo-row.c"
13434+ line="1087">an expression</doc>
13435+ <type name="Gtk.Expression" c:type="GtkExpression*"/>
13436+ </parameter>
13437+ </parameters>
13438+ </method>
13439+ <method name="set_factory"
13440+ c:identifier="adw_combo_row_set_factory"
13441+ glib:set-property="factory">
13442+ <doc xml:space="preserve"
13443+ filename="src/adw-combo-row.c"
13444+ line="943">Sets the factory for populating list items.
13445+
13446+This factory is always used for the item in the row. It is also used for
13447+items in the popup unless [property@ComboRow:list-factory] is set.</doc>
13448+ <source-position filename="src/adw-combo-row.h" line="58"/>
13449+ <return-value transfer-ownership="none">
13450+ <type name="none" c:type="void"/>
13451+ </return-value>
13452+ <parameters>
13453+ <instance-parameter name="self" transfer-ownership="none">
13454+ <doc xml:space="preserve"
13455+ filename="src/adw-combo-row.c"
13456+ line="945">a combo row</doc>
13457+ <type name="ComboRow" c:type="AdwComboRow*"/>
13458+ </instance-parameter>
13459+ <parameter name="factory"
13460+ transfer-ownership="none"
13461+ nullable="1"
13462+ allow-none="1">
13463+ <doc xml:space="preserve"
13464+ filename="src/adw-combo-row.c"
13465+ line="946">the factory to use</doc>
13466+ <type name="Gtk.ListItemFactory" c:type="GtkListItemFactory*"/>
13467+ </parameter>
13468+ </parameters>
13469+ </method>
13470+ <method name="set_header_factory"
13471+ c:identifier="adw_combo_row_set_header_factory"
13472+ glib:set-property="header-factory"
13473+ version="1.6">
13474+ <doc xml:space="preserve"
13475+ filename="src/adw-combo-row.c"
13476+ line="985">Sets the factory to use for creating header widgets for the popup.</doc>
13477+ <source-position filename="src/adw-combo-row.h" line="64"/>
13478+ <return-value transfer-ownership="none">
13479+ <type name="none" c:type="void"/>
13480+ </return-value>
13481+ <parameters>
13482+ <instance-parameter name="self" transfer-ownership="none">
13483+ <doc xml:space="preserve"
13484+ filename="src/adw-combo-row.c"
13485+ line="987">a combo row</doc>
13486+ <type name="ComboRow" c:type="AdwComboRow*"/>
13487+ </instance-parameter>
13488+ <parameter name="factory"
13489+ transfer-ownership="none"
13490+ nullable="1"
13491+ allow-none="1">
13492+ <doc xml:space="preserve"
13493+ filename="src/adw-combo-row.c"
13494+ line="988">the factory to use</doc>
13495+ <type name="Gtk.ListItemFactory" c:type="GtkListItemFactory*"/>
13496+ </parameter>
13497+ </parameters>
13498+ </method>
13499+ <method name="set_list_factory"
13500+ c:identifier="adw_combo_row_set_list_factory"
13501+ glib:set-property="list-factory">
13502+ <doc xml:space="preserve"
13503+ filename="src/adw-combo-row.c"
13504+ line="1033">Sets the factory for populating list items in the popup.
13505+
13506+If this is not set, [property@ComboRow:factory] is used.</doc>
13507+ <source-position filename="src/adw-combo-row.h" line="70"/>
13508+ <return-value transfer-ownership="none">
13509+ <type name="none" c:type="void"/>
13510+ </return-value>
13511+ <parameters>
13512+ <instance-parameter name="self" transfer-ownership="none">
13513+ <doc xml:space="preserve"
13514+ filename="src/adw-combo-row.c"
13515+ line="1035">a combo row</doc>
13516+ <type name="ComboRow" c:type="AdwComboRow*"/>
13517+ </instance-parameter>
13518+ <parameter name="factory"
13519+ transfer-ownership="none"
13520+ nullable="1"
13521+ allow-none="1">
13522+ <doc xml:space="preserve"
13523+ filename="src/adw-combo-row.c"
13524+ line="1036">the factory to use</doc>
13525+ <type name="Gtk.ListItemFactory" c:type="GtkListItemFactory*"/>
13526+ </parameter>
13527+ </parameters>
13528+ </method>
13529+ <method name="set_model"
13530+ c:identifier="adw_combo_row_set_model"
13531+ glib:set-property="model">
13532+ <doc xml:space="preserve"
13533+ filename="src/adw-combo-row.c"
13534+ line="850">Sets the model that provides the displayed items.</doc>
13535+ <source-position filename="src/adw-combo-row.h" line="43"/>
13536+ <return-value transfer-ownership="none">
13537+ <type name="none" c:type="void"/>
13538+ </return-value>
13539+ <parameters>
13540+ <instance-parameter name="self" transfer-ownership="none">
13541+ <doc xml:space="preserve"
13542+ filename="src/adw-combo-row.c"
13543+ line="852">a combo row</doc>
13544+ <type name="ComboRow" c:type="AdwComboRow*"/>
13545+ </instance-parameter>
13546+ <parameter name="model"
13547+ transfer-ownership="none"
13548+ nullable="1"
13549+ allow-none="1">
13550+ <doc xml:space="preserve"
13551+ filename="src/adw-combo-row.c"
13552+ line="853">the model to use</doc>
13553+ <type name="Gio.ListModel" c:type="GListModel*"/>
13554+ </parameter>
13555+ </parameters>
13556+ </method>
13557+ <method name="set_search_match_mode"
13558+ c:identifier="adw_combo_row_set_search_match_mode"
13559+ glib:set-property="search-match-mode"
13560+ version="1.6">
13561+ <doc xml:space="preserve"
13562+ filename="src/adw-combo-row.c"
13563+ line="1272">Sets the match mode for the search filter.</doc>
13564+ <source-position filename="src/adw-combo-row.h" line="92"/>
13565+ <return-value transfer-ownership="none">
13566+ <type name="none" c:type="void"/>
13567+ </return-value>
13568+ <parameters>
13569+ <instance-parameter name="self" transfer-ownership="none">
13570+ <doc xml:space="preserve"
13571+ filename="src/adw-combo-row.c"
13572+ line="1274">a combo row</doc>
13573+ <type name="ComboRow" c:type="AdwComboRow*"/>
13574+ </instance-parameter>
13575+ <parameter name="search_match_mode" transfer-ownership="none">
13576+ <doc xml:space="preserve"
13577+ filename="src/adw-combo-row.c"
13578+ line="1275">the new match mode</doc>
13579+ <type name="Gtk.StringFilterMatchMode"
13580+ c:type="GtkStringFilterMatchMode"/>
13581+ </parameter>
13582+ </parameters>
13583+ </method>
13584+ <method name="set_selected"
13585+ c:identifier="adw_combo_row_set_selected"
13586+ glib:set-property="selected">
13587+ <doc xml:space="preserve"
13588+ filename="src/adw-combo-row.c"
13589+ line="756">Selects the item at the given position.</doc>
13590+ <source-position filename="src/adw-combo-row.h" line="49"/>
13591+ <return-value transfer-ownership="none">
13592+ <type name="none" c:type="void"/>
13593+ </return-value>
13594+ <parameters>
13595+ <instance-parameter name="self" transfer-ownership="none">
13596+ <doc xml:space="preserve"
13597+ filename="src/adw-combo-row.c"
13598+ line="758">a combo row</doc>
13599+ <type name="ComboRow" c:type="AdwComboRow*"/>
13600+ </instance-parameter>
13601+ <parameter name="position" transfer-ownership="none">
13602+ <doc xml:space="preserve"
13603+ filename="src/adw-combo-row.c"
13604+ line="759">the position of the item to select, or
13605+ [const@Gtk.INVALID_LIST_POSITION]</doc>
13606+ <type name="guint" c:type="guint"/>
13607+ </parameter>
13608+ </parameters>
13609+ </method>
13610+ <method name="set_use_subtitle"
13611+ c:identifier="adw_combo_row_set_use_subtitle"
13612+ glib:set-property="use-subtitle">
13613+ <doc xml:space="preserve"
13614+ filename="src/adw-combo-row.c"
13615+ line="1148">Sets whether to use the current value as the subtitle.
13616+
13617+If you use a custom list item factory, you will need to give the row a
13618+name conversion expression with [property@ComboRow:expression].
13619+
13620+If set to `TRUE`, you should not access [property@ActionRow:subtitle].
13621+
13622+The subtitle is interpreted as Pango markup if
13623+[property@PreferencesRow:use-markup] is set to `TRUE`.</doc>
13624+ <source-position filename="src/adw-combo-row.h" line="82"/>
13625+ <return-value transfer-ownership="none">
13626+ <type name="none" c:type="void"/>
13627+ </return-value>
13628+ <parameters>
13629+ <instance-parameter name="self" transfer-ownership="none">
13630+ <doc xml:space="preserve"
13631+ filename="src/adw-combo-row.c"
13632+ line="1150">a combo row</doc>
13633+ <type name="ComboRow" c:type="AdwComboRow*"/>
13634+ </instance-parameter>
13635+ <parameter name="use_subtitle" transfer-ownership="none">
13636+ <doc xml:space="preserve"
13637+ filename="src/adw-combo-row.c"
13638+ line="1151">whether to use the current value as the subtitle</doc>
13639+ <type name="gboolean" c:type="gboolean"/>
13640+ </parameter>
13641+ </parameters>
13642+ </method>
13643+ <property name="enable-search"
13644+ version="1.4"
13645+ writable="1"
13646+ transfer-ownership="none"
13647+ setter="set_enable_search"
13648+ getter="get_enable_search"
13649+ default-value="FALSE">
13650+ <doc xml:space="preserve"
13651+ filename="src/adw-combo-row.c"
13652+ line="682">Whether to show a search entry in the popup.
13653+
13654+If set to `TRUE`, a search entry will be shown in the popup that
13655+allows to search for items in the list.
13656+
13657+Search requires [property@ComboRow:expression] to be set.</doc>
13658+ <type name="gboolean" c:type="gboolean"/>
13659+ </property>
13660+ <property name="expression"
13661+ writable="1"
13662+ transfer-ownership="none"
13663+ setter="set_expression"
13664+ getter="get_expression">
13665+ <doc xml:space="preserve"
13666+ filename="src/adw-combo-row.c"
13667+ line="647">An expression used to obtain strings from items.
13668+
13669+The expression must have a value type of `G_TYPE_STRING`.
13670+
13671+It's used to bind strings to labels produced by the default factory if
13672+[property@ComboRow:factory] is not set, or when
13673+[property@ComboRow:use-subtitle] is set to `TRUE`.</doc>
13674+ <type name="Gtk.Expression"/>
13675+ </property>
13676+ <property name="factory"
13677+ writable="1"
13678+ transfer-ownership="none"
13679+ setter="set_factory"
13680+ getter="get_factory">
13681+ <doc xml:space="preserve"
13682+ filename="src/adw-combo-row.c"
13683+ line="610">Factory for populating list items.
13684+
13685+This factory is always used for the item in the row. It is also used for
13686+items in the popup unless [property@ComboRow:list-factory] is set.</doc>
13687+ <type name="Gtk.ListItemFactory"/>
13688+ </property>
13689+ <property name="header-factory"
13690+ version="1.6"
13691+ writable="1"
13692+ transfer-ownership="none"
13693+ setter="set_header_factory"
13694+ getter="get_header_factory">
13695+ <doc xml:space="preserve"
13696+ filename="src/adw-combo-row.c"
13697+ line="623">The factory for creating header widgets for the popup.</doc>
13698+ <type name="Gtk.ListItemFactory"/>
13699+ </property>
13700+ <property name="list-factory"
13701+ writable="1"
13702+ transfer-ownership="none"
13703+ setter="set_list_factory"
13704+ getter="get_list_factory">
13705+ <doc xml:space="preserve"
13706+ filename="src/adw-combo-row.c"
13707+ line="635">The factory for populating list items in the popup.
13708+
13709+If this is not set, [property@ComboRow:factory] is used.</doc>
13710+ <type name="Gtk.ListItemFactory"/>
13711+ </property>
13712+ <property name="model"
13713+ writable="1"
13714+ transfer-ownership="none"
13715+ setter="set_model"
13716+ getter="get_model">
13717+ <doc xml:space="preserve"
13718+ filename="src/adw-combo-row.c"
13719+ line="600">The model that provides the displayed items.</doc>
13720+ <type name="Gio.ListModel"/>
13721+ </property>
13722+ <property name="search-match-mode"
13723+ version="1.6"
13724+ writable="1"
13725+ transfer-ownership="none"
13726+ setter="set_search_match_mode"
13727+ getter="get_search_match_mode"
13728+ default-value="GTK_STRING_FILTER_MATCH_MODE_PREFIX">
13729+ <doc xml:space="preserve"
13730+ filename="src/adw-combo-row.c"
13731+ line="699">The match mode for the search filter.</doc>
13732+ <type name="Gtk.StringFilterMatchMode"/>
13733+ </property>
13734+ <property name="selected"
13735+ writable="1"
13736+ transfer-ownership="none"
13737+ setter="set_selected"
13738+ getter="get_selected"
13739+ default-value="4294967295">
13740+ <doc xml:space="preserve"
13741+ filename="src/adw-combo-row.c"
13742+ line="577">The position of the selected item.
13743+
13744+If no item is selected, the property has the value
13745+[const@Gtk.INVALID_LIST_POSITION]</doc>
13746+ <type name="guint" c:type="guint"/>
13747+ </property>
13748+ <property name="selected-item"
13749+ transfer-ownership="none"
13750+ getter="get_selected_item">
13751+ <doc xml:space="preserve"
13752+ filename="src/adw-combo-row.c"
13753+ line="590">The selected item.</doc>
13754+ <type name="GObject.Object"/>
13755+ </property>
13756+ <property name="use-subtitle"
13757+ writable="1"
13758+ transfer-ownership="none"
13759+ setter="set_use_subtitle"
13760+ getter="get_use_subtitle"
13761+ default-value="FALSE">
13762+ <doc xml:space="preserve"
13763+ filename="src/adw-combo-row.c"
13764+ line="664">Whether to use the current value as the subtitle.
13765+
13766+If you use a custom list item factory, you will need to give the row a
13767+name conversion expression with [property@ComboRow:expression].
13768+
13769+If set to `TRUE`, you should not access [property@ActionRow:subtitle].
13770+
13771+The subtitle is interpreted as Pango markup if
13772+[property@PreferencesRow:use-markup] is set to `TRUE`.</doc>
13773+ <type name="gboolean" c:type="gboolean"/>
13774+ </property>
13775+ <field name="parent_instance">
13776+ <type name="ActionRow" c:type="AdwActionRow"/>
13777+ </field>
13778+ </class>
13779+ <record name="ComboRowClass"
13780+ c:type="AdwComboRowClass"
13781+ glib:is-gtype-struct-for="ComboRow">
13782+ <source-position filename="src/adw-combo-row.h" line="35"/>
13783+ <field name="parent_class">
13784+ <doc xml:space="preserve"
13785+ filename="src/adw-combo-row.h"
13786+ line="27">The parent class</doc>
13787+ <type name="ActionRowClass" c:type="AdwActionRowClass"/>
13788+ </field>
13789+ <field name="padding" readable="0" private="1">
13790+ <array zero-terminated="0" fixed-size="4">
13791+ <type name="gpointer" c:type="gpointer"/>
13792+ </array>
13793+ </field>
13794+ </record>
13795+ <function-macro name="DEPRECATED_IN_1_1_FOR"
13796+ c:identifier="ADW_DEPRECATED_IN_1_1_FOR"
13797+ introspectable="0">
13798+ <source-position filename="src/adw-version.h" line="171"/>
13799+ <parameters>
13800+ <parameter name="f">
13801+ </parameter>
13802+ </parameters>
13803+ </function-macro>
13804+ <function-macro name="DEPRECATED_IN_1_2_FOR"
13805+ c:identifier="ADW_DEPRECATED_IN_1_2_FOR"
13806+ introspectable="0">
13807+ <source-position filename="src/adw-version.h" line="189"/>
13808+ <parameters>
13809+ <parameter name="f">
13810+ </parameter>
13811+ </parameters>
13812+ </function-macro>
13813+ <function-macro name="DEPRECATED_IN_1_3_FOR"
13814+ c:identifier="ADW_DEPRECATED_IN_1_3_FOR"
13815+ introspectable="0">
13816+ <source-position filename="src/adw-version.h" line="207"/>
13817+ <parameters>
13818+ <parameter name="f">
13819+ </parameter>
13820+ </parameters>
13821+ </function-macro>
13822+ <function-macro name="DEPRECATED_IN_1_4_FOR"
13823+ c:identifier="ADW_DEPRECATED_IN_1_4_FOR"
13824+ introspectable="0">
13825+ <source-position filename="src/adw-version.h" line="225"/>
13826+ <parameters>
13827+ <parameter name="f">
13828+ </parameter>
13829+ </parameters>
13830+ </function-macro>
13831+ <function-macro name="DEPRECATED_IN_1_5_FOR"
13832+ c:identifier="ADW_DEPRECATED_IN_1_5_FOR"
13833+ introspectable="0">
13834+ <source-position filename="src/adw-version.h" line="243"/>
13835+ <parameters>
13836+ <parameter name="f">
13837+ </parameter>
13838+ </parameters>
13839+ </function-macro>
13840+ <function-macro name="DEPRECATED_IN_1_6_FOR"
13841+ c:identifier="ADW_DEPRECATED_IN_1_6_FOR"
13842+ introspectable="0">
13843+ <source-position filename="src/adw-version.h" line="261"/>
13844+ <parameters>
13845+ <parameter name="f">
13846+ </parameter>
13847+ </parameters>
13848+ </function-macro>
13849+ <function-macro name="DEPRECATED_TYPE_IN_1_1_FOR"
13850+ c:identifier="ADW_DEPRECATED_TYPE_IN_1_1_FOR"
13851+ introspectable="0">
13852+ <source-position filename="src/adw-version.h" line="173"/>
13853+ <parameters>
13854+ <parameter name="f">
13855+ </parameter>
13856+ </parameters>
13857+ </function-macro>
13858+ <function-macro name="DEPRECATED_TYPE_IN_1_2_FOR"
13859+ c:identifier="ADW_DEPRECATED_TYPE_IN_1_2_FOR"
13860+ introspectable="0">
13861+ <source-position filename="src/adw-version.h" line="191"/>
13862+ <parameters>
13863+ <parameter name="f">
13864+ </parameter>
13865+ </parameters>
13866+ </function-macro>
13867+ <function-macro name="DEPRECATED_TYPE_IN_1_3_FOR"
13868+ c:identifier="ADW_DEPRECATED_TYPE_IN_1_3_FOR"
13869+ introspectable="0">
13870+ <source-position filename="src/adw-version.h" line="209"/>
13871+ <parameters>
13872+ <parameter name="f">
13873+ </parameter>
13874+ </parameters>
13875+ </function-macro>
13876+ <function-macro name="DEPRECATED_TYPE_IN_1_4_FOR"
13877+ c:identifier="ADW_DEPRECATED_TYPE_IN_1_4_FOR"
13878+ introspectable="0">
13879+ <source-position filename="src/adw-version.h" line="227"/>
13880+ <parameters>
13881+ <parameter name="f">
13882+ </parameter>
13883+ </parameters>
13884+ </function-macro>
13885+ <function-macro name="DEPRECATED_TYPE_IN_1_5_FOR"
13886+ c:identifier="ADW_DEPRECATED_TYPE_IN_1_5_FOR"
13887+ introspectable="0">
13888+ <source-position filename="src/adw-version.h" line="245"/>
13889+ <parameters>
13890+ <parameter name="f">
13891+ </parameter>
13892+ </parameters>
13893+ </function-macro>
13894+ <function-macro name="DEPRECATED_TYPE_IN_1_6_FOR"
13895+ c:identifier="ADW_DEPRECATED_TYPE_IN_1_6_FOR"
13896+ introspectable="0">
13897+ <source-position filename="src/adw-version.h" line="263"/>
13898+ <parameters>
13899+ <parameter name="f">
13900+ </parameter>
13901+ </parameters>
13902+ </function-macro>
13903+ <constant name="DURATION_INFINITE"
13904+ value="4294967295"
13905+ c:type="ADW_DURATION_INFINITE">
13906+ <doc xml:space="preserve"
13907+ filename="src/adw-animation.h"
13908+ line="23">Indicates an [class@Animation] with an infinite duration.
13909+
13910+This value is mostly used internally.</doc>
13911+ <source-position filename="src/adw-animation.h" line="31"/>
13912+ <type name="guint" c:type="guint"/>
13913+ </constant>
13914+ <class name="Dialog"
13915+ c:symbol-prefix="dialog"
13916+ c:type="AdwDialog"
13917+ version="1.5"
13918+ parent="Gtk.Widget"
13919+ glib:type-name="AdwDialog"
13920+ glib:get-type="adw_dialog_get_type"
13921+ glib:type-struct="DialogClass">
13922+ <doc xml:space="preserve"
13923+ filename="src/adw-dialog.c"
13924+ line="42">An adaptive dialog container.
13925+
13926+&lt;picture&gt;
13927+ &lt;source srcset="dialog-floating-dark.png" media="(prefers-color-scheme: dark)"&gt;
13928+ &lt;img src="dialog-floating.png" alt="dialog-floating"&gt;
13929+&lt;/picture&gt;
13930+&lt;picture&gt;
13931+ &lt;source srcset="dialog-bottom-dark.png" media="(prefers-color-scheme: dark)"&gt;
13932+ &lt;img src="dialog-bottom.png" alt="dialog-bottom"&gt;
13933+&lt;/picture&gt;
13934+
13935+`AdwDialog` is similar to a window, but is shown within another window. It
13936+can be used with [class@Window] and [class@ApplicationWindow], use
13937+[method@Dialog.present] to show it.
13938+
13939+`AdwDialog` is not resizable. Use the [property@Dialog:content-width] and
13940+[property@Dialog:content-height] properties to set its size, or set
13941+[property@Dialog:follows-content-size] to `TRUE` to make the dialog track the
13942+content's size as it changes. `AdwDialog` can never be larger than its parent
13943+window.
13944+
13945+`AdwDialog` can be presented as a centered floating window or a bottom sheet.
13946+By default it's automatic depending on the available size.
13947+[property@Dialog:presentation-mode] can be used to change that.
13948+
13949+`AdwDialog` can be closed via [method@Dialog.close].
13950+
13951+When presented as a bottom sheet, `AdwDialog` can also be closed via swiping
13952+it down.
13953+
13954+The [property@Dialog:can-close] can be used to prevent closing. In that case,
13955+[signal@Dialog::close-attempt] gets emitted instead.
13956+
13957+Use [method@Dialog.force_close] to close the dialog even when `can-close` is set to
13958+`FALSE`.
13959+
13960+`AdwDialog` is transient and doesn't integrate with the window below it, for
13961+example it's not possible to collapse it into a bottom bar. See
13962+[class@BottomSheet] for persistent and more tightly integrated bottom sheets.
13963+
13964+## Header Bar Integration
13965+
13966+When placed inside an `AdwDialog`, [class@HeaderBar] will display the dialog
13967+title instead of window title. It will also adjust the decoration layout to
13968+ensure it always has a close button and nothing else. Set
13969+[property@HeaderBar:show-start-title-buttons] and
13970+[property@HeaderBar:show-end-title-buttons] to `FALSE` to remove it if it's
13971+unwanted.
13972+
13973+## Breakpoints
13974+
13975+`AdwDialog` can be used with [class@Breakpoint] the same way as
13976+[class@BreakpointBin]. Refer to that widget's documentation for details.
13977+
13978+Like `AdwBreakpointBin`, if breakpoints are used, `AdwDialog` doesn't have a
13979+minimum size, and [property@Gtk.Widget:width-request] and
13980+[property@Gtk.Widget:height-request] properties must be set manually.</doc>
13981+ <source-position filename="src/adw-dialog.h" line="44"/>
13982+ <implements name="Gtk.Accessible"/>
13983+ <implements name="Gtk.Buildable"/>
13984+ <implements name="Gtk.ConstraintTarget"/>
13985+ <constructor name="new" c:identifier="adw_dialog_new" version="1.5">
13986+ <doc xml:space="preserve"
13987+ filename="src/adw-dialog.c"
13988+ line="1308">Creates a new `AdwDialog`.</doc>
13989+ <source-position filename="src/adw-dialog.h" line="47"/>
13990+ <return-value transfer-ownership="none">
13991+ <doc xml:space="preserve"
13992+ filename="src/adw-dialog.c"
13993+ line="1313">the new created `AdwDialog`</doc>
13994+ <type name="Dialog" c:type="AdwDialog*"/>
13995+ </return-value>
13996+ </constructor>
13997+ <virtual-method name="close_attempt">
13998+ <source-position filename="src/adw-dialog.h" line="39"/>
13999+ <return-value transfer-ownership="none">
14000+ <type name="none" c:type="void"/>
14001+ </return-value>
14002+ <parameters>
14003+ <instance-parameter name="dialog" transfer-ownership="none">
14004+ <type name="Dialog" c:type="AdwDialog*"/>
14005+ </instance-parameter>
14006+ </parameters>
14007+ </virtual-method>
14008+ <virtual-method name="closed">
14009+ <source-position filename="src/adw-dialog.h" line="40"/>
14010+ <return-value transfer-ownership="none">
14011+ <type name="none" c:type="void"/>
14012+ </return-value>
14013+ <parameters>
14014+ <instance-parameter name="dialog" transfer-ownership="none">
14015+ <type name="Dialog" c:type="AdwDialog*"/>
14016+ </instance-parameter>
14017+ </parameters>
14018+ </virtual-method>
14019+ <method name="add_breakpoint"
14020+ c:identifier="adw_dialog_add_breakpoint"
14021+ version="1.5">
14022+ <doc xml:space="preserve"
14023+ filename="src/adw-dialog.c"
14024+ line="1952">Adds @breakpoint to @self.</doc>
14025+ <source-position filename="src/adw-dialog.h" line="110"/>
14026+ <return-value transfer-ownership="none">
14027+ <type name="none" c:type="void"/>
14028+ </return-value>
14029+ <parameters>
14030+ <instance-parameter name="self" transfer-ownership="none">
14031+ <doc xml:space="preserve"
14032+ filename="src/adw-dialog.c"
14033+ line="1954">a dialog</doc>
14034+ <type name="Dialog" c:type="AdwDialog*"/>
14035+ </instance-parameter>
14036+ <parameter name="breakpoint" transfer-ownership="full">
14037+ <doc xml:space="preserve"
14038+ filename="src/adw-dialog.c"
14039+ line="1955">the breakpoint to add</doc>
14040+ <type name="Breakpoint" c:type="AdwBreakpoint*"/>
14041+ </parameter>
14042+ </parameters>
14043+ </method>
14044+ <method name="close" c:identifier="adw_dialog_close" version="1.5">
14045+ <doc xml:space="preserve"
14046+ filename="src/adw-dialog.c"
14047+ line="1867">Attempts to close @self.
14048+
14049+If the [property@Dialog:can-close] property is set to `FALSE`, the
14050+[signal@Dialog::close-attempt] signal is emitted.
14051+
14052+See also: [method@Dialog.force_close].</doc>
14053+ <source-position filename="src/adw-dialog.h" line="104"/>
14054+ <return-value transfer-ownership="none">
14055+ <doc xml:space="preserve"
14056+ filename="src/adw-dialog.c"
14057+ line="1878">whether @self was successfully closed</doc>
14058+ <type name="gboolean" c:type="gboolean"/>
14059+ </return-value>
14060+ <parameters>
14061+ <instance-parameter name="self" transfer-ownership="none">
14062+ <doc xml:space="preserve"
14063+ filename="src/adw-dialog.c"
14064+ line="1869">a dialog</doc>
14065+ <type name="Dialog" c:type="AdwDialog*"/>
14066+ </instance-parameter>
14067+ </parameters>
14068+ </method>
14069+ <method name="force_close"
14070+ c:identifier="adw_dialog_force_close"
14071+ version="1.5">
14072+ <doc xml:space="preserve"
14073+ filename="src/adw-dialog.c"
14074+ line="1918">Closes @self.
14075+
14076+Unlike [method@Dialog.close], it succeeds even if [property@Dialog:can-close]
14077+is set to `FALSE`.</doc>
14078+ <source-position filename="src/adw-dialog.h" line="107"/>
14079+ <return-value transfer-ownership="none">
14080+ <type name="none" c:type="void"/>
14081+ </return-value>
14082+ <parameters>
14083+ <instance-parameter name="self" transfer-ownership="none">
14084+ <doc xml:space="preserve"
14085+ filename="src/adw-dialog.c"
14086+ line="1920">a dialog</doc>
14087+ <type name="Dialog" c:type="AdwDialog*"/>
14088+ </instance-parameter>
14089+ </parameters>
14090+ </method>
14091+ <method name="get_can_close"
14092+ c:identifier="adw_dialog_get_can_close"
14093+ glib:get-property="can-close"
14094+ version="1.5">
14095+ <doc xml:space="preserve"
14096+ filename="src/adw-dialog.c"
14097+ line="1429">Gets whether @self can be closed.</doc>
14098+ <source-position filename="src/adw-dialog.h" line="62"/>
14099+ <return-value transfer-ownership="none">
14100+ <doc xml:space="preserve"
14101+ filename="src/adw-dialog.c"
14102+ line="1435">whether the dialog can be closed</doc>
14103+ <type name="gboolean" c:type="gboolean"/>
14104+ </return-value>
14105+ <parameters>
14106+ <instance-parameter name="self" transfer-ownership="none">
14107+ <doc xml:space="preserve"
14108+ filename="src/adw-dialog.c"
14109+ line="1431">a dialog</doc>
14110+ <type name="Dialog" c:type="AdwDialog*"/>
14111+ </instance-parameter>
14112+ </parameters>
14113+ </method>
14114+ <method name="get_child"
14115+ c:identifier="adw_dialog_get_child"
14116+ glib:get-property="child"
14117+ version="1.5">
14118+ <doc xml:space="preserve"
14119+ filename="src/adw-dialog.c"
14120+ line="1323">Gets the child widget of @self.</doc>
14121+ <source-position filename="src/adw-dialog.h" line="50"/>
14122+ <return-value transfer-ownership="none" nullable="1">
14123+ <doc xml:space="preserve"
14124+ filename="src/adw-dialog.c"
14125+ line="1329">the child widget of @self</doc>
14126+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
14127+ </return-value>
14128+ <parameters>
14129+ <instance-parameter name="self" transfer-ownership="none">
14130+ <doc xml:space="preserve"
14131+ filename="src/adw-dialog.c"
14132+ line="1325">a dialog</doc>
14133+ <type name="Dialog" c:type="AdwDialog*"/>
14134+ </instance-parameter>
14135+ </parameters>
14136+ </method>
14137+ <method name="get_content_height"
14138+ c:identifier="adw_dialog_get_content_height"
14139+ glib:get-property="content-height"
14140+ version="1.5">
14141+ <doc xml:space="preserve"
14142+ filename="src/adw-dialog.c"
14143+ line="1541">Gets the height of the dialog's contents.</doc>
14144+ <source-position filename="src/adw-dialog.h" line="74"/>
14145+ <return-value transfer-ownership="none">
14146+ <doc xml:space="preserve"
14147+ filename="src/adw-dialog.c"
14148+ line="1547">the content height</doc>
14149+ <type name="gint" c:type="int"/>
14150+ </return-value>
14151+ <parameters>
14152+ <instance-parameter name="self" transfer-ownership="none">
14153+ <doc xml:space="preserve"
14154+ filename="src/adw-dialog.c"
14155+ line="1543">a dialog</doc>
14156+ <type name="Dialog" c:type="AdwDialog*"/>
14157+ </instance-parameter>
14158+ </parameters>
14159+ </method>
14160+ <method name="get_content_width"
14161+ c:identifier="adw_dialog_get_content_width"
14162+ glib:get-property="content-width"
14163+ version="1.5">
14164+ <doc xml:space="preserve"
14165+ filename="src/adw-dialog.c"
14166+ line="1491">Gets the width of the dialog's contents.</doc>
14167+ <source-position filename="src/adw-dialog.h" line="68"/>
14168+ <return-value transfer-ownership="none">
14169+ <doc xml:space="preserve"
14170+ filename="src/adw-dialog.c"
14171+ line="1497">the content width</doc>
14172+ <type name="gint" c:type="int"/>
14173+ </return-value>
14174+ <parameters>
14175+ <instance-parameter name="self" transfer-ownership="none">
14176+ <doc xml:space="preserve"
14177+ filename="src/adw-dialog.c"
14178+ line="1493">a dialog</doc>
14179+ <type name="Dialog" c:type="AdwDialog*"/>
14180+ </instance-parameter>
14181+ </parameters>
14182+ </method>
14183+ <method name="get_current_breakpoint"
14184+ c:identifier="adw_dialog_get_current_breakpoint"
14185+ glib:get-property="current-breakpoint"
14186+ version="1.5">
14187+ <doc xml:space="preserve"
14188+ filename="src/adw-dialog.c"
14189+ line="1977">Gets the current breakpoint.</doc>
14190+ <source-position filename="src/adw-dialog.h" line="114"/>
14191+ <return-value transfer-ownership="none" nullable="1">
14192+ <doc xml:space="preserve"
14193+ filename="src/adw-dialog.c"
14194+ line="1983">the current breakpoint</doc>
14195+ <type name="Breakpoint" c:type="AdwBreakpoint*"/>
14196+ </return-value>
14197+ <parameters>
14198+ <instance-parameter name="self" transfer-ownership="none">
14199+ <doc xml:space="preserve"
14200+ filename="src/adw-dialog.c"
14201+ line="1979">a dialog</doc>
14202+ <type name="Dialog" c:type="AdwDialog*"/>
14203+ </instance-parameter>
14204+ </parameters>
14205+ </method>
14206+ <method name="get_default_widget"
14207+ c:identifier="adw_dialog_get_default_widget"
14208+ glib:get-property="default-widget"
14209+ version="1.5">
14210+ <doc xml:space="preserve"
14211+ filename="src/adw-dialog.c"
14212+ line="1785">Gets the default widget for @self.</doc>
14213+ <source-position filename="src/adw-dialog.h" line="98"/>
14214+ <return-value transfer-ownership="none" nullable="1">
14215+ <doc xml:space="preserve"
14216+ filename="src/adw-dialog.c"
14217+ line="1791">the default widget</doc>
14218+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
14219+ </return-value>
14220+ <parameters>
14221+ <instance-parameter name="self" transfer-ownership="none">
14222+ <doc xml:space="preserve"
14223+ filename="src/adw-dialog.c"
14224+ line="1787">a dialog</doc>
14225+ <type name="Dialog" c:type="AdwDialog*"/>
14226+ </instance-parameter>
14227+ </parameters>
14228+ </method>
14229+ <method name="get_focus"
14230+ c:identifier="adw_dialog_get_focus"
14231+ glib:get-property="focus-widget"
14232+ version="1.5">
14233+ <doc xml:space="preserve"
14234+ filename="src/adw-dialog.c"
14235+ line="1713">Gets the focus widget for @self.</doc>
14236+ <source-position filename="src/adw-dialog.h" line="92"/>
14237+ <return-value transfer-ownership="none" nullable="1">
14238+ <doc xml:space="preserve"
14239+ filename="src/adw-dialog.c"
14240+ line="1719">the focus widget</doc>
14241+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
14242+ </return-value>
14243+ <parameters>
14244+ <instance-parameter name="self" transfer-ownership="none">
14245+ <doc xml:space="preserve"
14246+ filename="src/adw-dialog.c"
14247+ line="1715">a dialog</doc>
14248+ <type name="Dialog" c:type="AdwDialog*"/>
14249+ </instance-parameter>
14250+ </parameters>
14251+ </method>
14252+ <method name="get_follows_content_size"
14253+ c:identifier="adw_dialog_get_follows_content_size"
14254+ glib:get-property="follows-content-size"
14255+ version="1.5">
14256+ <doc xml:space="preserve"
14257+ filename="src/adw-dialog.c"
14258+ line="1591">Gets whether to size content of @self automatically.</doc>
14259+ <source-position filename="src/adw-dialog.h" line="80"/>
14260+ <return-value transfer-ownership="none">
14261+ <doc xml:space="preserve"
14262+ filename="src/adw-dialog.c"
14263+ line="1597">whether to size content automatically</doc>
14264+ <type name="gboolean" c:type="gboolean"/>
14265+ </return-value>
14266+ <parameters>
14267+ <instance-parameter name="self" transfer-ownership="none">
14268+ <doc xml:space="preserve"
14269+ filename="src/adw-dialog.c"
14270+ line="1593">a dialog</doc>
14271+ <type name="Dialog" c:type="AdwDialog*"/>
14272+ </instance-parameter>
14273+ </parameters>
14274+ </method>
14275+ <method name="get_presentation_mode"
14276+ c:identifier="adw_dialog_get_presentation_mode"
14277+ glib:get-property="presentation-mode"
14278+ version="1.5">
14279+ <doc xml:space="preserve"
14280+ filename="src/adw-dialog.c"
14281+ line="1650">Gets presentation mode for @self.</doc>
14282+ <source-position filename="src/adw-dialog.h" line="86"/>
14283+ <return-value transfer-ownership="none">
14284+ <doc xml:space="preserve"
14285+ filename="src/adw-dialog.c"
14286+ line="1656">the presentation mode</doc>
14287+ <type name="DialogPresentationMode"
14288+ c:type="AdwDialogPresentationMode"/>
14289+ </return-value>
14290+ <parameters>
14291+ <instance-parameter name="self" transfer-ownership="none">
14292+ <doc xml:space="preserve"
14293+ filename="src/adw-dialog.c"
14294+ line="1652">a dialog</doc>
14295+ <type name="Dialog" c:type="AdwDialog*"/>
14296+ </instance-parameter>
14297+ </parameters>
14298+ </method>
14299+ <method name="get_title"
14300+ c:identifier="adw_dialog_get_title"
14301+ glib:get-property="title"
14302+ version="1.5">
14303+ <doc xml:space="preserve"
14304+ filename="src/adw-dialog.c"
14305+ line="1378">Gets the title of @self.</doc>
14306+ <source-position filename="src/adw-dialog.h" line="56"/>
14307+ <return-value transfer-ownership="none">
14308+ <doc xml:space="preserve"
14309+ filename="src/adw-dialog.c"
14310+ line="1384">the title</doc>
14311+ <type name="utf8" c:type="const char*"/>
14312+ </return-value>
14313+ <parameters>
14314+ <instance-parameter name="self" transfer-ownership="none">
14315+ <doc xml:space="preserve"
14316+ filename="src/adw-dialog.c"
14317+ line="1380">a dialog</doc>
14318+ <type name="Dialog" c:type="AdwDialog*"/>
14319+ </instance-parameter>
14320+ </parameters>
14321+ </method>
14322+ <method name="present" c:identifier="adw_dialog_present" version="1.5">
14323+ <doc xml:space="preserve"
14324+ filename="src/adw-dialog.c"
14325+ line="2023">Presents @self within @parent's window.
14326+
14327+If @self is already shown, raises it to the top instead.
14328+
14329+If the window is an [class@Window] or [class@ApplicationWindow], the dialog
14330+will be shown within it. Otherwise, it will be a separate window.</doc>
14331+ <source-position filename="src/adw-dialog.h" line="117"/>
14332+ <return-value transfer-ownership="none">
14333+ <type name="none" c:type="void"/>
14334+ </return-value>
14335+ <parameters>
14336+ <instance-parameter name="self" transfer-ownership="none">
14337+ <doc xml:space="preserve"
14338+ filename="src/adw-dialog.c"
14339+ line="2025">a dialog</doc>
14340+ <type name="Dialog" c:type="AdwDialog*"/>
14341+ </instance-parameter>
14342+ <parameter name="parent"
14343+ transfer-ownership="none"
14344+ nullable="1"
14345+ allow-none="1">
14346+ <doc xml:space="preserve"
14347+ filename="src/adw-dialog.c"
14348+ line="2026">a widget within the toplevel</doc>
14349+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
14350+ </parameter>
14351+ </parameters>
14352+ </method>
14353+ <method name="set_can_close"
14354+ c:identifier="adw_dialog_set_can_close"
14355+ glib:set-property="can-close"
14356+ version="1.5">
14357+ <doc xml:space="preserve"
14358+ filename="src/adw-dialog.c"
14359+ line="1451">Sets whether @self can be closed.
14360+
14361+If set to `FALSE`, the close button, shortcuts and
14362+[method@Dialog.close] will result in [signal@Dialog::close-attempt] being
14363+emitted instead, and bottom sheet close swipe will be disabled.
14364+[method@Dialog.force_close] still works.</doc>
14365+ <source-position filename="src/adw-dialog.h" line="64"/>
14366+ <return-value transfer-ownership="none">
14367+ <type name="none" c:type="void"/>
14368+ </return-value>
14369+ <parameters>
14370+ <instance-parameter name="self" transfer-ownership="none">
14371+ <doc xml:space="preserve"
14372+ filename="src/adw-dialog.c"
14373+ line="1453">a dialog</doc>
14374+ <type name="Dialog" c:type="AdwDialog*"/>
14375+ </instance-parameter>
14376+ <parameter name="can_close" transfer-ownership="none">
14377+ <doc xml:space="preserve"
14378+ filename="src/adw-dialog.c"
14379+ line="1454">whether to allow closing</doc>
14380+ <type name="gboolean" c:type="gboolean"/>
14381+ </parameter>
14382+ </parameters>
14383+ </method>
14384+ <method name="set_child"
14385+ c:identifier="adw_dialog_set_child"
14386+ glib:set-property="child"
14387+ version="1.5">
14388+ <doc xml:space="preserve"
14389+ filename="src/adw-dialog.c"
14390+ line="1345">Sets the child widget of @self.</doc>
14391+ <source-position filename="src/adw-dialog.h" line="52"/>
14392+ <return-value transfer-ownership="none">
14393+ <type name="none" c:type="void"/>
14394+ </return-value>
14395+ <parameters>
14396+ <instance-parameter name="self" transfer-ownership="none">
14397+ <doc xml:space="preserve"
14398+ filename="src/adw-dialog.c"
14399+ line="1347">a dialog</doc>
14400+ <type name="Dialog" c:type="AdwDialog*"/>
14401+ </instance-parameter>
14402+ <parameter name="child"
14403+ transfer-ownership="none"
14404+ nullable="1"
14405+ allow-none="1">
14406+ <doc xml:space="preserve"
14407+ filename="src/adw-dialog.c"
14408+ line="1348">the child widget</doc>
14409+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
14410+ </parameter>
14411+ </parameters>
14412+ </method>
14413+ <method name="set_content_height"
14414+ c:identifier="adw_dialog_set_content_height"
14415+ glib:set-property="content-height"
14416+ version="1.5">
14417+ <doc xml:space="preserve"
14418+ filename="src/adw-dialog.c"
14419+ line="1563">Sets the height of the dialog's contents.
14420+
14421+Set it to -1 to reset it to the content's natural height.
14422+
14423+See also: [property@Gtk.Window:default-height]</doc>
14424+ <source-position filename="src/adw-dialog.h" line="76"/>
14425+ <return-value transfer-ownership="none">
14426+ <type name="none" c:type="void"/>
14427+ </return-value>
14428+ <parameters>
14429+ <instance-parameter name="self" transfer-ownership="none">
14430+ <doc xml:space="preserve"
14431+ filename="src/adw-dialog.c"
14432+ line="1565">a dialog</doc>
14433+ <type name="Dialog" c:type="AdwDialog*"/>
14434+ </instance-parameter>
14435+ <parameter name="content_height" transfer-ownership="none">
14436+ <doc xml:space="preserve"
14437+ filename="src/adw-dialog.c"
14438+ line="1566">the content height</doc>
14439+ <type name="gint" c:type="int"/>
14440+ </parameter>
14441+ </parameters>
14442+ </method>
14443+ <method name="set_content_width"
14444+ c:identifier="adw_dialog_set_content_width"
14445+ glib:set-property="content-width"
14446+ version="1.5">
14447+ <doc xml:space="preserve"
14448+ filename="src/adw-dialog.c"
14449+ line="1513">Sets the width of the dialog's contents.
14450+
14451+Set it to -1 to reset it to the content's natural width.
14452+
14453+See also: [property@Gtk.Window:default-width]</doc>
14454+ <source-position filename="src/adw-dialog.h" line="70"/>
14455+ <return-value transfer-ownership="none">
14456+ <type name="none" c:type="void"/>
14457+ </return-value>
14458+ <parameters>
14459+ <instance-parameter name="self" transfer-ownership="none">
14460+ <doc xml:space="preserve"
14461+ filename="src/adw-dialog.c"
14462+ line="1515">a dialog</doc>
14463+ <type name="Dialog" c:type="AdwDialog*"/>
14464+ </instance-parameter>
14465+ <parameter name="content_width" transfer-ownership="none">
14466+ <doc xml:space="preserve"
14467+ filename="src/adw-dialog.c"
14468+ line="1516">the content width</doc>
14469+ <type name="gint" c:type="int"/>
14470+ </parameter>
14471+ </parameters>
14472+ </method>
14473+ <method name="set_default_widget"
14474+ c:identifier="adw_dialog_set_default_widget"
14475+ glib:set-property="default-widget"
14476+ version="1.5">
14477+ <doc xml:space="preserve"
14478+ filename="src/adw-dialog.c"
14479+ line="1807">Sets the default widget for @self.
14480+
14481+It's activated when the user presses Enter.</doc>
14482+ <source-position filename="src/adw-dialog.h" line="100"/>
14483+ <return-value transfer-ownership="none">
14484+ <type name="none" c:type="void"/>
14485+ </return-value>
14486+ <parameters>
14487+ <instance-parameter name="self" transfer-ownership="none">
14488+ <doc xml:space="preserve"
14489+ filename="src/adw-dialog.c"
14490+ line="1809">a dialog</doc>
14491+ <type name="Dialog" c:type="AdwDialog*"/>
14492+ </instance-parameter>
14493+ <parameter name="default_widget"
14494+ transfer-ownership="none"
14495+ nullable="1"
14496+ allow-none="1">
14497+ <doc xml:space="preserve"
14498+ filename="src/adw-dialog.c"
14499+ line="1810">the default widget</doc>
14500+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
14501+ </parameter>
14502+ </parameters>
14503+ </method>
14504+ <method name="set_focus"
14505+ c:identifier="adw_dialog_set_focus"
14506+ glib:set-property="focus-widget"
14507+ version="1.5">
14508+ <doc xml:space="preserve"
14509+ filename="src/adw-dialog.c"
14510+ line="1735">Sets the focus widget for @self.
14511+
14512+If @focus is not the current focus widget, and is focusable, sets it as the
14513+focus widget for the dialog.
14514+
14515+If focus is `NULL`, unsets the focus widget for this dialog. To set the focus
14516+to a particular widget in the dialog, it is usually more convenient to use
14517+[method@Gtk.Widget.grab_focus] instead of this function.</doc>
14518+ <source-position filename="src/adw-dialog.h" line="94"/>
14519+ <return-value transfer-ownership="none">
14520+ <type name="none" c:type="void"/>
14521+ </return-value>
14522+ <parameters>
14523+ <instance-parameter name="self" transfer-ownership="none">
14524+ <doc xml:space="preserve"
14525+ filename="src/adw-dialog.c"
14526+ line="1737">a dialog</doc>
14527+ <type name="Dialog" c:type="AdwDialog*"/>
14528+ </instance-parameter>
14529+ <parameter name="focus"
14530+ transfer-ownership="none"
14531+ nullable="1"
14532+ allow-none="1">
14533+ <doc xml:space="preserve"
14534+ filename="src/adw-dialog.c"
14535+ line="1738">the focus widget</doc>
14536+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
14537+ </parameter>
14538+ </parameters>
14539+ </method>
14540+ <method name="set_follows_content_size"
14541+ c:identifier="adw_dialog_set_follows_content_size"
14542+ glib:set-property="follows-content-size"
14543+ version="1.5">
14544+ <doc xml:space="preserve"
14545+ filename="src/adw-dialog.c"
14546+ line="1613">Sets whether to size content of @self automatically.
14547+
14548+If set to `TRUE`, always use the content's natural size instead of
14549+[property@Dialog:content-width] and [property@Dialog:content-height]. If
14550+the content resizes, the dialog will immediately resize as well.
14551+
14552+See also: [property@Gtk.Window:resizable]</doc>
14553+ <source-position filename="src/adw-dialog.h" line="82"/>
14554+ <return-value transfer-ownership="none">
14555+ <type name="none" c:type="void"/>
14556+ </return-value>
14557+ <parameters>
14558+ <instance-parameter name="self" transfer-ownership="none">
14559+ <doc xml:space="preserve"
14560+ filename="src/adw-dialog.c"
14561+ line="1615">a dialog</doc>
14562+ <type name="Dialog" c:type="AdwDialog*"/>
14563+ </instance-parameter>
14564+ <parameter name="follows_content_size" transfer-ownership="none">
14565+ <doc xml:space="preserve"
14566+ filename="src/adw-dialog.c"
14567+ line="1616">whether to size content automatically</doc>
14568+ <type name="gboolean" c:type="gboolean"/>
14569+ </parameter>
14570+ </parameters>
14571+ </method>
14572+ <method name="set_presentation_mode"
14573+ c:identifier="adw_dialog_set_presentation_mode"
14574+ glib:set-property="presentation-mode"
14575+ version="1.5">
14576+ <doc xml:space="preserve"
14577+ filename="src/adw-dialog.c"
14578+ line="1672">Sets presentation mode for @self.
14579+
14580+When set to `ADW_DIALOG_AUTO`, the dialog appears as a bottom sheet when the
14581+following condition is met: `max-width: 450px or max-height: 360px`, and as a
14582+floating window otherwise.
14583+
14584+Set it to `ADW_DIALOG_FLOATING` or `ADW_DIALOG_BOTTOM_SHEET` to always
14585+present it a floating window or a bottom sheet respectively, regardless of
14586+available size.
14587+
14588+Presentation mode does nothing for dialogs presented as a window.</doc>
14589+ <source-position filename="src/adw-dialog.h" line="88"/>
14590+ <return-value transfer-ownership="none">
14591+ <type name="none" c:type="void"/>
14592+ </return-value>
14593+ <parameters>
14594+ <instance-parameter name="self" transfer-ownership="none">
14595+ <doc xml:space="preserve"
14596+ filename="src/adw-dialog.c"
14597+ line="1674">a dialog</doc>
14598+ <type name="Dialog" c:type="AdwDialog*"/>
14599+ </instance-parameter>
14600+ <parameter name="presentation_mode" transfer-ownership="none">
14601+ <doc xml:space="preserve"
14602+ filename="src/adw-dialog.c"
14603+ line="1675">the new presentation mode</doc>
14604+ <type name="DialogPresentationMode"
14605+ c:type="AdwDialogPresentationMode"/>
14606+ </parameter>
14607+ </parameters>
14608+ </method>
14609+ <method name="set_title"
14610+ c:identifier="adw_dialog_set_title"
14611+ glib:set-property="title"
14612+ version="1.5">
14613+ <doc xml:space="preserve"
14614+ filename="src/adw-dialog.c"
14615+ line="1400">Sets the title of @self.</doc>
14616+ <source-position filename="src/adw-dialog.h" line="58"/>
14617+ <return-value transfer-ownership="none">
14618+ <type name="none" c:type="void"/>
14619+ </return-value>
14620+ <parameters>
14621+ <instance-parameter name="self" transfer-ownership="none">
14622+ <doc xml:space="preserve"
14623+ filename="src/adw-dialog.c"
14624+ line="1402">a dialog</doc>
14625+ <type name="Dialog" c:type="AdwDialog*"/>
14626+ </instance-parameter>
14627+ <parameter name="title" transfer-ownership="none">
14628+ <doc xml:space="preserve"
14629+ filename="src/adw-dialog.c"
14630+ line="1403">the new title</doc>
14631+ <type name="utf8" c:type="const char*"/>
14632+ </parameter>
14633+ </parameters>
14634+ </method>
14635+ <property name="can-close"
14636+ version="1.5"
14637+ writable="1"
14638+ transfer-ownership="none"
14639+ setter="set_can_close"
14640+ getter="get_can_close"
14641+ default-value="TRUE">
14642+ <doc xml:space="preserve"
14643+ filename="src/adw-dialog.c"
14644+ line="1051">Whether the dialog can be closed.
14645+
14646+If set to `FALSE`, the close button, shortcuts and
14647+[method@Dialog.close] will result in [signal@Dialog::close-attempt] being
14648+emitted instead, and bottom sheet close swipe will be disabled.
14649+[method@Dialog.force_close] still works.</doc>
14650+ <type name="gboolean" c:type="gboolean"/>
14651+ </property>
14652+ <property name="child"
14653+ version="1.5"
14654+ writable="1"
14655+ transfer-ownership="none"
14656+ setter="set_child"
14657+ getter="get_child">
14658+ <doc xml:space="preserve"
14659+ filename="src/adw-dialog.c"
14660+ line="1027">The child widget of the `AdwDialog`.</doc>
14661+ <type name="Gtk.Widget"/>
14662+ </property>
14663+ <property name="content-height"
14664+ version="1.5"
14665+ writable="1"
14666+ transfer-ownership="none"
14667+ setter="set_content_height"
14668+ getter="get_content_height"
14669+ default-value="-1">
14670+ <doc xml:space="preserve"
14671+ filename="src/adw-dialog.c"
14672+ line="1084">The height of the dialog's contents.
14673+
14674+Set it to -1 to reset it to the content's natural height.
14675+
14676+See also: [property@Gtk.Window:default-height]</doc>
14677+ <type name="gint" c:type="gint"/>
14678+ </property>
14679+ <property name="content-width"
14680+ version="1.5"
14681+ writable="1"
14682+ transfer-ownership="none"
14683+ setter="set_content_width"
14684+ getter="get_content_width"
14685+ default-value="-1">
14686+ <doc xml:space="preserve"
14687+ filename="src/adw-dialog.c"
14688+ line="1068">The width of the dialog's contents.
14689+
14690+Set it to -1 to reset it to the content's natural width.
14691+
14692+See also: [property@Gtk.Window:default-width]</doc>
14693+ <type name="gint" c:type="gint"/>
14694+ </property>
14695+ <property name="current-breakpoint"
14696+ version="1.5"
14697+ transfer-ownership="none"
14698+ getter="get_current_breakpoint">
14699+ <doc xml:space="preserve"
14700+ filename="src/adw-dialog.c"
14701+ line="1167">The current breakpoint.</doc>
14702+ <type name="Breakpoint"/>
14703+ </property>
14704+ <property name="default-widget"
14705+ version="1.5"
14706+ writable="1"
14707+ transfer-ownership="none"
14708+ setter="set_default_widget"
14709+ getter="get_default_widget">
14710+ <doc xml:space="preserve"
14711+ filename="src/adw-dialog.c"
14712+ line="1153">The default widget.
14713+
14714+It's activated when the user presses Enter.</doc>
14715+ <type name="Gtk.Widget"/>
14716+ </property>
14717+ <property name="focus-widget"
14718+ version="1.5"
14719+ writable="1"
14720+ transfer-ownership="none"
14721+ setter="set_focus"
14722+ getter="get_focus">
14723+ <doc xml:space="preserve"
14724+ filename="src/adw-dialog.c"
14725+ line="1141">The focus widget.</doc>
14726+ <type name="Gtk.Widget"/>
14727+ </property>
14728+ <property name="follows-content-size"
14729+ version="1.5"
14730+ writable="1"
14731+ transfer-ownership="none"
14732+ setter="set_follows_content_size"
14733+ getter="get_follows_content_size"
14734+ default-value="FALSE">
14735+ <doc xml:space="preserve"
14736+ filename="src/adw-dialog.c"
14737+ line="1100">Whether to size content automatically.
14738+
14739+If set to `TRUE`, always use the content's natural size instead of
14740+[property@Dialog:content-width] and [property@Dialog:content-height]. If
14741+the content resizes, the dialog will immediately resize as well.
14742+
14743+See also: [property@Gtk.Window:resizable]</doc>
14744+ <type name="gboolean" c:type="gboolean"/>
14745+ </property>
14746+ <property name="presentation-mode"
14747+ version="1.5"
14748+ writable="1"
14749+ transfer-ownership="none"
14750+ setter="set_presentation_mode"
14751+ getter="get_presentation_mode"
14752+ default-value="ADW_DIALOG_AUTO">
14753+ <doc xml:space="preserve"
14754+ filename="src/adw-dialog.c"
14755+ line="1118">The dialog's presentation mode.
14756+
14757+When set to `ADW_DIALOG_AUTO`, the dialog appears as a bottom sheet when
14758+the following condition is met: `max-width: 450px or max-height: 360px`,
14759+and as a floating window otherwise.
14760+
14761+Set it to `ADW_DIALOG_FLOATING` or `ADW_DIALOG_BOTTOM_SHEET` to always
14762+present it a floating window or a bottom sheet respectively, regardless of
14763+available size.
14764+
14765+Presentation mode does nothing for dialogs presented as a window.</doc>
14766+ <type name="DialogPresentationMode"/>
14767+ </property>
14768+ <property name="title"
14769+ version="1.5"
14770+ writable="1"
14771+ transfer-ownership="none"
14772+ setter="set_title"
14773+ getter="get_title">
14774+ <doc xml:space="preserve"
14775+ filename="src/adw-dialog.c"
14776+ line="1039">The title of the dialog.</doc>
14777+ <type name="utf8" c:type="gchar*"/>
14778+ </property>
14779+ <field name="parent_instance">
14780+ <type name="Gtk.Widget" c:type="GtkWidget"/>
14781+ </field>
14782+ <glib:signal name="close-attempt" when="last" version="1.5">
14783+ <doc xml:space="preserve"
14784+ filename="src/adw-dialog.c"
14785+ line="1181">Emitted when the close button or shortcut is used, or
14786+[method@Dialog.close] is called while [property@Dialog:can-close] is set to
14787+`FALSE`.</doc>
14788+ <return-value transfer-ownership="none">
14789+ <type name="none" c:type="void"/>
14790+ </return-value>
14791+ </glib:signal>
14792+ <glib:signal name="closed" when="last" version="1.5">
14793+ <doc xml:space="preserve"
14794+ filename="src/adw-dialog.c"
14795+ line="1204">Emitted when the dialog is successfully closed.</doc>
14796+ <return-value transfer-ownership="none">
14797+ <type name="none" c:type="void"/>
14798+ </return-value>
14799+ </glib:signal>
14800+ </class>
14801+ <record name="DialogClass"
14802+ c:type="AdwDialogClass"
14803+ glib:is-gtype-struct-for="Dialog">
14804+ <source-position filename="src/adw-dialog.h" line="44"/>
14805+ <field name="parent_class">
14806+ <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
14807+ </field>
14808+ <field name="close_attempt">
14809+ <callback name="close_attempt">
14810+ <source-position filename="src/adw-dialog.h" line="39"/>
14811+ <return-value transfer-ownership="none">
14812+ <type name="none" c:type="void"/>
14813+ </return-value>
14814+ <parameters>
14815+ <parameter name="dialog" transfer-ownership="none">
14816+ <type name="Dialog" c:type="AdwDialog*"/>
14817+ </parameter>
14818+ </parameters>
14819+ </callback>
14820+ </field>
14821+ <field name="closed">
14822+ <callback name="closed">
14823+ <source-position filename="src/adw-dialog.h" line="40"/>
14824+ <return-value transfer-ownership="none">
14825+ <type name="none" c:type="void"/>
14826+ </return-value>
14827+ <parameters>
14828+ <parameter name="dialog" transfer-ownership="none">
14829+ <type name="Dialog" c:type="AdwDialog*"/>
14830+ </parameter>
14831+ </parameters>
14832+ </callback>
14833+ </field>
14834+ <field name="padding" readable="0" private="1">
14835+ <array zero-terminated="0" fixed-size="4">
14836+ <type name="gpointer" c:type="gpointer"/>
14837+ </array>
14838+ </field>
14839+ </record>
14840+ <enumeration name="DialogPresentationMode"
14841+ version="1.5"
14842+ glib:type-name="AdwDialogPresentationMode"
14843+ glib:get-type="adw_dialog_presentation_mode_get_type"
14844+ c:type="AdwDialogPresentationMode">
14845+ <doc xml:space="preserve"
14846+ filename="src/adw-dialog.c"
14847+ line="26">Describes the available presentation modes for [class@Dialog].
14848+
14849+New values may be added to this enumeration over time.
14850+
14851+See [property@Dialog:presentation-mode].</doc>
14852+ <member name="auto"
14853+ value="0"
14854+ c:identifier="ADW_DIALOG_AUTO"
14855+ glib:nick="auto"
14856+ glib:name="ADW_DIALOG_AUTO">
14857+ <doc xml:space="preserve"
14858+ filename="src/adw-dialog.c"
14859+ line="28">Switch between `ADW_DIALOG_FLOATING` and
14860+ `ADW_DIALOG_BOTTOM_SHEET` depending on available size.</doc>
14861+ </member>
14862+ <member name="floating"
14863+ value="1"
14864+ c:identifier="ADW_DIALOG_FLOATING"
14865+ glib:nick="floating"
14866+ glib:name="ADW_DIALOG_FLOATING">
14867+ <doc xml:space="preserve"
14868+ filename="src/adw-dialog.c"
14869+ line="30">Present dialog as a centered floating window.</doc>
14870+ </member>
14871+ <member name="bottom_sheet"
14872+ value="2"
14873+ c:identifier="ADW_DIALOG_BOTTOM_SHEET"
14874+ glib:nick="bottom-sheet"
14875+ glib:name="ADW_DIALOG_BOTTOM_SHEET">
14876+ <doc xml:space="preserve"
14877+ filename="src/adw-dialog.c"
14878+ line="31">Present dialog as a bottom sheet.</doc>
14879+ </member>
14880+ </enumeration>
14881+ <function-macro name="ENCODE_VERSION"
14882+ c:identifier="ADW_ENCODE_VERSION"
14883+ introspectable="0">
14884+ <source-position filename="src/adw-version.h" line="53"/>
14885+ <parameters>
14886+ <parameter name="major">
14887+ </parameter>
14888+ <parameter name="minor">
14889+ </parameter>
14890+ <parameter name="micro">
14891+ </parameter>
14892+ </parameters>
14893+ </function-macro>
14894+ <enumeration name="Easing"
14895+ glib:type-name="AdwEasing"
14896+ glib:get-type="adw_easing_get_type"
14897+ c:type="AdwEasing">
14898+ <doc xml:space="preserve"
14899+ filename="src/adw-easing.c"
14900+ line="22">Describes the available easing functions for use with
14901+[class@TimedAnimation].
14902+
14903+New values may be added to this enumeration over time.</doc>
14904+ <member name="linear"
14905+ value="0"
14906+ c:identifier="ADW_LINEAR"
14907+ glib:nick="linear"
14908+ glib:name="ADW_LINEAR">
14909+ <doc xml:space="preserve"
14910+ filename="src/adw-easing.c"
14911+ line="24">Linear tweening.</doc>
14912+ </member>
14913+ <member name="ease_in_quad"
14914+ value="1"
14915+ c:identifier="ADW_EASE_IN_QUAD"
14916+ glib:nick="ease-in-quad"
14917+ glib:name="ADW_EASE_IN_QUAD">
14918+ <doc xml:space="preserve"
14919+ filename="src/adw-easing.c"
14920+ line="25">Quadratic tweening.</doc>
14921+ </member>
14922+ <member name="ease_out_quad"
14923+ value="2"
14924+ c:identifier="ADW_EASE_OUT_QUAD"
14925+ glib:nick="ease-out-quad"
14926+ glib:name="ADW_EASE_OUT_QUAD">
14927+ <doc xml:space="preserve"
14928+ filename="src/adw-easing.c"
14929+ line="26">Quadratic tweening, inverse of `ADW_EASE_IN_QUAD`.</doc>
14930+ </member>
14931+ <member name="ease_in_out_quad"
14932+ value="3"
14933+ c:identifier="ADW_EASE_IN_OUT_QUAD"
14934+ glib:nick="ease-in-out-quad"
14935+ glib:name="ADW_EASE_IN_OUT_QUAD">
14936+ <doc xml:space="preserve"
14937+ filename="src/adw-easing.c"
14938+ line="27">Quadratic tweening, combining `ADW_EASE_IN_QUAD` and
14939+ `ADW_EASE_OUT_QUAD`.</doc>
14940+ </member>
14941+ <member name="ease_in_cubic"
14942+ value="4"
14943+ c:identifier="ADW_EASE_IN_CUBIC"
14944+ glib:nick="ease-in-cubic"
14945+ glib:name="ADW_EASE_IN_CUBIC">
14946+ <doc xml:space="preserve"
14947+ filename="src/adw-easing.c"
14948+ line="29">Cubic tweening.</doc>
14949+ </member>
14950+ <member name="ease_out_cubic"
14951+ value="5"
14952+ c:identifier="ADW_EASE_OUT_CUBIC"
14953+ glib:nick="ease-out-cubic"
14954+ glib:name="ADW_EASE_OUT_CUBIC">
14955+ <doc xml:space="preserve"
14956+ filename="src/adw-easing.c"
14957+ line="30">Cubic tweening, inverse of `ADW_EASE_IN_CUBIC`.</doc>
14958+ </member>
14959+ <member name="ease_in_out_cubic"
14960+ value="6"
14961+ c:identifier="ADW_EASE_IN_OUT_CUBIC"
14962+ glib:nick="ease-in-out-cubic"
14963+ glib:name="ADW_EASE_IN_OUT_CUBIC">
14964+ <doc xml:space="preserve"
14965+ filename="src/adw-easing.c"
14966+ line="31">Cubic tweening, combining `ADW_EASE_IN_CUBIC` and
14967+ `ADW_EASE_OUT_CUBIC`.</doc>
14968+ </member>
14969+ <member name="ease_in_quart"
14970+ value="7"
14971+ c:identifier="ADW_EASE_IN_QUART"
14972+ glib:nick="ease-in-quart"
14973+ glib:name="ADW_EASE_IN_QUART">
14974+ <doc xml:space="preserve"
14975+ filename="src/adw-easing.c"
14976+ line="33">Quartic tweening.</doc>
14977+ </member>
14978+ <member name="ease_out_quart"
14979+ value="8"
14980+ c:identifier="ADW_EASE_OUT_QUART"
14981+ glib:nick="ease-out-quart"
14982+ glib:name="ADW_EASE_OUT_QUART">
14983+ <doc xml:space="preserve"
14984+ filename="src/adw-easing.c"
14985+ line="34">Quartic tweening, inverse of `ADW_EASE_IN_QUART`.</doc>
14986+ </member>
14987+ <member name="ease_in_out_quart"
14988+ value="9"
14989+ c:identifier="ADW_EASE_IN_OUT_QUART"
14990+ glib:nick="ease-in-out-quart"
14991+ glib:name="ADW_EASE_IN_OUT_QUART">
14992+ <doc xml:space="preserve"
14993+ filename="src/adw-easing.c"
14994+ line="35">Quartic tweening, combining `ADW_EASE_IN_QUART` and
14995+ `ADW_EASE_OUT_QUART`.</doc>
14996+ </member>
14997+ <member name="ease_in_quint"
14998+ value="10"
14999+ c:identifier="ADW_EASE_IN_QUINT"
15000+ glib:nick="ease-in-quint"
15001+ glib:name="ADW_EASE_IN_QUINT">
15002+ <doc xml:space="preserve"
15003+ filename="src/adw-easing.c"
15004+ line="37">Quintic tweening.</doc>
15005+ </member>
15006+ <member name="ease_out_quint"
15007+ value="11"
15008+ c:identifier="ADW_EASE_OUT_QUINT"
15009+ glib:nick="ease-out-quint"
15010+ glib:name="ADW_EASE_OUT_QUINT">
15011+ <doc xml:space="preserve"
15012+ filename="src/adw-easing.c"
15013+ line="38">Quintic tweening, inverse of `ADW_EASE_IN_QUINT`.</doc>
15014+ </member>
15015+ <member name="ease_in_out_quint"
15016+ value="12"
15017+ c:identifier="ADW_EASE_IN_OUT_QUINT"
15018+ glib:nick="ease-in-out-quint"
15019+ glib:name="ADW_EASE_IN_OUT_QUINT">
15020+ <doc xml:space="preserve"
15021+ filename="src/adw-easing.c"
15022+ line="39">Quintic tweening, combining `ADW_EASE_IN_QUINT` and
15023+ `ADW_EASE_OUT_QUINT`.</doc>
15024+ </member>
15025+ <member name="ease_in_sine"
15026+ value="13"
15027+ c:identifier="ADW_EASE_IN_SINE"
15028+ glib:nick="ease-in-sine"
15029+ glib:name="ADW_EASE_IN_SINE">
15030+ <doc xml:space="preserve"
15031+ filename="src/adw-easing.c"
15032+ line="41">Sine wave tweening.</doc>
15033+ </member>
15034+ <member name="ease_out_sine"
15035+ value="14"
15036+ c:identifier="ADW_EASE_OUT_SINE"
15037+ glib:nick="ease-out-sine"
15038+ glib:name="ADW_EASE_OUT_SINE">
15039+ <doc xml:space="preserve"
15040+ filename="src/adw-easing.c"
15041+ line="42">Sine wave tweening, inverse of `ADW_EASE_IN_SINE`.</doc>
15042+ </member>
15043+ <member name="ease_in_out_sine"
15044+ value="15"
15045+ c:identifier="ADW_EASE_IN_OUT_SINE"
15046+ glib:nick="ease-in-out-sine"
15047+ glib:name="ADW_EASE_IN_OUT_SINE">
15048+ <doc xml:space="preserve"
15049+ filename="src/adw-easing.c"
15050+ line="43">Sine wave tweening, combining `ADW_EASE_IN_SINE` and
15051+ `ADW_EASE_OUT_SINE`.</doc>
15052+ </member>
15053+ <member name="ease_in_expo"
15054+ value="16"
15055+ c:identifier="ADW_EASE_IN_EXPO"
15056+ glib:nick="ease-in-expo"
15057+ glib:name="ADW_EASE_IN_EXPO">
15058+ <doc xml:space="preserve"
15059+ filename="src/adw-easing.c"
15060+ line="45">Exponential tweening.</doc>
15061+ </member>
15062+ <member name="ease_out_expo"
15063+ value="17"
15064+ c:identifier="ADW_EASE_OUT_EXPO"
15065+ glib:nick="ease-out-expo"
15066+ glib:name="ADW_EASE_OUT_EXPO">
15067+ <doc xml:space="preserve"
15068+ filename="src/adw-easing.c"
15069+ line="46">Exponential tweening, inverse of `ADW_EASE_IN_EXPO`.</doc>
15070+ </member>
15071+ <member name="ease_in_out_expo"
15072+ value="18"
15073+ c:identifier="ADW_EASE_IN_OUT_EXPO"
15074+ glib:nick="ease-in-out-expo"
15075+ glib:name="ADW_EASE_IN_OUT_EXPO">
15076+ <doc xml:space="preserve"
15077+ filename="src/adw-easing.c"
15078+ line="47">Exponential tweening, combining `ADW_EASE_IN_EXPO` and
15079+ `ADW_EASE_OUT_EXPO`.</doc>
15080+ </member>
15081+ <member name="ease_in_circ"
15082+ value="19"
15083+ c:identifier="ADW_EASE_IN_CIRC"
15084+ glib:nick="ease-in-circ"
15085+ glib:name="ADW_EASE_IN_CIRC">
15086+ <doc xml:space="preserve"
15087+ filename="src/adw-easing.c"
15088+ line="49">Circular tweening.</doc>
15089+ </member>
15090+ <member name="ease_out_circ"
15091+ value="20"
15092+ c:identifier="ADW_EASE_OUT_CIRC"
15093+ glib:nick="ease-out-circ"
15094+ glib:name="ADW_EASE_OUT_CIRC">
15095+ <doc xml:space="preserve"
15096+ filename="src/adw-easing.c"
15097+ line="50">Circular tweening, inverse of `ADW_EASE_IN_CIRC`.</doc>
15098+ </member>
15099+ <member name="ease_in_out_circ"
15100+ value="21"
15101+ c:identifier="ADW_EASE_IN_OUT_CIRC"
15102+ glib:nick="ease-in-out-circ"
15103+ glib:name="ADW_EASE_IN_OUT_CIRC">
15104+ <doc xml:space="preserve"
15105+ filename="src/adw-easing.c"
15106+ line="51">Circular tweening, combining `ADW_EASE_IN_CIRC` and
15107+ `ADW_EASE_OUT_CIRC`.</doc>
15108+ </member>
15109+ <member name="ease_in_elastic"
15110+ value="22"
15111+ c:identifier="ADW_EASE_IN_ELASTIC"
15112+ glib:nick="ease-in-elastic"
15113+ glib:name="ADW_EASE_IN_ELASTIC">
15114+ <doc xml:space="preserve"
15115+ filename="src/adw-easing.c"
15116+ line="53">Elastic tweening, with offshoot on start.</doc>
15117+ </member>
15118+ <member name="ease_out_elastic"
15119+ value="23"
15120+ c:identifier="ADW_EASE_OUT_ELASTIC"
15121+ glib:nick="ease-out-elastic"
15122+ glib:name="ADW_EASE_OUT_ELASTIC">
15123+ <doc xml:space="preserve"
15124+ filename="src/adw-easing.c"
15125+ line="54">Elastic tweening, with offshoot on end, inverse of
15126+ `ADW_EASE_IN_ELASTIC`.</doc>
15127+ </member>
15128+ <member name="ease_in_out_elastic"
15129+ value="24"
15130+ c:identifier="ADW_EASE_IN_OUT_ELASTIC"
15131+ glib:nick="ease-in-out-elastic"
15132+ glib:name="ADW_EASE_IN_OUT_ELASTIC">
15133+ <doc xml:space="preserve"
15134+ filename="src/adw-easing.c"
15135+ line="56">Elastic tweening, with offshoot on both ends,
15136+ combining `ADW_EASE_IN_ELASTIC` and `ADW_EASE_OUT_ELASTIC`.</doc>
15137+ </member>
15138+ <member name="ease_in_back"
15139+ value="25"
15140+ c:identifier="ADW_EASE_IN_BACK"
15141+ glib:nick="ease-in-back"
15142+ glib:name="ADW_EASE_IN_BACK">
15143+ <doc xml:space="preserve"
15144+ filename="src/adw-easing.c"
15145+ line="58">Overshooting cubic tweening, with backtracking on start.</doc>
15146+ </member>
15147+ <member name="ease_out_back"
15148+ value="26"
15149+ c:identifier="ADW_EASE_OUT_BACK"
15150+ glib:nick="ease-out-back"
15151+ glib:name="ADW_EASE_OUT_BACK">
15152+ <doc xml:space="preserve"
15153+ filename="src/adw-easing.c"
15154+ line="59">Overshooting cubic tweening, with backtracking on end,
783315155 inverse of `ADW_EASE_IN_BACK`.</doc>
783415156 </member>
7835- <member name="ease_in_out_back"
7836- value="27"
7837- c:identifier="ADW_EASE_IN_OUT_BACK"
7838- glib:nick="ease-in-out-back"
7839- glib:name="ADW_EASE_IN_OUT_BACK">
15157+ <member name="ease_in_out_back"
15158+ value="27"
15159+ c:identifier="ADW_EASE_IN_OUT_BACK"
15160+ glib:nick="ease-in-out-back"
15161+ glib:name="ADW_EASE_IN_OUT_BACK">
15162+ <doc xml:space="preserve"
15163+ filename="src/adw-easing.c"
15164+ line="61">Overshooting cubic tweening, with backtracking on both
15165+ ends, combining `ADW_EASE_IN_BACK` and `ADW_EASE_OUT_BACK`.</doc>
15166+ </member>
15167+ <member name="ease_in_bounce"
15168+ value="28"
15169+ c:identifier="ADW_EASE_IN_BOUNCE"
15170+ glib:nick="ease-in-bounce"
15171+ glib:name="ADW_EASE_IN_BOUNCE">
15172+ <doc xml:space="preserve"
15173+ filename="src/adw-easing.c"
15174+ line="63">Exponentially decaying parabolic (bounce) tweening,
15175+ on start.</doc>
15176+ </member>
15177+ <member name="ease_out_bounce"
15178+ value="29"
15179+ c:identifier="ADW_EASE_OUT_BOUNCE"
15180+ glib:nick="ease-out-bounce"
15181+ glib:name="ADW_EASE_OUT_BOUNCE">
15182+ <doc xml:space="preserve"
15183+ filename="src/adw-easing.c"
15184+ line="65">Exponentially decaying parabolic (bounce) tweening,
15185+ with bounce on end, inverse of `ADW_EASE_IN_BOUNCE`.</doc>
15186+ </member>
15187+ <member name="ease_in_out_bounce"
15188+ value="30"
15189+ c:identifier="ADW_EASE_IN_OUT_BOUNCE"
15190+ glib:nick="ease-in-out-bounce"
15191+ glib:name="ADW_EASE_IN_OUT_BOUNCE">
15192+ <doc xml:space="preserve"
15193+ filename="src/adw-easing.c"
15194+ line="67">Exponentially decaying parabolic (bounce) tweening,
15195+ with bounce on both ends, combining `ADW_EASE_IN_BOUNCE` and
15196+ `ADW_EASE_OUT_BOUNCE`.</doc>
15197+ </member>
15198+ <function name="ease" c:identifier="adw_easing_ease">
15199+ <doc xml:space="preserve"
15200+ filename="src/adw-easing.c"
15201+ line="428">Computes easing with @easing for @value.
15202+
15203+@value should generally be in the [0, 1] range.</doc>
15204+ <source-position filename="src/adw-easing.h" line="57"/>
15205+ <return-value transfer-ownership="none">
15206+ <doc xml:space="preserve"
15207+ filename="src/adw-easing.c"
15208+ line="437">the easing for @value</doc>
15209+ <type name="gdouble" c:type="double"/>
15210+ </return-value>
15211+ <parameters>
15212+ <parameter name="self" transfer-ownership="none">
15213+ <doc xml:space="preserve"
15214+ filename="src/adw-easing.c"
15215+ line="430">an easing value</doc>
15216+ <type name="Easing" c:type="AdwEasing"/>
15217+ </parameter>
15218+ <parameter name="value" transfer-ownership="none">
15219+ <doc xml:space="preserve"
15220+ filename="src/adw-easing.c"
15221+ line="431">a value to ease</doc>
15222+ <type name="gdouble" c:type="double"/>
15223+ </parameter>
15224+ </parameters>
15225+ </function>
15226+ </enumeration>
15227+ <class name="EntryRow"
15228+ c:symbol-prefix="entry_row"
15229+ c:type="AdwEntryRow"
15230+ version="1.2"
15231+ parent="PreferencesRow"
15232+ glib:type-name="AdwEntryRow"
15233+ glib:get-type="adw_entry_row_get_type"
15234+ glib:type-struct="EntryRowClass">
15235+ <doc xml:space="preserve"
15236+ filename="src/adw-entry-row.c"
15237+ line="21">A [class@Gtk.ListBoxRow] with an embedded text entry.
15238+
15239+&lt;picture&gt;
15240+ &lt;source srcset="entry-row-dark.png" media="(prefers-color-scheme: dark)"&gt;
15241+ &lt;img src="entry-row.png" alt="entry-row"&gt;
15242+&lt;/picture&gt;
15243+
15244+`AdwEntryRow` has a title that doubles as placeholder text. It shows an icon
15245+indicating that it's editable and can receive additional widgets before or
15246+after the editable part.
15247+
15248+If [property@EntryRow:show-apply-button] is set to `TRUE`, `AdwEntryRow` can
15249+show an apply button when editing its contents. This can be useful if
15250+changing its contents can result in an expensive operation, such as network
15251+activity.
15252+
15253+`AdwEntryRow` provides only minimal API and should be used with the
15254+[iface@Gtk.Editable] API.
15255+
15256+See also [class@PasswordEntryRow].
15257+
15258+## AdwEntryRow as GtkBuildable
15259+
15260+The `AdwEntryRow` implementation of the [iface@Gtk.Buildable] interface
15261+supports adding a child at its end by specifying “suffix” or omitting the
15262+“type” attribute of a &lt;child&gt; element.
15263+
15264+It also supports adding a child as a prefix widget by specifying “prefix” as
15265+the “type” attribute of a &lt;child&gt; element.
15266+
15267+## CSS nodes
15268+
15269+`AdwEntryRow` has a single CSS node with name `row` and the `.entry` style
15270+class.</doc>
15271+ <source-position filename="src/adw-entry-row.h" line="32"/>
15272+ <implements name="Gtk.Accessible"/>
15273+ <implements name="Gtk.Actionable"/>
15274+ <implements name="Gtk.Buildable"/>
15275+ <implements name="Gtk.ConstraintTarget"/>
15276+ <implements name="Gtk.Editable"/>
15277+ <constructor name="new" c:identifier="adw_entry_row_new" version="1.2">
15278+ <doc xml:space="preserve"
15279+ filename="src/adw-entry-row.c"
15280+ line="808">Creates a new `AdwEntryRow`.</doc>
15281+ <source-position filename="src/adw-entry-row.h" line="35"/>
15282+ <return-value transfer-ownership="none">
15283+ <doc xml:space="preserve"
15284+ filename="src/adw-entry-row.c"
15285+ line="813">the newly created `AdwEntryRow`</doc>
15286+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
15287+ </return-value>
15288+ </constructor>
15289+ <method name="add_prefix"
15290+ c:identifier="adw_entry_row_add_prefix"
15291+ version="1.2">
15292+ <doc xml:space="preserve"
15293+ filename="src/adw-entry-row.c"
15294+ line="823">Adds a prefix widget to @self.</doc>
15295+ <source-position filename="src/adw-entry-row.h" line="38"/>
15296+ <return-value transfer-ownership="none">
15297+ <type name="none" c:type="void"/>
15298+ </return-value>
15299+ <parameters>
15300+ <instance-parameter name="self" transfer-ownership="none">
15301+ <doc xml:space="preserve"
15302+ filename="src/adw-entry-row.c"
15303+ line="825">an entry row</doc>
15304+ <type name="EntryRow" c:type="AdwEntryRow*"/>
15305+ </instance-parameter>
15306+ <parameter name="widget" transfer-ownership="none">
15307+ <doc xml:space="preserve"
15308+ filename="src/adw-entry-row.c"
15309+ line="826">a widget</doc>
15310+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
15311+ </parameter>
15312+ </parameters>
15313+ </method>
15314+ <method name="add_suffix"
15315+ c:identifier="adw_entry_row_add_suffix"
15316+ version="1.2">
15317+ <doc xml:space="preserve"
15318+ filename="src/adw-entry-row.c"
15319+ line="848">Adds a suffix widget to @self.</doc>
15320+ <source-position filename="src/adw-entry-row.h" line="41"/>
15321+ <return-value transfer-ownership="none">
15322+ <type name="none" c:type="void"/>
15323+ </return-value>
15324+ <parameters>
15325+ <instance-parameter name="self" transfer-ownership="none">
15326+ <doc xml:space="preserve"
15327+ filename="src/adw-entry-row.c"
15328+ line="850">an entry row</doc>
15329+ <type name="EntryRow" c:type="AdwEntryRow*"/>
15330+ </instance-parameter>
15331+ <parameter name="widget" transfer-ownership="none">
15332+ <doc xml:space="preserve"
15333+ filename="src/adw-entry-row.c"
15334+ line="851">a widget</doc>
15335+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
15336+ </parameter>
15337+ </parameters>
15338+ </method>
15339+ <method name="get_activates_default"
15340+ c:identifier="adw_entry_row_get_activates_default"
15341+ glib:get-property="activates-default"
15342+ version="1.2">
15343+ <doc xml:space="preserve"
15344+ filename="src/adw-entry-row.c"
15345+ line="1178">Gets whether activating the embedded entry can activate the default widget.</doc>
15346+ <source-position filename="src/adw-entry-row.h" line="78"/>
15347+ <return-value transfer-ownership="none">
15348+ <doc xml:space="preserve"
15349+ filename="src/adw-entry-row.c"
15350+ line="1184">whether to activate the default widget</doc>
15351+ <type name="gboolean" c:type="gboolean"/>
15352+ </return-value>
15353+ <parameters>
15354+ <instance-parameter name="self" transfer-ownership="none">
15355+ <doc xml:space="preserve"
15356+ filename="src/adw-entry-row.c"
15357+ line="1180">an entry row</doc>
15358+ <type name="EntryRow" c:type="AdwEntryRow*"/>
15359+ </instance-parameter>
15360+ </parameters>
15361+ </method>
15362+ <method name="get_attributes"
15363+ c:identifier="adw_entry_row_get_attributes"
15364+ glib:get-property="attributes"
15365+ version="1.2">
15366+ <doc xml:space="preserve"
15367+ filename="src/adw-entry-row.c"
15368+ line="1073">Gets Pango attributes applied to the text of the embedded entry.</doc>
15369+ <source-position filename="src/adw-entry-row.h" line="72"/>
15370+ <return-value transfer-ownership="full" nullable="1">
15371+ <doc xml:space="preserve"
15372+ filename="src/adw-entry-row.c"
15373+ line="1079">the list of attributes</doc>
15374+ <type name="Pango.AttrList" c:type="PangoAttrList*"/>
15375+ </return-value>
15376+ <parameters>
15377+ <instance-parameter name="self" transfer-ownership="none">
15378+ <doc xml:space="preserve"
15379+ filename="src/adw-entry-row.c"
15380+ line="1075">an entry row</doc>
15381+ <type name="EntryRow" c:type="AdwEntryRow*"/>
15382+ </instance-parameter>
15383+ </parameters>
15384+ </method>
15385+ <method name="get_enable_emoji_completion"
15386+ c:identifier="adw_entry_row_get_enable_emoji_completion"
15387+ glib:get-property="enable-emoji-completion"
15388+ version="1.2">
15389+ <doc xml:space="preserve"
15390+ filename="src/adw-entry-row.c"
15391+ line="1125">Gets whether to suggest emoji replacements on @self.</doc>
15392+ <source-position filename="src/adw-entry-row.h" line="66"/>
15393+ <return-value transfer-ownership="none">
15394+ <doc xml:space="preserve"
15395+ filename="src/adw-entry-row.c"
15396+ line="1131">whether or not emoji completion is enabled</doc>
15397+ <type name="gboolean" c:type="gboolean"/>
15398+ </return-value>
15399+ <parameters>
15400+ <instance-parameter name="self" transfer-ownership="none">
15401+ <doc xml:space="preserve"
15402+ filename="src/adw-entry-row.c"
15403+ line="1127">an entry row</doc>
15404+ <type name="EntryRow" c:type="AdwEntryRow*"/>
15405+ </instance-parameter>
15406+ </parameters>
15407+ </method>
15408+ <method name="get_input_hints"
15409+ c:identifier="adw_entry_row_get_input_hints"
15410+ glib:get-property="input-hints"
15411+ version="1.2">
15412+ <doc xml:space="preserve"
15413+ filename="src/adw-entry-row.c"
15414+ line="969">Gets the additional input hints of @self.</doc>
15415+ <source-position filename="src/adw-entry-row.h" line="54"/>
15416+ <return-value transfer-ownership="none">
15417+ <doc xml:space="preserve"
15418+ filename="src/adw-entry-row.c"
15419+ line="975">The input hints</doc>
15420+ <type name="Gtk.InputHints" c:type="GtkInputHints"/>
15421+ </return-value>
15422+ <parameters>
15423+ <instance-parameter name="self" transfer-ownership="none">
15424+ <doc xml:space="preserve"
15425+ filename="src/adw-entry-row.c"
15426+ line="971">an entry row</doc>
15427+ <type name="EntryRow" c:type="AdwEntryRow*"/>
15428+ </instance-parameter>
15429+ </parameters>
15430+ </method>
15431+ <method name="get_input_purpose"
15432+ c:identifier="adw_entry_row_get_input_purpose"
15433+ glib:get-property="input-purpose"
15434+ version="1.2">
15435+ <doc xml:space="preserve"
15436+ filename="src/adw-entry-row.c"
15437+ line="1022">Gets the input purpose of @self.</doc>
15438+ <source-position filename="src/adw-entry-row.h" line="60"/>
15439+ <return-value transfer-ownership="none">
15440+ <doc xml:space="preserve"
15441+ filename="src/adw-entry-row.c"
15442+ line="1028">the input purpose</doc>
15443+ <type name="Gtk.InputPurpose" c:type="GtkInputPurpose"/>
15444+ </return-value>
15445+ <parameters>
15446+ <instance-parameter name="self" transfer-ownership="none">
15447+ <doc xml:space="preserve"
15448+ filename="src/adw-entry-row.c"
15449+ line="1024">an entry row</doc>
15450+ <type name="EntryRow" c:type="AdwEntryRow*"/>
15451+ </instance-parameter>
15452+ </parameters>
15453+ </method>
15454+ <method name="get_max_length"
15455+ c:identifier="adw_entry_row_get_max_length"
15456+ glib:get-property="max-length"
15457+ version="1.6">
15458+ <doc xml:space="preserve"
15459+ filename="src/adw-entry-row.c"
15460+ line="1317">Retrieves the maximum length of the entry.</doc>
15461+ <source-position filename="src/adw-entry-row.h" line="88"/>
15462+ <return-value transfer-ownership="none">
15463+ <doc xml:space="preserve"
15464+ filename="src/adw-entry-row.c"
15465+ line="1323">The maximum length of the entry.</doc>
15466+ <type name="gint" c:type="int"/>
15467+ </return-value>
15468+ <parameters>
15469+ <instance-parameter name="self" transfer-ownership="none">
15470+ <doc xml:space="preserve"
15471+ filename="src/adw-entry-row.c"
15472+ line="1319">an entry row</doc>
15473+ <type name="EntryRow" c:type="AdwEntryRow*"/>
15474+ </instance-parameter>
15475+ </parameters>
15476+ </method>
15477+ <method name="get_show_apply_button"
15478+ c:identifier="adw_entry_row_get_show_apply_button"
15479+ glib:get-property="show-apply-button"
15480+ version="1.2">
15481+ <doc xml:space="preserve"
15482+ filename="src/adw-entry-row.c"
15483+ line="905">Gets whether @self can show the apply button.</doc>
15484+ <source-position filename="src/adw-entry-row.h" line="48"/>
15485+ <return-value transfer-ownership="none">
15486+ <doc xml:space="preserve"
15487+ filename="src/adw-entry-row.c"
15488+ line="911">whether to show the apply button</doc>
15489+ <type name="gboolean" c:type="gboolean"/>
15490+ </return-value>
15491+ <parameters>
15492+ <instance-parameter name="self" transfer-ownership="none">
15493+ <doc xml:space="preserve"
15494+ filename="src/adw-entry-row.c"
15495+ line="907">an entry row</doc>
15496+ <type name="EntryRow" c:type="AdwEntryRow*"/>
15497+ </instance-parameter>
15498+ </parameters>
15499+ </method>
15500+ <method name="get_text_length"
15501+ c:identifier="adw_entry_row_get_text_length"
15502+ glib:get-property="text-length"
15503+ version="1.5">
15504+ <doc xml:space="preserve"
15505+ filename="src/adw-entry-row.c"
15506+ line="1270">Retrieves the current length of the text in @self.</doc>
15507+ <source-position filename="src/adw-entry-row.h" line="84"/>
15508+ <return-value transfer-ownership="none">
15509+ <doc xml:space="preserve"
15510+ filename="src/adw-entry-row.c"
15511+ line="1276">The current number of characters in @self, or 0 if there are none.</doc>
15512+ <type name="guint" c:type="guint"/>
15513+ </return-value>
15514+ <parameters>
15515+ <instance-parameter name="self" transfer-ownership="none">
15516+ <doc xml:space="preserve"
15517+ filename="src/adw-entry-row.c"
15518+ line="1272">an entry row</doc>
15519+ <type name="EntryRow" c:type="AdwEntryRow*"/>
15520+ </instance-parameter>
15521+ </parameters>
15522+ </method>
15523+ <method name="grab_focus_without_selecting"
15524+ c:identifier="adw_entry_row_grab_focus_without_selecting"
15525+ version="1.3">
15526+ <doc xml:space="preserve"
15527+ filename="src/adw-entry-row.c"
15528+ line="1339">Causes @self to have keyboard focus without selecting the text.
15529+
15530+See [method@Gtk.Text.grab_focus_without_selecting] for more information.</doc>
15531+ <source-position filename="src/adw-entry-row.h" line="95"/>
15532+ <return-value transfer-ownership="none">
15533+ <doc xml:space="preserve"
15534+ filename="src/adw-entry-row.c"
15535+ line="1347">whether the focus is now inside @self</doc>
15536+ <type name="gboolean" c:type="gboolean"/>
15537+ </return-value>
15538+ <parameters>
15539+ <instance-parameter name="self" transfer-ownership="none">
15540+ <doc xml:space="preserve"
15541+ filename="src/adw-entry-row.c"
15542+ line="1341">an entry row</doc>
15543+ <type name="EntryRow" c:type="AdwEntryRow*"/>
15544+ </instance-parameter>
15545+ </parameters>
15546+ </method>
15547+ <method name="remove" c:identifier="adw_entry_row_remove" version="1.2">
15548+ <doc xml:space="preserve"
15549+ filename="src/adw-entry-row.c"
15550+ line="873">Removes a child from @self.</doc>
15551+ <source-position filename="src/adw-entry-row.h" line="44"/>
15552+ <return-value transfer-ownership="none">
15553+ <type name="none" c:type="void"/>
15554+ </return-value>
15555+ <parameters>
15556+ <instance-parameter name="self" transfer-ownership="none">
15557+ <doc xml:space="preserve"
15558+ filename="src/adw-entry-row.c"
15559+ line="875">an entry row</doc>
15560+ <type name="EntryRow" c:type="AdwEntryRow*"/>
15561+ </instance-parameter>
15562+ <parameter name="widget" transfer-ownership="none">
15563+ <doc xml:space="preserve"
15564+ filename="src/adw-entry-row.c"
15565+ line="876">the child to be removed</doc>
15566+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
15567+ </parameter>
15568+ </parameters>
15569+ </method>
15570+ <method name="set_activates_default"
15571+ c:identifier="adw_entry_row_set_activates_default"
15572+ glib:set-property="activates-default"
15573+ version="1.2">
15574+ <doc xml:space="preserve"
15575+ filename="src/adw-entry-row.c"
15576+ line="1200">Sets whether activating the embedded entry can activate the default widget.</doc>
15577+ <source-position filename="src/adw-entry-row.h" line="80"/>
15578+ <return-value transfer-ownership="none">
15579+ <type name="none" c:type="void"/>
15580+ </return-value>
15581+ <parameters>
15582+ <instance-parameter name="self" transfer-ownership="none">
15583+ <doc xml:space="preserve"
15584+ filename="src/adw-entry-row.c"
15585+ line="1202">an entry row</doc>
15586+ <type name="EntryRow" c:type="AdwEntryRow*"/>
15587+ </instance-parameter>
15588+ <parameter name="activates" transfer-ownership="none">
15589+ <doc xml:space="preserve"
15590+ filename="src/adw-entry-row.c"
15591+ line="1203">whether to activate the default widget</doc>
15592+ <type name="gboolean" c:type="gboolean"/>
15593+ </parameter>
15594+ </parameters>
15595+ </method>
15596+ <method name="set_attributes"
15597+ c:identifier="adw_entry_row_set_attributes"
15598+ glib:set-property="attributes"
15599+ version="1.2">
15600+ <doc xml:space="preserve"
15601+ filename="src/adw-entry-row.c"
15602+ line="1095">Sets Pango attributes to apply to the text of the embedded entry.
15603+
15604+The [struct@Pango.Attribute]'s `start_index` and `end_index` must refer to
15605+the [class@Gtk.EntryBuffer] text, i.e. without the preedit string.</doc>
15606+ <source-position filename="src/adw-entry-row.h" line="74"/>
15607+ <return-value transfer-ownership="none">
15608+ <type name="none" c:type="void"/>
15609+ </return-value>
15610+ <parameters>
15611+ <instance-parameter name="self" transfer-ownership="none">
15612+ <doc xml:space="preserve"
15613+ filename="src/adw-entry-row.c"
15614+ line="1097">an entry row</doc>
15615+ <type name="EntryRow" c:type="AdwEntryRow*"/>
15616+ </instance-parameter>
15617+ <parameter name="attributes"
15618+ transfer-ownership="none"
15619+ nullable="1"
15620+ allow-none="1">
15621+ <doc xml:space="preserve"
15622+ filename="src/adw-entry-row.c"
15623+ line="1098">a list of attributes</doc>
15624+ <type name="Pango.AttrList" c:type="PangoAttrList*"/>
15625+ </parameter>
15626+ </parameters>
15627+ </method>
15628+ <method name="set_enable_emoji_completion"
15629+ c:identifier="adw_entry_row_set_enable_emoji_completion"
15630+ glib:set-property="enable-emoji-completion"
15631+ version="1.2">
15632+ <doc xml:space="preserve"
15633+ filename="src/adw-entry-row.c"
15634+ line="1147">Sets whether to suggest emoji replacements on @self.
15635+
15636+Emoji replacement is done with :-delimited names, like `:heart:`.</doc>
15637+ <source-position filename="src/adw-entry-row.h" line="68"/>
15638+ <return-value transfer-ownership="none">
15639+ <type name="none" c:type="void"/>
15640+ </return-value>
15641+ <parameters>
15642+ <instance-parameter name="self" transfer-ownership="none">
15643+ <doc xml:space="preserve"
15644+ filename="src/adw-entry-row.c"
15645+ line="1149">an entry row</doc>
15646+ <type name="EntryRow" c:type="AdwEntryRow*"/>
15647+ </instance-parameter>
15648+ <parameter name="enable_emoji_completion" transfer-ownership="none">
15649+ <doc xml:space="preserve"
15650+ filename="src/adw-entry-row.c"
15651+ line="1150">Whether emoji completion should be enabled or not</doc>
15652+ <type name="gboolean" c:type="gboolean"/>
15653+ </parameter>
15654+ </parameters>
15655+ </method>
15656+ <method name="set_input_hints"
15657+ c:identifier="adw_entry_row_set_input_hints"
15658+ glib:set-property="input-hints"
15659+ version="1.2">
15660+ <doc xml:space="preserve"
15661+ filename="src/adw-entry-row.c"
15662+ line="991">Set additional input hints for @self.
15663+
15664+Input hints allow input methods to fine-tune their behavior.
15665+
15666+See also: [property@AdwEntryRow:input-purpose]</doc>
15667+ <source-position filename="src/adw-entry-row.h" line="56"/>
15668+ <return-value transfer-ownership="none">
15669+ <type name="none" c:type="void"/>
15670+ </return-value>
15671+ <parameters>
15672+ <instance-parameter name="self" transfer-ownership="none">
15673+ <doc xml:space="preserve"
15674+ filename="src/adw-entry-row.c"
15675+ line="993">an entry row</doc>
15676+ <type name="EntryRow" c:type="AdwEntryRow*"/>
15677+ </instance-parameter>
15678+ <parameter name="hints" transfer-ownership="none">
15679+ <doc xml:space="preserve"
15680+ filename="src/adw-entry-row.c"
15681+ line="994">the hints</doc>
15682+ <type name="Gtk.InputHints" c:type="GtkInputHints"/>
15683+ </parameter>
15684+ </parameters>
15685+ </method>
15686+ <method name="set_input_purpose"
15687+ c:identifier="adw_entry_row_set_input_purpose"
15688+ glib:set-property="input-purpose"
15689+ version="1.2">
15690+ <doc xml:space="preserve"
15691+ filename="src/adw-entry-row.c"
15692+ line="1044">Sets the input purpose of @self.
15693+
15694+The input purpose can be used by input methods to adjust their behavior.</doc>
15695+ <source-position filename="src/adw-entry-row.h" line="62"/>
15696+ <return-value transfer-ownership="none">
15697+ <type name="none" c:type="void"/>
15698+ </return-value>
15699+ <parameters>
15700+ <instance-parameter name="self" transfer-ownership="none">
15701+ <doc xml:space="preserve"
15702+ filename="src/adw-entry-row.c"
15703+ line="1046">an entry row</doc>
15704+ <type name="EntryRow" c:type="AdwEntryRow*"/>
15705+ </instance-parameter>
15706+ <parameter name="purpose" transfer-ownership="none">
15707+ <doc xml:space="preserve"
15708+ filename="src/adw-entry-row.c"
15709+ line="1047">the purpose</doc>
15710+ <type name="Gtk.InputPurpose" c:type="GtkInputPurpose"/>
15711+ </parameter>
15712+ </parameters>
15713+ </method>
15714+ <method name="set_max_length"
15715+ c:identifier="adw_entry_row_set_max_length"
15716+ glib:set-property="max-length"
15717+ version="1.6">
15718+ <doc xml:space="preserve"
15719+ filename="src/adw-entry-row.c"
15720+ line="1292">Sets the maximum length of the entry.</doc>
15721+ <source-position filename="src/adw-entry-row.h" line="90"/>
15722+ <return-value transfer-ownership="none">
15723+ <type name="none" c:type="void"/>
15724+ </return-value>
15725+ <parameters>
15726+ <instance-parameter name="self" transfer-ownership="none">
15727+ <doc xml:space="preserve"
15728+ filename="src/adw-entry-row.c"
15729+ line="1294">an entry row</doc>
15730+ <type name="EntryRow" c:type="AdwEntryRow*"/>
15731+ </instance-parameter>
15732+ <parameter name="max_length" transfer-ownership="none">
15733+ <doc xml:space="preserve"
15734+ filename="src/adw-entry-row.c"
15735+ line="1295">maximum length of the entry</doc>
15736+ <type name="gint" c:type="int"/>
15737+ </parameter>
15738+ </parameters>
15739+ </method>
15740+ <method name="set_show_apply_button"
15741+ c:identifier="adw_entry_row_set_show_apply_button"
15742+ glib:set-property="show-apply-button"
15743+ version="1.2">
15744+ <doc xml:space="preserve"
15745+ filename="src/adw-entry-row.c"
15746+ line="927">Sets whether @self can show the apply button.
15747+
15748+When set to `TRUE`, typing text in the entry will reveal an apply button.
15749+Clicking it or pressing the &lt;kbd&gt;Enter&lt;/kbd&gt; key will hide the button and
15750+emit the [signal@EntryRow::apply] signal.
15751+
15752+This is useful if changing the entry contents can trigger an expensive
15753+operation, e.g. network activity, to avoid triggering it after typing every
15754+character.</doc>
15755+ <source-position filename="src/adw-entry-row.h" line="50"/>
15756+ <return-value transfer-ownership="none">
15757+ <type name="none" c:type="void"/>
15758+ </return-value>
15759+ <parameters>
15760+ <instance-parameter name="self" transfer-ownership="none">
15761+ <doc xml:space="preserve"
15762+ filename="src/adw-entry-row.c"
15763+ line="929">an entry row</doc>
15764+ <type name="EntryRow" c:type="AdwEntryRow*"/>
15765+ </instance-parameter>
15766+ <parameter name="show_apply_button" transfer-ownership="none">
15767+ <doc xml:space="preserve"
15768+ filename="src/adw-entry-row.c"
15769+ line="930">whether to show the apply button</doc>
15770+ <type name="gboolean" c:type="gboolean"/>
15771+ </parameter>
15772+ </parameters>
15773+ </method>
15774+ <property name="activates-default"
15775+ version="1.2"
15776+ writable="1"
15777+ transfer-ownership="none"
15778+ setter="set_activates_default"
15779+ getter="get_activates_default"
15780+ default-value="FALSE">
15781+ <doc xml:space="preserve"
15782+ filename="src/adw-entry-row.c"
15783+ line="619">Whether activating the embedded entry can activate the default widget.</doc>
15784+ <type name="gboolean" c:type="gboolean"/>
15785+ </property>
15786+ <property name="attributes"
15787+ version="1.2"
15788+ writable="1"
15789+ transfer-ownership="none"
15790+ setter="set_attributes"
15791+ getter="get_attributes">
15792+ <doc xml:space="preserve"
15793+ filename="src/adw-entry-row.c"
15794+ line="590">A list of Pango attributes to apply to the text of the embedded entry.
15795+
15796+The [struct@Pango.Attribute]'s `start_index` and `end_index` must refer to
15797+the [class@Gtk.EntryBuffer] text, i.e. without the preedit string.</doc>
15798+ <type name="Pango.AttrList"/>
15799+ </property>
15800+ <property name="enable-emoji-completion"
15801+ version="1.2"
15802+ writable="1"
15803+ transfer-ownership="none"
15804+ setter="set_enable_emoji_completion"
15805+ getter="get_enable_emoji_completion"
15806+ default-value="FALSE">
15807+ <doc xml:space="preserve"
15808+ filename="src/adw-entry-row.c"
15809+ line="605">Whether to suggest emoji replacements on the entry row.
15810+
15811+Emoji replacement is done with :-delimited names, like `:heart:`.</doc>
15812+ <type name="gboolean" c:type="gboolean"/>
15813+ </property>
15814+ <property name="input-hints"
15815+ version="1.2"
15816+ writable="1"
15817+ transfer-ownership="none"
15818+ setter="set_input_hints"
15819+ getter="get_input_hints"
15820+ default-value="GTK_INPUT_HINT_NONE">
15821+ <doc xml:space="preserve"
15822+ filename="src/adw-entry-row.c"
15823+ line="558">Additional input hints for the entry row.
15824+
15825+Input hints allow input methods to fine-tune their behavior.
15826+
15827+See also: [property@Adw.EntryRow:input-purpose]</doc>
15828+ <type name="Gtk.InputHints"/>
15829+ </property>
15830+ <property name="input-purpose"
15831+ version="1.2"
15832+ writable="1"
15833+ transfer-ownership="none"
15834+ setter="set_input_purpose"
15835+ getter="get_input_purpose"
15836+ default-value="GTK_INPUT_PURPOSE_FREE_FORM">
15837+ <doc xml:space="preserve"
15838+ filename="src/adw-entry-row.c"
15839+ line="575">The input purpose of the entry row.
15840+
15841+The input purpose can be used by input methods to adjust their behavior.</doc>
15842+ <type name="Gtk.InputPurpose"/>
15843+ </property>
15844+ <property name="max-length"
15845+ version="1.6"
15846+ writable="1"
15847+ transfer-ownership="none"
15848+ setter="set_max_length"
15849+ getter="get_max_length"
15850+ default-value="0">
15851+ <doc xml:space="preserve"
15852+ filename="src/adw-entry-row.c"
15853+ line="643">Maximum number of characters for the entry.</doc>
15854+ <type name="gint" c:type="gint"/>
15855+ </property>
15856+ <property name="show-apply-button"
15857+ version="1.2"
15858+ writable="1"
15859+ transfer-ownership="none"
15860+ setter="set_show_apply_button"
15861+ getter="get_show_apply_button"
15862+ default-value="FALSE">
15863+ <doc xml:space="preserve"
15864+ filename="src/adw-entry-row.c"
15865+ line="538">Whether to show the apply button.
15866+
15867+When set to `TRUE`, typing text in the entry will reveal an apply button.
15868+Clicking it or pressing the &lt;kbd&gt;Enter&lt;/kbd&gt; key will hide the button and
15869+emit the [signal@EntryRow::apply] signal.
15870+
15871+This is useful if changing the entry contents can trigger an expensive
15872+operation, e.g. network activity, to avoid triggering it after typing every
15873+character.</doc>
15874+ <type name="gboolean" c:type="gboolean"/>
15875+ </property>
15876+ <property name="text-length"
15877+ version="1.5"
15878+ transfer-ownership="none"
15879+ getter="get_text_length"
15880+ default-value="0">
15881+ <doc xml:space="preserve"
15882+ filename="src/adw-entry-row.c"
15883+ line="631">The length of the text in the entry row.</doc>
15884+ <type name="guint" c:type="guint"/>
15885+ </property>
15886+ <field name="parent_instance">
15887+ <type name="PreferencesRow" c:type="AdwPreferencesRow"/>
15888+ </field>
15889+ <glib:signal name="apply" when="last" version="1.2">
15890+ <doc xml:space="preserve"
15891+ filename="src/adw-entry-row.c"
15892+ line="660">Emitted when the apply button is pressed.
15893+
15894+See [property@EntryRow:show-apply-button].</doc>
15895+ <return-value transfer-ownership="none">
15896+ <type name="none" c:type="void"/>
15897+ </return-value>
15898+ </glib:signal>
15899+ <glib:signal name="entry-activated" when="last" version="1.2">
15900+ <doc xml:space="preserve"
15901+ filename="src/adw-entry-row.c"
15902+ line="682">Emitted when the embedded entry is activated.</doc>
15903+ <return-value transfer-ownership="none">
15904+ <type name="none" c:type="void"/>
15905+ </return-value>
15906+ </glib:signal>
15907+ </class>
15908+ <record name="EntryRowClass"
15909+ c:type="AdwEntryRowClass"
15910+ glib:is-gtype-struct-for="EntryRow">
15911+ <source-position filename="src/adw-entry-row.h" line="32"/>
15912+ <field name="parent_class">
15913+ <doc xml:space="preserve"
15914+ filename="src/adw-entry-row.h"
15915+ line="27">The parent class</doc>
15916+ <type name="PreferencesRowClass" c:type="AdwPreferencesRowClass"/>
15917+ </field>
15918+ </record>
15919+ <class name="EnumListItem"
15920+ c:symbol-prefix="enum_list_item"
15921+ c:type="AdwEnumListItem"
15922+ parent="GObject.Object"
15923+ final="1"
15924+ glib:type-name="AdwEnumListItem"
15925+ glib:get-type="adw_enum_list_item_get_type"
15926+ glib:type-struct="EnumListItemClass">
15927+ <doc xml:space="preserve"
15928+ filename="src/adw-enum-list-model.c"
15929+ line="45">`AdwEnumListItem` is the type of items in a [class@EnumListModel].</doc>
15930+ <source-position filename="src/adw-enum-list-model.h" line="22"/>
15931+ <method name="get_name"
15932+ c:identifier="adw_enum_list_item_get_name"
15933+ glib:get-property="name">
15934+ <doc xml:space="preserve"
15935+ filename="src/adw-enum-list-model.c"
15936+ line="163">Gets the enum value name.</doc>
15937+ <source-position filename="src/adw-enum-list-model.h" line="28"/>
15938+ <return-value transfer-ownership="none">
15939+ <doc xml:space="preserve"
15940+ filename="src/adw-enum-list-model.c"
15941+ line="168">the enum value name</doc>
15942+ <type name="utf8" c:type="const char*"/>
15943+ </return-value>
15944+ <parameters>
15945+ <instance-parameter name="self" transfer-ownership="none">
15946+ <type name="EnumListItem" c:type="AdwEnumListItem*"/>
15947+ </instance-parameter>
15948+ </parameters>
15949+ </method>
15950+ <method name="get_nick"
15951+ c:identifier="adw_enum_list_item_get_nick"
15952+ glib:get-property="nick">
15953+ <doc xml:space="preserve"
15954+ filename="src/adw-enum-list-model.c"
15955+ line="178">Gets the enum value nick.</doc>
15956+ <source-position filename="src/adw-enum-list-model.h" line="31"/>
15957+ <return-value transfer-ownership="none">
15958+ <doc xml:space="preserve"
15959+ filename="src/adw-enum-list-model.c"
15960+ line="183">the enum value nick</doc>
15961+ <type name="utf8" c:type="const char*"/>
15962+ </return-value>
15963+ <parameters>
15964+ <instance-parameter name="self" transfer-ownership="none">
15965+ <type name="EnumListItem" c:type="AdwEnumListItem*"/>
15966+ </instance-parameter>
15967+ </parameters>
15968+ </method>
15969+ <method name="get_value"
15970+ c:identifier="adw_enum_list_item_get_value"
15971+ glib:get-property="value">
15972+ <doc xml:space="preserve"
15973+ filename="src/adw-enum-list-model.c"
15974+ line="148">Gets the enum value.</doc>
15975+ <source-position filename="src/adw-enum-list-model.h" line="25"/>
15976+ <return-value transfer-ownership="none">
15977+ <doc xml:space="preserve"
15978+ filename="src/adw-enum-list-model.c"
15979+ line="153">the enum value</doc>
15980+ <type name="gint" c:type="int"/>
15981+ </return-value>
15982+ <parameters>
15983+ <instance-parameter name="self" transfer-ownership="none">
15984+ <type name="EnumListItem" c:type="AdwEnumListItem*"/>
15985+ </instance-parameter>
15986+ </parameters>
15987+ </method>
15988+ <property name="name"
15989+ transfer-ownership="none"
15990+ getter="get_name"
15991+ default-value="NULL">
15992+ <doc xml:space="preserve"
15993+ filename="src/adw-enum-list-model.c"
15994+ line="110">The enum value name.</doc>
15995+ <type name="utf8" c:type="gchar*"/>
15996+ </property>
15997+ <property name="nick"
15998+ transfer-ownership="none"
15999+ getter="get_nick"
16000+ default-value="NULL">
16001+ <doc xml:space="preserve"
16002+ filename="src/adw-enum-list-model.c"
16003+ line="120">The enum value nick.</doc>
16004+ <type name="utf8" c:type="gchar*"/>
16005+ </property>
16006+ <property name="value"
16007+ transfer-ownership="none"
16008+ getter="get_value"
16009+ default-value="0">
16010+ <doc xml:space="preserve"
16011+ filename="src/adw-enum-list-model.c"
16012+ line="100">The enum value.</doc>
16013+ <type name="gint" c:type="gint"/>
16014+ </property>
16015+ </class>
16016+ <record name="EnumListItemClass"
16017+ c:type="AdwEnumListItemClass"
16018+ glib:is-gtype-struct-for="EnumListItem">
16019+ <source-position filename="src/adw-enum-list-model.h" line="22"/>
16020+ <field name="parent_class">
16021+ <type name="GObject.ObjectClass" c:type="GObjectClass"/>
16022+ </field>
16023+ </record>
16024+ <class name="EnumListModel"
16025+ c:symbol-prefix="enum_list_model"
16026+ c:type="AdwEnumListModel"
16027+ parent="GObject.Object"
16028+ final="1"
16029+ glib:type-name="AdwEnumListModel"
16030+ glib:get-type="adw_enum_list_model_get_type"
16031+ glib:type-struct="EnumListModelClass">
16032+ <doc xml:space="preserve"
16033+ filename="src/adw-enum-list-model.c"
16034+ line="14">A [iface@Gio.ListModel] representing values of a given enum.
16035+
16036+`AdwEnumListModel` contains objects of type [class@EnumListItem].</doc>
16037+ <source-position filename="src/adw-enum-list-model.h" line="36"/>
16038+ <implements name="Gio.ListModel"/>
16039+ <constructor name="new" c:identifier="adw_enum_list_model_new">
16040+ <doc xml:space="preserve"
16041+ filename="src/adw-enum-list-model.c"
16042+ line="321">Creates a new `AdwEnumListModel` for @enum_type.</doc>
16043+ <source-position filename="src/adw-enum-list-model.h" line="39"/>
16044+ <return-value transfer-ownership="full">
16045+ <doc xml:space="preserve"
16046+ filename="src/adw-enum-list-model.c"
16047+ line="327">the newly created `AdwEnumListModel`</doc>
16048+ <type name="EnumListModel" c:type="AdwEnumListModel*"/>
16049+ </return-value>
16050+ <parameters>
16051+ <parameter name="enum_type" transfer-ownership="none">
16052+ <doc xml:space="preserve"
16053+ filename="src/adw-enum-list-model.c"
16054+ line="323">the type of the enum to construct the model from</doc>
16055+ <type name="GType" c:type="GType"/>
16056+ </parameter>
16057+ </parameters>
16058+ </constructor>
16059+ <method name="find_position"
16060+ c:identifier="adw_enum_list_model_find_position">
16061+ <doc xml:space="preserve"
16062+ filename="src/adw-enum-list-model.c"
16063+ line="352">Finds the position of a given enum value in @self.
16064+
16065+If the value is not found, `GTK_INVALID_LIST_POSITION` is returned.</doc>
16066+ <source-position filename="src/adw-enum-list-model.h" line="45"/>
16067+ <return-value transfer-ownership="none">
16068+ <doc xml:space="preserve"
16069+ filename="src/adw-enum-list-model.c"
16070+ line="360">the position of the value</doc>
16071+ <type name="guint" c:type="guint"/>
16072+ </return-value>
16073+ <parameters>
16074+ <instance-parameter name="self" transfer-ownership="none">
16075+ <type name="EnumListModel" c:type="AdwEnumListModel*"/>
16076+ </instance-parameter>
16077+ <parameter name="value" transfer-ownership="none">
16078+ <doc xml:space="preserve"
16079+ filename="src/adw-enum-list-model.c"
16080+ line="354">an enum value</doc>
16081+ <type name="gint" c:type="int"/>
16082+ </parameter>
16083+ </parameters>
16084+ </method>
16085+ <method name="get_enum_type"
16086+ c:identifier="adw_enum_list_model_get_enum_type"
16087+ glib:get-property="enum-type">
16088+ <doc xml:space="preserve"
16089+ filename="src/adw-enum-list-model.c"
16090+ line="337">Gets the type of the enum represented by @self.</doc>
16091+ <source-position filename="src/adw-enum-list-model.h" line="42"/>
16092+ <return-value transfer-ownership="none">
16093+ <doc xml:space="preserve"
16094+ filename="src/adw-enum-list-model.c"
16095+ line="342">the enum type</doc>
16096+ <type name="GType" c:type="GType"/>
16097+ </return-value>
16098+ <parameters>
16099+ <instance-parameter name="self" transfer-ownership="none">
16100+ <type name="EnumListModel" c:type="AdwEnumListModel*"/>
16101+ </instance-parameter>
16102+ </parameters>
16103+ </method>
16104+ <property name="enum-type"
16105+ writable="1"
16106+ construct-only="1"
16107+ transfer-ownership="none"
16108+ getter="get_enum_type">
16109+ <doc xml:space="preserve"
16110+ filename="src/adw-enum-list-model.c"
16111+ line="269">The type of the enum represented by the model.</doc>
16112+ <type name="GType" c:type="GType"/>
16113+ </property>
16114+ </class>
16115+ <record name="EnumListModelClass"
16116+ c:type="AdwEnumListModelClass"
16117+ glib:is-gtype-struct-for="EnumListModel">
16118+ <source-position filename="src/adw-enum-list-model.h" line="36"/>
16119+ <field name="parent_class">
16120+ <type name="GObject.ObjectClass" c:type="GObjectClass"/>
16121+ </field>
16122+ </record>
16123+ <class name="ExpanderRow"
16124+ c:symbol-prefix="expander_row"
16125+ c:type="AdwExpanderRow"
16126+ parent="PreferencesRow"
16127+ glib:type-name="AdwExpanderRow"
16128+ glib:get-type="adw_expander_row_get_type"
16129+ glib:type-struct="ExpanderRowClass">
16130+ <doc xml:space="preserve"
16131+ filename="src/adw-expander-row.c"
16132+ line="13">A [class@Gtk.ListBoxRow] used to reveal widgets.
16133+
16134+&lt;picture&gt;
16135+ &lt;source srcset="expander-row-dark.png" media="(prefers-color-scheme: dark)"&gt;
16136+ &lt;img src="expander-row.png" alt="expander-row"&gt;
16137+&lt;/picture&gt;
16138+
16139+The `AdwExpanderRow` widget allows the user to reveal or hide widgets below
16140+it. It also allows the user to enable the expansion of the row, allowing to
16141+disable all that the row contains.
16142+
16143+## AdwExpanderRow as GtkBuildable
16144+
16145+The `AdwExpanderRow` implementation of the [iface@Gtk.Buildable] interface
16146+supports adding a child as an suffix widget by specifying “suffix” as the
16147+“type” attribute of a &lt;child&gt; element.
16148+
16149+It also supports adding it as a prefix widget by specifying “prefix” as the
16150+“type” attribute of a &lt;child&gt; element.
16151+
16152+## CSS nodes
16153+
16154+`AdwExpanderRow` has a main CSS node with name `row` and the `.expander`
16155+style class. It has the `.empty` style class when it contains no children.
16156+
16157+It contains the subnodes `row.header` for its main embedded row,
16158+`list.nested` for the list it can expand, and `image.expander-row-arrow` for
16159+its arrow.
16160+
16161+## Style classes
16162+
16163+`AdwExpanderRow` can use the [`.`](style-classes.html#property-rows)
16164+style class to emphasize the row subtitle instead of the row title, which is
16165+useful for displaying read-only properties.
16166+
16167+When used together with the `.monospace` style class, only the subtitle
16168+becomes monospace, not the title or any extra widgets.</doc>
16169+ <source-position filename="src/adw-expander-row.h" line="35"/>
16170+ <implements name="Gtk.Accessible"/>
16171+ <implements name="Gtk.Actionable"/>
16172+ <implements name="Gtk.Buildable"/>
16173+ <implements name="Gtk.ConstraintTarget"/>
16174+ <constructor name="new" c:identifier="adw_expander_row_new">
16175+ <doc xml:space="preserve"
16176+ filename="src/adw-expander-row.c"
16177+ line="359">Creates a new `AdwExpanderRow`.</doc>
16178+ <source-position filename="src/adw-expander-row.h" line="38"/>
16179+ <return-value transfer-ownership="none">
16180+ <doc xml:space="preserve"
16181+ filename="src/adw-expander-row.c"
16182+ line="364">the newly created `AdwExpanderRow`</doc>
16183+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
16184+ </return-value>
16185+ </constructor>
16186+ <method name="add_action"
16187+ c:identifier="adw_expander_row_add_action"
16188+ deprecated="1"
16189+ deprecated-version="1.4">
16190+ <doc xml:space="preserve"
16191+ filename="src/adw-expander-row.c"
16192+ line="372">Adds an action widget to @self.</doc>
16193+ <doc-deprecated xml:space="preserve">Use [method@ExpanderRow.add_suffix] to add a suffix.</doc-deprecated>
16194+ <source-position filename="src/adw-expander-row.h" line="41"/>
16195+ <return-value transfer-ownership="none">
16196+ <type name="none" c:type="void"/>
16197+ </return-value>
16198+ <parameters>
16199+ <instance-parameter name="self" transfer-ownership="none">
16200+ <doc xml:space="preserve"
16201+ filename="src/adw-expander-row.c"
16202+ line="374">an expander row</doc>
16203+ <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
16204+ </instance-parameter>
16205+ <parameter name="widget" transfer-ownership="none">
16206+ <doc xml:space="preserve"
16207+ filename="src/adw-expander-row.c"
16208+ line="375">a widget</doc>
16209+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
16210+ </parameter>
16211+ </parameters>
16212+ </method>
16213+ <method name="add_prefix" c:identifier="adw_expander_row_add_prefix">
16214+ <doc xml:space="preserve"
16215+ filename="src/adw-expander-row.c"
16216+ line="397">Adds a prefix widget to @self.</doc>
16217+ <source-position filename="src/adw-expander-row.h" line="44"/>
16218+ <return-value transfer-ownership="none">
16219+ <type name="none" c:type="void"/>
16220+ </return-value>
16221+ <parameters>
16222+ <instance-parameter name="self" transfer-ownership="none">
16223+ <doc xml:space="preserve"
16224+ filename="src/adw-expander-row.c"
16225+ line="399">an expander row</doc>
16226+ <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
16227+ </instance-parameter>
16228+ <parameter name="widget" transfer-ownership="none">
16229+ <doc xml:space="preserve"
16230+ filename="src/adw-expander-row.c"
16231+ line="400">a widget</doc>
16232+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
16233+ </parameter>
16234+ </parameters>
16235+ </method>
16236+ <method name="add_row" c:identifier="adw_expander_row_add_row">
16237+ <doc xml:space="preserve"
16238+ filename="src/adw-expander-row.c"
16239+ line="448">Adds a widget to @self.
16240+
16241+The widget will appear in the expanding list below @self.</doc>
16242+ <source-position filename="src/adw-expander-row.h" line="51"/>
16243+ <return-value transfer-ownership="none">
16244+ <type name="none" c:type="void"/>
16245+ </return-value>
16246+ <parameters>
16247+ <instance-parameter name="self" transfer-ownership="none">
16248+ <doc xml:space="preserve"
16249+ filename="src/adw-expander-row.c"
16250+ line="450">an expander row</doc>
16251+ <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
16252+ </instance-parameter>
16253+ <parameter name="child" transfer-ownership="none">
16254+ <doc xml:space="preserve"
16255+ filename="src/adw-expander-row.c"
16256+ line="451">a widget</doc>
16257+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
16258+ </parameter>
16259+ </parameters>
16260+ </method>
16261+ <method name="add_suffix"
16262+ c:identifier="adw_expander_row_add_suffix"
16263+ version="1.4">
16264+ <doc xml:space="preserve"
16265+ filename="src/adw-expander-row.c"
16266+ line="423">Adds an suffix widget to @self.</doc>
16267+ <source-position filename="src/adw-expander-row.h" line="47"/>
16268+ <return-value transfer-ownership="none">
16269+ <type name="none" c:type="void"/>
16270+ </return-value>
16271+ <parameters>
16272+ <instance-parameter name="self" transfer-ownership="none">
16273+ <doc xml:space="preserve"
16274+ filename="src/adw-expander-row.c"
16275+ line="425">an expander row</doc>
16276+ <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
16277+ </instance-parameter>
16278+ <parameter name="widget" transfer-ownership="none">
16279+ <doc xml:space="preserve"
16280+ filename="src/adw-expander-row.c"
16281+ line="426">a widget</doc>
16282+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
16283+ </parameter>
16284+ </parameters>
16285+ </method>
16286+ <method name="get_enable_expansion"
16287+ c:identifier="adw_expander_row_get_enable_expansion"
16288+ glib:get-property="enable-expansion">
16289+ <doc xml:space="preserve"
16290+ filename="src/adw-expander-row.c"
16291+ line="657">Gets whether the expansion of @self is enabled.</doc>
16292+ <source-position filename="src/adw-expander-row.h" line="76"/>
16293+ <return-value transfer-ownership="none">
16294+ <doc xml:space="preserve"
16295+ filename="src/adw-expander-row.c"
16296+ line="663">whether the expansion of @self is enabled.</doc>
16297+ <type name="gboolean" c:type="gboolean"/>
16298+ </return-value>
16299+ <parameters>
16300+ <instance-parameter name="self" transfer-ownership="none">
16301+ <doc xml:space="preserve"
16302+ filename="src/adw-expander-row.c"
16303+ line="659">an expander row</doc>
16304+ <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
16305+ </instance-parameter>
16306+ </parameters>
16307+ </method>
16308+ <method name="get_expanded"
16309+ c:identifier="adw_expander_row_get_expanded"
16310+ glib:get-property="expanded">
16311+ <doc xml:space="preserve"
16312+ filename="src/adw-expander-row.c"
16313+ line="601">Gets whether @self is expanded.</doc>
16314+ <source-position filename="src/adw-expander-row.h" line="70"/>
16315+ <return-value transfer-ownership="none">
16316+ <doc xml:space="preserve"
16317+ filename="src/adw-expander-row.c"
16318+ line="607">whether @self is expanded</doc>
16319+ <type name="gboolean" c:type="gboolean"/>
16320+ </return-value>
16321+ <parameters>
16322+ <instance-parameter name="self" transfer-ownership="none">
16323+ <doc xml:space="preserve"
16324+ filename="src/adw-expander-row.c"
16325+ line="603">an expander row</doc>
16326+ <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
16327+ </instance-parameter>
16328+ </parameters>
16329+ </method>
16330+ <method name="get_icon_name"
16331+ c:identifier="adw_expander_row_get_icon_name"
16332+ glib:get-property="icon-name"
16333+ deprecated="1"
16334+ deprecated-version="1.3">
16335+ <doc xml:space="preserve"
16336+ filename="src/adw-expander-row.c"
16337+ line="557">Gets the icon name for @self.</doc>
16338+ <doc-deprecated xml:space="preserve">Use [method@ExpanderRow.add_prefix] to add an icon.</doc-deprecated>
16339+ <source-position filename="src/adw-expander-row.h" line="64"/>
16340+ <return-value transfer-ownership="none" nullable="1">
16341+ <doc xml:space="preserve"
16342+ filename="src/adw-expander-row.c"
16343+ line="563">the icon name for @self</doc>
16344+ <type name="utf8" c:type="const char*"/>
16345+ </return-value>
16346+ <parameters>
16347+ <instance-parameter name="self" transfer-ownership="none">
16348+ <doc xml:space="preserve"
16349+ filename="src/adw-expander-row.c"
16350+ line="559">an expander row</doc>
16351+ <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
16352+ </instance-parameter>
16353+ </parameters>
16354+ </method>
16355+ <method name="get_show_enable_switch"
16356+ c:identifier="adw_expander_row_get_show_enable_switch"
16357+ glib:get-property="show-enable-switch">
16358+ <doc xml:space="preserve"
16359+ filename="src/adw-expander-row.c"
16360+ line="706">Gets whether the switch enabling the expansion of @self is visible.</doc>
16361+ <source-position filename="src/adw-expander-row.h" line="82"/>
16362+ <return-value transfer-ownership="none">
16363+ <doc xml:space="preserve"
16364+ filename="src/adw-expander-row.c"
16365+ line="712">whether the switch enabling the expansion is visible</doc>
16366+ <type name="gboolean" c:type="gboolean"/>
16367+ </return-value>
16368+ <parameters>
16369+ <instance-parameter name="self" transfer-ownership="none">
16370+ <doc xml:space="preserve"
16371+ filename="src/adw-expander-row.c"
16372+ line="708">an expander row</doc>
16373+ <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
16374+ </instance-parameter>
16375+ </parameters>
16376+ </method>
16377+ <method name="get_subtitle"
16378+ c:identifier="adw_expander_row_get_subtitle"
16379+ glib:get-property="subtitle">
16380+ <doc xml:space="preserve"
16381+ filename="src/adw-expander-row.c"
16382+ line="514">Gets the subtitle for @self.</doc>
16383+ <source-position filename="src/adw-expander-row.h" line="58"/>
16384+ <return-value transfer-ownership="none">
16385+ <doc xml:space="preserve"
16386+ filename="src/adw-expander-row.c"
16387+ line="520">the subtitle for @self</doc>
16388+ <type name="utf8" c:type="const char*"/>
16389+ </return-value>
16390+ <parameters>
16391+ <instance-parameter name="self" transfer-ownership="none">
16392+ <doc xml:space="preserve"
16393+ filename="src/adw-expander-row.c"
16394+ line="516">an expander row</doc>
16395+ <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
16396+ </instance-parameter>
16397+ </parameters>
16398+ </method>
16399+ <method name="get_subtitle_lines"
16400+ c:identifier="adw_expander_row_get_subtitle_lines"
16401+ glib:get-property="subtitle-lines"
16402+ version="1.3">
16403+ <doc xml:space="preserve"
16404+ filename="src/adw-expander-row.c"
16405+ line="802">Gets the number of lines at the end of which the subtitle label will be
16406+ellipsized.</doc>
16407+ <source-position filename="src/adw-expander-row.h" line="94"/>
16408+ <return-value transfer-ownership="none">
16409+ <doc xml:space="preserve"
16410+ filename="src/adw-expander-row.c"
16411+ line="809">the number of lines at the end of which the subtitle label will be
16412+ ellipsized</doc>
16413+ <type name="gint" c:type="int"/>
16414+ </return-value>
16415+ <parameters>
16416+ <instance-parameter name="self" transfer-ownership="none">
16417+ <doc xml:space="preserve"
16418+ filename="src/adw-expander-row.c"
16419+ line="804">an expander row</doc>
16420+ <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
16421+ </instance-parameter>
16422+ </parameters>
16423+ </method>
16424+ <method name="get_title_lines"
16425+ c:identifier="adw_expander_row_get_title_lines"
16426+ glib:get-property="title-lines"
16427+ version="1.3">
16428+ <doc xml:space="preserve"
16429+ filename="src/adw-expander-row.c"
16430+ line="753">Gets the number of lines at the end of which the title label will be
16431+ellipsized.</doc>
16432+ <source-position filename="src/adw-expander-row.h" line="88"/>
16433+ <return-value transfer-ownership="none">
16434+ <doc xml:space="preserve"
16435+ filename="src/adw-expander-row.c"
16436+ line="760">the number of lines at the end of which the title label will be
16437+ ellipsized</doc>
16438+ <type name="gint" c:type="int"/>
16439+ </return-value>
16440+ <parameters>
16441+ <instance-parameter name="self" transfer-ownership="none">
16442+ <doc xml:space="preserve"
16443+ filename="src/adw-expander-row.c"
16444+ line="755">an expander row</doc>
16445+ <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
16446+ </instance-parameter>
16447+ </parameters>
16448+ </method>
16449+ <method name="remove" c:identifier="adw_expander_row_remove">
16450+ <doc xml:space="preserve"
16451+ filename="src/adw-expander-row.c"
16452+ line="477">Removes a child from @self.</doc>
16453+ <source-position filename="src/adw-expander-row.h" line="54"/>
16454+ <return-value transfer-ownership="none">
16455+ <type name="none" c:type="void"/>
16456+ </return-value>
16457+ <parameters>
16458+ <instance-parameter name="self" transfer-ownership="none">
16459+ <doc xml:space="preserve"
16460+ filename="src/adw-expander-row.c"
16461+ line="479">an expander row</doc>
16462+ <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
16463+ </instance-parameter>
16464+ <parameter name="child" transfer-ownership="none">
16465+ <doc xml:space="preserve"
16466+ filename="src/adw-expander-row.c"
16467+ line="480">the child to be removed</doc>
16468+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
16469+ </parameter>
16470+ </parameters>
16471+ </method>
16472+ <method name="set_enable_expansion"
16473+ c:identifier="adw_expander_row_set_enable_expansion"
16474+ glib:set-property="enable-expansion">
16475+ <doc xml:space="preserve"
16476+ filename="src/adw-expander-row.c"
16477+ line="677">Sets whether the expansion of @self is enabled.</doc>
16478+ <source-position filename="src/adw-expander-row.h" line="78"/>
16479+ <return-value transfer-ownership="none">
16480+ <type name="none" c:type="void"/>
16481+ </return-value>
16482+ <parameters>
16483+ <instance-parameter name="self" transfer-ownership="none">
16484+ <doc xml:space="preserve"
16485+ filename="src/adw-expander-row.c"
16486+ line="679">an expander row</doc>
16487+ <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
16488+ </instance-parameter>
16489+ <parameter name="enable_expansion" transfer-ownership="none">
16490+ <doc xml:space="preserve"
16491+ filename="src/adw-expander-row.c"
16492+ line="680">whether to enable the expansion</doc>
16493+ <type name="gboolean" c:type="gboolean"/>
16494+ </parameter>
16495+ </parameters>
16496+ </method>
16497+ <method name="set_expanded"
16498+ c:identifier="adw_expander_row_set_expanded"
16499+ glib:set-property="expanded">
16500+ <doc xml:space="preserve"
16501+ filename="src/adw-expander-row.c"
16502+ line="621">Sets whether @self is expanded.</doc>
16503+ <source-position filename="src/adw-expander-row.h" line="72"/>
16504+ <return-value transfer-ownership="none">
16505+ <type name="none" c:type="void"/>
16506+ </return-value>
16507+ <parameters>
16508+ <instance-parameter name="self" transfer-ownership="none">
16509+ <doc xml:space="preserve"
16510+ filename="src/adw-expander-row.c"
16511+ line="623">an expander row</doc>
16512+ <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
16513+ </instance-parameter>
16514+ <parameter name="expanded" transfer-ownership="none">
16515+ <doc xml:space="preserve"
16516+ filename="src/adw-expander-row.c"
16517+ line="624">whether to expand the row</doc>
16518+ <type name="gboolean" c:type="gboolean"/>
16519+ </parameter>
16520+ </parameters>
16521+ </method>
16522+ <method name="set_icon_name"
16523+ c:identifier="adw_expander_row_set_icon_name"
16524+ glib:set-property="icon-name"
16525+ deprecated="1"
16526+ deprecated-version="1.3">
16527+ <doc xml:space="preserve"
16528+ filename="src/adw-expander-row.c"
16529+ line="579">Sets the icon name for @self.</doc>
16530+ <doc-deprecated xml:space="preserve">Use [method@ExpanderRow.add_prefix] to add an icon.</doc-deprecated>
16531+ <source-position filename="src/adw-expander-row.h" line="66"/>
16532+ <return-value transfer-ownership="none">
16533+ <type name="none" c:type="void"/>
16534+ </return-value>
16535+ <parameters>
16536+ <instance-parameter name="self" transfer-ownership="none">
16537+ <doc xml:space="preserve"
16538+ filename="src/adw-expander-row.c"
16539+ line="581">an expander row</doc>
16540+ <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
16541+ </instance-parameter>
16542+ <parameter name="icon_name"
16543+ transfer-ownership="none"
16544+ nullable="1"
16545+ allow-none="1">
16546+ <doc xml:space="preserve"
16547+ filename="src/adw-expander-row.c"
16548+ line="582">the icon name</doc>
16549+ <type name="utf8" c:type="const char*"/>
16550+ </parameter>
16551+ </parameters>
16552+ </method>
16553+ <method name="set_show_enable_switch"
16554+ c:identifier="adw_expander_row_set_show_enable_switch"
16555+ glib:set-property="show-enable-switch">
16556+ <doc xml:space="preserve"
16557+ filename="src/adw-expander-row.c"
16558+ line="726">Sets whether the switch enabling the expansion of @self is visible.</doc>
16559+ <source-position filename="src/adw-expander-row.h" line="84"/>
16560+ <return-value transfer-ownership="none">
16561+ <type name="none" c:type="void"/>
16562+ </return-value>
16563+ <parameters>
16564+ <instance-parameter name="self" transfer-ownership="none">
16565+ <doc xml:space="preserve"
16566+ filename="src/adw-expander-row.c"
16567+ line="728">an expander row</doc>
16568+ <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
16569+ </instance-parameter>
16570+ <parameter name="show_enable_switch" transfer-ownership="none">
16571+ <doc xml:space="preserve"
16572+ filename="src/adw-expander-row.c"
16573+ line="729">whether to show the switch enabling the expansion</doc>
16574+ <type name="gboolean" c:type="gboolean"/>
16575+ </parameter>
16576+ </parameters>
16577+ </method>
16578+ <method name="set_subtitle"
16579+ c:identifier="adw_expander_row_set_subtitle"
16580+ glib:set-property="subtitle">
16581+ <doc xml:space="preserve"
16582+ filename="src/adw-expander-row.c"
16583+ line="534">Sets the subtitle for @self.
16584+
16585+The subtitle is interpreted as Pango markup unless
16586+[property@PreferencesRow:use-markup] is set to `FALSE`.</doc>
16587+ <source-position filename="src/adw-expander-row.h" line="60"/>
16588+ <return-value transfer-ownership="none">
16589+ <type name="none" c:type="void"/>
16590+ </return-value>
16591+ <parameters>
16592+ <instance-parameter name="self" transfer-ownership="none">
16593+ <doc xml:space="preserve"
16594+ filename="src/adw-expander-row.c"
16595+ line="536">an expander row</doc>
16596+ <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
16597+ </instance-parameter>
16598+ <parameter name="subtitle" transfer-ownership="none">
16599+ <doc xml:space="preserve"
16600+ filename="src/adw-expander-row.c"
16601+ line="537">the subtitle</doc>
16602+ <type name="utf8" c:type="const char*"/>
16603+ </parameter>
16604+ </parameters>
16605+ </method>
16606+ <method name="set_subtitle_lines"
16607+ c:identifier="adw_expander_row_set_subtitle_lines"
16608+ glib:set-property="subtitle-lines"
16609+ version="1.3">
16610+ <doc xml:space="preserve"
16611+ filename="src/adw-expander-row.c"
16612+ line="826">Sets the number of lines at the end of which the subtitle label will be
16613+ellipsized.
16614+
16615+If the value is 0, the number of lines won't be limited.</doc>
16616+ <source-position filename="src/adw-expander-row.h" line="96"/>
16617+ <return-value transfer-ownership="none">
16618+ <type name="none" c:type="void"/>
16619+ </return-value>
16620+ <parameters>
16621+ <instance-parameter name="self" transfer-ownership="none">
16622+ <doc xml:space="preserve"
16623+ filename="src/adw-expander-row.c"
16624+ line="828">an expander row</doc>
16625+ <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
16626+ </instance-parameter>
16627+ <parameter name="subtitle_lines" transfer-ownership="none">
16628+ <doc xml:space="preserve"
16629+ filename="src/adw-expander-row.c"
16630+ line="829">the number of lines at the end of which the subtitle label will be ellipsized</doc>
16631+ <type name="gint" c:type="int"/>
16632+ </parameter>
16633+ </parameters>
16634+ </method>
16635+ <method name="set_title_lines"
16636+ c:identifier="adw_expander_row_set_title_lines"
16637+ glib:set-property="title-lines"
16638+ version="1.3">
16639+ <doc xml:space="preserve"
16640+ filename="src/adw-expander-row.c"
16641+ line="777">Sets the number of lines at the end of which the title label will be
16642+ellipsized.
16643+
16644+If the value is 0, the number of lines won't be limited.</doc>
16645+ <source-position filename="src/adw-expander-row.h" line="90"/>
16646+ <return-value transfer-ownership="none">
16647+ <type name="none" c:type="void"/>
16648+ </return-value>
16649+ <parameters>
16650+ <instance-parameter name="self" transfer-ownership="none">
16651+ <doc xml:space="preserve"
16652+ filename="src/adw-expander-row.c"
16653+ line="779">an expander row</doc>
16654+ <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
16655+ </instance-parameter>
16656+ <parameter name="title_lines" transfer-ownership="none">
16657+ <doc xml:space="preserve"
16658+ filename="src/adw-expander-row.c"
16659+ line="780">the number of lines at the end of which the title label will be ellipsized</doc>
16660+ <type name="gint" c:type="int"/>
16661+ </parameter>
16662+ </parameters>
16663+ </method>
16664+ <property name="enable-expansion"
16665+ writable="1"
16666+ transfer-ownership="none"
16667+ setter="set_enable_expansion"
16668+ getter="get_enable_expansion"
16669+ default-value="TRUE">
16670+ <doc xml:space="preserve"
16671+ filename="src/adw-expander-row.c"
16672+ line="234">Whether expansion is enabled.</doc>
16673+ <type name="gboolean" c:type="gboolean"/>
16674+ </property>
16675+ <property name="expanded"
16676+ writable="1"
16677+ transfer-ownership="none"
16678+ setter="set_expanded"
16679+ getter="get_expanded"
16680+ default-value="FALSE">
16681+ <doc xml:space="preserve"
16682+ filename="src/adw-expander-row.c"
16683+ line="224">Whether the row is expanded.</doc>
16684+ <type name="gboolean" c:type="gboolean"/>
16685+ </property>
16686+ <property name="icon-name"
16687+ deprecated="1"
16688+ deprecated-version="1.3"
16689+ writable="1"
16690+ transfer-ownership="none"
16691+ setter="set_icon_name"
16692+ getter="get_icon_name">
16693+ <doc xml:space="preserve"
16694+ filename="src/adw-expander-row.c"
16695+ line="212">The icon name for this row.</doc>
16696+ <doc-deprecated xml:space="preserve">Use [method@ExpanderRow.add_prefix] to add an icon.</doc-deprecated>
16697+ <type name="utf8" c:type="gchar*"/>
16698+ </property>
16699+ <property name="show-enable-switch"
16700+ writable="1"
16701+ transfer-ownership="none"
16702+ setter="set_show_enable_switch"
16703+ getter="get_show_enable_switch"
16704+ default-value="FALSE">
16705+ <doc xml:space="preserve"
16706+ filename="src/adw-expander-row.c"
16707+ line="244">Whether the switch enabling the expansion is visible.</doc>
16708+ <type name="gboolean" c:type="gboolean"/>
16709+ </property>
16710+ <property name="subtitle"
16711+ writable="1"
16712+ transfer-ownership="none"
16713+ setter="set_subtitle"
16714+ getter="get_subtitle">
16715+ <doc xml:space="preserve"
16716+ filename="src/adw-expander-row.c"
16717+ line="199">The subtitle for this row.
16718+
16719+The subtitle is interpreted as Pango markup unless
16720+[property@PreferencesRow:use-markup] is set to `FALSE`.</doc>
16721+ <type name="utf8" c:type="gchar*"/>
16722+ </property>
16723+ <property name="subtitle-lines"
16724+ version="1.3"
16725+ writable="1"
16726+ transfer-ownership="none"
16727+ setter="set_subtitle_lines"
16728+ getter="get_subtitle_lines"
16729+ default-value="0">
16730+ <doc xml:space="preserve"
16731+ filename="src/adw-expander-row.c"
16732+ line="269">The number of lines at the end of which the subtitle label will be
16733+ellipsized.
16734+
16735+If the value is 0, the number of lines won't be limited.</doc>
16736+ <type name="gint" c:type="gint"/>
16737+ </property>
16738+ <property name="title-lines"
16739+ version="1.3"
16740+ writable="1"
16741+ transfer-ownership="none"
16742+ setter="set_title_lines"
16743+ getter="get_title_lines"
16744+ default-value="0">
16745+ <doc xml:space="preserve"
16746+ filename="src/adw-expander-row.c"
16747+ line="254">The number of lines at the end of which the title label will be ellipsized.
16748+
16749+If the value is 0, the number of lines won't be limited.</doc>
16750+ <type name="gint" c:type="gint"/>
16751+ </property>
16752+ <field name="parent_instance">
16753+ <type name="PreferencesRow" c:type="AdwPreferencesRow"/>
16754+ </field>
16755+ </class>
16756+ <record name="ExpanderRowClass"
16757+ c:type="AdwExpanderRowClass"
16758+ glib:is-gtype-struct-for="ExpanderRow">
16759+ <source-position filename="src/adw-expander-row.h" line="35"/>
16760+ <field name="parent_class">
16761+ <doc xml:space="preserve"
16762+ filename="src/adw-expander-row.h"
16763+ line="27">The parent class</doc>
16764+ <type name="PreferencesRowClass" c:type="AdwPreferencesRowClass"/>
16765+ </field>
16766+ <field name="padding" readable="0" private="1">
16767+ <array zero-terminated="0" fixed-size="4">
16768+ <type name="gpointer" c:type="gpointer"/>
16769+ </array>
16770+ </field>
16771+ </record>
16772+ <class name="Flap"
16773+ c:symbol-prefix="flap"
16774+ c:type="AdwFlap"
16775+ deprecated="1"
16776+ deprecated-version="1.4"
16777+ parent="Gtk.Widget"
16778+ final="1"
16779+ glib:type-name="AdwFlap"
16780+ glib:get-type="adw_flap_get_type"
16781+ glib:type-struct="FlapClass">
16782+ <doc xml:space="preserve"
16783+ filename="src/adw-flap.c"
16784+ line="22">An adaptive container acting like a box or an overlay.
16785+
16786+&lt;picture&gt;
16787+ &lt;source srcset="flap-wide-dark.png" media="(prefers-color-scheme: dark)"&gt;
16788+ &lt;img src="flap-wide.png" alt="flap-wide"&gt;
16789+&lt;/picture&gt;
16790+&lt;picture&gt;
16791+ &lt;source srcset="flap-narrow-dark.png" media="(prefers-color-scheme: dark)"&gt;
16792+ &lt;img src="flap-narrow.png" alt="flap-narrow"&gt;
16793+&lt;/picture&gt;
16794+
16795+The `AdwFlap` widget can display its children like a [class@Gtk.Box] does or
16796+like a [class@Gtk.Overlay] does, according to the
16797+[property@Flap:fold-policy] value.
16798+
16799+`AdwFlap` has at most three children: [property@Flap:content],
16800+[property@Flap:flap] and [property@Flap:separator]. Content is the primary
16801+child, flap is displayed next to it when unfolded, or overlays it when
16802+folded. Flap can be shown or hidden by changing the
16803+[property@Flap:reveal-flap] value, as well as via swipe gestures if
16804+[property@Flap:swipe-to-open] and/or [property@Flap:swipe-to-close] are set
16805+to `TRUE`.
16806+
16807+Optionally, a separator can be provided, which would be displayed between
16808+the content and the flap when there's no shadow to separate them, depending
16809+on the transition type.
16810+
16811+[property@Flap:flap] is transparent by default; add the
16812+[`.background`](style-classes.html#background) style class to it if this is
16813+unwanted.
16814+
16815+If [property@Flap:modal] is set to `TRUE`, content becomes completely
16816+inaccessible when the flap is revealed while folded.
16817+
16818+The position of the flap and separator children relative to the content is
16819+determined by orientation, as well as the [property@Flap:flap-position]
16820+value.
16821+
16822+Folding the flap will automatically hide the flap widget, and unfolding it
16823+will automatically reveal it. If this behavior is not desired, the
16824+[property@Flap:locked] property can be used to override it.
16825+
16826+Common use cases include sidebars, header bars that need to be able to
16827+overlap the window content (for example, in fullscreen mode) and bottom
16828+sheets.
16829+
16830+## AdwFlap as GtkBuildable
16831+
16832+The `AdwFlap` implementation of the [iface@Gtk.Buildable] interface supports
16833+setting the flap child by specifying “flap” as the “type” attribute of a
16834+`&lt;child&gt;` element, and separator by specifying “separator”. Specifying
16835+“content” child type or omitting it results in setting the content child.
16836+
16837+## CSS nodes
16838+
16839+`AdwFlap` has a single CSS node with name `flap`. The node will get the style
16840+classes `.folded` when it is folded, and `.unfolded` when it's not.</doc>
16841+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
16842+ <source-position filename="src/adw-flap.h" line="25"/>
16843+ <implements name="Swipeable"/>
16844+ <implements name="Gtk.Accessible"/>
16845+ <implements name="Gtk.Buildable"/>
16846+ <implements name="Gtk.ConstraintTarget"/>
16847+ <implements name="Gtk.Orientable"/>
16848+ <constructor name="new"
16849+ c:identifier="adw_flap_new"
16850+ deprecated="1"
16851+ deprecated-version="1.4">
16852+ <doc xml:space="preserve"
16853+ filename="src/adw-flap.c"
16854+ line="1791">Creates a new `AdwFlap`.</doc>
16855+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
16856+ <source-position filename="src/adw-flap.h" line="40"/>
16857+ <return-value transfer-ownership="none">
16858+ <doc xml:space="preserve"
16859+ filename="src/adw-flap.c"
16860+ line="1796">the newly created `AdwFlap`</doc>
16861+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
16862+ </return-value>
16863+ </constructor>
16864+ <method name="get_content"
16865+ c:identifier="adw_flap_get_content"
16866+ glib:get-property="content"
16867+ deprecated="1"
16868+ deprecated-version="1.4">
16869+ <doc xml:space="preserve"
16870+ filename="src/adw-flap.c"
16871+ line="1806">Gets the content widget for @self.</doc>
16872+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
16873+ <source-position filename="src/adw-flap.h" line="43"/>
16874+ <return-value transfer-ownership="none" nullable="1">
16875+ <doc xml:space="preserve"
16876+ filename="src/adw-flap.c"
16877+ line="1812">the content widget for @self</doc>
16878+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
16879+ </return-value>
16880+ <parameters>
16881+ <instance-parameter name="self" transfer-ownership="none">
16882+ <doc xml:space="preserve"
16883+ filename="src/adw-flap.c"
16884+ line="1808">a flap</doc>
16885+ <type name="Flap" c:type="AdwFlap*"/>
16886+ </instance-parameter>
16887+ </parameters>
16888+ </method>
16889+ <method name="get_flap"
16890+ c:identifier="adw_flap_get_flap"
16891+ glib:get-property="flap"
16892+ deprecated="1"
16893+ deprecated-version="1.4">
16894+ <doc xml:space="preserve"
16895+ filename="src/adw-flap.c"
16896+ line="1861">Gets the flap widget for @self.</doc>
16897+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
16898+ <source-position filename="src/adw-flap.h" line="49"/>
16899+ <return-value transfer-ownership="none" nullable="1">
16900+ <doc xml:space="preserve"
16901+ filename="src/adw-flap.c"
16902+ line="1867">the flap widget for @self</doc>
16903+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
16904+ </return-value>
16905+ <parameters>
16906+ <instance-parameter name="self" transfer-ownership="none">
16907+ <doc xml:space="preserve"
16908+ filename="src/adw-flap.c"
16909+ line="1863">a flap</doc>
16910+ <type name="Flap" c:type="AdwFlap*"/>
16911+ </instance-parameter>
16912+ </parameters>
16913+ </method>
16914+ <method name="get_flap_position"
16915+ c:identifier="adw_flap_get_flap_position"
16916+ glib:get-property="flap-position"
16917+ deprecated="1"
16918+ deprecated-version="1.4">
16919+ <doc xml:space="preserve"
16920+ filename="src/adw-flap.c"
16921+ line="1974">Gets the flap position for @self.</doc>
16922+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
16923+ <source-position filename="src/adw-flap.h" line="61"/>
16924+ <return-value transfer-ownership="none">
16925+ <doc xml:space="preserve"
16926+ filename="src/adw-flap.c"
16927+ line="1980">the flap position for @self</doc>
16928+ <type name="Gtk.PackType" c:type="GtkPackType"/>
16929+ </return-value>
16930+ <parameters>
16931+ <instance-parameter name="self" transfer-ownership="none">
16932+ <doc xml:space="preserve"
16933+ filename="src/adw-flap.c"
16934+ line="1976">a flap</doc>
16935+ <type name="Flap" c:type="AdwFlap*"/>
16936+ </instance-parameter>
16937+ </parameters>
16938+ </method>
16939+ <method name="get_fold_duration"
16940+ c:identifier="adw_flap_get_fold_duration"
16941+ glib:get-property="fold-duration"
16942+ deprecated="1"
16943+ deprecated-version="1.4">
16944+ <doc xml:space="preserve"
16945+ filename="src/adw-flap.c"
16946+ line="2239">Gets the fold transition animation duration for @self, in milliseconds.</doc>
16947+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
16948+ <source-position filename="src/adw-flap.h" line="94"/>
16949+ <return-value transfer-ownership="none">
16950+ <doc xml:space="preserve"
16951+ filename="src/adw-flap.c"
16952+ line="2245">the fold transition duration</doc>
16953+ <type name="guint" c:type="guint"/>
16954+ </return-value>
16955+ <parameters>
16956+ <instance-parameter name="self" transfer-ownership="none">
16957+ <doc xml:space="preserve"
16958+ filename="src/adw-flap.c"
16959+ line="2241">a flap</doc>
16960+ <type name="Flap" c:type="AdwFlap*"/>
16961+ </instance-parameter>
16962+ </parameters>
16963+ </method>
16964+ <method name="get_fold_policy"
16965+ c:identifier="adw_flap_get_fold_policy"
16966+ glib:get-property="fold-policy"
16967+ deprecated="1"
16968+ deprecated-version="1.4">
16969+ <doc xml:space="preserve"
16970+ filename="src/adw-flap.c"
16971+ line="2129">Gets the fold policy for @self.</doc>
16972+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
16973+ <source-position filename="src/adw-flap.h" line="82"/>
16974+ <return-value transfer-ownership="none">
16975+ <doc xml:space="preserve"
16976+ filename="src/adw-flap.c"
16977+ line="2135">the fold policy for @self</doc>
16978+ <type name="FlapFoldPolicy" c:type="AdwFlapFoldPolicy"/>
16979+ </return-value>
16980+ <parameters>
16981+ <instance-parameter name="self" transfer-ownership="none">
16982+ <doc xml:space="preserve"
16983+ filename="src/adw-flap.c"
16984+ line="2131">a flap</doc>
16985+ <type name="Flap" c:type="AdwFlap*"/>
16986+ </instance-parameter>
16987+ </parameters>
16988+ </method>
16989+ <method name="get_fold_threshold_policy"
16990+ c:identifier="adw_flap_get_fold_threshold_policy"
16991+ glib:get-property="fold-threshold-policy"
16992+ deprecated="1"
16993+ deprecated-version="1.4">
16994+ <doc xml:space="preserve"
16995+ filename="src/adw-flap.c"
16996+ line="2188">Gets the fold threshold policy for @self.</doc>
16997+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
16998+ <source-position filename="src/adw-flap.h" line="88"/>
16999+ <return-value transfer-ownership="none">
17000+ <doc xml:space="preserve"
17001+ filename="src/adw-flap.c"
17002+ line="2194">the fold threshold policy</doc>
17003+ <type name="FoldThresholdPolicy" c:type="AdwFoldThresholdPolicy"/>
17004+ </return-value>
17005+ <parameters>
17006+ <instance-parameter name="self" transfer-ownership="none">
17007+ <doc xml:space="preserve"
17008+ filename="src/adw-flap.c"
17009+ line="2190">a flap</doc>
17010+ <type name="Flap" c:type="AdwFlap*"/>
17011+ </instance-parameter>
17012+ </parameters>
17013+ </method>
17014+ <method name="get_folded"
17015+ c:identifier="adw_flap_get_folded"
17016+ glib:get-property="folded"
17017+ deprecated="1"
17018+ deprecated-version="1.4">
17019+ <doc xml:space="preserve"
17020+ filename="src/adw-flap.c"
17021+ line="2280">Gets whether @self is currently folded.
17022+
17023+See [property@Flap:fold-policy].</doc>
17024+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17025+ <source-position filename="src/adw-flap.h" line="100"/>
17026+ <return-value transfer-ownership="none">
17027+ <doc xml:space="preserve"
17028+ filename="src/adw-flap.c"
17029+ line="2288">`TRUE` if @self is currently folded</doc>
17030+ <type name="gboolean" c:type="gboolean"/>
17031+ </return-value>
17032+ <parameters>
17033+ <instance-parameter name="self" transfer-ownership="none">
17034+ <doc xml:space="preserve"
17035+ filename="src/adw-flap.c"
17036+ line="2282">a flap</doc>
17037+ <type name="Flap" c:type="AdwFlap*"/>
17038+ </instance-parameter>
17039+ </parameters>
17040+ </method>
17041+ <method name="get_locked"
17042+ c:identifier="adw_flap_get_locked"
17043+ glib:get-property="locked"
17044+ deprecated="1"
17045+ deprecated-version="1.4">
17046+ <doc xml:space="preserve"
17047+ filename="src/adw-flap.c"
17048+ line="2300">Gets whether @self is locked.</doc>
17049+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17050+ <source-position filename="src/adw-flap.h" line="103"/>
17051+ <return-value transfer-ownership="none">
17052+ <doc xml:space="preserve"
17053+ filename="src/adw-flap.c"
17054+ line="2306">`TRUE` if @self is locked</doc>
17055+ <type name="gboolean" c:type="gboolean"/>
17056+ </return-value>
17057+ <parameters>
17058+ <instance-parameter name="self" transfer-ownership="none">
17059+ <doc xml:space="preserve"
17060+ filename="src/adw-flap.c"
17061+ line="2302">a flap</doc>
17062+ <type name="Flap" c:type="AdwFlap*"/>
17063+ </instance-parameter>
17064+ </parameters>
17065+ </method>
17066+ <method name="get_modal"
17067+ c:identifier="adw_flap_get_modal"
17068+ glib:get-property="modal"
17069+ deprecated="1"
17070+ deprecated-version="1.4">
17071+ <doc xml:space="preserve"
17072+ filename="src/adw-flap.c"
17073+ line="2399">Gets whether @self is modal.</doc>
17074+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17075+ <source-position filename="src/adw-flap.h" line="115"/>
17076+ <return-value transfer-ownership="none">
17077+ <doc xml:space="preserve"
17078+ filename="src/adw-flap.c"
17079+ line="2405">`TRUE` if @self is modal</doc>
17080+ <type name="gboolean" c:type="gboolean"/>
17081+ </return-value>
17082+ <parameters>
17083+ <instance-parameter name="self" transfer-ownership="none">
17084+ <doc xml:space="preserve"
17085+ filename="src/adw-flap.c"
17086+ line="2401">a flap</doc>
17087+ <type name="Flap" c:type="AdwFlap*"/>
17088+ </instance-parameter>
17089+ </parameters>
17090+ </method>
17091+ <method name="get_reveal_flap"
17092+ c:identifier="adw_flap_get_reveal_flap"
17093+ glib:get-property="reveal-flap"
17094+ deprecated="1"
17095+ deprecated-version="1.4">
17096+ <doc xml:space="preserve"
17097+ filename="src/adw-flap.c"
17098+ line="2022">Gets whether the flap widget is revealed for @self.</doc>
17099+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17100+ <source-position filename="src/adw-flap.h" line="67"/>
17101+ <return-value transfer-ownership="none">
17102+ <doc xml:space="preserve"
17103+ filename="src/adw-flap.c"
17104+ line="2028">`TRUE` if the flap widget is revealed</doc>
17105+ <type name="gboolean" c:type="gboolean"/>
17106+ </return-value>
17107+ <parameters>
17108+ <instance-parameter name="self" transfer-ownership="none">
17109+ <doc xml:space="preserve"
17110+ filename="src/adw-flap.c"
17111+ line="2024">a flap</doc>
17112+ <type name="Flap" c:type="AdwFlap*"/>
17113+ </instance-parameter>
17114+ </parameters>
17115+ </method>
17116+ <method name="get_reveal_params"
17117+ c:identifier="adw_flap_get_reveal_params"
17118+ glib:get-property="reveal-params"
17119+ deprecated="1"
17120+ deprecated-version="1.4">
17121+ <doc xml:space="preserve"
17122+ filename="src/adw-flap.c"
17123+ line="2058">Gets the reveal animation spring parameters for @self.</doc>
17124+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17125+ <source-position filename="src/adw-flap.h" line="73"/>
17126+ <return-value transfer-ownership="full">
17127+ <doc xml:space="preserve"
17128+ filename="src/adw-flap.c"
17129+ line="2064">the reveal animation parameters</doc>
17130+ <type name="SpringParams" c:type="AdwSpringParams*"/>
17131+ </return-value>
17132+ <parameters>
17133+ <instance-parameter name="self" transfer-ownership="none">
17134+ <doc xml:space="preserve"
17135+ filename="src/adw-flap.c"
17136+ line="2060">a flap</doc>
17137+ <type name="Flap" c:type="AdwFlap*"/>
17138+ </instance-parameter>
17139+ </parameters>
17140+ </method>
17141+ <method name="get_reveal_progress"
17142+ c:identifier="adw_flap_get_reveal_progress"
17143+ glib:get-property="reveal-progress"
17144+ deprecated="1"
17145+ deprecated-version="1.4">
17146+ <doc xml:space="preserve"
17147+ filename="src/adw-flap.c"
17148+ line="2107">Gets the current reveal progress for @self.
17149+
17150+0 means fully hidden, 1 means fully revealed.
17151+
17152+See [property@Flap:reveal-flap].</doc>
17153+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17154+ <source-position filename="src/adw-flap.h" line="79"/>
17155+ <return-value transfer-ownership="none">
17156+ <doc xml:space="preserve"
17157+ filename="src/adw-flap.c"
17158+ line="2117">the current reveal progress for @self</doc>
17159+ <type name="gdouble" c:type="double"/>
17160+ </return-value>
17161+ <parameters>
17162+ <instance-parameter name="self" transfer-ownership="none">
17163+ <doc xml:space="preserve"
17164+ filename="src/adw-flap.c"
17165+ line="2109">a flap</doc>
17166+ <type name="Flap" c:type="AdwFlap*"/>
17167+ </instance-parameter>
17168+ </parameters>
17169+ </method>
17170+ <method name="get_separator"
17171+ c:identifier="adw_flap_get_separator"
17172+ glib:get-property="separator"
17173+ deprecated="1"
17174+ deprecated-version="1.4">
17175+ <doc xml:space="preserve"
17176+ filename="src/adw-flap.c"
17177+ line="1917">Gets the separator widget for @self.</doc>
17178+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17179+ <source-position filename="src/adw-flap.h" line="55"/>
17180+ <return-value transfer-ownership="none" nullable="1">
17181+ <doc xml:space="preserve"
17182+ filename="src/adw-flap.c"
17183+ line="1923">the separator widget for @self</doc>
17184+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
17185+ </return-value>
17186+ <parameters>
17187+ <instance-parameter name="self" transfer-ownership="none">
17188+ <doc xml:space="preserve"
17189+ filename="src/adw-flap.c"
17190+ line="1919">a flap</doc>
17191+ <type name="Flap" c:type="AdwFlap*"/>
17192+ </instance-parameter>
17193+ </parameters>
17194+ </method>
17195+ <method name="get_swipe_to_close"
17196+ c:identifier="adw_flap_get_swipe_to_close"
17197+ glib:get-property="swipe-to-close"
17198+ deprecated="1"
17199+ deprecated-version="1.4">
17200+ <doc xml:space="preserve"
17201+ filename="src/adw-flap.c"
17202+ line="2499">Gets whether @self can be closed with a swipe gesture.</doc>
17203+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17204+ <source-position filename="src/adw-flap.h" line="127"/>
17205+ <return-value transfer-ownership="none">
17206+ <doc xml:space="preserve"
17207+ filename="src/adw-flap.c"
17208+ line="2505">`TRUE` if @self can be closed with a swipe gesture</doc>
17209+ <type name="gboolean" c:type="gboolean"/>
17210+ </return-value>
17211+ <parameters>
17212+ <instance-parameter name="self" transfer-ownership="none">
17213+ <doc xml:space="preserve"
17214+ filename="src/adw-flap.c"
17215+ line="2501">a flap</doc>
17216+ <type name="Flap" c:type="AdwFlap*"/>
17217+ </instance-parameter>
17218+ </parameters>
17219+ </method>
17220+ <method name="get_swipe_to_open"
17221+ c:identifier="adw_flap_get_swipe_to_open"
17222+ glib:get-property="swipe-to-open"
17223+ deprecated="1"
17224+ deprecated-version="1.4">
17225+ <doc xml:space="preserve"
17226+ filename="src/adw-flap.c"
17227+ line="2451">Gets whether @self can be opened with a swipe gesture.</doc>
17228+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17229+ <source-position filename="src/adw-flap.h" line="121"/>
17230+ <return-value transfer-ownership="none">
17231+ <doc xml:space="preserve"
17232+ filename="src/adw-flap.c"
17233+ line="2457">`TRUE` if @self can be opened with a swipe gesture</doc>
17234+ <type name="gboolean" c:type="gboolean"/>
17235+ </return-value>
17236+ <parameters>
17237+ <instance-parameter name="self" transfer-ownership="none">
17238+ <doc xml:space="preserve"
17239+ filename="src/adw-flap.c"
17240+ line="2453">a flap</doc>
17241+ <type name="Flap" c:type="AdwFlap*"/>
17242+ </instance-parameter>
17243+ </parameters>
17244+ </method>
17245+ <method name="get_transition_type"
17246+ c:identifier="adw_flap_get_transition_type"
17247+ glib:get-property="transition-type"
17248+ deprecated="1"
17249+ deprecated-version="1.4">
17250+ <doc xml:space="preserve"
17251+ filename="src/adw-flap.c"
17252+ line="2347">Gets the type of animation used for reveal and fold transitions in @self.</doc>
17253+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17254+ <source-position filename="src/adw-flap.h" line="109"/>
17255+ <return-value transfer-ownership="none">
17256+ <doc xml:space="preserve"
17257+ filename="src/adw-flap.c"
17258+ line="2353">the current transition type of @self</doc>
17259+ <type name="FlapTransitionType" c:type="AdwFlapTransitionType"/>
17260+ </return-value>
17261+ <parameters>
17262+ <instance-parameter name="self" transfer-ownership="none">
17263+ <doc xml:space="preserve"
17264+ filename="src/adw-flap.c"
17265+ line="2349">a flap</doc>
17266+ <type name="Flap" c:type="AdwFlap*"/>
17267+ </instance-parameter>
17268+ </parameters>
17269+ </method>
17270+ <method name="set_content"
17271+ c:identifier="adw_flap_set_content"
17272+ glib:set-property="content"
17273+ deprecated="1"
17274+ deprecated-version="1.4">
17275+ <doc xml:space="preserve"
17276+ filename="src/adw-flap.c"
17277+ line="1824">Sets the content widget for @self.
17278+
17279+It's always displayed when unfolded, and partially visible when folded.</doc>
17280+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17281+ <source-position filename="src/adw-flap.h" line="45"/>
17282+ <return-value transfer-ownership="none">
17283+ <type name="none" c:type="void"/>
17284+ </return-value>
17285+ <parameters>
17286+ <instance-parameter name="self" transfer-ownership="none">
17287+ <doc xml:space="preserve"
17288+ filename="src/adw-flap.c"
17289+ line="1826">a flap</doc>
17290+ <type name="Flap" c:type="AdwFlap*"/>
17291+ </instance-parameter>
17292+ <parameter name="content"
17293+ transfer-ownership="none"
17294+ nullable="1"
17295+ allow-none="1">
17296+ <doc xml:space="preserve"
17297+ filename="src/adw-flap.c"
17298+ line="1827">the content widget</doc>
17299+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
17300+ </parameter>
17301+ </parameters>
17302+ </method>
17303+ <method name="set_flap"
17304+ c:identifier="adw_flap_set_flap"
17305+ glib:set-property="flap"
17306+ deprecated="1"
17307+ deprecated-version="1.4">
17308+ <doc xml:space="preserve"
17309+ filename="src/adw-flap.c"
17310+ line="1879">Sets the flap widget for @self.
17311+
17312+It's only visible when [property@Flap:reveal-progress] is greater than 0.</doc>
17313+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17314+ <source-position filename="src/adw-flap.h" line="51"/>
17315+ <return-value transfer-ownership="none">
17316+ <type name="none" c:type="void"/>
17317+ </return-value>
17318+ <parameters>
17319+ <instance-parameter name="self" transfer-ownership="none">
17320+ <doc xml:space="preserve"
17321+ filename="src/adw-flap.c"
17322+ line="1881">a flap</doc>
17323+ <type name="Flap" c:type="AdwFlap*"/>
17324+ </instance-parameter>
17325+ <parameter name="flap"
17326+ transfer-ownership="none"
17327+ nullable="1"
17328+ allow-none="1">
17329+ <doc xml:space="preserve"
17330+ filename="src/adw-flap.c"
17331+ line="1882">the flap widget</doc>
17332+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
17333+ </parameter>
17334+ </parameters>
17335+ </method>
17336+ <method name="set_flap_position"
17337+ c:identifier="adw_flap_set_flap_position"
17338+ glib:set-property="flap-position"
17339+ deprecated="1"
17340+ deprecated-version="1.4">
17341+ <doc xml:space="preserve"
17342+ filename="src/adw-flap.c"
17343+ line="1992">Sets the flap position for @self.
17344+
17345+If it's set to `GTK_PACK_START`, the flap is displayed before the content,
17346+if `GTK_PACK_END`, it's displayed after the content.</doc>
17347+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17348+ <source-position filename="src/adw-flap.h" line="63"/>
17349+ <return-value transfer-ownership="none">
17350+ <type name="none" c:type="void"/>
17351+ </return-value>
17352+ <parameters>
17353+ <instance-parameter name="self" transfer-ownership="none">
17354+ <doc xml:space="preserve"
17355+ filename="src/adw-flap.c"
17356+ line="1994">a flap</doc>
17357+ <type name="Flap" c:type="AdwFlap*"/>
17358+ </instance-parameter>
17359+ <parameter name="position" transfer-ownership="none">
17360+ <doc xml:space="preserve"
17361+ filename="src/adw-flap.c"
17362+ line="1995">the new value</doc>
17363+ <type name="Gtk.PackType" c:type="GtkPackType"/>
17364+ </parameter>
17365+ </parameters>
17366+ </method>
17367+ <method name="set_fold_duration"
17368+ c:identifier="adw_flap_set_fold_duration"
17369+ glib:set-property="fold-duration"
17370+ deprecated="1"
17371+ deprecated-version="1.4">
17372+ <doc xml:space="preserve"
17373+ filename="src/adw-flap.c"
17374+ line="2257">Sets the fold transition animation duration for @self, in milliseconds.</doc>
17375+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17376+ <source-position filename="src/adw-flap.h" line="96"/>
17377+ <return-value transfer-ownership="none">
17378+ <type name="none" c:type="void"/>
17379+ </return-value>
17380+ <parameters>
17381+ <instance-parameter name="self" transfer-ownership="none">
17382+ <doc xml:space="preserve"
17383+ filename="src/adw-flap.c"
17384+ line="2259">a flap</doc>
17385+ <type name="Flap" c:type="AdwFlap*"/>
17386+ </instance-parameter>
17387+ <parameter name="duration" transfer-ownership="none">
17388+ <doc xml:space="preserve"
17389+ filename="src/adw-flap.c"
17390+ line="2260">the new duration, in milliseconds</doc>
17391+ <type name="guint" c:type="guint"/>
17392+ </parameter>
17393+ </parameters>
17394+ </method>
17395+ <method name="set_fold_policy"
17396+ c:identifier="adw_flap_set_fold_policy"
17397+ glib:set-property="fold-policy"
17398+ deprecated="1"
17399+ deprecated-version="1.4">
17400+ <doc xml:space="preserve"
17401+ filename="src/adw-flap.c"
17402+ line="2147">Sets the fold policy for @self.</doc>
17403+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17404+ <source-position filename="src/adw-flap.h" line="84"/>
17405+ <return-value transfer-ownership="none">
17406+ <type name="none" c:type="void"/>
17407+ </return-value>
17408+ <parameters>
17409+ <instance-parameter name="self" transfer-ownership="none">
17410+ <doc xml:space="preserve"
17411+ filename="src/adw-flap.c"
17412+ line="2149">a flap</doc>
17413+ <type name="Flap" c:type="AdwFlap*"/>
17414+ </instance-parameter>
17415+ <parameter name="policy" transfer-ownership="none">
17416+ <doc xml:space="preserve"
17417+ filename="src/adw-flap.c"
17418+ line="2150">the fold policy</doc>
17419+ <type name="FlapFoldPolicy" c:type="AdwFlapFoldPolicy"/>
17420+ </parameter>
17421+ </parameters>
17422+ </method>
17423+ <method name="set_fold_threshold_policy"
17424+ c:identifier="adw_flap_set_fold_threshold_policy"
17425+ glib:set-property="fold-threshold-policy"
17426+ deprecated="1"
17427+ deprecated-version="1.4">
17428+ <doc xml:space="preserve"
17429+ filename="src/adw-flap.c"
17430+ line="2206">Sets the fold threshold policy for @self.
17431+
17432+If set to `ADW_FOLD_THRESHOLD_POLICY_MINIMUM`, flap will only fold when the
17433+children cannot fit anymore. With `ADW_FOLD_THRESHOLD_POLICY_NATURAL`, it
17434+will fold as soon as children don't get their natural size.
17435+
17436+This can be useful if you have a long ellipsizing label and want to let it
17437+ellipsize instead of immediately folding.</doc>
17438+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17439+ <source-position filename="src/adw-flap.h" line="90"/>
17440+ <return-value transfer-ownership="none">
17441+ <type name="none" c:type="void"/>
17442+ </return-value>
17443+ <parameters>
17444+ <instance-parameter name="self" transfer-ownership="none">
17445+ <doc xml:space="preserve"
17446+ filename="src/adw-flap.c"
17447+ line="2208">a flap</doc>
17448+ <type name="Flap" c:type="AdwFlap*"/>
17449+ </instance-parameter>
17450+ <parameter name="policy" transfer-ownership="none">
17451+ <doc xml:space="preserve"
17452+ filename="src/adw-flap.c"
17453+ line="2209">the policy to use</doc>
17454+ <type name="FoldThresholdPolicy" c:type="AdwFoldThresholdPolicy"/>
17455+ </parameter>
17456+ </parameters>
17457+ </method>
17458+ <method name="set_locked"
17459+ c:identifier="adw_flap_set_locked"
17460+ glib:set-property="locked"
17461+ deprecated="1"
17462+ deprecated-version="1.4">
17463+ <doc xml:space="preserve"
17464+ filename="src/adw-flap.c"
17465+ line="2318">Sets whether @self is locked.
17466+
17467+If `FALSE`, folding when the flap is revealed automatically closes it, and
17468+unfolding it when the flap is not revealed opens it. If `TRUE`,
17469+[property@Flap:reveal-flap] value never changes on its own.</doc>
17470+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17471+ <source-position filename="src/adw-flap.h" line="105"/>
17472+ <return-value transfer-ownership="none">
17473+ <type name="none" c:type="void"/>
17474+ </return-value>
17475+ <parameters>
17476+ <instance-parameter name="self" transfer-ownership="none">
17477+ <doc xml:space="preserve"
17478+ filename="src/adw-flap.c"
17479+ line="2320">a flap</doc>
17480+ <type name="Flap" c:type="AdwFlap*"/>
17481+ </instance-parameter>
17482+ <parameter name="locked" transfer-ownership="none">
17483+ <doc xml:space="preserve"
17484+ filename="src/adw-flap.c"
17485+ line="2321">the new value</doc>
17486+ <type name="gboolean" c:type="gboolean"/>
17487+ </parameter>
17488+ </parameters>
17489+ </method>
17490+ <method name="set_modal"
17491+ c:identifier="adw_flap_set_modal"
17492+ glib:set-property="modal"
17493+ deprecated="1"
17494+ deprecated-version="1.4">
17495+ <doc xml:space="preserve"
17496+ filename="src/adw-flap.c"
17497+ line="2417">Sets whether @self is modal.
17498+
17499+If `TRUE`, clicking the content widget while flap is revealed, as well as
17500+pressing the &lt;kbd&gt;Esc&lt;/kbd&gt; key, will close the flap. If `FALSE`, clicks are
17501+passed through to the content widget.</doc>
17502+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17503+ <source-position filename="src/adw-flap.h" line="117"/>
17504+ <return-value transfer-ownership="none">
17505+ <type name="none" c:type="void"/>
17506+ </return-value>
17507+ <parameters>
17508+ <instance-parameter name="self" transfer-ownership="none">
17509+ <doc xml:space="preserve"
17510+ filename="src/adw-flap.c"
17511+ line="2419">a flap</doc>
17512+ <type name="Flap" c:type="AdwFlap*"/>
17513+ </instance-parameter>
17514+ <parameter name="modal" transfer-ownership="none">
17515+ <doc xml:space="preserve"
17516+ filename="src/adw-flap.c"
17517+ line="2420">whether @self is modal</doc>
17518+ <type name="gboolean" c:type="gboolean"/>
17519+ </parameter>
17520+ </parameters>
17521+ </method>
17522+ <method name="set_reveal_flap"
17523+ c:identifier="adw_flap_set_reveal_flap"
17524+ glib:set-property="reveal-flap"
17525+ deprecated="1"
17526+ deprecated-version="1.4">
17527+ <doc xml:space="preserve"
17528+ filename="src/adw-flap.c"
17529+ line="2040">Sets whether the flap widget is revealed for @self.</doc>
17530+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17531+ <source-position filename="src/adw-flap.h" line="69"/>
17532+ <return-value transfer-ownership="none">
17533+ <type name="none" c:type="void"/>
17534+ </return-value>
17535+ <parameters>
17536+ <instance-parameter name="self" transfer-ownership="none">
17537+ <doc xml:space="preserve"
17538+ filename="src/adw-flap.c"
17539+ line="2042">a flap</doc>
17540+ <type name="Flap" c:type="AdwFlap*"/>
17541+ </instance-parameter>
17542+ <parameter name="reveal_flap" transfer-ownership="none">
17543+ <doc xml:space="preserve"
17544+ filename="src/adw-flap.c"
17545+ line="2043">whether to reveal the flap widget</doc>
17546+ <type name="gboolean" c:type="gboolean"/>
17547+ </parameter>
17548+ </parameters>
17549+ </method>
17550+ <method name="set_reveal_params"
17551+ c:identifier="adw_flap_set_reveal_params"
17552+ glib:set-property="reveal-params"
17553+ deprecated="1"
17554+ deprecated-version="1.4">
17555+ <doc xml:space="preserve"
17556+ filename="src/adw-flap.c"
17557+ line="2076">Sets the reveal animation spring parameters for @self.
17558+
17559+The default value is equivalent to:
17560+
17561+```c
17562+adw_spring_params_new (1, 0.5, 500)
17563+```</doc>
17564+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17565+ <source-position filename="src/adw-flap.h" line="75"/>
17566+ <return-value transfer-ownership="none">
17567+ <type name="none" c:type="void"/>
17568+ </return-value>
17569+ <parameters>
17570+ <instance-parameter name="self" transfer-ownership="none">
17571+ <doc xml:space="preserve"
17572+ filename="src/adw-flap.c"
17573+ line="2078">a flap</doc>
17574+ <type name="Flap" c:type="AdwFlap*"/>
17575+ </instance-parameter>
17576+ <parameter name="params" transfer-ownership="none">
17577+ <doc xml:space="preserve"
17578+ filename="src/adw-flap.c"
17579+ line="2079">the new parameters</doc>
17580+ <type name="SpringParams" c:type="AdwSpringParams*"/>
17581+ </parameter>
17582+ </parameters>
17583+ </method>
17584+ <method name="set_separator"
17585+ c:identifier="adw_flap_set_separator"
17586+ glib:set-property="separator"
17587+ deprecated="1"
17588+ deprecated-version="1.4">
17589+ <doc xml:space="preserve"
17590+ filename="src/adw-flap.c"
17591+ line="1935">Sets the separator widget for @self.
17592+
17593+It's displayed between content and flap when there's no shadow to display.
17594+When exactly it's visible depends on the [property@Flap:transition-type]
17595+value.</doc>
17596+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17597+ <source-position filename="src/adw-flap.h" line="57"/>
17598+ <return-value transfer-ownership="none">
17599+ <type name="none" c:type="void"/>
17600+ </return-value>
17601+ <parameters>
17602+ <instance-parameter name="self" transfer-ownership="none">
17603+ <doc xml:space="preserve"
17604+ filename="src/adw-flap.c"
17605+ line="1937">a flap</doc>
17606+ <type name="Flap" c:type="AdwFlap*"/>
17607+ </instance-parameter>
17608+ <parameter name="separator"
17609+ transfer-ownership="none"
17610+ nullable="1"
17611+ allow-none="1">
17612+ <doc xml:space="preserve"
17613+ filename="src/adw-flap.c"
17614+ line="1938">the separator widget</doc>
17615+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
17616+ </parameter>
17617+ </parameters>
17618+ </method>
17619+ <method name="set_swipe_to_close"
17620+ c:identifier="adw_flap_set_swipe_to_close"
17621+ glib:set-property="swipe-to-close"
17622+ deprecated="1"
17623+ deprecated-version="1.4">
17624+ <doc xml:space="preserve"
17625+ filename="src/adw-flap.c"
17626+ line="2517">Sets whether @self can be closed with a swipe gesture.
17627+
17628+The area that can be swiped depends on the [property@Flap:transition-type]
17629+value.</doc>
17630+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17631+ <source-position filename="src/adw-flap.h" line="129"/>
17632+ <return-value transfer-ownership="none">
17633+ <type name="none" c:type="void"/>
17634+ </return-value>
17635+ <parameters>
17636+ <instance-parameter name="self" transfer-ownership="none">
17637+ <doc xml:space="preserve"
17638+ filename="src/adw-flap.c"
17639+ line="2519">a flap</doc>
17640+ <type name="Flap" c:type="AdwFlap*"/>
17641+ </instance-parameter>
17642+ <parameter name="swipe_to_close" transfer-ownership="none">
17643+ <doc xml:space="preserve"
17644+ filename="src/adw-flap.c"
17645+ line="2520">whether @self can be closed with a swipe gesture</doc>
17646+ <type name="gboolean" c:type="gboolean"/>
17647+ </parameter>
17648+ </parameters>
17649+ </method>
17650+ <method name="set_swipe_to_open"
17651+ c:identifier="adw_flap_set_swipe_to_open"
17652+ glib:set-property="swipe-to-open"
17653+ deprecated="1"
17654+ deprecated-version="1.4">
17655+ <doc xml:space="preserve"
17656+ filename="src/adw-flap.c"
17657+ line="2469">Sets whether @self can be opened with a swipe gesture.
17658+
17659+The area that can be swiped depends on the [property@Flap:transition-type]
17660+value.</doc>
17661+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17662+ <source-position filename="src/adw-flap.h" line="123"/>
17663+ <return-value transfer-ownership="none">
17664+ <type name="none" c:type="void"/>
17665+ </return-value>
17666+ <parameters>
17667+ <instance-parameter name="self" transfer-ownership="none">
17668+ <doc xml:space="preserve"
17669+ filename="src/adw-flap.c"
17670+ line="2471">a flap</doc>
17671+ <type name="Flap" c:type="AdwFlap*"/>
17672+ </instance-parameter>
17673+ <parameter name="swipe_to_open" transfer-ownership="none">
17674+ <doc xml:space="preserve"
17675+ filename="src/adw-flap.c"
17676+ line="2472">whether @self can be opened with a swipe gesture</doc>
17677+ <type name="gboolean" c:type="gboolean"/>
17678+ </parameter>
17679+ </parameters>
17680+ </method>
17681+ <method name="set_transition_type"
17682+ c:identifier="adw_flap_set_transition_type"
17683+ glib:set-property="transition-type"
17684+ deprecated="1"
17685+ deprecated-version="1.4">
17686+ <doc xml:space="preserve"
17687+ filename="src/adw-flap.c"
17688+ line="2365">Sets the type of animation used for reveal and fold transitions in @self.
17689+
17690+[property@Flap:flap] is transparent by default, which means the content will
17691+be seen through it with `ADW_FLAP_TRANSITION_TYPE_OVER` transitions; add the
17692+[`.background`](style-classes.html#background) style class to it if this is
17693+unwanted.</doc>
17694+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17695+ <source-position filename="src/adw-flap.h" line="111"/>
17696+ <return-value transfer-ownership="none">
17697+ <type name="none" c:type="void"/>
17698+ </return-value>
17699+ <parameters>
17700+ <instance-parameter name="self" transfer-ownership="none">
17701+ <doc xml:space="preserve"
17702+ filename="src/adw-flap.c"
17703+ line="2367">a flap</doc>
17704+ <type name="Flap" c:type="AdwFlap*"/>
17705+ </instance-parameter>
17706+ <parameter name="transition_type" transfer-ownership="none">
17707+ <doc xml:space="preserve"
17708+ filename="src/adw-flap.c"
17709+ line="2368">the new transition type</doc>
17710+ <type name="FlapTransitionType" c:type="AdwFlapTransitionType"/>
17711+ </parameter>
17712+ </parameters>
17713+ </method>
17714+ <property name="content"
17715+ deprecated="1"
17716+ deprecated-version="1.4"
17717+ writable="1"
17718+ transfer-ownership="none"
17719+ setter="set_content"
17720+ getter="get_content">
17721+ <doc xml:space="preserve"
17722+ filename="src/adw-flap.c"
17723+ line="1264">The content widget.
17724+
17725+It's always displayed when unfolded, and partially visible when folded.</doc>
17726+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17727+ <type name="Gtk.Widget"/>
17728+ </property>
17729+ <property name="flap"
17730+ deprecated="1"
17731+ deprecated-version="1.4"
17732+ writable="1"
17733+ transfer-ownership="none"
17734+ setter="set_flap"
17735+ getter="get_flap">
17736+ <doc xml:space="preserve"
17737+ filename="src/adw-flap.c"
17738+ line="1278">The flap widget.
17739+
17740+It's only visible when [property@Flap:reveal-progress] is greater than 0.</doc>
17741+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17742+ <type name="Gtk.Widget"/>
17743+ </property>
17744+ <property name="flap-position"
17745+ deprecated="1"
17746+ deprecated-version="1.4"
17747+ writable="1"
17748+ transfer-ownership="none"
17749+ setter="set_flap_position"
17750+ getter="get_flap_position"
17751+ default-value="GTK_PACK_START">
17752+ <doc xml:space="preserve"
17753+ filename="src/adw-flap.c"
17754+ line="1308">The flap position.
17755+
17756+If it's set to `GTK_PACK_START`, the flap is displayed before the content,
17757+if `GTK_PACK_END`, it's displayed after the content.</doc>
17758+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17759+ <type name="Gtk.PackType"/>
17760+ </property>
17761+ <property name="fold-duration"
17762+ deprecated="1"
17763+ deprecated-version="1.4"
17764+ writable="1"
17765+ transfer-ownership="none"
17766+ setter="set_fold_duration"
17767+ getter="get_fold_duration"
17768+ default-value="250">
17769+ <doc xml:space="preserve"
17770+ filename="src/adw-flap.c"
17771+ line="1403">The fold transition animation duration, in milliseconds.</doc>
17772+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17773+ <type name="guint" c:type="guint"/>
17774+ </property>
17775+ <property name="fold-policy"
17776+ deprecated="1"
17777+ deprecated-version="1.4"
17778+ writable="1"
17779+ transfer-ownership="none"
17780+ setter="set_fold_policy"
17781+ getter="get_fold_policy"
17782+ default-value="ADW_FLAP_FOLD_POLICY_AUTO">
17783+ <doc xml:space="preserve"
17784+ filename="src/adw-flap.c"
17785+ line="1370">The fold policy for the flap.</doc>
17786+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17787+ <type name="FlapFoldPolicy"/>
17788+ </property>
17789+ <property name="fold-threshold-policy"
17790+ deprecated="1"
17791+ deprecated-version="1.4"
17792+ writable="1"
17793+ transfer-ownership="none"
17794+ setter="set_fold_threshold_policy"
17795+ getter="get_fold_threshold_policy"
17796+ default-value="ADW_FOLD_THRESHOLD_POLICY_MINIMUM">
17797+ <doc xml:space="preserve"
17798+ filename="src/adw-flap.c"
17799+ line="1383">Determines when the flap will fold.
17800+
17801+If set to `ADW_FOLD_THRESHOLD_POLICY_MINIMUM`, flap will only fold when
17802+the children cannot fit anymore. With `ADW_FOLD_THRESHOLD_POLICY_NATURAL`,
17803+it will fold as soon as children don't get their natural size.
17804+
17805+This can be useful if you have a long ellipsizing label and want to let it
17806+ellipsize instead of immediately folding.</doc>
17807+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17808+ <type name="FoldThresholdPolicy"/>
17809+ </property>
17810+ <property name="folded"
17811+ deprecated="1"
17812+ deprecated-version="1.4"
17813+ transfer-ownership="none"
17814+ getter="get_folded"
17815+ default-value="FALSE">
17816+ <doc xml:space="preserve"
17817+ filename="src/adw-flap.c"
17818+ line="1416">Whether the flap is currently folded.
17819+
17820+See [property@Flap:fold-policy].</doc>
17821+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17822+ <type name="gboolean" c:type="gboolean"/>
17823+ </property>
17824+ <property name="locked"
17825+ deprecated="1"
17826+ deprecated-version="1.4"
17827+ writable="1"
17828+ transfer-ownership="none"
17829+ setter="set_locked"
17830+ getter="get_locked"
17831+ default-value="FALSE">
17832+ <doc xml:space="preserve"
17833+ filename="src/adw-flap.c"
17834+ line="1430">Whether the flap is locked.
17835+
17836+If `FALSE`, folding when the flap is revealed automatically closes it, and
17837+unfolding it when the flap is not revealed opens it. If `TRUE`,
17838+[property@Flap:reveal-flap] value never changes on its own.</doc>
17839+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17840+ <type name="gboolean" c:type="gboolean"/>
17841+ </property>
17842+ <property name="modal"
17843+ deprecated="1"
17844+ deprecated-version="1.4"
17845+ writable="1"
17846+ transfer-ownership="none"
17847+ setter="set_modal"
17848+ getter="get_modal"
17849+ default-value="TRUE">
17850+ <doc xml:space="preserve"
17851+ filename="src/adw-flap.c"
17852+ line="1464">Whether the flap is modal.
17853+
17854+If `TRUE`, clicking the content widget while flap is revealed, as well as
17855+pressing the &lt;kbd&gt;Esc&lt;/kbd&gt; key, will close the flap. If `FALSE`, clicks
17856+are passed through to the content widget.</doc>
17857+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17858+ <type name="gboolean" c:type="gboolean"/>
17859+ </property>
17860+ <property name="reveal-flap"
17861+ deprecated="1"
17862+ deprecated-version="1.4"
17863+ writable="1"
17864+ transfer-ownership="none"
17865+ setter="set_reveal_flap"
17866+ getter="get_reveal_flap"
17867+ default-value="TRUE">
17868+ <doc xml:space="preserve"
17869+ filename="src/adw-flap.c"
17870+ line="1324">Whether the flap widget is revealed.</doc>
17871+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17872+ <type name="gboolean" c:type="gboolean"/>
17873+ </property>
17874+ <property name="reveal-params"
17875+ deprecated="1"
17876+ deprecated-version="1.4"
17877+ writable="1"
17878+ transfer-ownership="none"
17879+ setter="set_reveal_params"
17880+ getter="get_reveal_params">
17881+ <doc xml:space="preserve"
17882+ filename="src/adw-flap.c"
17883+ line="1336">The reveal animation spring parameters.
17884+
17885+The default value is equivalent to:
17886+
17887+```c
17888+adw_spring_params_new (1, 0.5, 500)
17889+```</doc>
17890+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17891+ <type name="SpringParams"/>
17892+ </property>
17893+ <property name="reveal-progress"
17894+ deprecated="1"
17895+ deprecated-version="1.4"
17896+ transfer-ownership="none"
17897+ getter="get_reveal_progress"
17898+ default-value="1.000000">
17899+ <doc xml:space="preserve"
17900+ filename="src/adw-flap.c"
17901+ line="1354">The current reveal transition progress.
17902+
17903+0 means fully hidden, 1 means fully revealed.
17904+
17905+See [property@Flap:reveal-flap].</doc>
17906+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17907+ <type name="gdouble" c:type="gdouble"/>
17908+ </property>
17909+ <property name="separator"
17910+ deprecated="1"
17911+ deprecated-version="1.4"
17912+ writable="1"
17913+ transfer-ownership="none"
17914+ setter="set_separator"
17915+ getter="get_separator">
17916+ <doc xml:space="preserve"
17917+ filename="src/adw-flap.c"
17918+ line="1292">The separator widget.
17919+
17920+It's displayed between content and flap when there's no shadow to display.
17921+When exactly it's visible depends on the [property@Flap:transition-type]
17922+value.</doc>
17923+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17924+ <type name="Gtk.Widget"/>
17925+ </property>
17926+ <property name="swipe-to-close"
17927+ deprecated="1"
17928+ deprecated-version="1.4"
17929+ writable="1"
17930+ transfer-ownership="none"
17931+ setter="set_swipe_to_close"
17932+ getter="get_swipe_to_close"
17933+ default-value="TRUE">
17934+ <doc xml:space="preserve"
17935+ filename="src/adw-flap.c"
17936+ line="1495">Whether the flap can be closed with a swipe gesture.
17937+
17938+The area that can be swiped depends on the [property@Flap:transition-type]
17939+value.</doc>
17940+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17941+ <type name="gboolean" c:type="gboolean"/>
17942+ </property>
17943+ <property name="swipe-to-open"
17944+ deprecated="1"
17945+ deprecated-version="1.4"
17946+ writable="1"
17947+ transfer-ownership="none"
17948+ setter="set_swipe_to_open"
17949+ getter="get_swipe_to_open"
17950+ default-value="TRUE">
17951+ <doc xml:space="preserve"
17952+ filename="src/adw-flap.c"
17953+ line="1480">Whether the flap can be opened with a swipe gesture.
17954+
17955+The area that can be swiped depends on the [property@Flap:transition-type]
17956+value.</doc>
17957+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17958+ <type name="gboolean" c:type="gboolean"/>
17959+ </property>
17960+ <property name="transition-type"
17961+ deprecated="1"
17962+ deprecated-version="1.4"
17963+ writable="1"
17964+ transfer-ownership="none"
17965+ setter="set_transition_type"
17966+ getter="get_transition_type"
17967+ default-value="ADW_FLAP_TRANSITION_TYPE_OVER">
17968+ <doc xml:space="preserve"
17969+ filename="src/adw-flap.c"
17970+ line="1446">the type of animation used for reveal and fold transitions.
17971+
17972+[property@Flap:flap] is transparent by default, which means the content
17973+will be seen through it with `ADW_FLAP_TRANSITION_TYPE_OVER` transitions;
17974+add the [`.background`](style-classes.html#background) style class to it if
17975+this is unwanted.</doc>
17976+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17977+ <type name="FlapTransitionType"/>
17978+ </property>
17979+ </class>
17980+ <record name="FlapClass"
17981+ c:type="AdwFlapClass"
17982+ glib:is-gtype-struct-for="Flap">
17983+ <source-position filename="src/adw-flap.h" line="25"/>
17984+ <field name="parent_class">
17985+ <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
17986+ </field>
17987+ </record>
17988+ <enumeration name="FlapFoldPolicy"
17989+ deprecated="1"
17990+ deprecated-version="1.4"
17991+ glib:type-name="AdwFlapFoldPolicy"
17992+ glib:get-type="adw_flap_fold_policy_get_type"
17993+ c:type="AdwFlapFoldPolicy">
17994+ <doc xml:space="preserve"
17995+ filename="src/adw-flap.c"
17996+ line="86">Describes the possible folding behavior of a [class@Flap] widget.</doc>
17997+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
17998+ <member name="never"
17999+ value="0"
18000+ c:identifier="ADW_FLAP_FOLD_POLICY_NEVER"
18001+ glib:nick="never"
18002+ glib:name="ADW_FLAP_FOLD_POLICY_NEVER">
18003+ <doc xml:space="preserve"
18004+ filename="src/adw-flap.c"
18005+ line="88">Disable folding, the flap cannot reach narrow
18006+ sizes.</doc>
18007+ </member>
18008+ <member name="always"
18009+ value="1"
18010+ c:identifier="ADW_FLAP_FOLD_POLICY_ALWAYS"
18011+ glib:nick="always"
18012+ glib:name="ADW_FLAP_FOLD_POLICY_ALWAYS">
18013+ <doc xml:space="preserve"
18014+ filename="src/adw-flap.c"
18015+ line="90">Keep the flap always folded.</doc>
18016+ </member>
18017+ <member name="auto"
18018+ value="2"
18019+ c:identifier="ADW_FLAP_FOLD_POLICY_AUTO"
18020+ glib:nick="auto"
18021+ glib:name="ADW_FLAP_FOLD_POLICY_AUTO">
18022+ <doc xml:space="preserve"
18023+ filename="src/adw-flap.c"
18024+ line="91">Fold and unfold the flap based on available
18025+ space.</doc>
18026+ </member>
18027+ </enumeration>
18028+ <enumeration name="FlapTransitionType"
18029+ deprecated="1"
18030+ deprecated-version="1.4"
18031+ glib:type-name="AdwFlapTransitionType"
18032+ glib:get-type="adw_flap_transition_type_get_type"
18033+ c:type="AdwFlapTransitionType">
18034+ <doc xml:space="preserve"
18035+ filename="src/adw-flap.c"
18036+ line="99">Describes transitions types of a [class@Flap] widget.
18037+
18038+It determines the type of animation when transitioning between children in a
18039+[class@Flap] widget, as well as which areas can be swiped via
18040+[property@Flap:swipe-to-open] and [property@Flap:swipe-to-close].</doc>
18041+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwflap)</doc-deprecated>
18042+ <member name="over"
18043+ value="0"
18044+ c:identifier="ADW_FLAP_TRANSITION_TYPE_OVER"
18045+ glib:nick="over"
18046+ glib:name="ADW_FLAP_TRANSITION_TYPE_OVER">
18047+ <doc xml:space="preserve"
18048+ filename="src/adw-flap.c"
18049+ line="101">The flap slides over the content, which is
18050+ dimmed. When folded, only the flap can be swiped.</doc>
18051+ </member>
18052+ <member name="under"
18053+ value="1"
18054+ c:identifier="ADW_FLAP_TRANSITION_TYPE_UNDER"
18055+ glib:nick="under"
18056+ glib:name="ADW_FLAP_TRANSITION_TYPE_UNDER">
18057+ <doc xml:space="preserve"
18058+ filename="src/adw-flap.c"
18059+ line="103">The content slides over the flap. Only the
18060+ content can be swiped.</doc>
18061+ </member>
18062+ <member name="slide"
18063+ value="2"
18064+ c:identifier="ADW_FLAP_TRANSITION_TYPE_SLIDE"
18065+ glib:nick="slide"
18066+ glib:name="ADW_FLAP_TRANSITION_TYPE_SLIDE">
18067+ <doc xml:space="preserve"
18068+ filename="src/adw-flap.c"
18069+ line="105">The flap slides offscreen when hidden,
18070+ neither the flap nor content overlap each other. Both widgets can be
18071+ swiped.</doc>
18072+ </member>
18073+ </enumeration>
18074+ <enumeration name="FoldThresholdPolicy"
18075+ deprecated="1"
18076+ deprecated-version="1.4"
18077+ glib:type-name="AdwFoldThresholdPolicy"
18078+ glib:get-type="adw_fold_threshold_policy_get_type"
18079+ c:type="AdwFoldThresholdPolicy">
18080+ <doc xml:space="preserve"
18081+ filename="src/adw-fold-threshold-policy.c"
18082+ line="10">Determines when [class@Flap] and [class@Leaflet] will fold.</doc>
18083+ <doc-deprecated xml:space="preserve">Stop using `AdwLeaflet` and `AdwFlap`</doc-deprecated>
18084+ <member name="minimum"
18085+ value="0"
18086+ c:identifier="ADW_FOLD_THRESHOLD_POLICY_MINIMUM"
18087+ glib:nick="minimum"
18088+ glib:name="ADW_FOLD_THRESHOLD_POLICY_MINIMUM">
18089+ <doc xml:space="preserve"
18090+ filename="src/adw-fold-threshold-policy.c"
18091+ line="12">Folding is based on the minimum size</doc>
18092+ </member>
18093+ <member name="natural"
18094+ value="1"
18095+ c:identifier="ADW_FOLD_THRESHOLD_POLICY_NATURAL"
18096+ glib:nick="natural"
18097+ glib:name="ADW_FOLD_THRESHOLD_POLICY_NATURAL">
18098+ <doc xml:space="preserve"
18099+ filename="src/adw-fold-threshold-policy.c"
18100+ line="13">Folding is based on the natural size</doc>
18101+ </member>
18102+ </enumeration>
18103+ <class name="HeaderBar"
18104+ c:symbol-prefix="header_bar"
18105+ c:type="AdwHeaderBar"
18106+ parent="Gtk.Widget"
18107+ final="1"
18108+ glib:type-name="AdwHeaderBar"
18109+ glib:get-type="adw_header_bar_get_type"
18110+ glib:type-struct="HeaderBarClass">
18111+ <doc xml:space="preserve"
18112+ filename="src/adw-header-bar.c"
18113+ line="39">A title bar widget.
18114+
18115+&lt;picture&gt;
18116+ &lt;source srcset="header-bar-dark.png" media="(prefers-color-scheme: dark)"&gt;
18117+ &lt;img src="header-bar.png" alt="header-bar"&gt;
18118+&lt;/picture&gt;
18119+
18120+`AdwHeaderBar` is similar to [class@Gtk.HeaderBar], but provides additional
18121+features compared to it. Refer to `GtkHeaderBar` for details. It is typically
18122+used as a top bar within [class@ToolbarView].
18123+
18124+## Dialog Integration
18125+
18126+When placed inside an [class@Dialog], `AdwHeaderBar` will display the dialog
18127+title instead of window title. It will also adjust the decoration layout to
18128+ensure it always has a close button and nothing else. Set
18129+[property@HeaderBar:show-start-title-buttons] and
18130+[property@HeaderBar:show-end-title-buttons] to `FALSE` to remove it if it's
18131+unwanted.
18132+
18133+## Navigation View Integration
18134+
18135+When placed inside an [class@NavigationPage], `AdwHeaderBar` will display the
18136+page title instead of window title.
18137+
18138+When used together with [class@NavigationView] or [class@NavigationSplitView],
18139+it will also display a back button that can be used to go back to the previous
18140+page. The button also has a context menu, allowing to pop multiple pages at
18141+once, potentially across multiple navigation views.
18142+
18143+Set [property@HeaderBar:show-back-button] to `FALSE` to disable this behavior
18144+in rare scenarios where it's unwanted.
18145+
18146+## Split View Integration
18147+
18148+When placed inside [class@NavigationSplitView] or [class@OverlaySplitView],
18149+`AdwHeaderBar` will automatically hide the title buttons other than at the
18150+edges of the window.
18151+
18152+## Bottom Sheet Integration
18153+
18154+When played inside [class@BottomSheet], `AdwHeaderBar` will not show the title
18155+unless [property@BottomSheet:show-drag-handle] is set to `FALSE`, regardless
18156+of [property@HeaderBar:show-title]. This only applies to the default title,
18157+titles set with [property@HeaderBar:title-widget] will still be shown.
18158+
18159+## Centering Policy
18160+
18161+[property@HeaderBar:centering-policy] allows to enforce strict centering of
18162+the title widget. This can be useful for entries inside [class@Clamp].
18163+
18164+## Title Buttons
18165+
18166+Unlike `GtkHeaderBar`, `AdwHeaderBar` allows to toggle title button
18167+visibility for each side individually, using the
18168+[property@HeaderBar:show-start-title-buttons] and
18169+[property@HeaderBar:show-end-title-buttons] properties.
18170+
18171+## CSS nodes
18172+
18173+```
18174+headerbar
18175+╰── windowhandle
18176+ ╰── box
18177+ ├── widget
18178+ │ ╰── box.start
18179+ │ ├── windowcontrols.start
18180+ │ ├── widget
18181+ │ │ ╰── [button.back]
18182+ │ ╰── [other children]
18183+ ├── widget
18184+ │ ╰── [Title Widget]
18185+ ╰── widget
18186+ ╰── box.end
18187+ ├── [other children]
18188+ ╰── windowcontrols.end
18189+```
18190+
18191+`AdwHeaderBar`'s CSS node is called `headerbar`. It contains a `windowhandle`
18192+subnode, which contains a `box` subnode, which contains three `widget`
18193+subnodes at the start, center and end of the header bar. The start and end
18194+subnodes contain a `box` subnode with the `.start` and `.end` style classes
18195+respectively, and the center node contains a node that represents the title.
18196+
18197+Each of the boxes contains a `windowcontrols` subnode, see
18198+[class@Gtk.WindowControls] for details, as well as other children.
18199+
18200+When [property@HeaderBar:show-back-button] is `TRUE`, the start box also
18201+contains a node with the name `widget` that contains a node with the name
18202+`button` and `.back` style class.
18203+
18204+## Accessibility
18205+
18206+`AdwHeaderBar` uses the `GTK_ACCESSIBLE_ROLE_GROUP` role.</doc>
18207+ <source-position filename="src/adw-header-bar.h" line="37"/>
18208+ <implements name="Gtk.Accessible"/>
18209+ <implements name="Gtk.Buildable"/>
18210+ <implements name="Gtk.ConstraintTarget"/>
18211+ <constructor name="new" c:identifier="adw_header_bar_new">
18212+ <doc xml:space="preserve"
18213+ filename="src/adw-header-bar.c"
18214+ line="944">Creates a new `AdwHeaderBar`.</doc>
18215+ <source-position filename="src/adw-header-bar.h" line="45"/>
18216+ <return-value transfer-ownership="none">
18217+ <doc xml:space="preserve"
18218+ filename="src/adw-header-bar.c"
18219+ line="949">the newly created `AdwHeaderBar`.</doc>
18220+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
18221+ </return-value>
18222+ </constructor>
18223+ <method name="get_centering_policy"
18224+ c:identifier="adw_header_bar_get_centering_policy"
18225+ glib:get-property="centering-policy">
18226+ <doc xml:space="preserve"
18227+ filename="src/adw-header-bar.c"
18228+ line="1306">Gets the policy for aligning the center widget.</doc>
18229+ <source-position filename="src/adw-header-bar.h" line="88"/>
18230+ <return-value transfer-ownership="none">
18231+ <doc xml:space="preserve"
18232+ filename="src/adw-header-bar.c"
18233+ line="1312">the centering policy</doc>
18234+ <type name="CenteringPolicy" c:type="AdwCenteringPolicy"/>
18235+ </return-value>
18236+ <parameters>
18237+ <instance-parameter name="self" transfer-ownership="none">
18238+ <doc xml:space="preserve"
18239+ filename="src/adw-header-bar.c"
18240+ line="1308">a header bar</doc>
18241+ <type name="HeaderBar" c:type="AdwHeaderBar*"/>
18242+ </instance-parameter>
18243+ </parameters>
18244+ </method>
18245+ <method name="get_decoration_layout"
18246+ c:identifier="adw_header_bar_get_decoration_layout"
18247+ glib:get-property="decoration-layout">
18248+ <doc xml:space="preserve"
18249+ filename="src/adw-header-bar.c"
18250+ line="1258">Gets the decoration layout for @self.</doc>
18251+ <source-position filename="src/adw-header-bar.h" line="82"/>
18252+ <return-value transfer-ownership="none" nullable="1">
18253+ <doc xml:space="preserve"
18254+ filename="src/adw-header-bar.c"
18255+ line="1264">the decoration layout</doc>
18256+ <type name="utf8" c:type="const char*"/>
18257+ </return-value>
18258+ <parameters>
18259+ <instance-parameter name="self" transfer-ownership="none">
18260+ <doc xml:space="preserve"
18261+ filename="src/adw-header-bar.c"
18262+ line="1260">a header bar</doc>
18263+ <type name="HeaderBar" c:type="AdwHeaderBar*"/>
18264+ </instance-parameter>
18265+ </parameters>
18266+ </method>
18267+ <method name="get_show_back_button"
18268+ c:identifier="adw_header_bar_get_show_back_button"
18269+ glib:get-property="show-back-button"
18270+ version="1.4">
18271+ <doc xml:space="preserve"
18272+ filename="src/adw-header-bar.c"
18273+ line="1201">Gets whether @self can show the back button.</doc>
18274+ <source-position filename="src/adw-header-bar.h" line="76"/>
18275+ <return-value transfer-ownership="none">
18276+ <doc xml:space="preserve"
18277+ filename="src/adw-header-bar.c"
18278+ line="1207">whether to show the back button</doc>
18279+ <type name="gboolean" c:type="gboolean"/>
18280+ </return-value>
18281+ <parameters>
18282+ <instance-parameter name="self" transfer-ownership="none">
18283+ <doc xml:space="preserve"
18284+ filename="src/adw-header-bar.c"
18285+ line="1203">a header bar</doc>
18286+ <type name="HeaderBar" c:type="AdwHeaderBar*"/>
18287+ </instance-parameter>
18288+ </parameters>
18289+ </method>
18290+ <method name="get_show_end_title_buttons"
18291+ c:identifier="adw_header_bar_get_show_end_title_buttons"
18292+ glib:get-property="show-end-title-buttons">
18293+ <doc xml:space="preserve"
18294+ filename="src/adw-header-bar.c"
18295+ line="1153">Gets whether to show title buttons at the end of @self.</doc>
18296+ <source-position filename="src/adw-header-bar.h" line="70"/>
18297+ <return-value transfer-ownership="none">
18298+ <doc xml:space="preserve"
18299+ filename="src/adw-header-bar.c"
18300+ line="1159">`TRUE` if title buttons at the end are shown</doc>
18301+ <type name="gboolean" c:type="gboolean"/>
18302+ </return-value>
18303+ <parameters>
18304+ <instance-parameter name="self" transfer-ownership="none">
18305+ <doc xml:space="preserve"
18306+ filename="src/adw-header-bar.c"
18307+ line="1155">a header bar</doc>
18308+ <type name="HeaderBar" c:type="AdwHeaderBar*"/>
18309+ </instance-parameter>
18310+ </parameters>
18311+ </method>
18312+ <method name="get_show_start_title_buttons"
18313+ c:identifier="adw_header_bar_get_show_start_title_buttons"
18314+ glib:get-property="show-start-title-buttons">
18315+ <doc xml:space="preserve"
18316+ filename="src/adw-header-bar.c"
18317+ line="1105">Gets whether to show title buttons at the start of @self.</doc>
18318+ <source-position filename="src/adw-header-bar.h" line="64"/>
18319+ <return-value transfer-ownership="none">
18320+ <doc xml:space="preserve"
18321+ filename="src/adw-header-bar.c"
18322+ line="1111">`TRUE` if title buttons at the start are shown</doc>
18323+ <type name="gboolean" c:type="gboolean"/>
18324+ </return-value>
18325+ <parameters>
18326+ <instance-parameter name="self" transfer-ownership="none">
18327+ <doc xml:space="preserve"
18328+ filename="src/adw-header-bar.c"
18329+ line="1107">a header bar</doc>
18330+ <type name="HeaderBar" c:type="AdwHeaderBar*"/>
18331+ </instance-parameter>
18332+ </parameters>
18333+ </method>
18334+ <method name="get_show_title"
18335+ c:identifier="adw_header_bar_get_show_title"
18336+ glib:get-property="show-title"
18337+ version="1.4">
18338+ <doc xml:space="preserve"
18339+ filename="src/adw-header-bar.c"
18340+ line="1351">Gets whether the title widget should be shown.</doc>
18341+ <source-position filename="src/adw-header-bar.h" line="94"/>
18342+ <return-value transfer-ownership="none">
18343+ <doc xml:space="preserve"
18344+ filename="src/adw-header-bar.c"
18345+ line="1357">whether the title widget should be shown.</doc>
18346+ <type name="gboolean" c:type="gboolean"/>
18347+ </return-value>
18348+ <parameters>
18349+ <instance-parameter name="self" transfer-ownership="none">
18350+ <doc xml:space="preserve"
18351+ filename="src/adw-header-bar.c"
18352+ line="1353">a header bar</doc>
18353+ <type name="HeaderBar" c:type="AdwHeaderBar*"/>
18354+ </instance-parameter>
18355+ </parameters>
18356+ </method>
18357+ <method name="get_title_widget"
18358+ c:identifier="adw_header_bar_get_title_widget"
18359+ glib:get-property="title-widget">
18360+ <doc xml:space="preserve"
18361+ filename="src/adw-header-bar.c"
18362+ line="1039">Gets the title widget widget of @self.</doc>
18363+ <source-position filename="src/adw-header-bar.h" line="58"/>
18364+ <return-value transfer-ownership="none" nullable="1">
18365+ <doc xml:space="preserve"
18366+ filename="src/adw-header-bar.c"
18367+ line="1045">the title widget</doc>
18368+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
18369+ </return-value>
18370+ <parameters>
18371+ <instance-parameter name="self" transfer-ownership="none">
18372+ <doc xml:space="preserve"
18373+ filename="src/adw-header-bar.c"
18374+ line="1041">a header bar</doc>
18375+ <type name="HeaderBar" c:type="AdwHeaderBar*"/>
18376+ </instance-parameter>
18377+ </parameters>
18378+ </method>
18379+ <method name="pack_end" c:identifier="adw_header_bar_pack_end">
18380+ <doc xml:space="preserve"
18381+ filename="src/adw-header-bar.c"
18382+ line="980">Adds @child to @self, packed with reference to the end of @self.</doc>
18383+ <source-position filename="src/adw-header-bar.h" line="51"/>
18384+ <return-value transfer-ownership="none">
18385+ <type name="none" c:type="void"/>
18386+ </return-value>
18387+ <parameters>
18388+ <instance-parameter name="self" transfer-ownership="none">
18389+ <doc xml:space="preserve"
18390+ filename="src/adw-header-bar.c"
18391+ line="982">a header bar</doc>
18392+ <type name="HeaderBar" c:type="AdwHeaderBar*"/>
18393+ </instance-parameter>
18394+ <parameter name="child" transfer-ownership="none">
18395+ <doc xml:space="preserve"
18396+ filename="src/adw-header-bar.c"
18397+ line="983">the widget to be added to @self</doc>
18398+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
18399+ </parameter>
18400+ </parameters>
18401+ </method>
18402+ <method name="pack_start" c:identifier="adw_header_bar_pack_start">
18403+ <doc xml:space="preserve"
18404+ filename="src/adw-header-bar.c"
18405+ line="957">Adds @child to @self, packed with reference to the start of the @self.</doc>
18406+ <source-position filename="src/adw-header-bar.h" line="48"/>
18407+ <return-value transfer-ownership="none">
18408+ <type name="none" c:type="void"/>
18409+ </return-value>
18410+ <parameters>
18411+ <instance-parameter name="self" transfer-ownership="none">
18412+ <doc xml:space="preserve"
18413+ filename="src/adw-header-bar.c"
18414+ line="959">a header bar</doc>
18415+ <type name="HeaderBar" c:type="AdwHeaderBar*"/>
18416+ </instance-parameter>
18417+ <parameter name="child" transfer-ownership="none">
18418+ <doc xml:space="preserve"
18419+ filename="src/adw-header-bar.c"
18420+ line="960">the widget to be added to @self</doc>
18421+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
18422+ </parameter>
18423+ </parameters>
18424+ </method>
18425+ <method name="remove" c:identifier="adw_header_bar_remove">
18426+ <doc xml:space="preserve"
18427+ filename="src/adw-header-bar.c"
18428+ line="1003">Removes a child from @self.
18429+
18430+The child must have been added with [method@HeaderBar.pack_start],
18431+[method@HeaderBar.pack_end] or [property@HeaderBar:title-widget].</doc>
18432+ <source-position filename="src/adw-header-bar.h" line="54"/>
18433+ <return-value transfer-ownership="none">
18434+ <type name="none" c:type="void"/>
18435+ </return-value>
18436+ <parameters>
18437+ <instance-parameter name="self" transfer-ownership="none">
18438+ <doc xml:space="preserve"
18439+ filename="src/adw-header-bar.c"
18440+ line="1005">a header bar</doc>
18441+ <type name="HeaderBar" c:type="AdwHeaderBar*"/>
18442+ </instance-parameter>
18443+ <parameter name="child" transfer-ownership="none">
18444+ <doc xml:space="preserve"
18445+ filename="src/adw-header-bar.c"
18446+ line="1006">the child to remove</doc>
18447+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
18448+ </parameter>
18449+ </parameters>
18450+ </method>
18451+ <method name="set_centering_policy"
18452+ c:identifier="adw_header_bar_set_centering_policy"
18453+ glib:set-property="centering-policy">
18454+ <doc xml:space="preserve"
18455+ filename="src/adw-header-bar.c"
18456+ line="1322">Sets the policy for aligning the center widget.</doc>
18457+ <source-position filename="src/adw-header-bar.h" line="90"/>
18458+ <return-value transfer-ownership="none">
18459+ <type name="none" c:type="void"/>
18460+ </return-value>
18461+ <parameters>
18462+ <instance-parameter name="self" transfer-ownership="none">
18463+ <doc xml:space="preserve"
18464+ filename="src/adw-header-bar.c"
18465+ line="1324">a header bar</doc>
18466+ <type name="HeaderBar" c:type="AdwHeaderBar*"/>
18467+ </instance-parameter>
18468+ <parameter name="centering_policy" transfer-ownership="none">
18469+ <doc xml:space="preserve"
18470+ filename="src/adw-header-bar.c"
18471+ line="1325">the centering policy</doc>
18472+ <type name="CenteringPolicy" c:type="AdwCenteringPolicy"/>
18473+ </parameter>
18474+ </parameters>
18475+ </method>
18476+ <method name="set_decoration_layout"
18477+ c:identifier="adw_header_bar_set_decoration_layout"
18478+ glib:set-property="decoration-layout">
18479+ <doc xml:space="preserve"
18480+ filename="src/adw-header-bar.c"
18481+ line="1274">Sets the decoration layout for @self.
18482+
18483+If this property is not set, the
18484+[property@Gtk.Settings:gtk-decoration-layout] setting is used.
18485+
18486+The format of the string is button names, separated by commas. A colon
18487+separates the buttons that should appear at the start from those at the end.
18488+Recognized button names are minimize, maximize, close and icon (the window
18489+icon).
18490+
18491+For example, “icon:minimize,maximize,close” specifies an icon at the start,
18492+and minimize, maximize and close buttons at the end.</doc>
18493+ <source-position filename="src/adw-header-bar.h" line="84"/>
18494+ <return-value transfer-ownership="none">
18495+ <type name="none" c:type="void"/>
18496+ </return-value>
18497+ <parameters>
18498+ <instance-parameter name="self" transfer-ownership="none">
18499+ <doc xml:space="preserve"
18500+ filename="src/adw-header-bar.c"
18501+ line="1276">a header bar</doc>
18502+ <type name="HeaderBar" c:type="AdwHeaderBar*"/>
18503+ </instance-parameter>
18504+ <parameter name="layout"
18505+ transfer-ownership="none"
18506+ nullable="1"
18507+ allow-none="1">
18508+ <doc xml:space="preserve"
18509+ filename="src/adw-header-bar.c"
18510+ line="1277">a decoration layout</doc>
18511+ <type name="utf8" c:type="const char*"/>
18512+ </parameter>
18513+ </parameters>
18514+ </method>
18515+ <method name="set_show_back_button"
18516+ c:identifier="adw_header_bar_set_show_back_button"
18517+ glib:set-property="show-back-button"
18518+ version="1.4">
18519+ <doc xml:space="preserve"
18520+ filename="src/adw-header-bar.c"
18521+ line="1219">Sets whether @self can show the back button.
18522+
18523+The back button will never be shown unless the header bar is placed inside an
18524+[class@NavigationView]. Usually, there is no reason to set it to `FALSE`.</doc>
18525+ <source-position filename="src/adw-header-bar.h" line="78"/>
18526+ <return-value transfer-ownership="none">
18527+ <type name="none" c:type="void"/>
18528+ </return-value>
18529+ <parameters>
18530+ <instance-parameter name="self" transfer-ownership="none">
18531+ <doc xml:space="preserve"
18532+ filename="src/adw-header-bar.c"
18533+ line="1221">a header bar</doc>
18534+ <type name="HeaderBar" c:type="AdwHeaderBar*"/>
18535+ </instance-parameter>
18536+ <parameter name="show_back_button" transfer-ownership="none">
18537+ <doc xml:space="preserve"
18538+ filename="src/adw-header-bar.c"
18539+ line="1222">whether to show the back button</doc>
18540+ <type name="gboolean" c:type="gboolean"/>
18541+ </parameter>
18542+ </parameters>
18543+ </method>
18544+ <method name="set_show_end_title_buttons"
18545+ c:identifier="adw_header_bar_set_show_end_title_buttons"
18546+ glib:set-property="show-end-title-buttons">
18547+ <doc xml:space="preserve"
18548+ filename="src/adw-header-bar.c"
18549+ line="1169">Sets whether to show title buttons at the end of @self.
18550+
18551+See [property@HeaderBar:show-start-title-buttons] for the other side.
18552+
18553+Which buttons are actually shown and where is determined by the
18554+[property@HeaderBar:decoration-layout] property, and by the state of the
18555+window (e.g. a close button will not be shown if the window can't be closed).</doc>
18556+ <source-position filename="src/adw-header-bar.h" line="72"/>
18557+ <return-value transfer-ownership="none">
18558+ <type name="none" c:type="void"/>
18559+ </return-value>
18560+ <parameters>
18561+ <instance-parameter name="self" transfer-ownership="none">
18562+ <doc xml:space="preserve"
18563+ filename="src/adw-header-bar.c"
18564+ line="1171">a header bar</doc>
18565+ <type name="HeaderBar" c:type="AdwHeaderBar*"/>
18566+ </instance-parameter>
18567+ <parameter name="setting" transfer-ownership="none">
18568+ <doc xml:space="preserve"
18569+ filename="src/adw-header-bar.c"
18570+ line="1172">`TRUE` to show standard title buttons</doc>
18571+ <type name="gboolean" c:type="gboolean"/>
18572+ </parameter>
18573+ </parameters>
18574+ </method>
18575+ <method name="set_show_start_title_buttons"
18576+ c:identifier="adw_header_bar_set_show_start_title_buttons"
18577+ glib:set-property="show-start-title-buttons">
18578+ <doc xml:space="preserve"
18579+ filename="src/adw-header-bar.c"
18580+ line="1121">Sets whether to show title buttons at the start of @self.
18581+
18582+See [property@HeaderBar:show-end-title-buttons] for the other side.
18583+
18584+Which buttons are actually shown and where is determined by the
18585+[property@HeaderBar:decoration-layout] property, and by the state of the
18586+window (e.g. a close button will not be shown if the window can't be closed).</doc>
18587+ <source-position filename="src/adw-header-bar.h" line="66"/>
18588+ <return-value transfer-ownership="none">
18589+ <type name="none" c:type="void"/>
18590+ </return-value>
18591+ <parameters>
18592+ <instance-parameter name="self" transfer-ownership="none">
18593+ <doc xml:space="preserve"
18594+ filename="src/adw-header-bar.c"
18595+ line="1123">a header bar</doc>
18596+ <type name="HeaderBar" c:type="AdwHeaderBar*"/>
18597+ </instance-parameter>
18598+ <parameter name="setting" transfer-ownership="none">
18599+ <doc xml:space="preserve"
18600+ filename="src/adw-header-bar.c"
18601+ line="1124">`TRUE` to show standard title buttons</doc>
18602+ <type name="gboolean" c:type="gboolean"/>
18603+ </parameter>
18604+ </parameters>
18605+ </method>
18606+ <method name="set_show_title"
18607+ c:identifier="adw_header_bar_set_show_title"
18608+ glib:set-property="show-title"
18609+ version="1.4">
18610+ <doc xml:space="preserve"
18611+ filename="src/adw-header-bar.c"
18612+ line="1369">Sets whether the title widget should be shown.</doc>
18613+ <source-position filename="src/adw-header-bar.h" line="96"/>
18614+ <return-value transfer-ownership="none">
18615+ <type name="none" c:type="void"/>
18616+ </return-value>
18617+ <parameters>
18618+ <instance-parameter name="self" transfer-ownership="none">
18619+ <doc xml:space="preserve"
18620+ filename="src/adw-header-bar.c"
18621+ line="1371">a header bar</doc>
18622+ <type name="HeaderBar" c:type="AdwHeaderBar*"/>
18623+ </instance-parameter>
18624+ <parameter name="show_title" transfer-ownership="none">
18625+ <doc xml:space="preserve"
18626+ filename="src/adw-header-bar.c"
18627+ line="1372">whether the title widget is visible</doc>
18628+ <type name="gboolean" c:type="gboolean"/>
18629+ </parameter>
18630+ </parameters>
18631+ </method>
18632+ <method name="set_title_widget"
18633+ c:identifier="adw_header_bar_set_title_widget"
18634+ glib:set-property="title-widget">
18635+ <doc xml:space="preserve"
18636+ filename="src/adw-header-bar.c"
18637+ line="1055">Sets the title widget for @self.
18638+
18639+When set to `NULL`, the header bar will display the title of the window it
18640+is contained in.
18641+
18642+To use a different title, use [class@WindowTitle]:
18643+
18644+```xml
18645+&lt;object class="AdwHeaderBar"&gt;
18646+ &lt;property name="title-widget"&gt;
18647+ &lt;object class="AdwWindowTitle"&gt;
18648+ &lt;property name="title" translatable="yes"&gt;Title&lt;/property&gt;
18649+ &lt;/object&gt;
18650+ &lt;/property&gt;
18651+&lt;/object&gt;
18652+```</doc>
18653+ <source-position filename="src/adw-header-bar.h" line="60"/>
18654+ <return-value transfer-ownership="none">
18655+ <type name="none" c:type="void"/>
18656+ </return-value>
18657+ <parameters>
18658+ <instance-parameter name="self" transfer-ownership="none">
18659+ <doc xml:space="preserve"
18660+ filename="src/adw-header-bar.c"
18661+ line="1057">a header bar</doc>
18662+ <type name="HeaderBar" c:type="AdwHeaderBar*"/>
18663+ </instance-parameter>
18664+ <parameter name="title_widget"
18665+ transfer-ownership="none"
18666+ nullable="1"
18667+ allow-none="1">
18668+ <doc xml:space="preserve"
18669+ filename="src/adw-header-bar.c"
18670+ line="1058">a widget to use for a title</doc>
18671+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
18672+ </parameter>
18673+ </parameters>
18674+ </method>
18675+ <property name="centering-policy"
18676+ writable="1"
18677+ transfer-ownership="none"
18678+ setter="set_centering_policy"
18679+ getter="get_centering_policy"
18680+ default-value="ADW_CENTERING_POLICY_LOOSE">
18681+ <doc xml:space="preserve"
18682+ filename="src/adw-header-bar.c"
18683+ line="841">The policy for aligning the center widget.</doc>
18684+ <type name="CenteringPolicy"/>
18685+ </property>
18686+ <property name="decoration-layout"
18687+ writable="1"
18688+ transfer-ownership="none"
18689+ setter="set_decoration_layout"
18690+ getter="get_decoration_layout"
18691+ default-value="NULL">
18692+ <doc xml:space="preserve"
18693+ filename="src/adw-header-bar.c"
18694+ line="820">The decoration layout for buttons.
18695+
18696+If this property is not set, the
18697+[property@Gtk.Settings:gtk-decoration-layout] setting is used.
18698+
18699+The format of the string is button names, separated by commas. A colon
18700+separates the buttons that should appear at the start from those at the
18701+end. Recognized button names are minimize, maximize, close and icon (the
18702+window icon).
18703+
18704+For example, “icon:minimize,maximize,close” specifies an icon at the start,
18705+and minimize, maximize and close buttons at the end.</doc>
18706+ <type name="utf8" c:type="gchar*"/>
18707+ </property>
18708+ <property name="show-back-button"
18709+ version="1.4"
18710+ writable="1"
18711+ transfer-ownership="none"
18712+ setter="set_show_back_button"
18713+ getter="get_show_back_button"
18714+ default-value="TRUE">
18715+ <doc xml:space="preserve"
18716+ filename="src/adw-header-bar.c"
18717+ line="805">Whether the header bar can show the back button.
18718+
18719+The back button will never be shown unless the header bar is placed inside an
18720+[class@NavigationView]. Usually, there is no reason to set this to `FALSE`.</doc>
18721+ <type name="gboolean" c:type="gboolean"/>
18722+ </property>
18723+ <property name="show-end-title-buttons"
18724+ writable="1"
18725+ transfer-ownership="none"
18726+ setter="set_show_end_title_buttons"
18727+ getter="get_show_end_title_buttons"
18728+ default-value="TRUE">
18729+ <doc xml:space="preserve"
18730+ filename="src/adw-header-bar.c"
18731+ line="788">Whether to show title buttons at the end of the header bar.
18732+
18733+See [property@HeaderBar:show-start-title-buttons] for the other side.
18734+
18735+Which buttons are actually shown and where is determined by the
18736+[property@HeaderBar:decoration-layout] property, and by the state of the
18737+window (e.g. a close button will not be shown if the window can't be
18738+closed).</doc>
18739+ <type name="gboolean" c:type="gboolean"/>
18740+ </property>
18741+ <property name="show-start-title-buttons"
18742+ writable="1"
18743+ transfer-ownership="none"
18744+ setter="set_show_start_title_buttons"
18745+ getter="get_show_start_title_buttons"
18746+ default-value="TRUE">
18747+ <doc xml:space="preserve"
18748+ filename="src/adw-header-bar.c"
18749+ line="771">Whether to show title buttons at the start of the header bar.
18750+
18751+See [property@HeaderBar:show-end-title-buttons] for the other side.
18752+
18753+Which buttons are actually shown and where is determined by the
18754+[property@HeaderBar:decoration-layout] property, and by the state of the
18755+window (e.g. a close button will not be shown if the window can't be
18756+closed).</doc>
18757+ <type name="gboolean" c:type="gboolean"/>
18758+ </property>
18759+ <property name="show-title"
18760+ version="1.4"
18761+ writable="1"
18762+ transfer-ownership="none"
18763+ setter="set_show_title"
18764+ getter="get_show_title"
18765+ default-value="TRUE">
18766+ <doc xml:space="preserve"
18767+ filename="src/adw-header-bar.c"
18768+ line="852">Whether the title widget should be shown.</doc>
18769+ <type name="gboolean" c:type="gboolean"/>
18770+ </property>
18771+ <property name="title-widget"
18772+ writable="1"
18773+ transfer-ownership="none"
18774+ setter="set_title_widget"
18775+ getter="get_title_widget">
18776+ <doc xml:space="preserve"
18777+ filename="src/adw-header-bar.c"
18778+ line="746">The title widget to display.
18779+
18780+When set to `NULL`, the header bar will display the title of the window it
18781+is contained in.
18782+
18783+To use a different title, use [class@WindowTitle]:
18784+
18785+```xml
18786+&lt;object class="AdwHeaderBar"&gt;
18787+ &lt;property name="title-widget"&gt;
18788+ &lt;object class="AdwWindowTitle"&gt;
18789+ &lt;property name="title" translatable="yes"&gt;Title&lt;/property&gt;
18790+ &lt;/object&gt;
18791+ &lt;/property&gt;
18792+&lt;/object&gt;
18793+```</doc>
18794+ <type name="Gtk.Widget"/>
18795+ </property>
18796+ </class>
18797+ <record name="HeaderBarClass"
18798+ c:type="AdwHeaderBarClass"
18799+ glib:is-gtype-struct-for="HeaderBar">
18800+ <source-position filename="src/adw-header-bar.h" line="37"/>
18801+ <field name="parent_class">
18802+ <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
18803+ </field>
18804+ </record>
18805+ <class name="Layout"
18806+ c:symbol-prefix="layout"
18807+ c:type="AdwLayout"
18808+ version="1.6"
18809+ parent="GObject.Object"
18810+ final="1"
18811+ glib:type-name="AdwLayout"
18812+ glib:get-type="adw_layout_get_type"
18813+ glib:type-struct="LayoutClass">
18814+ <doc xml:space="preserve"
18815+ filename="src/adw-layout.c"
18816+ line="15">An individual layout in [class@MultiLayoutView].</doc>
18817+ <source-position filename="src/adw-layout.h" line="25"/>
18818+ <implements name="Gtk.Buildable"/>
18819+ <constructor name="new" c:identifier="adw_layout_new" version="1.6">
18820+ <doc xml:space="preserve"
18821+ filename="src/adw-layout.c"
18822+ line="185">Creates a new `AdwLayout` that contains @content.</doc>
18823+ <source-position filename="src/adw-layout.h" line="28"/>
18824+ <return-value transfer-ownership="full">
18825+ <doc xml:space="preserve"
18826+ filename="src/adw-layout.c"
18827+ line="191">a new `AdwLayout`</doc>
18828+ <type name="Layout" c:type="AdwLayout*"/>
18829+ </return-value>
18830+ <parameters>
18831+ <parameter name="content" transfer-ownership="none">
18832+ <doc xml:space="preserve"
18833+ filename="src/adw-layout.c"
18834+ line="187">the content widget to use</doc>
18835+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
18836+ </parameter>
18837+ </parameters>
18838+ </constructor>
18839+ <method name="get_content"
18840+ c:identifier="adw_layout_get_content"
18841+ glib:get-property="content"
18842+ version="1.6">
18843+ <doc xml:space="preserve"
18844+ filename="src/adw-layout.c"
18845+ line="203">Gets the content widget.</doc>
18846+ <source-position filename="src/adw-layout.h" line="31"/>
18847+ <return-value transfer-ownership="none">
18848+ <doc xml:space="preserve"
18849+ filename="src/adw-layout.c"
18850+ line="209">The content</doc>
18851+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
18852+ </return-value>
18853+ <parameters>
18854+ <instance-parameter name="self" transfer-ownership="none">
18855+ <doc xml:space="preserve"
18856+ filename="src/adw-layout.c"
18857+ line="205">a layout</doc>
18858+ <type name="Layout" c:type="AdwLayout*"/>
18859+ </instance-parameter>
18860+ </parameters>
18861+ </method>
18862+ <method name="get_name"
18863+ c:identifier="adw_layout_get_name"
18864+ glib:get-property="name"
18865+ version="1.6">
18866+ <doc xml:space="preserve"
18867+ filename="src/adw-layout.c"
18868+ line="221">Gets the name of the layout.</doc>
18869+ <source-position filename="src/adw-layout.h" line="34"/>
18870+ <return-value transfer-ownership="none" nullable="1">
18871+ <doc xml:space="preserve"
18872+ filename="src/adw-layout.c"
18873+ line="227">the name of the layout</doc>
18874+ <type name="utf8" c:type="const char*"/>
18875+ </return-value>
18876+ <parameters>
18877+ <instance-parameter name="self" transfer-ownership="none">
18878+ <doc xml:space="preserve"
18879+ filename="src/adw-layout.c"
18880+ line="223">a layout</doc>
18881+ <type name="Layout" c:type="AdwLayout*"/>
18882+ </instance-parameter>
18883+ </parameters>
18884+ </method>
18885+ <method name="set_name"
18886+ c:identifier="adw_layout_set_name"
18887+ glib:set-property="name"
18888+ version="1.6">
18889+ <doc xml:space="preserve"
18890+ filename="src/adw-layout.c"
18891+ line="239">Sets the name of the layout.</doc>
18892+ <source-position filename="src/adw-layout.h" line="36"/>
18893+ <return-value transfer-ownership="none">
18894+ <type name="none" c:type="void"/>
18895+ </return-value>
18896+ <parameters>
18897+ <instance-parameter name="self" transfer-ownership="none">
18898+ <doc xml:space="preserve"
18899+ filename="src/adw-layout.c"
18900+ line="241">a layout</doc>
18901+ <type name="Layout" c:type="AdwLayout*"/>
18902+ </instance-parameter>
18903+ <parameter name="name"
18904+ transfer-ownership="none"
18905+ nullable="1"
18906+ allow-none="1">
18907+ <doc xml:space="preserve"
18908+ filename="src/adw-layout.c"
18909+ line="242">the layout name</doc>
18910+ <type name="utf8" c:type="const char*"/>
18911+ </parameter>
18912+ </parameters>
18913+ </method>
18914+ <property name="content"
18915+ version="1.6"
18916+ writable="1"
18917+ construct-only="1"
18918+ transfer-ownership="none"
18919+ getter="get_content">
18920+ <doc xml:space="preserve"
18921+ filename="src/adw-layout.c"
18922+ line="133">The content widget.</doc>
18923+ <type name="Gtk.Widget"/>
18924+ </property>
18925+ <property name="name"
18926+ version="1.6"
18927+ writable="1"
18928+ transfer-ownership="none"
18929+ setter="set_name"
18930+ getter="get_name"
18931+ default-value="NULL">
18932+ <doc xml:space="preserve"
18933+ filename="src/adw-layout.c"
18934+ line="145">The name of the layout.</doc>
18935+ <type name="utf8" c:type="gchar*"/>
18936+ </property>
18937+ </class>
18938+ <record name="LayoutClass"
18939+ c:type="AdwLayoutClass"
18940+ glib:is-gtype-struct-for="Layout">
18941+ <source-position filename="src/adw-layout.h" line="25"/>
18942+ <field name="parent_class">
18943+ <type name="GObject.ObjectClass" c:type="GObjectClass"/>
18944+ </field>
18945+ </record>
18946+ <class name="LayoutSlot"
18947+ c:symbol-prefix="layout_slot"
18948+ c:type="AdwLayoutSlot"
18949+ version="1.6"
18950+ parent="Gtk.Widget"
18951+ final="1"
18952+ glib:type-name="AdwLayoutSlot"
18953+ glib:get-type="adw_layout_slot_get_type"
18954+ glib:type-struct="LayoutSlotClass">
18955+ <doc xml:space="preserve"
18956+ filename="src/adw-layout-slot.c"
18957+ line="17">A child slot within [class@Layout].
18958+
18959+While it contains a layout child, the [property@Gtk.Widget:visible] property
18960+of the slot is updated to match that of the layout child.
18961+
18962+See [class@MultiLayoutView].</doc>
18963+ <source-position filename="src/adw-layout-slot.h" line="25"/>
18964+ <implements name="Gtk.Accessible"/>
18965+ <implements name="Gtk.Buildable"/>
18966+ <implements name="Gtk.ConstraintTarget"/>
18967+ <constructor name="new" c:identifier="adw_layout_slot_new" version="1.6">
18968+ <doc xml:space="preserve"
18969+ filename="src/adw-layout-slot.c"
18970+ line="143">Creates a new `AdwLayoutSlot` with its ID set to @id.</doc>
18971+ <source-position filename="src/adw-layout-slot.h" line="28"/>
18972+ <return-value transfer-ownership="none">
18973+ <doc xml:space="preserve"
18974+ filename="src/adw-layout-slot.c"
18975+ line="149">a new `AdwLayoutSlot`</doc>
18976+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
18977+ </return-value>
18978+ <parameters>
18979+ <parameter name="id" transfer-ownership="none">
18980+ <doc xml:space="preserve"
18981+ filename="src/adw-layout-slot.c"
18982+ line="145">the slot ID</doc>
18983+ <type name="utf8" c:type="const char*"/>
18984+ </parameter>
18985+ </parameters>
18986+ </constructor>
18987+ <method name="get_slot_id"
18988+ c:identifier="adw_layout_slot_get_slot_id"
18989+ glib:get-property="id"
18990+ version="1.6">
18991+ <doc xml:space="preserve"
18992+ filename="src/adw-layout-slot.c"
18993+ line="161">Gets the slot id of @self.</doc>
18994+ <source-position filename="src/adw-layout-slot.h" line="31"/>
18995+ <return-value transfer-ownership="none">
18996+ <doc xml:space="preserve"
18997+ filename="src/adw-layout-slot.c"
18998+ line="167">the slot ID</doc>
18999+ <type name="utf8" c:type="const char*"/>
19000+ </return-value>
19001+ <parameters>
19002+ <instance-parameter name="self" transfer-ownership="none">
19003+ <doc xml:space="preserve"
19004+ filename="src/adw-layout-slot.c"
19005+ line="163">a layout slot</doc>
19006+ <type name="LayoutSlot" c:type="AdwLayoutSlot*"/>
19007+ </instance-parameter>
19008+ </parameters>
19009+ </method>
19010+ <property name="id"
19011+ version="1.6"
19012+ writable="1"
19013+ construct-only="1"
19014+ transfer-ownership="none"
19015+ getter="get_slot_id"
19016+ default-value="NULL">
19017+ <doc xml:space="preserve"
19018+ filename="src/adw-layout-slot.c"
19019+ line="121">The slot ID.
19020+
19021+See [method@MultiLayoutView.set_child].</doc>
19022+ <type name="utf8" c:type="gchar*"/>
19023+ </property>
19024+ </class>
19025+ <record name="LayoutSlotClass"
19026+ c:type="AdwLayoutSlotClass"
19027+ glib:is-gtype-struct-for="LayoutSlot">
19028+ <source-position filename="src/adw-layout-slot.h" line="25"/>
19029+ <field name="parent_class">
19030+ <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
19031+ </field>
19032+ </record>
19033+ <class name="Leaflet"
19034+ c:symbol-prefix="leaflet"
19035+ c:type="AdwLeaflet"
19036+ deprecated="1"
19037+ deprecated-version="1.4"
19038+ parent="Gtk.Widget"
19039+ final="1"
19040+ glib:type-name="AdwLeaflet"
19041+ glib:get-type="adw_leaflet_get_type"
19042+ glib:type-struct="LeafletClass">
19043+ <doc xml:space="preserve"
19044+ filename="src/adw-leaflet.c"
19045+ line="21">An adaptive container acting like a box or a stack.
19046+
19047+&lt;picture&gt;
19048+ &lt;source srcset="leaflet-wide-dark.png" media="(prefers-color-scheme: dark)"&gt;
19049+ &lt;img src="leaflet-wide.png" alt="leaflet-wide"&gt;
19050+&lt;/picture&gt;
19051+&lt;picture&gt;
19052+ &lt;source srcset="leaflet-narrow-dark.png" media="(prefers-color-scheme: dark)"&gt;
19053+ &lt;img src="leaflet-narrow.png" alt="leaflet-narrow"&gt;
19054+&lt;/picture&gt;
19055+
19056+The `AdwLeaflet` widget can display its children like a [class@Gtk.Box] does
19057+or like a [class@Gtk.Stack] does, adapting to size changes by switching
19058+between the two modes.
19059+
19060+When there is enough space the children are displayed side by side, otherwise
19061+only one is displayed and the leaflet is said to be “folded”.
19062+The threshold is dictated by the preferred minimum sizes of the children.
19063+When a leaflet is folded, the children can be navigated using swipe gestures.
19064+
19065+The “over” and “under” transition types stack the children one on top of the
19066+other, while the “slide” transition puts the children side by side. While
19067+navigating to a child on the side or below can be performed by swiping the
19068+current child away, navigating to an upper child requires dragging it from
19069+the edge where it resides. This doesn't affect non-dragging swipes.
19070+
19071+## CSS nodes
19072+
19073+`AdwLeaflet` has a single CSS node with name `leaflet`. The node will get the
19074+style classes `.folded` when it is folded, `.unfolded` when it's not, or none
19075+if it hasn't computed its fold yet.</doc>
19076+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19077+ <source-position filename="src/adw-leaflet.h" line="46"/>
19078+ <implements name="Swipeable"/>
19079+ <implements name="Gtk.Accessible"/>
19080+ <implements name="Gtk.Buildable"/>
19081+ <implements name="Gtk.ConstraintTarget"/>
19082+ <implements name="Gtk.Orientable"/>
19083+ <constructor name="new"
19084+ c:identifier="adw_leaflet_new"
19085+ deprecated="1"
19086+ deprecated-version="1.4">
19087+ <doc xml:space="preserve"
19088+ filename="src/adw-leaflet.c"
19089+ line="2803">Creates a new `AdwLeaflet`.</doc>
19090+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19091+ <source-position filename="src/adw-leaflet.h" line="55"/>
19092+ <return-value transfer-ownership="none">
19093+ <doc xml:space="preserve"
19094+ filename="src/adw-leaflet.c"
19095+ line="2808">the new created `AdwLeaflet`</doc>
19096+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
19097+ </return-value>
19098+ </constructor>
19099+ <method name="append"
19100+ c:identifier="adw_leaflet_append"
19101+ deprecated="1"
19102+ deprecated-version="1.4">
19103+ <doc xml:space="preserve"
19104+ filename="src/adw-leaflet.c"
19105+ line="2818">Adds a child to @self.</doc>
19106+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19107+ <source-position filename="src/adw-leaflet.h" line="58"/>
19108+ <return-value transfer-ownership="none">
19109+ <doc xml:space="preserve"
19110+ filename="src/adw-leaflet.c"
19111+ line="2825">the [class@LeafletPage] for @child</doc>
19112+ <type name="LeafletPage" c:type="AdwLeafletPage*"/>
19113+ </return-value>
19114+ <parameters>
19115+ <instance-parameter name="self" transfer-ownership="none">
19116+ <doc xml:space="preserve"
19117+ filename="src/adw-leaflet.c"
19118+ line="2820">a leaflet</doc>
19119+ <type name="Leaflet" c:type="AdwLeaflet*"/>
19120+ </instance-parameter>
19121+ <parameter name="child" transfer-ownership="none">
19122+ <doc xml:space="preserve"
19123+ filename="src/adw-leaflet.c"
19124+ line="2821">the widget to add</doc>
19125+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
19126+ </parameter>
19127+ </parameters>
19128+ </method>
19129+ <method name="get_adjacent_child"
19130+ c:identifier="adw_leaflet_get_adjacent_child"
19131+ deprecated="1"
19132+ deprecated-version="1.4">
19133+ <doc xml:space="preserve"
19134+ filename="src/adw-leaflet.c"
19135+ line="3593">Finds the previous or next navigatable child.
19136+
19137+This will be the same child [method@Leaflet.navigate] or swipe gestures will
19138+navigate to.
19139+
19140+If there's no child to navigate to, `NULL` will be returned instead.
19141+
19142+See [property@LeafletPage:navigatable].</doc>
19143+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19144+ <source-position filename="src/adw-leaflet.h" line="148"/>
19145+ <return-value transfer-ownership="none" nullable="1">
19146+ <doc xml:space="preserve"
19147+ filename="src/adw-leaflet.c"
19148+ line="3607">the previous or next child</doc>
19149+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
19150+ </return-value>
19151+ <parameters>
19152+ <instance-parameter name="self" transfer-ownership="none">
19153+ <doc xml:space="preserve"
19154+ filename="src/adw-leaflet.c"
19155+ line="3595">a leaflet</doc>
19156+ <type name="Leaflet" c:type="AdwLeaflet*"/>
19157+ </instance-parameter>
19158+ <parameter name="direction" transfer-ownership="none">
19159+ <doc xml:space="preserve"
19160+ filename="src/adw-leaflet.c"
19161+ line="3596">the direction</doc>
19162+ <type name="NavigationDirection" c:type="AdwNavigationDirection"/>
19163+ </parameter>
19164+ </parameters>
19165+ </method>
19166+ <method name="get_can_navigate_back"
19167+ c:identifier="adw_leaflet_get_can_navigate_back"
19168+ glib:get-property="can-navigate-back"
19169+ deprecated="1"
19170+ deprecated-version="1.4">
19171+ <doc xml:space="preserve"
19172+ filename="src/adw-leaflet.c"
19173+ line="3473">Gets whether gestures and shortcuts for navigating backward are enabled.</doc>
19174+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19175+ <source-position filename="src/adw-leaflet.h" line="136"/>
19176+ <return-value transfer-ownership="none">
19177+ <doc xml:space="preserve"
19178+ filename="src/adw-leaflet.c"
19179+ line="3479">Whether gestures and shortcuts are enabled.</doc>
19180+ <type name="gboolean" c:type="gboolean"/>
19181+ </return-value>
19182+ <parameters>
19183+ <instance-parameter name="self" transfer-ownership="none">
19184+ <doc xml:space="preserve"
19185+ filename="src/adw-leaflet.c"
19186+ line="3475">a leaflet</doc>
19187+ <type name="Leaflet" c:type="AdwLeaflet*"/>
19188+ </instance-parameter>
19189+ </parameters>
19190+ </method>
19191+ <method name="get_can_navigate_forward"
19192+ c:identifier="adw_leaflet_get_can_navigate_forward"
19193+ glib:get-property="can-navigate-forward"
19194+ deprecated="1"
19195+ deprecated-version="1.4">
19196+ <doc xml:space="preserve"
19197+ filename="src/adw-leaflet.c"
19198+ line="3533">Gets whether gestures and shortcuts for navigating forward are enabled.</doc>
19199+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19200+ <source-position filename="src/adw-leaflet.h" line="142"/>
19201+ <return-value transfer-ownership="none">
19202+ <doc xml:space="preserve"
19203+ filename="src/adw-leaflet.c"
19204+ line="3539">Whether gestures and shortcuts are enabled.</doc>
19205+ <type name="gboolean" c:type="gboolean"/>
19206+ </return-value>
19207+ <parameters>
19208+ <instance-parameter name="self" transfer-ownership="none">
19209+ <doc xml:space="preserve"
19210+ filename="src/adw-leaflet.c"
19211+ line="3535">a leaflet</doc>
19212+ <type name="Leaflet" c:type="AdwLeaflet*"/>
19213+ </instance-parameter>
19214+ </parameters>
19215+ </method>
19216+ <method name="get_can_unfold"
19217+ c:identifier="adw_leaflet_get_can_unfold"
19218+ glib:get-property="can-unfold"
19219+ deprecated="1"
19220+ deprecated-version="1.4">
19221+ <doc xml:space="preserve"
19222+ filename="src/adw-leaflet.c"
19223+ line="3059">Gets whether @self can unfold.</doc>
19224+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19225+ <source-position filename="src/adw-leaflet.h" line="82"/>
19226+ <return-value transfer-ownership="none">
19227+ <doc xml:space="preserve"
19228+ filename="src/adw-leaflet.c"
19229+ line="3065">whether @self can unfold</doc>
19230+ <type name="gboolean" c:type="gboolean"/>
19231+ </return-value>
19232+ <parameters>
19233+ <instance-parameter name="self" transfer-ownership="none">
19234+ <doc xml:space="preserve"
19235+ filename="src/adw-leaflet.c"
19236+ line="3061">a leaflet</doc>
19237+ <type name="Leaflet" c:type="AdwLeaflet*"/>
19238+ </instance-parameter>
19239+ </parameters>
19240+ </method>
19241+ <method name="get_child_by_name"
19242+ c:identifier="adw_leaflet_get_child_by_name"
19243+ deprecated="1"
19244+ deprecated-version="1.4">
19245+ <doc xml:space="preserve"
19246+ filename="src/adw-leaflet.c"
19247+ line="3661">Finds the child of @self with @name.
19248+
19249+Returns `NULL` if there is no child with this name.
19250+
19251+See [property@LeafletPage:name].</doc>
19252+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19253+ <source-position filename="src/adw-leaflet.h" line="155"/>
19254+ <return-value transfer-ownership="none" nullable="1">
19255+ <doc xml:space="preserve"
19256+ filename="src/adw-leaflet.c"
19257+ line="3672">the requested child of @self</doc>
19258+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
19259+ </return-value>
19260+ <parameters>
19261+ <instance-parameter name="self" transfer-ownership="none">
19262+ <doc xml:space="preserve"
19263+ filename="src/adw-leaflet.c"
19264+ line="3663">a leaflet</doc>
19265+ <type name="Leaflet" c:type="AdwLeaflet*"/>
19266+ </instance-parameter>
19267+ <parameter name="name" transfer-ownership="none">
19268+ <doc xml:space="preserve"
19269+ filename="src/adw-leaflet.c"
19270+ line="3664">the name of the child to find</doc>
19271+ <type name="utf8" c:type="const char*"/>
19272+ </parameter>
19273+ </parameters>
19274+ </method>
19275+ <method name="get_child_transition_params"
19276+ c:identifier="adw_leaflet_get_child_transition_params"
19277+ glib:get-property="child-transition-params"
19278+ deprecated="1"
19279+ deprecated-version="1.4">
19280+ <doc xml:space="preserve"
19281+ filename="src/adw-leaflet.c"
19282+ line="3406">Gets the child transition spring parameters for @self.</doc>
19283+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19284+ <source-position filename="src/adw-leaflet.h" line="127"/>
19285+ <return-value transfer-ownership="full">
19286+ <doc xml:space="preserve"
19287+ filename="src/adw-leaflet.c"
19288+ line="3412">the child transition parameters</doc>
19289+ <type name="SpringParams" c:type="AdwSpringParams*"/>
19290+ </return-value>
19291+ <parameters>
19292+ <instance-parameter name="self" transfer-ownership="none">
19293+ <doc xml:space="preserve"
19294+ filename="src/adw-leaflet.c"
19295+ line="3408">a leaflet</doc>
19296+ <type name="Leaflet" c:type="AdwLeaflet*"/>
19297+ </instance-parameter>
19298+ </parameters>
19299+ </method>
19300+ <method name="get_child_transition_running"
19301+ c:identifier="adw_leaflet_get_child_transition_running"
19302+ glib:get-property="child-transition-running"
19303+ deprecated="1"
19304+ deprecated-version="1.4">
19305+ <doc xml:space="preserve"
19306+ filename="src/adw-leaflet.c"
19307+ line="3455">Gets whether a child transition is currently running for @self.</doc>
19308+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19309+ <source-position filename="src/adw-leaflet.h" line="133"/>
19310+ <return-value transfer-ownership="none">
19311+ <doc xml:space="preserve"
19312+ filename="src/adw-leaflet.c"
19313+ line="3461">whether a transition is currently running</doc>
19314+ <type name="gboolean" c:type="gboolean"/>
19315+ </return-value>
19316+ <parameters>
19317+ <instance-parameter name="self" transfer-ownership="none">
19318+ <doc xml:space="preserve"
19319+ filename="src/adw-leaflet.c"
19320+ line="3457">a leaflet</doc>
19321+ <type name="Leaflet" c:type="AdwLeaflet*"/>
19322+ </instance-parameter>
19323+ </parameters>
19324+ </method>
19325+ <method name="get_fold_threshold_policy"
19326+ c:identifier="adw_leaflet_get_fold_threshold_policy"
19327+ glib:get-property="fold-threshold-policy"
19328+ deprecated="1"
19329+ deprecated-version="1.4">
19330+ <doc xml:space="preserve"
19331+ filename="src/adw-leaflet.c"
19332+ line="3099">Gets the fold threshold policy for @self.</doc>
19333+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19334+ <source-position filename="src/adw-leaflet.h" line="91"/>
19335+ <return-value transfer-ownership="none">
19336+ <doc xml:space="preserve"
19337+ filename="src/adw-leaflet.c"
19338+ line="3105">the fold threshold policy</doc>
19339+ <type name="FoldThresholdPolicy" c:type="AdwFoldThresholdPolicy"/>
19340+ </return-value>
19341+ <parameters>
19342+ <instance-parameter name="self" transfer-ownership="none">
19343+ <doc xml:space="preserve"
19344+ filename="src/adw-leaflet.c"
19345+ line="3101">a leaflet</doc>
19346+ <type name="Leaflet" c:type="AdwLeaflet*"/>
19347+ </instance-parameter>
19348+ </parameters>
19349+ </method>
19350+ <method name="get_folded"
19351+ c:identifier="adw_leaflet_get_folded"
19352+ glib:get-property="folded"
19353+ deprecated="1"
19354+ deprecated-version="1.4">
19355+ <doc xml:space="preserve"
19356+ filename="src/adw-leaflet.c"
19357+ line="3077">Gets whether @self is folded.
19358+
19359+The leaflet will be folded if the size allocated to it is smaller than the
19360+sum of the minimum or natural sizes of the children (see
19361+[property@Leaflet:fold-threshold-policy]), it will be unfolded otherwise.</doc>
19362+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19363+ <source-position filename="src/adw-leaflet.h" line="88"/>
19364+ <return-value transfer-ownership="none">
19365+ <doc xml:space="preserve"
19366+ filename="src/adw-leaflet.c"
19367+ line="3087">whether @self is folded.</doc>
19368+ <type name="gboolean" c:type="gboolean"/>
19369+ </return-value>
19370+ <parameters>
19371+ <instance-parameter name="self" transfer-ownership="none">
19372+ <doc xml:space="preserve"
19373+ filename="src/adw-leaflet.c"
19374+ line="3079">a leaflet</doc>
19375+ <type name="Leaflet" c:type="AdwLeaflet*"/>
19376+ </instance-parameter>
19377+ </parameters>
19378+ </method>
19379+ <method name="get_homogeneous"
19380+ c:identifier="adw_leaflet_get_homogeneous"
19381+ glib:get-property="homogeneous"
19382+ deprecated="1"
19383+ deprecated-version="1.4">
19384+ <doc xml:space="preserve"
19385+ filename="src/adw-leaflet.c"
19386+ line="3151">Gets whether @self is homogeneous.</doc>
19387+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19388+ <source-position filename="src/adw-leaflet.h" line="97"/>
19389+ <return-value transfer-ownership="none">
19390+ <doc xml:space="preserve"
19391+ filename="src/adw-leaflet.c"
19392+ line="3157">whether @self is homogeneous</doc>
19393+ <type name="gboolean" c:type="gboolean"/>
19394+ </return-value>
19395+ <parameters>
19396+ <instance-parameter name="self" transfer-ownership="none">
19397+ <doc xml:space="preserve"
19398+ filename="src/adw-leaflet.c"
19399+ line="3153">a leaflet</doc>
19400+ <type name="Leaflet" c:type="AdwLeaflet*"/>
19401+ </instance-parameter>
19402+ </parameters>
19403+ </method>
19404+ <method name="get_mode_transition_duration"
19405+ c:identifier="adw_leaflet_get_mode_transition_duration"
19406+ glib:get-property="mode-transition-duration"
19407+ deprecated="1"
19408+ deprecated-version="1.4">
19409+ <doc xml:space="preserve"
19410+ filename="src/adw-leaflet.c"
19411+ line="3361">Gets the mode transition animation duration for @self.</doc>
19412+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19413+ <source-position filename="src/adw-leaflet.h" line="121"/>
19414+ <return-value transfer-ownership="none">
19415+ <doc xml:space="preserve"
19416+ filename="src/adw-leaflet.c"
19417+ line="3367">the mode transition duration, in milliseconds.</doc>
19418+ <type name="guint" c:type="guint"/>
19419+ </return-value>
19420+ <parameters>
19421+ <instance-parameter name="self" transfer-ownership="none">
19422+ <doc xml:space="preserve"
19423+ filename="src/adw-leaflet.c"
19424+ line="3363">a leaflet</doc>
19425+ <type name="Leaflet" c:type="AdwLeaflet*"/>
19426+ </instance-parameter>
19427+ </parameters>
19428+ </method>
19429+ <method name="get_page"
19430+ c:identifier="adw_leaflet_get_page"
19431+ deprecated="1"
19432+ deprecated-version="1.4">
19433+ <doc xml:space="preserve"
19434+ filename="src/adw-leaflet.c"
19435+ line="3011">Returns the [class@LeafletPage] object for @child.</doc>
19436+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19437+ <source-position filename="src/adw-leaflet.h" line="78"/>
19438+ <return-value transfer-ownership="none">
19439+ <doc xml:space="preserve"
19440+ filename="src/adw-leaflet.c"
19441+ line="3018">the page object for @child</doc>
19442+ <type name="LeafletPage" c:type="AdwLeafletPage*"/>
19443+ </return-value>
19444+ <parameters>
19445+ <instance-parameter name="self" transfer-ownership="none">
19446+ <doc xml:space="preserve"
19447+ filename="src/adw-leaflet.c"
19448+ line="3013">a leaflet</doc>
19449+ <type name="Leaflet" c:type="AdwLeaflet*"/>
19450+ </instance-parameter>
19451+ <parameter name="child" transfer-ownership="none">
19452+ <doc xml:space="preserve"
19453+ filename="src/adw-leaflet.c"
19454+ line="3014">a child of @self</doc>
19455+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
19456+ </parameter>
19457+ </parameters>
19458+ </method>
19459+ <method name="get_pages"
19460+ c:identifier="adw_leaflet_get_pages"
19461+ glib:get-property="pages"
19462+ deprecated="1"
19463+ deprecated-version="1.4">
19464+ <doc xml:space="preserve"
19465+ filename="src/adw-leaflet.c"
19466+ line="3690">Returns a [iface@Gio.ListModel] that contains the pages of the leaflet.
19467+
19468+This can be used to keep an up-to-date view. The model also implements
19469+[iface@Gtk.SelectionModel] and can be used to track and change the visible
19470+page.</doc>
19471+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19472+ <source-position filename="src/adw-leaflet.h" line="159"/>
19473+ <return-value transfer-ownership="full">
19474+ <doc xml:space="preserve"
19475+ filename="src/adw-leaflet.c"
19476+ line="3700">a `GtkSelectionModel` for the leaflet's children</doc>
19477+ <type name="Gtk.SelectionModel" c:type="GtkSelectionModel*"/>
19478+ </return-value>
19479+ <parameters>
19480+ <instance-parameter name="self" transfer-ownership="none">
19481+ <doc xml:space="preserve"
19482+ filename="src/adw-leaflet.c"
19483+ line="3692">a leaflet</doc>
19484+ <type name="Leaflet" c:type="AdwLeaflet*"/>
19485+ </instance-parameter>
19486+ </parameters>
19487+ </method>
19488+ <method name="get_transition_type"
19489+ c:identifier="adw_leaflet_get_transition_type"
19490+ glib:get-property="transition-type"
19491+ deprecated="1"
19492+ deprecated-version="1.4">
19493+ <doc xml:space="preserve"
19494+ filename="src/adw-leaflet.c"
19495+ line="3303">Gets the type of animation used for transitions between modes and children.</doc>
19496+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19497+ <source-position filename="src/adw-leaflet.h" line="115"/>
19498+ <return-value transfer-ownership="none">
19499+ <doc xml:space="preserve"
19500+ filename="src/adw-leaflet.c"
19501+ line="3309">the current transition type of @self</doc>
19502+ <type name="LeafletTransitionType"
19503+ c:type="AdwLeafletTransitionType"/>
19504+ </return-value>
19505+ <parameters>
19506+ <instance-parameter name="self" transfer-ownership="none">
19507+ <doc xml:space="preserve"
19508+ filename="src/adw-leaflet.c"
19509+ line="3305">a leaflet</doc>
19510+ <type name="Leaflet" c:type="AdwLeaflet*"/>
19511+ </instance-parameter>
19512+ </parameters>
19513+ </method>
19514+ <method name="get_visible_child"
19515+ c:identifier="adw_leaflet_get_visible_child"
19516+ glib:get-property="visible-child"
19517+ deprecated="1"
19518+ deprecated-version="1.4">
19519+ <doc xml:space="preserve"
19520+ filename="src/adw-leaflet.c"
19521+ line="3199">Gets the widget currently visible when the leaflet is folded.</doc>
19522+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19523+ <source-position filename="src/adw-leaflet.h" line="103"/>
19524+ <return-value transfer-ownership="none" nullable="1">
19525+ <doc xml:space="preserve"
19526+ filename="src/adw-leaflet.c"
19527+ line="3205">the visible child</doc>
19528+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
19529+ </return-value>
19530+ <parameters>
19531+ <instance-parameter name="self" transfer-ownership="none">
19532+ <doc xml:space="preserve"
19533+ filename="src/adw-leaflet.c"
19534+ line="3201">a leaflet</doc>
19535+ <type name="Leaflet" c:type="AdwLeaflet*"/>
19536+ </instance-parameter>
19537+ </parameters>
19538+ </method>
19539+ <method name="get_visible_child_name"
19540+ c:identifier="adw_leaflet_get_visible_child_name"
19541+ glib:get-property="visible-child-name"
19542+ deprecated="1"
19543+ deprecated-version="1.4">
19544+ <doc xml:space="preserve"
19545+ filename="src/adw-leaflet.c"
19546+ line="3253">Gets the name of the currently visible child widget.</doc>
19547+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19548+ <source-position filename="src/adw-leaflet.h" line="109"/>
19549+ <return-value transfer-ownership="none" nullable="1">
19550+ <doc xml:space="preserve"
19551+ filename="src/adw-leaflet.c"
19552+ line="3259">the name of the visible child</doc>
19553+ <type name="utf8" c:type="const char*"/>
19554+ </return-value>
19555+ <parameters>
19556+ <instance-parameter name="self" transfer-ownership="none">
19557+ <doc xml:space="preserve"
19558+ filename="src/adw-leaflet.c"
19559+ line="3255">a leaflet</doc>
19560+ <type name="Leaflet" c:type="AdwLeaflet*"/>
19561+ </instance-parameter>
19562+ </parameters>
19563+ </method>
19564+ <method name="insert_child_after"
19565+ c:identifier="adw_leaflet_insert_child_after"
19566+ deprecated="1"
19567+ deprecated-version="1.4">
19568+ <doc xml:space="preserve"
19569+ filename="src/adw-leaflet.c"
19570+ line="2869">Inserts @child in the position after @sibling in the list of children.
19571+
19572+If @sibling is `NULL`, inserts @child at the first position.</doc>
19573+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19574+ <source-position filename="src/adw-leaflet.h" line="65"/>
19575+ <return-value transfer-ownership="none">
19576+ <doc xml:space="preserve"
19577+ filename="src/adw-leaflet.c"
19578+ line="2879">the [class@LeafletPage] for @child</doc>
19579+ <type name="LeafletPage" c:type="AdwLeafletPage*"/>
19580+ </return-value>
19581+ <parameters>
19582+ <instance-parameter name="self" transfer-ownership="none">
19583+ <doc xml:space="preserve"
19584+ filename="src/adw-leaflet.c"
19585+ line="2871">a leaflet</doc>
19586+ <type name="Leaflet" c:type="AdwLeaflet*"/>
19587+ </instance-parameter>
19588+ <parameter name="child" transfer-ownership="none">
19589+ <doc xml:space="preserve"
19590+ filename="src/adw-leaflet.c"
19591+ line="2872">the widget to insert</doc>
19592+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
19593+ </parameter>
19594+ <parameter name="sibling"
19595+ transfer-ownership="none"
19596+ nullable="1"
19597+ allow-none="1">
19598+ <doc xml:space="preserve"
19599+ filename="src/adw-leaflet.c"
19600+ line="2873">the sibling after which to insert @child</doc>
19601+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
19602+ </parameter>
19603+ </parameters>
19604+ </method>
19605+ <method name="navigate"
19606+ c:identifier="adw_leaflet_navigate"
19607+ deprecated="1"
19608+ deprecated-version="1.4">
19609+ <doc xml:space="preserve"
19610+ filename="src/adw-leaflet.c"
19611+ line="3624">Navigates to the previous or next child.
19612+
19613+The child must have the [property@LeafletPage:navigatable] property set to
19614+`TRUE`, otherwise it will be skipped.
19615+
19616+This will be the same child as returned by
19617+[method@Leaflet.get_adjacent_child] or navigated to via swipe gestures.</doc>
19618+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19619+ <source-position filename="src/adw-leaflet.h" line="151"/>
19620+ <return-value transfer-ownership="none">
19621+ <doc xml:space="preserve"
19622+ filename="src/adw-leaflet.c"
19623+ line="3637">whether the visible child was changed</doc>
19624+ <type name="gboolean" c:type="gboolean"/>
19625+ </return-value>
19626+ <parameters>
19627+ <instance-parameter name="self" transfer-ownership="none">
19628+ <doc xml:space="preserve"
19629+ filename="src/adw-leaflet.c"
19630+ line="3626">a leaflet</doc>
19631+ <type name="Leaflet" c:type="AdwLeaflet*"/>
19632+ </instance-parameter>
19633+ <parameter name="direction" transfer-ownership="none">
19634+ <doc xml:space="preserve"
19635+ filename="src/adw-leaflet.c"
19636+ line="3627">the direction</doc>
19637+ <type name="NavigationDirection" c:type="AdwNavigationDirection"/>
19638+ </parameter>
19639+ </parameters>
19640+ </method>
19641+ <method name="prepend"
19642+ c:identifier="adw_leaflet_prepend"
19643+ deprecated="1"
19644+ deprecated-version="1.4">
19645+ <doc xml:space="preserve"
19646+ filename="src/adw-leaflet.c"
19647+ line="2847">Inserts @child at the first position in @self.</doc>
19648+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19649+ <source-position filename="src/adw-leaflet.h" line="61"/>
19650+ <return-value transfer-ownership="none">
19651+ <doc xml:space="preserve"
19652+ filename="src/adw-leaflet.c"
19653+ line="2854">the [class@LeafletPage] for @child</doc>
19654+ <type name="LeafletPage" c:type="AdwLeafletPage*"/>
19655+ </return-value>
19656+ <parameters>
19657+ <instance-parameter name="self" transfer-ownership="none">
19658+ <doc xml:space="preserve"
19659+ filename="src/adw-leaflet.c"
19660+ line="2849">a leaflet</doc>
19661+ <type name="Leaflet" c:type="AdwLeaflet*"/>
19662+ </instance-parameter>
19663+ <parameter name="child" transfer-ownership="none">
19664+ <doc xml:space="preserve"
19665+ filename="src/adw-leaflet.c"
19666+ line="2850">the widget to prepend</doc>
19667+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
19668+ </parameter>
19669+ </parameters>
19670+ </method>
19671+ <method name="remove"
19672+ c:identifier="adw_leaflet_remove"
19673+ deprecated="1"
19674+ deprecated-version="1.4">
19675+ <doc xml:space="preserve"
19676+ filename="src/adw-leaflet.c"
19677+ line="2978">Removes a child widget from @self.</doc>
19678+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19679+ <source-position filename="src/adw-leaflet.h" line="74"/>
19680+ <return-value transfer-ownership="none">
19681+ <type name="none" c:type="void"/>
19682+ </return-value>
19683+ <parameters>
19684+ <instance-parameter name="self" transfer-ownership="none">
19685+ <doc xml:space="preserve"
19686+ filename="src/adw-leaflet.c"
19687+ line="2980">a leaflet</doc>
19688+ <type name="Leaflet" c:type="AdwLeaflet*"/>
19689+ </instance-parameter>
19690+ <parameter name="child" transfer-ownership="none">
19691+ <doc xml:space="preserve"
19692+ filename="src/adw-leaflet.c"
19693+ line="2981">the child to remove</doc>
19694+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
19695+ </parameter>
19696+ </parameters>
19697+ </method>
19698+ <method name="reorder_child_after"
19699+ c:identifier="adw_leaflet_reorder_child_after"
19700+ deprecated="1"
19701+ deprecated-version="1.4">
19702+ <doc xml:space="preserve"
19703+ filename="src/adw-leaflet.c"
19704+ line="2908">Moves @child to the position after @sibling in the list of children.
19705+
19706+If @sibling is `NULL`, moves @child to the first position.</doc>
19707+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19708+ <source-position filename="src/adw-leaflet.h" line="69"/>
19709+ <return-value transfer-ownership="none">
19710+ <type name="none" c:type="void"/>
19711+ </return-value>
19712+ <parameters>
19713+ <instance-parameter name="self" transfer-ownership="none">
19714+ <doc xml:space="preserve"
19715+ filename="src/adw-leaflet.c"
19716+ line="2910">a leaflet</doc>
19717+ <type name="Leaflet" c:type="AdwLeaflet*"/>
19718+ </instance-parameter>
19719+ <parameter name="child" transfer-ownership="none">
19720+ <doc xml:space="preserve"
19721+ filename="src/adw-leaflet.c"
19722+ line="2911">the widget to move, must be a child of @self</doc>
19723+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
19724+ </parameter>
19725+ <parameter name="sibling"
19726+ transfer-ownership="none"
19727+ nullable="1"
19728+ allow-none="1">
19729+ <doc xml:space="preserve"
19730+ filename="src/adw-leaflet.c"
19731+ line="2912">the sibling to move @child after</doc>
19732+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
19733+ </parameter>
19734+ </parameters>
19735+ </method>
19736+ <method name="set_can_navigate_back"
19737+ c:identifier="adw_leaflet_set_can_navigate_back"
19738+ glib:set-property="can-navigate-back"
19739+ deprecated="1"
19740+ deprecated-version="1.4">
19741+ <doc xml:space="preserve"
19742+ filename="src/adw-leaflet.c"
19743+ line="3491">Sets whether gestures and shortcuts for navigating backward are enabled.
19744+
19745+The supported gestures are:
19746+
19747+- One-finger swipe on touchscreens
19748+- Horizontal scrolling on touchpads (usually two-finger swipe)
19749+- Back/forward mouse buttons
19750+
19751+The keyboard back/forward keys are also supported, as well as the
19752+&lt;kbd&gt;Alt&lt;/kbd&gt;+&lt;kbd&gt;←&lt;/kbd&gt; shortcut for horizontal orientation, or
19753+&lt;kbd&gt;Alt&lt;/kbd&gt;+&lt;kbd&gt;↑&lt;/kbd&gt; for vertical orientation.
19754+
19755+If the orientation is horizontal, for right-to-left locales, gestures and
19756+shortcuts are reversed.
19757+
19758+Only children that have [property@LeafletPage:navigatable] set to `TRUE` can
19759+be navigated to.</doc>
19760+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19761+ <source-position filename="src/adw-leaflet.h" line="138"/>
19762+ <return-value transfer-ownership="none">
19763+ <type name="none" c:type="void"/>
19764+ </return-value>
19765+ <parameters>
19766+ <instance-parameter name="self" transfer-ownership="none">
19767+ <doc xml:space="preserve"
19768+ filename="src/adw-leaflet.c"
19769+ line="3493">a leaflet</doc>
19770+ <type name="Leaflet" c:type="AdwLeaflet*"/>
19771+ </instance-parameter>
19772+ <parameter name="can_navigate_back" transfer-ownership="none">
19773+ <doc xml:space="preserve"
19774+ filename="src/adw-leaflet.c"
19775+ line="3494">the new value</doc>
19776+ <type name="gboolean" c:type="gboolean"/>
19777+ </parameter>
19778+ </parameters>
19779+ </method>
19780+ <method name="set_can_navigate_forward"
19781+ c:identifier="adw_leaflet_set_can_navigate_forward"
19782+ glib:set-property="can-navigate-forward"
19783+ deprecated="1"
19784+ deprecated-version="1.4">
19785+ <doc xml:space="preserve"
19786+ filename="src/adw-leaflet.c"
19787+ line="3551">Sets whether gestures and shortcuts for navigating forward are enabled.
19788+
19789+The supported gestures are:
19790+
19791+- One-finger swipe on touchscreens
19792+- Horizontal scrolling on touchpads (usually two-finger swipe)
19793+- Back/forward mouse buttons
19794+
19795+The keyboard back/forward keys are also supported, as well as the
19796+&lt;kbd&gt;Alt&lt;/kbd&gt;+&lt;kbd&gt;→&lt;/kbd&gt; shortcut for horizontal orientation, or
19797+&lt;kbd&gt;Alt&lt;/kbd&gt;+&lt;kbd&gt;↓&lt;/kbd&gt; for vertical orientation.
19798+
19799+If the orientation is horizontal, for right-to-left locales, gestures and
19800+shortcuts are reversed.
19801+
19802+Only children that have [property@LeafletPage:navigatable] set to `TRUE` can
19803+be navigated to.</doc>
19804+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19805+ <source-position filename="src/adw-leaflet.h" line="144"/>
19806+ <return-value transfer-ownership="none">
19807+ <type name="none" c:type="void"/>
19808+ </return-value>
19809+ <parameters>
19810+ <instance-parameter name="self" transfer-ownership="none">
19811+ <doc xml:space="preserve"
19812+ filename="src/adw-leaflet.c"
19813+ line="3553">a leaflet</doc>
19814+ <type name="Leaflet" c:type="AdwLeaflet*"/>
19815+ </instance-parameter>
19816+ <parameter name="can_navigate_forward" transfer-ownership="none">
19817+ <doc xml:space="preserve"
19818+ filename="src/adw-leaflet.c"
19819+ line="3554">the new value</doc>
19820+ <type name="gboolean" c:type="gboolean"/>
19821+ </parameter>
19822+ </parameters>
19823+ </method>
19824+ <method name="set_can_unfold"
19825+ c:identifier="adw_leaflet_set_can_unfold"
19826+ glib:set-property="can-unfold"
19827+ deprecated="1"
19828+ deprecated-version="1.4">
19829+ <doc xml:space="preserve"
19830+ filename="src/adw-leaflet.c"
19831+ line="3032">Sets whether @self can unfold.</doc>
19832+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19833+ <source-position filename="src/adw-leaflet.h" line="84"/>
19834+ <return-value transfer-ownership="none">
19835+ <type name="none" c:type="void"/>
19836+ </return-value>
19837+ <parameters>
19838+ <instance-parameter name="self" transfer-ownership="none">
19839+ <doc xml:space="preserve"
19840+ filename="src/adw-leaflet.c"
19841+ line="3034">a leaflet</doc>
19842+ <type name="Leaflet" c:type="AdwLeaflet*"/>
19843+ </instance-parameter>
19844+ <parameter name="can_unfold" transfer-ownership="none">
19845+ <doc xml:space="preserve"
19846+ filename="src/adw-leaflet.c"
19847+ line="3035">whether @self can unfold</doc>
19848+ <type name="gboolean" c:type="gboolean"/>
19849+ </parameter>
19850+ </parameters>
19851+ </method>
19852+ <method name="set_child_transition_params"
19853+ c:identifier="adw_leaflet_set_child_transition_params"
19854+ glib:set-property="child-transition-params"
19855+ deprecated="1"
19856+ deprecated-version="1.4">
19857+ <doc xml:space="preserve"
19858+ filename="src/adw-leaflet.c"
19859+ line="3424">Sets the child transition spring parameters for @self.
19860+
19861+The default value is equivalent to:
19862+
19863+```c
19864+adw_spring_params_new (1, 0.5, 500)
19865+```</doc>
19866+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19867+ <source-position filename="src/adw-leaflet.h" line="129"/>
19868+ <return-value transfer-ownership="none">
19869+ <type name="none" c:type="void"/>
19870+ </return-value>
19871+ <parameters>
19872+ <instance-parameter name="self" transfer-ownership="none">
19873+ <doc xml:space="preserve"
19874+ filename="src/adw-leaflet.c"
19875+ line="3426">a leaflet</doc>
19876+ <type name="Leaflet" c:type="AdwLeaflet*"/>
19877+ </instance-parameter>
19878+ <parameter name="params" transfer-ownership="none">
19879+ <doc xml:space="preserve"
19880+ filename="src/adw-leaflet.c"
19881+ line="3427">the new parameters</doc>
19882+ <type name="SpringParams" c:type="AdwSpringParams*"/>
19883+ </parameter>
19884+ </parameters>
19885+ </method>
19886+ <method name="set_fold_threshold_policy"
19887+ c:identifier="adw_leaflet_set_fold_threshold_policy"
19888+ glib:set-property="fold-threshold-policy"
19889+ deprecated="1"
19890+ deprecated-version="1.4">
19891+ <doc xml:space="preserve"
19892+ filename="src/adw-leaflet.c"
19893+ line="3118">Sets the fold threshold policy for @self.
19894+
19895+If set to `ADW_FOLD_THRESHOLD_POLICY_MINIMUM`, it will only fold when the
19896+children cannot fit anymore. With `ADW_FOLD_THRESHOLD_POLICY_NATURAL`, it
19897+will fold as soon as children don't get their natural size.
19898+
19899+This can be useful if you have a long ellipsizing label and want to let it
19900+ellipsize instead of immediately folding.</doc>
19901+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19902+ <source-position filename="src/adw-leaflet.h" line="93"/>
19903+ <return-value transfer-ownership="none">
19904+ <type name="none" c:type="void"/>
19905+ </return-value>
19906+ <parameters>
19907+ <instance-parameter name="self" transfer-ownership="none">
19908+ <doc xml:space="preserve"
19909+ filename="src/adw-leaflet.c"
19910+ line="3120">a leaflet</doc>
19911+ <type name="Leaflet" c:type="AdwLeaflet*"/>
19912+ </instance-parameter>
19913+ <parameter name="policy" transfer-ownership="none">
19914+ <doc xml:space="preserve"
19915+ filename="src/adw-leaflet.c"
19916+ line="3121">the policy to use</doc>
19917+ <type name="FoldThresholdPolicy" c:type="AdwFoldThresholdPolicy"/>
19918+ </parameter>
19919+ </parameters>
19920+ </method>
19921+ <method name="set_homogeneous"
19922+ c:identifier="adw_leaflet_set_homogeneous"
19923+ glib:set-property="homogeneous"
19924+ deprecated="1"
19925+ deprecated-version="1.4">
19926+ <doc xml:space="preserve"
19927+ filename="src/adw-leaflet.c"
19928+ line="3169">Sets @self to be homogeneous or not.
19929+
19930+If set to `FALSE`, different children can have different size along the
19931+opposite orientation.</doc>
19932+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19933+ <source-position filename="src/adw-leaflet.h" line="99"/>
19934+ <return-value transfer-ownership="none">
19935+ <type name="none" c:type="void"/>
19936+ </return-value>
19937+ <parameters>
19938+ <instance-parameter name="self" transfer-ownership="none">
19939+ <doc xml:space="preserve"
19940+ filename="src/adw-leaflet.c"
19941+ line="3171">a leaflet</doc>
19942+ <type name="Leaflet" c:type="AdwLeaflet*"/>
19943+ </instance-parameter>
19944+ <parameter name="homogeneous" transfer-ownership="none">
19945+ <doc xml:space="preserve"
19946+ filename="src/adw-leaflet.c"
19947+ line="3172">whether to make @self homogeneous</doc>
19948+ <type name="gboolean" c:type="gboolean"/>
19949+ </parameter>
19950+ </parameters>
19951+ </method>
19952+ <method name="set_mode_transition_duration"
19953+ c:identifier="adw_leaflet_set_mode_transition_duration"
19954+ glib:set-property="mode-transition-duration"
19955+ deprecated="1"
19956+ deprecated-version="1.4">
19957+ <doc xml:space="preserve"
19958+ filename="src/adw-leaflet.c"
19959+ line="3379">Sets the mode transition animation duration for @self.</doc>
19960+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19961+ <source-position filename="src/adw-leaflet.h" line="123"/>
19962+ <return-value transfer-ownership="none">
19963+ <type name="none" c:type="void"/>
19964+ </return-value>
19965+ <parameters>
19966+ <instance-parameter name="self" transfer-ownership="none">
19967+ <doc xml:space="preserve"
19968+ filename="src/adw-leaflet.c"
19969+ line="3381">a leaflet</doc>
19970+ <type name="Leaflet" c:type="AdwLeaflet*"/>
19971+ </instance-parameter>
19972+ <parameter name="duration" transfer-ownership="none">
19973+ <doc xml:space="preserve"
19974+ filename="src/adw-leaflet.c"
19975+ line="3382">the new duration, in milliseconds</doc>
19976+ <type name="guint" c:type="guint"/>
19977+ </parameter>
19978+ </parameters>
19979+ </method>
19980+ <method name="set_transition_type"
19981+ c:identifier="adw_leaflet_set_transition_type"
19982+ glib:set-property="transition-type"
19983+ deprecated="1"
19984+ deprecated-version="1.4">
19985+ <doc xml:space="preserve"
19986+ filename="src/adw-leaflet.c"
19987+ line="3321">Sets the type of animation used for transitions between modes and children.
19988+
19989+The transition type can be changed without problems at runtime, so it is
19990+possible to change the animation based on the mode or child that is about to
19991+become current.</doc>
19992+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
19993+ <source-position filename="src/adw-leaflet.h" line="117"/>
19994+ <return-value transfer-ownership="none">
19995+ <type name="none" c:type="void"/>
19996+ </return-value>
19997+ <parameters>
19998+ <instance-parameter name="self" transfer-ownership="none">
19999+ <doc xml:space="preserve"
20000+ filename="src/adw-leaflet.c"
20001+ line="3323">a leaflet</doc>
20002+ <type name="Leaflet" c:type="AdwLeaflet*"/>
20003+ </instance-parameter>
20004+ <parameter name="transition" transfer-ownership="none">
20005+ <doc xml:space="preserve"
20006+ filename="src/adw-leaflet.c"
20007+ line="3324">the new transition type</doc>
20008+ <type name="LeafletTransitionType"
20009+ c:type="AdwLeafletTransitionType"/>
20010+ </parameter>
20011+ </parameters>
20012+ </method>
20013+ <method name="set_visible_child"
20014+ c:identifier="adw_leaflet_set_visible_child"
20015+ glib:set-property="visible-child"
20016+ deprecated="1"
20017+ deprecated-version="1.4">
20018+ <doc xml:space="preserve"
20019+ filename="src/adw-leaflet.c"
20020+ line="3220">Sets the widget currently visible when the leaflet is folded.
20021+
20022+The transition is determined by [property@Leaflet:transition-type] and
20023+[property@Leaflet:child-transition-params]. The transition can be cancelled
20024+by the user, in which case visible child will change back to the previously
20025+visible child.</doc>
20026+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
20027+ <source-position filename="src/adw-leaflet.h" line="105"/>
20028+ <return-value transfer-ownership="none">
20029+ <type name="none" c:type="void"/>
20030+ </return-value>
20031+ <parameters>
20032+ <instance-parameter name="self" transfer-ownership="none">
20033+ <doc xml:space="preserve"
20034+ filename="src/adw-leaflet.c"
20035+ line="3222">a leaflet</doc>
20036+ <type name="Leaflet" c:type="AdwLeaflet*"/>
20037+ </instance-parameter>
20038+ <parameter name="visible_child" transfer-ownership="none">
20039+ <doc xml:space="preserve"
20040+ filename="src/adw-leaflet.c"
20041+ line="3223">the new child</doc>
20042+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
20043+ </parameter>
20044+ </parameters>
20045+ </method>
20046+ <method name="set_visible_child_name"
20047+ c:identifier="adw_leaflet_set_visible_child_name"
20048+ glib:set-property="visible-child-name"
20049+ deprecated="1"
20050+ deprecated-version="1.4">
20051+ <doc xml:space="preserve"
20052+ filename="src/adw-leaflet.c"
20053+ line="3274">Makes the child with the name @name visible.
20054+
20055+See [property@Leaflet:visible-child].</doc>
20056+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
20057+ <source-position filename="src/adw-leaflet.h" line="111"/>
20058+ <return-value transfer-ownership="none">
20059+ <type name="none" c:type="void"/>
20060+ </return-value>
20061+ <parameters>
20062+ <instance-parameter name="self" transfer-ownership="none">
20063+ <doc xml:space="preserve"
20064+ filename="src/adw-leaflet.c"
20065+ line="3276">a leaflet</doc>
20066+ <type name="Leaflet" c:type="AdwLeaflet*"/>
20067+ </instance-parameter>
20068+ <parameter name="name" transfer-ownership="none">
20069+ <doc xml:space="preserve"
20070+ filename="src/adw-leaflet.c"
20071+ line="3277">the name of a child</doc>
20072+ <type name="utf8" c:type="const char*"/>
20073+ </parameter>
20074+ </parameters>
20075+ </method>
20076+ <property name="can-navigate-back"
20077+ deprecated="1"
20078+ deprecated-version="1.4"
20079+ writable="1"
20080+ transfer-ownership="none"
20081+ setter="set_can_navigate_back"
20082+ getter="get_can_navigate_back"
20083+ default-value="FALSE">
20084+ <doc xml:space="preserve"
20085+ filename="src/adw-leaflet.c"
20086+ line="2331">Whether gestures and shortcuts for navigating backward are enabled.
20087+
20088+The supported gestures are:
20089+
20090+- One-finger swipe on touchscreens
20091+- Horizontal scrolling on touchpads (usually two-finger swipe)
20092+- Back/forward mouse buttons
20093+
20094+The keyboard back/forward keys are also supported, as well as the
20095+&lt;kbd&gt;Alt&lt;/kbd&gt;+&lt;kbd&gt;←&lt;/kbd&gt; shortcut for horizontal orientation, or
20096+&lt;kbd&gt;Alt&lt;/kbd&gt;+&lt;kbd&gt;↑&lt;/kbd&gt; for vertical orientation.
20097+
20098+If the orientation is horizontal, for right-to-left locales, gestures and
20099+shortcuts are reversed.
20100+
20101+Only children that have [property@LeafletPage:navigatable] set to `TRUE`
20102+can be navigated to.</doc>
20103+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
20104+ <type name="gboolean" c:type="gboolean"/>
20105+ </property>
20106+ <property name="can-navigate-forward"
20107+ deprecated="1"
20108+ deprecated-version="1.4"
20109+ writable="1"
20110+ transfer-ownership="none"
20111+ setter="set_can_navigate_forward"
20112+ getter="get_can_navigate_forward"
20113+ default-value="FALSE">
20114+ <doc xml:space="preserve"
20115+ filename="src/adw-leaflet.c"
20116+ line="2359">Whether gestures and shortcuts for navigating forward are enabled.
20117+
20118+The supported gestures are:
20119+
20120+- One-finger swipe on touchscreens
20121+- Horizontal scrolling on touchpads (usually two-finger swipe)
20122+- Back/forward mouse buttons
20123+
20124+The keyboard back/forward keys are also supported, as well as the
20125+&lt;kbd&gt;Alt&lt;/kbd&gt;+&lt;kbd&gt;→&lt;/kbd&gt; shortcut for horizontal orientation, or
20126+&lt;kbd&gt;Alt&lt;/kbd&gt;+&lt;kbd&gt;↓&lt;/kbd&gt; for vertical orientation.
20127+
20128+If the orientation is horizontal, for right-to-left locales, gestures and
20129+shortcuts are reversed.
20130+
20131+Only children that have [property@LeafletPage:navigatable] set to `TRUE`
20132+can be navigated to.</doc>
20133+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
20134+ <type name="gboolean" c:type="gboolean"/>
20135+ </property>
20136+ <property name="can-unfold"
20137+ deprecated="1"
20138+ deprecated-version="1.4"
20139+ writable="1"
20140+ transfer-ownership="none"
20141+ setter="set_can_unfold"
20142+ getter="get_can_unfold"
20143+ default-value="TRUE">
20144+ <doc xml:space="preserve"
20145+ filename="src/adw-leaflet.c"
20146+ line="2179">Whether or not the leaflet can unfold.</doc>
20147+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
20148+ <type name="gboolean" c:type="gboolean"/>
20149+ </property>
20150+ <property name="child-transition-params"
20151+ deprecated="1"
20152+ deprecated-version="1.4"
20153+ writable="1"
20154+ transfer-ownership="none"
20155+ setter="set_child_transition_params"
20156+ getter="get_child_transition_params">
20157+ <doc xml:space="preserve"
20158+ filename="src/adw-leaflet.c"
20159+ line="2301">The child transition spring parameters.
20160+
20161+The default value is equivalent to:
20162+
20163+```c
20164+adw_spring_params_new (1, 0.5, 500)
20165+```</doc>
20166+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
20167+ <type name="SpringParams"/>
20168+ </property>
20169+ <property name="child-transition-running"
20170+ deprecated="1"
20171+ deprecated-version="1.4"
20172+ transfer-ownership="none"
20173+ getter="get_child_transition_running"
20174+ default-value="FALSE">
20175+ <doc xml:space="preserve"
20176+ filename="src/adw-leaflet.c"
20177+ line="2319">Whether a child transition is currently running.</doc>
20178+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
20179+ <type name="gboolean" c:type="gboolean"/>
20180+ </property>
20181+ <property name="fold-threshold-policy"
20182+ deprecated="1"
20183+ deprecated-version="1.4"
20184+ writable="1"
20185+ transfer-ownership="none"
20186+ setter="set_fold_threshold_policy"
20187+ getter="get_fold_threshold_policy"
20188+ default-value="ADW_FOLD_THRESHOLD_POLICY_MINIMUM">
20189+ <doc xml:space="preserve"
20190+ filename="src/adw-leaflet.c"
20191+ line="2207">Determines when the leaflet will fold.
20192+
20193+If set to `ADW_FOLD_THRESHOLD_POLICY_MINIMUM`, it will only fold when the
20194+children cannot fit anymore. With `ADW_FOLD_THRESHOLD_POLICY_NATURAL`, it
20195+will fold as soon as children don't get their natural size.
20196+
20197+This can be useful if you have a long ellipsizing label and want to let it
20198+ellipsize instead of immediately folding.</doc>
20199+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
20200+ <type name="FoldThresholdPolicy"/>
20201+ </property>
20202+ <property name="folded"
20203+ deprecated="1"
20204+ deprecated-version="1.4"
20205+ transfer-ownership="none"
20206+ getter="get_folded"
20207+ default-value="FALSE">
20208+ <doc xml:space="preserve"
20209+ filename="src/adw-leaflet.c"
20210+ line="2191">Whether the leaflet is folded.
20211+
20212+The leaflet will be folded if the size allocated to it is smaller than the
20213+sum of the minimum or natural sizes of the children (see
20214+[property@Leaflet:fold-threshold-policy]), it will be unfolded otherwise.</doc>
20215+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
20216+ <type name="gboolean" c:type="gboolean"/>
20217+ </property>
20218+ <property name="homogeneous"
20219+ deprecated="1"
20220+ deprecated-version="1.4"
20221+ writable="1"
20222+ transfer-ownership="none"
20223+ setter="set_homogeneous"
20224+ getter="get_homogeneous"
20225+ default-value="TRUE">
20226+ <doc xml:space="preserve"
20227+ filename="src/adw-leaflet.c"
20228+ line="2227">Whether the leaflet allocates the same size for all children when folded.
20229+
20230+If set to `FALSE`, different children can have different size along the
20231+opposite orientation.</doc>
20232+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
20233+ <type name="gboolean" c:type="gboolean"/>
20234+ </property>
20235+ <property name="mode-transition-duration"
20236+ deprecated="1"
20237+ deprecated-version="1.4"
20238+ writable="1"
20239+ transfer-ownership="none"
20240+ setter="set_mode_transition_duration"
20241+ getter="get_mode_transition_duration"
20242+ default-value="250">
20243+ <doc xml:space="preserve"
20244+ filename="src/adw-leaflet.c"
20245+ line="2289">The mode transition animation duration, in milliseconds.</doc>
20246+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
20247+ <type name="guint" c:type="guint"/>
20248+ </property>
20249+ <property name="pages"
20250+ deprecated="1"
20251+ deprecated-version="1.4"
20252+ transfer-ownership="none"
20253+ getter="get_pages">
20254+ <doc xml:space="preserve"
20255+ filename="src/adw-leaflet.c"
20256+ line="2387">A selection model with the leaflet's pages.
20257+
20258+This can be used to keep an up-to-date view. The model also implements
20259+[iface@Gtk.SelectionModel] and can be used to track and change the visible
20260+page.</doc>
20261+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
20262+ <type name="Gtk.SelectionModel"/>
20263+ </property>
20264+ <property name="transition-type"
20265+ deprecated="1"
20266+ deprecated-version="1.4"
20267+ writable="1"
20268+ transfer-ownership="none"
20269+ setter="set_transition_type"
20270+ getter="get_transition_type"
20271+ default-value="ADW_LEAFLET_TRANSITION_TYPE_OVER">
20272+ <doc xml:space="preserve"
20273+ filename="src/adw-leaflet.c"
20274+ line="2273">The type of animation used for transitions between modes and children.
20275+
20276+The transition type can be changed without problems at runtime, so it is
20277+possible to change the animation based on the mode or child that is about
20278+to become current.</doc>
20279+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
20280+ <type name="LeafletTransitionType"/>
20281+ </property>
20282+ <property name="visible-child"
20283+ deprecated="1"
20284+ deprecated-version="1.4"
20285+ writable="1"
20286+ transfer-ownership="none"
20287+ setter="set_visible_child"
20288+ getter="get_visible_child">
20289+ <doc xml:space="preserve"
20290+ filename="src/adw-leaflet.c"
20291+ line="2242">The widget currently visible when the leaflet is folded.
20292+
20293+The transition is determined by [property@Leaflet:transition-type] and
20294+[property@Leaflet:child-transition-params]. The transition can be cancelled
20295+by the user, in which case visible child will change back to the previously
20296+visible child.</doc>
20297+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
20298+ <type name="Gtk.Widget"/>
20299+ </property>
20300+ <property name="visible-child-name"
20301+ deprecated="1"
20302+ deprecated-version="1.4"
20303+ writable="1"
20304+ transfer-ownership="none"
20305+ setter="set_visible_child_name"
20306+ getter="get_visible_child_name"
20307+ default-value="NULL">
20308+ <doc xml:space="preserve"
20309+ filename="src/adw-leaflet.c"
20310+ line="2259">The name of the widget currently visible when the leaflet is folded.
20311+
20312+See [property@Leaflet:visible-child].</doc>
20313+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
20314+ <type name="utf8" c:type="gchar*"/>
20315+ </property>
20316+ </class>
20317+ <record name="LeafletClass"
20318+ c:type="AdwLeafletClass"
20319+ glib:is-gtype-struct-for="Leaflet">
20320+ <source-position filename="src/adw-leaflet.h" line="46"/>
20321+ <field name="parent_class">
20322+ <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
20323+ </field>
20324+ </record>
20325+ <class name="LeafletPage"
20326+ c:symbol-prefix="leaflet_page"
20327+ c:type="AdwLeafletPage"
20328+ deprecated="1"
20329+ deprecated-version="1.4"
20330+ parent="GObject.Object"
20331+ final="1"
20332+ glib:type-name="AdwLeafletPage"
20333+ glib:get-type="adw_leaflet_page_get_type"
20334+ glib:type-struct="LeafletPageClass">
20335+ <doc xml:space="preserve"
20336+ filename="src/adw-leaflet.c"
20337+ line="59">An auxiliary class used by [class@Leaflet].</doc>
20338+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
20339+ <source-position filename="src/adw-leaflet.h" line="26"/>
20340+ <method name="get_child"
20341+ c:identifier="adw_leaflet_page_get_child"
20342+ glib:get-property="child"
20343+ deprecated="1"
20344+ deprecated-version="1.4">
20345+ <doc xml:space="preserve"
20346+ filename="src/adw-leaflet.c"
20347+ line="2665">Gets the leaflet child to which @self belongs.</doc>
20348+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
20349+ <source-position filename="src/adw-leaflet.h" line="29"/>
20350+ <return-value transfer-ownership="none">
20351+ <doc xml:space="preserve"
20352+ filename="src/adw-leaflet.c"
20353+ line="2671">the child to which @self belongs</doc>
20354+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
20355+ </return-value>
20356+ <parameters>
20357+ <instance-parameter name="self" transfer-ownership="none">
20358+ <doc xml:space="preserve"
20359+ filename="src/adw-leaflet.c"
20360+ line="2667">a leaflet page</doc>
20361+ <type name="LeafletPage" c:type="AdwLeafletPage*"/>
20362+ </instance-parameter>
20363+ </parameters>
20364+ </method>
20365+ <method name="get_name"
20366+ c:identifier="adw_leaflet_page_get_name"
20367+ glib:get-property="name"
20368+ deprecated="1"
20369+ deprecated-version="1.4">
20370+ <doc xml:space="preserve"
20371+ filename="src/adw-leaflet.c"
20372+ line="2683">Gets the name of @self.</doc>
20373+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
20374+ <source-position filename="src/adw-leaflet.h" line="32"/>
20375+ <return-value transfer-ownership="none" nullable="1">
20376+ <doc xml:space="preserve"
20377+ filename="src/adw-leaflet.c"
20378+ line="2689">the name of @self.</doc>
20379+ <type name="utf8" c:type="const char*"/>
20380+ </return-value>
20381+ <parameters>
20382+ <instance-parameter name="self" transfer-ownership="none">
20383+ <doc xml:space="preserve"
20384+ filename="src/adw-leaflet.c"
20385+ line="2685">a leaflet page</doc>
20386+ <type name="LeafletPage" c:type="AdwLeafletPage*"/>
20387+ </instance-parameter>
20388+ </parameters>
20389+ </method>
20390+ <method name="get_navigatable"
20391+ c:identifier="adw_leaflet_page_get_navigatable"
20392+ glib:get-property="navigatable"
20393+ deprecated="1"
20394+ deprecated-version="1.4">
20395+ <doc xml:space="preserve"
20396+ filename="src/adw-leaflet.c"
20397+ line="2748">Gets whether the child can be navigated to when folded.</doc>
20398+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
20399+ <source-position filename="src/adw-leaflet.h" line="38"/>
20400+ <return-value transfer-ownership="none">
20401+ <doc xml:space="preserve"
20402+ filename="src/adw-leaflet.c"
20403+ line="2754">whether @self can be navigated to when folded</doc>
20404+ <type name="gboolean" c:type="gboolean"/>
20405+ </return-value>
20406+ <parameters>
20407+ <instance-parameter name="self" transfer-ownership="none">
20408+ <doc xml:space="preserve"
20409+ filename="src/adw-leaflet.c"
20410+ line="2750">a leaflet page</doc>
20411+ <type name="LeafletPage" c:type="AdwLeafletPage*"/>
20412+ </instance-parameter>
20413+ </parameters>
20414+ </method>
20415+ <method name="set_name"
20416+ c:identifier="adw_leaflet_page_set_name"
20417+ glib:set-property="name"
20418+ deprecated="1"
20419+ deprecated-version="1.4">
20420+ <doc xml:space="preserve"
20421+ filename="src/adw-leaflet.c"
20422+ line="2701">Sets the name of the @self.</doc>
20423+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
20424+ <source-position filename="src/adw-leaflet.h" line="34"/>
20425+ <return-value transfer-ownership="none">
20426+ <type name="none" c:type="void"/>
20427+ </return-value>
20428+ <parameters>
20429+ <instance-parameter name="self" transfer-ownership="none">
20430+ <doc xml:space="preserve"
20431+ filename="src/adw-leaflet.c"
20432+ line="2703">a leaflet page</doc>
20433+ <type name="LeafletPage" c:type="AdwLeafletPage*"/>
20434+ </instance-parameter>
20435+ <parameter name="name"
20436+ transfer-ownership="none"
20437+ nullable="1"
20438+ allow-none="1">
20439+ <doc xml:space="preserve"
20440+ filename="src/adw-leaflet.c"
20441+ line="2704">the new value to set</doc>
20442+ <type name="utf8" c:type="const char*"/>
20443+ </parameter>
20444+ </parameters>
20445+ </method>
20446+ <method name="set_navigatable"
20447+ c:identifier="adw_leaflet_page_set_navigatable"
20448+ glib:set-property="navigatable"
20449+ deprecated="1"
20450+ deprecated-version="1.4">
20451+ <doc xml:space="preserve"
20452+ filename="src/adw-leaflet.c"
20453+ line="2766">Sets whether @self can be navigated to when folded.
20454+
20455+If `FALSE`, the child will be ignored by [method@Leaflet.get_adjacent_child],
20456+[method@Leaflet.navigate], and swipe gestures.
20457+
20458+This can be used used to prevent switching to widgets like separators.</doc>
20459+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
20460+ <source-position filename="src/adw-leaflet.h" line="40"/>
20461+ <return-value transfer-ownership="none">
20462+ <type name="none" c:type="void"/>
20463+ </return-value>
20464+ <parameters>
20465+ <instance-parameter name="self" transfer-ownership="none">
20466+ <doc xml:space="preserve"
20467+ filename="src/adw-leaflet.c"
20468+ line="2768">a leaflet page</doc>
20469+ <type name="LeafletPage" c:type="AdwLeafletPage*"/>
20470+ </instance-parameter>
20471+ <parameter name="navigatable" transfer-ownership="none">
20472+ <doc xml:space="preserve"
20473+ filename="src/adw-leaflet.c"
20474+ line="2769">whether @self can be navigated to when folded</doc>
20475+ <type name="gboolean" c:type="gboolean"/>
20476+ </parameter>
20477+ </parameters>
20478+ </method>
20479+ <property name="child"
20480+ deprecated="1"
20481+ deprecated-version="1.4"
20482+ writable="1"
20483+ construct-only="1"
20484+ transfer-ownership="none"
20485+ getter="get_child">
20486+ <doc xml:space="preserve"
20487+ filename="src/adw-leaflet.c"
20488+ line="275">The leaflet child to which the page belongs.</doc>
20489+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
20490+ <type name="Gtk.Widget"/>
20491+ </property>
20492+ <property name="name"
20493+ deprecated="1"
20494+ deprecated-version="1.4"
20495+ writable="1"
20496+ transfer-ownership="none"
20497+ setter="set_name"
20498+ getter="get_name"
20499+ default-value="NULL">
20500+ <doc xml:space="preserve"
20501+ filename="src/adw-leaflet.c"
20502+ line="287">The name of the child page.</doc>
20503+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
20504+ <type name="utf8" c:type="gchar*"/>
20505+ </property>
20506+ <property name="navigatable"
20507+ deprecated="1"
20508+ deprecated-version="1.4"
20509+ writable="1"
20510+ transfer-ownership="none"
20511+ setter="set_navigatable"
20512+ getter="get_navigatable"
20513+ default-value="TRUE">
20514+ <doc xml:space="preserve"
20515+ filename="src/adw-leaflet.c"
20516+ line="299">Whether the child can be navigated to when folded.
20517+
20518+If `FALSE`, the child will be ignored by
20519+[method@Leaflet.get_adjacent_child], [method@Leaflet.navigate], and swipe
20520+gestures.
20521+
20522+This can be used used to prevent switching to widgets like separators.</doc>
20523+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
20524+ <type name="gboolean" c:type="gboolean"/>
20525+ </property>
20526+ </class>
20527+ <record name="LeafletPageClass"
20528+ c:type="AdwLeafletPageClass"
20529+ glib:is-gtype-struct-for="LeafletPage">
20530+ <source-position filename="src/adw-leaflet.h" line="26"/>
20531+ <field name="parent_class">
20532+ <type name="GObject.ObjectClass" c:type="GObjectClass"/>
20533+ </field>
20534+ </record>
20535+ <enumeration name="LeafletTransitionType"
20536+ deprecated="1"
20537+ deprecated-version="1.4"
20538+ glib:type-name="AdwLeafletTransitionType"
20539+ glib:get-type="adw_leaflet_transition_type_get_type"
20540+ c:type="AdwLeafletTransitionType">
20541+ <doc xml:space="preserve"
20542+ filename="src/adw-leaflet.c"
20543+ line="67">Describes the possible transitions in a [class@Leaflet] widget.
20544+
20545+New values may be added to this enumeration over time.</doc>
20546+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwleaflet)</doc-deprecated>
20547+ <member name="over"
20548+ value="0"
20549+ c:identifier="ADW_LEAFLET_TRANSITION_TYPE_OVER"
20550+ glib:nick="over"
20551+ glib:name="ADW_LEAFLET_TRANSITION_TYPE_OVER">
20552+ <doc xml:space="preserve"
20553+ filename="src/adw-leaflet.c"
20554+ line="69">Cover the old page or uncover the new page, sliding from or towards the end according to orientation, text direction and children order</doc>
20555+ </member>
20556+ <member name="under"
20557+ value="1"
20558+ c:identifier="ADW_LEAFLET_TRANSITION_TYPE_UNDER"
20559+ glib:nick="under"
20560+ glib:name="ADW_LEAFLET_TRANSITION_TYPE_UNDER">
20561+ <doc xml:space="preserve"
20562+ filename="src/adw-leaflet.c"
20563+ line="70">Uncover the new page or cover the old page, sliding from or towards the start according to orientation, text direction and children order</doc>
20564+ </member>
20565+ <member name="slide"
20566+ value="2"
20567+ c:identifier="ADW_LEAFLET_TRANSITION_TYPE_SLIDE"
20568+ glib:nick="slide"
20569+ glib:name="ADW_LEAFLET_TRANSITION_TYPE_SLIDE">
20570+ <doc xml:space="preserve"
20571+ filename="src/adw-leaflet.c"
20572+ line="71">Slide from left, right, up or down according to the orientation, text direction and the children order</doc>
20573+ </member>
20574+ </enumeration>
20575+ <enumeration name="LengthUnit"
20576+ version="1.4"
20577+ glib:type-name="AdwLengthUnit"
20578+ glib:get-type="adw_length_unit_get_type"
20579+ c:type="AdwLengthUnit">
20580+ <doc xml:space="preserve"
20581+ filename="src/adw-length-unit.c"
20582+ line="13">Describes length units.
20583+
20584+| Unit | Regular Text | Large Text |
20585+| ---- | ------------ | ---------- |
20586+| 1px | 1px | 1px |
20587+| 1pt | 1.333333px | 1.666667px |
20588+| 1sp | 1px | 1.25px |
20589+
20590+New values may be added to this enumeration over time.</doc>
20591+ <member name="px"
20592+ value="0"
20593+ c:identifier="ADW_LENGTH_UNIT_PX"
20594+ glib:nick="px"
20595+ glib:name="ADW_LENGTH_UNIT_PX">
20596+ <doc xml:space="preserve"
20597+ filename="src/adw-length-unit.c"
20598+ line="15">pixels</doc>
20599+ </member>
20600+ <member name="pt"
20601+ value="1"
20602+ c:identifier="ADW_LENGTH_UNIT_PT"
20603+ glib:nick="pt"
20604+ glib:name="ADW_LENGTH_UNIT_PT">
20605+ <doc xml:space="preserve"
20606+ filename="src/adw-length-unit.c"
20607+ line="16">points, changes with text scale factor</doc>
20608+ </member>
20609+ <member name="sp"
20610+ value="2"
20611+ c:identifier="ADW_LENGTH_UNIT_SP"
20612+ glib:nick="sp"
20613+ glib:name="ADW_LENGTH_UNIT_SP">
20614+ <doc xml:space="preserve"
20615+ filename="src/adw-length-unit.c"
20616+ line="17">scale independent pixels, changes with text scale factor</doc>
20617+ </member>
20618+ <function name="from_px"
20619+ c:identifier="adw_length_unit_from_px"
20620+ version="1.4">
20621+ <doc xml:space="preserve"
20622+ filename="src/adw-length-unit.c"
20623+ line="84">Converts @value from pixels to @unit.</doc>
20624+ <source-position filename="src/adw-length-unit.h" line="33"/>
20625+ <return-value transfer-ownership="none">
20626+ <doc xml:space="preserve"
20627+ filename="src/adw-length-unit.c"
20628+ line="92">the length in @unit</doc>
20629+ <type name="gdouble" c:type="double"/>
20630+ </return-value>
20631+ <parameters>
20632+ <parameter name="unit" transfer-ownership="none">
20633+ <doc xml:space="preserve"
20634+ filename="src/adw-length-unit.c"
20635+ line="86">a length unit</doc>
20636+ <type name="LengthUnit" c:type="AdwLengthUnit"/>
20637+ </parameter>
20638+ <parameter name="value" transfer-ownership="none">
20639+ <doc xml:space="preserve"
20640+ filename="src/adw-length-unit.c"
20641+ line="87">a value in pixels</doc>
20642+ <type name="gdouble" c:type="double"/>
20643+ </parameter>
20644+ <parameter name="settings"
20645+ transfer-ownership="none"
20646+ nullable="1"
20647+ allow-none="1">
20648+ <doc xml:space="preserve"
20649+ filename="src/adw-length-unit.c"
20650+ line="88">settings to use, or `NULL` for default settings</doc>
20651+ <type name="Gtk.Settings" c:type="GtkSettings*"/>
20652+ </parameter>
20653+ </parameters>
20654+ </function>
20655+ <function name="to_px"
20656+ c:identifier="adw_length_unit_to_px"
20657+ version="1.4">
20658+ <doc xml:space="preserve"
20659+ filename="src/adw-length-unit.c"
20660+ line="45">Converts @value from @unit to pixels.</doc>
20661+ <source-position filename="src/adw-length-unit.h" line="28"/>
20662+ <return-value transfer-ownership="none">
20663+ <doc xml:space="preserve"
20664+ filename="src/adw-length-unit.c"
20665+ line="53">the length in pixels</doc>
20666+ <type name="gdouble" c:type="double"/>
20667+ </return-value>
20668+ <parameters>
20669+ <parameter name="unit" transfer-ownership="none">
20670+ <doc xml:space="preserve"
20671+ filename="src/adw-length-unit.c"
20672+ line="47">a length unit</doc>
20673+ <type name="LengthUnit" c:type="AdwLengthUnit"/>
20674+ </parameter>
20675+ <parameter name="value" transfer-ownership="none">
20676+ <doc xml:space="preserve"
20677+ filename="src/adw-length-unit.c"
20678+ line="48">a value in @unit</doc>
20679+ <type name="gdouble" c:type="double"/>
20680+ </parameter>
20681+ <parameter name="settings"
20682+ transfer-ownership="none"
20683+ nullable="1"
20684+ allow-none="1">
20685+ <doc xml:space="preserve"
20686+ filename="src/adw-length-unit.c"
20687+ line="49">settings to use, or `NULL` for default settings</doc>
20688+ <type name="Gtk.Settings" c:type="GtkSettings*"/>
20689+ </parameter>
20690+ </parameters>
20691+ </function>
20692+ </enumeration>
20693+ <constant name="MAJOR_VERSION" value="1" c:type="ADW_MAJOR_VERSION">
20694+ <doc xml:space="preserve"
20695+ filename="src/adw-version.h"
20696+ line="17">Adwaita major version component (e.g. 1 if the version is 1.2.3).</doc>
20697+ <source-position filename="src/adw-version.h" line="22"/>
20698+ <type name="gint" c:type="gint"/>
20699+ </constant>
20700+ <constant name="MICRO_VERSION" value="4" c:type="ADW_MICRO_VERSION">
20701+ <doc xml:space="preserve"
20702+ filename="src/adw-version.h"
20703+ line="31">Adwaita micro version component (e.g. 3 if the version is 1.2.3).</doc>
20704+ <source-position filename="src/adw-version.h" line="36"/>
20705+ <type name="gint" c:type="gint"/>
20706+ </constant>
20707+ <constant name="MINOR_VERSION" value="6" c:type="ADW_MINOR_VERSION">
20708+ <doc xml:space="preserve"
20709+ filename="src/adw-version.h"
20710+ line="24">Adwaita minor version component (e.g. 2 if the version is 1.2.3).</doc>
20711+ <source-position filename="src/adw-version.h" line="29"/>
20712+ <type name="gint" c:type="gint"/>
20713+ </constant>
20714+ <class name="MessageDialog"
20715+ c:symbol-prefix="message_dialog"
20716+ c:type="AdwMessageDialog"
20717+ version="1.2"
20718+ deprecated="1"
20719+ deprecated-version="1.6"
20720+ parent="Gtk.Window"
20721+ glib:type-name="AdwMessageDialog"
20722+ glib:get-type="adw_message_dialog_get_type"
20723+ glib:type-struct="MessageDialogClass">
20724+ <doc xml:space="preserve"
20725+ filename="src/adw-message-dialog.c"
20726+ line="18">A dialog presenting a message or a question.
20727+
20728+&lt;picture&gt;
20729+ &lt;source srcset="message-dialog-dark.png" media="(prefers-color-scheme: dark)"&gt;
20730+ &lt;img src="message-dialog.png" alt="message-dialog"&gt;
20731+&lt;/picture&gt;
20732+
20733+Message dialogs have a heading, a body, an optional child widget, and one or
20734+multiple responses, each presented as a button.
20735+
20736+Each response has a unique string ID, and a button label. Additionally, each
20737+response can be enabled or disabled, and can have a suggested or destructive
20738+appearance.
20739+
20740+When one of the responses is activated, or the dialog is closed, the
20741+[signal@MessageDialog::response] signal will be emitted. This signal is
20742+detailed, and the detail, as well as the `response` parameter will be set to
20743+the ID of the activated response, or to the value of the
20744+[property@MessageDialog:close-response] property if the dialog had been
20745+closed without activating any of the responses.
20746+
20747+Response buttons can be presented horizontally or vertically depending on
20748+available space.
20749+
20750+When a response is activated, `AdwMessageDialog` is closed automatically.
20751+
20752+An example of using a message dialog:
20753+
20754+```c
20755+GtkWidget *dialog;
20756+
20757+dialog = adw_message_dialog_new (parent, _("Replace File?"), NULL);
20758+
20759+adw_message_dialog_format_body (ADW_MESSAGE_DIALOG (dialog),
20760+ _("A file named “%s” already exists. Do you want to replace it?"),
20761+ filename);
20762+
20763+adw_message_dialog_add_responses (ADW_MESSAGE_DIALOG (dialog),
20764+ "cancel", _("_Cancel"),
20765+ "replace", _("_Replace"),
20766+ NULL);
20767+
20768+adw_message_dialog_set_response_appearance (ADW_MESSAGE_DIALOG (dialog), "replace", ADW_RESPONSE_DESTRUCTIVE);
20769+
20770+adw_message_dialog_set_default_response (ADW_MESSAGE_DIALOG (dialog), "cancel");
20771+adw_message_dialog_set_close_response (ADW_MESSAGE_DIALOG (dialog), "cancel");
20772+
20773+g_signal_connect (dialog, "response", G_CALLBACK (response_cb), self);
20774+
20775+gtk_window_present (GTK_WINDOW (dialog));
20776+```
20777+
20778+## Async API
20779+
20780+`AdwMessageDialog` can also be used via the [method@MessageDialog.choose]
20781+method. This API follows the GIO async pattern, for example:
20782+
20783+```c
20784+static void
20785+dialog_cb (AdwMessageDialog *dialog,
20786+ GAsyncResult *result,
20787+ MyWindow *self)
20788+{
20789+ const char *response = adw_message_dialog_choose_finish (dialog, result);
20790+
20791+ // ...
20792+}
20793+
20794+static void
20795+show_dialog (MyWindow *self)
20796+{
20797+ GtkWidget *dialog;
20798+
20799+ dialog = adw_message_dialog_new (GTK_WINDOW (self), _("Replace File?"), NULL);
20800+
20801+ adw_message_dialog_format_body (ADW_MESSAGE_DIALOG (dialog),
20802+ _("A file named “%s” already exists. Do you want to replace it?"),
20803+ filename);
20804+
20805+ adw_message_dialog_add_responses (ADW_MESSAGE_DIALOG (dialog),
20806+ "cancel", _("_Cancel"),
20807+ "replace", _("_Replace"),
20808+ NULL);
20809+
20810+ adw_message_dialog_set_response_appearance (ADW_MESSAGE_DIALOG (dialog), "replace", ADW_RESPONSE_DESTRUCTIVE);
20811+
20812+ adw_message_dialog_set_default_response (ADW_MESSAGE_DIALOG (dialog), "cancel");
20813+ adw_message_dialog_set_close_response (ADW_MESSAGE_DIALOG (dialog), "cancel");
20814+
20815+ adw_message_dialog_choose (ADW_MESSAGE_DIALOG (dialog), NULL, (GAsyncReadyCallback) dialog_cb, self);
20816+}
20817+```
20818+
20819+## AdwMessageDialog as GtkBuildable
20820+
20821+`AdwMessageDialog` supports adding responses in UI definitions by via the
20822+`&lt;responses&gt;` element that may contain multiple `&lt;response&gt;` elements, each
20823+representing a response.
20824+
20825+Each of the `&lt;response&gt;` elements must have the `id` attribute specifying the
20826+response ID. The contents of the element are used as the response label.
20827+
20828+Response labels can be translated with the usual `translatable`, `context`
20829+and `comments` attributes.
20830+
20831+The `&lt;response&gt;` elements can also have `enabled` and/or `appearance`
20832+attributes. See [method@MessageDialog.set_response_enabled] and
20833+[method@MessageDialog.set_response_appearance] for details.
20834+
20835+Example of an `AdwMessageDialog` UI definition:
20836+
20837+```xml
20838+&lt;object class="AdwMessageDialog" id="dialog"&gt;
20839+ &lt;property name="heading" translatable="yes"&gt;Save Changes?&lt;/property&gt;
20840+ &lt;property name="body" translatable="yes"&gt;Open documents contain unsaved changes. Changes which are not saved will be permanently lost.&lt;/property&gt;
20841+ &lt;property name="default-response"&gt;save&lt;/property&gt;
20842+ &lt;property name="close-response"&gt;cancel&lt;/property&gt;
20843+ &lt;signal name="response" handler="response_cb"/&gt;
20844+ &lt;responses&gt;
20845+ &lt;response id="cancel" translatable="yes"&gt;_Cancel&lt;/response&gt;
20846+ &lt;response id="discard" translatable="yes" appearance="destructive"&gt;_Discard&lt;/response&gt;
20847+ &lt;response id="save" translatable="yes" appearance="suggested" enabled="false"&gt;_Save&lt;/response&gt;
20848+ &lt;/responses&gt;
20849+&lt;/object&gt;
20850+```
20851+
20852+## Accessibility
20853+
20854+`AdwMessageDialog` uses the `GTK_ACCESSIBLE_ROLE_DIALOG` role.</doc>
20855+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
20856+ <source-position filename="src/adw-message-dialog.h" line="37"/>
20857+ <implements name="Gtk.Accessible"/>
20858+ <implements name="Gtk.Buildable"/>
20859+ <implements name="Gtk.ConstraintTarget"/>
20860+ <implements name="Gtk.Native"/>
20861+ <implements name="Gtk.Root"/>
20862+ <implements name="Gtk.ShortcutManager"/>
20863+ <constructor name="new"
20864+ c:identifier="adw_message_dialog_new"
20865+ version="1.2"
20866+ deprecated="1"
20867+ deprecated-version="1.6">
20868+ <doc xml:space="preserve"
20869+ filename="src/adw-message-dialog.c"
20870+ line="1432">Creates a new `AdwMessageDialog`.
20871+
20872+@heading and @body can be set to `NULL`. This can be useful if they need to
20873+be formatted or use markup. In that case, set them to `NULL` and call
20874+[method@MessageDialog.format_body] or similar methods afterwards:
20875+
20876+```c
20877+GtkWidget *dialog;
20878+
20879+dialog = adw_message_dialog_new (parent, _("Replace File?"), NULL);
20880+adw_message_dialog_format_body (ADW_MESSAGE_DIALOG (dialog),
20881+ _("A file named “%s” already exists. Do you want to replace it?"),
20882+ filename);
20883+```</doc>
20884+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
20885+ <source-position filename="src/adw-message-dialog.h" line="40"/>
20886+ <return-value transfer-ownership="none">
20887+ <doc xml:space="preserve"
20888+ filename="src/adw-message-dialog.c"
20889+ line="1453">the newly created `AdwMessageDialog`</doc>
20890+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
20891+ </return-value>
20892+ <parameters>
20893+ <parameter name="parent"
20894+ transfer-ownership="none"
20895+ nullable="1"
20896+ allow-none="1">
20897+ <doc xml:space="preserve"
20898+ filename="src/adw-message-dialog.c"
20899+ line="1434">transient parent</doc>
20900+ <type name="Gtk.Window" c:type="GtkWindow*"/>
20901+ </parameter>
20902+ <parameter name="heading"
20903+ transfer-ownership="none"
20904+ nullable="1"
20905+ allow-none="1">
20906+ <doc xml:space="preserve"
20907+ filename="src/adw-message-dialog.c"
20908+ line="1435">the heading</doc>
20909+ <type name="utf8" c:type="const char*"/>
20910+ </parameter>
20911+ <parameter name="body"
20912+ transfer-ownership="none"
20913+ nullable="1"
20914+ allow-none="1">
20915+ <doc xml:space="preserve"
20916+ filename="src/adw-message-dialog.c"
20917+ line="1436">the body text</doc>
20918+ <type name="utf8" c:type="const char*"/>
20919+ </parameter>
20920+ </parameters>
20921+ </constructor>
20922+ <virtual-method name="response"
20923+ invoker="response"
20924+ version="1.2"
20925+ deprecated="1"
20926+ deprecated-version="1.6">
20927+ <attribute name="org.gtk.Method.signal" value="response"/>
20928+ <doc xml:space="preserve"
20929+ filename="src/adw-message-dialog.c"
20930+ line="2475">Emits the [signal@MessageDialog::response] signal with the given response ID.
20931+
20932+Used to indicate that the user has responded to the dialog in some way.</doc>
20933+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
20934+ <source-position filename="src/adw-message-dialog.h" line="32"/>
20935+ <return-value transfer-ownership="none">
20936+ <type name="none" c:type="void"/>
20937+ </return-value>
20938+ <parameters>
20939+ <instance-parameter name="self" transfer-ownership="none">
20940+ <doc xml:space="preserve"
20941+ filename="src/adw-message-dialog.c"
20942+ line="2477">a message dialog</doc>
20943+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
20944+ </instance-parameter>
20945+ <parameter name="response" transfer-ownership="none">
20946+ <doc xml:space="preserve"
20947+ filename="src/adw-message-dialog.c"
20948+ line="2478">response ID</doc>
20949+ <type name="utf8" c:type="const char*"/>
20950+ </parameter>
20951+ </parameters>
20952+ </virtual-method>
20953+ <method name="add_response"
20954+ c:identifier="adw_message_dialog_add_response"
20955+ version="1.2"
20956+ deprecated="1"
20957+ deprecated-version="1.6">
20958+ <doc xml:space="preserve"
20959+ filename="src/adw-message-dialog.c"
20960+ line="1965">Adds a response with @id and @label to @self.
20961+
20962+Responses are represented as buttons in the dialog.
20963+
20964+Response ID must be unique. It will be used in
20965+[signal@MessageDialog::response] to tell which response had been activated,
20966+as well as to inspect and modify the response later.
20967+
20968+An embedded underline in @label indicates a mnemonic.
20969+
20970+[method@MessageDialog.set_response_label] can be used to change the response
20971+label after it had been added.
20972+
20973+[method@MessageDialog.set_response_enabled] and
20974+[method@MessageDialog.set_response_appearance] can be used to customize the
20975+responses further.</doc>
20976+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
20977+ <source-position filename="src/adw-message-dialog.h" line="95"/>
20978+ <return-value transfer-ownership="none">
20979+ <type name="none" c:type="void"/>
20980+ </return-value>
20981+ <parameters>
20982+ <instance-parameter name="self" transfer-ownership="none">
20983+ <doc xml:space="preserve"
20984+ filename="src/adw-message-dialog.c"
20985+ line="1967">a message dialog</doc>
20986+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
20987+ </instance-parameter>
20988+ <parameter name="id" transfer-ownership="none">
20989+ <doc xml:space="preserve"
20990+ filename="src/adw-message-dialog.c"
20991+ line="1968">the response ID</doc>
20992+ <type name="utf8" c:type="const char*"/>
20993+ </parameter>
20994+ <parameter name="label" transfer-ownership="none">
20995+ <doc xml:space="preserve"
20996+ filename="src/adw-message-dialog.c"
20997+ line="1969">the response label</doc>
20998+ <type name="utf8" c:type="const char*"/>
20999+ </parameter>
21000+ </parameters>
21001+ </method>
21002+ <method name="add_responses"
21003+ c:identifier="adw_message_dialog_add_responses"
21004+ version="1.2"
21005+ introspectable="0"
21006+ deprecated="1"
21007+ deprecated-version="1.6">
784021008 <doc xml:space="preserve"
7841- filename="src/adw-easing.c"
7842- line="61">Overshooting cubic tweening, with backtracking on both
7843- ends, combining `ADW_EASE_IN_BACK` and `ADW_EASE_OUT_BACK`.</doc>
7844- </member>
7845- <member name="ease_in_bounce"
7846- value="28"
7847- c:identifier="ADW_EASE_IN_BOUNCE"
7848- glib:nick="ease-in-bounce"
7849- glib:name="ADW_EASE_IN_BOUNCE">
21009+ filename="src/adw-message-dialog.c"
21010+ line="2029">Adds multiple responses to @self.
21011+
21012+This is the same as calling [method@MessageDialog.add_response] repeatedly.
21013+The variable argument list should be `NULL`-terminated list of response IDs
21014+and labels.
21015+
21016+Example:
21017+
21018+```c
21019+adw_message_dialog_add_responses (dialog,
21020+ "cancel", _("_Cancel"),
21021+ "discard", _("_Discard"),
21022+ "save", _("_Save"),
21023+ NULL);
21024+```</doc>
21025+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
21026+ <source-position filename="src/adw-message-dialog.h" line="104"/>
21027+ <return-value transfer-ownership="none">
21028+ <type name="none" c:type="void"/>
21029+ </return-value>
21030+ <parameters>
21031+ <instance-parameter name="self" transfer-ownership="none">
21032+ <doc xml:space="preserve"
21033+ filename="src/adw-message-dialog.c"
21034+ line="2031">a message dialog</doc>
21035+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
21036+ </instance-parameter>
21037+ <parameter name="first_id" transfer-ownership="none">
21038+ <doc xml:space="preserve"
21039+ filename="src/adw-message-dialog.c"
21040+ line="2032">response id</doc>
21041+ <type name="utf8" c:type="const char*"/>
21042+ </parameter>
21043+ <parameter name="..." transfer-ownership="none">
21044+ <doc xml:space="preserve"
21045+ filename="src/adw-message-dialog.c"
21046+ line="2033">label for first response, then more id-label pairs</doc>
21047+ <varargs/>
21048+ </parameter>
21049+ </parameters>
21050+ </method>
21051+ <method name="choose"
21052+ c:identifier="adw_message_dialog_choose"
21053+ version="1.3"
21054+ deprecated="1"
21055+ deprecated-version="1.6"
21056+ glib:finish-func="choose_finish">
785021057 <doc xml:space="preserve"
7851- filename="src/adw-easing.c"
7852- line="63">Exponentially decaying parabolic (bounce) tweening,
7853- on start.</doc>
7854- </member>
7855- <member name="ease_out_bounce"
7856- value="29"
7857- c:identifier="ADW_EASE_OUT_BOUNCE"
7858- glib:nick="ease-out-bounce"
7859- glib:name="ADW_EASE_OUT_BOUNCE">
21058+ filename="src/adw-message-dialog.c"
21059+ line="2549">This function shows @self to the user.</doc>
21060+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
21061+ <source-position filename="src/adw-message-dialog.h" line="153"/>
21062+ <return-value transfer-ownership="none">
21063+ <type name="none" c:type="void"/>
21064+ </return-value>
21065+ <parameters>
21066+ <instance-parameter name="self" transfer-ownership="none">
21067+ <doc xml:space="preserve"
21068+ filename="src/adw-message-dialog.c"
21069+ line="2551">a message dialog</doc>
21070+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
21071+ </instance-parameter>
21072+ <parameter name="cancellable"
21073+ transfer-ownership="none"
21074+ nullable="1"
21075+ allow-none="1">
21076+ <doc xml:space="preserve"
21077+ filename="src/adw-message-dialog.c"
21078+ line="2552">a `GCancellable` to cancel the operation</doc>
21079+ <type name="Gio.Cancellable" c:type="GCancellable*"/>
21080+ </parameter>
21081+ <parameter name="callback"
21082+ transfer-ownership="none"
21083+ nullable="1"
21084+ allow-none="1"
21085+ scope="async"
21086+ closure="2">
21087+ <doc xml:space="preserve"
21088+ filename="src/adw-message-dialog.c"
21089+ line="2553">a callback to call when the operation is complete</doc>
21090+ <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
21091+ </parameter>
21092+ <parameter name="user_data"
21093+ transfer-ownership="none"
21094+ nullable="1"
21095+ allow-none="1">
21096+ <doc xml:space="preserve"
21097+ filename="src/adw-message-dialog.c"
21098+ line="2554">data to pass to @callback</doc>
21099+ <type name="gpointer" c:type="gpointer"/>
21100+ </parameter>
21101+ </parameters>
21102+ </method>
21103+ <method name="choose_finish"
21104+ c:identifier="adw_message_dialog_choose_finish"
21105+ version="1.3"
21106+ deprecated="1"
21107+ deprecated-version="1.6">
786021108 <doc xml:space="preserve"
7861- filename="src/adw-easing.c"
7862- line="65">Exponentially decaying parabolic (bounce) tweening,
7863- with bounce on end, inverse of `ADW_EASE_IN_BOUNCE`.</doc>
7864- </member>
7865- <member name="ease_in_out_bounce"
7866- value="30"
7867- c:identifier="ADW_EASE_IN_OUT_BOUNCE"
7868- glib:nick="ease-in-out-bounce"
7869- glib:name="ADW_EASE_IN_OUT_BOUNCE">
21109+ filename="src/adw-message-dialog.c"
21110+ line="2582">Finishes the [method@MessageDialog.choose] call and returns the response ID.</doc>
21111+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
21112+ <source-position filename="src/adw-message-dialog.h" line="159"/>
21113+ <return-value transfer-ownership="none">
21114+ <doc xml:space="preserve"
21115+ filename="src/adw-message-dialog.c"
21116+ line="2589">the ID of the response that was selected, or
21117+ [property@MessageDialog:close-response] if the call was cancelled.</doc>
21118+ <type name="utf8" c:type="const char*"/>
21119+ </return-value>
21120+ <parameters>
21121+ <instance-parameter name="self" transfer-ownership="none">
21122+ <doc xml:space="preserve"
21123+ filename="src/adw-message-dialog.c"
21124+ line="2584">a message dialog</doc>
21125+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
21126+ </instance-parameter>
21127+ <parameter name="result" transfer-ownership="none">
21128+ <doc xml:space="preserve"
21129+ filename="src/adw-message-dialog.c"
21130+ line="2585">a `GAsyncResult`</doc>
21131+ <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
21132+ </parameter>
21133+ </parameters>
21134+ </method>
21135+ <method name="format_body"
21136+ c:identifier="adw_message_dialog_format_body"
21137+ version="1.2"
21138+ introspectable="0"
21139+ deprecated="1"
21140+ deprecated-version="1.6">
787021141 <doc xml:space="preserve"
7871- filename="src/adw-easing.c"
7872- line="67">Exponentially decaying parabolic (bounce) tweening,
7873- with bounce on both ends, combining `ADW_EASE_IN_BOUNCE` and
7874- `ADW_EASE_OUT_BOUNCE`.</doc>
7875- </member>
7876- <function name="ease" c:identifier="adw_easing_ease">
21142+ filename="src/adw-message-dialog.c"
21143+ line="1812">Sets the formatted body text of @self.
21144+
21145+See [property@MessageDialog:body].</doc>
21146+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
21147+ <source-position filename="src/adw-message-dialog.h" line="79"/>
21148+ <return-value transfer-ownership="none">
21149+ <type name="none" c:type="void"/>
21150+ </return-value>
21151+ <parameters>
21152+ <instance-parameter name="self" transfer-ownership="none">
21153+ <doc xml:space="preserve"
21154+ filename="src/adw-message-dialog.c"
21155+ line="1814">a message dialog</doc>
21156+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
21157+ </instance-parameter>
21158+ <parameter name="format" transfer-ownership="none">
21159+ <doc xml:space="preserve"
21160+ filename="src/adw-message-dialog.c"
21161+ line="1815">the formatted string for the body text</doc>
21162+ <type name="utf8" c:type="const char*"/>
21163+ </parameter>
21164+ <parameter name="..." transfer-ownership="none">
21165+ <doc xml:space="preserve"
21166+ filename="src/adw-message-dialog.c"
21167+ line="1816">the parameters to insert into @format</doc>
21168+ <varargs/>
21169+ </parameter>
21170+ </parameters>
21171+ </method>
21172+ <method name="format_body_markup"
21173+ c:identifier="adw_message_dialog_format_body_markup"
21174+ version="1.2"
21175+ introspectable="0"
21176+ deprecated="1"
21177+ deprecated-version="1.6">
787721178 <doc xml:space="preserve"
7878- filename="src/adw-easing.c"
7879- line="428">Computes easing with @easing for @value.
21179+ filename="src/adw-message-dialog.c"
21180+ line="1856">Sets the formatted body text of @self with Pango markup.
21181+
21182+The @format is assumed to contain Pango markup.
21183+
21184+Special XML characters in the `printf()` arguments passed to this function
21185+will automatically be escaped as necessary, see
21186+[func@GLib.markup_printf_escaped].
21187+
21188+See [property@MessageDialog:body].</doc>
21189+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
21190+ <source-position filename="src/adw-message-dialog.h" line="84"/>
21191+ <return-value transfer-ownership="none">
21192+ <type name="none" c:type="void"/>
21193+ </return-value>
21194+ <parameters>
21195+ <instance-parameter name="self" transfer-ownership="none">
21196+ <doc xml:space="preserve"
21197+ filename="src/adw-message-dialog.c"
21198+ line="1858">a message dialog</doc>
21199+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
21200+ </instance-parameter>
21201+ <parameter name="format" transfer-ownership="none">
21202+ <doc xml:space="preserve"
21203+ filename="src/adw-message-dialog.c"
21204+ line="1859">the formatted string for the body text with Pango markup</doc>
21205+ <type name="utf8" c:type="const char*"/>
21206+ </parameter>
21207+ <parameter name="..." transfer-ownership="none">
21208+ <doc xml:space="preserve"
21209+ filename="src/adw-message-dialog.c"
21210+ line="1860">the parameters to insert into @format</doc>
21211+ <varargs/>
21212+ </parameter>
21213+ </parameters>
21214+ </method>
21215+ <method name="format_heading"
21216+ c:identifier="adw_message_dialog_format_heading"
21217+ version="1.2"
21218+ introspectable="0"
21219+ deprecated="1"
21220+ deprecated-version="1.6">
21221+ <doc xml:space="preserve"
21222+ filename="src/adw-message-dialog.c"
21223+ line="1603">Sets the formatted heading of @self.
21224+
21225+See [property@MessageDialog:heading].</doc>
21226+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
21227+ <source-position filename="src/adw-message-dialog.h" line="57"/>
21228+ <return-value transfer-ownership="none">
21229+ <type name="none" c:type="void"/>
21230+ </return-value>
21231+ <parameters>
21232+ <instance-parameter name="self" transfer-ownership="none">
21233+ <doc xml:space="preserve"
21234+ filename="src/adw-message-dialog.c"
21235+ line="1605">a message dialog</doc>
21236+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
21237+ </instance-parameter>
21238+ <parameter name="format" transfer-ownership="none">
21239+ <doc xml:space="preserve"
21240+ filename="src/adw-message-dialog.c"
21241+ line="1606">the formatted string for the heading</doc>
21242+ <type name="utf8" c:type="const char*"/>
21243+ </parameter>
21244+ <parameter name="..." transfer-ownership="none">
21245+ <doc xml:space="preserve"
21246+ filename="src/adw-message-dialog.c"
21247+ line="1607">the parameters to insert into @format</doc>
21248+ <varargs/>
21249+ </parameter>
21250+ </parameters>
21251+ </method>
21252+ <method name="format_heading_markup"
21253+ c:identifier="adw_message_dialog_format_heading_markup"
21254+ version="1.2"
21255+ introspectable="0"
21256+ deprecated="1"
21257+ deprecated-version="1.6">
21258+ <doc xml:space="preserve"
21259+ filename="src/adw-message-dialog.c"
21260+ line="1647">Sets the formatted heading of @self with Pango markup.
788021261
7881-@value should generally be in the [0, 1] range.</doc>
7882- <source-position filename="src/adw-easing.h" line="57"/>
21262+The @format is assumed to contain Pango markup.
21263+
21264+Special XML characters in the `printf()` arguments passed to this function
21265+will automatically be escaped as necessary, see
21266+[func@GLib.markup_printf_escaped].
21267+
21268+See [property@MessageDialog:heading].</doc>
21269+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
21270+ <source-position filename="src/adw-message-dialog.h" line="62"/>
788321271 <return-value transfer-ownership="none">
7884- <doc xml:space="preserve"
7885- filename="src/adw-easing.c"
7886- line="437">the easing for @value</doc>
7887- <type name="gdouble" c:type="double"/>
21272+ <type name="none" c:type="void"/>
788821273 </return-value>
788921274 <parameters>
7890- <parameter name="self" transfer-ownership="none">
21275+ <instance-parameter name="self" transfer-ownership="none">
789121276 <doc xml:space="preserve"
7892- filename="src/adw-easing.c"
7893- line="430">an easing value</doc>
7894- <type name="Easing" c:type="AdwEasing"/>
21277+ filename="src/adw-message-dialog.c"
21278+ line="1649">a message dialog</doc>
21279+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
21280+ </instance-parameter>
21281+ <parameter name="format" transfer-ownership="none">
21282+ <doc xml:space="preserve"
21283+ filename="src/adw-message-dialog.c"
21284+ line="1650">the formatted string for the heading with Pango markup</doc>
21285+ <type name="utf8" c:type="const char*"/>
789521286 </parameter>
7896- <parameter name="value" transfer-ownership="none">
21287+ <parameter name="..." transfer-ownership="none">
789721288 <doc xml:space="preserve"
7898- filename="src/adw-easing.c"
7899- line="431">a value to ease</doc>
7900- <type name="gdouble" c:type="double"/>
21289+ filename="src/adw-message-dialog.c"
21290+ line="1651">the parameters to insert into @format</doc>
21291+ <varargs/>
790121292 </parameter>
790221293 </parameters>
7903- </function>
7904- </enumeration>
7905- <class name="EntryRow"
7906- c:symbol-prefix="entry_row"
7907- c:type="AdwEntryRow"
7908- version="1.2"
7909- parent="PreferencesRow"
7910- glib:type-name="AdwEntryRow"
7911- glib:get-type="adw_entry_row_get_type"
7912- glib:type-struct="EntryRowClass">
7913- <doc xml:space="preserve"
7914- filename="src/adw-entry-row.c"
7915- line="21">A [class@Gtk.ListBoxRow] with an embedded text entry.
7916-
7917-&lt;picture&gt;
7918- &lt;source srcset="entry-row-dark.png" media="(prefers-color-scheme: dark)"&gt;
7919- &lt;img src="entry-row.png" alt="entry-row"&gt;
7920-&lt;/picture&gt;
7921-
7922-`AdwEntryRow` has a title that doubles as placeholder text. It shows an icon
7923-indicating that it's editable and can receive additional widgets before or
7924-after the editable part.
7925-
7926-If [property@EntryRow:show-apply-button] is set to `TRUE`, `AdwEntryRow` can
7927-show an apply button when editing its contents. This can be useful if
7928-changing its contents can result in an expensive operation, such as network
7929-activity.
7930-
7931-`AdwEntryRow` provides only minimal API and should be used with the
7932-[iface@Gtk.Editable] API.
7933-
7934-See also [class@PasswordEntryRow].
7935-
7936-## AdwEntryRow as GtkBuildable
7937-
7938-The `AdwEntryRow` implementation of the [iface@Gtk.Buildable] interface
7939-supports adding a child at its end by specifying “suffix” or omitting the
7940-“type” attribute of a &lt;child&gt; element.
7941-
7942-It also supports adding a child as a prefix widget by specifying “prefix” as
7943-the “type” attribute of a &lt;child&gt; element.
7944-
7945-## CSS nodes
7946-
7947-`AdwEntryRow` has a single CSS node with name `row` and the `.entry` style
7948-class.</doc>
7949- <source-position filename="src/adw-entry-row.h" line="32"/>
7950- <implements name="Gtk.Accessible"/>
7951- <implements name="Gtk.Actionable"/>
7952- <implements name="Gtk.Buildable"/>
7953- <implements name="Gtk.ConstraintTarget"/>
7954- <implements name="Gtk.Editable"/>
7955- <constructor name="new" c:identifier="adw_entry_row_new" version="1.2">
21294+ </method>
21295+ <method name="get_body"
21296+ c:identifier="adw_message_dialog_get_body"
21297+ glib:get-property="body"
21298+ version="1.2"
21299+ deprecated="1"
21300+ deprecated-version="1.6">
795621301 <doc xml:space="preserve"
7957- filename="src/adw-entry-row.c"
7958- line="687">Creates a new `AdwEntryRow`.</doc>
7959- <source-position filename="src/adw-entry-row.h" line="35"/>
21302+ filename="src/adw-message-dialog.c"
21303+ line="1697">Gets the body text of @self.</doc>
21304+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
21305+ <source-position filename="src/adw-message-dialog.h" line="67"/>
796021306 <return-value transfer-ownership="none">
796121307 <doc xml:space="preserve"
7962- filename="src/adw-entry-row.c"
7963- line="692">the newly created `AdwEntryRow`</doc>
7964- <type name="Gtk.Widget" c:type="GtkWidget*"/>
21308+ filename="src/adw-message-dialog.c"
21309+ line="1703">the body of @self.</doc>
21310+ <type name="utf8" c:type="const char*"/>
796521311 </return-value>
7966- </constructor>
7967- <method name="add_prefix"
7968- c:identifier="adw_entry_row_add_prefix"
7969- version="1.2">
21312+ <parameters>
21313+ <instance-parameter name="self" transfer-ownership="none">
21314+ <doc xml:space="preserve"
21315+ filename="src/adw-message-dialog.c"
21316+ line="1699">a message dialog</doc>
21317+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
21318+ </instance-parameter>
21319+ </parameters>
21320+ </method>
21321+ <method name="get_body_use_markup"
21322+ c:identifier="adw_message_dialog_get_body_use_markup"
21323+ glib:get-property="body-use-markup"
21324+ version="1.2"
21325+ deprecated="1"
21326+ deprecated-version="1.6">
797021327 <doc xml:space="preserve"
7971- filename="src/adw-entry-row.c"
7972- line="702">Adds a prefix widget to @self.</doc>
7973- <source-position filename="src/adw-entry-row.h" line="38"/>
21328+ filename="src/adw-message-dialog.c"
21329+ line="1755">Gets whether the body text of @self includes Pango markup.</doc>
21330+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
21331+ <source-position filename="src/adw-message-dialog.h" line="73"/>
797421332 <return-value transfer-ownership="none">
7975- <type name="none" c:type="void"/>
21333+ <doc xml:space="preserve"
21334+ filename="src/adw-message-dialog.c"
21335+ line="1761">whether @self uses markup for body text</doc>
21336+ <type name="gboolean" c:type="gboolean"/>
797621337 </return-value>
797721338 <parameters>
797821339 <instance-parameter name="self" transfer-ownership="none">
797921340 <doc xml:space="preserve"
7980- filename="src/adw-entry-row.c"
7981- line="704">an entry row</doc>
7982- <type name="EntryRow" c:type="AdwEntryRow*"/>
21341+ filename="src/adw-message-dialog.c"
21342+ line="1757">a message dialog</doc>
21343+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
798321344 </instance-parameter>
7984- <parameter name="widget" transfer-ownership="none">
7985- <doc xml:space="preserve"
7986- filename="src/adw-entry-row.c"
7987- line="705">a widget</doc>
7988- <type name="Gtk.Widget" c:type="GtkWidget*"/>
7989- </parameter>
799021345 </parameters>
799121346 </method>
7992- <method name="add_suffix"
7993- c:identifier="adw_entry_row_add_suffix"
7994- version="1.2">
21347+ <method name="get_close_response"
21348+ c:identifier="adw_message_dialog_get_close_response"
21349+ glib:get-property="close-response"
21350+ version="1.2"
21351+ deprecated="1"
21352+ deprecated-version="1.6">
799521353 <doc xml:space="preserve"
7996- filename="src/adw-entry-row.c"
7997- line="726">Adds a suffix widget to @self.</doc>
7998- <source-position filename="src/adw-entry-row.h" line="41"/>
21354+ filename="src/adw-message-dialog.c"
21355+ line="2414">Gets the ID of the close response of @self.</doc>
21356+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
21357+ <source-position filename="src/adw-message-dialog.h" line="139"/>
799921358 <return-value transfer-ownership="none">
8000- <type name="none" c:type="void"/>
21359+ <doc xml:space="preserve"
21360+ filename="src/adw-message-dialog.c"
21361+ line="2420">the close response ID</doc>
21362+ <type name="utf8" c:type="const char*"/>
800121363 </return-value>
800221364 <parameters>
800321365 <instance-parameter name="self" transfer-ownership="none">
800421366 <doc xml:space="preserve"
8005- filename="src/adw-entry-row.c"
8006- line="728">an entry row</doc>
8007- <type name="EntryRow" c:type="AdwEntryRow*"/>
21367+ filename="src/adw-message-dialog.c"
21368+ line="2416">a message dialog</doc>
21369+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
800821370 </instance-parameter>
8009- <parameter name="widget" transfer-ownership="none">
21371+ </parameters>
21372+ </method>
21373+ <method name="get_default_response"
21374+ c:identifier="adw_message_dialog_get_default_response"
21375+ glib:get-property="default-response"
21376+ version="1.2"
21377+ deprecated="1"
21378+ deprecated-version="1.6">
21379+ <doc xml:space="preserve"
21380+ filename="src/adw-message-dialog.c"
21381+ line="2347">Gets the ID of the default response of @self.</doc>
21382+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
21383+ <source-position filename="src/adw-message-dialog.h" line="133"/>
21384+ <return-value transfer-ownership="none" nullable="1">
21385+ <doc xml:space="preserve"
21386+ filename="src/adw-message-dialog.c"
21387+ line="2353">the default response ID</doc>
21388+ <type name="utf8" c:type="const char*"/>
21389+ </return-value>
21390+ <parameters>
21391+ <instance-parameter name="self" transfer-ownership="none">
801021392 <doc xml:space="preserve"
8011- filename="src/adw-entry-row.c"
8012- line="729">a widget</doc>
8013- <type name="Gtk.Widget" c:type="GtkWidget*"/>
8014- </parameter>
21393+ filename="src/adw-message-dialog.c"
21394+ line="2349">a message dialog</doc>
21395+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
21396+ </instance-parameter>
801521397 </parameters>
801621398 </method>
8017- <method name="get_activates_default"
8018- c:identifier="adw_entry_row_get_activates_default"
8019- glib:get-property="activates-default"
8020- version="1.2">
8021- <attribute name="org.gtk.Method.get_property"
8022- value="activates-default"/>
21399+ <method name="get_extra_child"
21400+ c:identifier="adw_message_dialog_get_extra_child"
21401+ glib:get-property="extra-child"
21402+ version="1.2"
21403+ deprecated="1"
21404+ deprecated-version="1.6">
802321405 <doc xml:space="preserve"
8024- filename="src/adw-entry-row.c"
8025- line="1055">Gets whether activating the embedded entry can activate the default widget.</doc>
8026- <source-position filename="src/adw-entry-row.h" line="78"/>
21406+ filename="src/adw-message-dialog.c"
21407+ line="1906">Gets the child widget of @self.</doc>
21408+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
21409+ <source-position filename="src/adw-message-dialog.h" line="89"/>
21410+ <return-value transfer-ownership="none" nullable="1">
21411+ <doc xml:space="preserve"
21412+ filename="src/adw-message-dialog.c"
21413+ line="1912">the child widget of @self.</doc>
21414+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
21415+ </return-value>
21416+ <parameters>
21417+ <instance-parameter name="self" transfer-ownership="none">
21418+ <doc xml:space="preserve"
21419+ filename="src/adw-message-dialog.c"
21420+ line="1908">a message dialog</doc>
21421+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
21422+ </instance-parameter>
21423+ </parameters>
21424+ </method>
21425+ <method name="get_heading"
21426+ c:identifier="adw_message_dialog_get_heading"
21427+ glib:get-property="heading"
21428+ version="1.2"
21429+ deprecated="1"
21430+ deprecated-version="1.6">
21431+ <doc xml:space="preserve"
21432+ filename="src/adw-message-dialog.c"
21433+ line="1480">Gets the heading of @self.</doc>
21434+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
21435+ <source-position filename="src/adw-message-dialog.h" line="45"/>
21436+ <return-value transfer-ownership="none" nullable="1">
21437+ <doc xml:space="preserve"
21438+ filename="src/adw-message-dialog.c"
21439+ line="1486">the heading of @self.</doc>
21440+ <type name="utf8" c:type="const char*"/>
21441+ </return-value>
21442+ <parameters>
21443+ <instance-parameter name="self" transfer-ownership="none">
21444+ <doc xml:space="preserve"
21445+ filename="src/adw-message-dialog.c"
21446+ line="1482">a message dialog</doc>
21447+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
21448+ </instance-parameter>
21449+ </parameters>
21450+ </method>
21451+ <method name="get_heading_use_markup"
21452+ c:identifier="adw_message_dialog_get_heading_use_markup"
21453+ glib:get-property="heading-use-markup"
21454+ version="1.2"
21455+ deprecated="1"
21456+ deprecated-version="1.6">
21457+ <doc xml:space="preserve"
21458+ filename="src/adw-message-dialog.c"
21459+ line="1542">Gets whether the heading of @self includes Pango markup.</doc>
21460+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
21461+ <source-position filename="src/adw-message-dialog.h" line="51"/>
802721462 <return-value transfer-ownership="none">
802821463 <doc xml:space="preserve"
8029- filename="src/adw-entry-row.c"
8030- line="1061">whether to activate the default widget</doc>
21464+ filename="src/adw-message-dialog.c"
21465+ line="1548">whether @self uses markup for heading</doc>
803121466 <type name="gboolean" c:type="gboolean"/>
803221467 </return-value>
803321468 <parameters>
803421469 <instance-parameter name="self" transfer-ownership="none">
803521470 <doc xml:space="preserve"
8036- filename="src/adw-entry-row.c"
8037- line="1057">an entry row</doc>
8038- <type name="EntryRow" c:type="AdwEntryRow*"/>
21471+ filename="src/adw-message-dialog.c"
21472+ line="1544">a message dialog</doc>
21473+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
803921474 </instance-parameter>
804021475 </parameters>
804121476 </method>
8042- <method name="get_attributes"
8043- c:identifier="adw_entry_row_get_attributes"
8044- glib:get-property="attributes"
8045- version="1.2">
8046- <attribute name="org.gtk.Method.get_property" value="attributes"/>
21477+ <method name="get_response_appearance"
21478+ c:identifier="adw_message_dialog_get_response_appearance"
21479+ version="1.2"
21480+ deprecated="1"
21481+ deprecated-version="1.6">
804721482 <doc xml:space="preserve"
8048- filename="src/adw-entry-row.c"
8049- line="950">Gets Pango attributes applied to the text of the embedded entry.</doc>
8050- <source-position filename="src/adw-entry-row.h" line="72"/>
8051- <return-value transfer-ownership="full" nullable="1">
21483+ filename="src/adw-message-dialog.c"
21484+ line="2188">Gets the appearance of @response.
21485+
21486+See [method@MessageDialog.set_response_appearance].</doc>
21487+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
21488+ <source-position filename="src/adw-message-dialog.h" line="117"/>
21489+ <return-value transfer-ownership="none">
805221490 <doc xml:space="preserve"
8053- filename="src/adw-entry-row.c"
8054- line="956">the list of attributes</doc>
8055- <type name="Pango.AttrList" c:type="PangoAttrList*"/>
21491+ filename="src/adw-message-dialog.c"
21492+ line="2197">the appearance of @response</doc>
21493+ <type name="ResponseAppearance" c:type="AdwResponseAppearance"/>
805621494 </return-value>
805721495 <parameters>
805821496 <instance-parameter name="self" transfer-ownership="none">
805921497 <doc xml:space="preserve"
8060- filename="src/adw-entry-row.c"
8061- line="952">an entry row</doc>
8062- <type name="EntryRow" c:type="AdwEntryRow*"/>
21498+ filename="src/adw-message-dialog.c"
21499+ line="2190">a message dialog</doc>
21500+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
806321501 </instance-parameter>
21502+ <parameter name="response" transfer-ownership="none">
21503+ <doc xml:space="preserve"
21504+ filename="src/adw-message-dialog.c"
21505+ line="2191">a response ID</doc>
21506+ <type name="utf8" c:type="const char*"/>
21507+ </parameter>
806421508 </parameters>
806521509 </method>
8066- <method name="get_enable_emoji_completion"
8067- c:identifier="adw_entry_row_get_enable_emoji_completion"
8068- glib:get-property="enable-emoji-completion"
8069- version="1.2">
8070- <attribute name="org.gtk.Method.get_property"
8071- value="enable-emoji-completion"/>
21510+ <method name="get_response_enabled"
21511+ c:identifier="adw_message_dialog_get_response_enabled"
21512+ version="1.2"
21513+ deprecated="1"
21514+ deprecated-version="1.6">
807221515 <doc xml:space="preserve"
8073- filename="src/adw-entry-row.c"
8074- line="1002">Gets whether to suggest emoji replacements on @self.</doc>
8075- <source-position filename="src/adw-entry-row.h" line="66"/>
21516+ filename="src/adw-message-dialog.c"
21517+ line="2275">Gets whether @response is enabled.
21518+
21519+See [method@MessageDialog.set_response_enabled].</doc>
21520+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
21521+ <source-position filename="src/adw-message-dialog.h" line="125"/>
807621522 <return-value transfer-ownership="none">
807721523 <doc xml:space="preserve"
8078- filename="src/adw-entry-row.c"
8079- line="1008">whether or not emoji completion is enabled</doc>
21524+ filename="src/adw-message-dialog.c"
21525+ line="2284">whether @response is enabled</doc>
808021526 <type name="gboolean" c:type="gboolean"/>
808121527 </return-value>
808221528 <parameters>
808321529 <instance-parameter name="self" transfer-ownership="none">
808421530 <doc xml:space="preserve"
8085- filename="src/adw-entry-row.c"
8086- line="1004">an entry row</doc>
8087- <type name="EntryRow" c:type="AdwEntryRow*"/>
21531+ filename="src/adw-message-dialog.c"
21532+ line="2277">a message dialog</doc>
21533+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
808821534 </instance-parameter>
21535+ <parameter name="response" transfer-ownership="none">
21536+ <doc xml:space="preserve"
21537+ filename="src/adw-message-dialog.c"
21538+ line="2278">a response ID</doc>
21539+ <type name="utf8" c:type="const char*"/>
21540+ </parameter>
808921541 </parameters>
809021542 </method>
8091- <method name="get_input_hints"
8092- c:identifier="adw_entry_row_get_input_hints"
8093- glib:get-property="input-hints"
8094- version="1.2">
8095- <attribute name="org.gtk.Method.get_property" value="input-hints"/>
21543+ <method name="get_response_label"
21544+ c:identifier="adw_message_dialog_get_response_label"
21545+ version="1.2"
21546+ deprecated="1"
21547+ deprecated-version="1.6">
809621548 <doc xml:space="preserve"
8097- filename="src/adw-entry-row.c"
8098- line="846">Gets the additional input hints of @self.</doc>
8099- <source-position filename="src/adw-entry-row.h" line="54"/>
21549+ filename="src/adw-message-dialog.c"
21550+ line="2126">Gets the label of @response.
21551+
21552+See [method@MessageDialog.set_response_label].</doc>
21553+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
21554+ <source-position filename="src/adw-message-dialog.h" line="109"/>
810021555 <return-value transfer-ownership="none">
810121556 <doc xml:space="preserve"
8102- filename="src/adw-entry-row.c"
8103- line="852">The input hints</doc>
8104- <type name="Gtk.InputHints" c:type="GtkInputHints"/>
21557+ filename="src/adw-message-dialog.c"
21558+ line="2135">the label of @response</doc>
21559+ <type name="utf8" c:type="const char*"/>
810521560 </return-value>
810621561 <parameters>
810721562 <instance-parameter name="self" transfer-ownership="none">
810821563 <doc xml:space="preserve"
8109- filename="src/adw-entry-row.c"
8110- line="848">an entry row</doc>
8111- <type name="EntryRow" c:type="AdwEntryRow*"/>
21564+ filename="src/adw-message-dialog.c"
21565+ line="2128">a message dialog</doc>
21566+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
811221567 </instance-parameter>
21568+ <parameter name="response" transfer-ownership="none">
21569+ <doc xml:space="preserve"
21570+ filename="src/adw-message-dialog.c"
21571+ line="2129">a response ID</doc>
21572+ <type name="utf8" c:type="const char*"/>
21573+ </parameter>
811321574 </parameters>
811421575 </method>
8115- <method name="get_input_purpose"
8116- c:identifier="adw_entry_row_get_input_purpose"
8117- glib:get-property="input-purpose"
8118- version="1.2">
8119- <attribute name="org.gtk.Method.get_property" value="input-purpose"/>
21576+ <method name="has_response"
21577+ c:identifier="adw_message_dialog_has_response"
21578+ version="1.2"
21579+ deprecated="1"
21580+ deprecated-version="1.6">
812021581 <doc xml:space="preserve"
8121- filename="src/adw-entry-row.c"
8122- line="899">Gets the input purpose of @self.</doc>
8123- <source-position filename="src/adw-entry-row.h" line="60"/>
21582+ filename="src/adw-message-dialog.c"
21583+ line="2498">Gets whether @self has a response with the ID @response.</doc>
21584+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
21585+ <source-position filename="src/adw-message-dialog.h" line="149"/>
812421586 <return-value transfer-ownership="none">
812521587 <doc xml:space="preserve"
8126- filename="src/adw-entry-row.c"
8127- line="905">the input purpose</doc>
8128- <type name="Gtk.InputPurpose" c:type="GtkInputPurpose"/>
21588+ filename="src/adw-message-dialog.c"
21589+ line="2505">whether @self has a response with the ID @response.</doc>
21590+ <type name="gboolean" c:type="gboolean"/>
812921591 </return-value>
813021592 <parameters>
813121593 <instance-parameter name="self" transfer-ownership="none">
813221594 <doc xml:space="preserve"
8133- filename="src/adw-entry-row.c"
8134- line="901">an entry row</doc>
8135- <type name="EntryRow" c:type="AdwEntryRow*"/>
21595+ filename="src/adw-message-dialog.c"
21596+ line="2500">a message dialog</doc>
21597+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
813621598 </instance-parameter>
21599+ <parameter name="response" transfer-ownership="none">
21600+ <doc xml:space="preserve"
21601+ filename="src/adw-message-dialog.c"
21602+ line="2501">response ID</doc>
21603+ <type name="utf8" c:type="const char*"/>
21604+ </parameter>
813721605 </parameters>
813821606 </method>
8139- <method name="get_show_apply_button"
8140- c:identifier="adw_entry_row_get_show_apply_button"
8141- glib:get-property="show-apply-button"
8142- version="1.2">
8143- <attribute name="org.gtk.Method.get_property"
8144- value="show-apply-button"/>
21607+ <method name="remove_response"
21608+ c:identifier="adw_message_dialog_remove_response"
21609+ version="1.5"
21610+ deprecated="1"
21611+ deprecated-version="1.6">
814521612 <doc xml:space="preserve"
8146- filename="src/adw-entry-row.c"
8147- line="782">Gets whether @self can show the apply button.</doc>
8148- <source-position filename="src/adw-entry-row.h" line="48"/>
21613+ filename="src/adw-message-dialog.c"
21614+ line="2085">Removes a response from @self.</doc>
21615+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
21616+ <source-position filename="src/adw-message-dialog.h" line="100"/>
814921617 <return-value transfer-ownership="none">
8150- <doc xml:space="preserve"
8151- filename="src/adw-entry-row.c"
8152- line="788">whether to show the apply button</doc>
8153- <type name="gboolean" c:type="gboolean"/>
21618+ <type name="none" c:type="void"/>
815421619 </return-value>
815521620 <parameters>
815621621 <instance-parameter name="self" transfer-ownership="none">
815721622 <doc xml:space="preserve"
8158- filename="src/adw-entry-row.c"
8159- line="784">an entry row</doc>
8160- <type name="EntryRow" c:type="AdwEntryRow*"/>
21623+ filename="src/adw-message-dialog.c"
21624+ line="2087">a message dialog</doc>
21625+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
816121626 </instance-parameter>
21627+ <parameter name="id" transfer-ownership="none">
21628+ <doc xml:space="preserve"
21629+ filename="src/adw-message-dialog.c"
21630+ line="2088">the response ID</doc>
21631+ <type name="utf8" c:type="const char*"/>
21632+ </parameter>
816221633 </parameters>
816321634 </method>
8164- <method name="grab_focus_without_selecting"
8165- c:identifier="adw_entry_row_grab_focus_without_selecting"
8166- version="1.3">
21635+ <method name="response"
21636+ c:identifier="adw_message_dialog_response"
21637+ version="1.2"
21638+ deprecated="1"
21639+ deprecated-version="1.6">
21640+ <attribute name="org.gtk.Method.signal" value="response"/>
816721641 <doc xml:space="preserve"
8168- filename="src/adw-entry-row.c"
8169- line="1147">Causes @self to have keyboard focus without selecting the text.
21642+ filename="src/adw-message-dialog.c"
21643+ line="2475">Emits the [signal@MessageDialog::response] signal with the given response ID.
817021644
8171-See [method@Gtk.Text.grab_focus_without_selecting] for more information.</doc>
8172- <source-position filename="src/adw-entry-row.h" line="84"/>
21645+Used to indicate that the user has responded to the dialog in some way.</doc>
21646+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
21647+ <source-position filename="src/adw-message-dialog.h" line="145"/>
817321648 <return-value transfer-ownership="none">
8174- <doc xml:space="preserve"
8175- filename="src/adw-entry-row.c"
8176- line="1155">whether the focus is now inside @self</doc>
8177- <type name="gboolean" c:type="gboolean"/>
21649+ <type name="none" c:type="void"/>
817821650 </return-value>
817921651 <parameters>
818021652 <instance-parameter name="self" transfer-ownership="none">
818121653 <doc xml:space="preserve"
8182- filename="src/adw-entry-row.c"
8183- line="1149">an entry row</doc>
8184- <type name="EntryRow" c:type="AdwEntryRow*"/>
21654+ filename="src/adw-message-dialog.c"
21655+ line="2477">a message dialog</doc>
21656+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
818521657 </instance-parameter>
21658+ <parameter name="response" transfer-ownership="none">
21659+ <doc xml:space="preserve"
21660+ filename="src/adw-message-dialog.c"
21661+ line="2478">response ID</doc>
21662+ <type name="utf8" c:type="const char*"/>
21663+ </parameter>
818621664 </parameters>
818721665 </method>
8188- <method name="remove" c:identifier="adw_entry_row_remove" version="1.2">
21666+ <method name="set_body"
21667+ c:identifier="adw_message_dialog_set_body"
21668+ glib:set-property="body"
21669+ version="1.2"
21670+ deprecated="1"
21671+ deprecated-version="1.6">
818921672 <doc xml:space="preserve"
8190- filename="src/adw-entry-row.c"
8191- line="750">Removes a child from @self.</doc>
8192- <source-position filename="src/adw-entry-row.h" line="44"/>
21673+ filename="src/adw-message-dialog.c"
21674+ line="1720">Sets the body text of @self.</doc>
21675+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
21676+ <source-position filename="src/adw-message-dialog.h" line="69"/>
819321677 <return-value transfer-ownership="none">
819421678 <type name="none" c:type="void"/>
819521679 </return-value>
819621680 <parameters>
819721681 <instance-parameter name="self" transfer-ownership="none">
819821682 <doc xml:space="preserve"
8199- filename="src/adw-entry-row.c"
8200- line="752">an entry row</doc>
8201- <type name="EntryRow" c:type="AdwEntryRow*"/>
21683+ filename="src/adw-message-dialog.c"
21684+ line="1722">a message dialog</doc>
21685+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
820221686 </instance-parameter>
8203- <parameter name="widget" transfer-ownership="none">
21687+ <parameter name="body" transfer-ownership="none">
820421688 <doc xml:space="preserve"
8205- filename="src/adw-entry-row.c"
8206- line="753">the child to be removed</doc>
8207- <type name="Gtk.Widget" c:type="GtkWidget*"/>
21689+ filename="src/adw-message-dialog.c"
21690+ line="1723">the body of @self</doc>
21691+ <type name="utf8" c:type="const char*"/>
820821692 </parameter>
820921693 </parameters>
821021694 </method>
8211- <method name="set_activates_default"
8212- c:identifier="adw_entry_row_set_activates_default"
8213- glib:set-property="activates-default"
8214- version="1.2">
8215- <attribute name="org.gtk.Method.set_property"
8216- value="activates-default"/>
21695+ <method name="set_body_use_markup"
21696+ c:identifier="adw_message_dialog_set_body_use_markup"
21697+ glib:set-property="body-use-markup"
21698+ version="1.2"
21699+ deprecated="1"
21700+ deprecated-version="1.6">
821721701 <doc xml:space="preserve"
8218- filename="src/adw-entry-row.c"
8219- line="1077">Sets whether activating the embedded entry can activate the default widget.</doc>
8220- <source-position filename="src/adw-entry-row.h" line="80"/>
21702+ filename="src/adw-message-dialog.c"
21703+ line="1778">Sets whether the body text of @self includes Pango markup.
21704+
21705+See [func@Pango.parse_markup].</doc>
21706+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
21707+ <source-position filename="src/adw-message-dialog.h" line="75"/>
822121708 <return-value transfer-ownership="none">
822221709 <type name="none" c:type="void"/>
822321710 </return-value>
822421711 <parameters>
822521712 <instance-parameter name="self" transfer-ownership="none">
822621713 <doc xml:space="preserve"
8227- filename="src/adw-entry-row.c"
8228- line="1079">an entry row</doc>
8229- <type name="EntryRow" c:type="AdwEntryRow*"/>
21714+ filename="src/adw-message-dialog.c"
21715+ line="1780">a message dialog</doc>
21716+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
823021717 </instance-parameter>
8231- <parameter name="activates" transfer-ownership="none">
21718+ <parameter name="use_markup" transfer-ownership="none">
823221719 <doc xml:space="preserve"
8233- filename="src/adw-entry-row.c"
8234- line="1080">whether to activate the default widget</doc>
21720+ filename="src/adw-message-dialog.c"
21721+ line="1781">whether to use markup for body text</doc>
823521722 <type name="gboolean" c:type="gboolean"/>
823621723 </parameter>
823721724 </parameters>
823821725 </method>
8239- <method name="set_attributes"
8240- c:identifier="adw_entry_row_set_attributes"
8241- glib:set-property="attributes"
8242- version="1.2">
8243- <attribute name="org.gtk.Method.set_property" value="attributes"/>
21726+ <method name="set_close_response"
21727+ c:identifier="adw_message_dialog_set_close_response"
21728+ glib:set-property="close-response"
21729+ version="1.2"
21730+ deprecated="1"
21731+ deprecated-version="1.6">
824421732 <doc xml:space="preserve"
8245- filename="src/adw-entry-row.c"
8246- line="972">Sets Pango attributes to apply to the text of the embedded entry.
21733+ filename="src/adw-message-dialog.c"
21734+ line="2437">Sets the ID of the close response of @self.
824721735
8248-The [struct@Pango.Attribute]'s `start_index` and `end_index` must refer to
8249-the [class@Gtk.EntryBuffer] text, i.e. without the preedit string.</doc>
8250- <source-position filename="src/adw-entry-row.h" line="74"/>
21736+It will be passed to [signal@MessageDialog::response] if the window is
21737+closed by pressing &lt;kbd&gt;Escape&lt;/kbd&gt; or with a system action.
21738+
21739+It doesn't have to correspond to any of the responses in the dialog.
21740+
21741+The default close response is `close`.</doc>
21742+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
21743+ <source-position filename="src/adw-message-dialog.h" line="141"/>
825121744 <return-value transfer-ownership="none">
825221745 <type name="none" c:type="void"/>
825321746 </return-value>
825421747 <parameters>
825521748 <instance-parameter name="self" transfer-ownership="none">
825621749 <doc xml:space="preserve"
8257- filename="src/adw-entry-row.c"
8258- line="974">an entry row</doc>
8259- <type name="EntryRow" c:type="AdwEntryRow*"/>
21750+ filename="src/adw-message-dialog.c"
21751+ line="2439">a message dialog</doc>
21752+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
826021753 </instance-parameter>
8261- <parameter name="attributes"
8262- transfer-ownership="none"
8263- nullable="1"
8264- allow-none="1">
21754+ <parameter name="response" transfer-ownership="none">
826521755 <doc xml:space="preserve"
8266- filename="src/adw-entry-row.c"
8267- line="975">a list of attributes</doc>
8268- <type name="Pango.AttrList" c:type="PangoAttrList*"/>
21756+ filename="src/adw-message-dialog.c"
21757+ line="2440">the close response ID</doc>
21758+ <type name="utf8" c:type="const char*"/>
826921759 </parameter>
827021760 </parameters>
827121761 </method>
8272- <method name="set_enable_emoji_completion"
8273- c:identifier="adw_entry_row_set_enable_emoji_completion"
8274- glib:set-property="enable-emoji-completion"
8275- version="1.2">
8276- <attribute name="org.gtk.Method.get_property"
8277- value="enable-emoji-completion"/>
21762+ <method name="set_default_response"
21763+ c:identifier="adw_message_dialog_set_default_response"
21764+ glib:set-property="default-response"
21765+ version="1.2"
21766+ deprecated="1"
21767+ deprecated-version="1.6">
827821768 <doc xml:space="preserve"
8279- filename="src/adw-entry-row.c"
8280- line="1024">Sets whether to suggest emoji replacements on @self.
21769+ filename="src/adw-message-dialog.c"
21770+ line="2373">Sets the ID of the default response of @self.
828121771
8282-Emoji replacement is done with :-delimited names, like `:heart:`.</doc>
8283- <source-position filename="src/adw-entry-row.h" line="68"/>
21772+If set, pressing &lt;kbd&gt;Enter&lt;/kbd&gt; will activate the corresponding button.
21773+
21774+If set to `NULL` or to a non-existent response ID, pressing &lt;kbd&gt;Enter&lt;/kbd&gt;
21775+will do nothing.</doc>
21776+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
21777+ <source-position filename="src/adw-message-dialog.h" line="135"/>
828421778 <return-value transfer-ownership="none">
828521779 <type name="none" c:type="void"/>
828621780 </return-value>
828721781 <parameters>
828821782 <instance-parameter name="self" transfer-ownership="none">
828921783 <doc xml:space="preserve"
8290- filename="src/adw-entry-row.c"
8291- line="1026">an entry row</doc>
8292- <type name="EntryRow" c:type="AdwEntryRow*"/>
21784+ filename="src/adw-message-dialog.c"
21785+ line="2375">a message dialog</doc>
21786+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
829321787 </instance-parameter>
8294- <parameter name="enable_emoji_completion" transfer-ownership="none">
21788+ <parameter name="response"
21789+ transfer-ownership="none"
21790+ nullable="1"
21791+ allow-none="1">
829521792 <doc xml:space="preserve"
8296- filename="src/adw-entry-row.c"
8297- line="1027">Whether emoji completion should be enabled or not</doc>
8298- <type name="gboolean" c:type="gboolean"/>
21793+ filename="src/adw-message-dialog.c"
21794+ line="2376">the default response ID</doc>
21795+ <type name="utf8" c:type="const char*"/>
829921796 </parameter>
830021797 </parameters>
830121798 </method>
8302- <method name="set_input_hints"
8303- c:identifier="adw_entry_row_set_input_hints"
8304- glib:set-property="input-hints"
8305- version="1.2">
8306- <attribute name="org.gtk.Method.set_property" value="input-hints"/>
21799+ <method name="set_extra_child"
21800+ c:identifier="adw_message_dialog_set_extra_child"
21801+ glib:set-property="extra-child"
21802+ version="1.2"
21803+ deprecated="1"
21804+ deprecated-version="1.6">
830721805 <doc xml:space="preserve"
8308- filename="src/adw-entry-row.c"
8309- line="868">Set additional input hints for @self.
8310-
8311-Input hints allow input methods to fine-tune their behavior.
21806+ filename="src/adw-message-dialog.c"
21807+ line="1929">Sets the child widget of @self.
831221808
8313-See also: [property@AdwEntryRow:input-purpose]</doc>
8314- <source-position filename="src/adw-entry-row.h" line="56"/>
21809+The child widget is displayed below the heading and body.</doc>
21810+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
21811+ <source-position filename="src/adw-message-dialog.h" line="91"/>
831521812 <return-value transfer-ownership="none">
831621813 <type name="none" c:type="void"/>
831721814 </return-value>
831821815 <parameters>
831921816 <instance-parameter name="self" transfer-ownership="none">
8320- <doc xml:space="preserve"
8321- filename="src/adw-entry-row.c"
8322- line="870">an entry row</doc>
8323- <type name="EntryRow" c:type="AdwEntryRow*"/>
21817+ <doc xml:space="preserve"
21818+ filename="src/adw-message-dialog.c"
21819+ line="1931">a message dialog</doc>
21820+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
832421821 </instance-parameter>
8325- <parameter name="hints" transfer-ownership="none">
21822+ <parameter name="child"
21823+ transfer-ownership="none"
21824+ nullable="1"
21825+ allow-none="1">
832621826 <doc xml:space="preserve"
8327- filename="src/adw-entry-row.c"
8328- line="871">the hints</doc>
8329- <type name="Gtk.InputHints" c:type="GtkInputHints"/>
21827+ filename="src/adw-message-dialog.c"
21828+ line="1932">the child widget</doc>
21829+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
833021830 </parameter>
833121831 </parameters>
833221832 </method>
8333- <method name="set_input_purpose"
8334- c:identifier="adw_entry_row_set_input_purpose"
8335- glib:set-property="input-purpose"
8336- version="1.2">
8337- <attribute name="org.gtk.Method.set_property" value="input-purpose"/>
21833+ <method name="set_heading"
21834+ c:identifier="adw_message_dialog_set_heading"
21835+ glib:set-property="heading"
21836+ version="1.2"
21837+ deprecated="1"
21838+ deprecated-version="1.6">
833821839 <doc xml:space="preserve"
8339- filename="src/adw-entry-row.c"
8340- line="921">Sets the input purpose of @self.
8341-
8342-The input purpose can be used by input methods to adjust their behavior.</doc>
8343- <source-position filename="src/adw-entry-row.h" line="62"/>
21840+ filename="src/adw-message-dialog.c"
21841+ line="1503">Sets the heading of @self.</doc>
21842+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
21843+ <source-position filename="src/adw-message-dialog.h" line="47"/>
834421844 <return-value transfer-ownership="none">
834521845 <type name="none" c:type="void"/>
834621846 </return-value>
834721847 <parameters>
834821848 <instance-parameter name="self" transfer-ownership="none">
834921849 <doc xml:space="preserve"
8350- filename="src/adw-entry-row.c"
8351- line="923">an entry row</doc>
8352- <type name="EntryRow" c:type="AdwEntryRow*"/>
21850+ filename="src/adw-message-dialog.c"
21851+ line="1505">a message dialog</doc>
21852+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
835321853 </instance-parameter>
8354- <parameter name="purpose" transfer-ownership="none">
21854+ <parameter name="heading"
21855+ transfer-ownership="none"
21856+ nullable="1"
21857+ allow-none="1">
835521858 <doc xml:space="preserve"
8356- filename="src/adw-entry-row.c"
8357- line="924">the purpose</doc>
8358- <type name="Gtk.InputPurpose" c:type="GtkInputPurpose"/>
21859+ filename="src/adw-message-dialog.c"
21860+ line="1506">the heading of @self</doc>
21861+ <type name="utf8" c:type="const char*"/>
835921862 </parameter>
836021863 </parameters>
836121864 </method>
8362- <method name="set_show_apply_button"
8363- c:identifier="adw_entry_row_set_show_apply_button"
8364- glib:set-property="show-apply-button"
8365- version="1.2">
8366- <attribute name="org.gtk.Method.set_property"
8367- value="show-apply-button"/>
21865+ <method name="set_heading_use_markup"
21866+ c:identifier="adw_message_dialog_set_heading_use_markup"
21867+ glib:set-property="heading-use-markup"
21868+ version="1.2"
21869+ deprecated="1"
21870+ deprecated-version="1.6">
836821871 <doc xml:space="preserve"
8369- filename="src/adw-entry-row.c"
8370- line="804">Sets whether @self can show the apply button.
8371-
8372-When set to `TRUE`, typing text in the entry will reveal an apply button.
8373-Clicking it or pressing the &lt;kbd&gt;Enter&lt;/kbd&gt; key will hide the button and
8374-emit the [signal@EntryRow::apply] signal.
21872+ filename="src/adw-message-dialog.c"
21873+ line="1565">Sets whether the heading of @self includes Pango markup.
837521874
8376-This is useful if changing the entry contents can trigger an expensive
8377-operation, e.g. network activity, to avoid triggering it after typing every
8378-character.</doc>
8379- <source-position filename="src/adw-entry-row.h" line="50"/>
21875+See [func@Pango.parse_markup].</doc>
21876+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
21877+ <source-position filename="src/adw-message-dialog.h" line="53"/>
838021878 <return-value transfer-ownership="none">
838121879 <type name="none" c:type="void"/>
838221880 </return-value>
838321881 <parameters>
838421882 <instance-parameter name="self" transfer-ownership="none">
838521883 <doc xml:space="preserve"
8386- filename="src/adw-entry-row.c"
8387- line="806">an entry row</doc>
8388- <type name="EntryRow" c:type="AdwEntryRow*"/>
21884+ filename="src/adw-message-dialog.c"
21885+ line="1567">a message dialog</doc>
21886+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
838921887 </instance-parameter>
8390- <parameter name="show_apply_button" transfer-ownership="none">
21888+ <parameter name="use_markup" transfer-ownership="none">
839121889 <doc xml:space="preserve"
8392- filename="src/adw-entry-row.c"
8393- line="807">whether to show the apply button</doc>
21890+ filename="src/adw-message-dialog.c"
21891+ line="1568">whether to use markup for heading</doc>
839421892 <type name="gboolean" c:type="gboolean"/>
839521893 </parameter>
839621894 </parameters>
839721895 </method>
8398- <property name="activates-default"
8399- version="1.2"
8400- writable="1"
8401- transfer-ownership="none"
8402- setter="set_activates_default"
8403- getter="get_activates_default"
8404- default-value="FALSE">
8405- <attribute name="org.gtk.Property.get"
8406- value="adw_entry_row_get_activates_default"/>
8407- <attribute name="org.gtk.Property.set"
8408- value="adw_entry_row_set_activates_default"/>
8409- <doc xml:space="preserve"
8410- filename="src/adw-entry-row.c"
8411- line="534">Whether activating the embedded entry can activate the default widget.</doc>
8412- <type name="gboolean" c:type="gboolean"/>
8413- </property>
8414- <property name="attributes"
8415- version="1.2"
8416- writable="1"
8417- transfer-ownership="none"
8418- setter="set_attributes"
8419- getter="get_attributes">
8420- <attribute name="org.gtk.Property.get"
8421- value="adw_entry_row_get_attributes"/>
8422- <attribute name="org.gtk.Property.set"
8423- value="adw_entry_row_set_attributes"/>
8424- <doc xml:space="preserve"
8425- filename="src/adw-entry-row.c"
8426- line="505">A list of Pango attributes to apply to the text of the embedded entry.
8427-
8428-The [struct@Pango.Attribute]'s `start_index` and `end_index` must refer to
8429-the [class@Gtk.EntryBuffer] text, i.e. without the preedit string.</doc>
8430- <type name="Pango.AttrList"/>
8431- </property>
8432- <property name="enable-emoji-completion"
8433- version="1.2"
8434- writable="1"
8435- transfer-ownership="none"
8436- setter="set_enable_emoji_completion"
8437- getter="get_enable_emoji_completion"
8438- default-value="FALSE">
8439- <attribute name="org.gtk.Property.get"
8440- value="adw_entry_row_get_enable_emoji_completion"/>
8441- <attribute name="org.gtk.Property.set"
8442- value="adw_entry_row_set_enable_emoji_completion"/>
8443- <doc xml:space="preserve"
8444- filename="src/adw-entry-row.c"
8445- line="520">Whether to suggest emoji replacements on the entry row.
8446-
8447-Emoji replacement is done with :-delimited names, like `:heart:`.</doc>
8448- <type name="gboolean" c:type="gboolean"/>
8449- </property>
8450- <property name="input-hints"
8451- version="1.2"
8452- writable="1"
8453- transfer-ownership="none"
8454- setter="set_input_hints"
8455- getter="get_input_hints"
8456- default-value="GTK_INPUT_HINT_NONE">
8457- <attribute name="org.gtk.Property.get"
8458- value="adw_entry_row_get_input_hints"/>
8459- <attribute name="org.gtk.Property.set"
8460- value="adw_entry_row_set_input_hints"/>
21896+ <method name="set_response_appearance"
21897+ c:identifier="adw_message_dialog_set_response_appearance"
21898+ version="1.2"
21899+ deprecated="1"
21900+ deprecated-version="1.6">
846121901 <doc xml:space="preserve"
8462- filename="src/adw-entry-row.c"
8463- line="473">Additional input hints for the entry row.
8464-
8465-Input hints allow input methods to fine-tune their behavior.
21902+ filename="src/adw-message-dialog.c"
21903+ line="2217">Sets the appearance for @response.
846621904
8467-See also: [property@Adw.EntryRow:input-purpose]</doc>
8468- <type name="Gtk.InputHints"/>
8469- </property>
8470- <property name="input-purpose"
8471- version="1.2"
8472- writable="1"
8473- transfer-ownership="none"
8474- setter="set_input_purpose"
8475- getter="get_input_purpose"
8476- default-value="GTK_INPUT_PURPOSE_FREE_FORM">
8477- <attribute name="org.gtk.Property.get"
8478- value="adw_entry_row_get_input_purpose"/>
8479- <attribute name="org.gtk.Property.set"
8480- value="adw_entry_row_set_input_purpose"/>
8481- <doc xml:space="preserve"
8482- filename="src/adw-entry-row.c"
8483- line="490">The input purpose of the entry row.
21905+&lt;picture&gt;
21906+ &lt;source srcset="message-dialog-appearance-dark.png" media="(prefers-color-scheme: dark)"&gt;
21907+ &lt;img src="message-dialog-appearance.png" alt="message-dialog-appearance"&gt;
21908+&lt;/picture&gt;
848421909
8485-The input purpose can be used by input methods to adjust their behavior.</doc>
8486- <type name="Gtk.InputPurpose"/>
8487- </property>
8488- <property name="show-apply-button"
8489- version="1.2"
8490- writable="1"
8491- transfer-ownership="none"
8492- setter="set_show_apply_button"
8493- getter="get_show_apply_button"
8494- default-value="FALSE">
8495- <attribute name="org.gtk.Property.get"
8496- value="adw_entry_row_get_show_apply_button"/>
8497- <attribute name="org.gtk.Property.set"
8498- value="adw_entry_row_set_show_apply_button"/>
8499- <doc xml:space="preserve"
8500- filename="src/adw-entry-row.c"
8501- line="453">Whether to show the apply button.
21910+Use `ADW_RESPONSE_SUGGESTED` to mark important responses such as the
21911+affirmative action, like the Save button in the example.
850221912
8503-When set to `TRUE`, typing text in the entry will reveal an apply button.
8504-Clicking it or pressing the &lt;kbd&gt;Enter&lt;/kbd&gt; key will hide the button and
8505-emit the [signal@EntryRow::apply] signal.
21913+Use `ADW_RESPONSE_DESTRUCTIVE` to draw attention to the potentially damaging
21914+consequences of using @response. This appearance acts as a warning to the
21915+user. The Discard button in the example is using this appearance.
850621916
8507-This is useful if changing the entry contents can trigger an expensive
8508-operation, e.g. network activity, to avoid triggering it after typing every
8509-character.</doc>
8510- <type name="gboolean" c:type="gboolean"/>
8511- </property>
8512- <field name="parent_instance">
8513- <type name="PreferencesRow" c:type="AdwPreferencesRow"/>
8514- </field>
8515- <glib:signal name="apply" when="last" version="1.2">
8516- <doc xml:space="preserve"
8517- filename="src/adw-entry-row.c"
8518- line="550">Emitted when the apply button is pressed.
21917+The default appearance is `ADW_RESPONSE_DEFAULT`.
851921918
8520-See [property@EntryRow:show-apply-button].</doc>
8521- <return-value transfer-ownership="none">
8522- <type name="none" c:type="void"/>
8523- </return-value>
8524- </glib:signal>
8525- <glib:signal name="entry-activated" when="last" version="1.2">
8526- <doc xml:space="preserve"
8527- filename="src/adw-entry-row.c"
8528- line="572">Emitted when the embedded entry is activated.</doc>
21919+Negative responses like Cancel or Close should use the default appearance.</doc>
21920+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
21921+ <source-position filename="src/adw-message-dialog.h" line="120"/>
852921922 <return-value transfer-ownership="none">
853021923 <type name="none" c:type="void"/>
853121924 </return-value>
8532- </glib:signal>
8533- </class>
8534- <record name="EntryRowClass"
8535- c:type="AdwEntryRowClass"
8536- glib:is-gtype-struct-for="EntryRow">
8537- <source-position filename="src/adw-entry-row.h" line="32"/>
8538- <field name="parent_class">
8539- <doc xml:space="preserve"
8540- filename="src/adw-entry-row.h"
8541- line="27">The parent class</doc>
8542- <type name="PreferencesRowClass" c:type="AdwPreferencesRowClass"/>
8543- </field>
8544- </record>
8545- <class name="EnumListItem"
8546- c:symbol-prefix="enum_list_item"
8547- c:type="AdwEnumListItem"
8548- parent="GObject.Object"
8549- final="1"
8550- glib:type-name="AdwEnumListItem"
8551- glib:get-type="adw_enum_list_item_get_type"
8552- glib:type-struct="EnumListItemClass">
8553- <doc xml:space="preserve"
8554- filename="src/adw-enum-list-model.c"
8555- line="44">`AdwEnumListItem` is the type of items in a [class@EnumListModel].</doc>
8556- <source-position filename="src/adw-enum-list-model.h" line="22"/>
8557- <method name="get_name"
8558- c:identifier="adw_enum_list_item_get_name"
8559- glib:get-property="name">
8560- <attribute name="org.gtk.Method.get_property" value="name"/>
8561- <doc xml:space="preserve"
8562- filename="src/adw-enum-list-model.c"
8563- line="162">Gets the enum value name.</doc>
8564- <source-position filename="src/adw-enum-list-model.h" line="28"/>
8565- <return-value transfer-ownership="none">
8566- <doc xml:space="preserve"
8567- filename="src/adw-enum-list-model.c"
8568- line="167">the enum value name</doc>
8569- <type name="utf8" c:type="const char*"/>
8570- </return-value>
857121925 <parameters>
857221926 <instance-parameter name="self" transfer-ownership="none">
8573- <type name="EnumListItem" c:type="AdwEnumListItem*"/>
21927+ <doc xml:space="preserve"
21928+ filename="src/adw-message-dialog.c"
21929+ line="2219">a message dialog</doc>
21930+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
857421931 </instance-parameter>
21932+ <parameter name="response" transfer-ownership="none">
21933+ <doc xml:space="preserve"
21934+ filename="src/adw-message-dialog.c"
21935+ line="2220">a response ID</doc>
21936+ <type name="utf8" c:type="const char*"/>
21937+ </parameter>
21938+ <parameter name="appearance" transfer-ownership="none">
21939+ <doc xml:space="preserve"
21940+ filename="src/adw-message-dialog.c"
21941+ line="2221">appearance for @response</doc>
21942+ <type name="ResponseAppearance" c:type="AdwResponseAppearance"/>
21943+ </parameter>
857521944 </parameters>
857621945 </method>
8577- <method name="get_nick"
8578- c:identifier="adw_enum_list_item_get_nick"
8579- glib:get-property="nick">
8580- <attribute name="org.gtk.Method.get_property" value="nick"/>
21946+ <method name="set_response_enabled"
21947+ c:identifier="adw_message_dialog_set_response_enabled"
21948+ version="1.2"
21949+ deprecated="1"
21950+ deprecated-version="1.6">
858121951 <doc xml:space="preserve"
8582- filename="src/adw-enum-list-model.c"
8583- line="177">Gets the enum value nick.</doc>
8584- <source-position filename="src/adw-enum-list-model.h" line="31"/>
21952+ filename="src/adw-message-dialog.c"
21953+ line="2304">Sets whether @response is enabled.
21954+
21955+If @response is not enabled, the corresponding button will have
21956+[property@Gtk.Widget:sensitive] set to `FALSE` and it can't be activated as
21957+a default response.
21958+
21959+@response can still be used as [property@MessageDialog:close-response] while
21960+it's not enabled.
21961+
21962+Responses are enabled by default.</doc>
21963+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
21964+ <source-position filename="src/adw-message-dialog.h" line="128"/>
858521965 <return-value transfer-ownership="none">
8586- <doc xml:space="preserve"
8587- filename="src/adw-enum-list-model.c"
8588- line="182">the enum value nick</doc>
8589- <type name="utf8" c:type="const char*"/>
21966+ <type name="none" c:type="void"/>
859021967 </return-value>
859121968 <parameters>
859221969 <instance-parameter name="self" transfer-ownership="none">
8593- <type name="EnumListItem" c:type="AdwEnumListItem*"/>
21970+ <doc xml:space="preserve"
21971+ filename="src/adw-message-dialog.c"
21972+ line="2306">a message dialog</doc>
21973+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
859421974 </instance-parameter>
21975+ <parameter name="response" transfer-ownership="none">
21976+ <doc xml:space="preserve"
21977+ filename="src/adw-message-dialog.c"
21978+ line="2307">a response ID</doc>
21979+ <type name="utf8" c:type="const char*"/>
21980+ </parameter>
21981+ <parameter name="enabled" transfer-ownership="none">
21982+ <doc xml:space="preserve"
21983+ filename="src/adw-message-dialog.c"
21984+ line="2308">whether to enable @response</doc>
21985+ <type name="gboolean" c:type="gboolean"/>
21986+ </parameter>
859521987 </parameters>
859621988 </method>
8597- <method name="get_value"
8598- c:identifier="adw_enum_list_item_get_value"
8599- glib:get-property="value">
8600- <attribute name="org.gtk.Method.get_property" value="value"/>
21989+ <method name="set_response_label"
21990+ c:identifier="adw_message_dialog_set_response_label"
21991+ version="1.2"
21992+ deprecated="1"
21993+ deprecated-version="1.6">
860121994 <doc xml:space="preserve"
8602- filename="src/adw-enum-list-model.c"
8603- line="147">Gets the enum value.</doc>
8604- <source-position filename="src/adw-enum-list-model.h" line="25"/>
21995+ filename="src/adw-message-dialog.c"
21996+ line="2155">Sets the label of @response to @label.
21997+
21998+Labels are displayed on the dialog buttons. An embedded underline in @label
21999+indicates a mnemonic.</doc>
22000+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
22001+ <source-position filename="src/adw-message-dialog.h" line="112"/>
860522002 <return-value transfer-ownership="none">
8606- <doc xml:space="preserve"
8607- filename="src/adw-enum-list-model.c"
8608- line="152">the enum value</doc>
8609- <type name="gint" c:type="int"/>
22003+ <type name="none" c:type="void"/>
861022004 </return-value>
861122005 <parameters>
861222006 <instance-parameter name="self" transfer-ownership="none">
8613- <type name="EnumListItem" c:type="AdwEnumListItem*"/>
22007+ <doc xml:space="preserve"
22008+ filename="src/adw-message-dialog.c"
22009+ line="2157">a message dialog</doc>
22010+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
861422011 </instance-parameter>
22012+ <parameter name="response" transfer-ownership="none">
22013+ <doc xml:space="preserve"
22014+ filename="src/adw-message-dialog.c"
22015+ line="2158">a response ID</doc>
22016+ <type name="utf8" c:type="const char*"/>
22017+ </parameter>
22018+ <parameter name="label" transfer-ownership="none">
22019+ <doc xml:space="preserve"
22020+ filename="src/adw-message-dialog.c"
22021+ line="2159">the label of @response</doc>
22022+ <type name="utf8" c:type="const char*"/>
22023+ </parameter>
861522024 </parameters>
861622025 </method>
8617- <property name="name"
22026+ <property name="body"
22027+ version="1.2"
22028+ deprecated="1"
22029+ deprecated-version="1.6"
22030+ writable="1"
861822031 transfer-ownership="none"
8619- getter="get_name"
8620- default-value="NULL">
8621- <attribute name="org.gtk.Property.get"
8622- value="adw_enum_list_item_get_name"/>
22032+ setter="set_body"
22033+ getter="get_body">
862322034 <doc xml:space="preserve"
8624- filename="src/adw-enum-list-model.c"
8625- line="109">The enum value name.</doc>
22035+ filename="src/adw-message-dialog.c"
22036+ line="1027">The body text of the dialog.</doc>
22037+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
862622038 <type name="utf8" c:type="gchar*"/>
862722039 </property>
8628- <property name="nick"
22040+ <property name="body-use-markup"
22041+ version="1.2"
22042+ deprecated="1"
22043+ deprecated-version="1.6"
22044+ writable="1"
862922045 transfer-ownership="none"
8630- getter="get_nick"
8631- default-value="NULL">
8632- <attribute name="org.gtk.Property.get"
8633- value="adw_enum_list_item_get_nick"/>
22046+ setter="set_body_use_markup"
22047+ getter="get_body_use_markup"
22048+ default-value="FALSE">
863422049 <doc xml:space="preserve"
8635- filename="src/adw-enum-list-model.c"
8636- line="119">The enum value nick.</doc>
22050+ filename="src/adw-message-dialog.c"
22051+ line="1040">Whether the body text includes Pango markup.
22052+
22053+See [func@Pango.parse_markup].</doc>
22054+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
22055+ <type name="gboolean" c:type="gboolean"/>
22056+ </property>
22057+ <property name="close-response"
22058+ version="1.2"
22059+ deprecated="1"
22060+ deprecated-version="1.6"
22061+ writable="1"
22062+ transfer-ownership="none"
22063+ setter="set_close_response"
22064+ getter="get_close_response"
22065+ default-value="close">
22066+ <doc xml:space="preserve"
22067+ filename="src/adw-message-dialog.c"
22068+ line="1088">The ID of the close response.
22069+
22070+It will be passed to [signal@MessageDialog::response] if the window is
22071+closed by pressing &lt;kbd&gt;Escape&lt;/kbd&gt; or with a system action.
22072+
22073+It doesn't have to correspond to any of the responses in the dialog.
22074+
22075+The default close response is `close`.</doc>
22076+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
863722077 <type name="utf8" c:type="gchar*"/>
863822078 </property>
8639- <property name="value"
22079+ <property name="default-response"
22080+ version="1.2"
22081+ deprecated="1"
22082+ deprecated-version="1.6"
22083+ writable="1"
864022084 transfer-ownership="none"
8641- getter="get_value"
8642- default-value="0">
8643- <attribute name="org.gtk.Property.get"
8644- value="adw_enum_list_item_get_value"/>
22085+ setter="set_default_response"
22086+ getter="get_default_response"
22087+ default-value="NULL">
864522088 <doc xml:space="preserve"
8646- filename="src/adw-enum-list-model.c"
8647- line="99">The enum value.</doc>
8648- <type name="gint" c:type="gint"/>
22089+ filename="src/adw-message-dialog.c"
22090+ line="1070">The response ID of the default response.
22091+
22092+If set, pressing &lt;kbd&gt;Enter&lt;/kbd&gt; will activate the corresponding button.
22093+
22094+If set to `NULL` or a non-existent response ID, pressing &lt;kbd&gt;Enter&lt;/kbd&gt;
22095+will do nothing.</doc>
22096+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
22097+ <type name="utf8" c:type="gchar*"/>
864922098 </property>
8650- </class>
8651- <record name="EnumListItemClass"
8652- c:type="AdwEnumListItemClass"
8653- glib:is-gtype-struct-for="EnumListItem">
8654- <source-position filename="src/adw-enum-list-model.h" line="22"/>
8655- <field name="parent_class">
8656- <type name="GObject.ObjectClass" c:type="GObjectClass"/>
8657- </field>
8658- </record>
8659- <class name="EnumListModel"
8660- c:symbol-prefix="enum_list_model"
8661- c:type="AdwEnumListModel"
8662- parent="GObject.Object"
8663- final="1"
8664- glib:type-name="AdwEnumListModel"
8665- glib:get-type="adw_enum_list_model_get_type"
8666- glib:type-struct="EnumListModelClass">
8667- <doc xml:space="preserve"
8668- filename="src/adw-enum-list-model.c"
8669- line="13">A [iface@Gio.ListModel] representing values of a given enum.
22099+ <property name="extra-child"
22100+ version="1.2"
22101+ deprecated="1"
22102+ deprecated-version="1.6"
22103+ writable="1"
22104+ transfer-ownership="none"
22105+ setter="set_extra_child"
22106+ getter="get_extra_child">
22107+ <doc xml:space="preserve"
22108+ filename="src/adw-message-dialog.c"
22109+ line="1055">The child widget.
867022110
8671-`AdwEnumListModel` contains objects of type [class@EnumListItem].</doc>
8672- <source-position filename="src/adw-enum-list-model.h" line="36"/>
8673- <implements name="Gio.ListModel"/>
8674- <constructor name="new" c:identifier="adw_enum_list_model_new">
22111+Displayed below the heading and body.</doc>
22112+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
22113+ <type name="Gtk.Widget"/>
22114+ </property>
22115+ <property name="heading"
22116+ version="1.2"
22117+ deprecated="1"
22118+ deprecated-version="1.6"
22119+ writable="1"
22120+ transfer-ownership="none"
22121+ setter="set_heading"
22122+ getter="get_heading">
867522123 <doc xml:space="preserve"
8676- filename="src/adw-enum-list-model.c"
8677- line="320">Creates a new `AdwEnumListModel` for @enum_type.</doc>
8678- <source-position filename="src/adw-enum-list-model.h" line="39"/>
8679- <return-value transfer-ownership="full">
8680- <doc xml:space="preserve"
8681- filename="src/adw-enum-list-model.c"
8682- line="326">the newly created `AdwEnumListModel`</doc>
8683- <type name="EnumListModel" c:type="AdwEnumListModel*"/>
8684- </return-value>
8685- <parameters>
8686- <parameter name="enum_type" transfer-ownership="none">
8687- <doc xml:space="preserve"
8688- filename="src/adw-enum-list-model.c"
8689- line="322">the type of the enum to construct the model from</doc>
8690- <type name="GType" c:type="GType"/>
8691- </parameter>
8692- </parameters>
8693- </constructor>
8694- <method name="find_position"
8695- c:identifier="adw_enum_list_model_find_position">
22124+ filename="src/adw-message-dialog.c"
22125+ line="999">The heading of the dialog.</doc>
22126+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
22127+ <type name="utf8" c:type="gchar*"/>
22128+ </property>
22129+ <property name="heading-use-markup"
22130+ version="1.2"
22131+ deprecated="1"
22132+ deprecated-version="1.6"
22133+ writable="1"
22134+ transfer-ownership="none"
22135+ setter="set_heading_use_markup"
22136+ getter="get_heading_use_markup"
22137+ default-value="FALSE">
869622138 <doc xml:space="preserve"
8697- filename="src/adw-enum-list-model.c"
8698- line="351">Finds the position of a given enum value in @self.</doc>
8699- <source-position filename="src/adw-enum-list-model.h" line="45"/>
22139+ filename="src/adw-message-dialog.c"
22140+ line="1012">Whether the heading includes Pango markup.
22141+
22142+See [func@Pango.parse_markup].</doc>
22143+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
22144+ <type name="gboolean" c:type="gboolean"/>
22145+ </property>
22146+ <field name="parent_instance">
22147+ <type name="Gtk.Window" c:type="GtkWindow"/>
22148+ </field>
22149+ <glib:signal name="response"
22150+ when="last"
22151+ detailed="1"
22152+ version="1.2"
22153+ deprecated="1"
22154+ deprecated-version="1.6">
22155+ <doc xml:space="preserve"
22156+ filename="src/adw-message-dialog.c"
22157+ line="1110">This signal is emitted when the dialog is closed.
22158+
22159+@response will be set to the response ID of the button that had been
22160+activated.
22161+
22162+if the dialog was closed by pressing &lt;kbd&gt;Escape&lt;/kbd&gt; or with a system
22163+action, @response will be set to the value of
22164+[property@MessageDialog:close-response].</doc>
22165+ <doc-deprecated xml:space="preserve">Use [class@AlertDialog].</doc-deprecated>
870022166 <return-value transfer-ownership="none">
8701- <type name="guint" c:type="guint"/>
22167+ <type name="none" c:type="void"/>
870222168 </return-value>
870322169 <parameters>
8704- <instance-parameter name="self" transfer-ownership="none">
8705- <type name="EnumListModel" c:type="AdwEnumListModel*"/>
8706- </instance-parameter>
8707- <parameter name="value" transfer-ownership="none">
22170+ <parameter name="response" transfer-ownership="none">
870822171 <doc xml:space="preserve"
8709- filename="src/adw-enum-list-model.c"
8710- line="353">an enum value</doc>
8711- <type name="gint" c:type="int"/>
22172+ filename="src/adw-message-dialog.c"
22173+ line="1113">the response ID</doc>
22174+ <type name="utf8" c:type="gchar*"/>
871222175 </parameter>
871322176 </parameters>
8714- </method>
8715- <method name="get_enum_type"
8716- c:identifier="adw_enum_list_model_get_enum_type"
8717- glib:get-property="enum-type">
8718- <attribute name="org.gtk.Method.get_property" value="enum-type"/>
8719- <doc xml:space="preserve"
8720- filename="src/adw-enum-list-model.c"
8721- line="336">Gets the type of the enum represented by @self.</doc>
8722- <source-position filename="src/adw-enum-list-model.h" line="42"/>
8723- <return-value transfer-ownership="none">
8724- <doc xml:space="preserve"
8725- filename="src/adw-enum-list-model.c"
8726- line="341">the enum type</doc>
8727- <type name="GType" c:type="GType"/>
8728- </return-value>
8729- <parameters>
8730- <instance-parameter name="self" transfer-ownership="none">
8731- <type name="EnumListModel" c:type="AdwEnumListModel*"/>
8732- </instance-parameter>
8733- </parameters>
8734- </method>
8735- <property name="enum-type"
8736- writable="1"
8737- construct-only="1"
8738- transfer-ownership="none"
8739- getter="get_enum_type">
8740- <attribute name="org.gtk.Property.get"
8741- value="adw_enum_list_model_get_enum_type"/>
8742- <doc xml:space="preserve"
8743- filename="src/adw-enum-list-model.c"
8744- line="268">The type of the enum represented by the model.</doc>
8745- <type name="GType" c:type="GType"/>
8746- </property>
22177+ </glib:signal>
874722178 </class>
8748- <record name="EnumListModelClass"
8749- c:type="AdwEnumListModelClass"
8750- glib:is-gtype-struct-for="EnumListModel">
8751- <source-position filename="src/adw-enum-list-model.h" line="36"/>
22179+ <record name="MessageDialogClass"
22180+ c:type="AdwMessageDialogClass"
22181+ glib:is-gtype-struct-for="MessageDialog">
22182+ <source-position filename="src/adw-message-dialog.h" line="37"/>
875222183 <field name="parent_class">
8753- <type name="GObject.ObjectClass" c:type="GObjectClass"/>
22184+ <type name="Gtk.WindowClass" c:type="GtkWindowClass"/>
22185+ </field>
22186+ <field name="response">
22187+ <callback name="response">
22188+ <source-position filename="src/adw-message-dialog.h" line="32"/>
22189+ <return-value transfer-ownership="none">
22190+ <type name="none" c:type="void"/>
22191+ </return-value>
22192+ <parameters>
22193+ <parameter name="self" transfer-ownership="none">
22194+ <doc xml:space="preserve"
22195+ filename="src/adw-message-dialog.c"
22196+ line="2477">a message dialog</doc>
22197+ <type name="MessageDialog" c:type="AdwMessageDialog*"/>
22198+ </parameter>
22199+ <parameter name="response" transfer-ownership="none">
22200+ <doc xml:space="preserve"
22201+ filename="src/adw-message-dialog.c"
22202+ line="2478">response ID</doc>
22203+ <type name="utf8" c:type="const char*"/>
22204+ </parameter>
22205+ </parameters>
22206+ </callback>
22207+ </field>
22208+ <field name="padding" readable="0" private="1">
22209+ <array zero-terminated="0" fixed-size="4">
22210+ <type name="gpointer" c:type="gpointer"/>
22211+ </array>
875422212 </field>
875522213 </record>
8756- <class name="ExpanderRow"
8757- c:symbol-prefix="expander_row"
8758- c:type="AdwExpanderRow"
8759- parent="PreferencesRow"
8760- glib:type-name="AdwExpanderRow"
8761- glib:get-type="adw_expander_row_get_type"
8762- glib:type-struct="ExpanderRowClass">
22214+ <class name="MultiLayoutView"
22215+ c:symbol-prefix="multi_layout_view"
22216+ c:type="AdwMultiLayoutView"
22217+ version="1.6"
22218+ parent="Gtk.Widget"
22219+ final="1"
22220+ glib:type-name="AdwMultiLayoutView"
22221+ glib:get-type="adw_multi_layout_view_get_type"
22222+ glib:type-struct="MultiLayoutViewClass">
876322223 <doc xml:space="preserve"
8764- filename="src/adw-expander-row.c"
8765- line="13">A [class@Gtk.ListBoxRow] used to reveal widgets.
22224+ filename="src/adw-multi-layout-view.c"
22225+ line="17">A widget for switching between different layouts.
876622226
8767-&lt;picture&gt;
8768- &lt;source srcset="expander-row-dark.png" media="(prefers-color-scheme: dark)"&gt;
8769- &lt;img src="expander-row.png" alt="expander-row"&gt;
8770-&lt;/picture&gt;
22227+`AdwMultiLayoutView` contains layouts and children. Each child has
22228+an ID, each layout has slots inside it, each slot also has an ID. When
22229+switching layouts, children are inserted into slots with matching IDs. The
22230+[property@Gtk.Widget:visible] property of each slot is updated to match
22231+that of the inserted child.
877122232
8772-The `AdwExpanderRow` widget allows the user to reveal or hide widgets below
8773-it. It also allows the user to enable the expansion of the row, allowing to
8774-disable all that the row contains.
22233+This can be useful for rearranging children when it's difficult to do so
22234+otherwise, for example to move a child from a sidebar to a bottom bar.
877522235
8776-## AdwExpanderRow as GtkBuildable
22236+The currently used layout can be switched using the
22237+[property@MultiLayoutView:layout] or [property@MultiLayoutView:layout-name]
22238+properties. For example, it can be done via a [class@Adw.Breakpoint] setter
22239+to change layouts depending on the window size.
877722240
8778-The `AdwExpanderRow` implementation of the [iface@Gtk.Buildable] interface
8779-supports adding a child as an action widget by specifying “action” as the
8780-“type” attribute of a &lt;child&gt; element.
22241+## AdwMultiLayoutView as GtkBuildable
878122242
8782-It also supports adding it as a prefix widget by specifying “prefix” as the
8783-“type” attribute of a &lt;child&gt; element.
22243+The `AdwMultiLayoutView` implementation of the [iface@Gtk.Buildable]
22244+interface supports adding layouts via `&lt;child&gt;` element with the `type`
22245+attribute omitted.
878422246
8785-## CSS nodes
22247+It also supports setting children via `&lt;child type="ID"&gt;`.
878622248
8787-`AdwExpanderRow` has a main CSS node with name `row` and the `.expander`
8788-style class. It has the `.empty` style class when it contains no children.
22249+Example of an `AdwMultiLayoutView` UI definition that can display a secondary
22250+child as either a sidebar or a bottom sheet.
878922251
8790-It contains the subnodes `row.header` for its main embedded row,
8791-`list.nested` for the list it can expand, and `image.expander-row-arrow` for
8792-its arrow.</doc>
8793- <source-position filename="src/adw-expander-row.h" line="35"/>
22252+```xml
22253+&lt;object class="AdwMultiLayoutView"&gt;
22254+ &lt;child&gt;
22255+ &lt;object class="AdwLayout"&gt;
22256+ &lt;property name="name"&gt;sidebar&lt;/property&gt;
22257+ &lt;property name="content"&gt;
22258+ &lt;object class="AdwOverlaySplitView"&gt;
22259+ &lt;property name="sidebar"&gt;
22260+ &lt;object class="AdwLayoutSlot"&gt;
22261+ &lt;property name="id"&gt;secondary&lt;/property&gt;
22262+ &lt;/object&gt;
22263+ &lt;/property&gt;
22264+ &lt;property name="content"&gt;
22265+ &lt;object class="AdwLayoutSlot"&gt;
22266+ &lt;property name="id"&gt;primary&lt;/property&gt;
22267+ &lt;/object&gt;
22268+ &lt;/property&gt;
22269+ &lt;/object&gt;
22270+ &lt;/property&gt;
22271+ &lt;/object&gt;
22272+ &lt;/child&gt;
22273+ &lt;child&gt;
22274+ &lt;object class="AdwLayout"&gt;
22275+ &lt;property name="name"&gt;bottom-sheet&lt;/property&gt;
22276+ &lt;property name="content"&gt;
22277+ &lt;object class="AdwBottomSheet"&gt;
22278+ &lt;property name="open"&gt;True&lt;/property&gt;
22279+ &lt;property name="content"&gt;
22280+ &lt;object class="AdwLayoutSlot"&gt;
22281+ &lt;property name="id"&gt;primary&lt;/property&gt;
22282+ &lt;/object&gt;
22283+ &lt;/property&gt;
22284+ &lt;property name="sheet"&gt;
22285+ &lt;object class="AdwLayoutSlot"&gt;
22286+ &lt;property name="id"&gt;secondary&lt;/property&gt;
22287+ &lt;/object&gt;
22288+ &lt;/property&gt;
22289+ &lt;/object&gt;
22290+ &lt;/property&gt;
22291+ &lt;/object&gt;
22292+ &lt;/child&gt;
22293+ &lt;child type="primary"&gt;
22294+ &lt;!-- ... --&gt;
22295+ &lt;/child&gt;
22296+ &lt;child type="secondary"&gt;
22297+ &lt;!-- ... --&gt;
22298+ &lt;/child&gt;
22299+&lt;/object&gt;
22300+```
22301+
22302+## CSS nodes
22303+
22304+`AdwMultiLayoutView` has a single CSS node with name `multi-layout-view`.</doc>
22305+ <source-position filename="src/adw-multi-layout-view.h" line="27"/>
879422306 <implements name="Gtk.Accessible"/>
8795- <implements name="Gtk.Actionable"/>
879622307 <implements name="Gtk.Buildable"/>
879722308 <implements name="Gtk.ConstraintTarget"/>
8798- <constructor name="new" c:identifier="adw_expander_row_new">
22309+ <constructor name="new"
22310+ c:identifier="adw_multi_layout_view_new"
22311+ version="1.6">
879922312 <doc xml:space="preserve"
8800- filename="src/adw-expander-row.c"
8801- line="348">Creates a new `AdwExpanderRow`.</doc>
8802- <source-position filename="src/adw-expander-row.h" line="38"/>
22313+ filename="src/adw-multi-layout-view.c"
22314+ line="426">Creates a new `AdwMultiLayoutView`.</doc>
22315+ <source-position filename="src/adw-multi-layout-view.h" line="30"/>
880322316 <return-value transfer-ownership="none">
880422317 <doc xml:space="preserve"
8805- filename="src/adw-expander-row.c"
8806- line="353">the newly created `AdwExpanderRow`</doc>
22318+ filename="src/adw-multi-layout-view.c"
22319+ line="431">the newly created `AdwMultiLayoutView`</doc>
880722320 <type name="Gtk.Widget" c:type="GtkWidget*"/>
880822321 </return-value>
880922322 </constructor>
8810- <method name="add_action" c:identifier="adw_expander_row_add_action">
8811- <doc xml:space="preserve"
8812- filename="src/adw-expander-row.c"
8813- line="361">Adds an action widget to @self.</doc>
8814- <source-position filename="src/adw-expander-row.h" line="41"/>
8815- <return-value transfer-ownership="none">
8816- <type name="none" c:type="void"/>
8817- </return-value>
8818- <parameters>
8819- <instance-parameter name="self" transfer-ownership="none">
8820- <doc xml:space="preserve"
8821- filename="src/adw-expander-row.c"
8822- line="363">an expander row</doc>
8823- <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
8824- </instance-parameter>
8825- <parameter name="widget" transfer-ownership="none">
8826- <doc xml:space="preserve"
8827- filename="src/adw-expander-row.c"
8828- line="364">a widget</doc>
8829- <type name="Gtk.Widget" c:type="GtkWidget*"/>
8830- </parameter>
8831- </parameters>
8832- </method>
8833- <method name="add_prefix" c:identifier="adw_expander_row_add_prefix">
8834- <doc xml:space="preserve"
8835- filename="src/adw-expander-row.c"
8836- line="383">Adds a prefix widget to @self.</doc>
8837- <source-position filename="src/adw-expander-row.h" line="44"/>
8838- <return-value transfer-ownership="none">
8839- <type name="none" c:type="void"/>
8840- </return-value>
8841- <parameters>
8842- <instance-parameter name="self" transfer-ownership="none">
8843- <doc xml:space="preserve"
8844- filename="src/adw-expander-row.c"
8845- line="385">an expander row</doc>
8846- <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
8847- </instance-parameter>
8848- <parameter name="widget" transfer-ownership="none">
8849- <doc xml:space="preserve"
8850- filename="src/adw-expander-row.c"
8851- line="386">a widget</doc>
8852- <type name="Gtk.Widget" c:type="GtkWidget*"/>
8853- </parameter>
8854- </parameters>
8855- </method>
8856- <method name="add_row" c:identifier="adw_expander_row_add_row">
22323+ <method name="add_layout"
22324+ c:identifier="adw_multi_layout_view_add_layout"
22325+ version="1.6">
885722326 <doc xml:space="preserve"
8858- filename="src/adw-expander-row.c"
8859- line="408">Adds a widget to @self.
8860-
8861-The widget will appear in the expanding list below @self.</doc>
8862- <source-position filename="src/adw-expander-row.h" line="48"/>
22327+ filename="src/adw-multi-layout-view.c"
22328+ line="532">Adds @layout to @self.</doc>
22329+ <source-position filename="src/adw-multi-layout-view.h" line="45"/>
886322330 <return-value transfer-ownership="none">
886422331 <type name="none" c:type="void"/>
886522332 </return-value>
886622333 <parameters>
886722334 <instance-parameter name="self" transfer-ownership="none">
886822335 <doc xml:space="preserve"
8869- filename="src/adw-expander-row.c"
8870- line="410">an expander row</doc>
8871- <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
22336+ filename="src/adw-multi-layout-view.c"
22337+ line="534">a multi-layout view</doc>
22338+ <type name="MultiLayoutView" c:type="AdwMultiLayoutView*"/>
887222339 </instance-parameter>
8873- <parameter name="child" transfer-ownership="none">
22340+ <parameter name="layout" transfer-ownership="full">
887422341 <doc xml:space="preserve"
8875- filename="src/adw-expander-row.c"
8876- line="411">a widget</doc>
8877- <type name="Gtk.Widget" c:type="GtkWidget*"/>
22342+ filename="src/adw-multi-layout-view.c"
22343+ line="535">the layout to add</doc>
22344+ <type name="Layout" c:type="AdwLayout*"/>
887822345 </parameter>
887922346 </parameters>
888022347 </method>
8881- <method name="get_enable_expansion"
8882- c:identifier="adw_expander_row_get_enable_expansion"
8883- glib:get-property="enable-expansion">
8884- <attribute name="org.gtk.Method.get_property"
8885- value="enable-expansion"/>
8886- <doc xml:space="preserve"
8887- filename="src/adw-expander-row.c"
8888- line="616">Gets whether the expansion of @self is enabled.</doc>
8889- <source-position filename="src/adw-expander-row.h" line="73"/>
8890- <return-value transfer-ownership="none">
8891- <doc xml:space="preserve"
8892- filename="src/adw-expander-row.c"
8893- line="622">whether the expansion of @self is enabled.</doc>
8894- <type name="gboolean" c:type="gboolean"/>
8895- </return-value>
8896- <parameters>
8897- <instance-parameter name="self" transfer-ownership="none">
8898- <doc xml:space="preserve"
8899- filename="src/adw-expander-row.c"
8900- line="618">an expander row</doc>
8901- <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
8902- </instance-parameter>
8903- </parameters>
8904- </method>
8905- <method name="get_expanded"
8906- c:identifier="adw_expander_row_get_expanded"
8907- glib:get-property="expanded">
8908- <attribute name="org.gtk.Method.get_property" value="expanded"/>
8909- <doc xml:space="preserve"
8910- filename="src/adw-expander-row.c"
8911- line="560">Gets whether @self is expanded.</doc>
8912- <source-position filename="src/adw-expander-row.h" line="67"/>
8913- <return-value transfer-ownership="none">
8914- <doc xml:space="preserve"
8915- filename="src/adw-expander-row.c"
8916- line="566">whether @self is expanded</doc>
8917- <type name="gboolean" c:type="gboolean"/>
8918- </return-value>
8919- <parameters>
8920- <instance-parameter name="self" transfer-ownership="none">
8921- <doc xml:space="preserve"
8922- filename="src/adw-expander-row.c"
8923- line="562">an expander row</doc>
8924- <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
8925- </instance-parameter>
8926- </parameters>
8927- </method>
8928- <method name="get_icon_name"
8929- c:identifier="adw_expander_row_get_icon_name"
8930- glib:get-property="icon-name"
8931- deprecated="1"
8932- deprecated-version="1.3">
8933- <attribute name="org.gtk.Method.get_property" value="icon-name"/>
22348+ <method name="get_child"
22349+ c:identifier="adw_multi_layout_view_get_child"
22350+ version="1.6">
893422351 <doc xml:space="preserve"
8935- filename="src/adw-expander-row.c"
8936- line="516">Gets the icon name for @self.</doc>
8937- <doc-deprecated xml:space="preserve">Use [method@ExpanderRow.add_prefix] to add an icon.</doc-deprecated>
8938- <source-position filename="src/adw-expander-row.h" line="61"/>
22352+ filename="src/adw-multi-layout-view.c"
22353+ line="625">Gets the child for @id to @self.</doc>
22354+ <source-position filename="src/adw-multi-layout-view.h" line="56"/>
893922355 <return-value transfer-ownership="none" nullable="1">
894022356 <doc xml:space="preserve"
8941- filename="src/adw-expander-row.c"
8942- line="522">the icon name for @self</doc>
8943- <type name="utf8" c:type="const char*"/>
8944- </return-value>
8945- <parameters>
8946- <instance-parameter name="self" transfer-ownership="none">
8947- <doc xml:space="preserve"
8948- filename="src/adw-expander-row.c"
8949- line="518">an expander row</doc>
8950- <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
8951- </instance-parameter>
8952- </parameters>
8953- </method>
8954- <method name="get_show_enable_switch"
8955- c:identifier="adw_expander_row_get_show_enable_switch"
8956- glib:get-property="show-enable-switch">
8957- <attribute name="org.gtk.Method.get_property"
8958- value="show-enable-switch"/>
8959- <doc xml:space="preserve"
8960- filename="src/adw-expander-row.c"
8961- line="665">Gets whether the switch enabling the expansion of @self is visible.</doc>
8962- <source-position filename="src/adw-expander-row.h" line="79"/>
8963- <return-value transfer-ownership="none">
8964- <doc xml:space="preserve"
8965- filename="src/adw-expander-row.c"
8966- line="671">whether the switch enabling the expansion is visible</doc>
8967- <type name="gboolean" c:type="gboolean"/>
8968- </return-value>
8969- <parameters>
8970- <instance-parameter name="self" transfer-ownership="none">
8971- <doc xml:space="preserve"
8972- filename="src/adw-expander-row.c"
8973- line="667">an expander row</doc>
8974- <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
8975- </instance-parameter>
8976- </parameters>
8977- </method>
8978- <method name="get_subtitle"
8979- c:identifier="adw_expander_row_get_subtitle"
8980- glib:get-property="subtitle">
8981- <attribute name="org.gtk.Method.get_property" value="subtitle"/>
8982- <doc xml:space="preserve"
8983- filename="src/adw-expander-row.c"
8984- line="473">Gets the subtitle for @self.</doc>
8985- <source-position filename="src/adw-expander-row.h" line="55"/>
8986- <return-value transfer-ownership="none">
8987- <doc xml:space="preserve"
8988- filename="src/adw-expander-row.c"
8989- line="479">the subtitle for @self</doc>
8990- <type name="utf8" c:type="const char*"/>
8991- </return-value>
8992- <parameters>
8993- <instance-parameter name="self" transfer-ownership="none">
8994- <doc xml:space="preserve"
8995- filename="src/adw-expander-row.c"
8996- line="475">an expander row</doc>
8997- <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
8998- </instance-parameter>
8999- </parameters>
9000- </method>
9001- <method name="get_subtitle_lines"
9002- c:identifier="adw_expander_row_get_subtitle_lines"
9003- glib:get-property="subtitle-lines"
9004- version="1.3">
9005- <attribute name="org.gtk.Method.get_property" value="subtitle-lines"/>
9006- <doc xml:space="preserve"
9007- filename="src/adw-expander-row.c"
9008- line="761">Gets the number of lines at the end of which the subtitle label will be
9009-ellipsized.</doc>
9010- <source-position filename="src/adw-expander-row.h" line="91"/>
9011- <return-value transfer-ownership="none">
9012- <doc xml:space="preserve"
9013- filename="src/adw-expander-row.c"
9014- line="768">the number of lines at the end of which the subtitle label will be
9015- ellipsized</doc>
9016- <type name="gboolean" c:type="gboolean"/>
22357+ filename="src/adw-multi-layout-view.c"
22358+ line="632">the child for @id</doc>
22359+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
901722360 </return-value>
901822361 <parameters>
901922362 <instance-parameter name="self" transfer-ownership="none">
902022363 <doc xml:space="preserve"
9021- filename="src/adw-expander-row.c"
9022- line="763">an expander row</doc>
9023- <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
22364+ filename="src/adw-multi-layout-view.c"
22365+ line="627">a multi-layout view</doc>
22366+ <type name="MultiLayoutView" c:type="AdwMultiLayoutView*"/>
902422367 </instance-parameter>
9025- </parameters>
9026- </method>
9027- <method name="get_title_lines"
9028- c:identifier="adw_expander_row_get_title_lines"
9029- glib:get-property="title-lines"
9030- version="1.3">
9031- <attribute name="org.gtk.Method.get_property" value="title-lines"/>
9032- <doc xml:space="preserve"
9033- filename="src/adw-expander-row.c"
9034- line="712">Gets the number of lines at the end of which the title label will be
9035-ellipsized.</doc>
9036- <source-position filename="src/adw-expander-row.h" line="85"/>
9037- <return-value transfer-ownership="none">
9038- <doc xml:space="preserve"
9039- filename="src/adw-expander-row.c"
9040- line="719">the number of lines at the end of which the title label will be
9041- ellipsized</doc>
9042- <type name="gboolean" c:type="gboolean"/>
9043- </return-value>
9044- <parameters>
9045- <instance-parameter name="self" transfer-ownership="none">
22368+ <parameter name="id" transfer-ownership="none">
904622369 <doc xml:space="preserve"
9047- filename="src/adw-expander-row.c"
9048- line="714">an expander row</doc>
9049- <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
9050- </instance-parameter>
9051- </parameters>
9052- </method>
9053- <method name="remove" c:identifier="adw_expander_row_remove">
9054- <source-position filename="src/adw-expander-row.h" line="51"/>
9055- <return-value transfer-ownership="none">
9056- <type name="none" c:type="void"/>
9057- </return-value>
9058- <parameters>
9059- <instance-parameter name="self" transfer-ownership="none">
9060- <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
9061- </instance-parameter>
9062- <parameter name="child" transfer-ownership="none">
9063- <type name="Gtk.Widget" c:type="GtkWidget*"/>
22370+ filename="src/adw-multi-layout-view.c"
22371+ line="628">the id of the child</doc>
22372+ <type name="utf8" c:type="const char*"/>
906422373 </parameter>
906522374 </parameters>
9066- </method>
9067- <method name="set_enable_expansion"
9068- c:identifier="adw_expander_row_set_enable_expansion"
9069- glib:set-property="enable-expansion">
9070- <attribute name="org.gtk.Method.set_property"
9071- value="enable-expansion"/>
9072- <doc xml:space="preserve"
9073- filename="src/adw-expander-row.c"
9074- line="636">Sets whether the expansion of @self is enabled.</doc>
9075- <source-position filename="src/adw-expander-row.h" line="75"/>
9076- <return-value transfer-ownership="none">
9077- <type name="none" c:type="void"/>
22375+ </method>
22376+ <method name="get_layout"
22377+ c:identifier="adw_multi_layout_view_get_layout"
22378+ glib:get-property="layout"
22379+ version="1.6">
22380+ <doc xml:space="preserve"
22381+ filename="src/adw-multi-layout-view.c"
22382+ line="441">Gets the currently used layout of @self.</doc>
22383+ <source-position filename="src/adw-multi-layout-view.h" line="33"/>
22384+ <return-value transfer-ownership="none" nullable="1">
22385+ <doc xml:space="preserve"
22386+ filename="src/adw-multi-layout-view.c"
22387+ line="447">the current layout</doc>
22388+ <type name="Layout" c:type="AdwLayout*"/>
907822389 </return-value>
907922390 <parameters>
908022391 <instance-parameter name="self" transfer-ownership="none">
908122392 <doc xml:space="preserve"
9082- filename="src/adw-expander-row.c"
9083- line="638">an expander row</doc>
9084- <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
22393+ filename="src/adw-multi-layout-view.c"
22394+ line="443">a multi-layout view</doc>
22395+ <type name="MultiLayoutView" c:type="AdwMultiLayoutView*"/>
908522396 </instance-parameter>
9086- <parameter name="enable_expansion" transfer-ownership="none">
9087- <doc xml:space="preserve"
9088- filename="src/adw-expander-row.c"
9089- line="639">whether to enable the expansion</doc>
9090- <type name="gboolean" c:type="gboolean"/>
9091- </parameter>
909222397 </parameters>
909322398 </method>
9094- <method name="set_expanded"
9095- c:identifier="adw_expander_row_set_expanded"
9096- glib:set-property="expanded">
9097- <attribute name="org.gtk.Method.set_property" value="expanded"/>
22399+ <method name="get_layout_by_name"
22400+ c:identifier="adw_multi_layout_view_get_layout_by_name"
22401+ version="1.6">
909822402 <doc xml:space="preserve"
9099- filename="src/adw-expander-row.c"
9100- line="580">Sets whether @self is expanded.</doc>
9101- <source-position filename="src/adw-expander-row.h" line="69"/>
9102- <return-value transfer-ownership="none">
9103- <type name="none" c:type="void"/>
22403+ filename="src/adw-multi-layout-view.c"
22404+ line="593">Gets layout with the name @name from @self, or `NULL` if it doesn't exist.
22405+
22406+See [property@Layout:name].</doc>
22407+ <source-position filename="src/adw-multi-layout-view.h" line="52"/>
22408+ <return-value transfer-ownership="none" nullable="1">
22409+ <doc xml:space="preserve"
22410+ filename="src/adw-multi-layout-view.c"
22411+ line="602">the layout with @name</doc>
22412+ <type name="Layout" c:type="AdwLayout*"/>
910422413 </return-value>
910522414 <parameters>
910622415 <instance-parameter name="self" transfer-ownership="none">
910722416 <doc xml:space="preserve"
9108- filename="src/adw-expander-row.c"
9109- line="582">an expander row</doc>
9110- <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
22417+ filename="src/adw-multi-layout-view.c"
22418+ line="595">a multi-layout view</doc>
22419+ <type name="MultiLayoutView" c:type="AdwMultiLayoutView*"/>
911122420 </instance-parameter>
9112- <parameter name="expanded" transfer-ownership="none">
22421+ <parameter name="name" transfer-ownership="none">
911322422 <doc xml:space="preserve"
9114- filename="src/adw-expander-row.c"
9115- line="583">whether to expand the row</doc>
9116- <type name="gboolean" c:type="gboolean"/>
22423+ filename="src/adw-multi-layout-view.c"
22424+ line="596">the name of the layout</doc>
22425+ <type name="utf8" c:type="const char*"/>
911722426 </parameter>
911822427 </parameters>
911922428 </method>
9120- <method name="set_icon_name"
9121- c:identifier="adw_expander_row_set_icon_name"
9122- glib:set-property="icon-name"
9123- deprecated="1"
9124- deprecated-version="1.3">
9125- <attribute name="org.gtk.Method.set_property" value="icon-name"/>
22429+ <method name="get_layout_name"
22430+ c:identifier="adw_multi_layout_view_get_layout_name"
22431+ glib:get-property="layout-name"
22432+ version="1.6">
912622433 <doc xml:space="preserve"
9127- filename="src/adw-expander-row.c"
9128- line="538">Sets the icon name for @self.</doc>
9129- <doc-deprecated xml:space="preserve">Use [method@ExpanderRow.add_prefix] to add an icon.</doc-deprecated>
9130- <source-position filename="src/adw-expander-row.h" line="63"/>
9131- <return-value transfer-ownership="none">
9132- <type name="none" c:type="void"/>
22434+ filename="src/adw-multi-layout-view.c"
22435+ line="478">Returns the name of the currently used layout of @self.</doc>
22436+ <source-position filename="src/adw-multi-layout-view.h" line="39"/>
22437+ <return-value transfer-ownership="none" nullable="1">
22438+ <doc xml:space="preserve"
22439+ filename="src/adw-multi-layout-view.c"
22440+ line="484">the name of the current layout</doc>
22441+ <type name="utf8" c:type="const char*"/>
913322442 </return-value>
913422443 <parameters>
913522444 <instance-parameter name="self" transfer-ownership="none">
913622445 <doc xml:space="preserve"
9137- filename="src/adw-expander-row.c"
9138- line="540">an expander row</doc>
9139- <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
22446+ filename="src/adw-multi-layout-view.c"
22447+ line="480">a multi-layout view</doc>
22448+ <type name="MultiLayoutView" c:type="AdwMultiLayoutView*"/>
914022449 </instance-parameter>
9141- <parameter name="icon_name"
9142- transfer-ownership="none"
9143- nullable="1"
9144- allow-none="1">
9145- <doc xml:space="preserve"
9146- filename="src/adw-expander-row.c"
9147- line="541">the icon name</doc>
9148- <type name="utf8" c:type="const char*"/>
9149- </parameter>
915022450 </parameters>
915122451 </method>
9152- <method name="set_show_enable_switch"
9153- c:identifier="adw_expander_row_set_show_enable_switch"
9154- glib:set-property="show-enable-switch">
9155- <attribute name="org.gtk.Method.set_property"
9156- value="show-enable-switch"/>
22452+ <method name="remove_layout"
22453+ c:identifier="adw_multi_layout_view_remove_layout"
22454+ version="1.6">
915722455 <doc xml:space="preserve"
9158- filename="src/adw-expander-row.c"
9159- line="685">Sets whether the switch enabling the expansion of @self is visible.</doc>
9160- <source-position filename="src/adw-expander-row.h" line="81"/>
22456+ filename="src/adw-multi-layout-view.c"
22457+ line="565">Removes @layout from @self.</doc>
22458+ <source-position filename="src/adw-multi-layout-view.h" line="49"/>
916122459 <return-value transfer-ownership="none">
916222460 <type name="none" c:type="void"/>
916322461 </return-value>
916422462 <parameters>
916522463 <instance-parameter name="self" transfer-ownership="none">
916622464 <doc xml:space="preserve"
9167- filename="src/adw-expander-row.c"
9168- line="687">an expander row</doc>
9169- <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
22465+ filename="src/adw-multi-layout-view.c"
22466+ line="567">a multi-layout view</doc>
22467+ <type name="MultiLayoutView" c:type="AdwMultiLayoutView*"/>
917022468 </instance-parameter>
9171- <parameter name="show_enable_switch" transfer-ownership="none">
22469+ <parameter name="layout" transfer-ownership="none">
917222470 <doc xml:space="preserve"
9173- filename="src/adw-expander-row.c"
9174- line="688">whether to show the switch enabling the expansion</doc>
9175- <type name="gboolean" c:type="gboolean"/>
22471+ filename="src/adw-multi-layout-view.c"
22472+ line="568">the layout to add</doc>
22473+ <type name="Layout" c:type="AdwLayout*"/>
917622474 </parameter>
917722475 </parameters>
917822476 </method>
9179- <method name="set_subtitle"
9180- c:identifier="adw_expander_row_set_subtitle"
9181- glib:set-property="subtitle">
9182- <attribute name="org.gtk.Method.set_property" value="subtitle"/>
22477+ <method name="set_child"
22478+ c:identifier="adw_multi_layout_view_set_child"
22479+ version="1.6">
918322480 <doc xml:space="preserve"
9184- filename="src/adw-expander-row.c"
9185- line="493">Sets the subtitle for @self.
22481+ filename="src/adw-multi-layout-view.c"
22482+ line="646">Sets @child as the child for @id in @self.
918622483
9187-The subtitle is interpreted as Pango markup unless
9188-[property@PreferencesRow:use-markup] is set to `FALSE`.</doc>
9189- <source-position filename="src/adw-expander-row.h" line="57"/>
22484+When changing layouts, it will be inserted into the slot with @id.</doc>
22485+ <source-position filename="src/adw-multi-layout-view.h" line="59"/>
919022486 <return-value transfer-ownership="none">
919122487 <type name="none" c:type="void"/>
919222488 </return-value>
919322489 <parameters>
919422490 <instance-parameter name="self" transfer-ownership="none">
919522491 <doc xml:space="preserve"
9196- filename="src/adw-expander-row.c"
9197- line="495">an expander row</doc>
9198- <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
22492+ filename="src/adw-multi-layout-view.c"
22493+ line="648">a multi-layout view</doc>
22494+ <type name="MultiLayoutView" c:type="AdwMultiLayoutView*"/>
919922495 </instance-parameter>
9200- <parameter name="subtitle" transfer-ownership="none">
22496+ <parameter name="id" transfer-ownership="none">
920122497 <doc xml:space="preserve"
9202- filename="src/adw-expander-row.c"
9203- line="496">the subtitle</doc>
22498+ filename="src/adw-multi-layout-view.c"
22499+ line="649">the id of the child</doc>
920422500 <type name="utf8" c:type="const char*"/>
920522501 </parameter>
22502+ <parameter name="child" transfer-ownership="none">
22503+ <doc xml:space="preserve"
22504+ filename="src/adw-multi-layout-view.c"
22505+ line="650">the child to set</doc>
22506+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
22507+ </parameter>
920622508 </parameters>
920722509 </method>
9208- <method name="set_subtitle_lines"
9209- c:identifier="adw_expander_row_set_subtitle_lines"
9210- glib:set-property="subtitle-lines"
9211- version="1.3">
9212- <attribute name="org.gtk.Method.set_property" value="subtitle-lines"/>
22510+ <method name="set_layout"
22511+ c:identifier="adw_multi_layout_view_set_layout"
22512+ glib:set-property="layout"
22513+ version="1.6">
921322514 <doc xml:space="preserve"
9214- filename="src/adw-expander-row.c"
9215- line="785">Sets the number of lines at the end of which the subtitle label will be
9216-ellipsized.
9217-
9218-If the value is 0, the number of lines won't be limited.</doc>
9219- <source-position filename="src/adw-expander-row.h" line="93"/>
22515+ filename="src/adw-multi-layout-view.c"
22516+ line="459">Makes @layout the current layout of @self.</doc>
22517+ <source-position filename="src/adw-multi-layout-view.h" line="35"/>
922022518 <return-value transfer-ownership="none">
922122519 <type name="none" c:type="void"/>
922222520 </return-value>
922322521 <parameters>
922422522 <instance-parameter name="self" transfer-ownership="none">
922522523 <doc xml:space="preserve"
9226- filename="src/adw-expander-row.c"
9227- line="787">an expander row</doc>
9228- <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
22524+ filename="src/adw-multi-layout-view.c"
22525+ line="461">a multi-layout view</doc>
22526+ <type name="MultiLayoutView" c:type="AdwMultiLayoutView*"/>
922922527 </instance-parameter>
9230- <parameter name="subtitle_lines" transfer-ownership="none">
22528+ <parameter name="layout" transfer-ownership="none">
923122529 <doc xml:space="preserve"
9232- filename="src/adw-expander-row.c"
9233- line="788">the number of lines at the end of which the subtitle label will be ellipsized</doc>
9234- <type name="gint" c:type="int"/>
22530+ filename="src/adw-multi-layout-view.c"
22531+ line="462">a layout in @self</doc>
22532+ <type name="Layout" c:type="AdwLayout*"/>
923522533 </parameter>
923622534 </parameters>
923722535 </method>
9238- <method name="set_title_lines"
9239- c:identifier="adw_expander_row_set_title_lines"
9240- glib:set-property="title-lines"
9241- version="1.3">
9242- <attribute name="org.gtk.Method.set_property" value="title-lines"/>
22536+ <method name="set_layout_name"
22537+ c:identifier="adw_multi_layout_view_set_layout_name"
22538+ glib:set-property="layout-name"
22539+ version="1.6">
924322540 <doc xml:space="preserve"
9244- filename="src/adw-expander-row.c"
9245- line="736">Sets the number of lines at the end of which the title label will be
9246-ellipsized.
22541+ filename="src/adw-multi-layout-view.c"
22542+ line="499">Makes the layout with @name the current layout of @self.
924722543
9248-If the value is 0, the number of lines won't be limited.</doc>
9249- <source-position filename="src/adw-expander-row.h" line="87"/>
22544+See [property@Layout:name].</doc>
22545+ <source-position filename="src/adw-multi-layout-view.h" line="41"/>
925022546 <return-value transfer-ownership="none">
925122547 <type name="none" c:type="void"/>
925222548 </return-value>
925322549 <parameters>
925422550 <instance-parameter name="self" transfer-ownership="none">
925522551 <doc xml:space="preserve"
9256- filename="src/adw-expander-row.c"
9257- line="738">an expander row</doc>
9258- <type name="ExpanderRow" c:type="AdwExpanderRow*"/>
22552+ filename="src/adw-multi-layout-view.c"
22553+ line="501">a multi-layout view</doc>
22554+ <type name="MultiLayoutView" c:type="AdwMultiLayoutView*"/>
925922555 </instance-parameter>
9260- <parameter name="title_lines" transfer-ownership="none">
22556+ <parameter name="name" transfer-ownership="none">
926122557 <doc xml:space="preserve"
9262- filename="src/adw-expander-row.c"
9263- line="739">the number of lines at the end of which the title label will be ellipsized</doc>
9264- <type name="gint" c:type="int"/>
22558+ filename="src/adw-multi-layout-view.c"
22559+ line="502">the name of the layout</doc>
22560+ <type name="utf8" c:type="const char*"/>
926522561 </parameter>
926622562 </parameters>
926722563 </method>
9268- <property name="enable-expansion"
9269- writable="1"
9270- transfer-ownership="none"
9271- setter="set_enable_expansion"
9272- getter="get_enable_expansion"
9273- default-value="TRUE">
9274- <attribute name="org.gtk.Property.get"
9275- value="adw_expander_row_get_enable_expansion"/>
9276- <attribute name="org.gtk.Property.set"
9277- value="adw_expander_row_set_enable_expansion"/>
9278- <doc xml:space="preserve"
9279- filename="src/adw-expander-row.c"
9280- line="225">Whether expansion is enabled.</doc>
9281- <type name="gboolean" c:type="gboolean"/>
9282- </property>
9283- <property name="expanded"
9284- writable="1"
9285- transfer-ownership="none"
9286- setter="set_expanded"
9287- getter="get_expanded"
9288- default-value="FALSE">
9289- <attribute name="org.gtk.Property.get"
9290- value="adw_expander_row_get_expanded"/>
9291- <attribute name="org.gtk.Property.set"
9292- value="adw_expander_row_set_expanded"/>
9293- <doc xml:space="preserve"
9294- filename="src/adw-expander-row.c"
9295- line="215">Whether the row is expanded.</doc>
9296- <type name="gboolean" c:type="gboolean"/>
9297- </property>
9298- <property name="icon-name"
9299- deprecated="1"
9300- deprecated-version="1.3"
9301- writable="1"
9302- transfer-ownership="none"
9303- setter="set_icon_name"
9304- getter="get_icon_name">
9305- <attribute name="org.gtk.Property.get"
9306- value="adw_expander_row_get_icon_name"/>
9307- <attribute name="org.gtk.Property.set"
9308- value="adw_expander_row_set_icon_name"/>
9309- <doc xml:space="preserve"
9310- filename="src/adw-expander-row.c"
9311- line="203">The icon name for this row.</doc>
9312- <doc-deprecated xml:space="preserve">Use [method@ExpanderRow.add_prefix] to add an icon.</doc-deprecated>
9313- <type name="utf8" c:type="gchar*"/>
9314- </property>
9315- <property name="show-enable-switch"
22564+ <property name="layout"
22565+ version="1.6"
931622566 writable="1"
931722567 transfer-ownership="none"
9318- setter="set_show_enable_switch"
9319- getter="get_show_enable_switch"
9320- default-value="FALSE">
9321- <attribute name="org.gtk.Property.get"
9322- value="adw_expander_row_get_show_enable_switch"/>
9323- <attribute name="org.gtk.Property.set"
9324- value="adw_expander_row_set_show_enable_switch"/>
22568+ setter="set_layout"
22569+ getter="get_layout">
932522570 <doc xml:space="preserve"
9326- filename="src/adw-expander-row.c"
9327- line="235">Whether the switch enabling the expansion is visible.</doc>
9328- <type name="gboolean" c:type="gboolean"/>
22571+ filename="src/adw-multi-layout-view.c"
22572+ line="361">The currently used layout.</doc>
22573+ <type name="Layout"/>
932922574 </property>
9330- <property name="subtitle"
22575+ <property name="layout-name"
22576+ version="1.6"
933122577 writable="1"
933222578 transfer-ownership="none"
9333- setter="set_subtitle"
9334- getter="get_subtitle">
9335- <attribute name="org.gtk.Property.get"
9336- value="adw_expander_row_get_subtitle"/>
9337- <attribute name="org.gtk.Property.set"
9338- value="adw_expander_row_set_subtitle"/>
22579+ setter="set_layout_name"
22580+ getter="get_layout_name"
22581+ default-value="NULL">
933922582 <doc xml:space="preserve"
9340- filename="src/adw-expander-row.c"
9341- line="190">The subtitle for this row.
22583+ filename="src/adw-multi-layout-view.c"
22584+ line="373">The name of the currently used layout.
934222585
9343-The subtitle is interpreted as Pango markup unless
9344-[property@PreferencesRow:use-markup] is set to `FALSE`.</doc>
22586+See [property@Layout:name].</doc>
934522587 <type name="utf8" c:type="gchar*"/>
934622588 </property>
9347- <property name="subtitle-lines"
9348- version="1.3"
9349- writable="1"
9350- transfer-ownership="none"
9351- setter="set_subtitle_lines"
9352- getter="get_subtitle_lines"
9353- default-value="0">
9354- <attribute name="org.gtk.Property.get"
9355- value="adw_expander_row_get_subtitle_lines"/>
9356- <attribute name="org.gtk.Property.set"
9357- value="adw_expander_row_set_subtitle_lines"/>
9358- <doc xml:space="preserve"
9359- filename="src/adw-expander-row.c"
9360- line="260">The number of lines at the end of which the subtitle label will be
9361-ellipsized.
9362-
9363-If the value is 0, the number of lines won't be limited.</doc>
9364- <type name="gint" c:type="gint"/>
9365- </property>
9366- <property name="title-lines"
9367- version="1.3"
9368- writable="1"
9369- transfer-ownership="none"
9370- setter="set_title_lines"
9371- getter="get_title_lines"
9372- default-value="0">
9373- <attribute name="org.gtk.Property.get"
9374- value="adw_expander_row_get_title_lines"/>
9375- <attribute name="org.gtk.Property.set"
9376- value="adw_expander_row_set_title_lines"/>
9377- <doc xml:space="preserve"
9378- filename="src/adw-expander-row.c"
9379- line="245">The number of lines at the end of which the title label will be ellipsized.
9380-
9381-If the value is 0, the number of lines won't be limited.</doc>
9382- <type name="gint" c:type="gint"/>
9383- </property>
9384- <field name="parent_instance">
9385- <type name="PreferencesRow" c:type="AdwPreferencesRow"/>
9386- </field>
938722589 </class>
9388- <record name="ExpanderRowClass"
9389- c:type="AdwExpanderRowClass"
9390- glib:is-gtype-struct-for="ExpanderRow">
9391- <source-position filename="src/adw-expander-row.h" line="35"/>
22590+ <record name="MultiLayoutViewClass"
22591+ c:type="AdwMultiLayoutViewClass"
22592+ glib:is-gtype-struct-for="MultiLayoutView">
22593+ <source-position filename="src/adw-multi-layout-view.h" line="27"/>
939222594 <field name="parent_class">
9393- <doc xml:space="preserve"
9394- filename="src/adw-expander-row.h"
9395- line="27">The parent class</doc>
9396- <type name="PreferencesRowClass" c:type="AdwPreferencesRowClass"/>
9397- </field>
9398- <field name="padding" readable="0" private="1">
9399- <array zero-terminated="0" fixed-size="4">
9400- <type name="gpointer" c:type="gpointer"/>
9401- </array>
22595+ <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
940222596 </field>
940322597 </record>
9404- <class name="Flap"
9405- c:symbol-prefix="flap"
9406- c:type="AdwFlap"
22598+ <enumeration name="NavigationDirection"
22599+ glib:type-name="AdwNavigationDirection"
22600+ glib:get-type="adw_navigation_direction_get_type"
22601+ c:type="AdwNavigationDirection">
22602+ <doc xml:space="preserve"
22603+ filename="src/adw-navigation-direction.c"
22604+ line="10">Describes the direction of a swipe navigation gesture.</doc>
22605+ <member name="back"
22606+ value="0"
22607+ c:identifier="ADW_NAVIGATION_DIRECTION_BACK"
22608+ glib:nick="back"
22609+ glib:name="ADW_NAVIGATION_DIRECTION_BACK">
22610+ <doc xml:space="preserve"
22611+ filename="src/adw-navigation-direction.c"
22612+ line="12">Corresponds to start or top, depending on orientation and text direction</doc>
22613+ </member>
22614+ <member name="forward"
22615+ value="1"
22616+ c:identifier="ADW_NAVIGATION_DIRECTION_FORWARD"
22617+ glib:nick="forward"
22618+ glib:name="ADW_NAVIGATION_DIRECTION_FORWARD">
22619+ <doc xml:space="preserve"
22620+ filename="src/adw-navigation-direction.c"
22621+ line="13">Corresponds to end or bottom, depending on orientation and text direction</doc>
22622+ </member>
22623+ </enumeration>
22624+ <class name="NavigationPage"
22625+ c:symbol-prefix="navigation_page"
22626+ c:type="AdwNavigationPage"
22627+ version="1.4"
940722628 parent="Gtk.Widget"
9408- final="1"
9409- glib:type-name="AdwFlap"
9410- glib:get-type="adw_flap_get_type"
9411- glib:type-struct="FlapClass">
22629+ glib:type-name="AdwNavigationPage"
22630+ glib:get-type="adw_navigation_page_get_type"
22631+ glib:type-struct="NavigationPageClass">
941222632 <doc xml:space="preserve"
9413- filename="src/adw-flap.c"
9414- line="22">An adaptive container acting like a box or an overlay.
9415-
9416-&lt;picture&gt;
9417- &lt;source srcset="flap-wide-dark.png" media="(prefers-color-scheme: dark)"&gt;
9418- &lt;img src="flap-wide.png" alt="flap-wide"&gt;
9419-&lt;/picture&gt;
9420-&lt;picture&gt;
9421- &lt;source srcset="flap-narrow-dark.png" media="(prefers-color-scheme: dark)"&gt;
9422- &lt;img src="flap-narrow.png" alt="flap-narrow"&gt;
9423-&lt;/picture&gt;
9424-
9425-The `AdwFlap` widget can display its children like a [class@Gtk.Box] does or
9426-like a [class@Gtk.Overlay] does, according to the
9427-[property@Flap:fold-policy] value.
9428-
9429-`AdwFlap` has at most three children: [property@Flap:content],
9430-[property@Flap:flap] and [property@Flap:separator]. Content is the primary
9431-child, flap is displayed next to it when unfolded, or overlays it when
9432-folded. Flap can be shown or hidden by changing the
9433-[property@Flap:reveal-flap] value, as well as via swipe gestures if
9434-[property@Flap:swipe-to-open] and/or [property@Flap:swipe-to-close] are set
9435-to `TRUE`.
9436-
9437-Optionally, a separator can be provided, which would be displayed between
9438-the content and the flap when there's no shadow to separate them, depending
9439-on the transition type.
9440-
9441-[property@Flap:flap] is transparent by default; add the
9442-[`.background`](style-classes.html#background) style class to it if this is
9443-unwanted.
22633+ filename="src/adw-navigation-view.c"
22634+ line="184">A page within [class@NavigationView] or [class@NavigationSplitView].
944422635
9445-If [property@Flap:modal] is set to `TRUE`, content becomes completely
9446-inaccessible when the flap is revealed while folded.
22636+Each page has a child widget, a title and optionally a tag.
944722637
9448-The position of the flap and separator children relative to the content is
9449-determined by orientation, as well as the [property@Flap:flap-position]
9450-value.
22638+The [signal@NavigationPage::showing], [signal@NavigationPage::shown],
22639+[signal@NavigationPage::hiding] and [signal@NavigationPage::hidden] signals
22640+can be used to track the page's visibility within its `AdwNavigationView`.
945122641
9452-Folding the flap will automatically hide the flap widget, and unfolding it
9453-will automatically reveal it. If this behavior is not desired, the
9454-[property@Flap:locked] property can be used to override it.
22642+## Header Bar Integration
945522643
9456-Common use cases include sidebars, header bars that need to be able to
9457-overlap the window content (for example, in fullscreen mode) and bottom
9458-sheets.
22644+When placed inside `AdwNavigationPage`, [class@HeaderBar] will display the
22645+page title instead of window title.
945922646
9460-## AdwFlap as GtkBuildable
22647+When used together with [class@NavigationView], it will also display a back
22648+button that can be used to go back to the previous page. Set
22649+[property@HeaderBar:show-back-button] to `FALSE` to disable that behavior if
22650+it's unwanted.
946122651
9462-The `AdwFlap` implementation of the [iface@Gtk.Buildable] interface supports
9463-setting the flap child by specifying “flap” as the “type” attribute of a
9464-`&lt;child&gt;` element, and separator by specifying “separator”. Specifying
9465-“content” child type or omitting it results in setting the content child.
22652+## CSS Nodes
946622653
9467-## CSS nodes
22654+`AdwNavigationPage` has a single CSS node with name
22655+`navigation-view-page`.
946822656
9469-`AdwFlap` has a single CSS node with name `flap`. The node will get the style
9470-classes `.folded` when it is folded, and `.unfolded` when it's not.</doc>
9471- <source-position filename="src/adw-flap.h" line="25"/>
9472- <implements name="Swipeable"/>
22657+## Accessibility
22658+
22659+`AdwNavigationPage` uses the `GTK_ACCESSIBLE_ROLE_GROUP` role.</doc>
22660+ <source-position filename="src/adw-navigation-view.h" line="76"/>
947322661 <implements name="Gtk.Accessible"/>
947422662 <implements name="Gtk.Buildable"/>
947522663 <implements name="Gtk.ConstraintTarget"/>
9476- <implements name="Gtk.Orientable"/>
9477- <constructor name="new" c:identifier="adw_flap_new">
22664+ <constructor name="new"
22665+ c:identifier="adw_navigation_page_new"
22666+ version="1.4">
947822667 <doc xml:space="preserve"
9479- filename="src/adw-flap.c"
9480- line="1755">Creates a new `AdwFlap`.</doc>
9481- <source-position filename="src/adw-flap.h" line="40"/>
22668+ filename="src/adw-navigation-view.c"
22669+ line="2018">Creates a new `AdwNavigationPage`.</doc>
22670+ <source-position filename="src/adw-navigation-view.h" line="79"/>
948222671 <return-value transfer-ownership="none">
948322672 <doc xml:space="preserve"
9484- filename="src/adw-flap.c"
9485- line="1760">the newly created `AdwFlap`</doc>
9486- <type name="Gtk.Widget" c:type="GtkWidget*"/>
22673+ filename="src/adw-navigation-view.c"
22674+ line="2025">the new created `AdwNavigationPage`</doc>
22675+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
948722676 </return-value>
22677+ <parameters>
22678+ <parameter name="child" transfer-ownership="none">
22679+ <doc xml:space="preserve"
22680+ filename="src/adw-navigation-view.c"
22681+ line="2020">the child widget</doc>
22682+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
22683+ </parameter>
22684+ <parameter name="title" transfer-ownership="none">
22685+ <doc xml:space="preserve"
22686+ filename="src/adw-navigation-view.c"
22687+ line="2021">the page title</doc>
22688+ <type name="utf8" c:type="const char*"/>
22689+ </parameter>
22690+ </parameters>
948822691 </constructor>
9489- <method name="get_content"
9490- c:identifier="adw_flap_get_content"
9491- glib:get-property="content">
9492- <attribute name="org.gtk.Method.get_property" value="content"/>
22692+ <constructor name="new_with_tag"
22693+ c:identifier="adw_navigation_page_new_with_tag"
22694+ version="1.4">
949322695 <doc xml:space="preserve"
9494- filename="src/adw-flap.c"
9495- line="1768">Gets the content widget for @self.</doc>
9496- <source-position filename="src/adw-flap.h" line="43"/>
9497- <return-value transfer-ownership="none" nullable="1">
22696+ filename="src/adw-navigation-view.c"
22697+ line="2042">Creates a new `AdwNavigationPage` with provided tag.</doc>
22698+ <source-position filename="src/adw-navigation-view.h" line="83"/>
22699+ <return-value transfer-ownership="none">
949822700 <doc xml:space="preserve"
9499- filename="src/adw-flap.c"
9500- line="1774">the content widget for @self</doc>
9501- <type name="Gtk.Widget" c:type="GtkWidget*"/>
22701+ filename="src/adw-navigation-view.c"
22702+ line="2050">the new created `AdwNavigationPage`</doc>
22703+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
22704+ </return-value>
22705+ <parameters>
22706+ <parameter name="child" transfer-ownership="none">
22707+ <doc xml:space="preserve"
22708+ filename="src/adw-navigation-view.c"
22709+ line="2044">the child widget</doc>
22710+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
22711+ </parameter>
22712+ <parameter name="title" transfer-ownership="none">
22713+ <doc xml:space="preserve"
22714+ filename="src/adw-navigation-view.c"
22715+ line="2045">the page title</doc>
22716+ <type name="utf8" c:type="const char*"/>
22717+ </parameter>
22718+ <parameter name="tag" transfer-ownership="none">
22719+ <doc xml:space="preserve"
22720+ filename="src/adw-navigation-view.c"
22721+ line="2046">the page tag</doc>
22722+ <type name="utf8" c:type="const char*"/>
22723+ </parameter>
22724+ </parameters>
22725+ </constructor>
22726+ <virtual-method name="hidden" version="1.4">
22727+ <doc xml:space="preserve"
22728+ filename="src/adw-navigation-view.h"
22729+ line="63">Called when the navigation view transition has been completed and the page
22730+is fully hidden.</doc>
22731+ <source-position filename="src/adw-navigation-view.h" line="72"/>
22732+ <return-value transfer-ownership="none">
22733+ <type name="none" c:type="void"/>
950222734 </return-value>
950322735 <parameters>
950422736 <instance-parameter name="self" transfer-ownership="none">
950522737 <doc xml:space="preserve"
9506- filename="src/adw-flap.c"
9507- line="1770">a flap</doc>
9508- <type name="Flap" c:type="AdwFlap*"/>
22738+ filename="src/adw-navigation-view.h"
22739+ line="65">a navigation page</doc>
22740+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
950922741 </instance-parameter>
951022742 </parameters>
9511- </method>
9512- <method name="get_flap"
9513- c:identifier="adw_flap_get_flap"
9514- glib:get-property="flap">
9515- <attribute name="org.gtk.Method.get_property" value="flap"/>
22743+ </virtual-method>
22744+ <virtual-method name="hiding" version="1.4">
951622745 <doc xml:space="preserve"
9517- filename="src/adw-flap.c"
9518- line="1816">Gets the flap widget for @self.</doc>
9519- <source-position filename="src/adw-flap.h" line="49"/>
9520- <return-value transfer-ownership="none" nullable="1">
9521- <doc xml:space="preserve"
9522- filename="src/adw-flap.c"
9523- line="1822">the flap widget for @self</doc>
9524- <type name="Gtk.Widget" c:type="GtkWidget*"/>
22746+ filename="src/adw-navigation-view.h"
22747+ line="52">Called when the page starts hiding at the beginning of the navigation view
22748+transition.</doc>
22749+ <source-position filename="src/adw-navigation-view.h" line="61"/>
22750+ <return-value transfer-ownership="none">
22751+ <type name="none" c:type="void"/>
952522752 </return-value>
952622753 <parameters>
952722754 <instance-parameter name="self" transfer-ownership="none">
952822755 <doc xml:space="preserve"
9529- filename="src/adw-flap.c"
9530- line="1818">a flap</doc>
9531- <type name="Flap" c:type="AdwFlap*"/>
22756+ filename="src/adw-navigation-view.h"
22757+ line="54">a navigation page</doc>
22758+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
953222759 </instance-parameter>
953322760 </parameters>
9534- </method>
9535- <method name="get_flap_position"
9536- c:identifier="adw_flap_get_flap_position"
9537- glib:get-property="flap-position">
9538- <attribute name="org.gtk.Method.get_property" value="flap-position"/>
22761+ </virtual-method>
22762+ <virtual-method name="showing" version="1.4">
953922763 <doc xml:space="preserve"
9540- filename="src/adw-flap.c"
9541- line="1915">Gets the flap position for @self.</doc>
9542- <source-position filename="src/adw-flap.h" line="61"/>
22764+ filename="src/adw-navigation-view.h"
22765+ line="30">Called when the page shows at the beginning of the navigation view
22766+transition.</doc>
22767+ <source-position filename="src/adw-navigation-view.h" line="39"/>
22768+ <return-value transfer-ownership="none">
22769+ <type name="none" c:type="void"/>
22770+ </return-value>
22771+ <parameters>
22772+ <instance-parameter name="self" transfer-ownership="none">
22773+ <doc xml:space="preserve"
22774+ filename="src/adw-navigation-view.h"
22775+ line="32">a navigation page</doc>
22776+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
22777+ </instance-parameter>
22778+ </parameters>
22779+ </virtual-method>
22780+ <virtual-method name="shown" version="1.4">
22781+ <doc xml:space="preserve"
22782+ filename="src/adw-navigation-view.h"
22783+ line="41">Called when the navigation view transition has been completed and the page
22784+is fully shown.</doc>
22785+ <source-position filename="src/adw-navigation-view.h" line="50"/>
22786+ <return-value transfer-ownership="none">
22787+ <type name="none" c:type="void"/>
22788+ </return-value>
22789+ <parameters>
22790+ <instance-parameter name="self" transfer-ownership="none">
22791+ <doc xml:space="preserve"
22792+ filename="src/adw-navigation-view.h"
22793+ line="43">a navigation page</doc>
22794+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
22795+ </instance-parameter>
22796+ </parameters>
22797+ </virtual-method>
22798+ <method name="get_can_pop"
22799+ c:identifier="adw_navigation_page_get_can_pop"
22800+ glib:get-property="can-pop"
22801+ version="1.4">
22802+ <doc xml:space="preserve"
22803+ filename="src/adw-navigation-view.c"
22804+ line="2266">Gets whether @self can be popped from navigation stack.</doc>
22805+ <source-position filename="src/adw-navigation-view.h" line="106"/>
954322806 <return-value transfer-ownership="none">
954422807 <doc xml:space="preserve"
9545- filename="src/adw-flap.c"
9546- line="1921">the flap position for @self</doc>
9547- <type name="Gtk.PackType" c:type="GtkPackType"/>
22808+ filename="src/adw-navigation-view.c"
22809+ line="2272">whether the page can be popped from navigation stack</doc>
22810+ <type name="gboolean" c:type="gboolean"/>
954822811 </return-value>
954922812 <parameters>
955022813 <instance-parameter name="self" transfer-ownership="none">
955122814 <doc xml:space="preserve"
9552- filename="src/adw-flap.c"
9553- line="1917">a flap</doc>
9554- <type name="Flap" c:type="AdwFlap*"/>
22815+ filename="src/adw-navigation-view.c"
22816+ line="2268">a navigation page</doc>
22817+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
955522818 </instance-parameter>
955622819 </parameters>
955722820 </method>
9558- <method name="get_fold_duration"
9559- c:identifier="adw_flap_get_fold_duration"
9560- glib:get-property="fold-duration">
9561- <attribute name="org.gtk.Method.get_property" value="fold-duration"/>
22821+ <method name="get_child"
22822+ c:identifier="adw_navigation_page_get_child"
22823+ glib:get-property="child"
22824+ version="1.4">
956222825 <doc xml:space="preserve"
9563- filename="src/adw-flap.c"
9564- line="2156">Gets the fold transition animation duration for @self, in milliseconds.</doc>
9565- <source-position filename="src/adw-flap.h" line="94"/>
9566- <return-value transfer-ownership="none">
22826+ filename="src/adw-navigation-view.c"
22827+ line="2070">Gets the child widget of @self.</doc>
22828+ <source-position filename="src/adw-navigation-view.h" line="88"/>
22829+ <return-value transfer-ownership="none" nullable="1">
956722830 <doc xml:space="preserve"
9568- filename="src/adw-flap.c"
9569- line="2162">the fold transition duration</doc>
9570- <type name="guint" c:type="guint"/>
22831+ filename="src/adw-navigation-view.c"
22832+ line="2076">the child widget of @self</doc>
22833+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
957122834 </return-value>
957222835 <parameters>
957322836 <instance-parameter name="self" transfer-ownership="none">
957422837 <doc xml:space="preserve"
9575- filename="src/adw-flap.c"
9576- line="2158">a flap</doc>
9577- <type name="Flap" c:type="AdwFlap*"/>
22838+ filename="src/adw-navigation-view.c"
22839+ line="2072">a navigation page</doc>
22840+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
957822841 </instance-parameter>
957922842 </parameters>
958022843 </method>
9581- <method name="get_fold_policy"
9582- c:identifier="adw_flap_get_fold_policy"
9583- glib:get-property="fold-policy">
9584- <attribute name="org.gtk.Method.get_property" value="fold-policy"/>
22844+ <method name="get_tag"
22845+ c:identifier="adw_navigation_page_get_tag"
22846+ glib:get-property="tag"
22847+ version="1.4">
958522848 <doc xml:space="preserve"
9586- filename="src/adw-flap.c"
9587- line="2056">Gets the fold policy for @self.</doc>
9588- <source-position filename="src/adw-flap.h" line="82"/>
9589- <return-value transfer-ownership="none">
22849+ filename="src/adw-navigation-view.c"
22850+ line="2133">Gets the tag of @self.</doc>
22851+ <source-position filename="src/adw-navigation-view.h" line="94"/>
22852+ <return-value transfer-ownership="none" nullable="1">
959022853 <doc xml:space="preserve"
9591- filename="src/adw-flap.c"
9592- line="2062">the fold policy for @self</doc>
9593- <type name="FlapFoldPolicy" c:type="AdwFlapFoldPolicy"/>
22854+ filename="src/adw-navigation-view.c"
22855+ line="2139">the page tag</doc>
22856+ <type name="utf8" c:type="const char*"/>
959422857 </return-value>
959522858 <parameters>
959622859 <instance-parameter name="self" transfer-ownership="none">
959722860 <doc xml:space="preserve"
9598- filename="src/adw-flap.c"
9599- line="2058">a flap</doc>
9600- <type name="Flap" c:type="AdwFlap*"/>
22861+ filename="src/adw-navigation-view.c"
22862+ line="2135">a navigation page</doc>
22863+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
960122864 </instance-parameter>
960222865 </parameters>
960322866 </method>
9604- <method name="get_fold_threshold_policy"
9605- c:identifier="adw_flap_get_fold_threshold_policy"
9606- glib:get-property="fold-threshold-policy">
9607- <attribute name="org.gtk.Method.get_property"
9608- value="fold-threshold-policy"/>
22867+ <method name="get_title"
22868+ c:identifier="adw_navigation_page_get_title"
22869+ glib:get-property="title"
22870+ version="1.4">
960922871 <doc xml:space="preserve"
9610- filename="src/adw-flap.c"
9611- line="2111">Gets the fold threshold policy for @self.</doc>
9612- <source-position filename="src/adw-flap.h" line="88"/>
22872+ filename="src/adw-navigation-view.c"
22873+ line="2211">Gets the title of @self.</doc>
22874+ <source-position filename="src/adw-navigation-view.h" line="100"/>
961322875 <return-value transfer-ownership="none">
9614- <type name="FoldThresholdPolicy" c:type="AdwFoldThresholdPolicy"/>
22876+ <doc xml:space="preserve"
22877+ filename="src/adw-navigation-view.c"
22878+ line="2217">the title of @self</doc>
22879+ <type name="utf8" c:type="const char*"/>
961522880 </return-value>
961622881 <parameters>
961722882 <instance-parameter name="self" transfer-ownership="none">
961822883 <doc xml:space="preserve"
9619- filename="src/adw-flap.c"
9620- line="2113">a flap</doc>
9621- <type name="Flap" c:type="AdwFlap*"/>
22884+ filename="src/adw-navigation-view.c"
22885+ line="2213">a navigation page</doc>
22886+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
962222887 </instance-parameter>
962322888 </parameters>
962422889 </method>
9625- <method name="get_folded"
9626- c:identifier="adw_flap_get_folded"
9627- glib:get-property="folded">
9628- <attribute name="org.gtk.Method.get_property" value="folded"/>
22890+ <method name="set_can_pop"
22891+ c:identifier="adw_navigation_page_set_can_pop"
22892+ glib:set-property="can-pop"
22893+ version="1.4">
962922894 <doc xml:space="preserve"
9630- filename="src/adw-flap.c"
9631- line="2193">Gets whether @self is currently folded.
22895+ filename="src/adw-navigation-view.c"
22896+ line="2288">Sets whether @self can be popped from navigation stack.
963222897
9633-See [property@Flap:fold-policy].</doc>
9634- <source-position filename="src/adw-flap.h" line="100"/>
22898+Set it to `FALSE` to disable shortcuts and gestures, as well as remove the
22899+back button from [class@HeaderBar].
22900+
22901+Manually calling [method@NavigationView.pop] or using the `navigation.pop`
22902+action will still work.
22903+
22904+See [property@HeaderBar:show-back-button] for removing only the back button,
22905+but not shortcuts.</doc>
22906+ <source-position filename="src/adw-navigation-view.h" line="108"/>
963522907 <return-value transfer-ownership="none">
9636- <doc xml:space="preserve"
9637- filename="src/adw-flap.c"
9638- line="2201">`TRUE` if @self is currently folded</doc>
9639- <type name="gboolean" c:type="gboolean"/>
22908+ <type name="none" c:type="void"/>
964022909 </return-value>
964122910 <parameters>
964222911 <instance-parameter name="self" transfer-ownership="none">
964322912 <doc xml:space="preserve"
9644- filename="src/adw-flap.c"
9645- line="2195">a flap</doc>
9646- <type name="Flap" c:type="AdwFlap*"/>
22913+ filename="src/adw-navigation-view.c"
22914+ line="2290">a navigation page</doc>
22915+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
964722916 </instance-parameter>
22917+ <parameter name="can_pop" transfer-ownership="none">
22918+ <doc xml:space="preserve"
22919+ filename="src/adw-navigation-view.c"
22920+ line="2291">whether the page can be popped from navigation stack</doc>
22921+ <type name="gboolean" c:type="gboolean"/>
22922+ </parameter>
964822923 </parameters>
964922924 </method>
9650- <method name="get_locked"
9651- c:identifier="adw_flap_get_locked"
9652- glib:get-property="locked">
9653- <attribute name="org.gtk.Method.get_property" value="locked"/>
22925+ <method name="set_child"
22926+ c:identifier="adw_navigation_page_set_child"
22927+ glib:set-property="child"
22928+ version="1.4">
965422929 <doc xml:space="preserve"
9655- filename="src/adw-flap.c"
9656- line="2211">Gets whether @self is locked.</doc>
9657- <source-position filename="src/adw-flap.h" line="103"/>
22930+ filename="src/adw-navigation-view.c"
22931+ line="2092">Sets the child widget of @self.</doc>
22932+ <source-position filename="src/adw-navigation-view.h" line="90"/>
965822933 <return-value transfer-ownership="none">
9659- <doc xml:space="preserve"
9660- filename="src/adw-flap.c"
9661- line="2217">`TRUE` if @self is locked</doc>
9662- <type name="gboolean" c:type="gboolean"/>
22934+ <type name="none" c:type="void"/>
966322935 </return-value>
966422936 <parameters>
966522937 <instance-parameter name="self" transfer-ownership="none">
966622938 <doc xml:space="preserve"
9667- filename="src/adw-flap.c"
9668- line="2213">a flap</doc>
9669- <type name="Flap" c:type="AdwFlap*"/>
22939+ filename="src/adw-navigation-view.c"
22940+ line="2094">a navigation page</doc>
22941+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
967022942 </instance-parameter>
22943+ <parameter name="child"
22944+ transfer-ownership="none"
22945+ nullable="1"
22946+ allow-none="1">
22947+ <doc xml:space="preserve"
22948+ filename="src/adw-navigation-view.c"
22949+ line="2095">the child widget</doc>
22950+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
22951+ </parameter>
967122952 </parameters>
967222953 </method>
9673- <method name="get_modal"
9674- c:identifier="adw_flap_get_modal"
9675- glib:get-property="modal">
9676- <attribute name="org.gtk.Method.get_property" value="modal"/>
22954+ <method name="set_tag"
22955+ c:identifier="adw_navigation_page_set_tag"
22956+ glib:set-property="tag"
22957+ version="1.4">
967722958 <doc xml:space="preserve"
9678- filename="src/adw-flap.c"
9679- line="2302">Gets whether @self is modal.</doc>
9680- <source-position filename="src/adw-flap.h" line="115"/>
22959+ filename="src/adw-navigation-view.c"
22960+ line="2155">Sets the tag for @self.
22961+
22962+The tag can be used to retrieve the page with
22963+[method@NavigationView.find_page], as well as with
22964+[method@NavigationView.push_by_tag], [method@NavigationView.pop_to_tag] or
22965+[method@NavigationView.replace_with_tags].
22966+
22967+Tags must be unique within each [class@NavigationView].
22968+
22969+The tag also must be set to use the `navigation.push` action.</doc>
22970+ <source-position filename="src/adw-navigation-view.h" line="96"/>
968122971 <return-value transfer-ownership="none">
9682- <doc xml:space="preserve"
9683- filename="src/adw-flap.c"
9684- line="2308">`TRUE` if @self is modal</doc>
9685- <type name="gboolean" c:type="gboolean"/>
22972+ <type name="none" c:type="void"/>
968622973 </return-value>
968722974 <parameters>
968822975 <instance-parameter name="self" transfer-ownership="none">
968922976 <doc xml:space="preserve"
9690- filename="src/adw-flap.c"
9691- line="2304">a flap</doc>
9692- <type name="Flap" c:type="AdwFlap*"/>
22977+ filename="src/adw-navigation-view.c"
22978+ line="2157">a navigation page</doc>
22979+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
969322980 </instance-parameter>
22981+ <parameter name="tag"
22982+ transfer-ownership="none"
22983+ nullable="1"
22984+ allow-none="1">
22985+ <doc xml:space="preserve"
22986+ filename="src/adw-navigation-view.c"
22987+ line="2158">the page tag</doc>
22988+ <type name="utf8" c:type="const char*"/>
22989+ </parameter>
969422990 </parameters>
969522991 </method>
9696- <method name="get_reveal_flap"
9697- c:identifier="adw_flap_get_reveal_flap"
9698- glib:get-property="reveal-flap">
9699- <attribute name="org.gtk.Method.get_property" value="reveal-flap"/>
22992+ <method name="set_title"
22993+ c:identifier="adw_navigation_page_set_title"
22994+ glib:set-property="title"
22995+ version="1.4">
970022996 <doc xml:space="preserve"
9701- filename="src/adw-flap.c"
9702- line="1959">Gets whether the flap widget is revealed for @self.</doc>
9703- <source-position filename="src/adw-flap.h" line="67"/>
22997+ filename="src/adw-navigation-view.c"
22998+ line="2233">Sets the title of @self.
22999+
23000+It's displayed in [class@HeaderBar] instead of the window title, and used as
23001+the tooltip on the next page's back button, as well as by screen reader.</doc>
23002+ <source-position filename="src/adw-navigation-view.h" line="102"/>
970423003 <return-value transfer-ownership="none">
9705- <doc xml:space="preserve"
9706- filename="src/adw-flap.c"
9707- line="1965">`TRUE` if the flap widget is revealed</doc>
9708- <type name="gboolean" c:type="gboolean"/>
23004+ <type name="none" c:type="void"/>
970923005 </return-value>
971023006 <parameters>
971123007 <instance-parameter name="self" transfer-ownership="none">
971223008 <doc xml:space="preserve"
9713- filename="src/adw-flap.c"
9714- line="1961">a flap</doc>
9715- <type name="Flap" c:type="AdwFlap*"/>
23009+ filename="src/adw-navigation-view.c"
23010+ line="2235">a navigation page</doc>
23011+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
971623012 </instance-parameter>
23013+ <parameter name="title" transfer-ownership="none">
23014+ <doc xml:space="preserve"
23015+ filename="src/adw-navigation-view.c"
23016+ line="2236">the title</doc>
23017+ <type name="utf8" c:type="const char*"/>
23018+ </parameter>
971723019 </parameters>
971823020 </method>
9719- <method name="get_reveal_params"
9720- c:identifier="adw_flap_get_reveal_params"
9721- glib:get-property="reveal-params">
9722- <attribute name="org.gtk.Method.get_property" value="reveal-params"/>
23021+ <property name="can-pop"
23022+ version="1.4"
23023+ writable="1"
23024+ transfer-ownership="none"
23025+ setter="set_can_pop"
23026+ getter="get_can_pop"
23027+ default-value="TRUE">
23028+ <doc xml:space="preserve"
23029+ filename="src/adw-navigation-view.c"
23030+ line="553">Whether the page can be popped from navigation stack.
23031+
23032+Set it to `FALSE` to disable shortcuts and gestures, as well as remove the
23033+back button from [class@HeaderBar].
23034+
23035+Manually calling [method@NavigationView.pop] or using the `navigation.pop`
23036+action will still work.
23037+
23038+See [property@HeaderBar:show-back-button] for removing only the back
23039+button, but not shortcuts.</doc>
23040+ <type name="gboolean" c:type="gboolean"/>
23041+ </property>
23042+ <property name="child"
23043+ version="1.4"
23044+ writable="1"
23045+ transfer-ownership="none"
23046+ setter="set_child"
23047+ getter="get_child">
23048+ <doc xml:space="preserve"
23049+ filename="src/adw-navigation-view.c"
23050+ line="505">The child widget.</doc>
23051+ <type name="Gtk.Widget"/>
23052+ </property>
23053+ <property name="tag"
23054+ version="1.4"
23055+ writable="1"
23056+ transfer-ownership="none"
23057+ setter="set_tag"
23058+ getter="get_tag"
23059+ default-value="NULL">
23060+ <doc xml:space="preserve"
23061+ filename="src/adw-navigation-view.c"
23062+ line="517">The page tag.
23063+
23064+The tag can be used to retrieve the page with
23065+[method@NavigationView.find_page], as well as with
23066+[method@NavigationView.push_by_tag], [method@NavigationView.pop_to_tag] or
23067+[method@NavigationView.replace_with_tags].
23068+
23069+Tags must be unique within each [class@NavigationView].
23070+
23071+The tag also must be set to use the `navigation.push` action.</doc>
23072+ <type name="utf8" c:type="gchar*"/>
23073+ </property>
23074+ <property name="title"
23075+ version="1.4"
23076+ writable="1"
23077+ transfer-ownership="none"
23078+ setter="set_title"
23079+ getter="get_title">
23080+ <doc xml:space="preserve"
23081+ filename="src/adw-navigation-view.c"
23082+ line="538">The page title.
23083+
23084+It's displayed in [class@HeaderBar] instead of the window title, and used
23085+as the tooltip on the next page's back button, as well as by screen reader.</doc>
23086+ <type name="utf8" c:type="gchar*"/>
23087+ </property>
23088+ <field name="parent_instance">
23089+ <type name="Gtk.Widget" c:type="GtkWidget"/>
23090+ </field>
23091+ <glib:signal name="hidden" when="last" version="1.4">
972323092 <doc xml:space="preserve"
9724- filename="src/adw-flap.c"
9725- line="1991">Gets the reveal animation spring parameters for @self.</doc>
9726- <source-position filename="src/adw-flap.h" line="73"/>
9727- <return-value transfer-ownership="full">
9728- <doc xml:space="preserve"
9729- filename="src/adw-flap.c"
9730- line="1997">the reveal animation parameters</doc>
9731- <type name="SpringParams" c:type="AdwSpringParams*"/>
23093+ filename="src/adw-navigation-view.c"
23094+ line="648">Emitted when the navigation view transition has been completed and the page
23095+is fully hidden.
23096+
23097+It will always be preceded by [signal@NavigationPage::hiding] or
23098+[signal@NavigationPage::showing].</doc>
23099+ <return-value transfer-ownership="none">
23100+ <type name="none" c:type="void"/>
973223101 </return-value>
9733- <parameters>
9734- <instance-parameter name="self" transfer-ownership="none">
9735- <doc xml:space="preserve"
9736- filename="src/adw-flap.c"
9737- line="1993">a flap</doc>
9738- <type name="Flap" c:type="AdwFlap*"/>
9739- </instance-parameter>
9740- </parameters>
9741- </method>
9742- <method name="get_reveal_progress"
9743- c:identifier="adw_flap_get_reveal_progress"
9744- glib:get-property="reveal-progress">
9745- <attribute name="org.gtk.Method.get_property" value="reveal-progress"/>
23102+ </glib:signal>
23103+ <glib:signal name="hiding" when="last" version="1.4">
974623104 <doc xml:space="preserve"
9747- filename="src/adw-flap.c"
9748- line="2036">Gets the current reveal progress for @self.
23105+ filename="src/adw-navigation-view.c"
23106+ line="624">Emitted when the page starts hiding at the beginning of the navigation view
23107+transition.
974923108
9750-0 means fully hidden, 1 means fully revealed.
23109+It will always be followed by [signal@NavigationPage::hidden] or
23110+[signal@NavigationPage::shown].</doc>
23111+ <return-value transfer-ownership="none">
23112+ <type name="none" c:type="void"/>
23113+ </return-value>
23114+ </glib:signal>
23115+ <glib:signal name="showing" when="last" version="1.4">
23116+ <doc xml:space="preserve"
23117+ filename="src/adw-navigation-view.c"
23118+ line="576">Emitted when the page shows at the beginning of the navigation view
23119+transition.
975123120
9752-See [property@Flap:reveal-flap].</doc>
9753- <source-position filename="src/adw-flap.h" line="79"/>
23121+It will always be followed by [signal@NavigationPage::shown] or
23122+[signal@NavigationPage::hidden].</doc>
975423123 <return-value transfer-ownership="none">
9755- <doc xml:space="preserve"
9756- filename="src/adw-flap.c"
9757- line="2046">the current reveal progress for @self</doc>
9758- <type name="gdouble" c:type="double"/>
23124+ <type name="none" c:type="void"/>
975923125 </return-value>
9760- <parameters>
9761- <instance-parameter name="self" transfer-ownership="none">
9762- <doc xml:space="preserve"
9763- filename="src/adw-flap.c"
9764- line="2038">a flap</doc>
9765- <type name="Flap" c:type="AdwFlap*"/>
9766- </instance-parameter>
9767- </parameters>
9768- </method>
9769- <method name="get_separator"
9770- c:identifier="adw_flap_get_separator"
9771- glib:get-property="separator">
9772- <attribute name="org.gtk.Method.get_property" value="separator"/>
23126+ </glib:signal>
23127+ <glib:signal name="shown" when="last" version="1.4">
977323128 <doc xml:space="preserve"
9774- filename="src/adw-flap.c"
9775- line="1865">Gets the separator widget for @self.</doc>
9776- <source-position filename="src/adw-flap.h" line="55"/>
9777- <return-value transfer-ownership="none" nullable="1">
9778- <doc xml:space="preserve"
9779- filename="src/adw-flap.c"
9780- line="1871">the separator widget for @self</doc>
9781- <type name="Gtk.Widget" c:type="GtkWidget*"/>
23129+ filename="src/adw-navigation-view.c"
23130+ line="600">Emitted when the navigation view transition has been completed and the page
23131+is fully shown.
23132+
23133+It will always be preceded by [signal@NavigationPage::showing] or
23134+[signal@NavigationPage::hiding].</doc>
23135+ <return-value transfer-ownership="none">
23136+ <type name="none" c:type="void"/>
978223137 </return-value>
9783- <parameters>
9784- <instance-parameter name="self" transfer-ownership="none">
9785- <doc xml:space="preserve"
9786- filename="src/adw-flap.c"
9787- line="1867">a flap</doc>
9788- <type name="Flap" c:type="AdwFlap*"/>
9789- </instance-parameter>
9790- </parameters>
9791- </method>
9792- <method name="get_swipe_to_close"
9793- c:identifier="adw_flap_get_swipe_to_close"
9794- glib:get-property="swipe-to-close">
9795- <attribute name="org.gtk.Method.get_property" value="swipe-to-close"/>
23138+ </glib:signal>
23139+ </class>
23140+ <record name="NavigationPageClass"
23141+ c:type="AdwNavigationPageClass"
23142+ glib:is-gtype-struct-for="NavigationPage">
23143+ <source-position filename="src/adw-navigation-view.h" line="76"/>
23144+ <field name="parent_class">
23145+ <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
23146+ </field>
23147+ <field name="showing">
23148+ <callback name="showing">
23149+ <source-position filename="src/adw-navigation-view.h" line="39"/>
23150+ <return-value transfer-ownership="none">
23151+ <type name="none" c:type="void"/>
23152+ </return-value>
23153+ <parameters>
23154+ <parameter name="self" transfer-ownership="none">
23155+ <doc xml:space="preserve"
23156+ filename="src/adw-navigation-view.h"
23157+ line="32">a navigation page</doc>
23158+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
23159+ </parameter>
23160+ </parameters>
23161+ </callback>
23162+ </field>
23163+ <field name="shown">
23164+ <callback name="shown">
23165+ <source-position filename="src/adw-navigation-view.h" line="50"/>
23166+ <return-value transfer-ownership="none">
23167+ <type name="none" c:type="void"/>
23168+ </return-value>
23169+ <parameters>
23170+ <parameter name="self" transfer-ownership="none">
23171+ <doc xml:space="preserve"
23172+ filename="src/adw-navigation-view.h"
23173+ line="43">a navigation page</doc>
23174+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
23175+ </parameter>
23176+ </parameters>
23177+ </callback>
23178+ </field>
23179+ <field name="hiding">
23180+ <callback name="hiding">
23181+ <source-position filename="src/adw-navigation-view.h" line="61"/>
23182+ <return-value transfer-ownership="none">
23183+ <type name="none" c:type="void"/>
23184+ </return-value>
23185+ <parameters>
23186+ <parameter name="self" transfer-ownership="none">
23187+ <doc xml:space="preserve"
23188+ filename="src/adw-navigation-view.h"
23189+ line="54">a navigation page</doc>
23190+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
23191+ </parameter>
23192+ </parameters>
23193+ </callback>
23194+ </field>
23195+ <field name="hidden">
23196+ <callback name="hidden">
23197+ <source-position filename="src/adw-navigation-view.h" line="72"/>
23198+ <return-value transfer-ownership="none">
23199+ <type name="none" c:type="void"/>
23200+ </return-value>
23201+ <parameters>
23202+ <parameter name="self" transfer-ownership="none">
23203+ <doc xml:space="preserve"
23204+ filename="src/adw-navigation-view.h"
23205+ line="65">a navigation page</doc>
23206+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
23207+ </parameter>
23208+ </parameters>
23209+ </callback>
23210+ </field>
23211+ <field name="padding" readable="0" private="1">
23212+ <array zero-terminated="0" fixed-size="8">
23213+ <type name="gpointer" c:type="gpointer"/>
23214+ </array>
23215+ </field>
23216+ </record>
23217+ <class name="NavigationSplitView"
23218+ c:symbol-prefix="navigation_split_view"
23219+ c:type="AdwNavigationSplitView"
23220+ version="1.4"
23221+ parent="Gtk.Widget"
23222+ final="1"
23223+ glib:type-name="AdwNavigationSplitView"
23224+ glib:get-type="adw_navigation_split_view_get_type"
23225+ glib:type-struct="NavigationSplitViewClass">
23226+ <doc xml:space="preserve"
23227+ filename="src/adw-navigation-split-view.c"
23228+ line="20">A widget presenting sidebar and content side by side or as a navigation view.
23229+
23230+&lt;picture&gt;
23231+ &lt;source srcset="navigation-split-view-dark.png" media="(prefers-color-scheme: dark)"&gt;
23232+ &lt;img src="navigation-split-view.png" alt="navigation-split-view"&gt;
23233+&lt;/picture&gt;
23234+&lt;picture&gt;
23235+ &lt;source srcset="navigation-split-view-collapsed-dark.png" media="(prefers-color-scheme: dark)"&gt;
23236+ &lt;img src="navigation-split-view-collapsed.png" alt="navigation-split-view-collapsed"&gt;
23237+&lt;/picture&gt;
23238+
23239+`AdwNavigationSplitView` has two [class@NavigationPage] children: sidebar and
23240+content, and displays them side by side.
23241+
23242+When [property@NavigationSplitView:collapsed] is set to `TRUE`, it instead
23243+puts both children inside an [class@NavigationView]. The
23244+[property@NavigationSplitView:show-content] controls which child is visible
23245+while collapsed.
23246+
23247+See also [class@OverlaySplitView].
23248+
23249+`AdwNavigationSplitView` is typically used together with an [class@Breakpoint]
23250+setting the `collapsed` property to `TRUE` on small widths, as follows:
23251+
23252+```xml
23253+&lt;object class="AdwWindow"&gt;
23254+ &lt;property name="width-request"&gt;280&lt;/property&gt;
23255+ &lt;property name="height-request"&gt;200&lt;/property&gt;
23256+ &lt;property name="default-width"&gt;800&lt;/property&gt;
23257+ &lt;property name="default-height"&gt;800&lt;/property&gt;
23258+ &lt;child&gt;
23259+ &lt;object class="AdwBreakpoint"&gt;
23260+ &lt;condition&gt;max-width: 400sp&lt;/condition&gt;
23261+ &lt;setter object="split_view" property="collapsed"&gt;True&lt;/setter&gt;
23262+ &lt;/object&gt;
23263+ &lt;/child&gt;
23264+ &lt;property name="content"&gt;
23265+ &lt;object class="AdwNavigationSplitView" id="split_view"&gt;
23266+ &lt;property name="sidebar"&gt;
23267+ &lt;object class="AdwNavigationPage"&gt;
23268+ &lt;property name="title" translatable="yes"&gt;Sidebar&lt;/property&gt;
23269+ &lt;property name="child"&gt;
23270+ &lt;!-- ... --&gt;
23271+ &lt;/property&gt;
23272+ &lt;/object&gt;
23273+ &lt;/property&gt;
23274+ &lt;property name="content"&gt;
23275+ &lt;object class="AdwNavigationPage"&gt;
23276+ &lt;property name="title" translatable="yes"&gt;Content&lt;/property&gt;
23277+ &lt;property name="child"&gt;
23278+ &lt;!-- ... --&gt;
23279+ &lt;/property&gt;
23280+ &lt;/object&gt;
23281+ &lt;/property&gt;
23282+ &lt;/object&gt;
23283+ &lt;/property&gt;
23284+&lt;/object&gt;
23285+```
23286+
23287+## Sizing
23288+
23289+When not collapsed, `AdwNavigationSplitView` changes the sidebar width
23290+depending on its own width.
23291+
23292+If possible, it tries to allocate a fraction of the total width, controlled
23293+with the [property@NavigationSplitView:sidebar-width-fraction] property.
23294+
23295+The sidebar also has minimum and maximum sizes, controlled with the
23296+[property@NavigationSplitView:min-sidebar-width] and
23297+[property@NavigationSplitView:max-sidebar-width] properties.
23298+
23299+The minimum and maximum sizes are using the length unit specified with the
23300+[property@NavigationSplitView:sidebar-width-unit].
23301+
23302+By default, sidebar is using 25% of the total width, with 180sp as the
23303+minimum size and 280sp as the maximum size.
23304+
23305+## Header Bar Integration
23306+
23307+When used inside `AdwNavigationSplitView`, [class@HeaderBar] will
23308+automatically hide the window buttons in the middle.
23309+
23310+When collapsed, it also displays a back button for the content widget, as
23311+well as the page titles. See [class@NavigationView] documentation for details.
23312+
23313+## Actions
23314+
23315+`AdwNavigationSplitView` defines the same actions as `AdwNavigationView`, but
23316+they can be used even when the split view is not collapsed:
23317+
23318+- `navigation.push` takes a string parameter specifying the tag of the page
23319+to push. If it matches the tag of the content widget, it sets
23320+[property@NavigationSplitView:show-content] to `TRUE`.
23321+
23322+- `navigation.pop` doesn't take any parameters and sets
23323+[property@NavigationSplitView:show-content] to `FALSE`.
23324+
23325+## `AdwNavigationSplitView` as `GtkBuildable`
23326+
23327+The `AdwNavigationSplitView` implementation of the [iface@Gtk.Buildable]
23328+interface supports setting the sidebar widget by specifying “sidebar” as the
23329+“type” attribute of a `&lt;child&gt;` element, Specifying “content” child type or
23330+omitting it results in setting the content widget.
23331+
23332+## CSS nodes
23333+
23334+`AdwNavigationSplitView` has a single CSS node with the name
23335+`navigation-split-view`.
23336+
23337+When collapsed, it contains a child node with the name `navigation-view`
23338+containing both children.
23339+
23340+```
23341+navigation-split-view
23342+╰── navigation-view
23343+ ├── [sidebar child]
23344+ ╰── [content child]
23345+```
23346+
23347+When not collapsed, it contains two nodes with the name `widget`, one with
23348+the `.sidebar-pane` style class, the other one with `.content-view` style
23349+class, containing the sidebar and content children respectively.
23350+
23351+```
23352+navigation-split-view
23353+├── widget.sidebar-pane
23354+│ ╰── [sidebar child]
23355+╰── widget.content-pane
23356+ ╰── [content child]
23357+```
23358+
23359+## Accessibility
23360+
23361+`AdwNavigationSplitView` uses the `GTK_ACCESSIBLE_ROLE_GROUP` role.</doc>
23362+ <source-position filename="src/adw-navigation-split-view.h" line="27"/>
23363+ <implements name="Gtk.Accessible"/>
23364+ <implements name="Gtk.Buildable"/>
23365+ <implements name="Gtk.ConstraintTarget"/>
23366+ <constructor name="new"
23367+ c:identifier="adw_navigation_split_view_new"
23368+ version="1.4">
979623369 <doc xml:space="preserve"
9797- filename="src/adw-flap.c"
9798- line="2394">Gets whether @self can be closed with a swipe gesture.</doc>
9799- <source-position filename="src/adw-flap.h" line="127"/>
23370+ filename="src/adw-navigation-split-view.c"
23371+ line="947">Creates a new `AdwNavigationSplitView`.</doc>
23372+ <source-position filename="src/adw-navigation-split-view.h" line="30"/>
980023373 <return-value transfer-ownership="none">
980123374 <doc xml:space="preserve"
9802- filename="src/adw-flap.c"
9803- line="2400">`TRUE` if @self can be closed with a swipe gesture</doc>
9804- <type name="gboolean" c:type="gboolean"/>
23375+ filename="src/adw-navigation-split-view.c"
23376+ line="952">the newly created `AdwNavigationSplitView`</doc>
23377+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
980523378 </return-value>
9806- <parameters>
9807- <instance-parameter name="self" transfer-ownership="none">
9808- <doc xml:space="preserve"
9809- filename="src/adw-flap.c"
9810- line="2396">a flap</doc>
9811- <type name="Flap" c:type="AdwFlap*"/>
9812- </instance-parameter>
9813- </parameters>
9814- </method>
9815- <method name="get_swipe_to_open"
9816- c:identifier="adw_flap_get_swipe_to_open"
9817- glib:get-property="swipe-to-open">
9818- <attribute name="org.gtk.Method.get_property" value="swipe-to-open"/>
23379+ </constructor>
23380+ <method name="get_collapsed"
23381+ c:identifier="adw_navigation_split_view_get_collapsed"
23382+ glib:get-property="collapsed"
23383+ version="1.4">
981923384 <doc xml:space="preserve"
9820- filename="src/adw-flap.c"
9821- line="2350">Gets whether @self can be opened with a swipe gesture.</doc>
9822- <source-position filename="src/adw-flap.h" line="121"/>
23385+ filename="src/adw-navigation-split-view.c"
23386+ line="1148">Gets whether @self is collapsed.</doc>
23387+ <source-position filename="src/adw-navigation-split-view.h" line="45"/>
982323388 <return-value transfer-ownership="none">
982423389 <doc xml:space="preserve"
9825- filename="src/adw-flap.c"
9826- line="2356">`TRUE` if @self can be opened with a swipe gesture</doc>
23390+ filename="src/adw-navigation-split-view.c"
23391+ line="1154">whether @self is collapsed</doc>
982723392 <type name="gboolean" c:type="gboolean"/>
982823393 </return-value>
982923394 <parameters>
983023395 <instance-parameter name="self" transfer-ownership="none">
983123396 <doc xml:space="preserve"
9832- filename="src/adw-flap.c"
9833- line="2352">a flap</doc>
9834- <type name="Flap" c:type="AdwFlap*"/>
23397+ filename="src/adw-navigation-split-view.c"
23398+ line="1150">a navigation split view</doc>
23399+ <type name="NavigationSplitView" c:type="AdwNavigationSplitView*"/>
983523400 </instance-parameter>
983623401 </parameters>
983723402 </method>
9838- <method name="get_transition_type"
9839- c:identifier="adw_flap_get_transition_type"
9840- glib:get-property="transition-type">
9841- <attribute name="org.gtk.Method.get_property" value="transition-type"/>
23403+ <method name="get_content"
23404+ c:identifier="adw_navigation_split_view_get_content"
23405+ glib:get-property="content"
23406+ version="1.4">
984223407 <doc xml:space="preserve"
9843- filename="src/adw-flap.c"
9844- line="2254">Gets the type of animation used for reveal and fold transitions in @self.</doc>
9845- <source-position filename="src/adw-flap.h" line="109"/>
9846- <return-value transfer-ownership="none">
23408+ filename="src/adw-navigation-split-view.c"
23409+ line="1055">Sets the content widget for @self.</doc>
23410+ <source-position filename="src/adw-navigation-split-view.h" line="39"/>
23411+ <return-value transfer-ownership="none" nullable="1">
984723412 <doc xml:space="preserve"
9848- filename="src/adw-flap.c"
9849- line="2260">the current transition type of @self</doc>
9850- <type name="FlapTransitionType" c:type="AdwFlapTransitionType"/>
23413+ filename="src/adw-navigation-split-view.c"
23414+ line="1061">the content widget</doc>
23415+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
985123416 </return-value>
985223417 <parameters>
985323418 <instance-parameter name="self" transfer-ownership="none">
985423419 <doc xml:space="preserve"
9855- filename="src/adw-flap.c"
9856- line="2256">a flap</doc>
9857- <type name="Flap" c:type="AdwFlap*"/>
23420+ filename="src/adw-navigation-split-view.c"
23421+ line="1057">a navigation split view</doc>
23422+ <type name="NavigationSplitView" c:type="AdwNavigationSplitView*"/>
985823423 </instance-parameter>
985923424 </parameters>
986023425 </method>
9861- <method name="set_content"
9862- c:identifier="adw_flap_set_content"
9863- glib:set-property="content">
9864- <attribute name="org.gtk.Method.set_property" value="content"/>
23426+ <method name="get_max_sidebar_width"
23427+ c:identifier="adw_navigation_split_view_get_max_sidebar_width"
23428+ glib:get-property="max-sidebar-width"
23429+ version="1.4">
986523430 <doc xml:space="preserve"
9866- filename="src/adw-flap.c"
9867- line="1784">Sets the content widget for @self.
9868-
9869-It's always displayed when unfolded, and partially visible when folded.</doc>
9870- <source-position filename="src/adw-flap.h" line="45"/>
23431+ filename="src/adw-navigation-split-view.c"
23432+ line="1313">Gets the maximum sidebar width for @self.</doc>
23433+ <source-position filename="src/adw-navigation-split-view.h" line="63"/>
987123434 <return-value transfer-ownership="none">
9872- <type name="none" c:type="void"/>
23435+ <doc xml:space="preserve"
23436+ filename="src/adw-navigation-split-view.c"
23437+ line="1319">the maximum width</doc>
23438+ <type name="gdouble" c:type="double"/>
987323439 </return-value>
987423440 <parameters>
987523441 <instance-parameter name="self" transfer-ownership="none">
987623442 <doc xml:space="preserve"
9877- filename="src/adw-flap.c"
9878- line="1786">a flap</doc>
9879- <type name="Flap" c:type="AdwFlap*"/>
23443+ filename="src/adw-navigation-split-view.c"
23444+ line="1315">a navigation split view</doc>
23445+ <type name="NavigationSplitView" c:type="AdwNavigationSplitView*"/>
988023446 </instance-parameter>
9881- <parameter name="content"
9882- transfer-ownership="none"
9883- nullable="1"
9884- allow-none="1">
9885- <doc xml:space="preserve"
9886- filename="src/adw-flap.c"
9887- line="1787">the content widget</doc>
9888- <type name="Gtk.Widget" c:type="GtkWidget*"/>
9889- </parameter>
989023447 </parameters>
989123448 </method>
9892- <method name="set_flap"
9893- c:identifier="adw_flap_set_flap"
9894- glib:set-property="flap">
9895- <attribute name="org.gtk.Method.set_property" value="flap"/>
23449+ <method name="get_min_sidebar_width"
23450+ c:identifier="adw_navigation_split_view_get_min_sidebar_width"
23451+ glib:get-property="min-sidebar-width"
23452+ version="1.4">
989623453 <doc xml:space="preserve"
9897- filename="src/adw-flap.c"
9898- line="1832">Sets the flap widget for @self.
9899-
9900-It's only visible when [property@Flap:reveal-progress] is greater than 0.</doc>
9901- <source-position filename="src/adw-flap.h" line="51"/>
23454+ filename="src/adw-navigation-split-view.c"
23455+ line="1263">Gets the minimum sidebar width for @self.</doc>
23456+ <source-position filename="src/adw-navigation-split-view.h" line="57"/>
990223457 <return-value transfer-ownership="none">
9903- <type name="none" c:type="void"/>
23458+ <doc xml:space="preserve"
23459+ filename="src/adw-navigation-split-view.c"
23460+ line="1269">the minimum width</doc>
23461+ <type name="gdouble" c:type="double"/>
990423462 </return-value>
990523463 <parameters>
990623464 <instance-parameter name="self" transfer-ownership="none">
990723465 <doc xml:space="preserve"
9908- filename="src/adw-flap.c"
9909- line="1834">a flap</doc>
9910- <type name="Flap" c:type="AdwFlap*"/>
23466+ filename="src/adw-navigation-split-view.c"
23467+ line="1265">a navigation split view</doc>
23468+ <type name="NavigationSplitView" c:type="AdwNavigationSplitView*"/>
991123469 </instance-parameter>
9912- <parameter name="flap"
9913- transfer-ownership="none"
9914- nullable="1"
9915- allow-none="1">
9916- <doc xml:space="preserve"
9917- filename="src/adw-flap.c"
9918- line="1835">the flap widget</doc>
9919- <type name="Gtk.Widget" c:type="GtkWidget*"/>
9920- </parameter>
992123470 </parameters>
992223471 </method>
9923- <method name="set_flap_position"
9924- c:identifier="adw_flap_set_flap_position"
9925- glib:set-property="flap-position">
9926- <attribute name="org.gtk.Method.set_property" value="flap-position"/>
23472+ <method name="get_show_content"
23473+ c:identifier="adw_navigation_split_view_get_show_content"
23474+ glib:get-property="show-content"
23475+ version="1.4">
992723476 <doc xml:space="preserve"
9928- filename="src/adw-flap.c"
9929- line="1931">Sets the flap position for @self.
9930-
9931-If it's set to `GTK_PACK_START`, the flap is displayed before the content,
9932-if `GTK_PACK_END`, it's displayed after the content.</doc>
9933- <source-position filename="src/adw-flap.h" line="63"/>
23477+ filename="src/adw-navigation-split-view.c"
23478+ line="1200">Gets which page is visible when @self is collapsed.</doc>
23479+ <source-position filename="src/adw-navigation-split-view.h" line="51"/>
993423480 <return-value transfer-ownership="none">
9935- <type name="none" c:type="void"/>
23481+ <doc xml:space="preserve"
23482+ filename="src/adw-navigation-split-view.c"
23483+ line="1206">whether to show content when collapsed</doc>
23484+ <type name="gboolean" c:type="gboolean"/>
993623485 </return-value>
993723486 <parameters>
993823487 <instance-parameter name="self" transfer-ownership="none">
993923488 <doc xml:space="preserve"
9940- filename="src/adw-flap.c"
9941- line="1933">a flap</doc>
9942- <type name="Flap" c:type="AdwFlap*"/>
23489+ filename="src/adw-navigation-split-view.c"
23490+ line="1202">a navigation split view</doc>
23491+ <type name="NavigationSplitView" c:type="AdwNavigationSplitView*"/>
994323492 </instance-parameter>
9944- <parameter name="position" transfer-ownership="none">
9945- <doc xml:space="preserve"
9946- filename="src/adw-flap.c"
9947- line="1934">the new value</doc>
9948- <type name="Gtk.PackType" c:type="GtkPackType"/>
9949- </parameter>
995023493 </parameters>
995123494 </method>
9952- <method name="set_fold_duration"
9953- c:identifier="adw_flap_set_fold_duration"
9954- glib:set-property="fold-duration">
9955- <attribute name="org.gtk.Method.set_property" value="fold-duration"/>
23495+ <method name="get_sidebar"
23496+ c:identifier="adw_navigation_split_view_get_sidebar"
23497+ glib:get-property="sidebar"
23498+ version="1.4">
995623499 <doc xml:space="preserve"
9957- filename="src/adw-flap.c"
9958- line="2172">Sets the fold transition animation duration for @self, in milliseconds.</doc>
9959- <source-position filename="src/adw-flap.h" line="96"/>
9960- <return-value transfer-ownership="none">
9961- <type name="none" c:type="void"/>
23500+ filename="src/adw-navigation-split-view.c"
23501+ line="962">Gets the sidebar widget for @self.</doc>
23502+ <source-position filename="src/adw-navigation-split-view.h" line="33"/>
23503+ <return-value transfer-ownership="none" nullable="1">
23504+ <doc xml:space="preserve"
23505+ filename="src/adw-navigation-split-view.c"
23506+ line="968">the sidebar widget</doc>
23507+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
996223508 </return-value>
996323509 <parameters>
996423510 <instance-parameter name="self" transfer-ownership="none">
996523511 <doc xml:space="preserve"
9966- filename="src/adw-flap.c"
9967- line="2174">a flap</doc>
9968- <type name="Flap" c:type="AdwFlap*"/>
23512+ filename="src/adw-navigation-split-view.c"
23513+ line="964">a navigation split view</doc>
23514+ <type name="NavigationSplitView" c:type="AdwNavigationSplitView*"/>
996923515 </instance-parameter>
9970- <parameter name="duration" transfer-ownership="none">
9971- <doc xml:space="preserve"
9972- filename="src/adw-flap.c"
9973- line="2175">the new duration, in milliseconds</doc>
9974- <type name="guint" c:type="guint"/>
9975- </parameter>
997623516 </parameters>
997723517 </method>
9978- <method name="set_fold_policy"
9979- c:identifier="adw_flap_set_fold_policy"
9980- glib:set-property="fold-policy">
9981- <attribute name="org.gtk.Method.set_property" value="fold-policy"/>
23518+ <method name="get_sidebar_width_fraction"
23519+ c:identifier="adw_navigation_split_view_get_sidebar_width_fraction"
23520+ glib:get-property="sidebar-width-fraction"
23521+ version="1.4">
998223522 <doc xml:space="preserve"
9983- filename="src/adw-flap.c"
9984- line="2072">Sets the fold policy for @self.</doc>
9985- <source-position filename="src/adw-flap.h" line="84"/>
23523+ filename="src/adw-navigation-split-view.c"
23524+ line="1363">Gets the preferred sidebar width fraction for @self.</doc>
23525+ <source-position filename="src/adw-navigation-split-view.h" line="69"/>
998623526 <return-value transfer-ownership="none">
9987- <type name="none" c:type="void"/>
23527+ <doc xml:space="preserve"
23528+ filename="src/adw-navigation-split-view.c"
23529+ line="1369">the preferred width fraction</doc>
23530+ <type name="gdouble" c:type="double"/>
998823531 </return-value>
998923532 <parameters>
999023533 <instance-parameter name="self" transfer-ownership="none">
999123534 <doc xml:space="preserve"
9992- filename="src/adw-flap.c"
9993- line="2074">a flap</doc>
9994- <type name="Flap" c:type="AdwFlap*"/>
23535+ filename="src/adw-navigation-split-view.c"
23536+ line="1365">a navigation split view</doc>
23537+ <type name="NavigationSplitView" c:type="AdwNavigationSplitView*"/>
999523538 </instance-parameter>
9996- <parameter name="policy" transfer-ownership="none">
9997- <doc xml:space="preserve"
9998- filename="src/adw-flap.c"
9999- line="2075">the fold policy</doc>
10000- <type name="FlapFoldPolicy" c:type="AdwFlapFoldPolicy"/>
10001- </parameter>
1000223539 </parameters>
1000323540 </method>
10004- <method name="set_fold_threshold_policy"
10005- c:identifier="adw_flap_set_fold_threshold_policy"
10006- glib:set-property="fold-threshold-policy">
10007- <attribute name="org.gtk.Method.set_property"
10008- value="fold-threshold-policy"/>
23541+ <method name="get_sidebar_width_unit"
23542+ c:identifier="adw_navigation_split_view_get_sidebar_width_unit"
23543+ glib:get-property="sidebar-width-unit"
23544+ version="1.4">
1000923545 <doc xml:space="preserve"
10010- filename="src/adw-flap.c"
10011- line="2125">Sets the fold threshold policy for @self.
10012-
10013-If set to `ADW_FOLD_THRESHOLD_POLICY_MINIMUM`, flap will only fold when the
10014-children cannot fit anymore. With `ADW_FOLD_THRESHOLD_POLICY_NATURAL`, it
10015-will fold as soon as children don't get their natural size.
10016-
10017-This can be useful if you have a long ellipsizing label and want to let it
10018-ellipsize instead of immediately folding.</doc>
10019- <source-position filename="src/adw-flap.h" line="90"/>
23546+ filename="src/adw-navigation-split-view.c"
23547+ line="1414">Gets the length unit for minimum and maximum sidebar widths.</doc>
23548+ <source-position filename="src/adw-navigation-split-view.h" line="75"/>
1002023549 <return-value transfer-ownership="none">
10021- <type name="none" c:type="void"/>
23550+ <doc xml:space="preserve"
23551+ filename="src/adw-navigation-split-view.c"
23552+ line="1420">the length unit</doc>
23553+ <type name="LengthUnit" c:type="AdwLengthUnit"/>
1002223554 </return-value>
1002323555 <parameters>
1002423556 <instance-parameter name="self" transfer-ownership="none">
1002523557 <doc xml:space="preserve"
10026- filename="src/adw-flap.c"
10027- line="2127">a flap</doc>
10028- <type name="Flap" c:type="AdwFlap*"/>
23558+ filename="src/adw-navigation-split-view.c"
23559+ line="1416">a navigation split view</doc>
23560+ <type name="NavigationSplitView" c:type="AdwNavigationSplitView*"/>
1002923561 </instance-parameter>
10030- <parameter name="policy" transfer-ownership="none">
10031- <doc xml:space="preserve"
10032- filename="src/adw-flap.c"
10033- line="2128">the policy to use</doc>
10034- <type name="FoldThresholdPolicy" c:type="AdwFoldThresholdPolicy"/>
10035- </parameter>
1003623562 </parameters>
1003723563 </method>
10038- <method name="set_locked"
10039- c:identifier="adw_flap_set_locked"
10040- glib:set-property="locked">
10041- <attribute name="org.gtk.Method.set_property" value="locked"/>
23564+ <method name="set_collapsed"
23565+ c:identifier="adw_navigation_split_view_set_collapsed"
23566+ glib:set-property="collapsed"
23567+ version="1.4">
1004223568 <doc xml:space="preserve"
10043- filename="src/adw-flap.c"
10044- line="2227">Sets whether @self is locked.
23569+ filename="src/adw-navigation-split-view.c"
23570+ line="1166">Sets whether @self is collapsed.
1004523571
10046-If `FALSE`, folding when the flap is revealed automatically closes it, and
10047-unfolding it when the flap is not revealed opens it. If `TRUE`,
10048-[property@Flap:reveal-flap] value never changes on its own.</doc>
10049- <source-position filename="src/adw-flap.h" line="105"/>
23572+When collapsed, the children are put inside an [class@NavigationView],
23573+otherwise they are displayed side by side.
23574+
23575+The [property@NavigationSplitView:show-content] controls which child is
23576+visible while collapsed.</doc>
23577+ <source-position filename="src/adw-navigation-split-view.h" line="47"/>
1005023578 <return-value transfer-ownership="none">
1005123579 <type name="none" c:type="void"/>
1005223580 </return-value>
1005323581 <parameters>
1005423582 <instance-parameter name="self" transfer-ownership="none">
1005523583 <doc xml:space="preserve"
10056- filename="src/adw-flap.c"
10057- line="2229">a flap</doc>
10058- <type name="Flap" c:type="AdwFlap*"/>
23584+ filename="src/adw-navigation-split-view.c"
23585+ line="1168">a navigation split view</doc>
23586+ <type name="NavigationSplitView" c:type="AdwNavigationSplitView*"/>
1005923587 </instance-parameter>
10060- <parameter name="locked" transfer-ownership="none">
23588+ <parameter name="collapsed" transfer-ownership="none">
1006123589 <doc xml:space="preserve"
10062- filename="src/adw-flap.c"
10063- line="2230">the new value</doc>
23590+ filename="src/adw-navigation-split-view.c"
23591+ line="1169">whether @self is collapsed</doc>
1006423592 <type name="gboolean" c:type="gboolean"/>
1006523593 </parameter>
1006623594 </parameters>
1006723595 </method>
10068- <method name="set_modal"
10069- c:identifier="adw_flap_set_modal"
10070- glib:set-property="modal">
10071- <attribute name="org.gtk.Method.set_property" value="modal"/>
23596+ <method name="set_content"
23597+ c:identifier="adw_navigation_split_view_set_content"
23598+ glib:set-property="content"
23599+ version="1.4">
1007223600 <doc xml:space="preserve"
10073- filename="src/adw-flap.c"
10074- line="2318">Sets whether @self is modal.
10075-
10076-If `TRUE`, clicking the content widget while flap is revealed, as well as
10077-pressing the &lt;kbd&gt;Esc&lt;/kbd&gt; key, will close the flap. If `FALSE`, clicks are
10078-passed through to the content widget.</doc>
10079- <source-position filename="src/adw-flap.h" line="117"/>
23601+ filename="src/adw-navigation-split-view.c"
23602+ line="1073">Sets the content widget for @self.</doc>
23603+ <source-position filename="src/adw-navigation-split-view.h" line="41"/>
1008023604 <return-value transfer-ownership="none">
1008123605 <type name="none" c:type="void"/>
1008223606 </return-value>
1008323607 <parameters>
1008423608 <instance-parameter name="self" transfer-ownership="none">
1008523609 <doc xml:space="preserve"
10086- filename="src/adw-flap.c"
10087- line="2320">a flap</doc>
10088- <type name="Flap" c:type="AdwFlap*"/>
23610+ filename="src/adw-navigation-split-view.c"
23611+ line="1075">a navigation split view</doc>
23612+ <type name="NavigationSplitView" c:type="AdwNavigationSplitView*"/>
1008923613 </instance-parameter>
10090- <parameter name="modal" transfer-ownership="none">
23614+ <parameter name="content"
23615+ transfer-ownership="none"
23616+ nullable="1"
23617+ allow-none="1">
1009123618 <doc xml:space="preserve"
10092- filename="src/adw-flap.c"
10093- line="2321">whether @self is modal</doc>
10094- <type name="gboolean" c:type="gboolean"/>
23619+ filename="src/adw-navigation-split-view.c"
23620+ line="1076">the content widget</doc>
23621+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
1009523622 </parameter>
1009623623 </parameters>
1009723624 </method>
10098- <method name="set_reveal_flap"
10099- c:identifier="adw_flap_set_reveal_flap"
10100- glib:set-property="reveal-flap">
10101- <attribute name="org.gtk.Method.set_property" value="reveal-flap"/>
23625+ <method name="set_max_sidebar_width"
23626+ c:identifier="adw_navigation_split_view_set_max_sidebar_width"
23627+ glib:set-property="max-sidebar-width"
23628+ version="1.4">
1010223629 <doc xml:space="preserve"
10103- filename="src/adw-flap.c"
10104- line="1975">Sets whether the flap widget is revealed for @self.</doc>
10105- <source-position filename="src/adw-flap.h" line="69"/>
23630+ filename="src/adw-navigation-split-view.c"
23631+ line="1331">Sets the maximum sidebar width for @self.
23632+
23633+Maximum width is affected by
23634+[property@NavigationSplitView:sidebar-width-unit].
23635+
23636+The sidebar widget can still be allocated with larger width if its own
23637+minimum width exceeds it.</doc>
23638+ <source-position filename="src/adw-navigation-split-view.h" line="65"/>
1010623639 <return-value transfer-ownership="none">
1010723640 <type name="none" c:type="void"/>
1010823641 </return-value>
1010923642 <parameters>
1011023643 <instance-parameter name="self" transfer-ownership="none">
1011123644 <doc xml:space="preserve"
10112- filename="src/adw-flap.c"
10113- line="1977">a flap</doc>
10114- <type name="Flap" c:type="AdwFlap*"/>
23645+ filename="src/adw-navigation-split-view.c"
23646+ line="1333">a navigation split view</doc>
23647+ <type name="NavigationSplitView" c:type="AdwNavigationSplitView*"/>
1011523648 </instance-parameter>
10116- <parameter name="reveal_flap" transfer-ownership="none">
23649+ <parameter name="width" transfer-ownership="none">
1011723650 <doc xml:space="preserve"
10118- filename="src/adw-flap.c"
10119- line="1978">whether to reveal the flap widget</doc>
10120- <type name="gboolean" c:type="gboolean"/>
23651+ filename="src/adw-navigation-split-view.c"
23652+ line="1334">the maximum width</doc>
23653+ <type name="gdouble" c:type="double"/>
1012123654 </parameter>
1012223655 </parameters>
1012323656 </method>
10124- <method name="set_reveal_params"
10125- c:identifier="adw_flap_set_reveal_params"
10126- glib:set-property="reveal-params">
10127- <attribute name="org.gtk.Method.set_property" value="reveal-params"/>
23657+ <method name="set_min_sidebar_width"
23658+ c:identifier="adw_navigation_split_view_set_min_sidebar_width"
23659+ glib:set-property="min-sidebar-width"
23660+ version="1.4">
1012823661 <doc xml:space="preserve"
10129- filename="src/adw-flap.c"
10130- line="2007">Sets the reveal animation spring parameters for @self.
23662+ filename="src/adw-navigation-split-view.c"
23663+ line="1281">Sets the minimum sidebar width for @self.
1013123664
10132-The default value is equivalent to:
23665+Minimum width is affected by
23666+[property@NavigationSplitView:sidebar-width-unit].
1013323667
10134-```c
10135-adw_spring_params_new (1, 0.5, 500)
10136-```</doc>
10137- <source-position filename="src/adw-flap.h" line="75"/>
23668+The sidebar widget can still be allocated with larger width if its own
23669+minimum width exceeds it.</doc>
23670+ <source-position filename="src/adw-navigation-split-view.h" line="59"/>
1013823671 <return-value transfer-ownership="none">
1013923672 <type name="none" c:type="void"/>
1014023673 </return-value>
1014123674 <parameters>
1014223675 <instance-parameter name="self" transfer-ownership="none">
1014323676 <doc xml:space="preserve"
10144- filename="src/adw-flap.c"
10145- line="2009">a flap</doc>
10146- <type name="Flap" c:type="AdwFlap*"/>
23677+ filename="src/adw-navigation-split-view.c"
23678+ line="1283">a navigation split view</doc>
23679+ <type name="NavigationSplitView" c:type="AdwNavigationSplitView*"/>
1014723680 </instance-parameter>
10148- <parameter name="params" transfer-ownership="none">
23681+ <parameter name="width" transfer-ownership="none">
1014923682 <doc xml:space="preserve"
10150- filename="src/adw-flap.c"
10151- line="2010">the new parameters</doc>
10152- <type name="SpringParams" c:type="AdwSpringParams*"/>
23683+ filename="src/adw-navigation-split-view.c"
23684+ line="1284">the minimum width</doc>
23685+ <type name="gdouble" c:type="double"/>
1015323686 </parameter>
1015423687 </parameters>
1015523688 </method>
10156- <method name="set_separator"
10157- c:identifier="adw_flap_set_separator"
10158- glib:set-property="separator">
10159- <attribute name="org.gtk.Method.set_property" value="separator"/>
23689+ <method name="set_show_content"
23690+ c:identifier="adw_navigation_split_view_set_show_content"
23691+ glib:set-property="show-content"
23692+ version="1.4">
1016023693 <doc xml:space="preserve"
10161- filename="src/adw-flap.c"
10162- line="1881">Sets the separator widget for @self.
23694+ filename="src/adw-navigation-split-view.c"
23695+ line="1218">Sets which page is visible when @self is collapsed.
1016323696
10164-It's displayed between content and flap when there's no shadow to display.
10165-When exactly it's visible depends on the [property@Flap:transition-type]
10166-value.</doc>
10167- <source-position filename="src/adw-flap.h" line="57"/>
23697+If set to `TRUE`, the content widget will be the visible page when
23698+[property@NavigationSplitView:collapsed] is `TRUE`; otherwise the sidebar
23699+widget will be visible.
23700+
23701+If the split view is already collapsed, the visible page changes immediately.</doc>
23702+ <source-position filename="src/adw-navigation-split-view.h" line="53"/>
1016823703 <return-value transfer-ownership="none">
1016923704 <type name="none" c:type="void"/>
1017023705 </return-value>
1017123706 <parameters>
1017223707 <instance-parameter name="self" transfer-ownership="none">
1017323708 <doc xml:space="preserve"
10174- filename="src/adw-flap.c"
10175- line="1883">a flap</doc>
10176- <type name="Flap" c:type="AdwFlap*"/>
23709+ filename="src/adw-navigation-split-view.c"
23710+ line="1220">a navigation split view</doc>
23711+ <type name="NavigationSplitView" c:type="AdwNavigationSplitView*"/>
1017723712 </instance-parameter>
10178- <parameter name="separator"
10179- transfer-ownership="none"
10180- nullable="1"
10181- allow-none="1">
23713+ <parameter name="show_content" transfer-ownership="none">
1018223714 <doc xml:space="preserve"
10183- filename="src/adw-flap.c"
10184- line="1884">the separator widget</doc>
10185- <type name="Gtk.Widget" c:type="GtkWidget*"/>
23715+ filename="src/adw-navigation-split-view.c"
23716+ line="1221">whether to show content when collapsed</doc>
23717+ <type name="gboolean" c:type="gboolean"/>
1018623718 </parameter>
1018723719 </parameters>
1018823720 </method>
10189- <method name="set_swipe_to_close"
10190- c:identifier="adw_flap_set_swipe_to_close"
10191- glib:set-property="swipe-to-close">
10192- <attribute name="org.gtk.Method.set_property" value="swipe-to-close"/>
23721+ <method name="set_sidebar"
23722+ c:identifier="adw_navigation_split_view_set_sidebar"
23723+ glib:set-property="sidebar"
23724+ version="1.4">
1019323725 <doc xml:space="preserve"
10194- filename="src/adw-flap.c"
10195- line="2410">Sets whether @self can be closed with a swipe gesture.
10196-
10197-The area that can be swiped depends on the [property@Flap:transition-type]
10198-value.</doc>
10199- <source-position filename="src/adw-flap.h" line="129"/>
23726+ filename="src/adw-navigation-split-view.c"
23727+ line="980">Sets the sidebar widget for @self.</doc>
23728+ <source-position filename="src/adw-navigation-split-view.h" line="35"/>
1020023729 <return-value transfer-ownership="none">
1020123730 <type name="none" c:type="void"/>
1020223731 </return-value>
1020323732 <parameters>
1020423733 <instance-parameter name="self" transfer-ownership="none">
1020523734 <doc xml:space="preserve"
10206- filename="src/adw-flap.c"
10207- line="2412">a flap</doc>
10208- <type name="Flap" c:type="AdwFlap*"/>
23735+ filename="src/adw-navigation-split-view.c"
23736+ line="982">a navigation split view</doc>
23737+ <type name="NavigationSplitView" c:type="AdwNavigationSplitView*"/>
1020923738 </instance-parameter>
10210- <parameter name="swipe_to_close" transfer-ownership="none">
23739+ <parameter name="sidebar"
23740+ transfer-ownership="none"
23741+ nullable="1"
23742+ allow-none="1">
1021123743 <doc xml:space="preserve"
10212- filename="src/adw-flap.c"
10213- line="2413">whether @self can be closed with a swipe gesture</doc>
10214- <type name="gboolean" c:type="gboolean"/>
23744+ filename="src/adw-navigation-split-view.c"
23745+ line="983">the sidebar widget</doc>
23746+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
1021523747 </parameter>
1021623748 </parameters>
1021723749 </method>
10218- <method name="set_swipe_to_open"
10219- c:identifier="adw_flap_set_swipe_to_open"
10220- glib:set-property="swipe-to-open">
10221- <attribute name="org.gtk.Method.set_property" value="swipe-to-open"/>
23750+ <method name="set_sidebar_width_fraction"
23751+ c:identifier="adw_navigation_split_view_set_sidebar_width_fraction"
23752+ glib:set-property="sidebar-width-fraction"
23753+ version="1.4">
1022223754 <doc xml:space="preserve"
10223- filename="src/adw-flap.c"
10224- line="2366">Sets whether @self can be opened with a swipe gesture.
23755+ filename="src/adw-navigation-split-view.c"
23756+ line="1381">Sets the preferred sidebar width as a fraction of the total width of @self.
1022523757
10226-The area that can be swiped depends on the [property@Flap:transition-type]
10227-value.</doc>
10228- <source-position filename="src/adw-flap.h" line="123"/>
23758+The preferred width is additionally limited by
23759+[property@NavigationSplitView:min-sidebar-width] and
23760+[property@NavigationSplitView:max-sidebar-width].
23761+
23762+The sidebar widget can be allocated with larger width if its own minimum
23763+width exceeds the preferred width.</doc>
23764+ <source-position filename="src/adw-navigation-split-view.h" line="71"/>
1022923765 <return-value transfer-ownership="none">
1023023766 <type name="none" c:type="void"/>
1023123767 </return-value>
1023223768 <parameters>
1023323769 <instance-parameter name="self" transfer-ownership="none">
1023423770 <doc xml:space="preserve"
10235- filename="src/adw-flap.c"
10236- line="2368">a flap</doc>
10237- <type name="Flap" c:type="AdwFlap*"/>
23771+ filename="src/adw-navigation-split-view.c"
23772+ line="1383">a navigation split view</doc>
23773+ <type name="NavigationSplitView" c:type="AdwNavigationSplitView*"/>
1023823774 </instance-parameter>
10239- <parameter name="swipe_to_open" transfer-ownership="none">
23775+ <parameter name="fraction" transfer-ownership="none">
1024023776 <doc xml:space="preserve"
10241- filename="src/adw-flap.c"
10242- line="2369">whether @self can be opened with a swipe gesture</doc>
10243- <type name="gboolean" c:type="gboolean"/>
23777+ filename="src/adw-navigation-split-view.c"
23778+ line="1384">the preferred width fraction</doc>
23779+ <type name="gdouble" c:type="double"/>
1024423780 </parameter>
1024523781 </parameters>
1024623782 </method>
10247- <method name="set_transition_type"
10248- c:identifier="adw_flap_set_transition_type"
10249- glib:set-property="transition-type">
10250- <attribute name="org.gtk.Method.set_property" value="transition-type"/>
23783+ <method name="set_sidebar_width_unit"
23784+ c:identifier="adw_navigation_split_view_set_sidebar_width_unit"
23785+ glib:set-property="sidebar-width-unit"
23786+ version="1.4">
1025123787 <doc xml:space="preserve"
10252- filename="src/adw-flap.c"
10253- line="2270">Sets the type of animation used for reveal and fold transitions in @self.
23788+ filename="src/adw-navigation-split-view.c"
23789+ line="1432">Sets the length unit for minimum and maximum sidebar widths.
1025423790
10255-[property@Flap:flap] is transparent by default, which means the content will
10256-be seen through it with `ADW_FLAP_TRANSITION_TYPE_OVER` transitions; add the
10257-[`.background`](style-classes.html#background) style class to it if this is
10258-unwanted.</doc>
10259- <source-position filename="src/adw-flap.h" line="111"/>
23791+See [property@NavigationSplitView:min-sidebar-width] and
23792+[property@NavigationSplitView:max-sidebar-width].</doc>
23793+ <source-position filename="src/adw-navigation-split-view.h" line="77"/>
1026023794 <return-value transfer-ownership="none">
1026123795 <type name="none" c:type="void"/>
1026223796 </return-value>
1026323797 <parameters>
1026423798 <instance-parameter name="self" transfer-ownership="none">
1026523799 <doc xml:space="preserve"
10266- filename="src/adw-flap.c"
10267- line="2272">a flap</doc>
10268- <type name="Flap" c:type="AdwFlap*"/>
23800+ filename="src/adw-navigation-split-view.c"
23801+ line="1434">a navigation split view</doc>
23802+ <type name="NavigationSplitView" c:type="AdwNavigationSplitView*"/>
1026923803 </instance-parameter>
10270- <parameter name="transition_type" transfer-ownership="none">
23804+ <parameter name="unit" transfer-ownership="none">
1027123805 <doc xml:space="preserve"
10272- filename="src/adw-flap.c"
10273- line="2273">the new transition type</doc>
10274- <type name="FlapTransitionType" c:type="AdwFlapTransitionType"/>
23806+ filename="src/adw-navigation-split-view.c"
23807+ line="1435">the length unit</doc>
23808+ <type name="LengthUnit" c:type="AdwLengthUnit"/>
1027523809 </parameter>
1027623810 </parameters>
10277- </method>
10278- <property name="content"
10279- writable="1"
10280- transfer-ownership="none"
10281- setter="set_content"
10282- getter="get_content">
10283- <attribute name="org.gtk.Property.get" value="adw_flap_get_content"/>
10284- <attribute name="org.gtk.Property.set" value="adw_flap_set_content"/>
10285- <doc xml:space="preserve"
10286- filename="src/adw-flap.c"
10287- line="1260">The content widget.
10288-
10289-It's always displayed when unfolded, and partially visible when folded.</doc>
10290- <type name="Gtk.Widget"/>
10291- </property>
10292- <property name="flap"
10293- writable="1"
10294- transfer-ownership="none"
10295- setter="set_flap"
10296- getter="get_flap">
10297- <attribute name="org.gtk.Property.get" value="adw_flap_get_flap"/>
10298- <attribute name="org.gtk.Property.set" value="adw_flap_set_flap"/>
10299- <doc xml:space="preserve"
10300- filename="src/adw-flap.c"
10301- line="1272">The flap widget.
10302-
10303-It's only visible when [property@Flap:reveal-progress] is greater than 0.</doc>
10304- <type name="Gtk.Widget"/>
10305- </property>
10306- <property name="flap-position"
10307- writable="1"
10308- transfer-ownership="none"
10309- setter="set_flap_position"
10310- getter="get_flap_position"
10311- default-value="GTK_PACK_START">
10312- <attribute name="org.gtk.Property.get"
10313- value="adw_flap_get_flap_position"/>
10314- <attribute name="org.gtk.Property.set"
10315- value="adw_flap_set_flap_position"/>
10316- <doc xml:space="preserve"
10317- filename="src/adw-flap.c"
10318- line="1298">The flap position.
10319-
10320-If it's set to `GTK_PACK_START`, the flap is displayed before the content,
10321-if `GTK_PACK_END`, it's displayed after the content.</doc>
10322- <type name="Gtk.PackType"/>
10323- </property>
10324- <property name="fold-duration"
10325- writable="1"
10326- transfer-ownership="none"
10327- setter="set_fold_duration"
10328- getter="get_fold_duration"
10329- default-value="250">
10330- <attribute name="org.gtk.Property.get"
10331- value="adw_flap_get_fold_duration"/>
10332- <attribute name="org.gtk.Property.set"
10333- value="adw_flap_set_fold_duration"/>
10334- <doc xml:space="preserve"
10335- filename="src/adw-flap.c"
10336- line="1381">The fold transition animation duration, in milliseconds.</doc>
10337- <type name="guint" c:type="guint"/>
10338- </property>
10339- <property name="fold-policy"
10340- writable="1"
10341- transfer-ownership="none"
10342- setter="set_fold_policy"
10343- getter="get_fold_policy"
10344- default-value="ADW_FLAP_FOLD_POLICY_AUTO">
10345- <attribute name="org.gtk.Property.get"
10346- value="adw_flap_get_fold_policy"/>
10347- <attribute name="org.gtk.Property.set"
10348- value="adw_flap_set_fold_policy"/>
10349- <doc xml:space="preserve"
10350- filename="src/adw-flap.c"
10351- line="1352">The fold policy for the flap.</doc>
10352- <type name="FlapFoldPolicy"/>
10353- </property>
10354- <property name="fold-threshold-policy"
10355- writable="1"
10356- transfer-ownership="none"
10357- setter="set_fold_threshold_policy"
10358- getter="get_fold_threshold_policy"
10359- default-value="ADW_FOLD_THRESHOLD_POLICY_MINIMUM">
10360- <attribute name="org.gtk.Property.get"
10361- value="adw_flap_get_fold_threshold_policy"/>
10362- <attribute name="org.gtk.Property.set"
10363- value="adw_flap_set_fold_threshold_policy"/>
10364- <doc xml:space="preserve"
10365- filename="src/adw-flap.c"
10366- line="1363">Determines when the flap will fold.
10367-
10368-If set to `ADW_FOLD_THRESHOLD_POLICY_MINIMUM`, flap will only fold when
10369-the children cannot fit anymore. With `ADW_FOLD_THRESHOLD_POLICY_NATURAL`,
10370-it will fold as soon as children don't get their natural size.
10371-
10372-This can be useful if you have a long ellipsizing label and want to let it
10373-ellipsize instead of immediately folding.</doc>
10374- <type name="FoldThresholdPolicy"/>
10375- </property>
10376- <property name="folded"
10377- transfer-ownership="none"
10378- getter="get_folded"
10379- default-value="FALSE">
10380- <attribute name="org.gtk.Property.get" value="adw_flap_get_folded"/>
10381- <doc xml:space="preserve"
10382- filename="src/adw-flap.c"
10383- line="1392">Whether the flap is currently folded.
10384-
10385-See [property@Flap:fold-policy].</doc>
10386- <type name="gboolean" c:type="gboolean"/>
10387- </property>
10388- <property name="locked"
23811+ </method>
23812+ <property name="collapsed"
23813+ version="1.4"
1038923814 writable="1"
1039023815 transfer-ownership="none"
10391- setter="set_locked"
10392- getter="get_locked"
23816+ setter="set_collapsed"
23817+ getter="get_collapsed"
1039323818 default-value="FALSE">
10394- <attribute name="org.gtk.Property.get" value="adw_flap_get_locked"/>
10395- <attribute name="org.gtk.Property.set" value="adw_flap_set_locked"/>
1039623819 <doc xml:space="preserve"
10397- filename="src/adw-flap.c"
10398- line="1404">Whether the flap is locked.
23820+ filename="src/adw-navigation-split-view.c"
23821+ line="787">Whether the split view is collapsed.
1039923822
10400-If `FALSE`, folding when the flap is revealed automatically closes it, and
10401-unfolding it when the flap is not revealed opens it. If `TRUE`,
10402-[property@Flap:reveal-flap] value never changes on its own.</doc>
10403- <type name="gboolean" c:type="gboolean"/>
10404- </property>
10405- <property name="modal"
10406- writable="1"
10407- transfer-ownership="none"
10408- setter="set_modal"
10409- getter="get_modal"
10410- default-value="TRUE">
10411- <attribute name="org.gtk.Property.get" value="adw_flap_get_modal"/>
10412- <attribute name="org.gtk.Property.set" value="adw_flap_set_modal"/>
10413- <doc xml:space="preserve"
10414- filename="src/adw-flap.c"
10415- line="1434">Whether the flap is modal.
23823+When collapsed, the children are put inside an [class@NavigationView],
23824+otherwise they are displayed side by side.
1041623825
10417-If `TRUE`, clicking the content widget while flap is revealed, as well as
10418-pressing the &lt;kbd&gt;Esc&lt;/kbd&gt; key, will close the flap. If `FALSE`, clicks
10419-are passed through to the content widget.</doc>
23826+The [property@NavigationSplitView:show-content] controls which child is
23827+visible while collapsed.</doc>
1042023828 <type name="gboolean" c:type="gboolean"/>
1042123829 </property>
10422- <property name="reveal-flap"
23830+ <property name="content"
23831+ version="1.4"
1042323832 writable="1"
1042423833 transfer-ownership="none"
10425- setter="set_reveal_flap"
10426- getter="get_reveal_flap"
10427- default-value="TRUE">
10428- <attribute name="org.gtk.Property.get"
10429- value="adw_flap_get_reveal_flap"/>
10430- <attribute name="org.gtk.Property.set"
10431- value="adw_flap_set_reveal_flap"/>
23834+ setter="set_content"
23835+ getter="get_content">
1043223836 <doc xml:space="preserve"
10433- filename="src/adw-flap.c"
10434- line="1312">Whether the flap widget is revealed.</doc>
10435- <type name="gboolean" c:type="gboolean"/>
23837+ filename="src/adw-navigation-split-view.c"
23838+ line="775">The content widget.</doc>
23839+ <type name="NavigationPage"/>
1043623840 </property>
10437- <property name="reveal-params"
23841+ <property name="max-sidebar-width"
23842+ version="1.4"
1043823843 writable="1"
1043923844 transfer-ownership="none"
10440- setter="set_reveal_params"
10441- getter="get_reveal_params">
10442- <attribute name="org.gtk.Property.get"
10443- value="adw_flap_get_reveal_params"/>
10444- <attribute name="org.gtk.Property.set"
10445- value="adw_flap_set_reveal_params"/>
23845+ setter="set_max_sidebar_width"
23846+ getter="get_max_sidebar_width"
23847+ default-value="280.000000">
1044623848 <doc xml:space="preserve"
10447- filename="src/adw-flap.c"
10448- line="1322">The reveal animation spring parameters.
23849+ filename="src/adw-navigation-split-view.c"
23850+ line="842">The maximum sidebar width.
1044923851
10450-The default value is equivalent to:
23852+Maximum width is affected by
23853+[property@NavigationSplitView:sidebar-width-unit].
1045123854
10452-```c
10453-adw_spring_params_new (1, 0.5, 500)
10454-```</doc>
10455- <type name="SpringParams"/>
23855+The sidebar widget can still be allocated with larger width if its own
23856+minimum width exceeds it.</doc>
23857+ <type name="gdouble" c:type="gdouble"/>
1045623858 </property>
10457- <property name="reveal-progress"
23859+ <property name="min-sidebar-width"
23860+ version="1.4"
23861+ writable="1"
1045823862 transfer-ownership="none"
10459- getter="get_reveal_progress"
10460- default-value="1.000000">
10461- <attribute name="org.gtk.Property.get"
10462- value="adw_flap_get_reveal_progress"/>
23863+ setter="set_min_sidebar_width"
23864+ getter="get_min_sidebar_width"
23865+ default-value="180.000000">
1046323866 <doc xml:space="preserve"
10464- filename="src/adw-flap.c"
10465- line="1338">The current reveal transition progress.
23867+ filename="src/adw-navigation-split-view.c"
23868+ line="824">The minimum sidebar width.
1046623869
10467-0 means fully hidden, 1 means fully revealed.
23870+Minimum width is affected by
23871+[property@NavigationSplitView:sidebar-width-unit].
1046823872
10469-See [property@Flap:reveal-flap].</doc>
23873+The sidebar widget can still be allocated with larger width if its own
23874+minimum width exceeds it.</doc>
1047023875 <type name="gdouble" c:type="gdouble"/>
1047123876 </property>
10472- <property name="separator"
23877+ <property name="show-content"
23878+ version="1.4"
1047323879 writable="1"
1047423880 transfer-ownership="none"
10475- setter="set_separator"
10476- getter="get_separator">
10477- <attribute name="org.gtk.Property.get" value="adw_flap_get_separator"/>
10478- <attribute name="org.gtk.Property.set" value="adw_flap_set_separator"/>
23881+ setter="set_show_content"
23882+ getter="get_show_content"
23883+ default-value="FALSE">
1047923884 <doc xml:space="preserve"
10480- filename="src/adw-flap.c"
10481- line="1284">The separator widget.
23885+ filename="src/adw-navigation-split-view.c"
23886+ line="805">Determines the visible page when collapsed.
1048223887
10483-It's displayed between content and flap when there's no shadow to display.
10484-When exactly it's visible depends on the [property@Flap:transition-type]
10485-value.</doc>
10486- <type name="Gtk.Widget"/>
23888+If set to `TRUE`, the content widget will be the visible page when
23889+[property@NavigationSplitView:collapsed] is `TRUE`; otherwise the sidebar
23890+widget will be visible.
23891+
23892+If the split view is already collapsed, the visible page changes
23893+immediately.</doc>
23894+ <type name="gboolean" c:type="gboolean"/>
1048723895 </property>
10488- <property name="swipe-to-close"
23896+ <property name="sidebar"
23897+ version="1.4"
1048923898 writable="1"
1049023899 transfer-ownership="none"
10491- setter="set_swipe_to_close"
10492- getter="get_swipe_to_close"
10493- default-value="TRUE">
10494- <attribute name="org.gtk.Property.get"
10495- value="adw_flap_get_swipe_to_close"/>
10496- <attribute name="org.gtk.Property.set"
10497- value="adw_flap_set_swipe_to_close"/>
23900+ setter="set_sidebar"
23901+ getter="get_sidebar">
1049823902 <doc xml:space="preserve"
10499- filename="src/adw-flap.c"
10500- line="1461">Whether the flap can be closed with a swipe gesture.
10501-
10502-The area that can be swiped depends on the [property@Flap:transition-type]
10503-value.</doc>
10504- <type name="gboolean" c:type="gboolean"/>
23903+ filename="src/adw-navigation-split-view.c"
23904+ line="763">The sidebar widget.</doc>
23905+ <type name="NavigationPage"/>
1050523906 </property>
10506- <property name="swipe-to-open"
23907+ <property name="sidebar-width-fraction"
23908+ version="1.4"
1050723909 writable="1"
1050823910 transfer-ownership="none"
10509- setter="set_swipe_to_open"
10510- getter="get_swipe_to_open"
10511- default-value="TRUE">
10512- <attribute name="org.gtk.Property.get"
10513- value="adw_flap_get_swipe_to_open"/>
10514- <attribute name="org.gtk.Property.set"
10515- value="adw_flap_set_swipe_to_open"/>
23911+ setter="set_sidebar_width_fraction"
23912+ getter="get_sidebar_width_fraction"
23913+ default-value="0.250000">
1051623914 <doc xml:space="preserve"
10517- filename="src/adw-flap.c"
10518- line="1448">Whether the flap can be opened with a swipe gesture.
23915+ filename="src/adw-navigation-split-view.c"
23916+ line="860">The preferred sidebar width as a fraction of the total width.
1051923917
10520-The area that can be swiped depends on the [property@Flap:transition-type]
10521-value.</doc>
10522- <type name="gboolean" c:type="gboolean"/>
23918+The preferred width is additionally limited by
23919+[property@NavigationSplitView:min-sidebar-width] and
23920+[property@NavigationSplitView:max-sidebar-width].
23921+
23922+The sidebar widget can be allocated with larger width if its own minimum
23923+width exceeds the preferred width.</doc>
23924+ <type name="gdouble" c:type="gdouble"/>
1052323925 </property>
10524- <property name="transition-type"
23926+ <property name="sidebar-width-unit"
23927+ version="1.4"
1052523928 writable="1"
1052623929 transfer-ownership="none"
10527- setter="set_transition_type"
10528- getter="get_transition_type"
10529- default-value="ADW_FLAP_TRANSITION_TYPE_OVER">
10530- <attribute name="org.gtk.Property.get"
10531- value="adw_flap_get_transition_type"/>
10532- <attribute name="org.gtk.Property.set"
10533- value="adw_flap_set_transition_type"/>
23930+ setter="set_sidebar_width_unit"
23931+ getter="get_sidebar_width_unit"
23932+ default-value="ADW_LENGTH_UNIT_SP">
1053423933 <doc xml:space="preserve"
10535- filename="src/adw-flap.c"
10536- line="1418">the type of animation used for reveal and fold transitions.
23934+ filename="src/adw-navigation-split-view.c"
23935+ line="879">The length unit for minimum and maximum sidebar widths.
1053723936
10538-[property@Flap:flap] is transparent by default, which means the content
10539-will be seen through it with `ADW_FLAP_TRANSITION_TYPE_OVER` transitions;
10540-add the [`.background`](style-classes.html#background) style class to it if
10541-this is unwanted.</doc>
10542- <type name="FlapTransitionType"/>
23937+See [property@NavigationSplitView:min-sidebar-width] and
23938+[property@NavigationSplitView:max-sidebar-width].</doc>
23939+ <type name="LengthUnit"/>
1054323940 </property>
1054423941 </class>
10545- <record name="FlapClass"
10546- c:type="AdwFlapClass"
10547- glib:is-gtype-struct-for="Flap">
10548- <source-position filename="src/adw-flap.h" line="25"/>
23942+ <record name="NavigationSplitViewClass"
23943+ c:type="AdwNavigationSplitViewClass"
23944+ glib:is-gtype-struct-for="NavigationSplitView">
23945+ <source-position filename="src/adw-navigation-split-view.h" line="27"/>
1054923946 <field name="parent_class">
1055023947 <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
1055123948 </field>
1055223949 </record>
10553- <enumeration name="FlapFoldPolicy"
10554- glib:type-name="AdwFlapFoldPolicy"
10555- glib:get-type="adw_flap_fold_policy_get_type"
10556- c:type="AdwFlapFoldPolicy">
10557- <doc xml:space="preserve"
10558- filename="src/adw-flap.c"
10559- line="84">Describes the possible folding behavior of a [class@Flap] widget.</doc>
10560- <member name="never"
10561- value="0"
10562- c:identifier="ADW_FLAP_FOLD_POLICY_NEVER"
10563- glib:nick="never"
10564- glib:name="ADW_FLAP_FOLD_POLICY_NEVER">
10565- <doc xml:space="preserve"
10566- filename="src/adw-flap.c"
10567- line="86">Disable folding, the flap cannot reach narrow
10568- sizes.</doc>
10569- </member>
10570- <member name="always"
10571- value="1"
10572- c:identifier="ADW_FLAP_FOLD_POLICY_ALWAYS"
10573- glib:nick="always"
10574- glib:name="ADW_FLAP_FOLD_POLICY_ALWAYS">
10575- <doc xml:space="preserve"
10576- filename="src/adw-flap.c"
10577- line="88">Keep the flap always folded.</doc>
10578- </member>
10579- <member name="auto"
10580- value="2"
10581- c:identifier="ADW_FLAP_FOLD_POLICY_AUTO"
10582- glib:nick="auto"
10583- glib:name="ADW_FLAP_FOLD_POLICY_AUTO">
10584- <doc xml:space="preserve"
10585- filename="src/adw-flap.c"
10586- line="89">Fold and unfold the flap based on available
10587- space.</doc>
10588- </member>
10589- </enumeration>
10590- <enumeration name="FlapTransitionType"
10591- glib:type-name="AdwFlapTransitionType"
10592- glib:get-type="adw_flap_transition_type_get_type"
10593- c:type="AdwFlapTransitionType">
10594- <doc xml:space="preserve"
10595- filename="src/adw-flap.c"
10596- line="95">Describes transitions types of a [class@Flap] widget.
10597-
10598-It determines the type of animation when transitioning between children in a
10599-[class@Flap] widget, as well as which areas can be swiped via
10600-[property@Flap:swipe-to-open] and [property@Flap:swipe-to-close].
10601-
10602-New values may be added to this enum over time.</doc>
10603- <member name="over"
10604- value="0"
10605- c:identifier="ADW_FLAP_TRANSITION_TYPE_OVER"
10606- glib:nick="over"
10607- glib:name="ADW_FLAP_TRANSITION_TYPE_OVER">
10608- <doc xml:space="preserve"
10609- filename="src/adw-flap.c"
10610- line="97">The flap slides over the content, which is
10611- dimmed. When folded, only the flap can be swiped.</doc>
10612- </member>
10613- <member name="under"
10614- value="1"
10615- c:identifier="ADW_FLAP_TRANSITION_TYPE_UNDER"
10616- glib:nick="under"
10617- glib:name="ADW_FLAP_TRANSITION_TYPE_UNDER">
10618- <doc xml:space="preserve"
10619- filename="src/adw-flap.c"
10620- line="99">The content slides over the flap. Only the
10621- content can be swiped.</doc>
10622- </member>
10623- <member name="slide"
10624- value="2"
10625- c:identifier="ADW_FLAP_TRANSITION_TYPE_SLIDE"
10626- glib:nick="slide"
10627- glib:name="ADW_FLAP_TRANSITION_TYPE_SLIDE">
10628- <doc xml:space="preserve"
10629- filename="src/adw-flap.c"
10630- line="101">The flap slides offscreen when hidden,
10631- neither the flap nor content overlap each other. Both widgets can be
10632- swiped.</doc>
10633- </member>
10634- </enumeration>
10635- <enumeration name="FoldThresholdPolicy"
10636- glib:type-name="AdwFoldThresholdPolicy"
10637- glib:get-type="adw_fold_threshold_policy_get_type"
10638- c:type="AdwFoldThresholdPolicy">
10639- <doc xml:space="preserve"
10640- filename="src/adw-fold-threshold-policy.c"
10641- line="10">Determines when [class@Flap] and [class@Leaflet] will fold.</doc>
10642- <member name="minimum"
10643- value="0"
10644- c:identifier="ADW_FOLD_THRESHOLD_POLICY_MINIMUM"
10645- glib:nick="minimum"
10646- glib:name="ADW_FOLD_THRESHOLD_POLICY_MINIMUM">
10647- <doc xml:space="preserve"
10648- filename="src/adw-fold-threshold-policy.c"
10649- line="12">Folding is based on the minimum size</doc>
10650- </member>
10651- <member name="natural"
10652- value="1"
10653- c:identifier="ADW_FOLD_THRESHOLD_POLICY_NATURAL"
10654- glib:nick="natural"
10655- glib:name="ADW_FOLD_THRESHOLD_POLICY_NATURAL">
10656- <doc xml:space="preserve"
10657- filename="src/adw-fold-threshold-policy.c"
10658- line="13">Folding is based on the natural size</doc>
10659- </member>
10660- </enumeration>
10661- <class name="HeaderBar"
10662- c:symbol-prefix="header_bar"
10663- c:type="AdwHeaderBar"
23950+ <class name="NavigationView"
23951+ c:symbol-prefix="navigation_view"
23952+ c:type="AdwNavigationView"
23953+ version="1.4"
1066423954 parent="Gtk.Widget"
1066523955 final="1"
10666- glib:type-name="AdwHeaderBar"
10667- glib:get-type="adw_header_bar_get_type"
10668- glib:type-struct="HeaderBarClass">
23956+ glib:type-name="AdwNavigationView"
23957+ glib:get-type="adw_navigation_view_get_type"
23958+ glib:type-struct="NavigationViewClass">
1066923959 <doc xml:space="preserve"
10670- filename="src/adw-header-bar.c"
10671- line="30">A title bar widget.
23960+ filename="src/adw-navigation-view.c"
23961+ line="20">A page-based navigation container.
1067223962
1067323963 &lt;picture&gt;
10674- &lt;source srcset="header-bar-dark.png" media="(prefers-color-scheme: dark)"&gt;
10675- &lt;img src="header-bar.png" alt="header-bar"&gt;
23964+ &lt;source srcset="navigation-view-dark.png" media="(prefers-color-scheme: dark)"&gt;
23965+ &lt;img src="navigation-view.png" alt="navigation-view"&gt;
1067623966 &lt;/picture&gt;
1067723967
10678-`AdwHeaderBar` is similar to [class@Gtk.HeaderBar], but provides additional
10679-features compared to it. Refer to `GtkHeaderBar` for details.
23968+`AdwNavigationView` presents one child at a time, similar to
23969+[class@Gtk.Stack].
1068023970
10681-[property@HeaderBar:centering-policy] allows to enforce strict centering of
10682-the title widget, this is useful for [class@ViewSwitcherTitle].
23971+`AdwNavigationView` can only contain [class@NavigationPage] children.
1068323972
10684-[property@HeaderBar:show-start-title-buttons] and
10685-[property@HeaderBar:show-end-title-buttons] allow to easily create split
10686-header bar layouts using [class@Leaflet], as follows:
23973+It maintains a navigation stack that can be controlled with
23974+[method@NavigationView.push] and [method@NavigationView.pop]. The whole
23975+navigation stack can also be replaced using [method@NavigationView.replace].
23976+
23977+`AdwNavigationView` allows to manage pages statically or dynamically.
23978+
23979+Static pages can be added using the [method@NavigationView.add] method. The
23980+`AdwNavigationView` will keep a reference to these pages, but they aren't
23981+accessible to the user until [method@NavigationView.push] is called (except
23982+for the first page, which is pushed automatically). Use the
23983+[method@NavigationView.remove] method to remove them. This is useful for
23984+applications that have a small number of unique pages and just need
23985+navigation between them.
23986+
23987+Dynamic pages are automatically destroyed once they are popped off the
23988+navigation stack. To add a page like this, push it using the
23989+[method@NavigationView.push] method without calling
23990+[method@NavigationView.add] first.
23991+
23992+## Tags
23993+
23994+Static pages, as well as any pages in the navigation stack, can be accessed
23995+by their [property@NavigationPage:tag]. For example,
23996+[method@NavigationView.push_by_tag] can be used to push a static page that's
23997+not in the navigation stack without having to keep a reference to it manually.
23998+
23999+## Header Bar Integration
24000+
24001+When used inside `AdwNavigationView`, [class@HeaderBar] will automatically
24002+display a back button that can be used to go back to the previous page when
24003+possible. The button also has a context menu, allowing to pop multiple pages
24004+at once, potentially across multiple navigation views.
24005+
24006+Set [property@HeaderBar:show-back-button] to `FALSE` to disable this behavior
24007+in rare scenarios where it's unwanted.
24008+
24009+`AdwHeaderBar` will also display the title of the `AdwNavigationPage` it's
24010+placed into, so most applications shouldn't need to customize it at all.
24011+
24012+## Shortcuts and Gestures
24013+
24014+`AdwNavigationView` supports the following shortcuts for going to the
24015+previous page:
24016+
24017+- &lt;kbd&gt;Escape&lt;/kbd&gt; (unless [property@NavigationView:pop-on-escape] is set to
24018+ `FALSE`)
24019+- &lt;kbd&gt;Alt&lt;/kbd&gt;+&lt;kbd&gt;←&lt;/kbd&gt;
24020+- Back mouse button
24021+
24022+Additionally, it supports interactive gestures:
24023+
24024+- One-finger swipe towards the right on touchscreens
24025+- Scrolling towards the right on touchpads (usually two-finger swipe)
24026+
24027+These gestures have transitions enabled regardless of the
24028+[property@NavigationView:animate-transitions] value.
24029+
24030+Applications can also enable shortcuts for pushing another page onto the
24031+navigation stack via connecting to the [signal@NavigationView::get-next-page]
24032+signal, in that case the following shortcuts are supported:
24033+
24034+- &lt;kbd&gt;Alt&lt;/kbd&gt;+&lt;kbd&gt;→&lt;/kbd&gt;
24035+- Forward mouse button
24036+- Swipe/scrolling towards the left
24037+
24038+For right-to-left locales, the gestures and shortcuts are reversed.
24039+
24040+[property@NavigationPage:can-pop] can be used to disable them, along with the
24041+header bar back buttons.
24042+
24043+## Actions
24044+
24045+`AdwNavigationView` defines actions for controlling the navigation stack.
24046+actions for controlling the navigation stack:
24047+
24048+- `navigation.push` takes a string parameter specifying the tag of the page to
24049+push, and is equivalent to calling [method@NavigationView.push_by_tag].
24050+
24051+- `navigation.pop` doesn't take any parameters and pops the current page from
24052+the navigation stack, equivalent to calling [method@NavigationView.pop].
24053+
24054+## `AdwNavigationView` as `GtkBuildable`
24055+
24056+`AdwNavigationView` allows to add pages as children, equivalent to using the
24057+[method@NavigationView.add] method.
24058+
24059+Example of an `AdwNavigationView` UI definition:
1068724060
1068824061 ```xml
10689-&lt;object class="AdwLeaflet" id="leaflet"&gt;
24062+&lt;object class="AdwNavigationView"&gt;
1069024063 &lt;child&gt;
10691- &lt;object class="GtkBox"&gt;
10692- &lt;property name="orientation"&gt;vertical&lt;/property&gt;
10693- &lt;child&gt;
10694- &lt;object class="AdwHeaderBar"&gt;
10695- &lt;binding name="show-end-title-buttons"&gt;
10696- &lt;lookup name="folded"&gt;leaflet&lt;/lookup&gt;
10697- &lt;/binding&gt;
24064+ &lt;object class="AdwNavigationPage"&gt;
24065+ &lt;property name="title" translatable="yes"&gt;Page 1&lt;/property&gt;
24066+ &lt;property name="child"&gt;
24067+ &lt;object class="AdwToolbarView"&gt;
24068+ &lt;child type="top"&gt;
24069+ &lt;object class="AdwHeaderBar"/&gt;
24070+ &lt;/child&gt;
24071+ &lt;property name="content"&gt;
24072+ &lt;object class="GtkButton"&gt;
24073+ &lt;property name="label" translatable="yes"&gt;Open Page 2&lt;/property&gt;
24074+ &lt;property name="halign"&gt;center&lt;/property&gt;
24075+ &lt;property name="valign"&gt;center&lt;/property&gt;
24076+ &lt;property name="action-name"&gt;navigation.push&lt;/property&gt;
24077+ &lt;property name="action-target"&gt;'page-2'&lt;/property&gt;
24078+ &lt;style&gt;
24079+ &lt;class name="pill"/&gt;
24080+ &lt;/style&gt;
24081+ &lt;/object&gt;
24082+ &lt;/property&gt;
1069824083 &lt;/object&gt;
10699- &lt;/child&gt;
10700- &lt;!-- ... --&gt;
24084+ &lt;/property&gt;
1070124085 &lt;/object&gt;
1070224086 &lt;/child&gt;
10703- &lt;!-- ... --&gt;
1070424087 &lt;child&gt;
10705- &lt;object class="GtkBox"&gt;
10706- &lt;property name="orientation"&gt;vertical&lt;/property&gt;
10707- &lt;property name="hexpand"&gt;True&lt;/property&gt;
10708- &lt;child&gt;
10709- &lt;object class="AdwHeaderBar"&gt;
10710- &lt;binding name="show-start-title-buttons"&gt;
10711- &lt;lookup name="folded"&gt;leaflet&lt;/lookup&gt;
10712- &lt;/binding&gt;
24088+ &lt;object class="AdwNavigationPage"&gt;
24089+ &lt;property name="title" translatable="yes"&gt;Page 2&lt;/property&gt;
24090+ &lt;property name="tag"&gt;page-2&lt;/property&gt;
24091+ &lt;property name="child"&gt;
24092+ &lt;object class="AdwToolbarView"&gt;
24093+ &lt;child type="top"&gt;
24094+ &lt;object class="AdwHeaderBar"/&gt;
24095+ &lt;/child&gt;
24096+ &lt;property name="content"&gt;
24097+ &lt;!-- ... --&gt;
24098+ &lt;/property&gt;
1071324099 &lt;/object&gt;
10714- &lt;/child&gt;
10715- &lt;!-- ... --&gt;
24100+ &lt;/property&gt;
1071624101 &lt;/object&gt;
1071724102 &lt;/child&gt;
1071824103 &lt;/object&gt;
1071924104 ```
1072024105
1072124106 &lt;picture&gt;
10722- &lt;source srcset="header-bar-split-dark.png" media="(prefers-color-scheme: dark)"&gt;
10723- &lt;img src="header-bar-split.png" alt="header-bar-split"&gt;
10724-&lt;/picture&gt;
10725-
10726-## CSS nodes
10727-
10728-```
10729-headerbar
10730-╰── windowhandle
10731- ╰── box
10732- ├── widget
10733- │ ╰── box.start
10734- │ ├── windowcontrols.start
10735- │ ╰── [other children]
10736- ├── [Title Widget]
10737- ╰── widget
10738- ╰── box.end
10739- ├── [other children]
10740- ╰── windowcontrols.end
10741-```
24107+ &lt;source srcset="navigation-view-example-dark.png" media="(prefers-color-scheme: dark)"&gt;
24108+ &lt;img src="navigation-view-example.png" alt="navigation-view-example"&gt;
24109+&lt;/picture&gt;
1074224110
10743-`AdwHeaderBar`'s CSS node is called `headerbar`. It contains a `windowhandle`
10744-subnode, which contains a `box` subnode, which contains two `widget` subnodes
10745-at the start and end of the header bar, each of which contains a `box`
10746-subnode with the `.start` and `.end` style classes respectively, as well as a
10747-center node that represents the title.
24111+## CSS nodes
1074824112
10749-Each of the boxes contains a `windowcontrols` subnode, see
10750-[class@Gtk.WindowControls] for details, as well as other children.
24113+`AdwNavigationView` has a single CSS node with the name `navigation-view`.
1075124114
1075224115 ## Accessibility
1075324116
10754-`AdwHeaderBar` uses the `GTK_ACCESSIBLE_ROLE_GROUP` role.</doc>
10755- <source-position filename="src/adw-header-bar.h" line="37"/>
24117+`AdwNavigationView` uses the `GTK_ACCESSIBLE_ROLE_GROUP` role.</doc>
24118+ <source-position filename="src/adw-navigation-view.h" line="114"/>
24119+ <implements name="Swipeable"/>
1075624120 <implements name="Gtk.Accessible"/>
1075724121 <implements name="Gtk.Buildable"/>
1075824122 <implements name="Gtk.ConstraintTarget"/>
10759- <constructor name="new" c:identifier="adw_header_bar_new">
24123+ <constructor name="new"
24124+ c:identifier="adw_navigation_view_new"
24125+ version="1.4">
1076024126 <doc xml:space="preserve"
10761- filename="src/adw-header-bar.c"
10762- line="548">Creates a new `AdwHeaderBar`.</doc>
10763- <source-position filename="src/adw-header-bar.h" line="45"/>
24127+ filename="src/adw-navigation-view.c"
24128+ line="2424">Creates a new `AdwNavigationView`.</doc>
24129+ <source-position filename="src/adw-navigation-view.h" line="117"/>
1076424130 <return-value transfer-ownership="none">
1076524131 <doc xml:space="preserve"
10766- filename="src/adw-header-bar.c"
10767- line="553">the newly created `AdwHeaderBar`.</doc>
24132+ filename="src/adw-navigation-view.c"
24133+ line="2429">the new created `AdwNavigationView`</doc>
1076824134 <type name="Gtk.Widget" c:type="GtkWidget*"/>
1076924135 </return-value>
1077024136 </constructor>
10771- <method name="get_centering_policy"
10772- c:identifier="adw_header_bar_get_centering_policy"
10773- glib:get-property="centering-policy">
10774- <attribute name="org.gtk.Method.get_property"
10775- value="centering-policy"/>
24137+ <method name="add" c:identifier="adw_navigation_view_add" version="1.4">
1077624138 <doc xml:space="preserve"
10777- filename="src/adw-header-bar.c"
10778- line="840">Gets the policy for aligning the center widget.</doc>
10779- <source-position filename="src/adw-header-bar.h" line="82"/>
24139+ filename="src/adw-navigation-view.c"
24140+ line="2439">Permanently adds @page to @self.
24141+
24142+Any page that has been added will stay in @self even after being popped from
24143+the navigation stack.
24144+
24145+Adding a page while no page is visible will automatically push it to the
24146+navigation stack.
24147+
24148+See [method@NavigationView.remove].</doc>
24149+ <source-position filename="src/adw-navigation-view.h" line="120"/>
1078024150 <return-value transfer-ownership="none">
10781- <doc xml:space="preserve"
10782- filename="src/adw-header-bar.c"
10783- line="846">the centering policy</doc>
10784- <type name="CenteringPolicy" c:type="AdwCenteringPolicy"/>
24151+ <type name="none" c:type="void"/>
1078524152 </return-value>
1078624153 <parameters>
1078724154 <instance-parameter name="self" transfer-ownership="none">
1078824155 <doc xml:space="preserve"
10789- filename="src/adw-header-bar.c"
10790- line="842">a header bar</doc>
10791- <type name="HeaderBar" c:type="AdwHeaderBar*"/>
24156+ filename="src/adw-navigation-view.c"
24157+ line="2441">a navigation view</doc>
24158+ <type name="NavigationView" c:type="AdwNavigationView*"/>
1079224159 </instance-parameter>
24160+ <parameter name="page" transfer-ownership="none">
24161+ <doc xml:space="preserve"
24162+ filename="src/adw-navigation-view.c"
24163+ line="2442">the page to add</doc>
24164+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
24165+ </parameter>
1079324166 </parameters>
1079424167 </method>
10795- <method name="get_decoration_layout"
10796- c:identifier="adw_header_bar_get_decoration_layout"
10797- glib:get-property="decoration-layout">
10798- <attribute name="org.gtk.Method.get_property"
10799- value="decoration-layout"/>
24168+ <method name="find_page"
24169+ c:identifier="adw_navigation_view_find_page"
24170+ version="1.4">
1080024171 <doc xml:space="preserve"
10801- filename="src/adw-header-bar.c"
10802- line="794">Gets the decoration layout for @self.</doc>
10803- <source-position filename="src/adw-header-bar.h" line="76"/>
24172+ filename="src/adw-navigation-view.c"
24173+ line="2498">Finds a page in @self by its tag.
24174+
24175+See [property@NavigationPage:tag].</doc>
24176+ <source-position filename="src/adw-navigation-view.h" line="128"/>
1080424177 <return-value transfer-ownership="none" nullable="1">
1080524178 <doc xml:space="preserve"
10806- filename="src/adw-header-bar.c"
10807- line="800">the decoration layout</doc>
10808- <type name="utf8" c:type="const char*"/>
24179+ filename="src/adw-navigation-view.c"
24180+ line="2507">the page with the given tag</doc>
24181+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
1080924182 </return-value>
1081024183 <parameters>
1081124184 <instance-parameter name="self" transfer-ownership="none">
1081224185 <doc xml:space="preserve"
10813- filename="src/adw-header-bar.c"
10814- line="796">a header bar</doc>
10815- <type name="HeaderBar" c:type="AdwHeaderBar*"/>
24186+ filename="src/adw-navigation-view.c"
24187+ line="2500">a navigation view</doc>
24188+ <type name="NavigationView" c:type="AdwNavigationView*"/>
1081624189 </instance-parameter>
24190+ <parameter name="tag" transfer-ownership="none">
24191+ <doc xml:space="preserve"
24192+ filename="src/adw-navigation-view.c"
24193+ line="2501">a page tag</doc>
24194+ <type name="utf8" c:type="const char*"/>
24195+ </parameter>
1081724196 </parameters>
1081824197 </method>
10819- <method name="get_show_end_title_buttons"
10820- c:identifier="adw_header_bar_get_show_end_title_buttons"
10821- glib:get-property="show-end-title-buttons">
10822- <attribute name="org.gtk.Method.get_property"
10823- value="show-end-title-buttons"/>
24198+ <method name="get_animate_transitions"
24199+ c:identifier="adw_navigation_view_get_animate_transitions"
24200+ glib:get-property="animate-transitions"
24201+ version="1.4">
1082424202 <doc xml:space="preserve"
10825- filename="src/adw-header-bar.c"
10826- line="740">Gets whether to show title buttons at the end of @self.</doc>
10827- <source-position filename="src/adw-header-bar.h" line="70"/>
24203+ filename="src/adw-navigation-view.c"
24204+ line="2955">Gets whether @self animates page transitions.</doc>
24205+ <source-position filename="src/adw-navigation-view.h" line="168"/>
1082824206 <return-value transfer-ownership="none">
1082924207 <doc xml:space="preserve"
10830- filename="src/adw-header-bar.c"
10831- line="746">`TRUE` if title buttons at the end are shown</doc>
24208+ filename="src/adw-navigation-view.c"
24209+ line="2961">whether to animate page transitions</doc>
1083224210 <type name="gboolean" c:type="gboolean"/>
1083324211 </return-value>
1083424212 <parameters>
1083524213 <instance-parameter name="self" transfer-ownership="none">
1083624214 <doc xml:space="preserve"
10837- filename="src/adw-header-bar.c"
10838- line="742">a header bar</doc>
10839- <type name="HeaderBar" c:type="AdwHeaderBar*"/>
24215+ filename="src/adw-navigation-view.c"
24216+ line="2957">a navigation view</doc>
24217+ <type name="NavigationView" c:type="AdwNavigationView*"/>
1084024218 </instance-parameter>
1084124219 </parameters>
1084224220 </method>
10843- <method name="get_show_start_title_buttons"
10844- c:identifier="adw_header_bar_get_show_start_title_buttons"
10845- glib:get-property="show-start-title-buttons">
10846- <attribute name="org.gtk.Method.get_property"
10847- value="show-start-title-buttons"/>
24221+ <method name="get_navigation_stack"
24222+ c:identifier="adw_navigation_view_get_navigation_stack"
24223+ glib:get-property="navigation-stack"
24224+ version="1.4">
1084824225 <doc xml:space="preserve"
10849- filename="src/adw-header-bar.c"
10850- line="686">Gets whether to show title buttons at the start of @self.</doc>
10851- <source-position filename="src/adw-header-bar.h" line="64"/>
24226+ filename="src/adw-navigation-view.c"
24227+ line="3046">Returns a [iface@Gio.ListModel] that contains the pages in navigation stack.
24228+
24229+The pages are sorted from root page to visible page.
24230+
24231+This can be used to keep an up-to-date view.</doc>
24232+ <source-position filename="src/adw-navigation-view.h" line="180"/>
24233+ <return-value transfer-ownership="full">
24234+ <doc xml:space="preserve"
24235+ filename="src/adw-navigation-view.c"
24236+ line="3056">a list model for the navigation stack</doc>
24237+ <type name="Gio.ListModel" c:type="GListModel*"/>
24238+ </return-value>
24239+ <parameters>
24240+ <instance-parameter name="self" transfer-ownership="none">
24241+ <doc xml:space="preserve"
24242+ filename="src/adw-navigation-view.c"
24243+ line="3048">a navigation view</doc>
24244+ <type name="NavigationView" c:type="AdwNavigationView*"/>
24245+ </instance-parameter>
24246+ </parameters>
24247+ </method>
24248+ <method name="get_pop_on_escape"
24249+ c:identifier="adw_navigation_view_get_pop_on_escape"
24250+ glib:get-property="pop-on-escape"
24251+ version="1.4">
24252+ <doc xml:space="preserve"
24253+ filename="src/adw-navigation-view.c"
24254+ line="3000">Gets whether pressing Escape pops the current page on @self.</doc>
24255+ <source-position filename="src/adw-navigation-view.h" line="174"/>
1085224256 <return-value transfer-ownership="none">
1085324257 <doc xml:space="preserve"
10854- filename="src/adw-header-bar.c"
10855- line="692">`TRUE` if title buttons at the start are shown</doc>
24258+ filename="src/adw-navigation-view.c"
24259+ line="3006">whether to pop the current page</doc>
1085624260 <type name="gboolean" c:type="gboolean"/>
1085724261 </return-value>
1085824262 <parameters>
1085924263 <instance-parameter name="self" transfer-ownership="none">
1086024264 <doc xml:space="preserve"
10861- filename="src/adw-header-bar.c"
10862- line="688">a header bar</doc>
10863- <type name="HeaderBar" c:type="AdwHeaderBar*"/>
24265+ filename="src/adw-navigation-view.c"
24266+ line="3002">a navigation view</doc>
24267+ <type name="NavigationView" c:type="AdwNavigationView*"/>
1086424268 </instance-parameter>
1086524269 </parameters>
1086624270 </method>
10867- <method name="get_title_widget"
10868- c:identifier="adw_header_bar_get_title_widget"
10869- glib:get-property="title-widget">
10870- <attribute name="org.gtk.Method.get_property" value="title-widget"/>
24271+ <method name="get_previous_page"
24272+ c:identifier="adw_navigation_view_get_previous_page"
24273+ version="1.4">
1087124274 <doc xml:space="preserve"
10872- filename="src/adw-header-bar.c"
10873- line="620">Gets the title widget widget of @self.</doc>
10874- <source-position filename="src/adw-header-bar.h" line="58"/>
24275+ filename="src/adw-navigation-view.c"
24276+ line="2916">Gets the previous page for @page.
24277+
24278+If @page is in the navigation stack, returns the page popping @page will
24279+reveal.
24280+
24281+If @page is the root page or is not in the navigation stack, returns `NULL`.</doc>
24282+ <source-position filename="src/adw-navigation-view.h" line="164"/>
1087524283 <return-value transfer-ownership="none" nullable="1">
1087624284 <doc xml:space="preserve"
10877- filename="src/adw-header-bar.c"
10878- line="626">the title widget</doc>
10879- <type name="Gtk.Widget" c:type="GtkWidget*"/>
24285+ filename="src/adw-navigation-view.c"
24286+ line="2928">the previous page</doc>
24287+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
1088024288 </return-value>
1088124289 <parameters>
1088224290 <instance-parameter name="self" transfer-ownership="none">
1088324291 <doc xml:space="preserve"
10884- filename="src/adw-header-bar.c"
10885- line="622">a header bar</doc>
10886- <type name="HeaderBar" c:type="AdwHeaderBar*"/>
24292+ filename="src/adw-navigation-view.c"
24293+ line="2918">a navigation view</doc>
24294+ <type name="NavigationView" c:type="AdwNavigationView*"/>
1088724295 </instance-parameter>
24296+ <parameter name="page" transfer-ownership="none">
24297+ <doc xml:space="preserve"
24298+ filename="src/adw-navigation-view.c"
24299+ line="2919">a page in @self</doc>
24300+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
24301+ </parameter>
1088824302 </parameters>
1088924303 </method>
10890- <method name="pack_end" c:identifier="adw_header_bar_pack_end">
24304+ <method name="get_visible_page"
24305+ c:identifier="adw_navigation_view_get_visible_page"
24306+ glib:get-property="visible-page"
24307+ version="1.4">
1089124308 <doc xml:space="preserve"
10892- filename="src/adw-header-bar.c"
10893- line="575">Adds @child to @self, packed with reference to the end of @self.</doc>
10894- <source-position filename="src/adw-header-bar.h" line="51"/>
10895- <return-value transfer-ownership="none">
10896- <type name="none" c:type="void"/>
24309+ filename="src/adw-navigation-view.c"
24310+ line="2886">Gets the currently visible page in @self.</doc>
24311+ <source-position filename="src/adw-navigation-view.h" line="161"/>
24312+ <return-value transfer-ownership="none" nullable="1">
24313+ <doc xml:space="preserve"
24314+ filename="src/adw-navigation-view.c"
24315+ line="2892">the currently visible page</doc>
24316+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
1089724317 </return-value>
1089824318 <parameters>
1089924319 <instance-parameter name="self" transfer-ownership="none">
1090024320 <doc xml:space="preserve"
10901- filename="src/adw-header-bar.c"
10902- line="577">a header bar</doc>
10903- <type name="HeaderBar" c:type="AdwHeaderBar*"/>
24321+ filename="src/adw-navigation-view.c"
24322+ line="2888">a navigation view</doc>
24323+ <type name="NavigationView" c:type="AdwNavigationView*"/>
1090424324 </instance-parameter>
10905- <parameter name="child" transfer-ownership="none">
24325+ </parameters>
24326+ </method>
24327+ <method name="pop" c:identifier="adw_navigation_view_pop" version="1.4">
24328+ <doc xml:space="preserve"
24329+ filename="src/adw-navigation-view.c"
24330+ line="2586">Pops the visible page from the navigation stack.
24331+
24332+Does nothing if the navigation stack contains less than two pages.
24333+
24334+If [method@NavigationView.add] hasn't been called, the page is automatically
24335+removed.
24336+
24337+[signal@NavigationView::popped] will be emitted for the current visible page.
24338+
24339+See [method@NavigationView.pop_to_page] and
24340+[method@NavigationView.pop_to_tag].</doc>
24341+ <source-position filename="src/adw-navigation-view.h" line="140"/>
24342+ <return-value transfer-ownership="none">
24343+ <doc xml:space="preserve"
24344+ filename="src/adw-navigation-view.c"
24345+ line="2602">`TRUE` if a page has been popped</doc>
24346+ <type name="gboolean" c:type="gboolean"/>
24347+ </return-value>
24348+ <parameters>
24349+ <instance-parameter name="self" transfer-ownership="none">
1090624350 <doc xml:space="preserve"
10907- filename="src/adw-header-bar.c"
10908- line="578">the widget to be added to @self</doc>
10909- <type name="Gtk.Widget" c:type="GtkWidget*"/>
10910- </parameter>
24351+ filename="src/adw-navigation-view.c"
24352+ line="2588">a navigation view</doc>
24353+ <type name="NavigationView" c:type="AdwNavigationView*"/>
24354+ </instance-parameter>
1091124355 </parameters>
1091224356 </method>
10913- <method name="pack_start" c:identifier="adw_header_bar_pack_start">
24357+ <method name="pop_to_page"
24358+ c:identifier="adw_navigation_view_pop_to_page"
24359+ version="1.4">
1091424360 <doc xml:space="preserve"
10915- filename="src/adw-header-bar.c"
10916- line="561">Adds @child to @self, packed with reference to the start of the @self.</doc>
10917- <source-position filename="src/adw-header-bar.h" line="48"/>
24361+ filename="src/adw-navigation-view.c"
24362+ line="2629">Pops pages from the navigation stack until @page is visible.
24363+
24364+@page must be in the navigation stack.
24365+
24366+If [method@NavigationView.add] hasn't been called for any of the popped pages,
24367+they are automatically removed.
24368+
24369+[signal@NavigationView::popped] will be be emitted for each of the popped
24370+pages.
24371+
24372+See [method@NavigationView.pop] and [method@NavigationView.pop_to_tag].</doc>
24373+ <source-position filename="src/adw-navigation-view.h" line="143"/>
1091824374 <return-value transfer-ownership="none">
10919- <type name="none" c:type="void"/>
24375+ <doc xml:space="preserve"
24376+ filename="src/adw-navigation-view.c"
24377+ line="2646">`TRUE` if any pages have been popped</doc>
24378+ <type name="gboolean" c:type="gboolean"/>
1092024379 </return-value>
1092124380 <parameters>
1092224381 <instance-parameter name="self" transfer-ownership="none">
1092324382 <doc xml:space="preserve"
10924- filename="src/adw-header-bar.c"
10925- line="563">a header bar</doc>
10926- <type name="HeaderBar" c:type="AdwHeaderBar*"/>
24383+ filename="src/adw-navigation-view.c"
24384+ line="2631">a navigation view</doc>
24385+ <type name="NavigationView" c:type="AdwNavigationView*"/>
1092724386 </instance-parameter>
10928- <parameter name="child" transfer-ownership="none">
24387+ <parameter name="page" transfer-ownership="none">
1092924388 <doc xml:space="preserve"
10930- filename="src/adw-header-bar.c"
10931- line="564">the widget to be added to @self</doc>
10932- <type name="Gtk.Widget" c:type="GtkWidget*"/>
24389+ filename="src/adw-navigation-view.c"
24390+ line="2632">the page to pop to</doc>
24391+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
1093324392 </parameter>
1093424393 </parameters>
1093524394 </method>
10936- <method name="remove" c:identifier="adw_header_bar_remove">
24395+ <method name="pop_to_tag"
24396+ c:identifier="adw_navigation_view_pop_to_tag"
24397+ version="1.4">
1093724398 <doc xml:space="preserve"
10938- filename="src/adw-header-bar.c"
10939- line="589">Removes a child from @self.
24399+ filename="src/adw-navigation-view.c"
24400+ line="2675">Pops pages from the navigation stack until page with the tag @tag is visible.
1094024401
10941-The child must have been added with [method@HeaderBar.pack_start],
10942-[method@HeaderBar.pack_end] or [property@HeaderBar:title-widget].</doc>
10943- <source-position filename="src/adw-header-bar.h" line="54"/>
24402+The page must be in the navigation stack.
24403+
24404+If [method@NavigationView.add] hasn't been called for any of the popped pages,
24405+they are automatically removed.
24406+
24407+[signal@NavigationView::popped] will be emitted for each of the popped pages.
24408+
24409+See [method@NavigationView.pop_to_page] and [property@NavigationPage:tag].</doc>
24410+ <source-position filename="src/adw-navigation-view.h" line="147"/>
1094424411 <return-value transfer-ownership="none">
10945- <type name="none" c:type="void"/>
24412+ <doc xml:space="preserve"
24413+ filename="src/adw-navigation-view.c"
24414+ line="2691">`TRUE` if any pages have been popped</doc>
24415+ <type name="gboolean" c:type="gboolean"/>
1094624416 </return-value>
1094724417 <parameters>
1094824418 <instance-parameter name="self" transfer-ownership="none">
1094924419 <doc xml:space="preserve"
10950- filename="src/adw-header-bar.c"
10951- line="591">a header bar</doc>
10952- <type name="HeaderBar" c:type="AdwHeaderBar*"/>
24420+ filename="src/adw-navigation-view.c"
24421+ line="2677">a navigation view</doc>
24422+ <type name="NavigationView" c:type="AdwNavigationView*"/>
1095324423 </instance-parameter>
10954- <parameter name="child" transfer-ownership="none">
24424+ <parameter name="tag" transfer-ownership="none">
1095524425 <doc xml:space="preserve"
10956- filename="src/adw-header-bar.c"
10957- line="592">the child to remove</doc>
10958- <type name="Gtk.Widget" c:type="GtkWidget*"/>
24426+ filename="src/adw-navigation-view.c"
24427+ line="2678">a page tag</doc>
24428+ <type name="utf8" c:type="const char*"/>
1095924429 </parameter>
1096024430 </parameters>
1096124431 </method>
10962- <method name="set_centering_policy"
10963- c:identifier="adw_header_bar_set_centering_policy"
10964- glib:set-property="centering-policy">
10965- <attribute name="org.gtk.Method.set_property"
10966- value="centering-policy"/>
24432+ <method name="push"
24433+ c:identifier="adw_navigation_view_push"
24434+ version="1.4">
1096724435 <doc xml:space="preserve"
10968- filename="src/adw-header-bar.c"
10969- line="856">Sets the policy for aligning the center widget.</doc>
10970- <source-position filename="src/adw-header-bar.h" line="84"/>
24436+ filename="src/adw-navigation-view.c"
24437+ line="2521">Pushes @page onto the navigation stack.
24438+
24439+If [method@NavigationView.add] hasn't been called, the page is automatically
24440+removed once it's popped.
24441+
24442+[signal@NavigationView::pushed] will be emitted for @page.
24443+
24444+See [method@NavigationView.push_by_tag].</doc>
24445+ <source-position filename="src/adw-navigation-view.h" line="132"/>
1097124446 <return-value transfer-ownership="none">
1097224447 <type name="none" c:type="void"/>
1097324448 </return-value>
1097424449 <parameters>
1097524450 <instance-parameter name="self" transfer-ownership="none">
1097624451 <doc xml:space="preserve"
10977- filename="src/adw-header-bar.c"
10978- line="858">a header bar</doc>
10979- <type name="HeaderBar" c:type="AdwHeaderBar*"/>
24452+ filename="src/adw-navigation-view.c"
24453+ line="2523">a navigation view</doc>
24454+ <type name="NavigationView" c:type="AdwNavigationView*"/>
1098024455 </instance-parameter>
10981- <parameter name="centering_policy" transfer-ownership="none">
24456+ <parameter name="page" transfer-ownership="none">
1098224457 <doc xml:space="preserve"
10983- filename="src/adw-header-bar.c"
10984- line="859">the centering policy</doc>
10985- <type name="CenteringPolicy" c:type="AdwCenteringPolicy"/>
24458+ filename="src/adw-navigation-view.c"
24459+ line="2524">the page to push</doc>
24460+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
1098624461 </parameter>
1098724462 </parameters>
1098824463 </method>
10989- <method name="set_decoration_layout"
10990- c:identifier="adw_header_bar_set_decoration_layout"
10991- glib:set-property="decoration-layout">
10992- <attribute name="org.gtk.Method.set_property"
10993- value="decoration-layout"/>
24464+ <method name="push_by_tag"
24465+ c:identifier="adw_navigation_view_push_by_tag"
24466+ version="1.4">
1099424467 <doc xml:space="preserve"
10995- filename="src/adw-header-bar.c"
10996- line="810">Sets the decoration layout for @self.
24468+ filename="src/adw-navigation-view.c"
24469+ line="2550">Pushes the page with the tag @tag onto the navigation stack.
1099724470
10998-If this property is not set, the
10999-[property@Gtk.Settings:gtk-decoration-layout] setting is used.
24471+If [method@NavigationView.add] hasn't been called, the page is automatically
24472+removed once it's popped.
1100024473
11001-The format of the string is button names, separated by commas. A colon
11002-separates the buttons that should appear at the start from those at the end.
11003-Recognized button names are minimize, maximize, close and icon (the window
11004-icon).
24474+[signal@NavigationView::pushed] will be emitted for the page.
1100524475
11006-For example, “icon:minimize,maximize,close” specifies an icon at the start,
11007-and minimize, maximize and close buttons at the end.</doc>
11008- <source-position filename="src/adw-header-bar.h" line="78"/>
24476+See [method@NavigationView.push] and [property@NavigationPage:tag].</doc>
24477+ <source-position filename="src/adw-navigation-view.h" line="136"/>
1100924478 <return-value transfer-ownership="none">
1101024479 <type name="none" c:type="void"/>
1101124480 </return-value>
1101224481 <parameters>
1101324482 <instance-parameter name="self" transfer-ownership="none">
1101424483 <doc xml:space="preserve"
11015- filename="src/adw-header-bar.c"
11016- line="812">a header bar</doc>
11017- <type name="HeaderBar" c:type="AdwHeaderBar*"/>
24484+ filename="src/adw-navigation-view.c"
24485+ line="2552">a navigation view</doc>
24486+ <type name="NavigationView" c:type="AdwNavigationView*"/>
1101824487 </instance-parameter>
11019- <parameter name="layout"
11020- transfer-ownership="none"
11021- nullable="1"
11022- allow-none="1">
24488+ <parameter name="tag" transfer-ownership="none">
1102324489 <doc xml:space="preserve"
11024- filename="src/adw-header-bar.c"
11025- line="813">a decoration layout</doc>
24490+ filename="src/adw-navigation-view.c"
24491+ line="2553">the page tag</doc>
1102624492 <type name="utf8" c:type="const char*"/>
1102724493 </parameter>
1102824494 </parameters>
1102924495 </method>
11030- <method name="set_show_end_title_buttons"
11031- c:identifier="adw_header_bar_set_show_end_title_buttons"
11032- glib:set-property="show-end-title-buttons">
11033- <attribute name="org.gtk.Method.set_property"
11034- value="show-end-title-buttons"/>
24496+ <method name="remove"
24497+ c:identifier="adw_navigation_view_remove"
24498+ version="1.4">
1103524499 <doc xml:space="preserve"
11036- filename="src/adw-header-bar.c"
11037- line="756">Sets whether to show title buttons at the end of @self.
24500+ filename="src/adw-navigation-view.c"
24501+ line="2473">Removes @page from @self.
1103824502
11039-See [property@HeaderBar:show-start-title-buttons] for the other side.
24503+If @page is currently in the navigation stack, it will be removed once it's
24504+popped. Otherwise, it's removed immediately.
1104024505
11041-Which buttons are actually shown and where is determined by the
11042-[property@HeaderBar:decoration-layout] property, and by the state of the
11043-window (e.g. a close button will not be shown if the window can't be closed).</doc>
11044- <source-position filename="src/adw-header-bar.h" line="72"/>
24506+See [method@NavigationView.add].</doc>
24507+ <source-position filename="src/adw-navigation-view.h" line="124"/>
1104524508 <return-value transfer-ownership="none">
1104624509 <type name="none" c:type="void"/>
1104724510 </return-value>
1104824511 <parameters>
1104924512 <instance-parameter name="self" transfer-ownership="none">
1105024513 <doc xml:space="preserve"
11051- filename="src/adw-header-bar.c"
11052- line="758">a header bar</doc>
11053- <type name="HeaderBar" c:type="AdwHeaderBar*"/>
24514+ filename="src/adw-navigation-view.c"
24515+ line="2475">a navigation view</doc>
24516+ <type name="NavigationView" c:type="AdwNavigationView*"/>
1105424517 </instance-parameter>
11055- <parameter name="setting" transfer-ownership="none">
24518+ <parameter name="page" transfer-ownership="none">
1105624519 <doc xml:space="preserve"
11057- filename="src/adw-header-bar.c"
11058- line="759">`TRUE` to show standard title buttons</doc>
11059- <type name="gboolean" c:type="gboolean"/>
24520+ filename="src/adw-navigation-view.c"
24521+ line="2476">the page to remove</doc>
24522+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
1106024523 </parameter>
1106124524 </parameters>
1106224525 </method>
11063- <method name="set_show_start_title_buttons"
11064- c:identifier="adw_header_bar_set_show_start_title_buttons"
11065- glib:set-property="show-start-title-buttons">
11066- <attribute name="org.gtk.Method.set_property"
11067- value="show-start-title-buttons"/>
24526+ <method name="replace"
24527+ c:identifier="adw_navigation_view_replace"
24528+ version="1.4">
1106824529 <doc xml:space="preserve"
11069- filename="src/adw-header-bar.c"
11070- line="702">Sets whether to show title buttons at the start of @self.
24530+ filename="src/adw-navigation-view.c"
24531+ line="2715">Replaces the current navigation stack with @pages.
1107124532
11072-See [property@HeaderBar:show-end-title-buttons] for the other side.
24533+The last page becomes the visible page.
1107324534
11074-Which buttons are actually shown and where is determined by the
11075-[property@HeaderBar:decoration-layout] property, and by the state of the
11076-window (e.g. a close button will not be shown if the window can't be closed).</doc>
11077- <source-position filename="src/adw-header-bar.h" line="66"/>
24535+Replacing the navigation stack has no animation.
24536+
24537+If [method@NavigationView.add] hasn't been called for any pages that are no
24538+longer in the navigation stack, they are automatically removed.
24539+
24540+@n_pages can be 0, in that case no page will be visible after calling this
24541+method. This can be useful for removing all pages from @self.
24542+
24543+The [signal@NavigationView::replaced] signal will be emitted.
24544+
24545+See [method@NavigationView.replace_with_tags].</doc>
24546+ <source-position filename="src/adw-navigation-view.h" line="151"/>
1107824547 <return-value transfer-ownership="none">
1107924548 <type name="none" c:type="void"/>
1108024549 </return-value>
1108124550 <parameters>
1108224551 <instance-parameter name="self" transfer-ownership="none">
1108324552 <doc xml:space="preserve"
11084- filename="src/adw-header-bar.c"
11085- line="704">a header bar</doc>
11086- <type name="HeaderBar" c:type="AdwHeaderBar*"/>
24553+ filename="src/adw-navigation-view.c"
24554+ line="2717">a navigation view</doc>
24555+ <type name="NavigationView" c:type="AdwNavigationView*"/>
1108724556 </instance-parameter>
11088- <parameter name="setting" transfer-ownership="none">
24557+ <parameter name="pages" transfer-ownership="none">
1108924558 <doc xml:space="preserve"
11090- filename="src/adw-header-bar.c"
11091- line="705">`TRUE` to show standard title buttons</doc>
11092- <type name="gboolean" c:type="gboolean"/>
24559+ filename="src/adw-navigation-view.c"
24560+ line="2718">the new navigation stack</doc>
24561+ <array length="1" zero-terminated="0" c:type="AdwNavigationPage**">
24562+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
24563+ </array>
24564+ </parameter>
24565+ <parameter name="n_pages" transfer-ownership="none">
24566+ <doc xml:space="preserve"
24567+ filename="src/adw-navigation-view.c"
24568+ line="2719">the number of pages in @pages</doc>
24569+ <type name="gint" c:type="int"/>
1109324570 </parameter>
1109424571 </parameters>
1109524572 </method>
11096- <method name="set_title_widget"
11097- c:identifier="adw_header_bar_set_title_widget"
11098- glib:set-property="title-widget">
11099- <attribute name="org.gtk.Method.set_property" value="title-widget"/>
24573+ <method name="replace_with_tags"
24574+ c:identifier="adw_navigation_view_replace_with_tags"
24575+ version="1.4">
1110024576 <doc xml:space="preserve"
11101- filename="src/adw-header-bar.c"
11102- line="636">Sets the title widget for @self.
24577+ filename="src/adw-navigation-view.c"
24578+ line="2830">Replaces the current navigation stack with pages with the tags @tags.
1110324579
11104-When set to `NULL`, the header bar will display the title of the window it
11105-is contained in.
24580+The last page becomes the visible page.
1110624581
11107-To use a different title, use [class@WindowTitle]:
24582+Replacing the navigation stack has no animation.
24583+
24584+If [method@NavigationView.add] hasn't been called for any pages that are no
24585+longer in the navigation stack, they are automatically removed.
24586+
24587+@n_tags can be 0, in that case no page will be visible after calling this
24588+method. This can be useful for removing all pages from @self.
24589+
24590+The [signal@NavigationView::replaced] signal will be emitted.
24591+
24592+See [method@NavigationView.replace] and [property@NavigationPage:tag].</doc>
24593+ <source-position filename="src/adw-navigation-view.h" line="156"/>
24594+ <return-value transfer-ownership="none">
24595+ <type name="none" c:type="void"/>
24596+ </return-value>
24597+ <parameters>
24598+ <instance-parameter name="self" transfer-ownership="none">
24599+ <doc xml:space="preserve"
24600+ filename="src/adw-navigation-view.c"
24601+ line="2832">a navigation view</doc>
24602+ <type name="NavigationView" c:type="AdwNavigationView*"/>
24603+ </instance-parameter>
24604+ <parameter name="tags" transfer-ownership="none">
24605+ <doc xml:space="preserve"
24606+ filename="src/adw-navigation-view.c"
24607+ line="2833">tags of the pages in the
24608+ navigation stack</doc>
24609+ <array length="1" zero-terminated="0" c:type="const char* const*">
24610+ <type name="utf8"/>
24611+ </array>
24612+ </parameter>
24613+ <parameter name="n_tags" transfer-ownership="none">
24614+ <doc xml:space="preserve"
24615+ filename="src/adw-navigation-view.c"
24616+ line="2835">the number of tags</doc>
24617+ <type name="gint" c:type="int"/>
24618+ </parameter>
24619+ </parameters>
24620+ </method>
24621+ <method name="set_animate_transitions"
24622+ c:identifier="adw_navigation_view_set_animate_transitions"
24623+ glib:set-property="animate-transitions"
24624+ version="1.4">
24625+ <doc xml:space="preserve"
24626+ filename="src/adw-navigation-view.c"
24627+ line="2973">Sets whether @self should animate page transitions.
24628+
24629+Gesture-based transitions are always animated.</doc>
24630+ <source-position filename="src/adw-navigation-view.h" line="170"/>
24631+ <return-value transfer-ownership="none">
24632+ <type name="none" c:type="void"/>
24633+ </return-value>
24634+ <parameters>
24635+ <instance-parameter name="self" transfer-ownership="none">
24636+ <doc xml:space="preserve"
24637+ filename="src/adw-navigation-view.c"
24638+ line="2975">a navigation view</doc>
24639+ <type name="NavigationView" c:type="AdwNavigationView*"/>
24640+ </instance-parameter>
24641+ <parameter name="animate_transitions" transfer-ownership="none">
24642+ <doc xml:space="preserve"
24643+ filename="src/adw-navigation-view.c"
24644+ line="2976">whether to animate page transitions</doc>
24645+ <type name="gboolean" c:type="gboolean"/>
24646+ </parameter>
24647+ </parameters>
24648+ </method>
24649+ <method name="set_pop_on_escape"
24650+ c:identifier="adw_navigation_view_set_pop_on_escape"
24651+ glib:set-property="pop-on-escape"
24652+ version="1.4">
24653+ <doc xml:space="preserve"
24654+ filename="src/adw-navigation-view.c"
24655+ line="3018">Sets whether pressing Escape pops the current page on @self.
1110824656
11109-```xml
11110-&lt;object class="AdwHeaderBar"&gt;
11111- &lt;property name="title-widget"&gt;
11112- &lt;object class="AdwWindowTitle"&gt;
11113- &lt;property name="title" translatable="yes"&gt;Title&lt;/property&gt;
11114- &lt;/object&gt;
11115- &lt;/property&gt;
11116-&lt;/object&gt;
11117-```</doc>
11118- <source-position filename="src/adw-header-bar.h" line="60"/>
24657+Applications using `AdwNavigationView` to implement a browser may want to
24658+disable it.</doc>
24659+ <source-position filename="src/adw-navigation-view.h" line="176"/>
1111924660 <return-value transfer-ownership="none">
1112024661 <type name="none" c:type="void"/>
1112124662 </return-value>
1112224663 <parameters>
1112324664 <instance-parameter name="self" transfer-ownership="none">
1112424665 <doc xml:space="preserve"
11125- filename="src/adw-header-bar.c"
11126- line="638">a header bar</doc>
11127- <type name="HeaderBar" c:type="AdwHeaderBar*"/>
24666+ filename="src/adw-navigation-view.c"
24667+ line="3020">a navigation view</doc>
24668+ <type name="NavigationView" c:type="AdwNavigationView*"/>
1112824669 </instance-parameter>
11129- <parameter name="title_widget"
11130- transfer-ownership="none"
11131- nullable="1"
11132- allow-none="1">
24670+ <parameter name="pop_on_escape" transfer-ownership="none">
1113324671 <doc xml:space="preserve"
11134- filename="src/adw-header-bar.c"
11135- line="639">a widget to use for a title</doc>
11136- <type name="Gtk.Widget" c:type="GtkWidget*"/>
24672+ filename="src/adw-navigation-view.c"
24673+ line="3021">whether to pop the current page when pressing Escape</doc>
24674+ <type name="gboolean" c:type="gboolean"/>
1113724675 </parameter>
1113824676 </parameters>
1113924677 </method>
11140- <property name="centering-policy"
24678+ <property name="animate-transitions"
24679+ version="1.4"
1114124680 writable="1"
1114224681 transfer-ownership="none"
11143- setter="set_centering_policy"
11144- getter="get_centering_policy"
11145- default-value="ADW_CENTERING_POLICY_LOOSE">
11146- <attribute name="org.gtk.Property.get"
11147- value="adw_header_bar_get_centering_policy"/>
11148- <attribute name="org.gtk.Property.set"
11149- value="adw_header_bar_set_centering_policy"/>
24682+ setter="set_animate_transitions"
24683+ getter="get_animate_transitions"
24684+ default-value="TRUE">
1115024685 <doc xml:space="preserve"
11151- filename="src/adw-header-bar.c"
11152- line="461">The policy for aligning the center widget.</doc>
11153- <type name="CenteringPolicy"/>
24686+ filename="src/adw-navigation-view.c"
24687+ line="1704">Whether to animate page transitions.
24688+
24689+Gesture-based transitions are always animated.</doc>
24690+ <type name="gboolean" c:type="gboolean"/>
1115424691 </property>
11155- <property name="decoration-layout"
11156- writable="1"
24692+ <property name="navigation-stack"
24693+ version="1.4"
1115724694 transfer-ownership="none"
11158- setter="set_decoration_layout"
11159- getter="get_decoration_layout"
11160- default-value="NULL">
11161- <attribute name="org.gtk.Property.get"
11162- value="adw_header_bar_get_decoration_layout"/>
11163- <attribute name="org.gtk.Property.set"
11164- value="adw_header_bar_set_decoration_layout"/>
24695+ getter="get_navigation_stack">
1116524696 <doc xml:space="preserve"
11166- filename="src/adw-header-bar.c"
11167- line="440">The decoration layout for buttons.
11168-
11169-If this property is not set, the
11170-[property@Gtk.Settings:gtk-decoration-layout] setting is used.
24697+ filename="src/adw-navigation-view.c"
24698+ line="1733">A list model that contains the pages in navigation stack.
1117124699
11172-The format of the string is button names, separated by commas. A colon
11173-separates the buttons that should appear at the start from those at the
11174-end. Recognized button names are minimize, maximize, close and icon (the
11175-window icon).
24700+The pages are sorted from root page to visible page.
1117624701
11177-For example, “icon:minimize,maximize,close” specifies an icon at the start,
11178-and minimize, maximize and close buttons at the end.</doc>
11179- <type name="utf8" c:type="gchar*"/>
24702+This can be used to keep an up-to-date view.</doc>
24703+ <type name="Gio.ListModel"/>
1118024704 </property>
11181- <property name="show-end-title-buttons"
24705+ <property name="pop-on-escape"
24706+ version="1.4"
1118224707 writable="1"
1118324708 transfer-ownership="none"
11184- setter="set_show_end_title_buttons"
11185- getter="get_show_end_title_buttons"
24709+ setter="set_pop_on_escape"
24710+ getter="get_pop_on_escape"
1118624711 default-value="TRUE">
11187- <attribute name="org.gtk.Property.get"
11188- value="adw_header_bar_get_show_end_title_buttons"/>
11189- <attribute name="org.gtk.Property.set"
11190- value="adw_header_bar_set_show_end_title_buttons"/>
1119124712 <doc xml:space="preserve"
11192- filename="src/adw-header-bar.c"
11193- line="423">Whether to show title buttons at the end of the header bar.
24713+ filename="src/adw-navigation-view.c"
24714+ line="1718">Whether pressing Escape pops the current page.
1119424715
11195-See [property@HeaderBar:show-start-title-buttons] for the other side.
11196-
11197-Which buttons are actually shown and where is determined by the
11198-[property@HeaderBar:decoration-layout] property, and by the state of the
11199-window (e.g. a close button will not be shown if the window can't be
11200-closed).</doc>
24716+Applications using `AdwNavigationView` to implement a browser may want to
24717+disable it.</doc>
1120124718 <type name="gboolean" c:type="gboolean"/>
1120224719 </property>
11203- <property name="show-start-title-buttons"
11204- writable="1"
24720+ <property name="visible-page"
24721+ version="1.4"
1120524722 transfer-ownership="none"
11206- setter="set_show_start_title_buttons"
11207- getter="get_show_start_title_buttons"
11208- default-value="TRUE">
11209- <attribute name="org.gtk.Property.get"
11210- value="adw_header_bar_get_show_start_title_buttons"/>
11211- <attribute name="org.gtk.Property.set"
11212- value="adw_header_bar_set_show_start_title_buttons"/>
24723+ getter="get_visible_page">
1121324724 <doc xml:space="preserve"
11214- filename="src/adw-header-bar.c"
11215- line="406">Whether to show title buttons at the start of the header bar.
24725+ filename="src/adw-navigation-view.c"
24726+ line="1692">The currently visible page.</doc>
24727+ <type name="NavigationPage"/>
24728+ </property>
24729+ <glib:signal name="get-next-page" when="last" version="1.4">
24730+ <doc xml:space="preserve"
24731+ filename="src/adw-navigation-view.c"
24732+ line="1824">Emitted when a push shortcut or a gesture is triggered.
1121624733
11217-See [property@HeaderBar:show-end-title-buttons] for the other side.
24734+To support the push shortcuts and gestures, the application is expected to
24735+return the page to push in the handler.
1121824736
11219-Which buttons are actually shown and where is determined by the
11220-[property@HeaderBar:decoration-layout] property, and by the state of the
11221-window (e.g. a close button will not be shown if the window can't be
11222-closed).</doc>
11223- <type name="gboolean" c:type="gboolean"/>
11224- </property>
11225- <property name="title-widget"
11226- writable="1"
11227- transfer-ownership="none"
11228- setter="set_title_widget"
11229- getter="get_title_widget">
11230- <attribute name="org.gtk.Property.get"
11231- value="adw_header_bar_get_title_widget"/>
11232- <attribute name="org.gtk.Property.set"
11233- value="adw_header_bar_set_title_widget"/>
24737+This signal can be emitted multiple times for the gestures, for example
24738+when the gesture is cancelled by the user. As such, the application must
24739+not make any irreversible changes in the handler, such as removing the page
24740+from a forward stack.
24741+
24742+Instead, it should be done in the [signal@NavigationView::pushed] handler.</doc>
24743+ <return-value transfer-ownership="full" nullable="1">
24744+ <doc xml:space="preserve"
24745+ filename="src/adw-navigation-view.c"
24746+ line="1839">the page to push</doc>
24747+ <type name="NavigationPage"/>
24748+ </return-value>
24749+ </glib:signal>
24750+ <glib:signal name="popped" when="last" version="1.4">
1123424751 <doc xml:space="preserve"
11235- filename="src/adw-header-bar.c"
11236- line="381">The title widget to display.
24752+ filename="src/adw-navigation-view.c"
24753+ line="1773">Emitted after @page has been popped from the navigation stack.
1123724754
11238-When set to `NULL`, the header bar will display the title of the window it
11239-is contained in.
24755+See [method@NavigationView.pop].
1124024756
11241-To use a different title, use [class@WindowTitle]:
24757+When using [method@NavigationView.pop_to_page] or
24758+[method@NavigationView.pop_to_tag], this signal is emitted for each of the
24759+popped pages.</doc>
24760+ <return-value transfer-ownership="none">
24761+ <type name="none" c:type="void"/>
24762+ </return-value>
24763+ <parameters>
24764+ <parameter name="page" transfer-ownership="none">
24765+ <doc xml:space="preserve"
24766+ filename="src/adw-navigation-view.c"
24767+ line="1776">the popped page</doc>
24768+ <type name="NavigationPage"/>
24769+ </parameter>
24770+ </parameters>
24771+ </glib:signal>
24772+ <glib:signal name="pushed" when="last" version="1.4">
24773+ <doc xml:space="preserve"
24774+ filename="src/adw-navigation-view.c"
24775+ line="1751">Emitted after a page has been pushed to the navigation stack.
1124224776
11243-```xml
11244-&lt;object class="AdwHeaderBar"&gt;
11245- &lt;property name="title-widget"&gt;
11246- &lt;object class="AdwWindowTitle"&gt;
11247- &lt;property name="title" translatable="yes"&gt;Title&lt;/property&gt;
11248- &lt;/object&gt;
11249- &lt;/property&gt;
11250-&lt;/object&gt;
11251-```</doc>
11252- <type name="Gtk.Widget"/>
11253- </property>
24777+See [method@NavigationView.push].</doc>
24778+ <return-value transfer-ownership="none">
24779+ <type name="none" c:type="void"/>
24780+ </return-value>
24781+ </glib:signal>
24782+ <glib:signal name="replaced" when="last" version="1.4">
24783+ <doc xml:space="preserve"
24784+ filename="src/adw-navigation-view.c"
24785+ line="1802">Emitted after the navigation stack has been replaced.
24786+
24787+See [method@NavigationView.replace].</doc>
24788+ <return-value transfer-ownership="none">
24789+ <type name="none" c:type="void"/>
24790+ </return-value>
24791+ </glib:signal>
1125424792 </class>
11255- <record name="HeaderBarClass"
11256- c:type="AdwHeaderBarClass"
11257- glib:is-gtype-struct-for="HeaderBar">
11258- <source-position filename="src/adw-header-bar.h" line="37"/>
24793+ <record name="NavigationViewClass"
24794+ c:type="AdwNavigationViewClass"
24795+ glib:is-gtype-struct-for="NavigationView">
24796+ <source-position filename="src/adw-navigation-view.h" line="114"/>
1125924797 <field name="parent_class">
1126024798 <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
1126124799 </field>
1126224800 </record>
11263- <class name="Leaflet"
11264- c:symbol-prefix="leaflet"
11265- c:type="AdwLeaflet"
24801+ <class name="OverlaySplitView"
24802+ c:symbol-prefix="overlay_split_view"
24803+ c:type="AdwOverlaySplitView"
24804+ version="1.4"
1126624805 parent="Gtk.Widget"
1126724806 final="1"
11268- glib:type-name="AdwLeaflet"
11269- glib:get-type="adw_leaflet_get_type"
11270- glib:type-struct="LeafletClass">
24807+ glib:type-name="AdwOverlaySplitView"
24808+ glib:get-type="adw_overlay_split_view_get_type"
24809+ glib:type-struct="OverlaySplitViewClass">
1127124810 <doc xml:space="preserve"
11272- filename="src/adw-leaflet.c"
11273- line="21">An adaptive container acting like a box or a stack.
24811+ filename="src/adw-overlay-split-view.c"
24812+ line="23">A widget presenting sidebar and content side by side or as an overlay.
1127424813
1127524814 &lt;picture&gt;
11276- &lt;source srcset="leaflet-wide-dark.png" media="(prefers-color-scheme: dark)"&gt;
11277- &lt;img src="leaflet-wide.png" alt="leaflet-wide"&gt;
24815+ &lt;source srcset="overlay-split-view-dark.png" media="(prefers-color-scheme: dark)"&gt;
24816+ &lt;img src="overlay-split-view.png" alt="overlay-split-view"&gt;
1127824817 &lt;/picture&gt;
1127924818 &lt;picture&gt;
11280- &lt;source srcset="leaflet-narrow-dark.png" media="(prefers-color-scheme: dark)"&gt;
11281- &lt;img src="leaflet-narrow.png" alt="leaflet-narrow"&gt;
24819+ &lt;source srcset="overlay-split-view-collapsed-dark.png" media="(prefers-color-scheme: dark)"&gt;
24820+ &lt;img src="overlay-split-view-collapsed.png" alt="overlay-split-view-collapsed"&gt;
1128224821 &lt;/picture&gt;
1128324822
11284-The `AdwLeaflet` widget can display its children like a [class@Gtk.Box] does
11285-or like a [class@Gtk.Stack] does, adapting to size changes by switching
11286-between the two modes.
24823+`AdwOverlaySplitView` has two children: sidebar and content, and displays
24824+them side by side.
1128724825
11288-When there is enough space the children are displayed side by side, otherwise
11289-only one is displayed and the leaflet is said to be “folded”.
11290-The threshold is dictated by the preferred minimum sizes of the children.
11291-When a leaflet is folded, the children can be navigated using swipe gestures.
24826+When [property@OverlaySplitView:collapsed] is set to `TRUE`, the sidebar is
24827+instead shown as an overlay above the content widget.
1129224828
11293-The “over” and “under” transition types stack the children one on top of the
11294-other, while the “slide” transition puts the children side by side. While
11295-navigating to a child on the side or below can be performed by swiping the
11296-current child away, navigating to an upper child requires dragging it from
11297-the edge where it resides. This doesn't affect non-dragging swipes.
24829+The sidebar can be hidden or shown using the
24830+[property@OverlaySplitView:show-sidebar] property.
1129824831
11299-## CSS nodes
24832+Sidebar can be displayed before or after the content, this can be controlled
24833+with the [property@OverlaySplitView:sidebar-position] property.
1130024834
11301-`AdwLeaflet` has a single CSS node with name `leaflet`. The node will get the
11302-style classes `.folded` when it is folded, `.unfolded` when it's not, or none
11303-if it hasn't computed its fold yet.</doc>
11304- <source-position filename="src/adw-leaflet.h" line="46"/>
11305- <implements name="Swipeable"/>
11306- <implements name="Gtk.Accessible"/>
11307- <implements name="Gtk.Buildable"/>
11308- <implements name="Gtk.ConstraintTarget"/>
11309- <implements name="Gtk.Orientable"/>
11310- <constructor name="new" c:identifier="adw_leaflet_new">
11311- <doc xml:space="preserve"
11312- filename="src/adw-leaflet.c"
11313- line="2771">Creates a new `AdwLeaflet`.</doc>
11314- <source-position filename="src/adw-leaflet.h" line="55"/>
11315- <return-value transfer-ownership="none">
11316- <doc xml:space="preserve"
11317- filename="src/adw-leaflet.c"
11318- line="2776">the new created `AdwLeaflet`</doc>
11319- <type name="Gtk.Widget" c:type="GtkWidget*"/>
11320- </return-value>
11321- </constructor>
11322- <method name="append" c:identifier="adw_leaflet_append">
11323- <doc xml:space="preserve"
11324- filename="src/adw-leaflet.c"
11325- line="2784">Adds a child to @self.</doc>
11326- <source-position filename="src/adw-leaflet.h" line="58"/>
11327- <return-value transfer-ownership="none">
11328- <doc xml:space="preserve"
11329- filename="src/adw-leaflet.c"
11330- line="2791">the [class@LeafletPage] for @child</doc>
11331- <type name="LeafletPage" c:type="AdwLeafletPage*"/>
11332- </return-value>
11333- <parameters>
11334- <instance-parameter name="self" transfer-ownership="none">
11335- <doc xml:space="preserve"
11336- filename="src/adw-leaflet.c"
11337- line="2786">a leaflet</doc>
11338- <type name="Leaflet" c:type="AdwLeaflet*"/>
11339- </instance-parameter>
11340- <parameter name="child" transfer-ownership="none">
11341- <doc xml:space="preserve"
11342- filename="src/adw-leaflet.c"
11343- line="2787">the widget to add</doc>
11344- <type name="Gtk.Widget" c:type="GtkWidget*"/>
11345- </parameter>
11346- </parameters>
11347- </method>
11348- <method name="get_adjacent_child"
11349- c:identifier="adw_leaflet_get_adjacent_child">
11350- <doc xml:space="preserve"
11351- filename="src/adw-leaflet.c"
11352- line="3501">Finds the previous or next navigatable child.
24835+Collapsing the split view automatically hides the sidebar widget, and
24836+uncollapsing it shows the sidebar. If this behavior is not desired, the
24837+[property@OverlaySplitView:pin-sidebar] property can be used to override it.
1135324838
11354-This will be the same child [method@Leaflet.navigate] or swipe gestures will
11355-navigate to.
24839+`AdwOverlaySplitView` supports an edge swipe gesture for showing the sidebar,
24840+and a swipe from the sidebar for hiding it. Gestures are only supported on
24841+touchscreen, but not touchpad. Gestures can be controlled with the
24842+[property@OverlaySplitView:enable-show-gesture] and
24843+[property@OverlaySplitView:enable-hide-gesture] properties.
1135624844
11357-If there's no child to navigate to, `NULL` will be returned instead.
24845+See also [class@NavigationSplitView].
1135824846
11359-See [property@LeafletPage:navigatable].</doc>
11360- <source-position filename="src/adw-leaflet.h" line="148"/>
11361- <return-value transfer-ownership="none" nullable="1">
11362- <doc xml:space="preserve"
11363- filename="src/adw-leaflet.c"
11364- line="3515">the previous or next child</doc>
11365- <type name="Gtk.Widget" c:type="GtkWidget*"/>
11366- </return-value>
11367- <parameters>
11368- <instance-parameter name="self" transfer-ownership="none">
11369- <doc xml:space="preserve"
11370- filename="src/adw-leaflet.c"
11371- line="3503">a leaflet</doc>
11372- <type name="Leaflet" c:type="AdwLeaflet*"/>
11373- </instance-parameter>
11374- <parameter name="direction" transfer-ownership="none">
11375- <doc xml:space="preserve"
11376- filename="src/adw-leaflet.c"
11377- line="3504">the direction</doc>
11378- <type name="NavigationDirection" c:type="AdwNavigationDirection"/>
11379- </parameter>
11380- </parameters>
11381- </method>
11382- <method name="get_can_navigate_back"
11383- c:identifier="adw_leaflet_get_can_navigate_back"
11384- glib:get-property="can-navigate-back">
11385- <attribute name="org.gtk.Method.get_property"
11386- value="can-navigate-back"/>
11387- <doc xml:space="preserve"
11388- filename="src/adw-leaflet.c"
11389- line="3389">Gets whether gestures and shortcuts for navigating backward are enabled.</doc>
11390- <source-position filename="src/adw-leaflet.h" line="136"/>
11391- <return-value transfer-ownership="none">
11392- <doc xml:space="preserve"
11393- filename="src/adw-leaflet.c"
11394- line="3395">Whether gestures and shortcuts are enabled.</doc>
11395- <type name="gboolean" c:type="gboolean"/>
11396- </return-value>
11397- <parameters>
11398- <instance-parameter name="self" transfer-ownership="none">
11399- <doc xml:space="preserve"
11400- filename="src/adw-leaflet.c"
11401- line="3391">a leaflet</doc>
11402- <type name="Leaflet" c:type="AdwLeaflet*"/>
11403- </instance-parameter>
11404- </parameters>
11405- </method>
11406- <method name="get_can_navigate_forward"
11407- c:identifier="adw_leaflet_get_can_navigate_forward"
11408- glib:get-property="can-navigate-forward">
11409- <attribute name="org.gtk.Method.get_property"
11410- value="can-navigate-forward"/>
24847+`AdwOverlaySplitView` is typically used together with an [class@Breakpoint]
24848+setting the `collapsed` property to `TRUE` on small widths, as follows:
24849+
24850+```xml
24851+&lt;object class="AdwWindow"&gt;
24852+ &lt;property name="default-width"&gt;800&lt;/property&gt;
24853+ &lt;property name="default-height"&gt;800&lt;/property&gt;
24854+ &lt;child&gt;
24855+ &lt;object class="AdwBreakpoint"&gt;
24856+ &lt;condition&gt;max-width: 400sp&lt;/condition&gt;
24857+ &lt;setter object="split_view" property="collapsed"&gt;True&lt;/setter&gt;
24858+ &lt;/object&gt;
24859+ &lt;/child&gt;
24860+ &lt;property name="content"&gt;
24861+ &lt;object class="AdwOverlaySplitView" id="split_view"&gt;
24862+ &lt;property name="sidebar"&gt;
24863+ &lt;!-- ... --&gt;
24864+ &lt;/property&gt;
24865+ &lt;property name="content"&gt;
24866+ &lt;!-- ... --&gt;
24867+ &lt;/property&gt;
24868+ &lt;/object&gt;
24869+ &lt;/property&gt;
24870+&lt;/object&gt;
24871+```
24872+
24873+`AdwOverlaySplitView` is often used for implementing the
24874+[utility pane](https://developer.gnome.org/hig/patterns/containers/utility-panes.html)
24875+pattern.
24876+
24877+## Sizing
24878+
24879+When not collapsed, `AdwOverlaySplitView` changes the sidebar width
24880+depending on its own width.
24881+
24882+If possible, it tries to allocate a fraction of the total width, controlled
24883+with the [property@OverlaySplitView:sidebar-width-fraction] property.
24884+
24885+The sidebar also has minimum and maximum sizes, controlled with the
24886+[property@OverlaySplitView:min-sidebar-width] and
24887+[property@OverlaySplitView:max-sidebar-width] properties.
24888+
24889+The minimum and maximum sizes are using the length unit specified with the
24890+[property@OverlaySplitView:sidebar-width-unit].
24891+
24892+By default, sidebar is using 25% of the total width, with 180sp as the
24893+minimum size and 280sp as the maximum size.
24894+
24895+When collapsed, the preferred width fraction is ignored and the sidebar uses
24896+[property@OverlaySplitView:max-sidebar-width] when possible.
24897+
24898+## Header Bar Integration
24899+
24900+When used inside `AdwOverlaySplitView`, [class@HeaderBar] will automatically
24901+hide the window buttons in the middle.
24902+
24903+## `AdwOverlaySplitView` as `GtkBuildable`
24904+
24905+The `AdwOverlaySplitView` implementation of the [iface@Gtk.Buildable]
24906+interface supports setting the sidebar widget by specifying “sidebar” as the
24907+“type” attribute of a `&lt;child&gt;` element, Specifying “content” child type or
24908+omitting it results in setting the content widget.
24909+
24910+## CSS nodes
24911+
24912+`AdwOverlaySplitView` has a single CSS node with the name
24913+`overlay-split-view`.
24914+
24915+It contains two nodes with the name `widget`, containing the sidebar and
24916+content children.
24917+
24918+When not collapsed, they have the `.sidebar-view` and `.content-view` style
24919+classes respectively.
24920+
24921+```
24922+overlay-split-view
24923+├── widget.sidebar-pane
24924+│ ╰── [sidebar child]
24925+╰── widget.content-pane
24926+ ╰── [content child]
24927+```
24928+
24929+When collapsed, the one containing the sidebar child has the `.background`
24930+style class and the other one has no style classes.
24931+
24932+```
24933+overlay-split-view
24934+├── widget.background
24935+│ ╰── [sidebar child]
24936+╰── widget
24937+ ╰── [content child]
24938+```
24939+
24940+## Accessibility
24941+
24942+`AdwOverlaySplitView` uses the `GTK_ACCESSIBLE_ROLE_GROUP` role.</doc>
24943+ <source-position filename="src/adw-overlay-split-view.h" line="25"/>
24944+ <implements name="Swipeable"/>
24945+ <implements name="Gtk.Accessible"/>
24946+ <implements name="Gtk.Buildable"/>
24947+ <implements name="Gtk.ConstraintTarget"/>
24948+ <constructor name="new"
24949+ c:identifier="adw_overlay_split_view_new"
24950+ version="1.4">
1141124951 <doc xml:space="preserve"
11412- filename="src/adw-leaflet.c"
11413- line="3445">Gets whether gestures and shortcuts for navigating forward are enabled.</doc>
11414- <source-position filename="src/adw-leaflet.h" line="142"/>
24952+ filename="src/adw-overlay-split-view.c"
24953+ line="1264">Creates a new `AdwOverlaySplitView`.</doc>
24954+ <source-position filename="src/adw-overlay-split-view.h" line="28"/>
1141524955 <return-value transfer-ownership="none">
1141624956 <doc xml:space="preserve"
11417- filename="src/adw-leaflet.c"
11418- line="3451">Whether gestures and shortcuts are enabled.</doc>
11419- <type name="gboolean" c:type="gboolean"/>
24957+ filename="src/adw-overlay-split-view.c"
24958+ line="1269">the newly created `AdwOverlaySplitView`</doc>
24959+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
1142024960 </return-value>
11421- <parameters>
11422- <instance-parameter name="self" transfer-ownership="none">
11423- <doc xml:space="preserve"
11424- filename="src/adw-leaflet.c"
11425- line="3447">a leaflet</doc>
11426- <type name="Leaflet" c:type="AdwLeaflet*"/>
11427- </instance-parameter>
11428- </parameters>
11429- </method>
11430- <method name="get_can_unfold"
11431- c:identifier="adw_leaflet_get_can_unfold"
11432- glib:get-property="can-unfold">
11433- <attribute name="org.gtk.Method.get_property" value="can-unfold"/>
24961+ </constructor>
24962+ <method name="get_collapsed"
24963+ c:identifier="adw_overlay_split_view_get_collapsed"
24964+ glib:get-property="collapsed"
24965+ version="1.4">
1143424966 <doc xml:space="preserve"
11435- filename="src/adw-leaflet.c"
11436- line="3011">Gets whether @self can unfold.</doc>
11437- <source-position filename="src/adw-leaflet.h" line="82"/>
24967+ filename="src/adw-overlay-split-view.c"
24968+ line="1371">Gets whether @self is collapsed.</doc>
24969+ <source-position filename="src/adw-overlay-split-view.h" line="43"/>
1143824970 <return-value transfer-ownership="none">
1143924971 <doc xml:space="preserve"
11440- filename="src/adw-leaflet.c"
11441- line="3017">whether @self can unfold</doc>
24972+ filename="src/adw-overlay-split-view.c"
24973+ line="1377">whether @self is collapsed</doc>
1144224974 <type name="gboolean" c:type="gboolean"/>
1144324975 </return-value>
1144424976 <parameters>
1144524977 <instance-parameter name="self" transfer-ownership="none">
1144624978 <doc xml:space="preserve"
11447- filename="src/adw-leaflet.c"
11448- line="3013">a leaflet</doc>
11449- <type name="Leaflet" c:type="AdwLeaflet*"/>
24979+ filename="src/adw-overlay-split-view.c"
24980+ line="1373">an overlay split view</doc>
24981+ <type name="OverlaySplitView" c:type="AdwOverlaySplitView*"/>
1145024982 </instance-parameter>
1145124983 </parameters>
1145224984 </method>
11453- <method name="get_child_by_name"
11454- c:identifier="adw_leaflet_get_child_by_name">
24985+ <method name="get_content"
24986+ c:identifier="adw_overlay_split_view_get_content"
24987+ glib:get-property="content"
24988+ version="1.4">
1145524989 <doc xml:space="preserve"
11456- filename="src/adw-leaflet.c"
11457- line="3565">Finds the child of @self with @name.
11458-
11459-Returns `NULL` if there is no child with this name.
11460-
11461-See [property@LeafletPage:name].</doc>
11462- <source-position filename="src/adw-leaflet.h" line="155"/>
24990+ filename="src/adw-overlay-split-view.c"
24991+ line="1326">Gets the content widget for @self.</doc>
24992+ <source-position filename="src/adw-overlay-split-view.h" line="37"/>
1146324993 <return-value transfer-ownership="none" nullable="1">
1146424994 <doc xml:space="preserve"
11465- filename="src/adw-leaflet.c"
11466- line="3576">the requested child of @self</doc>
24995+ filename="src/adw-overlay-split-view.c"
24996+ line="1332">the content widget for @self</doc>
1146724997 <type name="Gtk.Widget" c:type="GtkWidget*"/>
1146824998 </return-value>
1146924999 <parameters>
1147025000 <instance-parameter name="self" transfer-ownership="none">
1147125001 <doc xml:space="preserve"
11472- filename="src/adw-leaflet.c"
11473- line="3567">a leaflet</doc>
11474- <type name="Leaflet" c:type="AdwLeaflet*"/>
11475- </instance-parameter>
11476- <parameter name="name" transfer-ownership="none">
11477- <doc xml:space="preserve"
11478- filename="src/adw-leaflet.c"
11479- line="3568">the name of the child to find</doc>
11480- <type name="utf8" c:type="const char*"/>
11481- </parameter>
11482- </parameters>
11483- </method>
11484- <method name="get_child_transition_params"
11485- c:identifier="adw_leaflet_get_child_transition_params"
11486- glib:get-property="child-transition-params">
11487- <attribute name="org.gtk.Method.get_property"
11488- value="child-transition-params"/>
11489- <doc xml:space="preserve"
11490- filename="src/adw-leaflet.c"
11491- line="3328">Gets the child transition spring parameters for @self.</doc>
11492- <source-position filename="src/adw-leaflet.h" line="127"/>
11493- <return-value transfer-ownership="full">
11494- <doc xml:space="preserve"
11495- filename="src/adw-leaflet.c"
11496- line="3334">the child transition parameters</doc>
11497- <type name="SpringParams" c:type="AdwSpringParams*"/>
11498- </return-value>
11499- <parameters>
11500- <instance-parameter name="self" transfer-ownership="none">
11501- <doc xml:space="preserve"
11502- filename="src/adw-leaflet.c"
11503- line="3330">a leaflet</doc>
11504- <type name="Leaflet" c:type="AdwLeaflet*"/>
25002+ filename="src/adw-overlay-split-view.c"
25003+ line="1328">an overlay split view</doc>
25004+ <type name="OverlaySplitView" c:type="AdwOverlaySplitView*"/>
1150525005 </instance-parameter>
1150625006 </parameters>
1150725007 </method>
11508- <method name="get_child_transition_running"
11509- c:identifier="adw_leaflet_get_child_transition_running"
11510- glib:get-property="child-transition-running">
11511- <attribute name="org.gtk.Method.get_property"
11512- value="child-transition-running"/>
25008+ <method name="get_enable_hide_gesture"
25009+ c:identifier="adw_overlay_split_view_get_enable_hide_gesture"
25010+ glib:get-property="enable-hide-gesture"
25011+ version="1.4">
1151325012 <doc xml:space="preserve"
11514- filename="src/adw-leaflet.c"
11515- line="3373">Gets whether a child transition is currently running for @self.</doc>
11516- <source-position filename="src/adw-leaflet.h" line="133"/>
25013+ filename="src/adw-overlay-split-view.c"
25014+ line="1630">Gets whether @self can be closed with a swipe gesture.</doc>
25015+ <source-position filename="src/adw-overlay-split-view.h" line="73"/>
1151725016 <return-value transfer-ownership="none">
1151825017 <doc xml:space="preserve"
11519- filename="src/adw-leaflet.c"
11520- line="3379">whether a transition is currently running</doc>
25018+ filename="src/adw-overlay-split-view.c"
25019+ line="1636">`TRUE` if @self can be closed with a swipe gesture</doc>
1152125020 <type name="gboolean" c:type="gboolean"/>
1152225021 </return-value>
1152325022 <parameters>
1152425023 <instance-parameter name="self" transfer-ownership="none">
1152525024 <doc xml:space="preserve"
11526- filename="src/adw-leaflet.c"
11527- line="3375">a leaflet</doc>
11528- <type name="Leaflet" c:type="AdwLeaflet*"/>
11529- </instance-parameter>
11530- </parameters>
11531- </method>
11532- <method name="get_fold_threshold_policy"
11533- c:identifier="adw_leaflet_get_fold_threshold_policy"
11534- glib:get-property="fold-threshold-policy">
11535- <attribute name="org.gtk.Method.get_property"
11536- value="fold-threshold-policy"/>
11537- <doc xml:space="preserve"
11538- filename="src/adw-leaflet.c"
11539- line="3047">Gets the fold threshold policy for @self.</doc>
11540- <source-position filename="src/adw-leaflet.h" line="91"/>
11541- <return-value transfer-ownership="none">
11542- <type name="FoldThresholdPolicy" c:type="AdwFoldThresholdPolicy"/>
11543- </return-value>
11544- <parameters>
11545- <instance-parameter name="self" transfer-ownership="none">
11546- <doc xml:space="preserve"
11547- filename="src/adw-leaflet.c"
11548- line="3049">a leaflet</doc>
11549- <type name="Leaflet" c:type="AdwLeaflet*"/>
25025+ filename="src/adw-overlay-split-view.c"
25026+ line="1632">an overlay split view</doc>
25027+ <type name="OverlaySplitView" c:type="AdwOverlaySplitView*"/>
1155025028 </instance-parameter>
1155125029 </parameters>
1155225030 </method>
11553- <method name="get_folded"
11554- c:identifier="adw_leaflet_get_folded"
11555- glib:get-property="folded">
11556- <attribute name="org.gtk.Method.get_property" value="folded"/>
25031+ <method name="get_enable_show_gesture"
25032+ c:identifier="adw_overlay_split_view_get_enable_show_gesture"
25033+ glib:get-property="enable-show-gesture"
25034+ version="1.4">
1155725035 <doc xml:space="preserve"
11558- filename="src/adw-leaflet.c"
11559- line="3027">Gets whether @self is folded.
11560-
11561-The leaflet will be folded if the size allocated to it is smaller than the
11562-sum of the minimum or natural sizes of the children (see
11563-[property@Leaflet:fold-threshold-policy]), it will be unfolded otherwise.</doc>
11564- <source-position filename="src/adw-leaflet.h" line="88"/>
25036+ filename="src/adw-overlay-split-view.c"
25037+ line="1583">Gets whether @self can be opened with an edge swipe gesture.</doc>
25038+ <source-position filename="src/adw-overlay-split-view.h" line="67"/>
1156525039 <return-value transfer-ownership="none">
1156625040 <doc xml:space="preserve"
11567- filename="src/adw-leaflet.c"
11568- line="3037">whether @self is folded.</doc>
25041+ filename="src/adw-overlay-split-view.c"
25042+ line="1589">`TRUE` if @self can be opened with a swipe gesture</doc>
1156925043 <type name="gboolean" c:type="gboolean"/>
1157025044 </return-value>
1157125045 <parameters>
1157225046 <instance-parameter name="self" transfer-ownership="none">
1157325047 <doc xml:space="preserve"
11574- filename="src/adw-leaflet.c"
11575- line="3029">a leaflet</doc>
11576- <type name="Leaflet" c:type="AdwLeaflet*"/>
25048+ filename="src/adw-overlay-split-view.c"
25049+ line="1585">an overlay split view</doc>
25050+ <type name="OverlaySplitView" c:type="AdwOverlaySplitView*"/>
1157725051 </instance-parameter>
1157825052 </parameters>
1157925053 </method>
11580- <method name="get_homogeneous"
11581- c:identifier="adw_leaflet_get_homogeneous"
11582- glib:get-property="homogeneous">
11583- <attribute name="org.gtk.Method.get_property" value="homogeneous"/>
25054+ <method name="get_max_sidebar_width"
25055+ c:identifier="adw_overlay_split_view_get_max_sidebar_width"
25056+ glib:get-property="max-sidebar-width"
25057+ version="1.4">
1158425058 <doc xml:space="preserve"
11585- filename="src/adw-leaflet.c"
11586- line="3093">Gets whether @self is homogeneous.</doc>
11587- <source-position filename="src/adw-leaflet.h" line="97"/>
25059+ filename="src/adw-overlay-split-view.c"
25060+ line="1725">Gets the maximum sidebar width for @self.</doc>
25061+ <source-position filename="src/adw-overlay-split-view.h" line="85"/>
1158825062 <return-value transfer-ownership="none">
1158925063 <doc xml:space="preserve"
11590- filename="src/adw-leaflet.c"
11591- line="3099">whether @self is homogeneous</doc>
11592- <type name="gboolean" c:type="gboolean"/>
25064+ filename="src/adw-overlay-split-view.c"
25065+ line="1731">the maximum width</doc>
25066+ <type name="gdouble" c:type="double"/>
1159325067 </return-value>
1159425068 <parameters>
1159525069 <instance-parameter name="self" transfer-ownership="none">
1159625070 <doc xml:space="preserve"
11597- filename="src/adw-leaflet.c"
11598- line="3095">a leaflet</doc>
11599- <type name="Leaflet" c:type="AdwLeaflet*"/>
25071+ filename="src/adw-overlay-split-view.c"
25072+ line="1727">an overlay split view</doc>
25073+ <type name="OverlaySplitView" c:type="AdwOverlaySplitView*"/>
1160025074 </instance-parameter>
1160125075 </parameters>
1160225076 </method>
11603- <method name="get_mode_transition_duration"
11604- c:identifier="adw_leaflet_get_mode_transition_duration"
11605- glib:get-property="mode-transition-duration">
11606- <attribute name="org.gtk.Method.get_property"
11607- value="mode-transition-duration"/>
25077+ <method name="get_min_sidebar_width"
25078+ c:identifier="adw_overlay_split_view_get_min_sidebar_width"
25079+ glib:get-property="min-sidebar-width"
25080+ version="1.4">
1160825081 <doc xml:space="preserve"
11609- filename="src/adw-leaflet.c"
11610- line="3287">Gets the mode transition animation duration for @self.</doc>
11611- <source-position filename="src/adw-leaflet.h" line="121"/>
25082+ filename="src/adw-overlay-split-view.c"
25083+ line="1677">Gets the minimum sidebar width for @self.</doc>
25084+ <source-position filename="src/adw-overlay-split-view.h" line="79"/>
1161225085 <return-value transfer-ownership="none">
1161325086 <doc xml:space="preserve"
11614- filename="src/adw-leaflet.c"
11615- line="3293">the mode transition duration, in milliseconds.</doc>
11616- <type name="guint" c:type="guint"/>
25087+ filename="src/adw-overlay-split-view.c"
25088+ line="1683">the minimum width</doc>
25089+ <type name="gdouble" c:type="double"/>
1161725090 </return-value>
1161825091 <parameters>
1161925092 <instance-parameter name="self" transfer-ownership="none">
1162025093 <doc xml:space="preserve"
11621- filename="src/adw-leaflet.c"
11622- line="3289">a leaflet</doc>
11623- <type name="Leaflet" c:type="AdwLeaflet*"/>
25094+ filename="src/adw-overlay-split-view.c"
25095+ line="1679">an overlay split view</doc>
25096+ <type name="OverlaySplitView" c:type="AdwOverlaySplitView*"/>
1162425097 </instance-parameter>
1162525098 </parameters>
1162625099 </method>
11627- <method name="get_page" c:identifier="adw_leaflet_get_page">
25100+ <method name="get_pin_sidebar"
25101+ c:identifier="adw_overlay_split_view_get_pin_sidebar"
25102+ glib:get-property="pin-sidebar"
25103+ version="1.4">
1162825104 <doc xml:space="preserve"
11629- filename="src/adw-leaflet.c"
11630- line="2967">Returns the [class@LeafletPage] object for @child.</doc>
11631- <source-position filename="src/adw-leaflet.h" line="78"/>
25105+ filename="src/adw-overlay-split-view.c"
25106+ line="1536">Gets whether the sidebar widget is pinned for @self.</doc>
25107+ <source-position filename="src/adw-overlay-split-view.h" line="61"/>
1163225108 <return-value transfer-ownership="none">
1163325109 <doc xml:space="preserve"
11634- filename="src/adw-leaflet.c"
11635- line="2974">the page object for @child</doc>
11636- <type name="LeafletPage" c:type="AdwLeafletPage*"/>
11637- </return-value>
11638- <parameters>
11639- <instance-parameter name="self" transfer-ownership="none">
11640- <doc xml:space="preserve"
11641- filename="src/adw-leaflet.c"
11642- line="2969">a leaflet</doc>
11643- <type name="Leaflet" c:type="AdwLeaflet*"/>
11644- </instance-parameter>
11645- <parameter name="child" transfer-ownership="none">
11646- <doc xml:space="preserve"
11647- filename="src/adw-leaflet.c"
11648- line="2970">a child of @self</doc>
11649- <type name="Gtk.Widget" c:type="GtkWidget*"/>
11650- </parameter>
11651- </parameters>
11652- </method>
11653- <method name="get_pages"
11654- c:identifier="adw_leaflet_get_pages"
11655- glib:get-property="pages">
11656- <attribute name="org.gtk.Method.get_property" value="pages"/>
11657- <doc xml:space="preserve"
11658- filename="src/adw-leaflet.c"
11659- line="3592">Returns a [iface@Gio.ListModel] that contains the pages of the leaflet.
11660-
11661-This can be used to keep an up-to-date view. The model also implements
11662-[iface@Gtk.SelectionModel] and can be used to track and change the visible
11663-page.</doc>
11664- <source-position filename="src/adw-leaflet.h" line="159"/>
11665- <return-value transfer-ownership="full">
11666- <doc xml:space="preserve"
11667- filename="src/adw-leaflet.c"
11668- line="3602">a `GtkSelectionModel` for the leaflet's children</doc>
11669- <type name="Gtk.SelectionModel" c:type="GtkSelectionModel*"/>
25110+ filename="src/adw-overlay-split-view.c"
25111+ line="1542">whether if the sidebar widget is pinned</doc>
25112+ <type name="gboolean" c:type="gboolean"/>
1167025113 </return-value>
1167125114 <parameters>
1167225115 <instance-parameter name="self" transfer-ownership="none">
1167325116 <doc xml:space="preserve"
11674- filename="src/adw-leaflet.c"
11675- line="3594">a leaflet</doc>
11676- <type name="Leaflet" c:type="AdwLeaflet*"/>
25117+ filename="src/adw-overlay-split-view.c"
25118+ line="1538">an overlay split view</doc>
25119+ <type name="OverlaySplitView" c:type="AdwOverlaySplitView*"/>
1167725120 </instance-parameter>
1167825121 </parameters>
1167925122 </method>
11680- <method name="get_transition_type"
11681- c:identifier="adw_leaflet_get_transition_type"
11682- glib:get-property="transition-type">
11683- <attribute name="org.gtk.Method.get_property" value="transition-type"/>
25123+ <method name="get_show_sidebar"
25124+ c:identifier="adw_overlay_split_view_get_show_sidebar"
25125+ glib:get-property="show-sidebar"
25126+ version="1.4">
1168425127 <doc xml:space="preserve"
11685- filename="src/adw-leaflet.c"
11686- line="3233">Gets the type of animation used for transitions between modes and children.</doc>
11687- <source-position filename="src/adw-leaflet.h" line="115"/>
25128+ filename="src/adw-overlay-split-view.c"
25129+ line="1500">Gets whether the sidebar widget is shown for @self.</doc>
25130+ <source-position filename="src/adw-overlay-split-view.h" line="55"/>
1168825131 <return-value transfer-ownership="none">
1168925132 <doc xml:space="preserve"
11690- filename="src/adw-leaflet.c"
11691- line="3239">the current transition type of @self</doc>
11692- <type name="LeafletTransitionType"
11693- c:type="AdwLeafletTransitionType"/>
25133+ filename="src/adw-overlay-split-view.c"
25134+ line="1506">`TRUE` if the sidebar widget is shown</doc>
25135+ <type name="gboolean" c:type="gboolean"/>
1169425136 </return-value>
1169525137 <parameters>
1169625138 <instance-parameter name="self" transfer-ownership="none">
1169725139 <doc xml:space="preserve"
11698- filename="src/adw-leaflet.c"
11699- line="3235">a leaflet</doc>
11700- <type name="Leaflet" c:type="AdwLeaflet*"/>
25140+ filename="src/adw-overlay-split-view.c"
25141+ line="1502">an overlay split view</doc>
25142+ <type name="OverlaySplitView" c:type="AdwOverlaySplitView*"/>
1170125143 </instance-parameter>
1170225144 </parameters>
1170325145 </method>
11704- <method name="get_visible_child"
11705- c:identifier="adw_leaflet_get_visible_child"
11706- glib:get-property="visible-child">
11707- <attribute name="org.gtk.Method.get_property" value="visible-child"/>
25146+ <method name="get_sidebar"
25147+ c:identifier="adw_overlay_split_view_get_sidebar"
25148+ glib:get-property="sidebar"
25149+ version="1.4">
1170825150 <doc xml:space="preserve"
11709- filename="src/adw-leaflet.c"
11710- line="3137">Gets the widget currently visible when the leaflet is folded.</doc>
11711- <source-position filename="src/adw-leaflet.h" line="103"/>
25151+ filename="src/adw-overlay-split-view.c"
25152+ line="1279">Gets the sidebar widget for @self.</doc>
25153+ <source-position filename="src/adw-overlay-split-view.h" line="31"/>
1171225154 <return-value transfer-ownership="none" nullable="1">
1171325155 <doc xml:space="preserve"
11714- filename="src/adw-leaflet.c"
11715- line="3143">the visible child</doc>
25156+ filename="src/adw-overlay-split-view.c"
25157+ line="1285">the sidebar widget for @self</doc>
1171625158 <type name="Gtk.Widget" c:type="GtkWidget*"/>
1171725159 </return-value>
1171825160 <parameters>
1171925161 <instance-parameter name="self" transfer-ownership="none">
1172025162 <doc xml:space="preserve"
11721- filename="src/adw-leaflet.c"
11722- line="3139">a leaflet</doc>
11723- <type name="Leaflet" c:type="AdwLeaflet*"/>
11724- </instance-parameter>
11725- </parameters>
11726- </method>
11727- <method name="get_visible_child_name"
11728- c:identifier="adw_leaflet_get_visible_child_name"
11729- glib:get-property="visible-child-name">
11730- <attribute name="org.gtk.Method.get_property"
11731- value="visible-child-name"/>
11732- <doc xml:space="preserve"
11733- filename="src/adw-leaflet.c"
11734- line="3187">Gets the name of the currently visible child widget.</doc>
11735- <source-position filename="src/adw-leaflet.h" line="109"/>
11736- <return-value transfer-ownership="none" nullable="1">
11737- <doc xml:space="preserve"
11738- filename="src/adw-leaflet.c"
11739- line="3193">the name of the visible child</doc>
11740- <type name="utf8" c:type="const char*"/>
11741- </return-value>
11742- <parameters>
11743- <instance-parameter name="self" transfer-ownership="none">
11744- <doc xml:space="preserve"
11745- filename="src/adw-leaflet.c"
11746- line="3189">a leaflet</doc>
11747- <type name="Leaflet" c:type="AdwLeaflet*"/>
25163+ filename="src/adw-overlay-split-view.c"
25164+ line="1281">an overlay split view</doc>
25165+ <type name="OverlaySplitView" c:type="AdwOverlaySplitView*"/>
1174825166 </instance-parameter>
1174925167 </parameters>
1175025168 </method>
11751- <method name="insert_child_after"
11752- c:identifier="adw_leaflet_insert_child_after">
25169+ <method name="get_sidebar_position"
25170+ c:identifier="adw_overlay_split_view_get_sidebar_position"
25171+ glib:get-property="sidebar-position"
25172+ version="1.4">
1175325173 <doc xml:space="preserve"
11754- filename="src/adw-leaflet.c"
11755- line="2831">Inserts @child in the position after @sibling in the list of children.
11756-
11757-If @sibling is `NULL`, inserts @child at the first position.</doc>
11758- <source-position filename="src/adw-leaflet.h" line="65"/>
25174+ filename="src/adw-overlay-split-view.c"
25175+ line="1445">Gets the sidebar position for @self.</doc>
25176+ <source-position filename="src/adw-overlay-split-view.h" line="49"/>
1175925177 <return-value transfer-ownership="none">
1176025178 <doc xml:space="preserve"
11761- filename="src/adw-leaflet.c"
11762- line="2841">the [class@LeafletPage] for @child</doc>
11763- <type name="LeafletPage" c:type="AdwLeafletPage*"/>
25179+ filename="src/adw-overlay-split-view.c"
25180+ line="1451">the sidebar position for @self</doc>
25181+ <type name="Gtk.PackType" c:type="GtkPackType"/>
1176425182 </return-value>
1176525183 <parameters>
1176625184 <instance-parameter name="self" transfer-ownership="none">
1176725185 <doc xml:space="preserve"
11768- filename="src/adw-leaflet.c"
11769- line="2833">a leaflet</doc>
11770- <type name="Leaflet" c:type="AdwLeaflet*"/>
25186+ filename="src/adw-overlay-split-view.c"
25187+ line="1447">an overlay split view</doc>
25188+ <type name="OverlaySplitView" c:type="AdwOverlaySplitView*"/>
1177125189 </instance-parameter>
11772- <parameter name="child" transfer-ownership="none">
11773- <doc xml:space="preserve"
11774- filename="src/adw-leaflet.c"
11775- line="2834">the widget to insert</doc>
11776- <type name="Gtk.Widget" c:type="GtkWidget*"/>
11777- </parameter>
11778- <parameter name="sibling"
11779- transfer-ownership="none"
11780- nullable="1"
11781- allow-none="1">
11782- <doc xml:space="preserve"
11783- filename="src/adw-leaflet.c"
11784- line="2835">the sibling after which to insert @child</doc>
11785- <type name="Gtk.Widget" c:type="GtkWidget*"/>
11786- </parameter>
1178725190 </parameters>
1178825191 </method>
11789- <method name="navigate" c:identifier="adw_leaflet_navigate">
25192+ <method name="get_sidebar_width_fraction"
25193+ c:identifier="adw_overlay_split_view_get_sidebar_width_fraction"
25194+ glib:get-property="sidebar-width-fraction"
25195+ version="1.4">
1179025196 <doc xml:space="preserve"
11791- filename="src/adw-leaflet.c"
11792- line="3530">Navigates to the previous or next child.
11793-
11794-The child must have the [property@LeafletPage:navigatable] property set to
11795-`TRUE`, otherwise it will be skipped.
11796-
11797-This will be the same child as returned by
11798-[method@Leaflet.get_adjacent_child] or navigated to via swipe gestures.</doc>
11799- <source-position filename="src/adw-leaflet.h" line="151"/>
25197+ filename="src/adw-overlay-split-view.c"
25198+ line="1773">Gets the preferred sidebar width fraction for @self.</doc>
25199+ <source-position filename="src/adw-overlay-split-view.h" line="91"/>
1180025200 <return-value transfer-ownership="none">
1180125201 <doc xml:space="preserve"
11802- filename="src/adw-leaflet.c"
11803- line="3543">whether the visible child was changed</doc>
11804- <type name="gboolean" c:type="gboolean"/>
25202+ filename="src/adw-overlay-split-view.c"
25203+ line="1779">the preferred width fraction</doc>
25204+ <type name="gdouble" c:type="double"/>
1180525205 </return-value>
1180625206 <parameters>
1180725207 <instance-parameter name="self" transfer-ownership="none">
1180825208 <doc xml:space="preserve"
11809- filename="src/adw-leaflet.c"
11810- line="3532">a leaflet</doc>
11811- <type name="Leaflet" c:type="AdwLeaflet*"/>
25209+ filename="src/adw-overlay-split-view.c"
25210+ line="1775">an overlay split view</doc>
25211+ <type name="OverlaySplitView" c:type="AdwOverlaySplitView*"/>
1181225212 </instance-parameter>
11813- <parameter name="direction" transfer-ownership="none">
11814- <doc xml:space="preserve"
11815- filename="src/adw-leaflet.c"
11816- line="3533">the direction</doc>
11817- <type name="NavigationDirection" c:type="AdwNavigationDirection"/>
11818- </parameter>
1181925213 </parameters>
1182025214 </method>
11821- <method name="prepend" c:identifier="adw_leaflet_prepend">
25215+ <method name="get_sidebar_width_unit"
25216+ c:identifier="adw_overlay_split_view_get_sidebar_width_unit"
25217+ glib:get-property="sidebar-width-unit"
25218+ version="1.4">
1182225219 <doc xml:space="preserve"
11823- filename="src/adw-leaflet.c"
11824- line="2811">Inserts @child at the first position in @self.</doc>
11825- <source-position filename="src/adw-leaflet.h" line="61"/>
25220+ filename="src/adw-overlay-split-view.c"
25221+ line="1824">Gets the length unit for minimum and maximum sidebar widths.</doc>
25222+ <source-position filename="src/adw-overlay-split-view.h" line="97"/>
1182625223 <return-value transfer-ownership="none">
1182725224 <doc xml:space="preserve"
11828- filename="src/adw-leaflet.c"
11829- line="2818">the [class@LeafletPage] for @child</doc>
11830- <type name="LeafletPage" c:type="AdwLeafletPage*"/>
25225+ filename="src/adw-overlay-split-view.c"
25226+ line="1830">the length unit</doc>
25227+ <type name="LengthUnit" c:type="AdwLengthUnit"/>
1183125228 </return-value>
1183225229 <parameters>
11833- <instance-parameter name="self" transfer-ownership="none">
11834- <doc xml:space="preserve"
11835- filename="src/adw-leaflet.c"
11836- line="2813">a leaflet</doc>
11837- <type name="Leaflet" c:type="AdwLeaflet*"/>
11838- </instance-parameter>
11839- <parameter name="child" transfer-ownership="none">
25230+ <instance-parameter name="self" transfer-ownership="none">
1184025231 <doc xml:space="preserve"
11841- filename="src/adw-leaflet.c"
11842- line="2814">the widget to prepend</doc>
11843- <type name="Gtk.Widget" c:type="GtkWidget*"/>
11844- </parameter>
25232+ filename="src/adw-overlay-split-view.c"
25233+ line="1826">an overlay split view</doc>
25234+ <type name="OverlaySplitView" c:type="AdwOverlaySplitView*"/>
25235+ </instance-parameter>
1184525236 </parameters>
1184625237 </method>
11847- <method name="remove" c:identifier="adw_leaflet_remove">
25238+ <method name="set_collapsed"
25239+ c:identifier="adw_overlay_split_view_set_collapsed"
25240+ glib:set-property="collapsed"
25241+ version="1.4">
1184825242 <doc xml:space="preserve"
11849- filename="src/adw-leaflet.c"
11850- line="2936">Removes a child widget from @self.</doc>
11851- <source-position filename="src/adw-leaflet.h" line="74"/>
25243+ filename="src/adw-overlay-split-view.c"
25244+ line="1389">Sets whether @self view is collapsed.
25245+
25246+When collapsed, the sidebar widget is presented as an overlay above the
25247+content widget, otherwise they are displayed side by side.</doc>
25248+ <source-position filename="src/adw-overlay-split-view.h" line="45"/>
1185225249 <return-value transfer-ownership="none">
1185325250 <type name="none" c:type="void"/>
1185425251 </return-value>
1185525252 <parameters>
1185625253 <instance-parameter name="self" transfer-ownership="none">
1185725254 <doc xml:space="preserve"
11858- filename="src/adw-leaflet.c"
11859- line="2938">a leaflet</doc>
11860- <type name="Leaflet" c:type="AdwLeaflet*"/>
25255+ filename="src/adw-overlay-split-view.c"
25256+ line="1391">an overlay split view</doc>
25257+ <type name="OverlaySplitView" c:type="AdwOverlaySplitView*"/>
1186125258 </instance-parameter>
11862- <parameter name="child" transfer-ownership="none">
25259+ <parameter name="collapsed" transfer-ownership="none">
1186325260 <doc xml:space="preserve"
11864- filename="src/adw-leaflet.c"
11865- line="2939">the child to remove</doc>
11866- <type name="Gtk.Widget" c:type="GtkWidget*"/>
25261+ filename="src/adw-overlay-split-view.c"
25262+ line="1392">whether @self is collapsed</doc>
25263+ <type name="gboolean" c:type="gboolean"/>
1186725264 </parameter>
1186825265 </parameters>
1186925266 </method>
11870- <method name="reorder_child_after"
11871- c:identifier="adw_leaflet_reorder_child_after">
25267+ <method name="set_content"
25268+ c:identifier="adw_overlay_split_view_set_content"
25269+ glib:set-property="content"
25270+ version="1.4">
1187225271 <doc xml:space="preserve"
11873- filename="src/adw-leaflet.c"
11874- line="2868">Moves @child to the position after @sibling in the list of children.
11875-
11876-If @sibling is `NULL`, moves @child to the first position.</doc>
11877- <source-position filename="src/adw-leaflet.h" line="69"/>
25272+ filename="src/adw-overlay-split-view.c"
25273+ line="1344">Sets the content widget for @self.</doc>
25274+ <source-position filename="src/adw-overlay-split-view.h" line="39"/>
1187825275 <return-value transfer-ownership="none">
1187925276 <type name="none" c:type="void"/>
1188025277 </return-value>
1188125278 <parameters>
1188225279 <instance-parameter name="self" transfer-ownership="none">
1188325280 <doc xml:space="preserve"
11884- filename="src/adw-leaflet.c"
11885- line="2870">a leaflet</doc>
11886- <type name="Leaflet" c:type="AdwLeaflet*"/>
25281+ filename="src/adw-overlay-split-view.c"
25282+ line="1346">an overlay split view</doc>
25283+ <type name="OverlaySplitView" c:type="AdwOverlaySplitView*"/>
1188725284 </instance-parameter>
11888- <parameter name="child" transfer-ownership="none">
11889- <doc xml:space="preserve"
11890- filename="src/adw-leaflet.c"
11891- line="2871">the widget to move, must be a child of @self</doc>
11892- <type name="Gtk.Widget" c:type="GtkWidget*"/>
11893- </parameter>
11894- <parameter name="sibling"
25285+ <parameter name="content"
1189525286 transfer-ownership="none"
1189625287 nullable="1"
1189725288 allow-none="1">
1189825289 <doc xml:space="preserve"
11899- filename="src/adw-leaflet.c"
11900- line="2872">the sibling to move @child after</doc>
25290+ filename="src/adw-overlay-split-view.c"
25291+ line="1347">the content widget</doc>
1190125292 <type name="Gtk.Widget" c:type="GtkWidget*"/>
1190225293 </parameter>
1190325294 </parameters>
1190425295 </method>
11905- <method name="set_can_navigate_back"
11906- c:identifier="adw_leaflet_set_can_navigate_back"
11907- glib:set-property="can-navigate-back">
11908- <attribute name="org.gtk.Method.set_property"
11909- value="can-navigate-back"/>
25296+ <method name="set_enable_hide_gesture"
25297+ c:identifier="adw_overlay_split_view_set_enable_hide_gesture"
25298+ glib:set-property="enable-hide-gesture"
25299+ version="1.4">
1191025300 <doc xml:space="preserve"
11911- filename="src/adw-leaflet.c"
11912- line="3405">Sets whether gestures and shortcuts for navigating backward are enabled.
11913-
11914-The supported gestures are:
11915-
11916-- One-finger swipe on touchscreens
11917-- Horizontal scrolling on touchpads (usually two-finger swipe)
11918-- Back/forward mouse buttons
11919-
11920-The keyboard back/forward keys are also supported, as well as the
11921-&lt;kbd&gt;Alt&lt;/kbd&gt;+&lt;kbd&gt;←&lt;/kbd&gt; shortcut for horizontal orientation, or
11922-&lt;kbd&gt;Alt&lt;/kbd&gt;+&lt;kbd&gt;↑&lt;/kbd&gt; for vertical orientation.
11923-
11924-If the orientation is horizontal, for right-to-left locales, gestures and
11925-shortcuts are reversed.
25301+ filename="src/adw-overlay-split-view.c"
25302+ line="1648">Sets whether @self can be closed with a swipe gesture.
1192625303
11927-Only children that have [property@LeafletPage:navigatable] set to `TRUE` can
11928-be navigated to.</doc>
11929- <source-position filename="src/adw-leaflet.h" line="138"/>
25304+Only touchscreen swipes are supported.</doc>
25305+ <source-position filename="src/adw-overlay-split-view.h" line="75"/>
1193025306 <return-value transfer-ownership="none">
1193125307 <type name="none" c:type="void"/>
1193225308 </return-value>
1193325309 <parameters>
1193425310 <instance-parameter name="self" transfer-ownership="none">
1193525311 <doc xml:space="preserve"
11936- filename="src/adw-leaflet.c"
11937- line="3407">a leaflet</doc>
11938- <type name="Leaflet" c:type="AdwLeaflet*"/>
25312+ filename="src/adw-overlay-split-view.c"
25313+ line="1650">an overlay split view</doc>
25314+ <type name="OverlaySplitView" c:type="AdwOverlaySplitView*"/>
1193925315 </instance-parameter>
11940- <parameter name="can_navigate_back" transfer-ownership="none">
25316+ <parameter name="enable_hide_gesture" transfer-ownership="none">
1194125317 <doc xml:space="preserve"
11942- filename="src/adw-leaflet.c"
11943- line="3408">the new value</doc>
25318+ filename="src/adw-overlay-split-view.c"
25319+ line="1651">whether @self can be closed with a swipe gesture</doc>
1194425320 <type name="gboolean" c:type="gboolean"/>
1194525321 </parameter>
1194625322 </parameters>
1194725323 </method>
11948- <method name="set_can_navigate_forward"
11949- c:identifier="adw_leaflet_set_can_navigate_forward"
11950- glib:set-property="can-navigate-forward">
11951- <attribute name="org.gtk.Method.set_property"
11952- value="can-navigate-forward"/>
25324+ <method name="set_enable_show_gesture"
25325+ c:identifier="adw_overlay_split_view_set_enable_show_gesture"
25326+ glib:set-property="enable-show-gesture"
25327+ version="1.4">
1195325328 <doc xml:space="preserve"
11954- filename="src/adw-leaflet.c"
11955- line="3461">Sets whether gestures and shortcuts for navigating forward are enabled.
11956-
11957-The supported gestures are:
11958-
11959-- One-finger swipe on touchscreens
11960-- Horizontal scrolling on touchpads (usually two-finger swipe)
11961-- Back/forward mouse buttons
11962-
11963-The keyboard back/forward keys are also supported, as well as the
11964-&lt;kbd&gt;Alt&lt;/kbd&gt;+&lt;kbd&gt;→&lt;/kbd&gt; shortcut for horizontal orientation, or
11965-&lt;kbd&gt;Alt&lt;/kbd&gt;+&lt;kbd&gt;↓&lt;/kbd&gt; for vertical orientation.
11966-
11967-If the orientation is horizontal, for right-to-left locales, gestures and
11968-shortcuts are reversed.
25329+ filename="src/adw-overlay-split-view.c"
25330+ line="1601">Sets whether @self can be opened with an edge swipe gesture.
1196925331
11970-Only children that have [property@LeafletPage:navigatable] set to `TRUE` can
11971-be navigated to.</doc>
11972- <source-position filename="src/adw-leaflet.h" line="144"/>
25332+Only touchscreen swipes are supported.</doc>
25333+ <source-position filename="src/adw-overlay-split-view.h" line="69"/>
1197325334 <return-value transfer-ownership="none">
1197425335 <type name="none" c:type="void"/>
1197525336 </return-value>
1197625337 <parameters>
1197725338 <instance-parameter name="self" transfer-ownership="none">
1197825339 <doc xml:space="preserve"
11979- filename="src/adw-leaflet.c"
11980- line="3463">a leaflet</doc>
11981- <type name="Leaflet" c:type="AdwLeaflet*"/>
25340+ filename="src/adw-overlay-split-view.c"
25341+ line="1603">an overlay split view</doc>
25342+ <type name="OverlaySplitView" c:type="AdwOverlaySplitView*"/>
1198225343 </instance-parameter>
11983- <parameter name="can_navigate_forward" transfer-ownership="none">
25344+ <parameter name="enable_show_gesture" transfer-ownership="none">
1198425345 <doc xml:space="preserve"
11985- filename="src/adw-leaflet.c"
11986- line="3464">the new value</doc>
25346+ filename="src/adw-overlay-split-view.c"
25347+ line="1604">whether @self can be opened with a swipe gesture</doc>
1198725348 <type name="gboolean" c:type="gboolean"/>
1198825349 </parameter>
1198925350 </parameters>
1199025351 </method>
11991- <method name="set_can_unfold"
11992- c:identifier="adw_leaflet_set_can_unfold"
11993- glib:set-property="can-unfold">
11994- <attribute name="org.gtk.Method.set_property" value="can-unfold"/>
25352+ <method name="set_max_sidebar_width"
25353+ c:identifier="adw_overlay_split_view_set_max_sidebar_width"
25354+ glib:set-property="max-sidebar-width"
25355+ version="1.4">
1199525356 <doc xml:space="preserve"
11996- filename="src/adw-leaflet.c"
11997- line="2986">Sets whether @self can unfold.</doc>
11998- <source-position filename="src/adw-leaflet.h" line="84"/>
25357+ filename="src/adw-overlay-split-view.c"
25358+ line="1743">Sets the maximum sidebar width for @self.
25359+
25360+Maximum width is affected by [property@OverlaySplitView:sidebar-width-unit].
25361+
25362+The sidebar widget can still be allocated with larger width if its own
25363+minimum width exceeds it.</doc>
25364+ <source-position filename="src/adw-overlay-split-view.h" line="87"/>
1199925365 <return-value transfer-ownership="none">
1200025366 <type name="none" c:type="void"/>
1200125367 </return-value>
1200225368 <parameters>
1200325369 <instance-parameter name="self" transfer-ownership="none">
1200425370 <doc xml:space="preserve"
12005- filename="src/adw-leaflet.c"
12006- line="2988">a leaflet</doc>
12007- <type name="Leaflet" c:type="AdwLeaflet*"/>
25371+ filename="src/adw-overlay-split-view.c"
25372+ line="1745">an overlay split view</doc>
25373+ <type name="OverlaySplitView" c:type="AdwOverlaySplitView*"/>
1200825374 </instance-parameter>
12009- <parameter name="can_unfold" transfer-ownership="none">
25375+ <parameter name="width" transfer-ownership="none">
1201025376 <doc xml:space="preserve"
12011- filename="src/adw-leaflet.c"
12012- line="2989">whether @self can unfold</doc>
12013- <type name="gboolean" c:type="gboolean"/>
25377+ filename="src/adw-overlay-split-view.c"
25378+ line="1746">the maximum width</doc>
25379+ <type name="gdouble" c:type="double"/>
1201425380 </parameter>
1201525381 </parameters>
1201625382 </method>
12017- <method name="set_child_transition_params"
12018- c:identifier="adw_leaflet_set_child_transition_params"
12019- glib:set-property="child-transition-params">
12020- <attribute name="org.gtk.Method.set_property"
12021- value="child-transition-params"/>
25383+ <method name="set_min_sidebar_width"
25384+ c:identifier="adw_overlay_split_view_set_min_sidebar_width"
25385+ glib:set-property="min-sidebar-width"
25386+ version="1.4">
1202225387 <doc xml:space="preserve"
12023- filename="src/adw-leaflet.c"
12024- line="3344">Sets the child transition spring parameters for @self.
25388+ filename="src/adw-overlay-split-view.c"
25389+ line="1695">Sets the minimum sidebar width for @self.
1202525390
12026-The default value is equivalent to:
25391+Minimum width is affected by [property@OverlaySplitView:sidebar-width-unit].
1202725392
12028-```c
12029-adw_spring_params_new (1, 0.5, 500)
12030-```</doc>
12031- <source-position filename="src/adw-leaflet.h" line="129"/>
25393+The sidebar widget can still be allocated with larger width if its own
25394+minimum width exceeds it.</doc>
25395+ <source-position filename="src/adw-overlay-split-view.h" line="81"/>
1203225396 <return-value transfer-ownership="none">
1203325397 <type name="none" c:type="void"/>
1203425398 </return-value>
1203525399 <parameters>
1203625400 <instance-parameter name="self" transfer-ownership="none">
1203725401 <doc xml:space="preserve"
12038- filename="src/adw-leaflet.c"
12039- line="3346">a leaflet</doc>
12040- <type name="Leaflet" c:type="AdwLeaflet*"/>
25402+ filename="src/adw-overlay-split-view.c"
25403+ line="1697">an overlay split view</doc>
25404+ <type name="OverlaySplitView" c:type="AdwOverlaySplitView*"/>
1204125405 </instance-parameter>
12042- <parameter name="params" transfer-ownership="none">
25406+ <parameter name="width" transfer-ownership="none">
1204325407 <doc xml:space="preserve"
12044- filename="src/adw-leaflet.c"
12045- line="3347">the new parameters</doc>
12046- <type name="SpringParams" c:type="AdwSpringParams*"/>
25408+ filename="src/adw-overlay-split-view.c"
25409+ line="1698">the minimum width</doc>
25410+ <type name="gdouble" c:type="double"/>
1204725411 </parameter>
1204825412 </parameters>
1204925413 </method>
12050- <method name="set_fold_threshold_policy"
12051- c:identifier="adw_leaflet_set_fold_threshold_policy"
12052- glib:set-property="fold-threshold-policy">
12053- <attribute name="org.gtk.Method.set_property"
12054- value="fold-threshold-policy"/>
25414+ <method name="set_pin_sidebar"
25415+ c:identifier="adw_overlay_split_view_set_pin_sidebar"
25416+ glib:set-property="pin-sidebar"
25417+ version="1.4">
1205525418 <doc xml:space="preserve"
12056- filename="src/adw-leaflet.c"
12057- line="3062">Sets the fold threshold policy for @self.
12058-
12059-If set to `ADW_FOLD_THRESHOLD_POLICY_MINIMUM`, it will only fold when the
12060-children cannot fit anymore. With `ADW_FOLD_THRESHOLD_POLICY_NATURAL`, it
12061-will fold as soon as children don't get their natural size.
25419+ filename="src/adw-overlay-split-view.c"
25420+ line="1554">Sets whether the sidebar widget is pinned for @self.
1206225421
12063-This can be useful if you have a long ellipsizing label and want to let it
12064-ellipsize instead of immediately folding.</doc>
12065- <source-position filename="src/adw-leaflet.h" line="93"/>
25422+By default, collapsing @self automatically hides the sidebar widget, and
25423+uncollapsing it shows the sidebar. If set to `TRUE`, sidebar visibility never
25424+changes on its own.</doc>
25425+ <source-position filename="src/adw-overlay-split-view.h" line="63"/>
1206625426 <return-value transfer-ownership="none">
1206725427 <type name="none" c:type="void"/>
1206825428 </return-value>
1206925429 <parameters>
1207025430 <instance-parameter name="self" transfer-ownership="none">
1207125431 <doc xml:space="preserve"
12072- filename="src/adw-leaflet.c"
12073- line="3064">a leaflet</doc>
12074- <type name="Leaflet" c:type="AdwLeaflet*"/>
25432+ filename="src/adw-overlay-split-view.c"
25433+ line="1556">an overlay split view</doc>
25434+ <type name="OverlaySplitView" c:type="AdwOverlaySplitView*"/>
1207525435 </instance-parameter>
12076- <parameter name="policy" transfer-ownership="none">
25436+ <parameter name="pin_sidebar" transfer-ownership="none">
1207725437 <doc xml:space="preserve"
12078- filename="src/adw-leaflet.c"
12079- line="3065">the policy to use</doc>
12080- <type name="FoldThresholdPolicy" c:type="AdwFoldThresholdPolicy"/>
25438+ filename="src/adw-overlay-split-view.c"
25439+ line="1557">whether to pin the sidebar widget</doc>
25440+ <type name="gboolean" c:type="gboolean"/>
1208125441 </parameter>
1208225442 </parameters>
1208325443 </method>
12084- <method name="set_homogeneous"
12085- c:identifier="adw_leaflet_set_homogeneous"
12086- glib:set-property="homogeneous">
12087- <attribute name="org.gtk.Method.set_property" value="homogeneous"/>
25444+ <method name="set_show_sidebar"
25445+ c:identifier="adw_overlay_split_view_set_show_sidebar"
25446+ glib:set-property="show-sidebar"
25447+ version="1.4">
1208825448 <doc xml:space="preserve"
12089- filename="src/adw-leaflet.c"
12090- line="3109">Sets @self to be homogeneous or not.
12091-
12092-If set to `FALSE`, different children can have different size along the
12093-opposite orientation.</doc>
12094- <source-position filename="src/adw-leaflet.h" line="99"/>
25449+ filename="src/adw-overlay-split-view.c"
25450+ line="1518">Sets whether the sidebar widget is shown for @self.</doc>
25451+ <source-position filename="src/adw-overlay-split-view.h" line="57"/>
1209525452 <return-value transfer-ownership="none">
1209625453 <type name="none" c:type="void"/>
1209725454 </return-value>
1209825455 <parameters>
1209925456 <instance-parameter name="self" transfer-ownership="none">
1210025457 <doc xml:space="preserve"
12101- filename="src/adw-leaflet.c"
12102- line="3111">a leaflet</doc>
12103- <type name="Leaflet" c:type="AdwLeaflet*"/>
25458+ filename="src/adw-overlay-split-view.c"
25459+ line="1520">an overlay split view</doc>
25460+ <type name="OverlaySplitView" c:type="AdwOverlaySplitView*"/>
1210425461 </instance-parameter>
12105- <parameter name="homogeneous" transfer-ownership="none">
25462+ <parameter name="show_sidebar" transfer-ownership="none">
1210625463 <doc xml:space="preserve"
12107- filename="src/adw-leaflet.c"
12108- line="3112">whether to make @self homogeneous</doc>
25464+ filename="src/adw-overlay-split-view.c"
25465+ line="1521">whether to show the sidebar widget</doc>
1210925466 <type name="gboolean" c:type="gboolean"/>
1211025467 </parameter>
1211125468 </parameters>
1211225469 </method>
12113- <method name="set_mode_transition_duration"
12114- c:identifier="adw_leaflet_set_mode_transition_duration"
12115- glib:set-property="mode-transition-duration">
12116- <attribute name="org.gtk.Method.set_property"
12117- value="mode-transition-duration"/>
25470+ <method name="set_sidebar"
25471+ c:identifier="adw_overlay_split_view_set_sidebar"
25472+ glib:set-property="sidebar"
25473+ version="1.4">
1211825474 <doc xml:space="preserve"
12119- filename="src/adw-leaflet.c"
12120- line="3303">Sets the mode transition animation duration for @self.</doc>
12121- <source-position filename="src/adw-leaflet.h" line="123"/>
25475+ filename="src/adw-overlay-split-view.c"
25476+ line="1297">Sets the sidebar widget for @self.</doc>
25477+ <source-position filename="src/adw-overlay-split-view.h" line="33"/>
1212225478 <return-value transfer-ownership="none">
1212325479 <type name="none" c:type="void"/>
1212425480 </return-value>
1212525481 <parameters>
1212625482 <instance-parameter name="self" transfer-ownership="none">
1212725483 <doc xml:space="preserve"
12128- filename="src/adw-leaflet.c"
12129- line="3305">a leaflet</doc>
12130- <type name="Leaflet" c:type="AdwLeaflet*"/>
25484+ filename="src/adw-overlay-split-view.c"
25485+ line="1299">an overlay split view</doc>
25486+ <type name="OverlaySplitView" c:type="AdwOverlaySplitView*"/>
1213125487 </instance-parameter>
12132- <parameter name="duration" transfer-ownership="none">
25488+ <parameter name="sidebar"
25489+ transfer-ownership="none"
25490+ nullable="1"
25491+ allow-none="1">
1213325492 <doc xml:space="preserve"
12134- filename="src/adw-leaflet.c"
12135- line="3306">the new duration, in milliseconds</doc>
12136- <type name="guint" c:type="guint"/>
25493+ filename="src/adw-overlay-split-view.c"
25494+ line="1300">the sidebar widget</doc>
25495+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
1213725496 </parameter>
1213825497 </parameters>
1213925498 </method>
12140- <method name="set_transition_type"
12141- c:identifier="adw_leaflet_set_transition_type"
12142- glib:set-property="transition-type">
12143- <attribute name="org.gtk.Method.set_property" value="transition-type"/>
25499+ <method name="set_sidebar_position"
25500+ c:identifier="adw_overlay_split_view_set_sidebar_position"
25501+ glib:set-property="sidebar-position"
25502+ version="1.4">
1214425503 <doc xml:space="preserve"
12145- filename="src/adw-leaflet.c"
12146- line="3249">Sets the type of animation used for transitions between modes and children.
25504+ filename="src/adw-overlay-split-view.c"
25505+ line="1463">Sets the sidebar position for @self.
1214725506
12148-The transition type can be changed without problems at runtime, so it is
12149-possible to change the animation based on the mode or child that is about to
12150-become current.</doc>
12151- <source-position filename="src/adw-leaflet.h" line="117"/>
25507+If it's set to `GTK_PACK_START`, the sidebar is displayed before the content,
25508+if `GTK_PACK_END`, it's displayed after the content.</doc>
25509+ <source-position filename="src/adw-overlay-split-view.h" line="51"/>
1215225510 <return-value transfer-ownership="none">
1215325511 <type name="none" c:type="void"/>
1215425512 </return-value>
1215525513 <parameters>
1215625514 <instance-parameter name="self" transfer-ownership="none">
1215725515 <doc xml:space="preserve"
12158- filename="src/adw-leaflet.c"
12159- line="3251">a leaflet</doc>
12160- <type name="Leaflet" c:type="AdwLeaflet*"/>
25516+ filename="src/adw-overlay-split-view.c"
25517+ line="1465">an overlay split view</doc>
25518+ <type name="OverlaySplitView" c:type="AdwOverlaySplitView*"/>
1216125519 </instance-parameter>
12162- <parameter name="transition" transfer-ownership="none">
25520+ <parameter name="position" transfer-ownership="none">
1216325521 <doc xml:space="preserve"
12164- filename="src/adw-leaflet.c"
12165- line="3252">the new transition type</doc>
12166- <type name="LeafletTransitionType"
12167- c:type="AdwLeafletTransitionType"/>
25522+ filename="src/adw-overlay-split-view.c"
25523+ line="1466">the new position</doc>
25524+ <type name="Gtk.PackType" c:type="GtkPackType"/>
1216825525 </parameter>
1216925526 </parameters>
1217025527 </method>
12171- <method name="set_visible_child"
12172- c:identifier="adw_leaflet_set_visible_child"
12173- glib:set-property="visible-child">
12174- <attribute name="org.gtk.Method.set_property" value="visible-child"/>
25528+ <method name="set_sidebar_width_fraction"
25529+ c:identifier="adw_overlay_split_view_set_sidebar_width_fraction"
25530+ glib:set-property="sidebar-width-fraction"
25531+ version="1.4">
1217525532 <doc xml:space="preserve"
12176- filename="src/adw-leaflet.c"
12177- line="3156">Sets the widget currently visible when the leaflet is folded.
25533+ filename="src/adw-overlay-split-view.c"
25534+ line="1791">Sets the preferred sidebar width as a fraction of the total width of @self.
1217825535
12179-The transition is determined by [property@Leaflet:transition-type] and
12180-[property@Leaflet:child-transition-params]. The transition can be cancelled
12181-by the user, in which case visible child will change back to the previously
12182-visible child.</doc>
12183- <source-position filename="src/adw-leaflet.h" line="105"/>
25536+The preferred width is additionally limited by
25537+[property@OverlaySplitView:min-sidebar-width] and
25538+[property@OverlaySplitView:max-sidebar-width].
25539+
25540+The sidebar widget can be allocated with larger width if its own minimum
25541+width exceeds the preferred width.</doc>
25542+ <source-position filename="src/adw-overlay-split-view.h" line="93"/>
1218425543 <return-value transfer-ownership="none">
1218525544 <type name="none" c:type="void"/>
1218625545 </return-value>
1218725546 <parameters>
1218825547 <instance-parameter name="self" transfer-ownership="none">
1218925548 <doc xml:space="preserve"
12190- filename="src/adw-leaflet.c"
12191- line="3158">a leaflet</doc>
12192- <type name="Leaflet" c:type="AdwLeaflet*"/>
25549+ filename="src/adw-overlay-split-view.c"
25550+ line="1793">an overlay split view</doc>
25551+ <type name="OverlaySplitView" c:type="AdwOverlaySplitView*"/>
1219325552 </instance-parameter>
12194- <parameter name="visible_child" transfer-ownership="none">
25553+ <parameter name="fraction" transfer-ownership="none">
1219525554 <doc xml:space="preserve"
12196- filename="src/adw-leaflet.c"
12197- line="3159">the new child</doc>
12198- <type name="Gtk.Widget" c:type="GtkWidget*"/>
25555+ filename="src/adw-overlay-split-view.c"
25556+ line="1794">the preferred width fraction</doc>
25557+ <type name="gdouble" c:type="double"/>
1219925558 </parameter>
1220025559 </parameters>
1220125560 </method>
12202- <method name="set_visible_child_name"
12203- c:identifier="adw_leaflet_set_visible_child_name"
12204- glib:set-property="visible-child-name">
12205- <attribute name="org.gtk.Method.set_property"
12206- value="visible-child-name"/>
25561+ <method name="set_sidebar_width_unit"
25562+ c:identifier="adw_overlay_split_view_set_sidebar_width_unit"
25563+ glib:set-property="sidebar-width-unit"
25564+ version="1.4">
1220725565 <doc xml:space="preserve"
12208- filename="src/adw-leaflet.c"
12209- line="3206">Makes the child with the name @name visible.
25566+ filename="src/adw-overlay-split-view.c"
25567+ line="1842">Sets the length unit for minimum and maximum sidebar widths.
1221025568
12211-See [property@Leaflet:visible-child].</doc>
12212- <source-position filename="src/adw-leaflet.h" line="111"/>
25569+See [property@OverlaySplitView:min-sidebar-width] and
25570+[property@OverlaySplitView:max-sidebar-width].</doc>
25571+ <source-position filename="src/adw-overlay-split-view.h" line="99"/>
1221325572 <return-value transfer-ownership="none">
1221425573 <type name="none" c:type="void"/>
1221525574 </return-value>
1221625575 <parameters>
1221725576 <instance-parameter name="self" transfer-ownership="none">
1221825577 <doc xml:space="preserve"
12219- filename="src/adw-leaflet.c"
12220- line="3208">a leaflet</doc>
12221- <type name="Leaflet" c:type="AdwLeaflet*"/>
25578+ filename="src/adw-overlay-split-view.c"
25579+ line="1844">an overlay split view</doc>
25580+ <type name="OverlaySplitView" c:type="AdwOverlaySplitView*"/>
1222225581 </instance-parameter>
12223- <parameter name="name" transfer-ownership="none">
25582+ <parameter name="unit" transfer-ownership="none">
1222425583 <doc xml:space="preserve"
12225- filename="src/adw-leaflet.c"
12226- line="3209">the name of a child</doc>
12227- <type name="utf8" c:type="const char*"/>
25584+ filename="src/adw-overlay-split-view.c"
25585+ line="1845">the length unit</doc>
25586+ <type name="LengthUnit" c:type="AdwLengthUnit"/>
1222825587 </parameter>
1222925588 </parameters>
1223025589 </method>
12231- <property name="can-navigate-back"
25590+ <property name="collapsed"
25591+ version="1.4"
1223225592 writable="1"
1223325593 transfer-ownership="none"
12234- setter="set_can_navigate_back"
12235- getter="get_can_navigate_back"
25594+ setter="set_collapsed"
25595+ getter="get_collapsed"
1223625596 default-value="FALSE">
12237- <attribute name="org.gtk.Property.get"
12238- value="adw_leaflet_get_can_navigate_back"/>
12239- <attribute name="org.gtk.Property.set"
12240- value="adw_leaflet_set_can_navigate_back"/>
1224125597 <doc xml:space="preserve"
12242- filename="src/adw-leaflet.c"
12243- line="2313">Whether gestures and shortcuts for navigating backward are enabled.
12244-
12245-The supported gestures are:
25598+ filename="src/adw-overlay-split-view.c"
25599+ line="898">Whether the split view is collapsed.
1224625600
12247-- One-finger swipe on touchscreens
12248-- Horizontal scrolling on touchpads (usually two-finger swipe)
12249-- Back/forward mouse buttons
12250-
12251-The keyboard back/forward keys are also supported, as well as the
12252-&lt;kbd&gt;Alt&lt;/kbd&gt;+&lt;kbd&gt;←&lt;/kbd&gt; shortcut for horizontal orientation, or
12253-&lt;kbd&gt;Alt&lt;/kbd&gt;+&lt;kbd&gt;↑&lt;/kbd&gt; for vertical orientation.
12254-
12255-If the orientation is horizontal, for right-to-left locales, gestures and
12256-shortcuts are reversed.
12257-
12258-Only children that have [property@LeafletPage:navigatable] set to `TRUE`
12259-can be navigated to.</doc>
25601+When collapsed, the sidebar widget is presented as an overlay above the
25602+content widget, otherwise they are displayed side by side.</doc>
1226025603 <type name="gboolean" c:type="gboolean"/>
1226125604 </property>
12262- <property name="can-navigate-forward"
25605+ <property name="content"
25606+ version="1.4"
1226325607 writable="1"
1226425608 transfer-ownership="none"
12265- setter="set_can_navigate_forward"
12266- getter="get_can_navigate_forward"
12267- default-value="FALSE">
12268- <attribute name="org.gtk.Property.get"
12269- value="adw_leaflet_get_can_navigate_forward"/>
12270- <attribute name="org.gtk.Property.set"
12271- value="adw_leaflet_set_can_navigate_forward"/>
25609+ setter="set_content"
25610+ getter="get_content">
1227225611 <doc xml:space="preserve"
12273- filename="src/adw-leaflet.c"
12274- line="2339">Whether gestures and shortcuts for navigating forward are enabled.
12275-
12276-The supported gestures are:
12277-
12278-- One-finger swipe on touchscreens
12279-- Horizontal scrolling on touchpads (usually two-finger swipe)
12280-- Back/forward mouse buttons
12281-
12282-The keyboard back/forward keys are also supported, as well as the
12283-&lt;kbd&gt;Alt&lt;/kbd&gt;+&lt;kbd&gt;→&lt;/kbd&gt; shortcut for horizontal orientation, or
12284-&lt;kbd&gt;Alt&lt;/kbd&gt;+&lt;kbd&gt;↓&lt;/kbd&gt; for vertical orientation.
12285-
12286-If the orientation is horizontal, for right-to-left locales, gestures and
12287-shortcuts are reversed.
12288-
12289-Only children that have [property@LeafletPage:navigatable] set to `TRUE`
12290-can be navigated to.</doc>
12291- <type name="gboolean" c:type="gboolean"/>
25612+ filename="src/adw-overlay-split-view.c"
25613+ line="874">The content widget.</doc>
25614+ <type name="Gtk.Widget"/>
1229225615 </property>
12293- <property name="can-unfold"
25616+ <property name="enable-hide-gesture"
25617+ version="1.4"
1229425618 writable="1"
1229525619 transfer-ownership="none"
12296- setter="set_can_unfold"
12297- getter="get_can_unfold"
25620+ setter="set_enable_hide_gesture"
25621+ getter="get_enable_hide_gesture"
1229825622 default-value="TRUE">
12299- <attribute name="org.gtk.Property.get"
12300- value="adw_leaflet_get_can_unfold"/>
12301- <attribute name="org.gtk.Property.set"
12302- value="adw_leaflet_set_can_unfold"/>
1230325623 <doc xml:space="preserve"
12304- filename="src/adw-leaflet.c"
12305- line="2181">Whether or not the leaflet can unfold.</doc>
25624+ filename="src/adw-overlay-split-view.c"
25625+ line="971">Whether the sidebar can be closed with a swipe gesture.
25626+
25627+Only touchscreen swipes are supported.</doc>
1230625628 <type name="gboolean" c:type="gboolean"/>
1230725629 </property>
12308- <property name="child-transition-params"
25630+ <property name="enable-show-gesture"
25631+ version="1.4"
1230925632 writable="1"
1231025633 transfer-ownership="none"
12311- setter="set_child_transition_params"
12312- getter="get_child_transition_params">
12313- <attribute name="org.gtk.Property.get"
12314- value="adw_leaflet_get_child_transition_params"/>
12315- <attribute name="org.gtk.Property.set"
12316- value="adw_leaflet_set_child_transition_params"/>
25634+ setter="set_enable_show_gesture"
25635+ getter="get_enable_show_gesture"
25636+ default-value="TRUE">
1231725637 <doc xml:space="preserve"
12318- filename="src/adw-leaflet.c"
12319- line="2287">The child transition spring parameters.
12320-
12321-The default value is equivalent to:
25638+ filename="src/adw-overlay-split-view.c"
25639+ line="957">Whether the sidebar can be opened with an edge swipe gesture.
1232225640
12323-```c
12324-adw_spring_params_new (1, 0.5, 500)
12325-```</doc>
12326- <type name="SpringParams"/>
25641+Only touchscreen swipes are supported.</doc>
25642+ <type name="gboolean" c:type="gboolean"/>
1232725643 </property>
12328- <property name="child-transition-running"
25644+ <property name="max-sidebar-width"
25645+ version="1.4"
25646+ writable="1"
1232925647 transfer-ownership="none"
12330- getter="get_child_transition_running"
12331- default-value="FALSE">
12332- <attribute name="org.gtk.Property.get"
12333- value="adw_leaflet_get_child_transition_running"/>
25648+ setter="set_max_sidebar_width"
25649+ getter="get_max_sidebar_width"
25650+ default-value="280.000000">
1233425651 <doc xml:space="preserve"
12335- filename="src/adw-leaflet.c"
12336- line="2303">Whether a child transition is currently running.</doc>
12337- <type name="gboolean" c:type="gboolean"/>
25652+ filename="src/adw-overlay-split-view.c"
25653+ line="1003">The maximum sidebar width.
25654+
25655+Maximum width is affected by
25656+[property@OverlaySplitView:sidebar-width-unit].
25657+
25658+The sidebar widget can still be allocated with larger width if its own
25659+minimum width exceeds it.</doc>
25660+ <type name="gdouble" c:type="gdouble"/>
1233825661 </property>
12339- <property name="fold-threshold-policy"
25662+ <property name="min-sidebar-width"
25663+ version="1.4"
1234025664 writable="1"
1234125665 transfer-ownership="none"
12342- setter="set_fold_threshold_policy"
12343- getter="get_fold_threshold_policy"
12344- default-value="ADW_FOLD_THRESHOLD_POLICY_MINIMUM">
12345- <attribute name="org.gtk.Property.get"
12346- value="adw_leaflet_get_fold_threshold_policy"/>
12347- <attribute name="org.gtk.Property.set"
12348- value="adw_leaflet_set_fold_threshold_policy"/>
25666+ setter="set_min_sidebar_width"
25667+ getter="get_min_sidebar_width"
25668+ default-value="180.000000">
1234925669 <doc xml:space="preserve"
12350- filename="src/adw-leaflet.c"
12351- line="2205">Determines when the leaflet will fold.
25670+ filename="src/adw-overlay-split-view.c"
25671+ line="985">The minimum sidebar width.
1235225672
12353-If set to `ADW_FOLD_THRESHOLD_POLICY_MINIMUM`, it will only fold when the
12354-children cannot fit anymore. With `ADW_FOLD_THRESHOLD_POLICY_NATURAL`, it
12355-will fold as soon as children don't get their natural size.
25673+Minimum width is affected by
25674+[property@OverlaySplitView:sidebar-width-unit].
1235625675
12357-This can be useful if you have a long ellipsizing label and want to let it
12358-ellipsize instead of immediately folding.</doc>
12359- <type name="FoldThresholdPolicy"/>
25676+The sidebar widget can still be allocated with larger width if its own
25677+minimum width exceeds it.</doc>
25678+ <type name="gdouble" c:type="gdouble"/>
1236025679 </property>
12361- <property name="folded"
25680+ <property name="pin-sidebar"
25681+ version="1.4"
25682+ writable="1"
1236225683 transfer-ownership="none"
12363- getter="get_folded"
25684+ setter="set_pin_sidebar"
25685+ getter="get_pin_sidebar"
1236425686 default-value="FALSE">
12365- <attribute name="org.gtk.Property.get" value="adw_leaflet_get_folded"/>
1236625687 <doc xml:space="preserve"
12367- filename="src/adw-leaflet.c"
12368- line="2191">Whether the leaflet is folded.
25688+ filename="src/adw-overlay-split-view.c"
25689+ line="941">Whether the sidebar widget is pinned.
1236925690
12370-The leaflet will be folded if the size allocated to it is smaller than the
12371-sum of the minimum or natural sizes of the children (see
12372-[property@Leaflet:fold-threshold-policy]), it will be unfolded otherwise.</doc>
25691+By default, collapsing @self automatically hides the sidebar widget, and
25692+uncollapsing it shows the sidebar. If set to `TRUE`, sidebar visibility
25693+never changes on its own.</doc>
1237325694 <type name="gboolean" c:type="gboolean"/>
1237425695 </property>
12375- <property name="homogeneous"
25696+ <property name="show-sidebar"
25697+ version="1.4"
1237625698 writable="1"
1237725699 transfer-ownership="none"
12378- setter="set_homogeneous"
12379- getter="get_homogeneous"
25700+ setter="set_show_sidebar"
25701+ getter="get_show_sidebar"
1238025702 default-value="TRUE">
12381- <attribute name="org.gtk.Property.get"
12382- value="adw_leaflet_get_homogeneous"/>
12383- <attribute name="org.gtk.Property.set"
12384- value="adw_leaflet_set_homogeneous"/>
1238525703 <doc xml:space="preserve"
12386- filename="src/adw-leaflet.c"
12387- line="2223">Whether the leaflet allocates the same size for all children when folded.
12388-
12389-If set to `FALSE`, different children can have different size along the
12390-opposite orientation.</doc>
25704+ filename="src/adw-overlay-split-view.c"
25705+ line="929">Whether the sidebar widget is shown.</doc>
1239125706 <type name="gboolean" c:type="gboolean"/>
1239225707 </property>
12393- <property name="mode-transition-duration"
25708+ <property name="sidebar"
25709+ version="1.4"
1239425710 writable="1"
1239525711 transfer-ownership="none"
12396- setter="set_mode_transition_duration"
12397- getter="get_mode_transition_duration"
12398- default-value="250">
12399- <attribute name="org.gtk.Property.get"
12400- value="adw_leaflet_get_mode_transition_duration"/>
12401- <attribute name="org.gtk.Property.set"
12402- value="adw_leaflet_set_mode_transition_duration"/>
25712+ setter="set_sidebar"
25713+ getter="get_sidebar">
1240325714 <doc xml:space="preserve"
12404- filename="src/adw-leaflet.c"
12405- line="2277">The mode transition animation duration, in milliseconds.</doc>
12406- <type name="guint" c:type="guint"/>
12407- </property>
12408- <property name="pages" transfer-ownership="none" getter="get_pages">
12409- <attribute name="org.gtk.Property.get" value="adw_leaflet_get_pages"/>
12410- <doc xml:space="preserve"
12411- filename="src/adw-leaflet.c"
12412- line="2365">A selection model with the leaflet's pages.
12413-
12414-This can be used to keep an up-to-date view. The model also implements
12415-[iface@Gtk.SelectionModel] and can be used to track and change the visible
12416-page.</doc>
12417- <type name="Gtk.SelectionModel"/>
25715+ filename="src/adw-overlay-split-view.c"
25716+ line="886">The sidebar widget.</doc>
25717+ <type name="Gtk.Widget"/>
1241825718 </property>
12419- <property name="transition-type"
25719+ <property name="sidebar-position"
25720+ version="1.4"
1242025721 writable="1"
1242125722 transfer-ownership="none"
12422- setter="set_transition_type"
12423- getter="get_transition_type"
12424- default-value="ADW_LEAFLET_TRANSITION_TYPE_OVER">
12425- <attribute name="org.gtk.Property.get"
12426- value="adw_leaflet_get_transition_type"/>
12427- <attribute name="org.gtk.Property.set"
12428- value="adw_leaflet_set_transition_type"/>
25723+ setter="set_sidebar_position"
25724+ getter="get_sidebar_position"
25725+ default-value="GTK_PACK_START">
1242925726 <doc xml:space="preserve"
12430- filename="src/adw-leaflet.c"
12431- line="2263">The type of animation used for transitions between modes and children.
25727+ filename="src/adw-overlay-split-view.c"
25728+ line="913">The sidebar position.
1243225729
12433-The transition type can be changed without problems at runtime, so it is
12434-possible to change the animation based on the mode or child that is about
12435-to become current.</doc>
12436- <type name="LeafletTransitionType"/>
25730+If it's set to `GTK_PACK_START`, the sidebar is displayed before the content,
25731+if `GTK_PACK_END`, it's displayed after the content.</doc>
25732+ <type name="Gtk.PackType"/>
1243725733 </property>
12438- <property name="visible-child"
25734+ <property name="sidebar-width-fraction"
25735+ version="1.4"
1243925736 writable="1"
1244025737 transfer-ownership="none"
12441- setter="set_visible_child"
12442- getter="get_visible_child">
12443- <attribute name="org.gtk.Property.get"
12444- value="adw_leaflet_get_visible_child"/>
12445- <attribute name="org.gtk.Property.set"
12446- value="adw_leaflet_set_visible_child"/>
25738+ setter="set_sidebar_width_fraction"
25739+ getter="get_sidebar_width_fraction"
25740+ default-value="0.250000">
1244725741 <doc xml:space="preserve"
12448- filename="src/adw-leaflet.c"
12449- line="2236">The widget currently visible when the leaflet is folded.
25742+ filename="src/adw-overlay-split-view.c"
25743+ line="1021">The preferred sidebar width as a fraction of the total width.
1245025744
12451-The transition is determined by [property@Leaflet:transition-type] and
12452-[property@Leaflet:child-transition-params]. The transition can be cancelled
12453-by the user, in which case visible child will change back to the previously
12454-visible child.</doc>
12455- <type name="Gtk.Widget"/>
25745+The preferred width is additionally limited by
25746+[property@OverlaySplitView:min-sidebar-width] and
25747+[property@OverlaySplitView:max-sidebar-width].
25748+
25749+The sidebar widget can be allocated with larger width if its own minimum
25750+width exceeds the preferred width.</doc>
25751+ <type name="gdouble" c:type="gdouble"/>
1245625752 </property>
12457- <property name="visible-child-name"
25753+ <property name="sidebar-width-unit"
25754+ version="1.4"
1245825755 writable="1"
1245925756 transfer-ownership="none"
12460- setter="set_visible_child_name"
12461- getter="get_visible_child_name"
12462- default-value="NULL">
12463- <attribute name="org.gtk.Property.get"
12464- value="adw_leaflet_get_visible_child_name"/>
12465- <attribute name="org.gtk.Property.set"
12466- value="adw_leaflet_set_visible_child_name"/>
25757+ setter="set_sidebar_width_unit"
25758+ getter="get_sidebar_width_unit"
25759+ default-value="ADW_LENGTH_UNIT_SP">
1246725760 <doc xml:space="preserve"
12468- filename="src/adw-leaflet.c"
12469- line="2251">The name of the widget currently visible when the leaflet is folded.
25761+ filename="src/adw-overlay-split-view.c"
25762+ line="1040">The length unit for minimum and maximum sidebar widths.
1247025763
12471-See [property@Leaflet:visible-child].</doc>
12472- <type name="utf8" c:type="gchar*"/>
25764+See [property@OverlaySplitView:min-sidebar-width] and
25765+[property@OverlaySplitView:max-sidebar-width].</doc>
25766+ <type name="LengthUnit"/>
1247325767 </property>
1247425768 </class>
12475- <record name="LeafletClass"
12476- c:type="AdwLeafletClass"
12477- glib:is-gtype-struct-for="Leaflet">
12478- <source-position filename="src/adw-leaflet.h" line="46"/>
25769+ <record name="OverlaySplitViewClass"
25770+ c:type="AdwOverlaySplitViewClass"
25771+ glib:is-gtype-struct-for="OverlaySplitView">
25772+ <source-position filename="src/adw-overlay-split-view.h" line="25"/>
1247925773 <field name="parent_class">
1248025774 <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
1248125775 </field>
1248225776 </record>
12483- <class name="LeafletPage"
12484- c:symbol-prefix="leaflet_page"
12485- c:type="AdwLeafletPage"
12486- parent="GObject.Object"
25777+ <class name="PasswordEntryRow"
25778+ c:symbol-prefix="password_entry_row"
25779+ c:type="AdwPasswordEntryRow"
25780+ version="1.2"
25781+ parent="EntryRow"
1248725782 final="1"
12488- glib:type-name="AdwLeafletPage"
12489- glib:get-type="adw_leaflet_page_get_type"
12490- glib:type-struct="LeafletPageClass">
25783+ glib:type-name="AdwPasswordEntryRow"
25784+ glib:get-type="adw_password_entry_row_get_type"
25785+ glib:type-struct="PasswordEntryRowClass">
1249125786 <doc xml:space="preserve"
12492- filename="src/adw-leaflet.c"
12493- line="57">An auxiliary class used by [class@Leaflet].</doc>
12494- <source-position filename="src/adw-leaflet.h" line="26"/>
12495- <method name="get_child"
12496- c:identifier="adw_leaflet_page_get_child"
12497- glib:get-property="child">
12498- <attribute name="org.gtk.Method.get_property" value="child"/>
25787+ filename="src/adw-password-entry-row.c"
25788+ line="15">A [class@EntryRow] tailored for entering secrets.
25789+
25790+&lt;picture&gt;
25791+ &lt;source srcset="password-entry-row-dark.png" media="(prefers-color-scheme: dark)"&gt;
25792+ &lt;img src="password-entry-row.png" alt="password-entry-row"&gt;
25793+&lt;/picture&gt;
25794+
25795+It does not show its contents in clear text, does not allow to copy it to the
25796+clipboard, and shows a warning when Caps Lock is engaged. If the underlying
25797+platform allows it, `AdwPasswordEntryRow` will also place the text in a
25798+non-pageable memory area, to avoid it being written out to disk by the
25799+operating system.
25800+
25801+It offer a way to reveal the contents in clear text.
25802+
25803+## CSS Nodes
25804+
25805+`AdwPasswordEntryRow` has a single CSS node with name `row` that carries
25806+`.entry` and `.password` style classes.</doc>
25807+ <source-position filename="src/adw-password-entry-row.h" line="24"/>
25808+ <implements name="Gtk.Accessible"/>
25809+ <implements name="Gtk.Actionable"/>
25810+ <implements name="Gtk.Buildable"/>
25811+ <implements name="Gtk.ConstraintTarget"/>
25812+ <implements name="Gtk.Editable"/>
25813+ <constructor name="new"
25814+ c:identifier="adw_password_entry_row_new"
25815+ version="1.2">
1249925816 <doc xml:space="preserve"
12500- filename="src/adw-leaflet.c"
12501- line="2641">Gets the leaflet child to which @self belongs.</doc>
12502- <source-position filename="src/adw-leaflet.h" line="29"/>
25817+ filename="src/adw-password-entry-row.c"
25818+ line="189">Creates a new `AdwPasswordEntryRow`.</doc>
25819+ <source-position filename="src/adw-password-entry-row.h" line="27"/>
1250325820 <return-value transfer-ownership="none">
1250425821 <doc xml:space="preserve"
12505- filename="src/adw-leaflet.c"
12506- line="2647">the child to which @self belongs</doc>
25822+ filename="src/adw-password-entry-row.c"
25823+ line="194">the newly created `AdwPasswordEntryRow`</doc>
1250725824 <type name="Gtk.Widget" c:type="GtkWidget*"/>
1250825825 </return-value>
25826+ </constructor>
25827+ </class>
25828+ <record name="PasswordEntryRowClass"
25829+ c:type="AdwPasswordEntryRowClass"
25830+ glib:is-gtype-struct-for="PasswordEntryRow">
25831+ <source-position filename="src/adw-password-entry-row.h" line="24"/>
25832+ <field name="parent_class">
25833+ <type name="EntryRowClass" c:type="AdwEntryRowClass"/>
25834+ </field>
25835+ </record>
25836+ <class name="PreferencesDialog"
25837+ c:symbol-prefix="preferences_dialog"
25838+ c:type="AdwPreferencesDialog"
25839+ version="1.5"
25840+ parent="Dialog"
25841+ glib:type-name="AdwPreferencesDialog"
25842+ glib:get-type="adw_preferences_dialog_get_type"
25843+ glib:type-struct="PreferencesDialogClass">
25844+ <doc xml:space="preserve"
25845+ filename="src/adw-preferences-dialog.c"
25846+ line="26">A dialog showing application's preferences.
25847+
25848+&lt;picture&gt;
25849+ &lt;source srcset="preferences-dialog-dark.png" media="(prefers-color-scheme: dark)"&gt;
25850+ &lt;img src="preferences-dialog.png" alt="preferences-dialog"&gt;
25851+&lt;/picture&gt;
25852+
25853+The `AdwPreferencesDialog` widget presents an application's preferences
25854+gathered into pages and groups. The preferences are searchable by the user.
25855+
25856+## Actions
25857+
25858+`AdwPrefencesDialog` defines the `navigation.pop` action, it doesn't take any
25859+parameters and pops the current subpage from the navigation stack, equivalent
25860+to calling [method@PreferencesDialog.pop_subpage].
25861+
25862+## CSS nodes
25863+
25864+`AdwPreferencesDialog` has a main CSS node with the name `dialog` and the
25865+style class `.preferences`.</doc>
25866+ <source-position filename="src/adw-preferences-dialog.h" line="39"/>
25867+ <implements name="Gtk.Accessible"/>
25868+ <implements name="Gtk.Buildable"/>
25869+ <implements name="Gtk.ConstraintTarget"/>
25870+ <constructor name="new"
25871+ c:identifier="adw_preferences_dialog_new"
25872+ version="1.5">
25873+ <doc xml:space="preserve"
25874+ filename="src/adw-preferences-dialog.c"
25875+ line="684">Creates a new `AdwPreferencesDialog`.</doc>
25876+ <source-position filename="src/adw-preferences-dialog.h" line="42"/>
25877+ <return-value transfer-ownership="none">
25878+ <doc xml:space="preserve"
25879+ filename="src/adw-preferences-dialog.c"
25880+ line="689">the newly created `AdwPreferencesDialog`</doc>
25881+ <type name="Dialog" c:type="AdwDialog*"/>
25882+ </return-value>
25883+ </constructor>
25884+ <method name="add"
25885+ c:identifier="adw_preferences_dialog_add"
25886+ version="1.5">
25887+ <doc xml:space="preserve"
25888+ filename="src/adw-preferences-dialog.c"
25889+ line="699">Adds a preferences page to @self.</doc>
25890+ <source-position filename="src/adw-preferences-dialog.h" line="45"/>
25891+ <return-value transfer-ownership="none">
25892+ <type name="none" c:type="void"/>
25893+ </return-value>
1250925894 <parameters>
1251025895 <instance-parameter name="self" transfer-ownership="none">
1251125896 <doc xml:space="preserve"
12512- filename="src/adw-leaflet.c"
12513- line="2643">a leaflet page</doc>
12514- <type name="LeafletPage" c:type="AdwLeafletPage*"/>
25897+ filename="src/adw-preferences-dialog.c"
25898+ line="701">a preferences dialog</doc>
25899+ <type name="PreferencesDialog" c:type="AdwPreferencesDialog*"/>
1251525900 </instance-parameter>
25901+ <parameter name="page" transfer-ownership="none">
25902+ <doc xml:space="preserve"
25903+ filename="src/adw-preferences-dialog.c"
25904+ line="702">the page to add</doc>
25905+ <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
25906+ </parameter>
1251625907 </parameters>
1251725908 </method>
12518- <method name="get_name"
12519- c:identifier="adw_leaflet_page_get_name"
12520- glib:get-property="name">
12521- <attribute name="org.gtk.Method.get_property" value="name"/>
25909+ <method name="add_toast"
25910+ c:identifier="adw_preferences_dialog_add_toast"
25911+ version="1.5">
1252225912 <doc xml:space="preserve"
12523- filename="src/adw-leaflet.c"
12524- line="2657">Gets the name of @self.</doc>
12525- <source-position filename="src/adw-leaflet.h" line="32"/>
25913+ filename="src/adw-preferences-dialog.c"
25914+ line="956">Displays @toast.
25915+
25916+See [method@ToastOverlay.add_toast].</doc>
25917+ <source-position filename="src/adw-preferences-dialog.h" line="76"/>
25918+ <return-value transfer-ownership="none">
25919+ <type name="none" c:type="void"/>
25920+ </return-value>
25921+ <parameters>
25922+ <instance-parameter name="self" transfer-ownership="none">
25923+ <doc xml:space="preserve"
25924+ filename="src/adw-preferences-dialog.c"
25925+ line="958">a preferences dialog</doc>
25926+ <type name="PreferencesDialog" c:type="AdwPreferencesDialog*"/>
25927+ </instance-parameter>
25928+ <parameter name="toast" transfer-ownership="full">
25929+ <doc xml:space="preserve"
25930+ filename="src/adw-preferences-dialog.c"
25931+ line="959">a toast</doc>
25932+ <type name="Toast" c:type="AdwToast*"/>
25933+ </parameter>
25934+ </parameters>
25935+ </method>
25936+ <method name="get_search_enabled"
25937+ c:identifier="adw_preferences_dialog_get_search_enabled"
25938+ glib:get-property="search-enabled"
25939+ version="1.5">
25940+ <doc xml:space="preserve"
25941+ filename="src/adw-preferences-dialog.c"
25942+ line="851">Gets whether search is enabled for @self.</doc>
25943+ <source-position filename="src/adw-preferences-dialog.h" line="64"/>
25944+ <return-value transfer-ownership="none">
25945+ <doc xml:space="preserve"
25946+ filename="src/adw-preferences-dialog.c"
25947+ line="857">whether search is enabled for @self.</doc>
25948+ <type name="gboolean" c:type="gboolean"/>
25949+ </return-value>
25950+ <parameters>
25951+ <instance-parameter name="self" transfer-ownership="none">
25952+ <doc xml:space="preserve"
25953+ filename="src/adw-preferences-dialog.c"
25954+ line="853">a preferences dialog</doc>
25955+ <type name="PreferencesDialog" c:type="AdwPreferencesDialog*"/>
25956+ </instance-parameter>
25957+ </parameters>
25958+ </method>
25959+ <method name="get_visible_page"
25960+ c:identifier="adw_preferences_dialog_get_visible_page"
25961+ glib:get-property="visible-page"
25962+ version="1.5">
25963+ <doc xml:space="preserve"
25964+ filename="src/adw-preferences-dialog.c"
25965+ line="760">Gets the currently visible page of @self.</doc>
25966+ <source-position filename="src/adw-preferences-dialog.h" line="52"/>
1252625967 <return-value transfer-ownership="none" nullable="1">
1252725968 <doc xml:space="preserve"
12528- filename="src/adw-leaflet.c"
12529- line="2663">the name of @self.</doc>
25969+ filename="src/adw-preferences-dialog.c"
25970+ line="766">the visible page</doc>
25971+ <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
25972+ </return-value>
25973+ <parameters>
25974+ <instance-parameter name="self" transfer-ownership="none">
25975+ <doc xml:space="preserve"
25976+ filename="src/adw-preferences-dialog.c"
25977+ line="762">a preferences dialog</doc>
25978+ <type name="PreferencesDialog" c:type="AdwPreferencesDialog*"/>
25979+ </instance-parameter>
25980+ </parameters>
25981+ </method>
25982+ <method name="get_visible_page_name"
25983+ c:identifier="adw_preferences_dialog_get_visible_page_name"
25984+ glib:get-property="visible-page-name"
25985+ version="1.5">
25986+ <doc xml:space="preserve"
25987+ filename="src/adw-preferences-dialog.c"
25988+ line="805">Gets the name of currently visible page of @self.</doc>
25989+ <source-position filename="src/adw-preferences-dialog.h" line="58"/>
25990+ <return-value transfer-ownership="none" nullable="1">
25991+ <doc xml:space="preserve"
25992+ filename="src/adw-preferences-dialog.c"
25993+ line="811">the name of the visible page</doc>
1253025994 <type name="utf8" c:type="const char*"/>
1253125995 </return-value>
1253225996 <parameters>
1253325997 <instance-parameter name="self" transfer-ownership="none">
1253425998 <doc xml:space="preserve"
12535- filename="src/adw-leaflet.c"
12536- line="2659">a leaflet page</doc>
12537- <type name="LeafletPage" c:type="AdwLeafletPage*"/>
25999+ filename="src/adw-preferences-dialog.c"
26000+ line="807">a preferences dialog</doc>
26001+ <type name="PreferencesDialog" c:type="AdwPreferencesDialog*"/>
26002+ </instance-parameter>
26003+ </parameters>
26004+ </method>
26005+ <method name="pop_subpage"
26006+ c:identifier="adw_preferences_dialog_pop_subpage"
26007+ version="1.5">
26008+ <doc xml:space="preserve"
26009+ filename="src/adw-preferences-dialog.c"
26010+ line="934">Pop the visible page from the subpage stack of @self.</doc>
26011+ <source-position filename="src/adw-preferences-dialog.h" line="73"/>
26012+ <return-value transfer-ownership="none">
26013+ <doc xml:space="preserve"
26014+ filename="src/adw-preferences-dialog.c"
26015+ line="940">`TRUE` if a page has been popped</doc>
26016+ <type name="gboolean" c:type="gboolean"/>
26017+ </return-value>
26018+ <parameters>
26019+ <instance-parameter name="self" transfer-ownership="none">
26020+ <doc xml:space="preserve"
26021+ filename="src/adw-preferences-dialog.c"
26022+ line="936">a preferences dialog</doc>
26023+ <type name="PreferencesDialog" c:type="AdwPreferencesDialog*"/>
26024+ </instance-parameter>
26025+ </parameters>
26026+ </method>
26027+ <method name="push_subpage"
26028+ c:identifier="adw_preferences_dialog_push_subpage"
26029+ version="1.5">
26030+ <doc xml:space="preserve"
26031+ filename="src/adw-preferences-dialog.c"
26032+ line="909">Pushes @page onto the subpage stack of @self.
26033+
26034+The page will be automatically removed when popped.</doc>
26035+ <source-position filename="src/adw-preferences-dialog.h" line="70"/>
26036+ <return-value transfer-ownership="none">
26037+ <type name="none" c:type="void"/>
26038+ </return-value>
26039+ <parameters>
26040+ <instance-parameter name="self" transfer-ownership="none">
26041+ <doc xml:space="preserve"
26042+ filename="src/adw-preferences-dialog.c"
26043+ line="911">a preferences dialog</doc>
26044+ <type name="PreferencesDialog" c:type="AdwPreferencesDialog*"/>
26045+ </instance-parameter>
26046+ <parameter name="page" transfer-ownership="none">
26047+ <doc xml:space="preserve"
26048+ filename="src/adw-preferences-dialog.c"
26049+ line="912">the subpage</doc>
26050+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
26051+ </parameter>
26052+ </parameters>
26053+ </method>
26054+ <method name="remove"
26055+ c:identifier="adw_preferences_dialog_remove"
26056+ version="1.5">
26057+ <doc xml:space="preserve"
26058+ filename="src/adw-preferences-dialog.c"
26059+ line="731">Removes a page from @self.</doc>
26060+ <source-position filename="src/adw-preferences-dialog.h" line="48"/>
26061+ <return-value transfer-ownership="none">
26062+ <type name="none" c:type="void"/>
26063+ </return-value>
26064+ <parameters>
26065+ <instance-parameter name="self" transfer-ownership="none">
26066+ <doc xml:space="preserve"
26067+ filename="src/adw-preferences-dialog.c"
26068+ line="733">a preferences dialog</doc>
26069+ <type name="PreferencesDialog" c:type="AdwPreferencesDialog*"/>
1253826070 </instance-parameter>
26071+ <parameter name="page" transfer-ownership="none">
26072+ <doc xml:space="preserve"
26073+ filename="src/adw-preferences-dialog.c"
26074+ line="734">the page to remove</doc>
26075+ <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
26076+ </parameter>
1253926077 </parameters>
1254026078 </method>
12541- <method name="get_navigatable"
12542- c:identifier="adw_leaflet_page_get_navigatable"
12543- glib:get-property="navigatable">
12544- <attribute name="org.gtk.Method.get_property" value="navigatable"/>
26079+ <method name="set_search_enabled"
26080+ c:identifier="adw_preferences_dialog_set_search_enabled"
26081+ glib:set-property="search-enabled"
26082+ version="1.5">
1254526083 <doc xml:space="preserve"
12546- filename="src/adw-leaflet.c"
12547- line="2720">Gets whether the child can be navigated to when folded.</doc>
12548- <source-position filename="src/adw-leaflet.h" line="38"/>
26084+ filename="src/adw-preferences-dialog.c"
26085+ line="873">Sets whether search is enabled for @self.</doc>
26086+ <source-position filename="src/adw-preferences-dialog.h" line="66"/>
1254926087 <return-value transfer-ownership="none">
12550- <doc xml:space="preserve"
12551- filename="src/adw-leaflet.c"
12552- line="2726">whether @self can be navigated to when folded</doc>
12553- <type name="gboolean" c:type="gboolean"/>
26088+ <type name="none" c:type="void"/>
1255426089 </return-value>
1255526090 <parameters>
1255626091 <instance-parameter name="self" transfer-ownership="none">
1255726092 <doc xml:space="preserve"
12558- filename="src/adw-leaflet.c"
12559- line="2722">a leaflet page</doc>
12560- <type name="LeafletPage" c:type="AdwLeafletPage*"/>
26093+ filename="src/adw-preferences-dialog.c"
26094+ line="875">a preferences dialog</doc>
26095+ <type name="PreferencesDialog" c:type="AdwPreferencesDialog*"/>
1256126096 </instance-parameter>
26097+ <parameter name="search_enabled" transfer-ownership="none">
26098+ <doc xml:space="preserve"
26099+ filename="src/adw-preferences-dialog.c"
26100+ line="876">whether search is enabled</doc>
26101+ <type name="gboolean" c:type="gboolean"/>
26102+ </parameter>
1256226103 </parameters>
1256326104 </method>
12564- <method name="set_name"
12565- c:identifier="adw_leaflet_page_set_name"
12566- glib:set-property="name">
12567- <attribute name="org.gtk.Method.set_property" value="name"/>
26105+ <method name="set_visible_page"
26106+ c:identifier="adw_preferences_dialog_set_visible_page"
26107+ glib:set-property="visible-page"
26108+ version="1.5">
1256826109 <doc xml:space="preserve"
12569- filename="src/adw-leaflet.c"
12570- line="2673">Sets the name of the @self.</doc>
12571- <source-position filename="src/adw-leaflet.h" line="34"/>
26110+ filename="src/adw-preferences-dialog.c"
26111+ line="782">Makes @page the visible page of @self.</doc>
26112+ <source-position filename="src/adw-preferences-dialog.h" line="54"/>
1257226113 <return-value transfer-ownership="none">
1257326114 <type name="none" c:type="void"/>
1257426115 </return-value>
1257526116 <parameters>
1257626117 <instance-parameter name="self" transfer-ownership="none">
1257726118 <doc xml:space="preserve"
12578- filename="src/adw-leaflet.c"
12579- line="2675">a leaflet page</doc>
12580- <type name="LeafletPage" c:type="AdwLeafletPage*"/>
26119+ filename="src/adw-preferences-dialog.c"
26120+ line="784">a preferences dialog</doc>
26121+ <type name="PreferencesDialog" c:type="AdwPreferencesDialog*"/>
1258126122 </instance-parameter>
12582- <parameter name="name"
12583- transfer-ownership="none"
12584- nullable="1"
12585- allow-none="1">
26123+ <parameter name="page" transfer-ownership="none">
1258626124 <doc xml:space="preserve"
12587- filename="src/adw-leaflet.c"
12588- line="2676">the new value to set</doc>
12589- <type name="utf8" c:type="const char*"/>
26125+ filename="src/adw-preferences-dialog.c"
26126+ line="785">a page of @self</doc>
26127+ <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
1259026128 </parameter>
1259126129 </parameters>
1259226130 </method>
12593- <method name="set_navigatable"
12594- c:identifier="adw_leaflet_page_set_navigatable"
12595- glib:set-property="navigatable">
12596- <attribute name="org.gtk.Method.set_property" value="navigatable"/>
26131+ <method name="set_visible_page_name"
26132+ c:identifier="adw_preferences_dialog_set_visible_page_name"
26133+ glib:set-property="visible-page-name"
26134+ version="1.5">
1259726135 <doc xml:space="preserve"
12598- filename="src/adw-leaflet.c"
12599- line="2736">Sets whether @self can be navigated to when folded.
26136+ filename="src/adw-preferences-dialog.c"
26137+ line="827">Makes the page with the given name visible.
1260026138
12601-If `FALSE`, the child will be ignored by [method@Leaflet.get_adjacent_child],
12602-[method@Leaflet.navigate], and swipe gestures.
12603-
12604-This can be used used to prevent switching to widgets like separators.</doc>
12605- <source-position filename="src/adw-leaflet.h" line="40"/>
26139+See [property@PreferencesDialog:visible-page].</doc>
26140+ <source-position filename="src/adw-preferences-dialog.h" line="60"/>
1260626141 <return-value transfer-ownership="none">
1260726142 <type name="none" c:type="void"/>
1260826143 </return-value>
1260926144 <parameters>
1261026145 <instance-parameter name="self" transfer-ownership="none">
1261126146 <doc xml:space="preserve"
12612- filename="src/adw-leaflet.c"
12613- line="2738">a leaflet page</doc>
12614- <type name="LeafletPage" c:type="AdwLeafletPage*"/>
26147+ filename="src/adw-preferences-dialog.c"
26148+ line="829">a preferences dialog</doc>
26149+ <type name="PreferencesDialog" c:type="AdwPreferencesDialog*"/>
1261526150 </instance-parameter>
12616- <parameter name="navigatable" transfer-ownership="none">
26151+ <parameter name="name" transfer-ownership="none">
1261726152 <doc xml:space="preserve"
12618- filename="src/adw-leaflet.c"
12619- line="2739">whether @self can be navigated to when folded</doc>
12620- <type name="gboolean" c:type="gboolean"/>
26153+ filename="src/adw-preferences-dialog.c"
26154+ line="830">the name of the page to make visible</doc>
26155+ <type name="utf8" c:type="const char*"/>
1262126156 </parameter>
1262226157 </parameters>
1262326158 </method>
12624- <property name="child"
26159+ <property name="search-enabled"
26160+ version="1.5"
1262526161 writable="1"
12626- construct-only="1"
1262726162 transfer-ownership="none"
12628- getter="get_child">
12629- <attribute name="org.gtk.Property.get"
12630- value="adw_leaflet_page_get_child"/>
26163+ setter="set_search_enabled"
26164+ getter="get_search_enabled"
26165+ default-value="FALSE">
1263126166 <doc xml:space="preserve"
12632- filename="src/adw-leaflet.c"
12633- line="272">The leaflet child to which the page belongs.</doc>
12634- <type name="Gtk.Widget"/>
26167+ filename="src/adw-preferences-dialog.c"
26168+ line="574">Whether search is enabled.</doc>
26169+ <type name="gboolean" c:type="gboolean"/>
1263526170 </property>
12636- <property name="name"
26171+ <property name="visible-page"
26172+ version="1.5"
1263726173 writable="1"
1263826174 transfer-ownership="none"
12639- setter="set_name"
12640- getter="get_name"
12641- default-value="NULL">
12642- <attribute name="org.gtk.Property.get"
12643- value="adw_leaflet_page_get_name"/>
12644- <attribute name="org.gtk.Property.set"
12645- value="adw_leaflet_page_set_name"/>
26175+ setter="set_visible_page"
26176+ getter="get_visible_page">
1264626177 <doc xml:space="preserve"
12647- filename="src/adw-leaflet.c"
12648- line="282">The name of the child page.</doc>
12649- <type name="utf8" c:type="gchar*"/>
26178+ filename="src/adw-preferences-dialog.c"
26179+ line="548">The currently visible page.</doc>
26180+ <type name="Gtk.Widget"/>
1265026181 </property>
12651- <property name="navigatable"
26182+ <property name="visible-page-name"
26183+ version="1.5"
1265226184 writable="1"
1265326185 transfer-ownership="none"
12654- setter="set_navigatable"
12655- getter="get_navigatable"
12656- default-value="TRUE">
12657- <attribute name="org.gtk.Property.get"
12658- value="adw_leaflet_page_get_navigatable"/>
12659- <attribute name="org.gtk.Property.set"
12660- value="adw_leaflet_page_set_navigatable"/>
26186+ setter="set_visible_page_name"
26187+ getter="get_visible_page_name"
26188+ default-value="NULL">
1266126189 <doc xml:space="preserve"
12662- filename="src/adw-leaflet.c"
12663- line="292">Whether the child can be navigated to when folded.
12664-
12665-If `FALSE`, the child will be ignored by
12666-[method@Leaflet.get_adjacent_child], [method@Leaflet.navigate], and swipe
12667-gestures.
26190+ filename="src/adw-preferences-dialog.c"
26191+ line="560">The name of the currently visible page.
1266826192
12669-This can be used used to prevent switching to widgets like separators.</doc>
12670- <type name="gboolean" c:type="gboolean"/>
26193+See [property@AdwPreferencesDialog:visible-page].</doc>
26194+ <type name="utf8" c:type="gchar*"/>
1267126195 </property>
26196+ <field name="parent_instance">
26197+ <type name="Dialog" c:type="AdwDialog"/>
26198+ </field>
1267226199 </class>
12673- <record name="LeafletPageClass"
12674- c:type="AdwLeafletPageClass"
12675- glib:is-gtype-struct-for="LeafletPage">
12676- <source-position filename="src/adw-leaflet.h" line="26"/>
26200+ <record name="PreferencesDialogClass"
26201+ c:type="AdwPreferencesDialogClass"
26202+ glib:is-gtype-struct-for="PreferencesDialog">
26203+ <source-position filename="src/adw-preferences-dialog.h" line="39"/>
1267726204 <field name="parent_class">
12678- <type name="GObject.ObjectClass" c:type="GObjectClass"/>
26205+ <doc xml:space="preserve"
26206+ filename="src/adw-preferences-dialog.h"
26207+ line="31">The parent class</doc>
26208+ <type name="DialogClass" c:type="AdwDialogClass"/>
26209+ </field>
26210+ <field name="padding" readable="0" private="1">
26211+ <array zero-terminated="0" fixed-size="4">
26212+ <type name="gpointer" c:type="gpointer"/>
26213+ </array>
1267926214 </field>
1268026215 </record>
12681- <enumeration name="LeafletTransitionType"
12682- glib:type-name="AdwLeafletTransitionType"
12683- glib:get-type="adw_leaflet_transition_type_get_type"
12684- c:type="AdwLeafletTransitionType">
12685- <doc xml:space="preserve"
12686- filename="src/adw-leaflet.c"
12687- line="63">Describes the possible transitions in a [class@Leaflet] widget.
12688-
12689-New values may be added to this enumeration over time.</doc>
12690- <member name="over"
12691- value="0"
12692- c:identifier="ADW_LEAFLET_TRANSITION_TYPE_OVER"
12693- glib:nick="over"
12694- glib:name="ADW_LEAFLET_TRANSITION_TYPE_OVER">
12695- <doc xml:space="preserve"
12696- filename="src/adw-leaflet.c"
12697- line="65">Cover the old page or uncover the new page, sliding from or towards the end according to orientation, text direction and children order</doc>
12698- </member>
12699- <member name="under"
12700- value="1"
12701- c:identifier="ADW_LEAFLET_TRANSITION_TYPE_UNDER"
12702- glib:nick="under"
12703- glib:name="ADW_LEAFLET_TRANSITION_TYPE_UNDER">
12704- <doc xml:space="preserve"
12705- filename="src/adw-leaflet.c"
12706- line="66">Uncover the new page or cover the old page, sliding from or towards the start according to orientation, text direction and children order</doc>
12707- </member>
12708- <member name="slide"
12709- value="2"
12710- c:identifier="ADW_LEAFLET_TRANSITION_TYPE_SLIDE"
12711- glib:nick="slide"
12712- glib:name="ADW_LEAFLET_TRANSITION_TYPE_SLIDE">
12713- <doc xml:space="preserve"
12714- filename="src/adw-leaflet.c"
12715- line="67">Slide from left, right, up or down according to the orientation, text direction and the children order</doc>
12716- </member>
12717- </enumeration>
12718- <constant name="MAJOR_VERSION" value="1" c:type="ADW_MAJOR_VERSION">
12719- <doc xml:space="preserve"
12720- filename="src/adw-version.h"
12721- line="17">Adwaita major version component (e.g. 1 if the version is 1.2.3).</doc>
12722- <source-position filename="src/adw-version.h" line="22"/>
12723- <type name="gint" c:type="gint"/>
12724- </constant>
12725- <constant name="MICRO_VERSION" value="3" c:type="ADW_MICRO_VERSION">
12726- <doc xml:space="preserve"
12727- filename="src/adw-version.h"
12728- line="31">Adwaita micro version component (e.g. 3 if the version is 1.2.3).</doc>
12729- <source-position filename="src/adw-version.h" line="36"/>
12730- <type name="gint" c:type="gint"/>
12731- </constant>
12732- <constant name="MINOR_VERSION" value="3" c:type="ADW_MINOR_VERSION">
12733- <doc xml:space="preserve"
12734- filename="src/adw-version.h"
12735- line="24">Adwaita minor version component (e.g. 2 if the version is 1.2.3).</doc>
12736- <source-position filename="src/adw-version.h" line="29"/>
12737- <type name="gint" c:type="gint"/>
12738- </constant>
12739- <class name="MessageDialog"
12740- c:symbol-prefix="message_dialog"
12741- c:type="AdwMessageDialog"
12742- version="1.2"
12743- parent="Gtk.Window"
12744- glib:type-name="AdwMessageDialog"
12745- glib:get-type="adw_message_dialog_get_type"
12746- glib:type-struct="MessageDialogClass">
12747- <doc xml:space="preserve"
12748- filename="src/adw-message-dialog.c"
12749- line="17">A dialog presenting a message or a question.
12750-
12751-&lt;picture&gt;
12752- &lt;source srcset="message-dialog-dark.png" media="(prefers-color-scheme: dark)"&gt;
12753- &lt;img src="message-dialog.png" alt="message-dialog"&gt;
12754-&lt;/picture&gt;
12755-
12756-Message dialogs have a heading, a body, an optional child widget, and one or
12757-multiple responses, each presented as a button.
12758-
12759-Each response has a unique string ID, and a button label. Additionally, each
12760-response can be enabled or disabled, and can have a suggested or destructive
12761-appearance.
12762-
12763-When one of the responses is activated, or the dialog is closed, the
12764-[signal@MessageDialog::response] signal will be emitted. This signal is
12765-detailed, and the detail, as well as the `response` parameter will be set to
12766-the ID of the activated response, or to the value of the
12767-[property@MessageDialog:close-response] property if the dialog had been
12768-closed without activating any of the responses.
12769-
12770-Response buttons can be presented horizontally or vertically depending on
12771-available space.
12772-
12773-When a response is activated, `AdwMessageDialog` is closed automatically.
12774-
12775-An example of using a message dialog:
12776-
12777-```c
12778-GtkWidget *dialog;
12779-
12780-dialog = adw_message_dialog_new (parent, _("Replace File?"), NULL);
12781-
12782-adw_message_dialog_format_body (ADW_MESSAGE_DIALOG (dialog),
12783- _("A file named “%s” already exists. Do you want to replace it?"),
12784- filename);
12785-
12786-adw_message_dialog_add_responses (ADW_MESSAGE_DIALOG (dialog),
12787- "cancel", _("_Cancel"),
12788- "replace", _("_Replace"),
12789- NULL);
12790-
12791-adw_message_dialog_set_response_appearance (ADW_MESSAGE_DIALOG (dialog), "replace", ADW_RESPONSE_DESTRUCTIVE);
12792-
12793-adw_message_dialog_set_default_response (ADW_MESSAGE_DIALOG (dialog), "cancel");
12794-adw_message_dialog_set_close_response (ADW_MESSAGE_DIALOG (dialog), "cancel");
12795-
12796-g_signal_connect (dialog, "response", G_CALLBACK (response_cb), self);
12797-
12798-gtk_window_present (GTK_WINDOW (dialog));
12799-```
12800-
12801-## Async API
12802-
12803-`AdwMessageDialog` can also be used via the [method@MessageDialog.choose]
12804-method. This API follows the GIO async pattern, and the result can be
12805-obtained by calling [method@MessageDialog.choose_finish], for example:
12806-
12807-```c
12808-static void
12809-dialog_cb (AdwMessageDialog *dialog,
12810- GAsyncResult *result,
12811- MyWindow *self)
12812-{
12813- const char *response = adw_message_dialog_choose_finish (dialog, result);
12814-
12815- // ...
12816-}
12817-
12818-static void
12819-show_dialog (MyWindow *self)
12820-{
12821- GtkWidget *dialog;
12822-
12823- dialog = adw_message_dialog_new (GTK_WINDOW (self), _("Replace File?"), NULL);
12824-
12825- adw_message_dialog_format_body (ADW_MESSAGE_DIALOG (dialog),
12826- _("A file named “%s” already exists. Do you want to replace it?"),
12827- filename);
12828-
12829- adw_message_dialog_add_responses (ADW_MESSAGE_DIALOG (dialog),
12830- "cancel", _("_Cancel"),
12831- "replace", _("_Replace"),
12832- NULL);
12833-
12834- adw_message_dialog_set_response_appearance (ADW_MESSAGE_DIALOG (dialog), "replace", ADW_RESPONSE_DESTRUCTIVE);
26216+ <class name="PreferencesGroup"
26217+ c:symbol-prefix="preferences_group"
26218+ c:type="AdwPreferencesGroup"
26219+ parent="Gtk.Widget"
26220+ glib:type-name="AdwPreferencesGroup"
26221+ glib:get-type="adw_preferences_group_get_type"
26222+ glib:type-struct="PreferencesGroupClass">
26223+ <doc xml:space="preserve"
26224+ filename="src/adw-preferences-group.c"
26225+ line="14">A group of preference rows.
1283526226
12836- adw_message_dialog_set_default_response (ADW_MESSAGE_DIALOG (dialog), "cancel");
12837- adw_message_dialog_set_close_response (ADW_MESSAGE_DIALOG (dialog), "cancel");
26227+&lt;picture&gt;
26228+ &lt;source srcset="preferences-group-dark.png" media="(prefers-color-scheme: dark)"&gt;
26229+ &lt;img src="preferences-group.png" alt="preferences-group"&gt;
26230+&lt;/picture&gt;
1283826231
12839- adw_message_dialog_choose (ADW_MESSAGE_DIALOG (dialog), NULL, (GAsyncReadyCallback) dialog_cb, self);
12840-}
12841-```
26232+An `AdwPreferencesGroup` represents a group or tightly related preferences,
26233+which in turn are represented by [class@PreferencesRow].
1284226234
12843-## AdwMessageDialog as GtkBuildable
26235+To summarize the role of the preferences it gathers, a group can have both a
26236+title and a description. The title will be used by [class@PreferencesDialog]
26237+to let the user look for a preference.
1284426238
12845-`AdwMessageDialog` supports adding responses in UI definitions by via the
12846-`&lt;responses&gt;` element that may contain multiple `&lt;response&gt;` elements, each
12847-respresenting a response.
26239+The [property@PreferencesGroup:separate-rows] property can be used to
26240+separate the rows within the group, same as when using the
26241+[`.boxed-list-separate`](style-classes.html#boxed-lists-cards) style class
26242+instead of `.boxed-list`.
1284826243
12849-Each of the `&lt;response&gt;` elements must have the `id` attribute specifying the
12850-response ID. The contents of the element are used as the response label.
26244+## AdwPreferencesGroup as GtkBuildable
1285126245
12852-Response labels can be translated with the usual `translatable`, `context`
12853-and `comments` attributes.
26246+The `AdwPreferencesGroup` implementation of the [iface@Gtk.Buildable] interface
26247+supports adding [class@PreferencesRow]s to the list by omitting "type". If "type"
26248+is omitted and the widget isn't a [class@PreferencesRow] the child is added to
26249+a box below the list.
1285426250
12855-The `&lt;response&gt;` elements can also have `enabled` and/or `appearance`
12856-attributes. See [method@MessageDialog.set_response_enabled] and
12857-[method@MessageDialog.set_response_appearance] for details.
26251+When the "type" attribute of a child is `header-suffix`, the child
26252+is set as the suffix on the end of the title and description.
1285826253
12859-Example of an `AdwMessageDialog` UI definition:
26254+## CSS nodes
1286026255
12861-```xml
12862-&lt;object class="AdwMessageDialog" id="dialog"&gt;
12863- &lt;property name="heading" translatable="yes"&gt;Save Changes?&lt;/property&gt;
12864- &lt;property name="body" translatable="yes"&gt;Open documents contain unsaved changes. Changes which are not saved will be permanently lost.&lt;/property&gt;
12865- &lt;property name="default-response"&gt;save&lt;/property&gt;
12866- &lt;property name="close-response"&gt;cancel&lt;/property&gt;
12867- &lt;signal name="response" handler="response_cb"/&gt;
12868- &lt;responses&gt;
12869- &lt;response id="cancel" translatable="yes"&gt;_Cancel&lt;/response&gt;
12870- &lt;response id="discard" translatable="yes" appearance="destructive"&gt;_Discard&lt;/response&gt;
12871- &lt;response id="save" translatable="yes" appearance="suggested" enabled="false"&gt;_Save&lt;/response&gt;
12872- &lt;/responses&gt;
12873-&lt;/object&gt;
12874-```
26256+`AdwPreferencesGroup` has a single CSS node with name `preferencesgroup`.
1287526257
1287626258 ## Accessibility
1287726259
12878-`AdwMessageDialog` uses the `GTK_ACCESSIBLE_ROLE_DIALOG` role.</doc>
12879- <source-position filename="src/adw-message-dialog.h" line="42"/>
26260+`AdwPreferencesGroup` uses the `GTK_ACCESSIBLE_ROLE_GROUP` role.</doc>
26261+ <source-position filename="src/adw-preferences-group.h" line="34"/>
1288026262 <implements name="Gtk.Accessible"/>
1288126263 <implements name="Gtk.Buildable"/>
1288226264 <implements name="Gtk.ConstraintTarget"/>
12883- <implements name="Gtk.Native"/>
12884- <implements name="Gtk.Root"/>
12885- <implements name="Gtk.ShortcutManager"/>
12886- <constructor name="new"
12887- c:identifier="adw_message_dialog_new"
12888- version="1.2">
26265+ <constructor name="new" c:identifier="adw_preferences_group_new">
1288926266 <doc xml:space="preserve"
12890- filename="src/adw-message-dialog.c"
12891- line="1283">Creates a new `AdwMessageDialog`.
12892-
12893-@heading and @body can be set to `NULL`. This can be useful if they need to
12894-be formatted or use markup. In that case, set them to `NULL` and call
12895-[method@MessageDialog.format_body] or similar methods afterwards:
12896-
12897-```c
12898-GtkWidget *dialog;
12899-
12900-dialog = adw_message_dialog_new (parent, _("Replace File?"), NULL);
12901-adw_message_dialog_format_body (ADW_MESSAGE_DIALOG (dialog),
12902- _("A file named “%s” already exists. Do you want to replace it?"),
12903- filename);
12904-```</doc>
12905- <source-position filename="src/adw-message-dialog.h" line="45"/>
26267+ filename="src/adw-preferences-group.c"
26268+ line="378">Creates a new `AdwPreferencesGroup`.</doc>
26269+ <source-position filename="src/adw-preferences-group.h" line="37"/>
1290626270 <return-value transfer-ownership="none">
1290726271 <doc xml:space="preserve"
12908- filename="src/adw-message-dialog.c"
12909- line="1304">the newly created `AdwMessageDialog`</doc>
26272+ filename="src/adw-preferences-group.c"
26273+ line="383">the newly created `AdwPreferencesGroup`</doc>
1291026274 <type name="Gtk.Widget" c:type="GtkWidget*"/>
1291126275 </return-value>
12912- <parameters>
12913- <parameter name="parent"
12914- transfer-ownership="none"
12915- nullable="1"
12916- allow-none="1">
12917- <doc xml:space="preserve"
12918- filename="src/adw-message-dialog.c"
12919- line="1285">transient parent</doc>
12920- <type name="Gtk.Window" c:type="GtkWindow*"/>
12921- </parameter>
12922- <parameter name="heading"
12923- transfer-ownership="none"
12924- nullable="1"
12925- allow-none="1">
12926- <doc xml:space="preserve"
12927- filename="src/adw-message-dialog.c"
12928- line="1286">the heading</doc>
12929- <type name="utf8" c:type="const char*"/>
12930- </parameter>
12931- <parameter name="body"
12932- transfer-ownership="none"
12933- nullable="1"
12934- allow-none="1">
12935- <doc xml:space="preserve"
12936- filename="src/adw-message-dialog.c"
12937- line="1287">the body text</doc>
12938- <type name="utf8" c:type="const char*"/>
12939- </parameter>
12940- </parameters>
1294126276 </constructor>
12942- <virtual-method name="response" invoker="response" version="1.2">
12943- <attribute name="org.gtk.Method.signal" value="response"/>
26277+ <method name="add" c:identifier="adw_preferences_group_add">
1294426278 <doc xml:space="preserve"
12945- filename="src/adw-message-dialog.c"
12946- line="2267">Emits the [signal@MessageDialog::response] signal with the given response ID.
12947-
12948-Used to indicate that the user has responded to the dialog in some way.</doc>
12949- <source-position filename="src/adw-message-dialog.h" line="37"/>
26279+ filename="src/adw-preferences-group.c"
26280+ line="391">Adds a child to @self.</doc>
26281+ <source-position filename="src/adw-preferences-group.h" line="40"/>
1295026282 <return-value transfer-ownership="none">
1295126283 <type name="none" c:type="void"/>
1295226284 </return-value>
1295326285 <parameters>
1295426286 <instance-parameter name="self" transfer-ownership="none">
1295526287 <doc xml:space="preserve"
12956- filename="src/adw-message-dialog.c"
12957- line="2269">a message dialog</doc>
12958- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
26288+ filename="src/adw-preferences-group.c"
26289+ line="393">a preferences group</doc>
26290+ <type name="PreferencesGroup" c:type="AdwPreferencesGroup*"/>
1295926291 </instance-parameter>
12960- <parameter name="response" transfer-ownership="none">
26292+ <parameter name="child" transfer-ownership="none">
1296126293 <doc xml:space="preserve"
12962- filename="src/adw-message-dialog.c"
12963- line="2270">response ID</doc>
12964- <type name="utf8" c:type="const char*"/>
26294+ filename="src/adw-preferences-group.c"
26295+ line="394">the widget to add</doc>
26296+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
1296526297 </parameter>
1296626298 </parameters>
12967- </virtual-method>
12968- <method name="add_response"
12969- c:identifier="adw_message_dialog_add_response"
12970- version="1.2">
26299+ </method>
26300+ <method name="get_description"
26301+ c:identifier="adw_preferences_group_get_description"
26302+ glib:get-property="description">
1297126303 <doc xml:space="preserve"
12972- filename="src/adw-message-dialog.c"
12973- line="1804">Adds a response with @id and @label to @self.
12974-
12975-Responses are represented as buttons in the dialog.
12976-
12977-Response ID must be unique. It will be used in
12978-[signal@MessageDialog::response] to tell which response had been activated,
12979-as well as to inspect and modify the response later.
12980-
12981-An embedded underline in @label indicates a mnemonic.
12982-
12983-[method@MessageDialog.set_response_label] can be used to change the response
12984-label after it had been added.
12985-
12986-[method@MessageDialog.set_response_enabled] and
12987-[method@MessageDialog.set_response_appearance] can be used to customize the
12988-responses further.</doc>
12989- <source-position filename="src/adw-message-dialog.h" line="100"/>
12990- <return-value transfer-ownership="none">
12991- <type name="none" c:type="void"/>
26304+ filename="src/adw-preferences-group.c"
26305+ line="492">Gets the description of @self.</doc>
26306+ <source-position filename="src/adw-preferences-group.h" line="53"/>
26307+ <return-value transfer-ownership="none" nullable="1">
26308+ <doc xml:space="preserve"
26309+ filename="src/adw-preferences-group.c"
26310+ line="498">the description of @self</doc>
26311+ <type name="utf8" c:type="const char*"/>
1299226312 </return-value>
1299326313 <parameters>
1299426314 <instance-parameter name="self" transfer-ownership="none">
1299526315 <doc xml:space="preserve"
12996- filename="src/adw-message-dialog.c"
12997- line="1806">a message dialog</doc>
12998- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
26316+ filename="src/adw-preferences-group.c"
26317+ line="494">a preferences group</doc>
26318+ <type name="PreferencesGroup" c:type="AdwPreferencesGroup*"/>
1299926319 </instance-parameter>
13000- <parameter name="id" transfer-ownership="none">
13001- <doc xml:space="preserve"
13002- filename="src/adw-message-dialog.c"
13003- line="1807">the response ID</doc>
13004- <type name="utf8" c:type="const char*"/>
13005- </parameter>
13006- <parameter name="label" transfer-ownership="none">
13007- <doc xml:space="preserve"
13008- filename="src/adw-message-dialog.c"
13009- line="1808">the response label</doc>
13010- <type name="utf8" c:type="const char*"/>
13011- </parameter>
1301226320 </parameters>
1301326321 </method>
13014- <method name="add_responses"
13015- c:identifier="adw_message_dialog_add_responses"
13016- version="1.2"
13017- introspectable="0">
26322+ <method name="get_header_suffix"
26323+ c:identifier="adw_preferences_group_get_header_suffix"
26324+ glib:get-property="header-suffix"
26325+ version="1.1">
1301826326 <doc xml:space="preserve"
13019- filename="src/adw-message-dialog.c"
13020- line="1872">Adds multiple responses to @self.
13021-
13022-This is the same as calling [method@MessageDialog.add_response] repeatedly.
13023-The variable argument list should be `NULL`-terminated list of response IDs
13024-and labels.
13025-
13026-Example:
13027-
13028-```c
13029-adw_message_dialog_add_responses (dialog,
13030- "cancel", _("_Cancel"),
13031- "discard", _("_Discard"),
13032- "save", _("_Save"),
13033- NULL);
13034-```</doc>
13035- <source-position filename="src/adw-message-dialog.h" line="105"/>
13036- <return-value transfer-ownership="none">
13037- <type name="none" c:type="void"/>
26327+ filename="src/adw-preferences-group.c"
26328+ line="539">Gets the suffix for @self's header.</doc>
26329+ <source-position filename="src/adw-preferences-group.h" line="59"/>
26330+ <return-value transfer-ownership="none" nullable="1">
26331+ <doc xml:space="preserve"
26332+ filename="src/adw-preferences-group.c"
26333+ line="545">the suffix for @self's header.</doc>
26334+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
1303826335 </return-value>
1303926336 <parameters>
1304026337 <instance-parameter name="self" transfer-ownership="none">
1304126338 <doc xml:space="preserve"
13042- filename="src/adw-message-dialog.c"
13043- line="1874">a message dialog</doc>
13044- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
26339+ filename="src/adw-preferences-group.c"
26340+ line="541">a preferences group</doc>
26341+ <type name="PreferencesGroup" c:type="AdwPreferencesGroup*"/>
1304526342 </instance-parameter>
13046- <parameter name="first_id" transfer-ownership="none">
13047- <doc xml:space="preserve"
13048- filename="src/adw-message-dialog.c"
13049- line="1875">response id</doc>
13050- <type name="utf8" c:type="const char*"/>
13051- </parameter>
13052- <parameter name="..." transfer-ownership="none">
13053- <doc xml:space="preserve"
13054- filename="src/adw-message-dialog.c"
13055- line="1876">label for first response, then more id-label pairs</doc>
13056- <varargs/>
13057- </parameter>
1305826343 </parameters>
1305926344 </method>
13060- <method name="choose"
13061- c:identifier="adw_message_dialog_choose"
13062- version="1.3">
26345+ <method name="get_separate_rows"
26346+ c:identifier="adw_preferences_group_get_separate_rows"
26347+ glib:get-property="separate-rows"
26348+ version="1.6">
1306326349 <doc xml:space="preserve"
13064- filename="src/adw-message-dialog.c"
13065- line="2339">This function shows @self to the user.
13066-
13067-The @callback will be called when the alert is dismissed. It should call
13068-[method@MessageDialog.choose_finish] to obtain the result.</doc>
13069- <source-position filename="src/adw-message-dialog.h" line="154"/>
26350+ filename="src/adw-preferences-group.c"
26351+ line="604">Gets whether @self's rows are separated.</doc>
26352+ <source-position filename="src/adw-preferences-group.h" line="65"/>
1307026353 <return-value transfer-ownership="none">
13071- <type name="none" c:type="void"/>
26354+ <doc xml:space="preserve"
26355+ filename="src/adw-preferences-group.c"
26356+ line="610">whether rows are separated</doc>
26357+ <type name="gboolean" c:type="gboolean"/>
1307226358 </return-value>
1307326359 <parameters>
13074- <instance-parameter name="self" transfer-ownership="full">
26360+ <instance-parameter name="self" transfer-ownership="none">
1307526361 <doc xml:space="preserve"
13076- filename="src/adw-message-dialog.c"
13077- line="2341">a message dialog</doc>
13078- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
26362+ filename="src/adw-preferences-group.c"
26363+ line="606">a preferences group</doc>
26364+ <type name="PreferencesGroup" c:type="AdwPreferencesGroup*"/>
1307926365 </instance-parameter>
13080- <parameter name="cancellable"
13081- transfer-ownership="none"
13082- nullable="1"
13083- allow-none="1">
13084- <doc xml:space="preserve"
13085- filename="src/adw-message-dialog.c"
13086- line="2342">a `GCancellable` to cancel the operation</doc>
13087- <type name="Gio.Cancellable" c:type="GCancellable*"/>
13088- </parameter>
13089- <parameter name="callback"
13090- transfer-ownership="none"
13091- nullable="1"
13092- allow-none="1"
13093- scope="async"
13094- closure="2">
13095- <doc xml:space="preserve"
13096- filename="src/adw-message-dialog.c"
13097- line="2343">a callback to call when the operation is complete</doc>
13098- <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
13099- </parameter>
13100- <parameter name="user_data"
13101- transfer-ownership="none"
13102- nullable="1"
13103- allow-none="1"
13104- closure="1">
13105- <doc xml:space="preserve"
13106- filename="src/adw-message-dialog.c"
13107- line="2344">data to pass to @callback</doc>
13108- <type name="gpointer" c:type="gpointer"/>
13109- </parameter>
1311026366 </parameters>
1311126367 </method>
13112- <method name="choose_finish"
13113- c:identifier="adw_message_dialog_choose_finish"
13114- version="1.3">
26368+ <method name="get_title"
26369+ c:identifier="adw_preferences_group_get_title"
26370+ glib:get-property="title">
1311526371 <doc xml:space="preserve"
13116- filename="src/adw-message-dialog.c"
13117- line="2374">Finishes the [method@MessageDialog.choose] call and returns the response ID.</doc>
13118- <source-position filename="src/adw-message-dialog.h" line="160"/>
26372+ filename="src/adw-preferences-group.c"
26373+ line="445">Gets the title of @self.</doc>
26374+ <source-position filename="src/adw-preferences-group.h" line="47"/>
1311926375 <return-value transfer-ownership="none">
1312026376 <doc xml:space="preserve"
13121- filename="src/adw-message-dialog.c"
13122- line="2381">the ID of the response that was selected, or
13123- [property@MessageDialog:close-response] if the call was cancelled.</doc>
26377+ filename="src/adw-preferences-group.c"
26378+ line="451">the title of @self</doc>
1312426379 <type name="utf8" c:type="const char*"/>
1312526380 </return-value>
1312626381 <parameters>
1312726382 <instance-parameter name="self" transfer-ownership="none">
1312826383 <doc xml:space="preserve"
13129- filename="src/adw-message-dialog.c"
13130- line="2376">a message dialog</doc>
13131- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
26384+ filename="src/adw-preferences-group.c"
26385+ line="447">a preferences group</doc>
26386+ <type name="PreferencesGroup" c:type="AdwPreferencesGroup*"/>
1313226387 </instance-parameter>
13133- <parameter name="result" transfer-ownership="none">
13134- <doc xml:space="preserve"
13135- filename="src/adw-message-dialog.c"
13136- line="2377">a `GAsyncResult`</doc>
13137- <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
13138- </parameter>
1313926388 </parameters>
1314026389 </method>
13141- <method name="format_body"
13142- c:identifier="adw_message_dialog_format_body"
13143- version="1.2"
13144- introspectable="0">
26390+ <method name="remove" c:identifier="adw_preferences_group_remove">
1314526391 <doc xml:space="preserve"
13146- filename="src/adw-message-dialog.c"
13147- line="1655">Sets the formatted body text of @self.
13148-
13149-See [property@MessageDialog:body].</doc>
13150- <source-position filename="src/adw-message-dialog.h" line="84"/>
26392+ filename="src/adw-preferences-group.c"
26393+ line="416">Removes a child from @self.</doc>
26394+ <source-position filename="src/adw-preferences-group.h" line="43"/>
1315126395 <return-value transfer-ownership="none">
1315226396 <type name="none" c:type="void"/>
1315326397 </return-value>
1315426398 <parameters>
1315526399 <instance-parameter name="self" transfer-ownership="none">
1315626400 <doc xml:space="preserve"
13157- filename="src/adw-message-dialog.c"
13158- line="1657">a message dialog</doc>
13159- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
26401+ filename="src/adw-preferences-group.c"
26402+ line="418">a preferences group</doc>
26403+ <type name="PreferencesGroup" c:type="AdwPreferencesGroup*"/>
1316026404 </instance-parameter>
13161- <parameter name="format" transfer-ownership="none">
13162- <doc xml:space="preserve"
13163- filename="src/adw-message-dialog.c"
13164- line="1658">the formatted string for the body text</doc>
13165- <type name="utf8" c:type="const char*"/>
13166- </parameter>
13167- <parameter name="..." transfer-ownership="none">
26405+ <parameter name="child" transfer-ownership="none">
1316826406 <doc xml:space="preserve"
13169- filename="src/adw-message-dialog.c"
13170- line="1659">the parameters to insert into @format</doc>
13171- <varargs/>
26407+ filename="src/adw-preferences-group.c"
26408+ line="419">the child to remove</doc>
26409+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
1317226410 </parameter>
1317326411 </parameters>
1317426412 </method>
13175- <method name="format_body_markup"
13176- c:identifier="adw_message_dialog_format_body_markup"
13177- version="1.2"
13178- introspectable="0">
26413+ <method name="set_description"
26414+ c:identifier="adw_preferences_group_set_description"
26415+ glib:set-property="description">
1317926416 <doc xml:space="preserve"
13180- filename="src/adw-message-dialog.c"
13181- line="1698">Sets the formatted body text of @self with Pango markup.
13182-
13183-The @format is assumed to contain Pango markup.
13184-
13185-Special XML characters in the `printf()` arguments passed to this function
13186-will automatically be escaped as necessary, see
13187-[func@GLib.markup_printf_escaped].
13188-
13189-See [property@MessageDialog:body].</doc>
13190- <source-position filename="src/adw-message-dialog.h" line="89"/>
26417+ filename="src/adw-preferences-group.c"
26418+ line="512">Sets the description for @self.</doc>
26419+ <source-position filename="src/adw-preferences-group.h" line="55"/>
1319126420 <return-value transfer-ownership="none">
1319226421 <type name="none" c:type="void"/>
1319326422 </return-value>
1319426423 <parameters>
1319526424 <instance-parameter name="self" transfer-ownership="none">
1319626425 <doc xml:space="preserve"
13197- filename="src/adw-message-dialog.c"
13198- line="1700">a message dialog</doc>
13199- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
26426+ filename="src/adw-preferences-group.c"
26427+ line="514">a preferences group</doc>
26428+ <type name="PreferencesGroup" c:type="AdwPreferencesGroup*"/>
1320026429 </instance-parameter>
13201- <parameter name="format" transfer-ownership="none">
26430+ <parameter name="description"
26431+ transfer-ownership="none"
26432+ nullable="1"
26433+ allow-none="1">
1320226434 <doc xml:space="preserve"
13203- filename="src/adw-message-dialog.c"
13204- line="1701">the formatted string for the body text with Pango markup</doc>
26435+ filename="src/adw-preferences-group.c"
26436+ line="515">the description</doc>
1320526437 <type name="utf8" c:type="const char*"/>
1320626438 </parameter>
13207- <parameter name="..." transfer-ownership="none">
13208- <doc xml:space="preserve"
13209- filename="src/adw-message-dialog.c"
13210- line="1702">the parameters to insert into @format</doc>
13211- <varargs/>
13212- </parameter>
1321326439 </parameters>
1321426440 </method>
13215- <method name="format_heading"
13216- c:identifier="adw_message_dialog_format_heading"
13217- version="1.2"
13218- introspectable="0">
26441+ <method name="set_header_suffix"
26442+ c:identifier="adw_preferences_group_set_header_suffix"
26443+ glib:set-property="header-suffix"
26444+ version="1.1">
1321926445 <doc xml:space="preserve"
13220- filename="src/adw-message-dialog.c"
13221- line="1449">Sets the formatted heading of @self.
26446+ filename="src/adw-preferences-group.c"
26447+ line="561">Sets the suffix for @self's header.
1322226448
13223-See [property@MessageDialog:heading].</doc>
13224- <source-position filename="src/adw-message-dialog.h" line="62"/>
26449+Displayed above the list, next to the title and description.
26450+
26451+Suffixes are commonly used to show a button or a spinner for the whole group.</doc>
26452+ <source-position filename="src/adw-preferences-group.h" line="61"/>
1322526453 <return-value transfer-ownership="none">
1322626454 <type name="none" c:type="void"/>
1322726455 </return-value>
1322826456 <parameters>
1322926457 <instance-parameter name="self" transfer-ownership="none">
1323026458 <doc xml:space="preserve"
13231- filename="src/adw-message-dialog.c"
13232- line="1451">a message dialog</doc>
13233- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
26459+ filename="src/adw-preferences-group.c"
26460+ line="563">a preferences group</doc>
26461+ <type name="PreferencesGroup" c:type="AdwPreferencesGroup*"/>
1323426462 </instance-parameter>
13235- <parameter name="format" transfer-ownership="none">
13236- <doc xml:space="preserve"
13237- filename="src/adw-message-dialog.c"
13238- line="1452">the formatted string for the heading</doc>
13239- <type name="utf8" c:type="const char*"/>
13240- </parameter>
13241- <parameter name="..." transfer-ownership="none">
26463+ <parameter name="suffix"
26464+ transfer-ownership="none"
26465+ nullable="1"
26466+ allow-none="1">
1324226467 <doc xml:space="preserve"
13243- filename="src/adw-message-dialog.c"
13244- line="1453">the parameters to insert into @format</doc>
13245- <varargs/>
26468+ filename="src/adw-preferences-group.c"
26469+ line="564">the suffix to set</doc>
26470+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
1324626471 </parameter>
1324726472 </parameters>
1324826473 </method>
13249- <method name="format_heading_markup"
13250- c:identifier="adw_message_dialog_format_heading_markup"
13251- version="1.2"
13252- introspectable="0">
26474+ <method name="set_separate_rows"
26475+ c:identifier="adw_preferences_group_set_separate_rows"
26476+ glib:set-property="separate-rows"
26477+ version="1.6">
1325326478 <doc xml:space="preserve"
13254- filename="src/adw-message-dialog.c"
13255- line="1492">Sets the formatted heading of @self with Pango markup.
13256-
13257-The @format is assumed to contain Pango markup.
13258-
13259-Special XML characters in the `printf()` arguments passed to this function
13260-will automatically be escaped as necessary, see
13261-[func@GLib.markup_printf_escaped].
26479+ filename="src/adw-preferences-group.c"
26480+ line="626">Sets whether @self's rows are separated.
1326226481
13263-See [property@MessageDialog:heading].</doc>
13264- <source-position filename="src/adw-message-dialog.h" line="67"/>
26482+Equivalent to using the
26483+[`.boxed-list-separate`](style-classes.html#boxed-lists-cards) style class
26484+on a [class@Gtk.ListBox] instead of `.boxed-list`.</doc>
26485+ <source-position filename="src/adw-preferences-group.h" line="67"/>
1326526486 <return-value transfer-ownership="none">
1326626487 <type name="none" c:type="void"/>
1326726488 </return-value>
1326826489 <parameters>
1326926490 <instance-parameter name="self" transfer-ownership="none">
1327026491 <doc xml:space="preserve"
13271- filename="src/adw-message-dialog.c"
13272- line="1494">a message dialog</doc>
13273- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
26492+ filename="src/adw-preferences-group.c"
26493+ line="628">a preferences group</doc>
26494+ <type name="PreferencesGroup" c:type="AdwPreferencesGroup*"/>
1327426495 </instance-parameter>
13275- <parameter name="format" transfer-ownership="none">
13276- <doc xml:space="preserve"
13277- filename="src/adw-message-dialog.c"
13278- line="1495">the formatted string for the heading with Pango markup</doc>
13279- <type name="utf8" c:type="const char*"/>
13280- </parameter>
13281- <parameter name="..." transfer-ownership="none">
26496+ <parameter name="separate_rows" transfer-ownership="none">
1328226497 <doc xml:space="preserve"
13283- filename="src/adw-message-dialog.c"
13284- line="1496">the parameters to insert into @format</doc>
13285- <varargs/>
26498+ filename="src/adw-preferences-group.c"
26499+ line="629">whether to separate rows</doc>
26500+ <type name="gboolean" c:type="gboolean"/>
1328626501 </parameter>
1328726502 </parameters>
1328826503 </method>
13289- <method name="get_body"
13290- c:identifier="adw_message_dialog_get_body"
13291- glib:get-property="body"
13292- version="1.2">
13293- <attribute name="org.gtk.Method.get_property" value="body"/>
26504+ <method name="set_title"
26505+ c:identifier="adw_preferences_group_set_title"
26506+ glib:set-property="title">
1329426507 <doc xml:space="preserve"
13295- filename="src/adw-message-dialog.c"
13296- line="1541">Gets the body text of @self.</doc>
13297- <source-position filename="src/adw-message-dialog.h" line="72"/>
26508+ filename="src/adw-preferences-group.c"
26509+ line="465">Sets the title for @self.</doc>
26510+ <source-position filename="src/adw-preferences-group.h" line="49"/>
1329826511 <return-value transfer-ownership="none">
13299- <doc xml:space="preserve"
13300- filename="src/adw-message-dialog.c"
13301- line="1547">the body of @self.</doc>
13302- <type name="utf8" c:type="const char*"/>
26512+ <type name="none" c:type="void"/>
1330326513 </return-value>
1330426514 <parameters>
1330526515 <instance-parameter name="self" transfer-ownership="none">
1330626516 <doc xml:space="preserve"
13307- filename="src/adw-message-dialog.c"
13308- line="1543">a message dialog</doc>
13309- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
26517+ filename="src/adw-preferences-group.c"
26518+ line="467">a preferences group</doc>
26519+ <type name="PreferencesGroup" c:type="AdwPreferencesGroup*"/>
1331026520 </instance-parameter>
26521+ <parameter name="title" transfer-ownership="none">
26522+ <doc xml:space="preserve"
26523+ filename="src/adw-preferences-group.c"
26524+ line="468">the title</doc>
26525+ <type name="utf8" c:type="const char*"/>
26526+ </parameter>
1331126527 </parameters>
1331226528 </method>
13313- <method name="get_body_use_markup"
13314- c:identifier="adw_message_dialog_get_body_use_markup"
13315- glib:get-property="body-use-markup"
13316- version="1.2">
13317- <attribute name="org.gtk.Method.get_property" value="body-use-markup"/>
26529+ <property name="description"
26530+ writable="1"
26531+ transfer-ownership="none"
26532+ setter="set_description"
26533+ getter="get_description">
26534+ <doc xml:space="preserve"
26535+ filename="src/adw-preferences-group.c"
26536+ line="275">The description for this group of preferences.</doc>
26537+ <type name="utf8" c:type="gchar*"/>
26538+ </property>
26539+ <property name="header-suffix"
26540+ version="1.1"
26541+ writable="1"
26542+ transfer-ownership="none"
26543+ setter="set_header_suffix"
26544+ getter="get_header_suffix">
26545+ <doc xml:space="preserve"
26546+ filename="src/adw-preferences-group.c"
26547+ line="285">The header suffix widget.
26548+
26549+Displayed above the list, next to the title and description.
26550+
26551+Suffixes are commonly used to show a button or a spinner for the whole
26552+group.</doc>
26553+ <type name="Gtk.Widget"/>
26554+ </property>
26555+ <property name="separate-rows"
26556+ version="1.6"
26557+ writable="1"
26558+ transfer-ownership="none"
26559+ setter="set_separate_rows"
26560+ getter="get_separate_rows"
26561+ default-value="FALSE">
26562+ <doc xml:space="preserve"
26563+ filename="src/adw-preferences-group.c"
26564+ line="302">Whether to separate rows.
26565+
26566+Equivalent to using the
26567+[`.boxed-list-separate`](style-classes.html#boxed-lists-cards) style class
26568+on a [class@Gtk.ListBox] instead of `.boxed-list`.</doc>
26569+ <type name="gboolean" c:type="gboolean"/>
26570+ </property>
26571+ <property name="title"
26572+ writable="1"
26573+ transfer-ownership="none"
26574+ setter="set_title"
26575+ getter="get_title">
26576+ <doc xml:space="preserve"
26577+ filename="src/adw-preferences-group.c"
26578+ line="265">The title for this group of preferences.</doc>
26579+ <type name="utf8" c:type="gchar*"/>
26580+ </property>
26581+ <field name="parent_instance">
26582+ <type name="Gtk.Widget" c:type="GtkWidget"/>
26583+ </field>
26584+ </class>
26585+ <record name="PreferencesGroupClass"
26586+ c:type="AdwPreferencesGroupClass"
26587+ glib:is-gtype-struct-for="PreferencesGroup">
26588+ <source-position filename="src/adw-preferences-group.h" line="34"/>
26589+ <field name="parent_class">
26590+ <doc xml:space="preserve"
26591+ filename="src/adw-preferences-group.h"
26592+ line="26">The parent class</doc>
26593+ <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
26594+ </field>
26595+ <field name="padding" readable="0" private="1">
26596+ <array zero-terminated="0" fixed-size="4">
26597+ <type name="gpointer" c:type="gpointer"/>
26598+ </array>
26599+ </field>
26600+ </record>
26601+ <class name="PreferencesPage"
26602+ c:symbol-prefix="preferences_page"
26603+ c:type="AdwPreferencesPage"
26604+ parent="Gtk.Widget"
26605+ glib:type-name="AdwPreferencesPage"
26606+ glib:get-type="adw_preferences_page_get_type"
26607+ glib:type-struct="PreferencesPageClass">
26608+ <doc xml:space="preserve"
26609+ filename="src/adw-preferences-page.c"
26610+ line="14">A page from [class@PreferencesDialog].
26611+
26612+&lt;picture&gt;
26613+ &lt;source srcset="preferences-page-dark.png" media="(prefers-color-scheme: dark)"&gt;
26614+ &lt;img src="preferences-page.png" alt="preferences-page"&gt;
26615+&lt;/picture&gt;
26616+
26617+The `AdwPreferencesPage` widget gathers preferences groups into a single page
26618+of a preferences window.
26619+
26620+## CSS nodes
26621+
26622+`AdwPreferencesPage` has a single CSS node with name `preferencespage`.
26623+
26624+## Accessibility
26625+
26626+`AdwPreferencesPage` uses the `GTK_ACCESSIBLE_ROLE_GROUP` role.</doc>
26627+ <source-position filename="src/adw-preferences-page.h" line="35"/>
26628+ <implements name="Gtk.Accessible"/>
26629+ <implements name="Gtk.Buildable"/>
26630+ <implements name="Gtk.ConstraintTarget"/>
26631+ <constructor name="new" c:identifier="adw_preferences_page_new">
1331826632 <doc xml:space="preserve"
13319- filename="src/adw-message-dialog.c"
13320- line="1600">Gets whether the body text of @self includes Pango markup.</doc>
13321- <source-position filename="src/adw-message-dialog.h" line="78"/>
26633+ filename="src/adw-preferences-page.c"
26634+ line="288">Creates a new `AdwPreferencesPage`.</doc>
26635+ <source-position filename="src/adw-preferences-page.h" line="38"/>
1332226636 <return-value transfer-ownership="none">
1332326637 <doc xml:space="preserve"
13324- filename="src/adw-message-dialog.c"
13325- line="1606">whether @self uses markup for body text</doc>
13326- <type name="gboolean" c:type="gboolean"/>
26638+ filename="src/adw-preferences-page.c"
26639+ line="293">the newly created `AdwPreferencesPage`</doc>
26640+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
1332726641 </return-value>
13328- <parameters>
13329- <instance-parameter name="self" transfer-ownership="none">
13330- <doc xml:space="preserve"
13331- filename="src/adw-message-dialog.c"
13332- line="1602">a message dialog</doc>
13333- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
13334- </instance-parameter>
13335- </parameters>
13336- </method>
13337- <method name="get_close_response"
13338- c:identifier="adw_message_dialog_get_close_response"
13339- glib:get-property="close-response"
13340- version="1.2">
13341- <attribute name="org.gtk.Method.get_property" value="close-response"/>
26642+ </constructor>
26643+ <method name="add" c:identifier="adw_preferences_page_add">
1334226644 <doc xml:space="preserve"
13343- filename="src/adw-message-dialog.c"
13344- line="2208">Gets the ID of the close response of @self.</doc>
13345- <source-position filename="src/adw-message-dialog.h" line="140"/>
26645+ filename="src/adw-preferences-page.c"
26646+ line="301">Adds a preferences group to @self.</doc>
26647+ <source-position filename="src/adw-preferences-page.h" line="41"/>
1334626648 <return-value transfer-ownership="none">
13347- <doc xml:space="preserve"
13348- filename="src/adw-message-dialog.c"
13349- line="2214">the close response ID</doc>
13350- <type name="utf8" c:type="const char*"/>
13351- </return-value>
13352- <parameters>
13353- <instance-parameter name="self" transfer-ownership="none">
13354- <doc xml:space="preserve"
13355- filename="src/adw-message-dialog.c"
13356- line="2210">a message dialog</doc>
13357- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
13358- </instance-parameter>
13359- </parameters>
13360- </method>
13361- <method name="get_default_response"
13362- c:identifier="adw_message_dialog_get_default_response"
13363- glib:get-property="default-response"
13364- version="1.2">
13365- <attribute name="org.gtk.Method.get_property"
13366- value="default-response"/>
13367- <doc xml:space="preserve"
13368- filename="src/adw-message-dialog.c"
13369- line="2143">Gets the ID of the default response of @self.</doc>
13370- <source-position filename="src/adw-message-dialog.h" line="134"/>
13371- <return-value transfer-ownership="none" nullable="1">
13372- <doc xml:space="preserve"
13373- filename="src/adw-message-dialog.c"
13374- line="2149">the default response ID</doc>
13375- <type name="utf8" c:type="const char*"/>
26649+ <type name="none" c:type="void"/>
1337626650 </return-value>
1337726651 <parameters>
1337826652 <instance-parameter name="self" transfer-ownership="none">
1337926653 <doc xml:space="preserve"
13380- filename="src/adw-message-dialog.c"
13381- line="2145">a message dialog</doc>
13382- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
26654+ filename="src/adw-preferences-page.c"
26655+ line="303">a preferences page</doc>
26656+ <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
1338326657 </instance-parameter>
13384- </parameters>
13385- </method>
13386- <method name="get_extra_child"
13387- c:identifier="adw_message_dialog_get_extra_child"
13388- glib:get-property="extra-child"
13389- version="1.2">
13390- <attribute name="org.gtk.Method.get_property" value="extra-child"/>
13391- <doc xml:space="preserve"
13392- filename="src/adw-message-dialog.c"
13393- line="1747">Gets the child widget of @self.</doc>
13394- <source-position filename="src/adw-message-dialog.h" line="94"/>
13395- <return-value transfer-ownership="none" nullable="1">
13396- <doc xml:space="preserve"
13397- filename="src/adw-message-dialog.c"
13398- line="1753">the child widget of @self.</doc>
13399- <type name="Gtk.Widget" c:type="GtkWidget*"/>
13400- </return-value>
13401- <parameters>
13402- <instance-parameter name="self" transfer-ownership="none">
26658+ <parameter name="group" transfer-ownership="none">
1340326659 <doc xml:space="preserve"
13404- filename="src/adw-message-dialog.c"
13405- line="1749">a message dialog</doc>
13406- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
13407- </instance-parameter>
26660+ filename="src/adw-preferences-page.c"
26661+ line="304">the group to add</doc>
26662+ <type name="PreferencesGroup" c:type="AdwPreferencesGroup*"/>
26663+ </parameter>
1340826664 </parameters>
1340926665 </method>
13410- <method name="get_heading"
13411- c:identifier="adw_message_dialog_get_heading"
13412- glib:get-property="heading"
13413- version="1.2">
13414- <attribute name="org.gtk.Method.get_property" value="heading"/>
26666+ <method name="get_description"
26667+ c:identifier="adw_preferences_page_get_description"
26668+ glib:get-property="description"
26669+ version="1.4">
1341526670 <doc xml:space="preserve"
13416- filename="src/adw-message-dialog.c"
13417- line="1330">Gets the heading of @self.</doc>
13418- <source-position filename="src/adw-message-dialog.h" line="50"/>
13419- <return-value transfer-ownership="none" nullable="1">
26671+ filename="src/adw-preferences-page.c"
26672+ line="432">Gets the description of @self.</doc>
26673+ <source-position filename="src/adw-preferences-page.h" line="60"/>
26674+ <return-value transfer-ownership="none">
1342026675 <doc xml:space="preserve"
13421- filename="src/adw-message-dialog.c"
13422- line="1336">the heading of @self.</doc>
26676+ filename="src/adw-preferences-page.c"
26677+ line="438">the description of @self.</doc>
1342326678 <type name="utf8" c:type="const char*"/>
1342426679 </return-value>
1342526680 <parameters>
1342626681 <instance-parameter name="self" transfer-ownership="none">
1342726682 <doc xml:space="preserve"
13428- filename="src/adw-message-dialog.c"
13429- line="1332">a message dialog</doc>
13430- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
26683+ filename="src/adw-preferences-page.c"
26684+ line="434">a preferences page</doc>
26685+ <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
1343126686 </instance-parameter>
1343226687 </parameters>
1343326688 </method>
13434- <method name="get_heading_use_markup"
13435- c:identifier="adw_message_dialog_get_heading_use_markup"
13436- glib:get-property="heading-use-markup"
13437- version="1.2">
13438- <attribute name="org.gtk.Method.get_property"
13439- value="heading-use-markup"/>
26689+ <method name="get_description_centered"
26690+ c:identifier="adw_preferences_page_get_description_centered"
26691+ glib:get-property="description-centered"
26692+ version="1.6">
1344026693 <doc xml:space="preserve"
13441- filename="src/adw-message-dialog.c"
13442- line="1391">Gets whether the heading of @self includes Pango markup.</doc>
13443- <source-position filename="src/adw-message-dialog.h" line="56"/>
26694+ filename="src/adw-preferences-page.c"
26695+ line="575">Gets whether the description is centered.</doc>
26696+ <source-position filename="src/adw-preferences-page.h" line="77"/>
1344426697 <return-value transfer-ownership="none">
1344526698 <doc xml:space="preserve"
13446- filename="src/adw-message-dialog.c"
13447- line="1397">whether @self uses markup for heading</doc>
26699+ filename="src/adw-preferences-page.c"
26700+ line="581">whether the description is centered.</doc>
1344826701 <type name="gboolean" c:type="gboolean"/>
1344926702 </return-value>
1345026703 <parameters>
1345126704 <instance-parameter name="self" transfer-ownership="none">
1345226705 <doc xml:space="preserve"
13453- filename="src/adw-message-dialog.c"
13454- line="1393">a message dialog</doc>
13455- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
26706+ filename="src/adw-preferences-page.c"
26707+ line="577">a preferences page</doc>
26708+ <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
1345626709 </instance-parameter>
1345726710 </parameters>
1345826711 </method>
13459- <method name="get_response_appearance"
13460- c:identifier="adw_message_dialog_get_response_appearance"
13461- version="1.2">
26712+ <method name="get_icon_name"
26713+ c:identifier="adw_preferences_page_get_icon_name"
26714+ glib:get-property="icon-name">
1346226715 <doc xml:space="preserve"
13463- filename="src/adw-message-dialog.c"
13464- line="1988">Gets the appearance of @response.
13465-
13466-See [method@MessageDialog.set_response_appearance].</doc>
13467- <source-position filename="src/adw-message-dialog.h" line="118"/>
13468- <return-value transfer-ownership="none">
26716+ filename="src/adw-preferences-page.c"
26717+ line="346">Gets the icon name for @self.</doc>
26718+ <source-position filename="src/adw-preferences-page.h" line="48"/>
26719+ <return-value transfer-ownership="none" nullable="1">
1346926720 <doc xml:space="preserve"
13470- filename="src/adw-message-dialog.c"
13471- line="1997">the appearance of @response</doc>
13472- <type name="ResponseAppearance" c:type="AdwResponseAppearance"/>
26721+ filename="src/adw-preferences-page.c"
26722+ line="352">the icon name for @self</doc>
26723+ <type name="utf8" c:type="const char*"/>
1347326724 </return-value>
1347426725 <parameters>
1347526726 <instance-parameter name="self" transfer-ownership="none">
1347626727 <doc xml:space="preserve"
13477- filename="src/adw-message-dialog.c"
13478- line="1990">a message dialog</doc>
13479- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
26728+ filename="src/adw-preferences-page.c"
26729+ line="348">a preferences page</doc>
26730+ <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
1348026731 </instance-parameter>
13481- <parameter name="response" transfer-ownership="none">
13482- <doc xml:space="preserve"
13483- filename="src/adw-message-dialog.c"
13484- line="1991">a response ID</doc>
13485- <type name="utf8" c:type="const char*"/>
13486- </parameter>
1348726732 </parameters>
1348826733 </method>
13489- <method name="get_response_enabled"
13490- c:identifier="adw_message_dialog_get_response_enabled"
13491- version="1.2">
26734+ <method name="get_name"
26735+ c:identifier="adw_preferences_page_get_name"
26736+ glib:get-property="name">
1349226737 <doc xml:space="preserve"
13493- filename="src/adw-message-dialog.c"
13494- line="2073">Gets whether @response is enabled.
13495-
13496-See [method@MessageDialog.set_response_enabled].</doc>
13497- <source-position filename="src/adw-message-dialog.h" line="126"/>
13498- <return-value transfer-ownership="none">
26738+ filename="src/adw-preferences-page.c"
26739+ line="485">Gets the name of @self.</doc>
26740+ <source-position filename="src/adw-preferences-page.h" line="66"/>
26741+ <return-value transfer-ownership="none" nullable="1">
1349926742 <doc xml:space="preserve"
13500- filename="src/adw-message-dialog.c"
13501- line="2082">whether @response is enabled</doc>
13502- <type name="gboolean" c:type="gboolean"/>
26743+ filename="src/adw-preferences-page.c"
26744+ line="491">the name of @self</doc>
26745+ <type name="utf8" c:type="const char*"/>
1350326746 </return-value>
1350426747 <parameters>
1350526748 <instance-parameter name="self" transfer-ownership="none">
1350626749 <doc xml:space="preserve"
13507- filename="src/adw-message-dialog.c"
13508- line="2075">a message dialog</doc>
13509- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
26750+ filename="src/adw-preferences-page.c"
26751+ line="487">a preferences page</doc>
26752+ <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
1351026753 </instance-parameter>
13511- <parameter name="response" transfer-ownership="none">
13512- <doc xml:space="preserve"
13513- filename="src/adw-message-dialog.c"
13514- line="2076">a response ID</doc>
13515- <type name="utf8" c:type="const char*"/>
13516- </parameter>
1351726754 </parameters>
1351826755 </method>
13519- <method name="get_response_label"
13520- c:identifier="adw_message_dialog_get_response_label"
13521- version="1.2">
26756+ <method name="get_title"
26757+ c:identifier="adw_preferences_page_get_title"
26758+ glib:get-property="title">
1352226759 <doc xml:space="preserve"
13523- filename="src/adw-message-dialog.c"
13524- line="1927">Gets the label of @response.
13525-
13526-See [method@MessageDialog.set_response_label].</doc>
13527- <source-position filename="src/adw-message-dialog.h" line="110"/>
26760+ filename="src/adw-preferences-page.c"
26761+ line="389">Gets the title of @self.</doc>
26762+ <source-position filename="src/adw-preferences-page.h" line="54"/>
1352826763 <return-value transfer-ownership="none">
1352926764 <doc xml:space="preserve"
13530- filename="src/adw-message-dialog.c"
13531- line="1936">the label of @response</doc>
26765+ filename="src/adw-preferences-page.c"
26766+ line="395">the title of @self.</doc>
1353226767 <type name="utf8" c:type="const char*"/>
1353326768 </return-value>
1353426769 <parameters>
1353526770 <instance-parameter name="self" transfer-ownership="none">
1353626771 <doc xml:space="preserve"
13537- filename="src/adw-message-dialog.c"
13538- line="1929">a message dialog</doc>
13539- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
26772+ filename="src/adw-preferences-page.c"
26773+ line="391">a preferences page</doc>
26774+ <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
1354026775 </instance-parameter>
13541- <parameter name="response" transfer-ownership="none">
13542- <doc xml:space="preserve"
13543- filename="src/adw-message-dialog.c"
13544- line="1930">a response ID</doc>
13545- <type name="utf8" c:type="const char*"/>
13546- </parameter>
1354726776 </parameters>
1354826777 </method>
13549- <method name="has_response"
13550- c:identifier="adw_message_dialog_has_response"
13551- version="1.2">
26778+ <method name="get_use_underline"
26779+ c:identifier="adw_preferences_page_get_use_underline"
26780+ glib:get-property="use-underline">
1355226781 <doc xml:space="preserve"
13553- filename="src/adw-message-dialog.c"
13554- line="2289">Gets whether @self has a response with the ID @response.</doc>
13555- <source-position filename="src/adw-message-dialog.h" line="150"/>
26782+ filename="src/adw-preferences-page.c"
26783+ line="528">Gets whether an embedded underline in the title indicates a mnemonic.</doc>
26784+ <source-position filename="src/adw-preferences-page.h" line="72"/>
1355626785 <return-value transfer-ownership="none">
1355726786 <doc xml:space="preserve"
13558- filename="src/adw-message-dialog.c"
13559- line="2296">whether @self has a response with the ID @response.</doc>
26787+ filename="src/adw-preferences-page.c"
26788+ line="534">whether an embedded underline in the title indicates a mnemonic</doc>
1356026789 <type name="gboolean" c:type="gboolean"/>
1356126790 </return-value>
1356226791 <parameters>
1356326792 <instance-parameter name="self" transfer-ownership="none">
1356426793 <doc xml:space="preserve"
13565- filename="src/adw-message-dialog.c"
13566- line="2291">a message dialog</doc>
13567- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
13568- </instance-parameter>
13569- <parameter name="response" transfer-ownership="none">
13570- <doc xml:space="preserve"
13571- filename="src/adw-message-dialog.c"
13572- line="2292">response ID</doc>
13573- <type name="utf8" c:type="const char*"/>
13574- </parameter>
13575- </parameters>
13576- </method>
13577- <method name="response"
13578- c:identifier="adw_message_dialog_response"
13579- version="1.2">
13580- <attribute name="org.gtk.Method.signal" value="response"/>
13581- <doc xml:space="preserve"
13582- filename="src/adw-message-dialog.c"
13583- line="2267">Emits the [signal@MessageDialog::response] signal with the given response ID.
13584-
13585-Used to indicate that the user has responded to the dialog in some way.</doc>
13586- <source-position filename="src/adw-message-dialog.h" line="146"/>
13587- <return-value transfer-ownership="none">
13588- <type name="none" c:type="void"/>
13589- </return-value>
13590- <parameters>
13591- <instance-parameter name="self" transfer-ownership="none">
13592- <doc xml:space="preserve"
13593- filename="src/adw-message-dialog.c"
13594- line="2269">a message dialog</doc>
13595- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
13596- </instance-parameter>
13597- <parameter name="response" transfer-ownership="none">
13598- <doc xml:space="preserve"
13599- filename="src/adw-message-dialog.c"
13600- line="2270">response ID</doc>
13601- <type name="utf8" c:type="const char*"/>
13602- </parameter>
13603- </parameters>
13604- </method>
13605- <method name="set_body"
13606- c:identifier="adw_message_dialog_set_body"
13607- glib:set-property="body"
13608- version="1.2">
13609- <attribute name="org.gtk.Method.set_property" value="body"/>
13610- <doc xml:space="preserve"
13611- filename="src/adw-message-dialog.c"
13612- line="1563">Sets the body text of @self.</doc>
13613- <source-position filename="src/adw-message-dialog.h" line="74"/>
13614- <return-value transfer-ownership="none">
13615- <type name="none" c:type="void"/>
13616- </return-value>
13617- <parameters>
13618- <instance-parameter name="self" transfer-ownership="none">
13619- <doc xml:space="preserve"
13620- filename="src/adw-message-dialog.c"
13621- line="1565">a message dialog</doc>
13622- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
26794+ filename="src/adw-preferences-page.c"
26795+ line="530">a preferences page</doc>
26796+ <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
1362326797 </instance-parameter>
13624- <parameter name="body" transfer-ownership="none">
13625- <doc xml:space="preserve"
13626- filename="src/adw-message-dialog.c"
13627- line="1566">the body of @self</doc>
13628- <type name="utf8" c:type="const char*"/>
13629- </parameter>
1363026798 </parameters>
1363126799 </method>
13632- <method name="set_body_use_markup"
13633- c:identifier="adw_message_dialog_set_body_use_markup"
13634- glib:set-property="body-use-markup"
13635- version="1.2">
13636- <attribute name="org.gtk.Method.set_property" value="body-use-markup"/>
26800+ <method name="remove" c:identifier="adw_preferences_page_remove">
1363726801 <doc xml:space="preserve"
13638- filename="src/adw-message-dialog.c"
13639- line="1622">Sets whether the body text of @self includes Pango markup.
13640-
13641-See [func@Pango.parse_markup].</doc>
13642- <source-position filename="src/adw-message-dialog.h" line="80"/>
26802+ filename="src/adw-preferences-page.c"
26803+ line="322">Removes a group from @self.</doc>
26804+ <source-position filename="src/adw-preferences-page.h" line="44"/>
1364326805 <return-value transfer-ownership="none">
1364426806 <type name="none" c:type="void"/>
1364526807 </return-value>
1364626808 <parameters>
1364726809 <instance-parameter name="self" transfer-ownership="none">
1364826810 <doc xml:space="preserve"
13649- filename="src/adw-message-dialog.c"
13650- line="1624">a message dialog</doc>
13651- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
26811+ filename="src/adw-preferences-page.c"
26812+ line="324">a preferences page</doc>
26813+ <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
1365226814 </instance-parameter>
13653- <parameter name="use_markup" transfer-ownership="none">
26815+ <parameter name="group" transfer-ownership="none">
1365426816 <doc xml:space="preserve"
13655- filename="src/adw-message-dialog.c"
13656- line="1625">whether to use markup for body text</doc>
13657- <type name="gboolean" c:type="gboolean"/>
26817+ filename="src/adw-preferences-page.c"
26818+ line="325">the group to remove</doc>
26819+ <type name="PreferencesGroup" c:type="AdwPreferencesGroup*"/>
1365826820 </parameter>
1365926821 </parameters>
1366026822 </method>
13661- <method name="set_close_response"
13662- c:identifier="adw_message_dialog_set_close_response"
13663- glib:set-property="close-response"
13664- version="1.2">
13665- <attribute name="org.gtk.Method.set_property" value="close-response"/>
26823+ <method name="scroll_to_top"
26824+ c:identifier="adw_preferences_page_scroll_to_top"
26825+ version="1.3">
1366626826 <doc xml:space="preserve"
13667- filename="src/adw-message-dialog.c"
13668- line="2230">Sets the ID of the close response of @self.
13669-
13670-It will be passed to [signal@MessageDialog::response] if the window is
13671-closed by pressing &lt;kbd&gt;Escape&lt;/kbd&gt; or with a system action.
13672-
13673-It doesn't have to correspond to any of the responses in the dialog.
13674-
13675-The default close response is `close`.</doc>
13676- <source-position filename="src/adw-message-dialog.h" line="142"/>
26827+ filename="src/adw-preferences-page.c"
26828+ line="673">Scrolls the scrolled window of @self to the top.</doc>
26829+ <source-position filename="src/adw-preferences-page.h" line="83"/>
1367726830 <return-value transfer-ownership="none">
1367826831 <type name="none" c:type="void"/>
1367926832 </return-value>
1368026833 <parameters>
1368126834 <instance-parameter name="self" transfer-ownership="none">
1368226835 <doc xml:space="preserve"
13683- filename="src/adw-message-dialog.c"
13684- line="2232">a message dialog</doc>
13685- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
26836+ filename="src/adw-preferences-page.c"
26837+ line="675">a preferences page</doc>
26838+ <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
1368626839 </instance-parameter>
13687- <parameter name="response" transfer-ownership="none">
13688- <doc xml:space="preserve"
13689- filename="src/adw-message-dialog.c"
13690- line="2233">the close response ID</doc>
13691- <type name="utf8" c:type="const char*"/>
13692- </parameter>
1369326840 </parameters>
1369426841 </method>
13695- <method name="set_default_response"
13696- c:identifier="adw_message_dialog_set_default_response"
13697- glib:set-property="default-response"
13698- version="1.2">
13699- <attribute name="org.gtk.Method.set_property"
13700- value="default-response"/>
26842+ <method name="set_description"
26843+ c:identifier="adw_preferences_page_set_description"
26844+ glib:set-property="description"
26845+ version="1.4">
1370126846 <doc xml:space="preserve"
13702- filename="src/adw-message-dialog.c"
13703- line="2168">Sets the ID of the default response of @self.
13704-
13705-If set, pressing &lt;kbd&gt;Enter&lt;/kbd&gt; will activate the corresponding button.
26847+ filename="src/adw-preferences-page.c"
26848+ line="454">Sets the description of @self.
1370626849
13707-If set to `NULL` or to a non-existent response ID, pressing &lt;kbd&gt;Enter&lt;/kbd&gt;
13708-will do nothing.</doc>
13709- <source-position filename="src/adw-message-dialog.h" line="136"/>
26850+The description is displayed at the top of the page.</doc>
26851+ <source-position filename="src/adw-preferences-page.h" line="62"/>
1371026852 <return-value transfer-ownership="none">
1371126853 <type name="none" c:type="void"/>
1371226854 </return-value>
1371326855 <parameters>
1371426856 <instance-parameter name="self" transfer-ownership="none">
1371526857 <doc xml:space="preserve"
13716- filename="src/adw-message-dialog.c"
13717- line="2170">a message dialog</doc>
13718- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
26858+ filename="src/adw-preferences-page.c"
26859+ line="456">a preferences page</doc>
26860+ <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
1371926861 </instance-parameter>
13720- <parameter name="response"
13721- transfer-ownership="none"
13722- nullable="1"
13723- allow-none="1">
26862+ <parameter name="description" transfer-ownership="none">
1372426863 <doc xml:space="preserve"
13725- filename="src/adw-message-dialog.c"
13726- line="2171">the default response ID</doc>
26864+ filename="src/adw-preferences-page.c"
26865+ line="457">the description</doc>
1372726866 <type name="utf8" c:type="const char*"/>
1372826867 </parameter>
1372926868 </parameters>
1373026869 </method>
13731- <method name="set_extra_child"
13732- c:identifier="adw_message_dialog_set_extra_child"
13733- glib:set-property="extra-child"
13734- version="1.2">
13735- <attribute name="org.gtk.Method.set_property" value="extra-child"/>
26870+ <method name="set_description_centered"
26871+ c:identifier="adw_preferences_page_set_description_centered"
26872+ glib:set-property="description-centered"
26873+ version="1.6">
1373626874 <doc xml:space="preserve"
13737- filename="src/adw-message-dialog.c"
13738- line="1769">Sets the child widget of @self.
13739-
13740-The child widget is displayed below the heading and body.</doc>
13741- <source-position filename="src/adw-message-dialog.h" line="96"/>
26875+ filename="src/adw-preferences-page.c"
26876+ line="597">Sets whether the description should be centered.</doc>
26877+ <source-position filename="src/adw-preferences-page.h" line="79"/>
1374226878 <return-value transfer-ownership="none">
1374326879 <type name="none" c:type="void"/>
1374426880 </return-value>
1374526881 <parameters>
1374626882 <instance-parameter name="self" transfer-ownership="none">
1374726883 <doc xml:space="preserve"
13748- filename="src/adw-message-dialog.c"
13749- line="1771">a message dialog</doc>
13750- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
26884+ filename="src/adw-preferences-page.c"
26885+ line="599">a preferences page</doc>
26886+ <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
1375126887 </instance-parameter>
13752- <parameter name="child"
13753- transfer-ownership="none"
13754- nullable="1"
13755- allow-none="1">
26888+ <parameter name="centered" transfer-ownership="none">
1375626889 <doc xml:space="preserve"
13757- filename="src/adw-message-dialog.c"
13758- line="1772">the child widget</doc>
13759- <type name="Gtk.Widget" c:type="GtkWidget*"/>
26890+ filename="src/adw-preferences-page.c"
26891+ line="600">If the description should be centered</doc>
26892+ <type name="gboolean" c:type="gboolean"/>
1376026893 </parameter>
1376126894 </parameters>
1376226895 </method>
13763- <method name="set_heading"
13764- c:identifier="adw_message_dialog_set_heading"
13765- glib:set-property="heading"
13766- version="1.2">
13767- <attribute name="org.gtk.Method.set_property" value="heading"/>
26896+ <method name="set_icon_name"
26897+ c:identifier="adw_preferences_page_set_icon_name"
26898+ glib:set-property="icon-name">
1376826899 <doc xml:space="preserve"
13769- filename="src/adw-message-dialog.c"
13770- line="1352">Sets the heading of @self.</doc>
13771- <source-position filename="src/adw-message-dialog.h" line="52"/>
26900+ filename="src/adw-preferences-page.c"
26901+ line="366">Sets the icon name for @self.</doc>
26902+ <source-position filename="src/adw-preferences-page.h" line="50"/>
1377226903 <return-value transfer-ownership="none">
1377326904 <type name="none" c:type="void"/>
1377426905 </return-value>
1377526906 <parameters>
1377626907 <instance-parameter name="self" transfer-ownership="none">
1377726908 <doc xml:space="preserve"
13778- filename="src/adw-message-dialog.c"
13779- line="1354">a message dialog</doc>
13780- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
26909+ filename="src/adw-preferences-page.c"
26910+ line="368">a preferences page</doc>
26911+ <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
1378126912 </instance-parameter>
13782- <parameter name="heading"
26913+ <parameter name="icon_name"
1378326914 transfer-ownership="none"
1378426915 nullable="1"
1378526916 allow-none="1">
1378626917 <doc xml:space="preserve"
13787- filename="src/adw-message-dialog.c"
13788- line="1355">the heading of @self</doc>
26918+ filename="src/adw-preferences-page.c"
26919+ line="369">the icon name</doc>
1378926920 <type name="utf8" c:type="const char*"/>
1379026921 </parameter>
1379126922 </parameters>
1379226923 </method>
13793- <method name="set_heading_use_markup"
13794- c:identifier="adw_message_dialog_set_heading_use_markup"
13795- glib:set-property="heading-use-markup"
13796- version="1.2">
13797- <attribute name="org.gtk.Method.set_property"
13798- value="heading-use-markup"/>
13799- <doc xml:space="preserve"
13800- filename="src/adw-message-dialog.c"
13801- line="1413">Sets whether the heading of @self includes Pango markup.
13802-
13803-See [func@Pango.parse_markup].</doc>
13804- <source-position filename="src/adw-message-dialog.h" line="58"/>
13805- <return-value transfer-ownership="none">
13806- <type name="none" c:type="void"/>
13807- </return-value>
13808- <parameters>
13809- <instance-parameter name="self" transfer-ownership="none">
13810- <doc xml:space="preserve"
13811- filename="src/adw-message-dialog.c"
13812- line="1415">a message dialog</doc>
13813- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
13814- </instance-parameter>
13815- <parameter name="use_markup" transfer-ownership="none">
13816- <doc xml:space="preserve"
13817- filename="src/adw-message-dialog.c"
13818- line="1416">whether to use markup for heading</doc>
13819- <type name="gboolean" c:type="gboolean"/>
13820- </parameter>
13821- </parameters>
13822- </method>
13823- <method name="set_response_appearance"
13824- c:identifier="adw_message_dialog_set_response_appearance"
13825- version="1.2">
26924+ <method name="set_name"
26925+ c:identifier="adw_preferences_page_set_name"
26926+ glib:set-property="name">
1382626927 <doc xml:space="preserve"
13827- filename="src/adw-message-dialog.c"
13828- line="2016">Sets the appearance for @response.
13829-
13830-&lt;picture&gt;
13831- &lt;source srcset="message-dialog-appearance-dark.png" media="(prefers-color-scheme: dark)"&gt;
13832- &lt;img src="message-dialog-appearance.png" alt="message-dialog-appearance"&gt;
13833-&lt;/picture&gt;
13834-
13835-Use `ADW_RESPONSE_SUGGESTED` to mark important responses such as the
13836-affirmative action, like the Save button in the example.
13837-
13838-Use `ADW_RESPONSE_DESTRUCTIVE` to draw attention to the potentially damaging
13839-consequences of using @response. This appearance acts as a warning to the
13840-user. The Discard button in the example is using this appearance.
13841-
13842-The default appearance is `ADW_RESPONSE_DEFAULT`.
13843-
13844-Negative responses like Cancel or Close should use the default appearance.</doc>
13845- <source-position filename="src/adw-message-dialog.h" line="121"/>
26928+ filename="src/adw-preferences-page.c"
26929+ line="505">Sets the name of @self.</doc>
26930+ <source-position filename="src/adw-preferences-page.h" line="68"/>
1384626931 <return-value transfer-ownership="none">
1384726932 <type name="none" c:type="void"/>
1384826933 </return-value>
1384926934 <parameters>
1385026935 <instance-parameter name="self" transfer-ownership="none">
1385126936 <doc xml:space="preserve"
13852- filename="src/adw-message-dialog.c"
13853- line="2018">a message dialog</doc>
13854- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
26937+ filename="src/adw-preferences-page.c"
26938+ line="507">a preferences page</doc>
26939+ <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
1385526940 </instance-parameter>
13856- <parameter name="response" transfer-ownership="none">
26941+ <parameter name="name"
26942+ transfer-ownership="none"
26943+ nullable="1"
26944+ allow-none="1">
1385726945 <doc xml:space="preserve"
13858- filename="src/adw-message-dialog.c"
13859- line="2019">a response ID</doc>
26946+ filename="src/adw-preferences-page.c"
26947+ line="508">the name</doc>
1386026948 <type name="utf8" c:type="const char*"/>
1386126949 </parameter>
13862- <parameter name="appearance" transfer-ownership="none">
13863- <doc xml:space="preserve"
13864- filename="src/adw-message-dialog.c"
13865- line="2020">appearance for @response</doc>
13866- <type name="ResponseAppearance" c:type="AdwResponseAppearance"/>
13867- </parameter>
1386826950 </parameters>
1386926951 </method>
13870- <method name="set_response_enabled"
13871- c:identifier="adw_message_dialog_set_response_enabled"
13872- version="1.2">
26952+ <method name="set_title"
26953+ c:identifier="adw_preferences_page_set_title"
26954+ glib:set-property="title">
1387326955 <doc xml:space="preserve"
13874- filename="src/adw-message-dialog.c"
13875- line="2101">Sets whether @response is enabled.
13876-
13877-If @response is not enabled, the corresponding button will have
13878-[property@Gtk.Widget:sensitive] set to `FALSE` and it can't be activated as
13879-a default response.
13880-
13881-@response can still be used as [property@MessageDialog:close-response] while
13882-it's not enabled.
13883-
13884-Responses are enabled by default.</doc>
13885- <source-position filename="src/adw-message-dialog.h" line="129"/>
26956+ filename="src/adw-preferences-page.c"
26957+ line="409">Sets the title of @self.</doc>
26958+ <source-position filename="src/adw-preferences-page.h" line="56"/>
1388626959 <return-value transfer-ownership="none">
1388726960 <type name="none" c:type="void"/>
1388826961 </return-value>
1388926962 <parameters>
1389026963 <instance-parameter name="self" transfer-ownership="none">
1389126964 <doc xml:space="preserve"
13892- filename="src/adw-message-dialog.c"
13893- line="2103">a message dialog</doc>
13894- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
26965+ filename="src/adw-preferences-page.c"
26966+ line="411">a preferences page</doc>
26967+ <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
1389526968 </instance-parameter>
13896- <parameter name="response" transfer-ownership="none">
26969+ <parameter name="title" transfer-ownership="none">
1389726970 <doc xml:space="preserve"
13898- filename="src/adw-message-dialog.c"
13899- line="2104">a response ID</doc>
26971+ filename="src/adw-preferences-page.c"
26972+ line="412">the title</doc>
1390026973 <type name="utf8" c:type="const char*"/>
1390126974 </parameter>
13902- <parameter name="enabled" transfer-ownership="none">
13903- <doc xml:space="preserve"
13904- filename="src/adw-message-dialog.c"
13905- line="2105">whether to enable @response</doc>
13906- <type name="gboolean" c:type="gboolean"/>
13907- </parameter>
1390826975 </parameters>
1390926976 </method>
13910- <method name="set_response_label"
13911- c:identifier="adw_message_dialog_set_response_label"
13912- version="1.2">
26977+ <method name="set_use_underline"
26978+ c:identifier="adw_preferences_page_set_use_underline"
26979+ glib:set-property="use-underline">
1391326980 <doc xml:space="preserve"
13914- filename="src/adw-message-dialog.c"
13915- line="1955">Sets the label of @response to @label.
13916-
13917-Labels are displayed on the dialog buttons. An embedded underline in @label
13918-indicates a mnemonic.</doc>
13919- <source-position filename="src/adw-message-dialog.h" line="113"/>
26981+ filename="src/adw-preferences-page.c"
26982+ line="548">Sets whether an embedded underline in the title indicates a mnemonic.</doc>
26983+ <source-position filename="src/adw-preferences-page.h" line="74"/>
1392026984 <return-value transfer-ownership="none">
1392126985 <type name="none" c:type="void"/>
1392226986 </return-value>
1392326987 <parameters>
1392426988 <instance-parameter name="self" transfer-ownership="none">
1392526989 <doc xml:space="preserve"
13926- filename="src/adw-message-dialog.c"
13927- line="1957">a message dialog</doc>
13928- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
26990+ filename="src/adw-preferences-page.c"
26991+ line="550">a preferences page</doc>
26992+ <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
1392926993 </instance-parameter>
13930- <parameter name="response" transfer-ownership="none">
13931- <doc xml:space="preserve"
13932- filename="src/adw-message-dialog.c"
13933- line="1958">a response ID</doc>
13934- <type name="utf8" c:type="const char*"/>
13935- </parameter>
13936- <parameter name="label" transfer-ownership="none">
26994+ <parameter name="use_underline" transfer-ownership="none">
1393726995 <doc xml:space="preserve"
13938- filename="src/adw-message-dialog.c"
13939- line="1959">the label of @response</doc>
13940- <type name="utf8" c:type="const char*"/>
26996+ filename="src/adw-preferences-page.c"
26997+ line="551">`TRUE` if underlines in the text indicate mnemonics</doc>
26998+ <type name="gboolean" c:type="gboolean"/>
1394126999 </parameter>
1394227000 </parameters>
1394327001 </method>
13944- <property name="body"
13945- version="1.2"
27002+ <property name="description"
27003+ version="1.4"
1394627004 writable="1"
1394727005 transfer-ownership="none"
13948- setter="set_body"
13949- getter="get_body">
13950- <attribute name="org.gtk.Property.get"
13951- value="adw_message_dialog_get_body"/>
13952- <attribute name="org.gtk.Property.set"
13953- value="adw_message_dialog_set_body"/>
27006+ setter="set_description"
27007+ getter="get_description">
1395427008 <doc xml:space="preserve"
13955- filename="src/adw-message-dialog.c"
13956- line="897">The body text of the dialog.</doc>
27009+ filename="src/adw-preferences-page.c"
27010+ line="199">The description to be displayed at the top of the page.</doc>
1395727011 <type name="utf8" c:type="gchar*"/>
1395827012 </property>
13959- <property name="body-use-markup"
13960- version="1.2"
27013+ <property name="description-centered"
27014+ version="1.6"
1396127015 writable="1"
1396227016 transfer-ownership="none"
13963- setter="set_body_use_markup"
13964- getter="get_body_use_markup"
27017+ setter="set_description_centered"
27018+ getter="get_description_centered"
1396527019 default-value="FALSE">
13966- <attribute name="org.gtk.Property.get"
13967- value="adw_message_dialog_get_body_use_markup"/>
13968- <attribute name="org.gtk.Property.set"
13969- value="adw_message_dialog_set_body_use_markup"/>
1397027020 <doc xml:space="preserve"
13971- filename="src/adw-message-dialog.c"
13972- line="909">Whether the body text includes Pango markup.
13973-
13974-See [func@Pango.parse_markup].</doc>
27021+ filename="src/adw-preferences-page.c"
27022+ line="231">Whether the description should be centered.</doc>
1397527023 <type name="gboolean" c:type="gboolean"/>
1397627024 </property>
13977- <property name="close-response"
13978- version="1.2"
13979- writable="1"
13980- transfer-ownership="none"
13981- setter="set_close_response"
13982- getter="get_close_response"
13983- default-value="close">
13984- <attribute name="org.gtk.Property.get"
13985- value="adw_message_dialog_get_close_response"/>
13986- <attribute name="org.gtk.Property.set"
13987- value="adw_message_dialog_set_close_response"/>
13988- <doc xml:space="preserve"
13989- filename="src/adw-message-dialog.c"
13990- line="954">The ID of the close response.
13991-
13992-It will be passed to [signal@MessageDialog::response] if the window is
13993-closed by pressing &lt;kbd&gt;Escape&lt;/kbd&gt; or with a system action.
13994-
13995-It doesn't have to correspond to any of the responses in the dialog.
13996-
13997-The default close response is `close`.</doc>
13998- <type name="utf8" c:type="gchar*"/>
13999- </property>
14000- <property name="default-response"
14001- version="1.2"
27025+ <property name="icon-name"
1400227026 writable="1"
1400327027 transfer-ownership="none"
14004- setter="set_default_response"
14005- getter="get_default_response"
14006- default-value="NULL">
14007- <attribute name="org.gtk.Property.get"
14008- value="adw_message_dialog_get_default_response"/>
14009- <attribute name="org.gtk.Property.set"
14010- value="adw_message_dialog_set_default_response"/>
27028+ setter="set_icon_name"
27029+ getter="get_icon_name">
1401127030 <doc xml:space="preserve"
14012- filename="src/adw-message-dialog.c"
14013- line="937">The response ID of the default response.
14014-
14015-If set, pressing &lt;kbd&gt;Enter&lt;/kbd&gt; will activate the corresponding button.
14016-
14017-If set to `NULL` or a non-existent response ID, pressing &lt;kbd&gt;Enter&lt;/kbd&gt;
14018-will do nothing.</doc>
27031+ filename="src/adw-preferences-page.c"
27032+ line="179">The icon name for this page.</doc>
1401927033 <type name="utf8" c:type="gchar*"/>
1402027034 </property>
14021- <property name="extra-child"
14022- version="1.2"
27035+ <property name="name"
1402327036 writable="1"
1402427037 transfer-ownership="none"
14025- setter="set_extra_child"
14026- getter="get_extra_child">
14027- <attribute name="org.gtk.Property.get"
14028- value="adw_message_dialog_get_extra_child"/>
14029- <attribute name="org.gtk.Property.set"
14030- value="adw_message_dialog_set_extra_child"/>
27038+ setter="set_name"
27039+ getter="get_name"
27040+ default-value="NULL">
1403127041 <doc xml:space="preserve"
14032- filename="src/adw-message-dialog.c"
14033- line="923">The child widget.
14034-
14035-Displayed below the heading and body.</doc>
14036- <type name="Gtk.Widget"/>
27042+ filename="src/adw-preferences-page.c"
27043+ line="211">The name of this page.</doc>
27044+ <type name="utf8" c:type="gchar*"/>
1403727045 </property>
14038- <property name="heading"
14039- version="1.2"
27046+ <property name="title"
1404027047 writable="1"
1404127048 transfer-ownership="none"
14042- setter="set_heading"
14043- getter="get_heading">
14044- <attribute name="org.gtk.Property.get"
14045- value="adw_message_dialog_get_heading"/>
14046- <attribute name="org.gtk.Property.set"
14047- value="adw_message_dialog_set_heading"/>
27049+ setter="set_title"
27050+ getter="get_title">
1404827051 <doc xml:space="preserve"
14049- filename="src/adw-message-dialog.c"
14050- line="871">The heading of the dialog.</doc>
27052+ filename="src/adw-preferences-page.c"
27053+ line="189">The title for this page.</doc>
1405127054 <type name="utf8" c:type="gchar*"/>
1405227055 </property>
14053- <property name="heading-use-markup"
14054- version="1.2"
27056+ <property name="use-underline"
1405527057 writable="1"
1405627058 transfer-ownership="none"
14057- setter="set_heading_use_markup"
14058- getter="get_heading_use_markup"
27059+ setter="set_use_underline"
27060+ getter="get_use_underline"
1405927061 default-value="FALSE">
14060- <attribute name="org.gtk.Property.get"
14061- value="adw_message_dialog_get_heading_use_markup"/>
14062- <attribute name="org.gtk.Property.set"
14063- value="adw_message_dialog_set_heading_use_markup"/>
1406427062 <doc xml:space="preserve"
14065- filename="src/adw-message-dialog.c"
14066- line="883">Whether the heading includes Pango markup.
14067-
14068-See [func@Pango.parse_markup].</doc>
27063+ filename="src/adw-preferences-page.c"
27064+ line="221">Whether an embedded underline in the title indicates a mnemonic.</doc>
1406927065 <type name="gboolean" c:type="gboolean"/>
1407027066 </property>
1407127067 <field name="parent_instance">
14072- <type name="Gtk.Window" c:type="GtkWindow"/>
27068+ <type name="Gtk.Widget" c:type="GtkWidget"/>
1407327069 </field>
14074- <glib:signal name="response" when="last" detailed="1" version="1.2">
14075- <doc xml:space="preserve"
14076- filename="src/adw-message-dialog.c"
14077- line="975">This signal is emitted when the dialog is closed.
14078-
14079-@response will be set to the response ID of the button that had been
14080-activated.
14081-
14082-if the dialog was closed by pressing &lt;kbd&gt;Escape&lt;/kbd&gt; or with a system
14083-action, @response will be set to the value of
14084-[property@MessageDialog:close-response].</doc>
14085- <return-value transfer-ownership="none">
14086- <type name="none" c:type="void"/>
14087- </return-value>
14088- <parameters>
14089- <parameter name="response" transfer-ownership="none">
14090- <doc xml:space="preserve"
14091- filename="src/adw-message-dialog.c"
14092- line="978">the response ID</doc>
14093- <type name="utf8" c:type="gchar*"/>
14094- </parameter>
14095- </parameters>
14096- </glib:signal>
1409727070 </class>
14098- <record name="MessageDialogClass"
14099- c:type="AdwMessageDialogClass"
14100- glib:is-gtype-struct-for="MessageDialog">
14101- <source-position filename="src/adw-message-dialog.h" line="42"/>
27071+ <record name="PreferencesPageClass"
27072+ c:type="AdwPreferencesPageClass"
27073+ glib:is-gtype-struct-for="PreferencesPage">
27074+ <source-position filename="src/adw-preferences-page.h" line="35"/>
1410227075 <field name="parent_class">
14103- <type name="Gtk.WindowClass" c:type="GtkWindowClass"/>
14104- </field>
14105- <field name="response">
14106- <callback name="response">
14107- <source-position filename="src/adw-message-dialog.h" line="37"/>
14108- <return-value transfer-ownership="none">
14109- <type name="none" c:type="void"/>
14110- </return-value>
14111- <parameters>
14112- <parameter name="self" transfer-ownership="none">
14113- <doc xml:space="preserve"
14114- filename="src/adw-message-dialog.c"
14115- line="2269">a message dialog</doc>
14116- <type name="MessageDialog" c:type="AdwMessageDialog*"/>
14117- </parameter>
14118- <parameter name="response" transfer-ownership="none">
14119- <doc xml:space="preserve"
14120- filename="src/adw-message-dialog.c"
14121- line="2270">response ID</doc>
14122- <type name="utf8" c:type="const char*"/>
14123- </parameter>
14124- </parameters>
14125- </callback>
27076+ <doc xml:space="preserve"
27077+ filename="src/adw-preferences-page.h"
27078+ line="27">The parent class</doc>
27079+ <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
1412627080 </field>
1412727081 <field name="padding" readable="0" private="1">
1412827082 <array zero-terminated="0" fixed-size="4">
@@ -14130,798 +27084,867 @@ action, @response will be set to the value of
1413027084 </array>
1413127085 </field>
1413227086 </record>
14133- <enumeration name="NavigationDirection"
14134- glib:type-name="AdwNavigationDirection"
14135- glib:get-type="adw_navigation_direction_get_type"
14136- c:type="AdwNavigationDirection">
14137- <doc xml:space="preserve"
14138- filename="src/adw-navigation-direction.c"
14139- line="10">Describes the direction of a swipe navigation gesture.</doc>
14140- <member name="back"
14141- value="0"
14142- c:identifier="ADW_NAVIGATION_DIRECTION_BACK"
14143- glib:nick="back"
14144- glib:name="ADW_NAVIGATION_DIRECTION_BACK">
14145- <doc xml:space="preserve"
14146- filename="src/adw-navigation-direction.c"
14147- line="12">Corresponds to start or top, depending on orientation and text direction</doc>
14148- </member>
14149- <member name="forward"
14150- value="1"
14151- c:identifier="ADW_NAVIGATION_DIRECTION_FORWARD"
14152- glib:nick="forward"
14153- glib:name="ADW_NAVIGATION_DIRECTION_FORWARD">
14154- <doc xml:space="preserve"
14155- filename="src/adw-navigation-direction.c"
14156- line="13">Corresponds to end or bottom, depending on orientation and text direction</doc>
14157- </member>
14158- </enumeration>
14159- <class name="PasswordEntryRow"
14160- c:symbol-prefix="password_entry_row"
14161- c:type="AdwPasswordEntryRow"
14162- version="1.2"
14163- parent="EntryRow"
14164- final="1"
14165- glib:type-name="AdwPasswordEntryRow"
14166- glib:get-type="adw_password_entry_row_get_type"
14167- glib:type-struct="PasswordEntryRowClass">
27087+ <class name="PreferencesRow"
27088+ c:symbol-prefix="preferences_row"
27089+ c:type="AdwPreferencesRow"
27090+ parent="Gtk.ListBoxRow"
27091+ glib:type-name="AdwPreferencesRow"
27092+ glib:get-type="adw_preferences_row_get_type"
27093+ glib:type-struct="PreferencesRowClass">
1416827094 <doc xml:space="preserve"
14169- filename="src/adw-password-entry-row.c"
14170- line="15">A [class@EntryRow] tailored for entering secrets.
14171-
14172-&lt;picture&gt;
14173- &lt;source srcset="password-entry-row-dark.png" media="(prefers-color-scheme: dark)"&gt;
14174- &lt;img src="password-entry-row.png" alt="password-entry-row"&gt;
14175-&lt;/picture&gt;
14176-
14177-It does not show its contents in clear text, does not allow to copy it to the
14178-clipboard, and shows a warning when Caps Lock is engaged. If the underlying
14179-platform allows it, `AdwPasswordEntryRow` will also place the text in a
14180-non-pageable memory area, to avoid it being written out to disk by the
14181-operating system.
14182-
14183-It offer a way to reveal the contents in clear text.
27095+ filename="src/adw-preferences-row.c"
27096+ line="11">A [class@Gtk.ListBoxRow] used to present preferences.
1418427097
14185-## CSS Nodes
27098+The `AdwPreferencesRow` widget has a title that [class@PreferencesDialog]
27099+will use to let the user look for a preference. It doesn't present the title
27100+in any way and lets you present the preference as you please.
1418627101
14187-`AdwPasswordEntryRow` has a single CSS node with name `row` that carries
14188-`.entry` and `.password` style classes.</doc>
14189- <source-position filename="src/adw-password-entry-row.h" line="24"/>
27102+[class@ActionRow] and its derivatives are convenient to use as preference
27103+rows as they take care of presenting the preference's title while letting you
27104+compose the inputs of the preference around it.</doc>
27105+ <source-position filename="src/adw-preferences-row.h" line="34"/>
1419027106 <implements name="Gtk.Accessible"/>
1419127107 <implements name="Gtk.Actionable"/>
1419227108 <implements name="Gtk.Buildable"/>
1419327109 <implements name="Gtk.ConstraintTarget"/>
14194- <implements name="Gtk.Editable"/>
14195- <constructor name="new"
14196- c:identifier="adw_password_entry_row_new"
14197- version="1.2">
14198- <doc xml:space="preserve"
14199- filename="src/adw-password-entry-row.c"
14200- line="189">Creates a new `AdwPasswordEntryRow`.</doc>
14201- <source-position filename="src/adw-password-entry-row.h" line="27"/>
14202- <return-value transfer-ownership="none">
14203- <doc xml:space="preserve"
14204- filename="src/adw-password-entry-row.c"
14205- line="194">the newly created `AdwPasswordEntryRow`</doc>
14206- <type name="Gtk.Widget" c:type="GtkWidget*"/>
14207- </return-value>
14208- </constructor>
14209- </class>
14210- <record name="PasswordEntryRowClass"
14211- c:type="AdwPasswordEntryRowClass"
14212- glib:is-gtype-struct-for="PasswordEntryRow">
14213- <source-position filename="src/adw-password-entry-row.h" line="24"/>
14214- <field name="parent_class">
14215- <type name="EntryRowClass" c:type="AdwEntryRowClass"/>
14216- </field>
14217- </record>
14218- <class name="PreferencesGroup"
14219- c:symbol-prefix="preferences_group"
14220- c:type="AdwPreferencesGroup"
14221- parent="Gtk.Widget"
14222- glib:type-name="AdwPreferencesGroup"
14223- glib:get-type="adw_preferences_group_get_type"
14224- glib:type-struct="PreferencesGroupClass">
14225- <doc xml:space="preserve"
14226- filename="src/adw-preferences-group.c"
14227- line="14">A group of preference rows.
14228-
14229-&lt;picture&gt;
14230- &lt;source srcset="preferences-group-dark.png" media="(prefers-color-scheme: dark)"&gt;
14231- &lt;img src="preferences-group.png" alt="preferences-group"&gt;
14232-&lt;/picture&gt;
14233-
14234-An `AdwPreferencesGroup` represents a group or tightly related preferences,
14235-which in turn are represented by [class@PreferencesRow].
14236-
14237-To summarize the role of the preferences it gathers, a group can have both a
14238-title and a description. The title will be used by [class@PreferencesWindow]
14239-to let the user look for a preference.
14240-
14241-## AdwPreferencesGroup as GtkBuildable
14242-
14243-The `AdwPreferencesGroup` implementation of the [iface@Gtk.Buildable] interface
14244-supports adding [class@PreferencesRow]s to the list by omitting "type". If "type"
14245-is omitted and the widget isn't a [class@PreferencesRow] the child is added to
14246-a box below the list.
14247-
14248-When the "type" attribute of a child is `header-suffix`, the child
14249-is set as the suffix on the end of the title and description.
14250-
14251-## CSS nodes
14252-
14253-`AdwPreferencesGroup` has a single CSS node with name `preferencesgroup`.
14254-
14255-## Accessibility
14256-
14257-`AdwPreferencesGroup` uses the `GTK_ACCESSIBLE_ROLE_GROUP` role.</doc>
14258- <source-position filename="src/adw-preferences-group.h" line="34"/>
14259- <implements name="Gtk.Accessible"/>
14260- <implements name="Gtk.Buildable"/>
14261- <implements name="Gtk.ConstraintTarget"/>
14262- <constructor name="new" c:identifier="adw_preferences_group_new">
27110+ <constructor name="new" c:identifier="adw_preferences_row_new">
1426327111 <doc xml:space="preserve"
14264- filename="src/adw-preferences-group.c"
14265- line="349">Creates a new `AdwPreferencesGroup`.</doc>
14266- <source-position filename="src/adw-preferences-group.h" line="37"/>
27112+ filename="src/adw-preferences-row.c"
27113+ line="182">Creates a new `AdwPreferencesRow`.</doc>
27114+ <source-position filename="src/adw-preferences-row.h" line="37"/>
1426727115 <return-value transfer-ownership="none">
1426827116 <doc xml:space="preserve"
14269- filename="src/adw-preferences-group.c"
14270- line="354">the newly created `AdwPreferencesGroup`</doc>
27117+ filename="src/adw-preferences-row.c"
27118+ line="187">the newly created `AdwPreferencesRow`</doc>
1427127119 <type name="Gtk.Widget" c:type="GtkWidget*"/>
1427227120 </return-value>
1427327121 </constructor>
14274- <method name="add" c:identifier="adw_preferences_group_add">
27122+ <method name="get_title"
27123+ c:identifier="adw_preferences_row_get_title"
27124+ glib:get-property="title">
1427527125 <doc xml:space="preserve"
14276- filename="src/adw-preferences-group.c"
14277- line="362">Adds a child to @self.</doc>
14278- <source-position filename="src/adw-preferences-group.h" line="40"/>
27126+ filename="src/adw-preferences-row.c"
27127+ line="195">Gets the title of the preference represented by @self.</doc>
27128+ <source-position filename="src/adw-preferences-row.h" line="40"/>
1427927129 <return-value transfer-ownership="none">
14280- <type name="none" c:type="void"/>
27130+ <doc xml:space="preserve"
27131+ filename="src/adw-preferences-row.c"
27132+ line="201">the title</doc>
27133+ <type name="utf8" c:type="const char*"/>
1428127134 </return-value>
1428227135 <parameters>
1428327136 <instance-parameter name="self" transfer-ownership="none">
1428427137 <doc xml:space="preserve"
14285- filename="src/adw-preferences-group.c"
14286- line="364">a preferences group</doc>
14287- <type name="PreferencesGroup" c:type="AdwPreferencesGroup*"/>
27138+ filename="src/adw-preferences-row.c"
27139+ line="197">a preferences row</doc>
27140+ <type name="PreferencesRow" c:type="AdwPreferencesRow*"/>
1428827141 </instance-parameter>
14289- <parameter name="child" transfer-ownership="none">
14290- <doc xml:space="preserve"
14291- filename="src/adw-preferences-group.c"
14292- line="365">the widget to add</doc>
14293- <type name="Gtk.Widget" c:type="GtkWidget*"/>
14294- </parameter>
1429527142 </parameters>
1429627143 </method>
14297- <method name="get_description"
14298- c:identifier="adw_preferences_group_get_description"
14299- glib:get-property="description">
14300- <attribute name="org.gtk.Method.get_property" value="description"/>
27144+ <method name="get_title_selectable"
27145+ c:identifier="adw_preferences_row_get_title_selectable"
27146+ glib:get-property="title-selectable"
27147+ version="1.1">
1430127148 <doc xml:space="preserve"
14302- filename="src/adw-preferences-group.c"
14303- line="462">Gets the description of @self.</doc>
14304- <source-position filename="src/adw-preferences-group.h" line="53"/>
14305- <return-value transfer-ownership="none" nullable="1">
27149+ filename="src/adw-preferences-row.c"
27150+ line="288">Gets whether the user can copy the title from the label</doc>
27151+ <source-position filename="src/adw-preferences-row.h" line="52"/>
27152+ <return-value transfer-ownership="none">
1430627153 <doc xml:space="preserve"
14307- filename="src/adw-preferences-group.c"
14308- line="468">the description of @self</doc>
14309- <type name="utf8" c:type="const char*"/>
27154+ filename="src/adw-preferences-row.c"
27155+ line="294">whether the user can copy the title from the label</doc>
27156+ <type name="gboolean" c:type="gboolean"/>
1431027157 </return-value>
1431127158 <parameters>
1431227159 <instance-parameter name="self" transfer-ownership="none">
1431327160 <doc xml:space="preserve"
14314- filename="src/adw-preferences-group.c"
14315- line="464">a preferences group</doc>
14316- <type name="PreferencesGroup" c:type="AdwPreferencesGroup*"/>
27161+ filename="src/adw-preferences-row.c"
27162+ line="290">a preferences row</doc>
27163+ <type name="PreferencesRow" c:type="AdwPreferencesRow*"/>
1431727164 </instance-parameter>
1431827165 </parameters>
1431927166 </method>
14320- <method name="get_header_suffix"
14321- c:identifier="adw_preferences_group_get_header_suffix"
14322- glib:get-property="header-suffix"
14323- version="1.1">
27167+ <method name="get_use_markup"
27168+ c:identifier="adw_preferences_row_get_use_markup"
27169+ glib:get-property="use-markup"
27170+ version="1.2">
1432427171 <doc xml:space="preserve"
14325- filename="src/adw-preferences-group.c"
14326- line="509">Gets the suffix for @self's header.</doc>
14327- <source-position filename="src/adw-preferences-group.h" line="59"/>
14328- <return-value transfer-ownership="none" nullable="1">
27172+ filename="src/adw-preferences-row.c"
27173+ line="337">Gets whether to use Pango markup for the title label.</doc>
27174+ <source-position filename="src/adw-preferences-row.h" line="59"/>
27175+ <return-value transfer-ownership="none">
1432927176 <doc xml:space="preserve"
14330- filename="src/adw-preferences-group.c"
14331- line="515">the suffix for @self's header.</doc>
14332- <type name="Gtk.Widget" c:type="GtkWidget*"/>
27177+ filename="src/adw-preferences-row.c"
27178+ line="343">whether to use markup</doc>
27179+ <type name="gboolean" c:type="gboolean"/>
1433327180 </return-value>
1433427181 <parameters>
1433527182 <instance-parameter name="self" transfer-ownership="none">
1433627183 <doc xml:space="preserve"
14337- filename="src/adw-preferences-group.c"
14338- line="511">a `AdwPreferencesGroup`</doc>
14339- <type name="PreferencesGroup" c:type="AdwPreferencesGroup*"/>
27184+ filename="src/adw-preferences-row.c"
27185+ line="339">a preferences row</doc>
27186+ <type name="PreferencesRow" c:type="AdwPreferencesRow*"/>
1434027187 </instance-parameter>
1434127188 </parameters>
1434227189 </method>
14343- <method name="get_title"
14344- c:identifier="adw_preferences_group_get_title"
14345- glib:get-property="title">
14346- <attribute name="org.gtk.Method.get_property" value="title"/>
27190+ <method name="get_use_underline"
27191+ c:identifier="adw_preferences_row_get_use_underline"
27192+ glib:get-property="use-underline">
1434727193 <doc xml:space="preserve"
14348- filename="src/adw-preferences-group.c"
14349- line="415">Gets the title of @self.</doc>
14350- <source-position filename="src/adw-preferences-group.h" line="47"/>
27194+ filename="src/adw-preferences-row.c"
27195+ line="241">Gets whether an embedded underline in the title indicates a mnemonic.</doc>
27196+ <source-position filename="src/adw-preferences-row.h" line="46"/>
1435127197 <return-value transfer-ownership="none">
1435227198 <doc xml:space="preserve"
14353- filename="src/adw-preferences-group.c"
14354- line="421">the title of @self</doc>
14355- <type name="utf8" c:type="const char*"/>
27199+ filename="src/adw-preferences-row.c"
27200+ line="247">whether an embedded underline in the title indicates a mnemonic</doc>
27201+ <type name="gboolean" c:type="gboolean"/>
1435627202 </return-value>
1435727203 <parameters>
1435827204 <instance-parameter name="self" transfer-ownership="none">
1435927205 <doc xml:space="preserve"
14360- filename="src/adw-preferences-group.c"
14361- line="417">a preferences group</doc>
14362- <type name="PreferencesGroup" c:type="AdwPreferencesGroup*"/>
27206+ filename="src/adw-preferences-row.c"
27207+ line="243">a preferences row</doc>
27208+ <type name="PreferencesRow" c:type="AdwPreferencesRow*"/>
1436327209 </instance-parameter>
1436427210 </parameters>
1436527211 </method>
14366- <method name="remove" c:identifier="adw_preferences_group_remove">
27212+ <method name="set_title"
27213+ c:identifier="adw_preferences_row_set_title"
27214+ glib:set-property="title">
1436727215 <doc xml:space="preserve"
14368- filename="src/adw-preferences-group.c"
14369- line="386">Removes a child from @self.</doc>
14370- <source-position filename="src/adw-preferences-group.h" line="43"/>
27216+ filename="src/adw-preferences-row.c"
27217+ line="215">Sets the title of the preference represented by @self.
27218+
27219+The title is interpreted as Pango markup unless
27220+[property@PreferencesRow:use-markup] is set to `FALSE`.</doc>
27221+ <source-position filename="src/adw-preferences-row.h" line="42"/>
1437127222 <return-value transfer-ownership="none">
1437227223 <type name="none" c:type="void"/>
1437327224 </return-value>
1437427225 <parameters>
1437527226 <instance-parameter name="self" transfer-ownership="none">
1437627227 <doc xml:space="preserve"
14377- filename="src/adw-preferences-group.c"
14378- line="388">a preferences group</doc>
14379- <type name="PreferencesGroup" c:type="AdwPreferencesGroup*"/>
27228+ filename="src/adw-preferences-row.c"
27229+ line="217">a preferences row</doc>
27230+ <type name="PreferencesRow" c:type="AdwPreferencesRow*"/>
1438027231 </instance-parameter>
14381- <parameter name="child" transfer-ownership="none">
27232+ <parameter name="title" transfer-ownership="none">
1438227233 <doc xml:space="preserve"
14383- filename="src/adw-preferences-group.c"
14384- line="389">the child to remove</doc>
14385- <type name="Gtk.Widget" c:type="GtkWidget*"/>
27234+ filename="src/adw-preferences-row.c"
27235+ line="218">the title</doc>
27236+ <type name="utf8" c:type="const char*"/>
1438627237 </parameter>
1438727238 </parameters>
1438827239 </method>
14389- <method name="set_description"
14390- c:identifier="adw_preferences_group_set_description"
14391- glib:set-property="description">
14392- <attribute name="org.gtk.Method.set_property" value="description"/>
27240+ <method name="set_title_selectable"
27241+ c:identifier="adw_preferences_row_set_title_selectable"
27242+ glib:set-property="title-selectable"
27243+ version="1.1">
1439327244 <doc xml:space="preserve"
14394- filename="src/adw-preferences-group.c"
14395- line="482">Sets the description for @self.</doc>
14396- <source-position filename="src/adw-preferences-group.h" line="55"/>
27245+ filename="src/adw-preferences-row.c"
27246+ line="308">Sets whether the user can copy the title from the label
27247+
27248+See also [property@Gtk.Label:selectable].</doc>
27249+ <source-position filename="src/adw-preferences-row.h" line="54"/>
1439727250 <return-value transfer-ownership="none">
1439827251 <type name="none" c:type="void"/>
1439927252 </return-value>
1440027253 <parameters>
1440127254 <instance-parameter name="self" transfer-ownership="none">
1440227255 <doc xml:space="preserve"
14403- filename="src/adw-preferences-group.c"
14404- line="484">a preferences group</doc>
14405- <type name="PreferencesGroup" c:type="AdwPreferencesGroup*"/>
27256+ filename="src/adw-preferences-row.c"
27257+ line="310">a preferences row</doc>
27258+ <type name="PreferencesRow" c:type="AdwPreferencesRow*"/>
1440627259 </instance-parameter>
14407- <parameter name="description"
14408- transfer-ownership="none"
14409- nullable="1"
14410- allow-none="1">
27260+ <parameter name="title_selectable" transfer-ownership="none">
1441127261 <doc xml:space="preserve"
14412- filename="src/adw-preferences-group.c"
14413- line="485">the description</doc>
14414- <type name="utf8" c:type="const char*"/>
27262+ filename="src/adw-preferences-row.c"
27263+ line="311">`TRUE` if the user can copy the title from the label</doc>
27264+ <type name="gboolean" c:type="gboolean"/>
1441527265 </parameter>
1441627266 </parameters>
1441727267 </method>
14418- <method name="set_header_suffix"
14419- c:identifier="adw_preferences_group_set_header_suffix"
14420- glib:set-property="header-suffix"
14421- version="1.1">
27268+ <method name="set_use_markup"
27269+ c:identifier="adw_preferences_row_set_use_markup"
27270+ glib:set-property="use-markup"
27271+ version="1.2">
1442227272 <doc xml:space="preserve"
14423- filename="src/adw-preferences-group.c"
14424- line="531">Sets the suffix for @self's header.
27273+ filename="src/adw-preferences-row.c"
27274+ line="359">Sets whether to use Pango markup for the title label.
1442527275
14426-Displayed above the list, next to the title and description.
27276+Subclasses may also use it for other labels, such as subtitle.
1442727277
14428-Suffixes are commonly used to show a button or a spinner for the whole group.</doc>
14429- <source-position filename="src/adw-preferences-group.h" line="61"/>
27278+See also [func@Pango.parse_markup].</doc>
27279+ <source-position filename="src/adw-preferences-row.h" line="61"/>
1443027280 <return-value transfer-ownership="none">
1443127281 <type name="none" c:type="void"/>
1443227282 </return-value>
1443327283 <parameters>
1443427284 <instance-parameter name="self" transfer-ownership="none">
1443527285 <doc xml:space="preserve"
14436- filename="src/adw-preferences-group.c"
14437- line="533">a `AdwPreferencesGroup`</doc>
14438- <type name="PreferencesGroup" c:type="AdwPreferencesGroup*"/>
27286+ filename="src/adw-preferences-row.c"
27287+ line="361">a preferences row</doc>
27288+ <type name="PreferencesRow" c:type="AdwPreferencesRow*"/>
1443927289 </instance-parameter>
14440- <parameter name="suffix"
14441- transfer-ownership="none"
14442- nullable="1"
14443- allow-none="1">
27290+ <parameter name="use_markup" transfer-ownership="none">
1444427291 <doc xml:space="preserve"
14445- filename="src/adw-preferences-group.c"
14446- line="534">the suffix to set</doc>
14447- <type name="Gtk.Widget" c:type="GtkWidget*"/>
27292+ filename="src/adw-preferences-row.c"
27293+ line="362">whether to use markup</doc>
27294+ <type name="gboolean" c:type="gboolean"/>
1444827295 </parameter>
1444927296 </parameters>
1445027297 </method>
14451- <method name="set_title"
14452- c:identifier="adw_preferences_group_set_title"
14453- glib:set-property="title">
14454- <attribute name="org.gtk.Method.set_property" value="title"/>
27298+ <method name="set_use_underline"
27299+ c:identifier="adw_preferences_row_set_use_underline"
27300+ glib:set-property="use-underline">
1445527301 <doc xml:space="preserve"
14456- filename="src/adw-preferences-group.c"
14457- line="435">Sets the title for @self.</doc>
14458- <source-position filename="src/adw-preferences-group.h" line="49"/>
27302+ filename="src/adw-preferences-row.c"
27303+ line="261">Sets whether an embedded underline in the title indicates a mnemonic.</doc>
27304+ <source-position filename="src/adw-preferences-row.h" line="48"/>
1445927305 <return-value transfer-ownership="none">
1446027306 <type name="none" c:type="void"/>
1446127307 </return-value>
1446227308 <parameters>
1446327309 <instance-parameter name="self" transfer-ownership="none">
1446427310 <doc xml:space="preserve"
14465- filename="src/adw-preferences-group.c"
14466- line="437">a preferences group</doc>
14467- <type name="PreferencesGroup" c:type="AdwPreferencesGroup*"/>
27311+ filename="src/adw-preferences-row.c"
27312+ line="263">a preferences row</doc>
27313+ <type name="PreferencesRow" c:type="AdwPreferencesRow*"/>
1446827314 </instance-parameter>
14469- <parameter name="title" transfer-ownership="none">
27315+ <parameter name="use_underline" transfer-ownership="none">
1447027316 <doc xml:space="preserve"
14471- filename="src/adw-preferences-group.c"
14472- line="438">the title</doc>
14473- <type name="utf8" c:type="const char*"/>
27317+ filename="src/adw-preferences-row.c"
27318+ line="264">`TRUE` if underlines in the text indicate mnemonics</doc>
27319+ <type name="gboolean" c:type="gboolean"/>
1447427320 </parameter>
1447527321 </parameters>
1447627322 </method>
14477- <property name="description"
27323+ <property name="title"
1447827324 writable="1"
1447927325 transfer-ownership="none"
14480- setter="set_description"
14481- getter="get_description">
14482- <attribute name="org.gtk.Property.get"
14483- value="adw_preferences_group_get_description"/>
14484- <attribute name="org.gtk.Property.set"
14485- value="adw_preferences_group_set_description"/>
27326+ setter="set_title"
27327+ getter="get_title">
1448627328 <doc xml:space="preserve"
14487- filename="src/adw-preferences-group.c"
14488- line="262">The description for this group of preferences.</doc>
27329+ filename="src/adw-preferences-row.c"
27330+ line="118">The title of the preference represented by this row.
27331+
27332+The title is interpreted as Pango markup unless
27333+[property@PreferencesRow:use-markup] is set to `FALSE`.</doc>
1448927334 <type name="utf8" c:type="gchar*"/>
1449027335 </property>
14491- <property name="header-suffix"
27336+ <property name="title-selectable"
1449227337 version="1.1"
1449327338 writable="1"
1449427339 transfer-ownership="none"
14495- setter="set_header_suffix"
14496- getter="get_header_suffix">
14497- <attribute name="org.gtk.Property.get"
14498- value="adw_preferences_group_get_header_suffix"/>
14499- <attribute name="org.gtk.Property.set"
14500- value="adw_preferences_group_set_header_suffix"/>
27340+ setter="set_title_selectable"
27341+ getter="get_title_selectable"
27342+ default-value="FALSE">
1450127343 <doc xml:space="preserve"
14502- filename="src/adw-preferences-group.c"
14503- line="272">The header suffix widget.
27344+ filename="src/adw-preferences-row.c"
27345+ line="141">Whether the user can copy the title from the label.
1450427346
14505-Displayed above the list, next to the title and description.
27347+See also [property@Gtk.Label:selectable].</doc>
27348+ <type name="gboolean" c:type="gboolean"/>
27349+ </property>
27350+ <property name="use-markup"
27351+ version="1.2"
27352+ writable="1"
27353+ transfer-ownership="none"
27354+ setter="set_use_markup"
27355+ getter="get_use_markup"
27356+ default-value="TRUE">
27357+ <doc xml:space="preserve"
27358+ filename="src/adw-preferences-row.c"
27359+ line="155">Whether to use Pango markup for the title label.
1450627360
14507-Suffixes are commonly used to show a button or a spinner for the whole
14508-group.</doc>
14509- <type name="Gtk.Widget"/>
27361+Subclasses may also use it for other labels, such as subtitle.
27362+
27363+See also [func@Pango.parse_markup].</doc>
27364+ <type name="gboolean" c:type="gboolean"/>
1451027365 </property>
14511- <property name="title"
27366+ <property name="use-underline"
1451227367 writable="1"
1451327368 transfer-ownership="none"
14514- setter="set_title"
14515- getter="get_title">
14516- <attribute name="org.gtk.Property.get"
14517- value="adw_preferences_group_get_title"/>
14518- <attribute name="org.gtk.Property.set"
14519- value="adw_preferences_group_set_title"/>
27369+ setter="set_use_underline"
27370+ getter="get_use_underline"
27371+ default-value="FALSE">
1452027372 <doc xml:space="preserve"
14521- filename="src/adw-preferences-group.c"
14522- line="252">The title for this group of preferences.</doc>
14523- <type name="utf8" c:type="gchar*"/>
27373+ filename="src/adw-preferences-row.c"
27374+ line="131">Whether an embedded underline in the title indicates a mnemonic.</doc>
27375+ <type name="gboolean" c:type="gboolean"/>
1452427376 </property>
1452527377 <field name="parent_instance">
14526- <type name="Gtk.Widget" c:type="GtkWidget"/>
27378+ <type name="Gtk.ListBoxRow" c:type="GtkListBoxRow"/>
1452727379 </field>
1452827380 </class>
14529- <record name="PreferencesGroupClass"
14530- c:type="AdwPreferencesGroupClass"
14531- glib:is-gtype-struct-for="PreferencesGroup">
14532- <source-position filename="src/adw-preferences-group.h" line="34"/>
27381+ <record name="PreferencesRowClass"
27382+ c:type="AdwPreferencesRowClass"
27383+ glib:is-gtype-struct-for="PreferencesRow">
27384+ <source-position filename="src/adw-preferences-row.h" line="34"/>
1453327385 <field name="parent_class">
1453427386 <doc xml:space="preserve"
14535- filename="src/adw-preferences-group.h"
27387+ filename="src/adw-preferences-row.h"
1453627388 line="26">The parent class</doc>
14537- <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
14538- </field>
14539- <field name="padding" readable="0" private="1">
14540- <array zero-terminated="0" fixed-size="4">
14541- <type name="gpointer" c:type="gpointer"/>
14542- </array>
27389+ <type name="Gtk.ListBoxRowClass" c:type="GtkListBoxRowClass"/>
1454327390 </field>
14544- </record>
14545- <class name="PreferencesPage"
14546- c:symbol-prefix="preferences_page"
14547- c:type="AdwPreferencesPage"
14548- parent="Gtk.Widget"
14549- glib:type-name="AdwPreferencesPage"
14550- glib:get-type="adw_preferences_page_get_type"
14551- glib:type-struct="PreferencesPageClass">
27391+ <field name="padding" readable="0" private="1">
27392+ <array zero-terminated="0" fixed-size="4">
27393+ <type name="gpointer" c:type="gpointer"/>
27394+ </array>
27395+ </field>
27396+ </record>
27397+ <class name="PreferencesWindow"
27398+ c:symbol-prefix="preferences_window"
27399+ c:type="AdwPreferencesWindow"
27400+ deprecated="1"
27401+ deprecated-version="1.6"
27402+ parent="Window"
27403+ glib:type-name="AdwPreferencesWindow"
27404+ glib:get-type="adw_preferences_window_get_type"
27405+ glib:type-struct="PreferencesWindowClass">
1455227406 <doc xml:space="preserve"
14553- filename="src/adw-preferences-page.c"
14554- line="14">A page from [class@PreferencesWindow].
27407+ filename="src/adw-preferences-window.c"
27408+ line="26">A window to present an application's preferences.
1455527409
1455627410 &lt;picture&gt;
14557- &lt;source srcset="preferences-page-dark.png" media="(prefers-color-scheme: dark)"&gt;
14558- &lt;img src="preferences-page.png" alt="preferences-page"&gt;
27411+ &lt;source srcset="preferences-window-dark.png" media="(prefers-color-scheme: dark)"&gt;
27412+ &lt;img src="preferences-window.png" alt="preferences-window"&gt;
1455927413 &lt;/picture&gt;
1456027414
14561-The `AdwPreferencesPage` widget gathers preferences groups into a single page
14562-of a preferences window.
27415+The `AdwPreferencesWindow` widget presents an application's preferences
27416+gathered into pages and groups. The preferences are searchable by the user.
1456327417
1456427418 ## CSS nodes
1456527419
14566-`AdwPreferencesPage` has a single CSS node with name `preferencespage`.
14567-
14568-## Accessibility
14569-
14570-`AdwPreferencesPage` uses the `GTK_ACCESSIBLE_ROLE_GROUP` role.</doc>
14571- <source-position filename="src/adw-preferences-page.h" line="35"/>
27420+`AdwPreferencesWindow` has a main CSS node with the name `window` and the
27421+style class `.preferences`.</doc>
27422+ <doc-deprecated xml:space="preserve">Use [class@PreferencesDialog].</doc-deprecated>
27423+ <source-position filename="src/adw-preferences-window.h" line="38"/>
1457227424 <implements name="Gtk.Accessible"/>
1457327425 <implements name="Gtk.Buildable"/>
1457427426 <implements name="Gtk.ConstraintTarget"/>
14575- <constructor name="new" c:identifier="adw_preferences_page_new">
27427+ <implements name="Gtk.Native"/>
27428+ <implements name="Gtk.Root"/>
27429+ <implements name="Gtk.ShortcutManager"/>
27430+ <constructor name="new"
27431+ c:identifier="adw_preferences_window_new"
27432+ deprecated="1"
27433+ deprecated-version="1.6">
1457627434 <doc xml:space="preserve"
14577- filename="src/adw-preferences-page.c"
14578- line="238">Creates a new `AdwPreferencesPage`.</doc>
14579- <source-position filename="src/adw-preferences-page.h" line="38"/>
27435+ filename="src/adw-preferences-window.c"
27436+ line="759">Creates a new `AdwPreferencesWindow`.</doc>
27437+ <doc-deprecated xml:space="preserve">Use [class@PreferencesDialog].</doc-deprecated>
27438+ <source-position filename="src/adw-preferences-window.h" line="41"/>
1458027439 <return-value transfer-ownership="none">
1458127440 <doc xml:space="preserve"
14582- filename="src/adw-preferences-page.c"
14583- line="243">the newly created `AdwPreferencesPage`</doc>
27441+ filename="src/adw-preferences-window.c"
27442+ line="764">the newly created `AdwPreferencesWindow`</doc>
1458427443 <type name="Gtk.Widget" c:type="GtkWidget*"/>
1458527444 </return-value>
1458627445 </constructor>
14587- <method name="add" c:identifier="adw_preferences_page_add">
27446+ <method name="add"
27447+ c:identifier="adw_preferences_window_add"
27448+ deprecated="1"
27449+ deprecated-version="1.6">
1458827450 <doc xml:space="preserve"
14589- filename="src/adw-preferences-page.c"
14590- line="251">Adds a preferences group to @self.</doc>
14591- <source-position filename="src/adw-preferences-page.h" line="41"/>
27451+ filename="src/adw-preferences-window.c"
27452+ line="774">Adds a preferences page to @self.</doc>
27453+ <doc-deprecated xml:space="preserve">Use [class@PreferencesDialog].</doc-deprecated>
27454+ <source-position filename="src/adw-preferences-window.h" line="44"/>
1459227455 <return-value transfer-ownership="none">
1459327456 <type name="none" c:type="void"/>
1459427457 </return-value>
1459527458 <parameters>
1459627459 <instance-parameter name="self" transfer-ownership="none">
1459727460 <doc xml:space="preserve"
14598- filename="src/adw-preferences-page.c"
14599- line="253">a preferences page</doc>
27461+ filename="src/adw-preferences-window.c"
27462+ line="776">a preferences window</doc>
27463+ <type name="PreferencesWindow" c:type="AdwPreferencesWindow*"/>
27464+ </instance-parameter>
27465+ <parameter name="page" transfer-ownership="none">
27466+ <doc xml:space="preserve"
27467+ filename="src/adw-preferences-window.c"
27468+ line="777">the page to add</doc>
1460027469 <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
27470+ </parameter>
27471+ </parameters>
27472+ </method>
27473+ <method name="add_toast"
27474+ c:identifier="adw_preferences_window_add_toast"
27475+ deprecated="1"
27476+ deprecated-version="1.6">
27477+ <doc xml:space="preserve"
27478+ filename="src/adw-preferences-window.c"
27479+ line="1159">Displays @toast.
27480+
27481+See [method@ToastOverlay.add_toast].</doc>
27482+ <doc-deprecated xml:space="preserve">Use [class@PreferencesDialog].</doc-deprecated>
27483+ <source-position filename="src/adw-preferences-window.h" line="87"/>
27484+ <return-value transfer-ownership="none">
27485+ <type name="none" c:type="void"/>
27486+ </return-value>
27487+ <parameters>
27488+ <instance-parameter name="self" transfer-ownership="none">
27489+ <doc xml:space="preserve"
27490+ filename="src/adw-preferences-window.c"
27491+ line="1161">a preferences window</doc>
27492+ <type name="PreferencesWindow" c:type="AdwPreferencesWindow*"/>
1460127493 </instance-parameter>
14602- <parameter name="group" transfer-ownership="none">
27494+ <parameter name="toast" transfer-ownership="full">
1460327495 <doc xml:space="preserve"
14604- filename="src/adw-preferences-page.c"
14605- line="254">the group to add</doc>
14606- <type name="PreferencesGroup" c:type="AdwPreferencesGroup*"/>
27496+ filename="src/adw-preferences-window.c"
27497+ line="1162">a toast</doc>
27498+ <type name="Toast" c:type="AdwToast*"/>
1460727499 </parameter>
1460827500 </parameters>
1460927501 </method>
14610- <method name="get_icon_name"
14611- c:identifier="adw_preferences_page_get_icon_name"
14612- glib:get-property="icon-name">
14613- <attribute name="org.gtk.Method.get_property" value="icon-name"/>
27502+ <method name="close_subpage"
27503+ c:identifier="adw_preferences_window_close_subpage"
27504+ deprecated="1"
27505+ deprecated-version="1.4">
1461427506 <doc xml:space="preserve"
14615- filename="src/adw-preferences-page.c"
14616- line="296">Gets the icon name for @self.</doc>
14617- <source-position filename="src/adw-preferences-page.h" line="48"/>
14618- <return-value transfer-ownership="none" nullable="1">
27507+ filename="src/adw-preferences-window.c"
27508+ line="1085">Closes the current subpage.
27509+
27510+If there is no presented subpage, this does nothing.</doc>
27511+ <doc-deprecated xml:space="preserve">Use [method@PreferencesWindow.pop_subpage] instead.</doc-deprecated>
27512+ <source-position filename="src/adw-preferences-window.h" line="78"/>
27513+ <return-value transfer-ownership="none">
27514+ <type name="none" c:type="void"/>
27515+ </return-value>
27516+ <parameters>
27517+ <instance-parameter name="self" transfer-ownership="none">
27518+ <doc xml:space="preserve"
27519+ filename="src/adw-preferences-window.c"
27520+ line="1087">a preferences window</doc>
27521+ <type name="PreferencesWindow" c:type="AdwPreferencesWindow*"/>
27522+ </instance-parameter>
27523+ </parameters>
27524+ </method>
27525+ <method name="get_can_navigate_back"
27526+ c:identifier="adw_preferences_window_get_can_navigate_back"
27527+ glib:get-property="can-navigate-back"
27528+ deprecated="1"
27529+ deprecated-version="1.4">
27530+ <doc xml:space="preserve"
27531+ filename="src/adw-preferences-window.c"
27532+ line="1026">Gets whether gestures and shortcuts for closing subpages are enabled.</doc>
27533+ <doc-deprecated xml:space="preserve">Use [method@NavigationPage.get_can_pop] instead.</doc-deprecated>
27534+ <source-position filename="src/adw-preferences-window.h" line="69"/>
27535+ <return-value transfer-ownership="none">
1461927536 <doc xml:space="preserve"
14620- filename="src/adw-preferences-page.c"
14621- line="302">the icon name for @self</doc>
14622- <type name="utf8" c:type="const char*"/>
27537+ filename="src/adw-preferences-window.c"
27538+ line="1032">whether gestures and shortcuts are enabled.</doc>
27539+ <type name="gboolean" c:type="gboolean"/>
1462327540 </return-value>
1462427541 <parameters>
1462527542 <instance-parameter name="self" transfer-ownership="none">
1462627543 <doc xml:space="preserve"
14627- filename="src/adw-preferences-page.c"
14628- line="298">a preferences page</doc>
14629- <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
27544+ filename="src/adw-preferences-window.c"
27545+ line="1028">a preferences window</doc>
27546+ <type name="PreferencesWindow" c:type="AdwPreferencesWindow*"/>
1463027547 </instance-parameter>
1463127548 </parameters>
1463227549 </method>
14633- <method name="get_name"
14634- c:identifier="adw_preferences_page_get_name"
14635- glib:get-property="name">
14636- <attribute name="org.gtk.Method.get_property" value="name"/>
27550+ <method name="get_search_enabled"
27551+ c:identifier="adw_preferences_window_get_search_enabled"
27552+ glib:get-property="search-enabled"
27553+ deprecated="1"
27554+ deprecated-version="1.6">
1463727555 <doc xml:space="preserve"
14638- filename="src/adw-preferences-page.c"
14639- line="388">Gets the name of @self.</doc>
14640- <source-position filename="src/adw-preferences-page.h" line="60"/>
27556+ filename="src/adw-preferences-window.c"
27557+ line="926">Gets whether search is enabled for @self.</doc>
27558+ <doc-deprecated xml:space="preserve">Use [class@PreferencesDialog].</doc-deprecated>
27559+ <source-position filename="src/adw-preferences-window.h" line="63"/>
27560+ <return-value transfer-ownership="none">
27561+ <doc xml:space="preserve"
27562+ filename="src/adw-preferences-window.c"
27563+ line="932">whether search is enabled for @self.</doc>
27564+ <type name="gboolean" c:type="gboolean"/>
27565+ </return-value>
27566+ <parameters>
27567+ <instance-parameter name="self" transfer-ownership="none">
27568+ <doc xml:space="preserve"
27569+ filename="src/adw-preferences-window.c"
27570+ line="928">a preferences window</doc>
27571+ <type name="PreferencesWindow" c:type="AdwPreferencesWindow*"/>
27572+ </instance-parameter>
27573+ </parameters>
27574+ </method>
27575+ <method name="get_visible_page"
27576+ c:identifier="adw_preferences_window_get_visible_page"
27577+ glib:get-property="visible-page"
27578+ deprecated="1"
27579+ deprecated-version="1.6">
27580+ <doc xml:space="preserve"
27581+ filename="src/adw-preferences-window.c"
27582+ line="835">Gets the currently visible page of @self.</doc>
27583+ <doc-deprecated xml:space="preserve">Use [class@PreferencesDialog].</doc-deprecated>
27584+ <source-position filename="src/adw-preferences-window.h" line="51"/>
1464127585 <return-value transfer-ownership="none" nullable="1">
1464227586 <doc xml:space="preserve"
14643- filename="src/adw-preferences-page.c"
14644- line="394">the name of @self</doc>
14645- <type name="utf8" c:type="const char*"/>
27587+ filename="src/adw-preferences-window.c"
27588+ line="841">the visible page</doc>
27589+ <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
1464627590 </return-value>
1464727591 <parameters>
1464827592 <instance-parameter name="self" transfer-ownership="none">
1464927593 <doc xml:space="preserve"
14650- filename="src/adw-preferences-page.c"
14651- line="390">a preferences page</doc>
14652- <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
27594+ filename="src/adw-preferences-window.c"
27595+ line="837">a preferences window</doc>
27596+ <type name="PreferencesWindow" c:type="AdwPreferencesWindow*"/>
1465327597 </instance-parameter>
1465427598 </parameters>
1465527599 </method>
14656- <method name="get_title"
14657- c:identifier="adw_preferences_page_get_title"
14658- glib:get-property="title">
14659- <attribute name="org.gtk.Method.get_property" value="title"/>
27600+ <method name="get_visible_page_name"
27601+ c:identifier="adw_preferences_window_get_visible_page_name"
27602+ glib:get-property="visible-page-name"
27603+ deprecated="1"
27604+ deprecated-version="1.6">
1466027605 <doc xml:space="preserve"
14661- filename="src/adw-preferences-page.c"
14662- line="342">Gets the title of @self.</doc>
14663- <source-position filename="src/adw-preferences-page.h" line="54"/>
14664- <return-value transfer-ownership="none">
27606+ filename="src/adw-preferences-window.c"
27607+ line="880">Gets the name of currently visible page of @self.</doc>
27608+ <doc-deprecated xml:space="preserve">Use [class@PreferencesDialog].</doc-deprecated>
27609+ <source-position filename="src/adw-preferences-window.h" line="57"/>
27610+ <return-value transfer-ownership="none" nullable="1">
1466527611 <doc xml:space="preserve"
14666- filename="src/adw-preferences-page.c"
14667- line="348">the title of @self.</doc>
27612+ filename="src/adw-preferences-window.c"
27613+ line="886">the name of the visible page</doc>
1466827614 <type name="utf8" c:type="const char*"/>
1466927615 </return-value>
1467027616 <parameters>
1467127617 <instance-parameter name="self" transfer-ownership="none">
1467227618 <doc xml:space="preserve"
14673- filename="src/adw-preferences-page.c"
14674- line="344">a preferences page</doc>
14675- <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
27619+ filename="src/adw-preferences-window.c"
27620+ line="882">a preferences window</doc>
27621+ <type name="PreferencesWindow" c:type="AdwPreferencesWindow*"/>
1467627622 </instance-parameter>
1467727623 </parameters>
1467827624 </method>
14679- <method name="get_use_underline"
14680- c:identifier="adw_preferences_page_get_use_underline"
14681- glib:get-property="use-underline">
14682- <attribute name="org.gtk.Method.get_property" value="use-underline"/>
27625+ <method name="pop_subpage"
27626+ c:identifier="adw_preferences_window_pop_subpage"
27627+ version="1.4"
27628+ deprecated="1"
27629+ deprecated-version="1.6">
1468327630 <doc xml:space="preserve"
14684- filename="src/adw-preferences-page.c"
14685- line="434">Gets whether an embedded underline in the title indicates a mnemonic.</doc>
14686- <source-position filename="src/adw-preferences-page.h" line="66"/>
27631+ filename="src/adw-preferences-window.c"
27632+ line="1136">Pop the visible page from the subpage stack of @self.</doc>
27633+ <doc-deprecated xml:space="preserve">Use [class@PreferencesDialog].</doc-deprecated>
27634+ <source-position filename="src/adw-preferences-window.h" line="84"/>
1468727635 <return-value transfer-ownership="none">
1468827636 <doc xml:space="preserve"
14689- filename="src/adw-preferences-page.c"
14690- line="440">whether an embedded underline in the title indicates a mnemonic</doc>
27637+ filename="src/adw-preferences-window.c"
27638+ line="1142">`TRUE` if a page has been popped</doc>
1469127639 <type name="gboolean" c:type="gboolean"/>
1469227640 </return-value>
1469327641 <parameters>
1469427642 <instance-parameter name="self" transfer-ownership="none">
1469527643 <doc xml:space="preserve"
14696- filename="src/adw-preferences-page.c"
14697- line="436">a preferences page</doc>
14698- <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
27644+ filename="src/adw-preferences-window.c"
27645+ line="1138">a preferences window</doc>
27646+ <type name="PreferencesWindow" c:type="AdwPreferencesWindow*"/>
1469927647 </instance-parameter>
1470027648 </parameters>
1470127649 </method>
14702- <method name="remove" c:identifier="adw_preferences_page_remove">
27650+ <method name="present_subpage"
27651+ c:identifier="adw_preferences_window_present_subpage"
27652+ deprecated="1"
27653+ deprecated-version="1.4">
1470327654 <doc xml:space="preserve"
14704- filename="src/adw-preferences-page.c"
14705- line="272">Removes a group from @self.</doc>
14706- <source-position filename="src/adw-preferences-page.h" line="44"/>
27655+ filename="src/adw-preferences-window.c"
27656+ line="1048">Sets @subpage as the window's subpage and opens it.
27657+
27658+The transition can be cancelled by the user, in which case visible child will
27659+change back to the previously visible child.</doc>
27660+ <doc-deprecated xml:space="preserve">Use [method@PreferencesWindow.push_subpage] instead.</doc-deprecated>
27661+ <source-position filename="src/adw-preferences-window.h" line="75"/>
1470727662 <return-value transfer-ownership="none">
1470827663 <type name="none" c:type="void"/>
1470927664 </return-value>
1471027665 <parameters>
1471127666 <instance-parameter name="self" transfer-ownership="none">
1471227667 <doc xml:space="preserve"
14713- filename="src/adw-preferences-page.c"
14714- line="274">a preferences page</doc>
14715- <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
27668+ filename="src/adw-preferences-window.c"
27669+ line="1050">a preferences window</doc>
27670+ <type name="PreferencesWindow" c:type="AdwPreferencesWindow*"/>
1471627671 </instance-parameter>
14717- <parameter name="group" transfer-ownership="none">
27672+ <parameter name="subpage" transfer-ownership="none">
1471827673 <doc xml:space="preserve"
14719- filename="src/adw-preferences-page.c"
14720- line="275">the group to remove</doc>
14721- <type name="PreferencesGroup" c:type="AdwPreferencesGroup*"/>
27674+ filename="src/adw-preferences-window.c"
27675+ line="1051">the subpage</doc>
27676+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
1472227677 </parameter>
1472327678 </parameters>
1472427679 </method>
14725- <method name="scroll_to_top"
14726- c:identifier="adw_preferences_page_scroll_to_top"
14727- version="1.3">
27680+ <method name="push_subpage"
27681+ c:identifier="adw_preferences_window_push_subpage"
27682+ version="1.4"
27683+ deprecated="1"
27684+ deprecated-version="1.6">
1472827685 <doc xml:space="preserve"
14729- filename="src/adw-preferences-page.c"
14730- line="522">Scrolls the scrolled window of @self to the top.</doc>
14731- <source-position filename="src/adw-preferences-page.h" line="72"/>
27686+ filename="src/adw-preferences-window.c"
27687+ line="1110">Pushes @page onto the subpage stack of @self.
27688+
27689+The page will be automatically removed when popped.</doc>
27690+ <doc-deprecated xml:space="preserve">Use [class@PreferencesDialog].</doc-deprecated>
27691+ <source-position filename="src/adw-preferences-window.h" line="81"/>
1473227692 <return-value transfer-ownership="none">
1473327693 <type name="none" c:type="void"/>
1473427694 </return-value>
1473527695 <parameters>
1473627696 <instance-parameter name="self" transfer-ownership="none">
1473727697 <doc xml:space="preserve"
14738- filename="src/adw-preferences-page.c"
14739- line="524">a preferences page</doc>
14740- <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
27698+ filename="src/adw-preferences-window.c"
27699+ line="1112">a preferences window</doc>
27700+ <type name="PreferencesWindow" c:type="AdwPreferencesWindow*"/>
1474127701 </instance-parameter>
27702+ <parameter name="page" transfer-ownership="none">
27703+ <doc xml:space="preserve"
27704+ filename="src/adw-preferences-window.c"
27705+ line="1113">the subpage</doc>
27706+ <type name="NavigationPage" c:type="AdwNavigationPage*"/>
27707+ </parameter>
1474227708 </parameters>
1474327709 </method>
14744- <method name="set_icon_name"
14745- c:identifier="adw_preferences_page_set_icon_name"
14746- glib:set-property="icon-name">
14747- <attribute name="org.gtk.Method.set_property" value="icon-name"/>
27710+ <method name="remove"
27711+ c:identifier="adw_preferences_window_remove"
27712+ deprecated="1"
27713+ deprecated-version="1.6">
1474827714 <doc xml:space="preserve"
14749- filename="src/adw-preferences-page.c"
14750- line="316">Sets the icon name for @self.</doc>
14751- <source-position filename="src/adw-preferences-page.h" line="50"/>
27715+ filename="src/adw-preferences-window.c"
27716+ line="806">Removes a page from @self.</doc>
27717+ <doc-deprecated xml:space="preserve">Use [class@PreferencesDialog].</doc-deprecated>
27718+ <source-position filename="src/adw-preferences-window.h" line="47"/>
1475227719 <return-value transfer-ownership="none">
1475327720 <type name="none" c:type="void"/>
1475427721 </return-value>
1475527722 <parameters>
1475627723 <instance-parameter name="self" transfer-ownership="none">
1475727724 <doc xml:space="preserve"
14758- filename="src/adw-preferences-page.c"
14759- line="318">a preferences page</doc>
27725+ filename="src/adw-preferences-window.c"
27726+ line="808">a preferences window</doc>
27727+ <type name="PreferencesWindow" c:type="AdwPreferencesWindow*"/>
27728+ </instance-parameter>
27729+ <parameter name="page" transfer-ownership="none">
27730+ <doc xml:space="preserve"
27731+ filename="src/adw-preferences-window.c"
27732+ line="809">the page to remove</doc>
1476027733 <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
27734+ </parameter>
27735+ </parameters>
27736+ </method>
27737+ <method name="set_can_navigate_back"
27738+ c:identifier="adw_preferences_window_set_can_navigate_back"
27739+ glib:set-property="can-navigate-back"
27740+ deprecated="1"
27741+ deprecated-version="1.4">
27742+ <doc xml:space="preserve"
27743+ filename="src/adw-preferences-window.c"
27744+ line="984">Sets whether gestures and shortcuts for closing subpages are enabled.
27745+
27746+The supported gestures are:
27747+
27748+- One-finger swipe on touchscreens
27749+- Horizontal scrolling on touchpads (usually two-finger swipe)
27750+- Back mouse button
27751+
27752+The keyboard back key is also supported, as well as the
27753+&lt;kbd&gt;Alt&lt;/kbd&gt;+&lt;kbd&gt;←&lt;/kbd&gt; shortcut.
27754+
27755+For right-to-left locales, gestures and shortcuts are reversed.
27756+
27757+Has no effect for subpages added with [method@PreferencesWindow.push_subpage].</doc>
27758+ <doc-deprecated xml:space="preserve">Use [method@NavigationPage.set_can_pop] instead.</doc-deprecated>
27759+ <source-position filename="src/adw-preferences-window.h" line="71"/>
27760+ <return-value transfer-ownership="none">
27761+ <type name="none" c:type="void"/>
27762+ </return-value>
27763+ <parameters>
27764+ <instance-parameter name="self" transfer-ownership="none">
27765+ <doc xml:space="preserve"
27766+ filename="src/adw-preferences-window.c"
27767+ line="986">a preferences window</doc>
27768+ <type name="PreferencesWindow" c:type="AdwPreferencesWindow*"/>
1476127769 </instance-parameter>
14762- <parameter name="icon_name"
14763- transfer-ownership="none"
14764- nullable="1"
14765- allow-none="1">
27770+ <parameter name="can_navigate_back" transfer-ownership="none">
1476627771 <doc xml:space="preserve"
14767- filename="src/adw-preferences-page.c"
14768- line="319">the icon name</doc>
14769- <type name="utf8" c:type="const char*"/>
27772+ filename="src/adw-preferences-window.c"
27773+ line="987">the new value</doc>
27774+ <type name="gboolean" c:type="gboolean"/>
1477027775 </parameter>
1477127776 </parameters>
1477227777 </method>
14773- <method name="set_name"
14774- c:identifier="adw_preferences_page_set_name"
14775- glib:set-property="name">
14776- <attribute name="org.gtk.Method.set_property" value="name"/>
27778+ <method name="set_search_enabled"
27779+ c:identifier="adw_preferences_window_set_search_enabled"
27780+ glib:set-property="search-enabled"
27781+ deprecated="1"
27782+ deprecated-version="1.6">
1477727783 <doc xml:space="preserve"
14778- filename="src/adw-preferences-page.c"
14779- line="408">Sets the name of @self.</doc>
14780- <source-position filename="src/adw-preferences-page.h" line="62"/>
27784+ filename="src/adw-preferences-window.c"
27785+ line="948">Sets whether search is enabled for @self.</doc>
27786+ <doc-deprecated xml:space="preserve">Use [class@PreferencesDialog].</doc-deprecated>
27787+ <source-position filename="src/adw-preferences-window.h" line="65"/>
1478127788 <return-value transfer-ownership="none">
1478227789 <type name="none" c:type="void"/>
1478327790 </return-value>
1478427791 <parameters>
1478527792 <instance-parameter name="self" transfer-ownership="none">
1478627793 <doc xml:space="preserve"
14787- filename="src/adw-preferences-page.c"
14788- line="410">a preferences page</doc>
14789- <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
27794+ filename="src/adw-preferences-window.c"
27795+ line="950">a preferences window</doc>
27796+ <type name="PreferencesWindow" c:type="AdwPreferencesWindow*"/>
1479027797 </instance-parameter>
14791- <parameter name="name"
14792- transfer-ownership="none"
14793- nullable="1"
14794- allow-none="1">
27798+ <parameter name="search_enabled" transfer-ownership="none">
1479527799 <doc xml:space="preserve"
14796- filename="src/adw-preferences-page.c"
14797- line="411">the name</doc>
14798- <type name="utf8" c:type="const char*"/>
27800+ filename="src/adw-preferences-window.c"
27801+ line="951">whether search is enabled</doc>
27802+ <type name="gboolean" c:type="gboolean"/>
1479927803 </parameter>
1480027804 </parameters>
1480127805 </method>
14802- <method name="set_title"
14803- c:identifier="adw_preferences_page_set_title"
14804- glib:set-property="title">
14805- <attribute name="org.gtk.Method.set_property" value="title"/>
27806+ <method name="set_visible_page"
27807+ c:identifier="adw_preferences_window_set_visible_page"
27808+ glib:set-property="visible-page"
27809+ deprecated="1"
27810+ deprecated-version="1.6">
1480627811 <doc xml:space="preserve"
14807- filename="src/adw-preferences-page.c"
14808- line="362">Sets the title of @self.</doc>
14809- <source-position filename="src/adw-preferences-page.h" line="56"/>
27812+ filename="src/adw-preferences-window.c"
27813+ line="857">Makes @page the visible page of @self.</doc>
27814+ <doc-deprecated xml:space="preserve">Use [class@PreferencesDialog].</doc-deprecated>
27815+ <source-position filename="src/adw-preferences-window.h" line="53"/>
1481027816 <return-value transfer-ownership="none">
1481127817 <type name="none" c:type="void"/>
1481227818 </return-value>
1481327819 <parameters>
1481427820 <instance-parameter name="self" transfer-ownership="none">
1481527821 <doc xml:space="preserve"
14816- filename="src/adw-preferences-page.c"
14817- line="364">a preferences page</doc>
14818- <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
27822+ filename="src/adw-preferences-window.c"
27823+ line="859">a preferences window</doc>
27824+ <type name="PreferencesWindow" c:type="AdwPreferencesWindow*"/>
1481927825 </instance-parameter>
14820- <parameter name="title" transfer-ownership="none">
27826+ <parameter name="page" transfer-ownership="none">
1482127827 <doc xml:space="preserve"
14822- filename="src/adw-preferences-page.c"
14823- line="365">the title</doc>
14824- <type name="utf8" c:type="const char*"/>
27828+ filename="src/adw-preferences-window.c"
27829+ line="860">a page of @self</doc>
27830+ <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
1482527831 </parameter>
1482627832 </parameters>
1482727833 </method>
14828- <method name="set_use_underline"
14829- c:identifier="adw_preferences_page_set_use_underline"
14830- glib:set-property="use-underline">
14831- <attribute name="org.gtk.Method.set_property" value="use-underline"/>
27834+ <method name="set_visible_page_name"
27835+ c:identifier="adw_preferences_window_set_visible_page_name"
27836+ glib:set-property="visible-page-name"
27837+ deprecated="1"
27838+ deprecated-version="1.6">
1483227839 <doc xml:space="preserve"
14833- filename="src/adw-preferences-page.c"
14834- line="454">Sets whether an embedded underline in the title indicates a mnemonic.</doc>
14835- <source-position filename="src/adw-preferences-page.h" line="68"/>
27840+ filename="src/adw-preferences-window.c"
27841+ line="902">Makes the page with the given name visible.
27842+
27843+See [property@PreferencesWindow:visible-page].</doc>
27844+ <doc-deprecated xml:space="preserve">Use [class@PreferencesDialog].</doc-deprecated>
27845+ <source-position filename="src/adw-preferences-window.h" line="59"/>
1483627846 <return-value transfer-ownership="none">
1483727847 <type name="none" c:type="void"/>
1483827848 </return-value>
1483927849 <parameters>
1484027850 <instance-parameter name="self" transfer-ownership="none">
1484127851 <doc xml:space="preserve"
14842- filename="src/adw-preferences-page.c"
14843- line="456">a preferences page</doc>
14844- <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
27852+ filename="src/adw-preferences-window.c"
27853+ line="904">a preferences window</doc>
27854+ <type name="PreferencesWindow" c:type="AdwPreferencesWindow*"/>
1484527855 </instance-parameter>
14846- <parameter name="use_underline" transfer-ownership="none">
27856+ <parameter name="name" transfer-ownership="none">
1484727857 <doc xml:space="preserve"
14848- filename="src/adw-preferences-page.c"
14849- line="457">`TRUE` if underlines in the text indicate mnemonics</doc>
14850- <type name="gboolean" c:type="gboolean"/>
27858+ filename="src/adw-preferences-window.c"
27859+ line="905">the name of the page to make visible</doc>
27860+ <type name="utf8" c:type="const char*"/>
1485127861 </parameter>
1485227862 </parameters>
1485327863 </method>
14854- <property name="icon-name"
27864+ <property name="can-navigate-back"
27865+ deprecated="1"
27866+ deprecated-version="1.4"
1485527867 writable="1"
1485627868 transfer-ownership="none"
14857- setter="set_icon_name"
14858- getter="get_icon_name">
14859- <attribute name="org.gtk.Property.get"
14860- value="adw_preferences_page_get_icon_name"/>
14861- <attribute name="org.gtk.Property.set"
14862- value="adw_preferences_page_set_icon_name"/>
27869+ setter="set_can_navigate_back"
27870+ getter="get_can_navigate_back"
27871+ default-value="FALSE">
1486327872 <doc xml:space="preserve"
14864- filename="src/adw-preferences-page.c"
14865- line="155">The icon name for this page.</doc>
14866- <type name="utf8" c:type="gchar*"/>
27873+ filename="src/adw-preferences-window.c"
27874+ line="631">Whether gestures and shortcuts for closing subpages are enabled.
27875+
27876+The supported gestures are:
27877+
27878+- One-finger swipe on touchscreens
27879+- Horizontal scrolling on touchpads (usually two-finger swipe)
27880+- Back mouse button
27881+
27882+The keyboard back key is also supported, as well as the
27883+&lt;kbd&gt;Alt&lt;/kbd&gt;+&lt;kbd&gt;←&lt;/kbd&gt; shortcut.
27884+
27885+For right-to-left locales, gestures and shortcuts are reversed.
27886+
27887+Has no effect for subpages added with
27888+[method@PreferencesWindow.push_subpage].</doc>
27889+ <doc-deprecated xml:space="preserve">Use [property@NavigationPage:can-pop] instead.</doc-deprecated>
27890+ <type name="gboolean" c:type="gboolean"/>
1486727891 </property>
14868- <property name="name"
27892+ <property name="search-enabled"
27893+ deprecated="1"
27894+ deprecated-version="1.6"
1486927895 writable="1"
1487027896 transfer-ownership="none"
14871- setter="set_name"
14872- getter="get_name"
14873- default-value="NULL">
14874- <attribute name="org.gtk.Property.get"
14875- value="adw_preferences_page_get_name"/>
14876- <attribute name="org.gtk.Property.set"
14877- value="adw_preferences_page_set_name"/>
27897+ setter="set_search_enabled"
27898+ getter="get_search_enabled"
27899+ default-value="TRUE">
1487827900 <doc xml:space="preserve"
14879- filename="src/adw-preferences-page.c"
14880- line="175">The name of this page.</doc>
14881- <type name="utf8" c:type="gchar*"/>
27901+ filename="src/adw-preferences-window.c"
27902+ line="619">Whether search is enabled.</doc>
27903+ <doc-deprecated xml:space="preserve">Use [class@PreferencesDialog].</doc-deprecated>
27904+ <type name="gboolean" c:type="gboolean"/>
1488227905 </property>
14883- <property name="title"
27906+ <property name="visible-page"
27907+ deprecated="1"
27908+ deprecated-version="1.6"
1488427909 writable="1"
1488527910 transfer-ownership="none"
14886- setter="set_title"
14887- getter="get_title">
14888- <attribute name="org.gtk.Property.get"
14889- value="adw_preferences_page_get_title"/>
14890- <attribute name="org.gtk.Property.set"
14891- value="adw_preferences_page_set_title"/>
27911+ setter="set_visible_page"
27912+ getter="get_visible_page">
1489227913 <doc xml:space="preserve"
14893- filename="src/adw-preferences-page.c"
14894- line="165">The title for this page.</doc>
14895- <type name="utf8" c:type="gchar*"/>
27914+ filename="src/adw-preferences-window.c"
27915+ line="593">The currently visible page.</doc>
27916+ <doc-deprecated xml:space="preserve">Use [class@PreferencesDialog].</doc-deprecated>
27917+ <type name="Gtk.Widget"/>
1489627918 </property>
14897- <property name="use-underline"
27919+ <property name="visible-page-name"
27920+ deprecated="1"
27921+ deprecated-version="1.6"
1489827922 writable="1"
1489927923 transfer-ownership="none"
14900- setter="set_use_underline"
14901- getter="get_use_underline"
14902- default-value="FALSE">
14903- <attribute name="org.gtk.Property.get"
14904- value="adw_preferences_page_get_use_underline"/>
14905- <attribute name="org.gtk.Property.set"
14906- value="adw_preferences_page_set_use_underline"/>
27924+ setter="set_visible_page_name"
27925+ getter="get_visible_page_name"
27926+ default-value="NULL">
1490727927 <doc xml:space="preserve"
14908- filename="src/adw-preferences-page.c"
14909- line="185">Whether an embedded underline in the title indicates a mnemonic.</doc>
14910- <type name="gboolean" c:type="gboolean"/>
27928+ filename="src/adw-preferences-window.c"
27929+ line="605">The name of the currently visible page.
27930+
27931+See [property@PreferencesWindow:visible-page].</doc>
27932+ <doc-deprecated xml:space="preserve">Use [class@PreferencesDialog].</doc-deprecated>
27933+ <type name="utf8" c:type="gchar*"/>
1491127934 </property>
1491227935 <field name="parent_instance">
14913- <type name="Gtk.Widget" c:type="GtkWidget"/>
27936+ <type name="Window" c:type="AdwWindow"/>
1491427937 </field>
1491527938 </class>
14916- <record name="PreferencesPageClass"
14917- c:type="AdwPreferencesPageClass"
14918- glib:is-gtype-struct-for="PreferencesPage">
14919- <source-position filename="src/adw-preferences-page.h" line="35"/>
27939+ <record name="PreferencesWindowClass"
27940+ c:type="AdwPreferencesWindowClass"
27941+ glib:is-gtype-struct-for="PreferencesWindow">
27942+ <source-position filename="src/adw-preferences-window.h" line="38"/>
1492027943 <field name="parent_class">
1492127944 <doc xml:space="preserve"
14922- filename="src/adw-preferences-page.h"
14923- line="27">The parent class</doc>
14924- <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
27945+ filename="src/adw-preferences-window.h"
27946+ line="30">The parent class</doc>
27947+ <type name="WindowClass" c:type="AdwWindowClass"/>
1492527948 </field>
1492627949 <field name="padding" readable="0" private="1">
1492727950 <array zero-terminated="0" fixed-size="4">
@@ -14929,990 +27952,1196 @@ of a preferences window.
1492927952 </array>
1493027953 </field>
1493127954 </record>
14932- <class name="PreferencesRow"
14933- c:symbol-prefix="preferences_row"
14934- c:type="AdwPreferencesRow"
14935- parent="Gtk.ListBoxRow"
14936- glib:type-name="AdwPreferencesRow"
14937- glib:get-type="adw_preferences_row_get_type"
14938- glib:type-struct="PreferencesRowClass">
27955+ <class name="PropertyAnimationTarget"
27956+ c:symbol-prefix="property_animation_target"
27957+ c:type="AdwPropertyAnimationTarget"
27958+ version="1.2"
27959+ parent="AnimationTarget"
27960+ final="1"
27961+ glib:type-name="AdwPropertyAnimationTarget"
27962+ glib:get-type="adw_property_animation_target_get_type"
27963+ glib:type-struct="PropertyAnimationTargetClass">
1493927964 <doc xml:space="preserve"
14940- filename="src/adw-preferences-row.c"
14941- line="11">A [class@Gtk.ListBoxRow] used to present preferences.
14942-
14943-The `AdwPreferencesRow` widget has a title that [class@PreferencesWindow]
14944-will use to let the user look for a preference. It doesn't present the title
14945-in any way and lets you present the preference as you please.
14946-
14947-[class@ActionRow] and its derivatives are convenient to use as preference
14948-rows as they take care of presenting the preference's title while letting you
14949-compose the inputs of the preference around it.</doc>
14950- <source-position filename="src/adw-preferences-row.h" line="34"/>
14951- <implements name="Gtk.Accessible"/>
14952- <implements name="Gtk.Actionable"/>
14953- <implements name="Gtk.Buildable"/>
14954- <implements name="Gtk.ConstraintTarget"/>
14955- <constructor name="new" c:identifier="adw_preferences_row_new">
14956- <doc xml:space="preserve"
14957- filename="src/adw-preferences-row.c"
14958- line="182">Creates a new `AdwPreferencesRow`.</doc>
14959- <source-position filename="src/adw-preferences-row.h" line="37"/>
14960- <return-value transfer-ownership="none">
14961- <doc xml:space="preserve"
14962- filename="src/adw-preferences-row.c"
14963- line="187">the newly created `AdwPreferencesRow`</doc>
14964- <type name="Gtk.Widget" c:type="GtkWidget*"/>
14965- </return-value>
14966- </constructor>
14967- <method name="get_title"
14968- c:identifier="adw_preferences_row_get_title"
14969- glib:get-property="title">
14970- <attribute name="org.gtk.Method.get_property" value="title"/>
14971- <doc xml:space="preserve"
14972- filename="src/adw-preferences-row.c"
14973- line="195">Gets the title of the preference represented by @self.</doc>
14974- <source-position filename="src/adw-preferences-row.h" line="40"/>
14975- <return-value transfer-ownership="none">
14976- <doc xml:space="preserve"
14977- filename="src/adw-preferences-row.c"
14978- line="201">the title</doc>
14979- <type name="utf8" c:type="const char*"/>
14980- </return-value>
14981- <parameters>
14982- <instance-parameter name="self" transfer-ownership="none">
14983- <doc xml:space="preserve"
14984- filename="src/adw-preferences-row.c"
14985- line="197">a preferences row</doc>
14986- <type name="PreferencesRow" c:type="AdwPreferencesRow*"/>
14987- </instance-parameter>
14988- </parameters>
14989- </method>
14990- <method name="get_title_selectable"
14991- c:identifier="adw_preferences_row_get_title_selectable"
14992- glib:get-property="title-selectable"
14993- version="1.1">
14994- <attribute name="org.gtk.Method.get_property"
14995- value="title-selectable"/>
14996- <doc xml:space="preserve"
14997- filename="src/adw-preferences-row.c"
14998- line="291">Gets whether the user can copy the title from the label</doc>
14999- <source-position filename="src/adw-preferences-row.h" line="52"/>
15000- <return-value transfer-ownership="none">
15001- <doc xml:space="preserve"
15002- filename="src/adw-preferences-row.c"
15003- line="297">whether the user can copy the title from the label</doc>
15004- <type name="gboolean" c:type="gboolean"/>
15005- </return-value>
15006- <parameters>
15007- <instance-parameter name="self" transfer-ownership="none">
15008- <doc xml:space="preserve"
15009- filename="src/adw-preferences-row.c"
15010- line="293">a `AdwPreferencesRow`</doc>
15011- <type name="PreferencesRow" c:type="AdwPreferencesRow*"/>
15012- </instance-parameter>
15013- </parameters>
15014- </method>
15015- <method name="get_use_markup"
15016- c:identifier="adw_preferences_row_get_use_markup"
15017- glib:get-property="use-markup"
15018- version="1.2">
15019- <attribute name="org.gtk.Method.get_property" value="use-markup"/>
15020- <doc xml:space="preserve"
15021- filename="src/adw-preferences-row.c"
15022- line="340">Gets whether to use Pango markup for the title label.</doc>
15023- <source-position filename="src/adw-preferences-row.h" line="59"/>
15024- <return-value transfer-ownership="none">
15025- <doc xml:space="preserve"
15026- filename="src/adw-preferences-row.c"
15027- line="346">whether to use markup</doc>
15028- <type name="gboolean" c:type="gboolean"/>
15029- </return-value>
15030- <parameters>
15031- <instance-parameter name="self" transfer-ownership="none">
15032- <doc xml:space="preserve"
15033- filename="src/adw-preferences-row.c"
15034- line="342">a preferences row</doc>
15035- <type name="PreferencesRow" c:type="AdwPreferencesRow*"/>
15036- </instance-parameter>
15037- </parameters>
15038- </method>
15039- <method name="get_use_underline"
15040- c:identifier="adw_preferences_row_get_use_underline"
15041- glib:get-property="use-underline">
15042- <attribute name="org.gtk.Method.get_property" value="use-underline"/>
27965+ filename="src/adw-animation-target.c"
27966+ line="24">An [class@AnimationTarget] changing the value of a property of a
27967+[class@GObject.Object] instance.</doc>
27968+ <source-position filename="src/adw-animation-target.h" line="48"/>
27969+ <constructor name="new"
27970+ c:identifier="adw_property_animation_target_new"
27971+ version="1.2">
1504327972 <doc xml:space="preserve"
15044- filename="src/adw-preferences-row.c"
15045- line="244">Gets whether an embedded underline in the title indicates a mnemonic.</doc>
15046- <source-position filename="src/adw-preferences-row.h" line="46"/>
15047- <return-value transfer-ownership="none">
27973+ filename="src/adw-animation-target.c"
27974+ line="348">Creates a new `AdwPropertyAnimationTarget` for the @property_name property on
27975+@object.</doc>
27976+ <source-position filename="src/adw-animation-target.h" line="51"/>
27977+ <return-value transfer-ownership="full">
1504827978 <doc xml:space="preserve"
15049- filename="src/adw-preferences-row.c"
15050- line="250">whether an embedded underline in the title indicates a mnemonic</doc>
15051- <type name="gboolean" c:type="gboolean"/>
15052- </return-value>
15053- <parameters>
15054- <instance-parameter name="self" transfer-ownership="none">
15055- <doc xml:space="preserve"
15056- filename="src/adw-preferences-row.c"
15057- line="246">a preferences row</doc>
15058- <type name="PreferencesRow" c:type="AdwPreferencesRow*"/>
15059- </instance-parameter>
15060- </parameters>
15061- </method>
15062- <method name="set_title"
15063- c:identifier="adw_preferences_row_set_title"
15064- glib:set-property="title">
15065- <attribute name="org.gtk.Method.set_property" value="title"/>
15066- <doc xml:space="preserve"
15067- filename="src/adw-preferences-row.c"
15068- line="215">Sets the title of the preference represented by @self.
15069-
15070-The title is interpreted as Pango markup unless
15071-[property@PreferencesRow:use-markup] is set to `FALSE`.</doc>
15072- <source-position filename="src/adw-preferences-row.h" line="42"/>
15073- <return-value transfer-ownership="none">
15074- <type name="none" c:type="void"/>
27979+ filename="src/adw-animation-target.c"
27980+ line="356">the newly created `AdwPropertyAnimationTarget`</doc>
27981+ <type name="AnimationTarget" c:type="AdwAnimationTarget*"/>
1507527982 </return-value>
1507627983 <parameters>
15077- <instance-parameter name="self" transfer-ownership="none">
27984+ <parameter name="object" transfer-ownership="none">
1507827985 <doc xml:space="preserve"
15079- filename="src/adw-preferences-row.c"
15080- line="217">a preferences row</doc>
15081- <type name="PreferencesRow" c:type="AdwPreferencesRow*"/>
15082- </instance-parameter>
15083- <parameter name="title" transfer-ownership="none">
27986+ filename="src/adw-animation-target.c"
27987+ line="350">an object to be animated</doc>
27988+ <type name="GObject.Object" c:type="GObject*"/>
27989+ </parameter>
27990+ <parameter name="property_name" transfer-ownership="none">
1508427991 <doc xml:space="preserve"
15085- filename="src/adw-preferences-row.c"
15086- line="218">the title</doc>
27992+ filename="src/adw-animation-target.c"
27993+ line="351">the name of the property on @object to animate</doc>
1508727994 <type name="utf8" c:type="const char*"/>
1508827995 </parameter>
1508927996 </parameters>
15090- </method>
15091- <method name="set_title_selectable"
15092- c:identifier="adw_preferences_row_set_title_selectable"
15093- glib:set-property="title-selectable"
15094- version="1.1">
15095- <attribute name="org.gtk.Method.set_property"
15096- value="title-selectable"/>
27997+ </constructor>
27998+ <constructor name="new_for_pspec"
27999+ c:identifier="adw_property_animation_target_new_for_pspec"
28000+ version="1.2">
1509728001 <doc xml:space="preserve"
15098- filename="src/adw-preferences-row.c"
15099- line="311">Sets whether the user can copy the title from the label
15100-
15101-See also [property@Gtk.Label:selectable].</doc>
15102- <source-position filename="src/adw-preferences-row.h" line="54"/>
15103- <return-value transfer-ownership="none">
15104- <type name="none" c:type="void"/>
28002+ filename="src/adw-animation-target.c"
28003+ line="378">Creates a new `AdwPropertyAnimationTarget` for the @pspec property on
28004+@object.</doc>
28005+ <source-position filename="src/adw-animation-target.h" line="54"/>
28006+ <return-value transfer-ownership="full">
28007+ <doc xml:space="preserve"
28008+ filename="src/adw-animation-target.c"
28009+ line="386">new newly created `AdwPropertyAnimationTarget`</doc>
28010+ <type name="AnimationTarget" c:type="AdwAnimationTarget*"/>
1510528011 </return-value>
1510628012 <parameters>
15107- <instance-parameter name="self" transfer-ownership="none">
28013+ <parameter name="object" transfer-ownership="none">
1510828014 <doc xml:space="preserve"
15109- filename="src/adw-preferences-row.c"
15110- line="313">a `AdwPreferencesRow`</doc>
15111- <type name="PreferencesRow" c:type="AdwPreferencesRow*"/>
15112- </instance-parameter>
15113- <parameter name="title_selectable" transfer-ownership="none">
28015+ filename="src/adw-animation-target.c"
28016+ line="380">an object to be animated</doc>
28017+ <type name="GObject.Object" c:type="GObject*"/>
28018+ </parameter>
28019+ <parameter name="pspec" transfer-ownership="none">
1511428020 <doc xml:space="preserve"
15115- filename="src/adw-preferences-row.c"
15116- line="314">`TRUE` if the user can copy the title from the label</doc>
15117- <type name="gboolean" c:type="gboolean"/>
28021+ filename="src/adw-animation-target.c"
28022+ line="381">the param spec of the property on @object to animate</doc>
28023+ <type name="GObject.ParamSpec" c:type="GParamSpec*"/>
1511828024 </parameter>
1511928025 </parameters>
15120- </method>
15121- <method name="set_use_markup"
15122- c:identifier="adw_preferences_row_set_use_markup"
15123- glib:set-property="use-markup"
28026+ </constructor>
28027+ <method name="get_object"
28028+ c:identifier="adw_property_animation_target_get_object"
28029+ glib:get-property="object"
1512428030 version="1.2">
15125- <attribute name="org.gtk.Method.set_property" value="use-markup"/>
1512628031 <doc xml:space="preserve"
15127- filename="src/adw-preferences-row.c"
15128- line="362">Sets whether to use Pango markup for the title label.
15129-
15130-Subclasses may also use it for other labels, such as subtitle.
28032+ filename="src/adw-animation-target.c"
28033+ line="403">Gets the object animated by @self.
1513128034
15132-See also [func@Pango.parse_markup].</doc>
15133- <source-position filename="src/adw-preferences-row.h" line="61"/>
28035+The `AdwPropertyAnimationTarget` instance does not hold a strong reference on
28036+the object; make sure the object is kept alive throughout the target's
28037+lifetime.</doc>
28038+ <source-position filename="src/adw-animation-target.h" line="58"/>
1513428039 <return-value transfer-ownership="none">
15135- <type name="none" c:type="void"/>
28040+ <doc xml:space="preserve"
28041+ filename="src/adw-animation-target.c"
28042+ line="413">the animated object</doc>
28043+ <type name="GObject.Object" c:type="GObject*"/>
1513628044 </return-value>
1513728045 <parameters>
1513828046 <instance-parameter name="self" transfer-ownership="none">
1513928047 <doc xml:space="preserve"
15140- filename="src/adw-preferences-row.c"
15141- line="364">a preferences row</doc>
15142- <type name="PreferencesRow" c:type="AdwPreferencesRow*"/>
28048+ filename="src/adw-animation-target.c"
28049+ line="405">a property animation target</doc>
28050+ <type name="PropertyAnimationTarget"
28051+ c:type="AdwPropertyAnimationTarget*"/>
1514328052 </instance-parameter>
15144- <parameter name="use_markup" transfer-ownership="none">
15145- <doc xml:space="preserve"
15146- filename="src/adw-preferences-row.c"
15147- line="365">whether to use markup</doc>
15148- <type name="gboolean" c:type="gboolean"/>
15149- </parameter>
1515028053 </parameters>
1515128054 </method>
15152- <method name="set_use_underline"
15153- c:identifier="adw_preferences_row_set_use_underline"
15154- glib:set-property="use-underline">
15155- <attribute name="org.gtk.Method.set_property" value="use-underline"/>
28055+ <method name="get_pspec"
28056+ c:identifier="adw_property_animation_target_get_pspec"
28057+ glib:get-property="pspec"
28058+ version="1.2">
1515628059 <doc xml:space="preserve"
15157- filename="src/adw-preferences-row.c"
15158- line="264">Sets whether an embedded underline in the title indicates a mnemonic.</doc>
15159- <source-position filename="src/adw-preferences-row.h" line="48"/>
28060+ filename="src/adw-animation-target.c"
28061+ line="425">Gets the `GParamSpec` of the property animated by @self.</doc>
28062+ <source-position filename="src/adw-animation-target.h" line="60"/>
1516028063 <return-value transfer-ownership="none">
15161- <type name="none" c:type="void"/>
28064+ <doc xml:space="preserve"
28065+ filename="src/adw-animation-target.c"
28066+ line="431">the animated property's `GParamSpec`</doc>
28067+ <type name="GObject.ParamSpec" c:type="GParamSpec*"/>
1516228068 </return-value>
1516328069 <parameters>
1516428070 <instance-parameter name="self" transfer-ownership="none">
1516528071 <doc xml:space="preserve"
15166- filename="src/adw-preferences-row.c"
15167- line="266">a preferences row</doc>
15168- <type name="PreferencesRow" c:type="AdwPreferencesRow*"/>
28072+ filename="src/adw-animation-target.c"
28073+ line="427">a property animation target</doc>
28074+ <type name="PropertyAnimationTarget"
28075+ c:type="AdwPropertyAnimationTarget*"/>
1516928076 </instance-parameter>
15170- <parameter name="use_underline" transfer-ownership="none">
15171- <doc xml:space="preserve"
15172- filename="src/adw-preferences-row.c"
15173- line="267">`TRUE` if underlines in the text indicate mnemonics</doc>
15174- <type name="gboolean" c:type="gboolean"/>
15175- </parameter>
1517628077 </parameters>
1517728078 </method>
15178- <property name="title"
15179- writable="1"
15180- transfer-ownership="none"
15181- setter="set_title"
15182- getter="get_title">
15183- <attribute name="org.gtk.Property.get"
15184- value="adw_preferences_row_get_title"/>
15185- <attribute name="org.gtk.Property.set"
15186- value="adw_preferences_row_set_title"/>
15187- <doc xml:space="preserve"
15188- filename="src/adw-preferences-row.c"
15189- line="118">The title of the preference represented by this row.
15190-
15191-The title is interpreted as Pango markup unless
15192-[property@PreferencesRow:use-markup] is set to `FALSE`.</doc>
15193- <type name="utf8" c:type="gchar*"/>
15194- </property>
15195- <property name="title-selectable"
15196- version="1.1"
15197- writable="1"
15198- transfer-ownership="none"
15199- setter="set_title_selectable"
15200- getter="get_title_selectable"
15201- default-value="FALSE">
15202- <attribute name="org.gtk.Property.get"
15203- value="adw_preferences_row_get_title_selectable"/>
15204- <attribute name="org.gtk.Property.set"
15205- value="adw_preferences_row_set_title_selectable"/>
15206- <doc xml:space="preserve"
15207- filename="src/adw-preferences-row.c"
15208- line="141">Whether the user can copy the title from the label.
15209-
15210-See also [property@Gtk.Label:selectable].</doc>
15211- <type name="gboolean" c:type="gboolean"/>
15212- </property>
15213- <property name="use-markup"
28079+ <property name="object"
1521428080 version="1.2"
1521528081 writable="1"
28082+ construct-only="1"
1521628083 transfer-ownership="none"
15217- setter="set_use_markup"
15218- getter="get_use_markup"
15219- default-value="TRUE">
15220- <attribute name="org.gtk.Property.get"
15221- value="adw_preferences_row_get_use_markup"/>
15222- <attribute name="org.gtk.Property.set"
15223- value="adw_preferences_row_set_use_markup"/>
28084+ getter="get_object">
1522428085 <doc xml:space="preserve"
15225- filename="src/adw-preferences-row.c"
15226- line="155">Whether to use Pango markup for the title label.
15227-
15228-Subclasses may also use it for other labels, such as subtitle.
28086+ filename="src/adw-animation-target.c"
28087+ line="310">The object whose property will be animated.
1522928088
15230-See also [func@Pango.parse_markup].</doc>
15231- <type name="gboolean" c:type="gboolean"/>
28089+The `AdwPropertyAnimationTarget` instance does not hold a strong reference
28090+on the object; make sure the object is kept alive throughout the target's
28091+lifetime.</doc>
28092+ <type name="GObject.Object"/>
1523228093 </property>
15233- <property name="use-underline"
28094+ <property name="pspec"
28095+ version="1.2"
1523428096 writable="1"
28097+ construct-only="1"
1523528098 transfer-ownership="none"
15236- setter="set_use_underline"
15237- getter="get_use_underline"
15238- default-value="FALSE">
15239- <attribute name="org.gtk.Property.get"
15240- value="adw_preferences_row_get_use_underline"/>
15241- <attribute name="org.gtk.Property.set"
15242- value="adw_preferences_row_set_use_underline"/>
28099+ getter="get_pspec">
1524328100 <doc xml:space="preserve"
15244- filename="src/adw-preferences-row.c"
15245- line="131">Whether an embedded underline in the title indicates a mnemonic.</doc>
15246- <type name="gboolean" c:type="gboolean"/>
28101+ filename="src/adw-animation-target.c"
28102+ line="326">The `GParamSpec` of the property to be animated.</doc>
28103+ <type name="GObject.ParamSpec"/>
1524728104 </property>
15248- <field name="parent_instance">
15249- <type name="Gtk.ListBoxRow" c:type="GtkListBoxRow"/>
15250- </field>
1525128105 </class>
15252- <record name="PreferencesRowClass"
15253- c:type="AdwPreferencesRowClass"
15254- glib:is-gtype-struct-for="PreferencesRow">
15255- <source-position filename="src/adw-preferences-row.h" line="34"/>
15256- <field name="parent_class">
15257- <doc xml:space="preserve"
15258- filename="src/adw-preferences-row.h"
15259- line="26">The parent class</doc>
15260- <type name="Gtk.ListBoxRowClass" c:type="GtkListBoxRowClass"/>
15261- </field>
15262- <field name="padding" readable="0" private="1">
15263- <array zero-terminated="0" fixed-size="4">
15264- <type name="gpointer" c:type="gpointer"/>
15265- </array>
15266- </field>
28106+ <record name="PropertyAnimationTargetClass"
28107+ c:type="AdwPropertyAnimationTargetClass"
28108+ disguised="1"
28109+ opaque="1"
28110+ glib:is-gtype-struct-for="PropertyAnimationTarget">
28111+ <source-position filename="src/adw-animation-target.h" line="48"/>
1526728112 </record>
15268- <class name="PreferencesWindow"
15269- c:symbol-prefix="preferences_window"
15270- c:type="AdwPreferencesWindow"
15271- parent="Window"
15272- glib:type-name="AdwPreferencesWindow"
15273- glib:get-type="adw_preferences_window_get_type"
15274- glib:type-struct="PreferencesWindowClass">
28113+ <enumeration name="ResponseAppearance"
28114+ version="1.2"
28115+ glib:type-name="AdwResponseAppearance"
28116+ glib:get-type="adw_response_appearance_get_type"
28117+ c:type="AdwResponseAppearance">
28118+ <doc xml:space="preserve"
28119+ filename="src/adw-alert-dialog.c"
28120+ line="159">Describes the possible styles of [class@AlertDialog] response buttons.
28121+
28122+See [method@AlertDialog.set_response_appearance].</doc>
28123+ <member name="default"
28124+ value="0"
28125+ c:identifier="ADW_RESPONSE_DEFAULT"
28126+ glib:nick="default"
28127+ glib:name="ADW_RESPONSE_DEFAULT">
28128+ <doc xml:space="preserve"
28129+ filename="src/adw-alert-dialog.c"
28130+ line="161">the default appearance.</doc>
28131+ </member>
28132+ <member name="suggested"
28133+ value="1"
28134+ c:identifier="ADW_RESPONSE_SUGGESTED"
28135+ glib:nick="suggested"
28136+ glib:name="ADW_RESPONSE_SUGGESTED">
28137+ <doc xml:space="preserve"
28138+ filename="src/adw-alert-dialog.c"
28139+ line="162">used to denote important responses such as the
28140+ affirmative action.</doc>
28141+ </member>
28142+ <member name="destructive"
28143+ value="2"
28144+ c:identifier="ADW_RESPONSE_DESTRUCTIVE"
28145+ glib:nick="destructive"
28146+ glib:name="ADW_RESPONSE_DESTRUCTIVE">
28147+ <doc xml:space="preserve"
28148+ filename="src/adw-alert-dialog.c"
28149+ line="164">used to draw attention to the potentially damaging
28150+ consequences of using the response. This appearance acts as a warning to
28151+ the user.</doc>
28152+ </member>
28153+ </enumeration>
28154+ <class name="SpinRow"
28155+ c:symbol-prefix="spin_row"
28156+ c:type="AdwSpinRow"
28157+ version="1.4"
28158+ parent="ActionRow"
28159+ final="1"
28160+ glib:type-name="AdwSpinRow"
28161+ glib:get-type="adw_spin_row_get_type"
28162+ glib:type-struct="SpinRowClass">
1527528163 <doc xml:space="preserve"
15276- filename="src/adw-preferences-window.c"
15277- line="23">A window to present an application's preferences.
28164+ filename="src/adw-spin-row.c"
28165+ line="19">An [class@ActionRow] with an embedded spin button.
1527828166
1527928167 &lt;picture&gt;
15280- &lt;source srcset="preferences-window-dark.png" media="(prefers-color-scheme: dark)"&gt;
15281- &lt;img src="preferences-window.png" alt="preferences-window"&gt;
28168+ &lt;source srcset="spin-row-dark.png" media="(prefers-color-scheme: dark)"&gt;
28169+ &lt;img src="spin-row.png" alt="spin-row"&gt;
1528228170 &lt;/picture&gt;
1528328171
15284-The `AdwPreferencesWindow` widget presents an application's preferences
15285-gathered into pages and groups. The preferences are searchable by the user.
28172+Example of an `AdwSpinRow` UI definition:
28173+
28174+```xml
28175+&lt;object class="AdwSpinRow"&gt;
28176+ &lt;property name="title" translatable="yes"&gt;Spin Row&lt;/property&gt;
28177+ &lt;property name="adjustment"&gt;
28178+ &lt;object class="GtkAdjustment"&gt;
28179+ &lt;property name="lower"&gt;0&lt;/property&gt;
28180+ &lt;property name="upper"&gt;100&lt;/property&gt;
28181+ &lt;property name="value"&gt;50&lt;/property&gt;
28182+ &lt;property name="page-increment"&gt;10&lt;/property&gt;
28183+ &lt;property name="step-increment"&gt;1&lt;/property&gt;
28184+ &lt;/object&gt;
28185+ &lt;/property&gt;
28186+&lt;/object&gt;
28187+```
28188+
28189+See [class@Gtk.SpinButton] for details.
1528628190
1528728191 ## CSS nodes
1528828192
15289-`AdwPreferencesWindow` has a main CSS node with the name `window` and the
15290-style class `.preferences`.</doc>
15291- <source-position filename="src/adw-preferences-window.h" line="37"/>
28193+`AdwSpinRow` has the same structure as [class@ActionRow], as well as the
28194+`.spin` style class on the main node.
28195+
28196+## Accessibility
28197+
28198+`AdwSpinRow` uses an internal `GtkSpinButton` with the
28199+`GTK_ACCESSIBLE_ROLE_SPIN_BUTTON` role.</doc>
28200+ <source-position filename="src/adw-spin-row.h" line="24"/>
1529228201 <implements name="Gtk.Accessible"/>
28202+ <implements name="Gtk.Actionable"/>
1529328203 <implements name="Gtk.Buildable"/>
1529428204 <implements name="Gtk.ConstraintTarget"/>
15295- <implements name="Gtk.Native"/>
15296- <implements name="Gtk.Root"/>
15297- <implements name="Gtk.ShortcutManager"/>
15298- <constructor name="new" c:identifier="adw_preferences_window_new">
28205+ <implements name="Gtk.Editable"/>
28206+ <constructor name="new" c:identifier="adw_spin_row_new" version="1.4">
1529928207 <doc xml:space="preserve"
15300- filename="src/adw-preferences-window.c"
15301- line="712">Creates a new `AdwPreferencesWindow`.</doc>
15302- <source-position filename="src/adw-preferences-window.h" line="40"/>
28208+ filename="src/adw-spin-row.c"
28209+ line="518">Creates a new `AdwSpinRow`.</doc>
28210+ <source-position filename="src/adw-spin-row.h" line="27"/>
1530328211 <return-value transfer-ownership="none">
1530428212 <doc xml:space="preserve"
15305- filename="src/adw-preferences-window.c"
15306- line="717">the newly created `AdwPreferencesWindow`</doc>
28213+ filename="src/adw-spin-row.c"
28214+ line="526">the newly created `AdwSpinRow`</doc>
1530728215 <type name="Gtk.Widget" c:type="GtkWidget*"/>
1530828216 </return-value>
28217+ <parameters>
28218+ <parameter name="adjustment"
28219+ transfer-ownership="none"
28220+ nullable="1"
28221+ allow-none="1">
28222+ <doc xml:space="preserve"
28223+ filename="src/adw-spin-row.c"
28224+ line="520">the adjustment that this spin row should use</doc>
28225+ <type name="Gtk.Adjustment" c:type="GtkAdjustment*"/>
28226+ </parameter>
28227+ <parameter name="climb_rate" transfer-ownership="none">
28228+ <doc xml:space="preserve"
28229+ filename="src/adw-spin-row.c"
28230+ line="521">the rate the value changes when holding a button or key</doc>
28231+ <type name="gdouble" c:type="double"/>
28232+ </parameter>
28233+ <parameter name="digits" transfer-ownership="none">
28234+ <doc xml:space="preserve"
28235+ filename="src/adw-spin-row.c"
28236+ line="522">the number of decimal places to display</doc>
28237+ <type name="guint" c:type="guint"/>
28238+ </parameter>
28239+ </parameters>
1530928240 </constructor>
15310- <method name="add" c:identifier="adw_preferences_window_add">
28241+ <constructor name="new_with_range"
28242+ c:identifier="adw_spin_row_new_with_range"
28243+ version="1.4">
1531128244 <doc xml:space="preserve"
15312- filename="src/adw-preferences-window.c"
15313- line="725">Adds a preferences page to @self.</doc>
15314- <source-position filename="src/adw-preferences-window.h" line="43"/>
28245+ filename="src/adw-spin-row.c"
28246+ line="545">Creates a new `AdwSpinRow` with the given properties.
28247+
28248+This is a convenience constructor that allows creation of a numeric
28249+`AdwSpinRow` without manually creating an adjustment. The value is initially
28250+set to the minimum value and a page increment of 10 * @step is the default.
28251+The precision of the spin row is equivalent to the precisions of @step.
28252+
28253+::: note
28254+ The way in which the precision is derived works best if @step is a power
28255+ of ten. If the resulting precision is not suitable for your needs, use
28256+ [method@SpinRow.set_digits] to correct it.</doc>
28257+ <source-position filename="src/adw-spin-row.h" line="31"/>
28258+ <return-value transfer-ownership="none">
28259+ <doc xml:space="preserve"
28260+ filename="src/adw-spin-row.c"
28261+ line="563">the new `AdwSpinRow`</doc>
28262+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
28263+ </return-value>
28264+ <parameters>
28265+ <parameter name="min" transfer-ownership="none">
28266+ <doc xml:space="preserve"
28267+ filename="src/adw-spin-row.c"
28268+ line="547">minimum allowable value</doc>
28269+ <type name="gdouble" c:type="double"/>
28270+ </parameter>
28271+ <parameter name="max" transfer-ownership="none">
28272+ <doc xml:space="preserve"
28273+ filename="src/adw-spin-row.c"
28274+ line="548">maximum allowable value</doc>
28275+ <type name="gdouble" c:type="double"/>
28276+ </parameter>
28277+ <parameter name="step" transfer-ownership="none">
28278+ <doc xml:space="preserve"
28279+ filename="src/adw-spin-row.c"
28280+ line="549">increment added or subtracted by spinning the widget</doc>
28281+ <type name="gdouble" c:type="double"/>
28282+ </parameter>
28283+ </parameters>
28284+ </constructor>
28285+ <method name="configure"
28286+ c:identifier="adw_spin_row_configure"
28287+ version="1.4">
28288+ <doc xml:space="preserve"
28289+ filename="src/adw-spin-row.c"
28290+ line="597">Changes the properties of an existing spin row.
28291+
28292+The adjustment, climb rate, and number of decimal places are updated
28293+accordingly.</doc>
28294+ <source-position filename="src/adw-spin-row.h" line="35"/>
1531528295 <return-value transfer-ownership="none">
1531628296 <type name="none" c:type="void"/>
1531728297 </return-value>
1531828298 <parameters>
1531928299 <instance-parameter name="self" transfer-ownership="none">
1532028300 <doc xml:space="preserve"
15321- filename="src/adw-preferences-window.c"
15322- line="727">a preferences window</doc>
15323- <type name="PreferencesWindow" c:type="AdwPreferencesWindow*"/>
28301+ filename="src/adw-spin-row.c"
28302+ line="599">a spin row</doc>
28303+ <type name="SpinRow" c:type="AdwSpinRow*"/>
1532428304 </instance-parameter>
15325- <parameter name="page" transfer-ownership="none">
28305+ <parameter name="adjustment"
28306+ transfer-ownership="none"
28307+ nullable="1"
28308+ allow-none="1">
1532628309 <doc xml:space="preserve"
15327- filename="src/adw-preferences-window.c"
15328- line="728">the page to add</doc>
15329- <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
28310+ filename="src/adw-spin-row.c"
28311+ line="600">the adjustment that this spin row should use</doc>
28312+ <type name="Gtk.Adjustment" c:type="GtkAdjustment*"/>
28313+ </parameter>
28314+ <parameter name="climb_rate" transfer-ownership="none">
28315+ <doc xml:space="preserve"
28316+ filename="src/adw-spin-row.c"
28317+ line="601">the new climb rate</doc>
28318+ <type name="gdouble" c:type="double"/>
28319+ </parameter>
28320+ <parameter name="digits" transfer-ownership="none">
28321+ <doc xml:space="preserve"
28322+ filename="src/adw-spin-row.c"
28323+ line="602">the number of decimal places to display</doc>
28324+ <type name="guint" c:type="guint"/>
1533028325 </parameter>
1533128326 </parameters>
1533228327 </method>
15333- <method name="add_toast" c:identifier="adw_preferences_window_add_toast">
28328+ <method name="get_adjustment"
28329+ c:identifier="adw_spin_row_get_adjustment"
28330+ glib:get-property="adjustment"
28331+ version="1.4">
1533428332 <doc xml:space="preserve"
15335- filename="src/adw-preferences-window.c"
15336- line="1029">Displays @toast.
15337-
15338-See [method@ToastOverlay.add_toast].</doc>
15339- <source-position filename="src/adw-preferences-window.h" line="80"/>
28333+ filename="src/adw-spin-row.c"
28334+ line="630">Gets the adjustment that holds the value for the spin row.</doc>
28335+ <source-position filename="src/adw-spin-row.h" line="41"/>
1534028336 <return-value transfer-ownership="none">
15341- <type name="none" c:type="void"/>
28337+ <doc xml:space="preserve"
28338+ filename="src/adw-spin-row.c"
28339+ line="636">the adjustment that holds the spin row's value</doc>
28340+ <type name="Gtk.Adjustment" c:type="GtkAdjustment*"/>
1534228341 </return-value>
1534328342 <parameters>
1534428343 <instance-parameter name="self" transfer-ownership="none">
1534528344 <doc xml:space="preserve"
15346- filename="src/adw-preferences-window.c"
15347- line="1031">a preferences window</doc>
15348- <type name="PreferencesWindow" c:type="AdwPreferencesWindow*"/>
28345+ filename="src/adw-spin-row.c"
28346+ line="632">a spin row</doc>
28347+ <type name="SpinRow" c:type="AdwSpinRow*"/>
1534928348 </instance-parameter>
15350- <parameter name="toast" transfer-ownership="full">
28349+ </parameters>
28350+ </method>
28351+ <method name="get_climb_rate"
28352+ c:identifier="adw_spin_row_get_climb_rate"
28353+ glib:get-property="climb-rate"
28354+ version="1.4">
28355+ <doc xml:space="preserve"
28356+ filename="src/adw-spin-row.c"
28357+ line="674">Gets the acceleration rate when you hold down a button or key.</doc>
28358+ <source-position filename="src/adw-spin-row.h" line="47"/>
28359+ <return-value transfer-ownership="none">
28360+ <doc xml:space="preserve"
28361+ filename="src/adw-spin-row.c"
28362+ line="680">the acceleration rate when you hold down a button or key</doc>
28363+ <type name="gdouble" c:type="double"/>
28364+ </return-value>
28365+ <parameters>
28366+ <instance-parameter name="self" transfer-ownership="none">
1535128367 <doc xml:space="preserve"
15352- filename="src/adw-preferences-window.c"
15353- line="1032">a toast</doc>
15354- <type name="Toast" c:type="AdwToast*"/>
15355- </parameter>
28368+ filename="src/adw-spin-row.c"
28369+ line="676">a spin row</doc>
28370+ <type name="SpinRow" c:type="AdwSpinRow*"/>
28371+ </instance-parameter>
1535628372 </parameters>
1535728373 </method>
15358- <method name="close_subpage"
15359- c:identifier="adw_preferences_window_close_subpage">
28374+ <method name="get_digits"
28375+ c:identifier="adw_spin_row_get_digits"
28376+ glib:get-property="digits"
28377+ version="1.4">
1536028378 <doc xml:space="preserve"
15361- filename="src/adw-preferences-window.c"
15362- line="1006">Closes the current subpage.
15363-
15364-If there is no presented subpage, this does nothing.</doc>
15365- <source-position filename="src/adw-preferences-window.h" line="77"/>
28379+ filename="src/adw-spin-row.c"
28380+ line="716">Gets the number of decimal places to display.</doc>
28381+ <source-position filename="src/adw-spin-row.h" line="53"/>
1536628382 <return-value transfer-ownership="none">
15367- <type name="none" c:type="void"/>
28383+ <doc xml:space="preserve"
28384+ filename="src/adw-spin-row.c"
28385+ line="722">the number of decimal places to display</doc>
28386+ <type name="guint" c:type="guint"/>
1536828387 </return-value>
1536928388 <parameters>
1537028389 <instance-parameter name="self" transfer-ownership="none">
1537128390 <doc xml:space="preserve"
15372- filename="src/adw-preferences-window.c"
15373- line="1008">a preferences window</doc>
15374- <type name="PreferencesWindow" c:type="AdwPreferencesWindow*"/>
28391+ filename="src/adw-spin-row.c"
28392+ line="718">a spin row</doc>
28393+ <type name="SpinRow" c:type="AdwSpinRow*"/>
1537528394 </instance-parameter>
1537628395 </parameters>
1537728396 </method>
15378- <method name="get_can_navigate_back"
15379- c:identifier="adw_preferences_window_get_can_navigate_back"
15380- glib:get-property="can-navigate-back">
15381- <attribute name="org.gtk.Method.get_property"
15382- value="can-navigate-back"/>
28397+ <method name="get_numeric"
28398+ c:identifier="adw_spin_row_get_numeric"
28399+ glib:get-property="numeric"
28400+ version="1.4">
1538328401 <doc xml:space="preserve"
15384- filename="src/adw-preferences-window.c"
15385- line="951">Gets whether gestures and shortcuts for closing subpages are enabled.</doc>
15386- <source-position filename="src/adw-preferences-window.h" line="68"/>
28402+ filename="src/adw-spin-row.c"
28403+ line="757">Gets whether non-numeric characters should be ignored.</doc>
28404+ <source-position filename="src/adw-spin-row.h" line="59"/>
1538728405 <return-value transfer-ownership="none">
1538828406 <doc xml:space="preserve"
15389- filename="src/adw-preferences-window.c"
15390- line="957">whether gestures and shortcuts are enabled.</doc>
28407+ filename="src/adw-spin-row.c"
28408+ line="763">whether non-numeric characters should be ignored.</doc>
1539128409 <type name="gboolean" c:type="gboolean"/>
1539228410 </return-value>
1539328411 <parameters>
1539428412 <instance-parameter name="self" transfer-ownership="none">
1539528413 <doc xml:space="preserve"
15396- filename="src/adw-preferences-window.c"
15397- line="953">a preferences window</doc>
15398- <type name="PreferencesWindow" c:type="AdwPreferencesWindow*"/>
28414+ filename="src/adw-spin-row.c"
28415+ line="759">a spin row</doc>
28416+ <type name="SpinRow" c:type="AdwSpinRow*"/>
1539928417 </instance-parameter>
1540028418 </parameters>
1540128419 </method>
15402- <method name="get_search_enabled"
15403- c:identifier="adw_preferences_window_get_search_enabled"
15404- glib:get-property="search-enabled">
15405- <attribute name="org.gtk.Method.get_property" value="search-enabled"/>
28420+ <method name="get_snap_to_ticks"
28421+ c:identifier="adw_spin_row_get_snap_to_ticks"
28422+ glib:get-property="snap-to-ticks"
28423+ version="1.4">
1540628424 <doc xml:space="preserve"
15407- filename="src/adw-preferences-window.c"
15408- line="859">Gets whether search is enabled for @self.</doc>
15409- <source-position filename="src/adw-preferences-window.h" line="62"/>
28425+ filename="src/adw-spin-row.c"
28426+ line="800">Gets whether invalid values are snapped to nearest step increment.</doc>
28427+ <source-position filename="src/adw-spin-row.h" line="65"/>
1541028428 <return-value transfer-ownership="none">
1541128429 <doc xml:space="preserve"
15412- filename="src/adw-preferences-window.c"
15413- line="865">whether search is enabled for @self.</doc>
28430+ filename="src/adw-spin-row.c"
28431+ line="806">whether invalid values are snapped to the nearest step increment</doc>
1541428432 <type name="gboolean" c:type="gboolean"/>
1541528433 </return-value>
1541628434 <parameters>
1541728435 <instance-parameter name="self" transfer-ownership="none">
1541828436 <doc xml:space="preserve"
15419- filename="src/adw-preferences-window.c"
15420- line="861">a preferences window</doc>
15421- <type name="PreferencesWindow" c:type="AdwPreferencesWindow*"/>
28437+ filename="src/adw-spin-row.c"
28438+ line="802">a spin row</doc>
28439+ <type name="SpinRow" c:type="AdwSpinRow*"/>
1542228440 </instance-parameter>
1542328441 </parameters>
1542428442 </method>
15425- <method name="get_visible_page"
15426- c:identifier="adw_preferences_window_get_visible_page"
15427- glib:get-property="visible-page">
28443+ <method name="get_update_policy"
28444+ c:identifier="adw_spin_row_get_update_policy"
28445+ glib:get-property="update-policy"
28446+ version="1.4">
1542828447 <doc xml:space="preserve"
15429- filename="src/adw-preferences-window.c"
15430- line="776">Gets the currently visible page of @self.</doc>
15431- <source-position filename="src/adw-preferences-window.h" line="50"/>
15432- <return-value transfer-ownership="none" nullable="1">
28448+ filename="src/adw-spin-row.c"
28449+ line="843">Gets the policy for updating the spin row.</doc>
28450+ <source-position filename="src/adw-spin-row.h" line="71"/>
28451+ <return-value transfer-ownership="none">
1543328452 <doc xml:space="preserve"
15434- filename="src/adw-preferences-window.c"
15435- line="782">the visible page</doc>
15436- <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
28453+ filename="src/adw-spin-row.c"
28454+ line="849">the policy for updating the spin row</doc>
28455+ <type name="Gtk.SpinButtonUpdatePolicy"
28456+ c:type="GtkSpinButtonUpdatePolicy"/>
1543728457 </return-value>
1543828458 <parameters>
1543928459 <instance-parameter name="self" transfer-ownership="none">
1544028460 <doc xml:space="preserve"
15441- filename="src/adw-preferences-window.c"
15442- line="778">a preferences window</doc>
15443- <type name="PreferencesWindow" c:type="AdwPreferencesWindow*"/>
28461+ filename="src/adw-spin-row.c"
28462+ line="845">a spin row</doc>
28463+ <type name="SpinRow" c:type="AdwSpinRow*"/>
1544428464 </instance-parameter>
1544528465 </parameters>
1544628466 </method>
15447- <method name="get_visible_page_name"
15448- c:identifier="adw_preferences_window_get_visible_page_name"
15449- glib:get-property="visible-page-name">
28467+ <method name="get_value"
28468+ c:identifier="adw_spin_row_get_value"
28469+ glib:get-property="value"
28470+ version="1.4">
1545028471 <doc xml:space="preserve"
15451- filename="src/adw-preferences-window.c"
15452- line="817">Gets the name of currently visible page of @self.</doc>
15453- <source-position filename="src/adw-preferences-window.h" line="56"/>
15454- <return-value transfer-ownership="none" nullable="1">
28472+ filename="src/adw-spin-row.c"
28473+ line="886">Gets the current value.</doc>
28474+ <source-position filename="src/adw-spin-row.h" line="77"/>
28475+ <return-value transfer-ownership="none">
1545528476 <doc xml:space="preserve"
15456- filename="src/adw-preferences-window.c"
15457- line="823">the name of the visible page</doc>
15458- <type name="utf8" c:type="const char*"/>
28477+ filename="src/adw-spin-row.c"
28478+ line="892">the current value</doc>
28479+ <type name="gdouble" c:type="double"/>
1545928480 </return-value>
1546028481 <parameters>
1546128482 <instance-parameter name="self" transfer-ownership="none">
1546228483 <doc xml:space="preserve"
15463- filename="src/adw-preferences-window.c"
15464- line="819">a preferences window</doc>
15465- <type name="PreferencesWindow" c:type="AdwPreferencesWindow*"/>
28484+ filename="src/adw-spin-row.c"
28485+ line="888">a spin row</doc>
28486+ <type name="SpinRow" c:type="AdwSpinRow*"/>
1546628487 </instance-parameter>
1546728488 </parameters>
1546828489 </method>
15469- <method name="present_subpage"
15470- c:identifier="adw_preferences_window_present_subpage">
28490+ <method name="get_wrap"
28491+ c:identifier="adw_spin_row_get_wrap"
28492+ glib:get-property="wrap"
28493+ version="1.4">
1547128494 <doc xml:space="preserve"
15472- filename="src/adw-preferences-window.c"
15473- line="971">Sets @subpage as the window's subpage and opens it.
15474-
15475-The transition can be cancelled by the user, in which case visible child will
15476-change back to the previously visible child.</doc>
15477- <source-position filename="src/adw-preferences-window.h" line="74"/>
28495+ filename="src/adw-spin-row.c"
28496+ line="925">Gets whether the spin row should wrap upon reaching its limits.</doc>
28497+ <source-position filename="src/adw-spin-row.h" line="83"/>
28498+ <return-value transfer-ownership="none">
28499+ <doc xml:space="preserve"
28500+ filename="src/adw-spin-row.c"
28501+ line="931">whether the spin row should wrap upon reaching its limits</doc>
28502+ <type name="gboolean" c:type="gboolean"/>
28503+ </return-value>
28504+ <parameters>
28505+ <instance-parameter name="self" transfer-ownership="none">
28506+ <doc xml:space="preserve"
28507+ filename="src/adw-spin-row.c"
28508+ line="927">a spin row</doc>
28509+ <type name="SpinRow" c:type="AdwSpinRow*"/>
28510+ </instance-parameter>
28511+ </parameters>
28512+ </method>
28513+ <method name="set_adjustment"
28514+ c:identifier="adw_spin_row_set_adjustment"
28515+ glib:set-property="adjustment"
28516+ version="1.4">
28517+ <doc xml:space="preserve"
28518+ filename="src/adw-spin-row.c"
28519+ line="650">Sets the adjustment that holds the value for the spin row.</doc>
28520+ <source-position filename="src/adw-spin-row.h" line="43"/>
1547828521 <return-value transfer-ownership="none">
1547928522 <type name="none" c:type="void"/>
1548028523 </return-value>
1548128524 <parameters>
1548228525 <instance-parameter name="self" transfer-ownership="none">
1548328526 <doc xml:space="preserve"
15484- filename="src/adw-preferences-window.c"
15485- line="973">a preferences window</doc>
15486- <type name="PreferencesWindow" c:type="AdwPreferencesWindow*"/>
28527+ filename="src/adw-spin-row.c"
28528+ line="652">a spin row</doc>
28529+ <type name="SpinRow" c:type="AdwSpinRow*"/>
1548728530 </instance-parameter>
15488- <parameter name="subpage" transfer-ownership="none">
28531+ <parameter name="adjustment"
28532+ transfer-ownership="none"
28533+ nullable="1"
28534+ allow-none="1">
1548928535 <doc xml:space="preserve"
15490- filename="src/adw-preferences-window.c"
15491- line="974">the subpage</doc>
15492- <type name="Gtk.Widget" c:type="GtkWidget*"/>
28536+ filename="src/adw-spin-row.c"
28537+ line="653">an adjustment</doc>
28538+ <type name="Gtk.Adjustment" c:type="GtkAdjustment*"/>
1549328539 </parameter>
1549428540 </parameters>
1549528541 </method>
15496- <method name="remove" c:identifier="adw_preferences_window_remove">
28542+ <method name="set_climb_rate"
28543+ c:identifier="adw_spin_row_set_climb_rate"
28544+ glib:set-property="climb-rate"
28545+ version="1.4">
1549728546 <doc xml:space="preserve"
15498- filename="src/adw-preferences-window.c"
15499- line="752">Removes a page from @self.</doc>
15500- <source-position filename="src/adw-preferences-window.h" line="46"/>
28547+ filename="src/adw-spin-row.c"
28548+ line="692">Sets the acceleration rate when you hold down a button or key.</doc>
28549+ <source-position filename="src/adw-spin-row.h" line="49"/>
1550128550 <return-value transfer-ownership="none">
1550228551 <type name="none" c:type="void"/>
1550328552 </return-value>
1550428553 <parameters>
1550528554 <instance-parameter name="self" transfer-ownership="none">
1550628555 <doc xml:space="preserve"
15507- filename="src/adw-preferences-window.c"
15508- line="754">a preferences window</doc>
15509- <type name="PreferencesWindow" c:type="AdwPreferencesWindow*"/>
28556+ filename="src/adw-spin-row.c"
28557+ line="694">a spin row</doc>
28558+ <type name="SpinRow" c:type="AdwSpinRow*"/>
1551028559 </instance-parameter>
15511- <parameter name="page" transfer-ownership="none">
28560+ <parameter name="climb_rate" transfer-ownership="none">
1551228561 <doc xml:space="preserve"
15513- filename="src/adw-preferences-window.c"
15514- line="755">the page to remove</doc>
15515- <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
28562+ filename="src/adw-spin-row.c"
28563+ line="695">the acceleration rate when you hold down a button or key</doc>
28564+ <type name="gdouble" c:type="double"/>
1551628565 </parameter>
1551728566 </parameters>
1551828567 </method>
15519- <method name="set_can_navigate_back"
15520- c:identifier="adw_preferences_window_set_can_navigate_back"
15521- glib:set-property="can-navigate-back">
15522- <attribute name="org.gtk.Method.set_property"
15523- value="can-navigate-back"/>
28568+ <method name="set_digits"
28569+ c:identifier="adw_spin_row_set_digits"
28570+ glib:set-property="digits"
28571+ version="1.4">
1552428572 <doc xml:space="preserve"
15525- filename="src/adw-preferences-window.c"
15526- line="913">Sets whether gestures and shortcuts for closing subpages are enabled.
15527-
15528-The supported gestures are:
15529-
15530-- One-finger swipe on touchscreens
15531-- Horizontal scrolling on touchpads (usually two-finger swipe)
15532-- Back mouse button
28573+ filename="src/adw-spin-row.c"
28574+ line="734">Sets the number of decimal places to display.</doc>
28575+ <source-position filename="src/adw-spin-row.h" line="55"/>
28576+ <return-value transfer-ownership="none">
28577+ <type name="none" c:type="void"/>
28578+ </return-value>
28579+ <parameters>
28580+ <instance-parameter name="self" transfer-ownership="none">
28581+ <doc xml:space="preserve"
28582+ filename="src/adw-spin-row.c"
28583+ line="736">a spin row</doc>
28584+ <type name="SpinRow" c:type="AdwSpinRow*"/>
28585+ </instance-parameter>
28586+ <parameter name="digits" transfer-ownership="none">
28587+ <doc xml:space="preserve"
28588+ filename="src/adw-spin-row.c"
28589+ line="737">the number of decimal places to display</doc>
28590+ <type name="guint" c:type="guint"/>
28591+ </parameter>
28592+ </parameters>
28593+ </method>
28594+ <method name="set_numeric"
28595+ c:identifier="adw_spin_row_set_numeric"
28596+ glib:set-property="numeric"
28597+ version="1.4">
28598+ <doc xml:space="preserve"
28599+ filename="src/adw-spin-row.c"
28600+ line="775">Sets whether non-numeric characters should be ignored.</doc>
28601+ <source-position filename="src/adw-spin-row.h" line="61"/>
28602+ <return-value transfer-ownership="none">
28603+ <type name="none" c:type="void"/>
28604+ </return-value>
28605+ <parameters>
28606+ <instance-parameter name="self" transfer-ownership="none">
28607+ <doc xml:space="preserve"
28608+ filename="src/adw-spin-row.c"
28609+ line="777">a spin row</doc>
28610+ <type name="SpinRow" c:type="AdwSpinRow*"/>
28611+ </instance-parameter>
28612+ <parameter name="numeric" transfer-ownership="none">
28613+ <doc xml:space="preserve"
28614+ filename="src/adw-spin-row.c"
28615+ line="778">whether non-numeric characters should be ignored</doc>
28616+ <type name="gboolean" c:type="gboolean"/>
28617+ </parameter>
28618+ </parameters>
28619+ </method>
28620+ <method name="set_range"
28621+ c:identifier="adw_spin_row_set_range"
28622+ version="1.4">
28623+ <doc xml:space="preserve"
28624+ filename="src/adw-spin-row.c"
28625+ line="984">Sets the minimum and maximum allowable values for @self.
1553328626
15534-The keyboard back key is also supported, as well as the
15535-&lt;kbd&gt;Alt&lt;/kbd&gt;+&lt;kbd&gt;←&lt;/kbd&gt; shortcut.
28627+If the current value is outside this range, it will be adjusted
28628+to fit within the range, otherwise it will remain unchanged.</doc>
28629+ <source-position filename="src/adw-spin-row.h" line="92"/>
28630+ <return-value transfer-ownership="none">
28631+ <type name="none" c:type="void"/>
28632+ </return-value>
28633+ <parameters>
28634+ <instance-parameter name="self" transfer-ownership="none">
28635+ <doc xml:space="preserve"
28636+ filename="src/adw-spin-row.c"
28637+ line="986">a spin row</doc>
28638+ <type name="SpinRow" c:type="AdwSpinRow*"/>
28639+ </instance-parameter>
28640+ <parameter name="min" transfer-ownership="none">
28641+ <doc xml:space="preserve"
28642+ filename="src/adw-spin-row.c"
28643+ line="987">minimum allowable value</doc>
28644+ <type name="gdouble" c:type="double"/>
28645+ </parameter>
28646+ <parameter name="max" transfer-ownership="none">
28647+ <doc xml:space="preserve"
28648+ filename="src/adw-spin-row.c"
28649+ line="988">maximum allowable value</doc>
28650+ <type name="gdouble" c:type="double"/>
28651+ </parameter>
28652+ </parameters>
28653+ </method>
28654+ <method name="set_snap_to_ticks"
28655+ c:identifier="adw_spin_row_set_snap_to_ticks"
28656+ glib:set-property="snap-to-ticks"
28657+ version="1.4">
28658+ <doc xml:space="preserve"
28659+ filename="src/adw-spin-row.c"
28660+ line="818">Sets whether invalid values are snapped to the nearest step increment.</doc>
28661+ <source-position filename="src/adw-spin-row.h" line="67"/>
28662+ <return-value transfer-ownership="none">
28663+ <type name="none" c:type="void"/>
28664+ </return-value>
28665+ <parameters>
28666+ <instance-parameter name="self" transfer-ownership="none">
28667+ <doc xml:space="preserve"
28668+ filename="src/adw-spin-row.c"
28669+ line="820">a spin row</doc>
28670+ <type name="SpinRow" c:type="AdwSpinRow*"/>
28671+ </instance-parameter>
28672+ <parameter name="snap_to_ticks" transfer-ownership="none">
28673+ <doc xml:space="preserve"
28674+ filename="src/adw-spin-row.c"
28675+ line="821">whether invalid values are snapped to the nearest step increment</doc>
28676+ <type name="gboolean" c:type="gboolean"/>
28677+ </parameter>
28678+ </parameters>
28679+ </method>
28680+ <method name="set_update_policy"
28681+ c:identifier="adw_spin_row_set_update_policy"
28682+ glib:set-property="update-policy"
28683+ version="1.4">
28684+ <doc xml:space="preserve"
28685+ filename="src/adw-spin-row.c"
28686+ line="861">Sets the policy for updating the spin row.
1553628687
15537-For right-to-left locales, gestures and shortcuts are reversed.</doc>
15538- <source-position filename="src/adw-preferences-window.h" line="70"/>
28688+The options are always, or only when the value is invalid.</doc>
28689+ <source-position filename="src/adw-spin-row.h" line="73"/>
1553928690 <return-value transfer-ownership="none">
1554028691 <type name="none" c:type="void"/>
1554128692 </return-value>
1554228693 <parameters>
1554328694 <instance-parameter name="self" transfer-ownership="none">
1554428695 <doc xml:space="preserve"
15545- filename="src/adw-preferences-window.c"
15546- line="915">a preferences window</doc>
15547- <type name="PreferencesWindow" c:type="AdwPreferencesWindow*"/>
28696+ filename="src/adw-spin-row.c"
28697+ line="863">a spin row</doc>
28698+ <type name="SpinRow" c:type="AdwSpinRow*"/>
1554828699 </instance-parameter>
15549- <parameter name="can_navigate_back" transfer-ownership="none">
28700+ <parameter name="policy" transfer-ownership="none">
1555028701 <doc xml:space="preserve"
15551- filename="src/adw-preferences-window.c"
15552- line="916">the new value</doc>
15553- <type name="gboolean" c:type="gboolean"/>
28702+ filename="src/adw-spin-row.c"
28703+ line="864">the policy for updating the spin row</doc>
28704+ <type name="Gtk.SpinButtonUpdatePolicy"
28705+ c:type="GtkSpinButtonUpdatePolicy"/>
1555428706 </parameter>
1555528707 </parameters>
1555628708 </method>
15557- <method name="set_search_enabled"
15558- c:identifier="adw_preferences_window_set_search_enabled"
15559- glib:set-property="search-enabled">
15560- <attribute name="org.gtk.Method.set_property" value="search-enabled"/>
28709+ <method name="set_value"
28710+ c:identifier="adw_spin_row_set_value"
28711+ glib:set-property="value"
28712+ version="1.4">
1556128713 <doc xml:space="preserve"
15562- filename="src/adw-preferences-window.c"
15563- line="879">Sets whether search is enabled for @self.</doc>
15564- <source-position filename="src/adw-preferences-window.h" line="64"/>
28714+ filename="src/adw-spin-row.c"
28715+ line="904">Sets the current value.</doc>
28716+ <source-position filename="src/adw-spin-row.h" line="79"/>
1556528717 <return-value transfer-ownership="none">
1556628718 <type name="none" c:type="void"/>
1556728719 </return-value>
1556828720 <parameters>
1556928721 <instance-parameter name="self" transfer-ownership="none">
1557028722 <doc xml:space="preserve"
15571- filename="src/adw-preferences-window.c"
15572- line="881">a preferences window</doc>
15573- <type name="PreferencesWindow" c:type="AdwPreferencesWindow*"/>
28723+ filename="src/adw-spin-row.c"
28724+ line="906">a spin row</doc>
28725+ <type name="SpinRow" c:type="AdwSpinRow*"/>
1557428726 </instance-parameter>
15575- <parameter name="search_enabled" transfer-ownership="none">
28727+ <parameter name="value" transfer-ownership="none">
1557628728 <doc xml:space="preserve"
15577- filename="src/adw-preferences-window.c"
15578- line="882">whether search is enabled</doc>
15579- <type name="gboolean" c:type="gboolean"/>
28729+ filename="src/adw-spin-row.c"
28730+ line="907">a new value</doc>
28731+ <type name="gdouble" c:type="double"/>
1558028732 </parameter>
1558128733 </parameters>
1558228734 </method>
15583- <method name="set_visible_page"
15584- c:identifier="adw_preferences_window_set_visible_page"
15585- glib:set-property="visible-page">
28735+ <method name="set_wrap"
28736+ c:identifier="adw_spin_row_set_wrap"
28737+ glib:set-property="wrap"
28738+ version="1.4">
1558628739 <doc xml:space="preserve"
15587- filename="src/adw-preferences-window.c"
15588- line="796">Makes @page the visible page of @self.</doc>
15589- <source-position filename="src/adw-preferences-window.h" line="52"/>
28740+ filename="src/adw-spin-row.c"
28741+ line="943">Sets whether the spin row should wrap upon reaching its limits.</doc>
28742+ <source-position filename="src/adw-spin-row.h" line="85"/>
1559028743 <return-value transfer-ownership="none">
1559128744 <type name="none" c:type="void"/>
1559228745 </return-value>
1559328746 <parameters>
1559428747 <instance-parameter name="self" transfer-ownership="none">
1559528748 <doc xml:space="preserve"
15596- filename="src/adw-preferences-window.c"
15597- line="798">a preferences window</doc>
15598- <type name="PreferencesWindow" c:type="AdwPreferencesWindow*"/>
28749+ filename="src/adw-spin-row.c"
28750+ line="945">a spin row</doc>
28751+ <type name="SpinRow" c:type="AdwSpinRow*"/>
1559928752 </instance-parameter>
15600- <parameter name="page" transfer-ownership="none">
28753+ <parameter name="wrap" transfer-ownership="none">
1560128754 <doc xml:space="preserve"
15602- filename="src/adw-preferences-window.c"
15603- line="799">a page of @self</doc>
15604- <type name="PreferencesPage" c:type="AdwPreferencesPage*"/>
28755+ filename="src/adw-spin-row.c"
28756+ line="946">whether the spin row should wrap upon reaching its limits</doc>
28757+ <type name="gboolean" c:type="gboolean"/>
1560528758 </parameter>
1560628759 </parameters>
1560728760 </method>
15608- <method name="set_visible_page_name"
15609- c:identifier="adw_preferences_window_set_visible_page_name"
15610- glib:set-property="visible-page-name">
28761+ <method name="update" c:identifier="adw_spin_row_update" version="1.4">
1561128762 <doc xml:space="preserve"
15612- filename="src/adw-preferences-window.c"
15613- line="837">Makes the page with the given name visible.
15614-
15615-See [property@ViewStack:visible-child].</doc>
15616- <source-position filename="src/adw-preferences-window.h" line="58"/>
28763+ filename="src/adw-spin-row.c"
28764+ line="968">Manually force an update of the spin row.</doc>
28765+ <source-position filename="src/adw-spin-row.h" line="89"/>
1561728766 <return-value transfer-ownership="none">
1561828767 <type name="none" c:type="void"/>
1561928768 </return-value>
1562028769 <parameters>
1562128770 <instance-parameter name="self" transfer-ownership="none">
1562228771 <doc xml:space="preserve"
15623- filename="src/adw-preferences-window.c"
15624- line="839">a preferences window</doc>
15625- <type name="PreferencesWindow" c:type="AdwPreferencesWindow*"/>
28772+ filename="src/adw-spin-row.c"
28773+ line="970">a spin row</doc>
28774+ <type name="SpinRow" c:type="AdwSpinRow*"/>
1562628775 </instance-parameter>
15627- <parameter name="name" transfer-ownership="none">
15628- <doc xml:space="preserve"
15629- filename="src/adw-preferences-window.c"
15630- line="840">the name of the page to make visible</doc>
15631- <type name="utf8" c:type="const char*"/>
15632- </parameter>
1563328776 </parameters>
1563428777 </method>
15635- <property name="can-navigate-back"
28778+ <property name="adjustment"
28779+ version="1.4"
1563628780 writable="1"
1563728781 transfer-ownership="none"
15638- setter="set_can_navigate_back"
15639- getter="get_can_navigate_back"
28782+ setter="set_adjustment"
28783+ getter="get_adjustment">
28784+ <doc xml:space="preserve"
28785+ filename="src/adw-spin-row.c"
28786+ line="269">The adjustment that holds the value of the spin row.</doc>
28787+ <type name="Gtk.Adjustment"/>
28788+ </property>
28789+ <property name="climb-rate"
28790+ version="1.4"
28791+ writable="1"
28792+ transfer-ownership="none"
28793+ setter="set_climb_rate"
28794+ getter="get_climb_rate"
28795+ default-value="0.000000">
28796+ <doc xml:space="preserve"
28797+ filename="src/adw-spin-row.c"
28798+ line="281">The acceleration rate when you hold down a button or key.</doc>
28799+ <type name="gdouble" c:type="gdouble"/>
28800+ </property>
28801+ <property name="digits"
28802+ version="1.4"
28803+ writable="1"
28804+ transfer-ownership="none"
28805+ setter="set_digits"
28806+ getter="get_digits"
28807+ default-value="0">
28808+ <doc xml:space="preserve"
28809+ filename="src/adw-spin-row.c"
28810+ line="293">The number of decimal places to display.</doc>
28811+ <type name="guint" c:type="guint"/>
28812+ </property>
28813+ <property name="numeric"
28814+ version="1.4"
28815+ writable="1"
28816+ transfer-ownership="none"
28817+ setter="set_numeric"
28818+ getter="get_numeric"
1564028819 default-value="FALSE">
15641- <attribute name="org.gtk.Property.get"
15642- value="adw_preferences_window_get_can_navigate_back"/>
15643- <attribute name="org.gtk.Property.set"
15644- value="adw_preferences_window_set_can_navigate_back"/>
1564528820 <doc xml:space="preserve"
15646- filename="src/adw-preferences-window.c"
15647- line="597">Whether gestures and shortcuts for closing subpages are enabled.
15648-
15649-The supported gestures are:
15650-
15651-- One-finger swipe on touchscreens
15652-- Horizontal scrolling on touchpads (usually two-finger swipe)
15653-- Back mouse button
15654-
15655-The keyboard back key is also supported, as well as the
15656-&lt;kbd&gt;Alt&lt;/kbd&gt;+&lt;kbd&gt;←&lt;/kbd&gt; shortcut.
15657-
15658-For right-to-left locales, gestures and shortcuts are reversed.</doc>
28821+ filename="src/adw-spin-row.c"
28822+ line="305">Whether non-numeric characters should be ignored.</doc>
1565928823 <type name="gboolean" c:type="gboolean"/>
1566028824 </property>
15661- <property name="search-enabled"
28825+ <property name="snap-to-ticks"
28826+ version="1.4"
1566228827 writable="1"
1566328828 transfer-ownership="none"
15664- setter="set_search_enabled"
15665- getter="get_search_enabled"
15666- default-value="TRUE">
15667- <attribute name="org.gtk.Property.get"
15668- value="adw_preferences_window_get_search_enabled"/>
15669- <attribute name="org.gtk.Property.set"
15670- value="adw_preferences_window_set_search_enabled"/>
28829+ setter="set_snap_to_ticks"
28830+ getter="get_snap_to_ticks"
28831+ default-value="FALSE">
1567128832 <doc xml:space="preserve"
15672- filename="src/adw-preferences-window.c"
15673- line="587">Whether search is enabled.</doc>
28833+ filename="src/adw-spin-row.c"
28834+ line="317">Whether invalid values are snapped to the nearest step increment.</doc>
1567428835 <type name="gboolean" c:type="gboolean"/>
1567528836 </property>
15676- <property name="visible-page"
28837+ <property name="update-policy"
28838+ version="1.4"
1567728839 writable="1"
1567828840 transfer-ownership="none"
15679- setter="set_visible_page"
15680- getter="get_visible_page">
15681- <type name="Gtk.Widget"/>
28841+ setter="set_update_policy"
28842+ getter="get_update_policy"
28843+ default-value="GTK_UPDATE_ALWAYS">
28844+ <doc xml:space="preserve"
28845+ filename="src/adw-spin-row.c"
28846+ line="329">The policy for updating the spin row.
28847+
28848+The options are always, or only when the value is invalid.</doc>
28849+ <type name="Gtk.SpinButtonUpdatePolicy"/>
1568228850 </property>
15683- <property name="visible-page-name"
28851+ <property name="value"
28852+ version="1.4"
1568428853 writable="1"
1568528854 transfer-ownership="none"
15686- setter="set_visible_page_name"
15687- getter="get_visible_page_name"
15688- default-value="NULL">
15689- <type name="utf8" c:type="gchar*"/>
28855+ setter="set_value"
28856+ getter="get_value"
28857+ default-value="0.000000">
28858+ <doc xml:space="preserve"
28859+ filename="src/adw-spin-row.c"
28860+ line="344">The current value.</doc>
28861+ <type name="gdouble" c:type="gdouble"/>
1569028862 </property>
15691- <field name="parent_instance">
15692- <type name="Window" c:type="AdwWindow"/>
15693- </field>
28863+ <property name="wrap"
28864+ version="1.4"
28865+ writable="1"
28866+ transfer-ownership="none"
28867+ setter="set_wrap"
28868+ getter="get_wrap"
28869+ default-value="FALSE">
28870+ <doc xml:space="preserve"
28871+ filename="src/adw-spin-row.c"
28872+ line="356">Whether the spin row should wrap upon reaching its limits.</doc>
28873+ <type name="gboolean" c:type="gboolean"/>
28874+ </property>
28875+ <glib:signal name="input" when="last" version="1.4">
28876+ <doc xml:space="preserve"
28877+ filename="src/adw-spin-row.c"
28878+ line="372">Emitted to convert the user's input into a double value.
28879+
28880+The signal handler is expected to use [method@Gtk.Editable.get_text] to
28881+retrieve the text of the spinbutton and set new_value to the new value.
28882+
28883+The default conversion uses [func@GLib.strtod].
28884+
28885+See [signal@Gtk.SpinButton::input].</doc>
28886+ <return-value transfer-ownership="none">
28887+ <doc xml:space="preserve"
28888+ filename="src/adw-spin-row.c"
28889+ line="386">`TRUE` for a successful conversion, `FALSE` if the input was not
28890+ handled, and `GTK_INPUT_ERROR` if the conversion failed.</doc>
28891+ <type name="gint" c:type="gint"/>
28892+ </return-value>
28893+ <parameters>
28894+ <parameter name="new_value"
28895+ direction="out"
28896+ caller-allocates="0"
28897+ transfer-ownership="full">
28898+ <doc xml:space="preserve"
28899+ filename="src/adw-spin-row.c"
28900+ line="375">return location for the new value</doc>
28901+ <type name="gdouble" c:type="gpointer"/>
28902+ </parameter>
28903+ </parameters>
28904+ </glib:signal>
28905+ <glib:signal name="output" when="last" version="1.4">
28906+ <doc xml:space="preserve"
28907+ filename="src/adw-spin-row.c"
28908+ line="404">Emitted to tweak the formatting of the value for display.
28909+
28910+See [signal@Gtk.SpinButton::output].</doc>
28911+ <return-value transfer-ownership="none">
28912+ <doc xml:space="preserve"
28913+ filename="src/adw-spin-row.c"
28914+ line="411">`TRUE` if the value has been displayed</doc>
28915+ <type name="gboolean" c:type="gboolean"/>
28916+ </return-value>
28917+ </glib:signal>
28918+ <glib:signal name="wrapped" when="last" version="1.4">
28919+ <doc xml:space="preserve"
28920+ filename="src/adw-spin-row.c"
28921+ line="428">Emitted right after the spinbutton wraps.
28922+
28923+See [signal@Gtk.SpinButton::wrapped].</doc>
28924+ <return-value transfer-ownership="none">
28925+ <type name="none" c:type="void"/>
28926+ </return-value>
28927+ </glib:signal>
1569428928 </class>
15695- <record name="PreferencesWindowClass"
15696- c:type="AdwPreferencesWindowClass"
15697- glib:is-gtype-struct-for="PreferencesWindow">
15698- <source-position filename="src/adw-preferences-window.h" line="37"/>
28929+ <record name="SpinRowClass"
28930+ c:type="AdwSpinRowClass"
28931+ glib:is-gtype-struct-for="SpinRow">
28932+ <source-position filename="src/adw-spin-row.h" line="24"/>
1569928933 <field name="parent_class">
15700- <doc xml:space="preserve"
15701- filename="src/adw-preferences-window.h"
15702- line="29">The parent class</doc>
15703- <type name="WindowClass" c:type="AdwWindowClass"/>
15704- </field>
15705- <field name="padding" readable="0" private="1">
15706- <array zero-terminated="0" fixed-size="4">
15707- <type name="gpointer" c:type="gpointer"/>
15708- </array>
28934+ <type name="ActionRowClass" c:type="AdwActionRowClass"/>
1570928935 </field>
1571028936 </record>
15711- <class name="PropertyAnimationTarget"
15712- c:symbol-prefix="property_animation_target"
15713- c:type="AdwPropertyAnimationTarget"
15714- version="1.2"
15715- parent="AnimationTarget"
28937+ <class name="Spinner"
28938+ c:symbol-prefix="spinner"
28939+ c:type="AdwSpinner"
28940+ version="1.6"
28941+ parent="Gtk.Widget"
1571628942 final="1"
15717- glib:type-name="AdwPropertyAnimationTarget"
15718- glib:get-type="adw_property_animation_target_get_type"
15719- glib:type-struct="PropertyAnimationTargetClass">
28943+ glib:type-name="AdwSpinner"
28944+ glib:get-type="adw_spinner_get_type"
28945+ glib:type-struct="SpinnerClass">
1572028946 <doc xml:space="preserve"
15721- filename="src/adw-animation-target.c"
15722- line="24">An [class@AnimationTarget] changing the value of a property of a
15723-[class@GObject.Object] instance.</doc>
15724- <source-position filename="src/adw-animation-target.h" line="48"/>
15725- <constructor name="new"
15726- c:identifier="adw_property_animation_target_new"
15727- version="1.2">
28947+ filename="src/adw-spinner.c"
28948+ line="17">A widget showing a loading spinner.
28949+
28950+&lt;picture&gt;
28951+ &lt;source srcset="spinner-dark.png" media="(prefers-color-scheme: dark)"&gt;
28952+ &lt;img src="spinner.png" alt="spinner"&gt;
28953+&lt;/picture&gt;
28954+
28955+The size of the spinner depends on the available size, never smaller than
28956+16×16 pixels and never larger than 64×64 pixels.
28957+
28958+Use the [property@Gtk.Widget:halign] and [property@Gtk.Widget:valign]
28959+properties in combination with [property@Gtk.Widget:width-request] and
28960+[property@Gtk.Widget:height-request] for fine sizing control.
28961+
28962+For example, the following snippet shows the spinner at 48×48 pixels:
28963+
28964+```xml
28965+&lt;object class="AdwSpinner"&gt;
28966+ &lt;property name="halign"&gt;center&lt;/property&gt;
28967+ &lt;property name="valign"&gt;center&lt;/property&gt;
28968+ &lt;property name="width-request"&gt;48&lt;/property&gt;
28969+ &lt;property name="height-request"&gt;48&lt;/property&gt;
28970+&lt;/object&gt;
28971+```
28972+
28973+See [class@SpinnerPaintable] for cases where using a widget is impractical or
28974+impossible, such as [property@StatusPage:paintable].
28975+
28976+## CSS nodes
28977+
28978+`AdwSpinner` has a single node with the name `image` and the style class
28979+`.spinner`.</doc>
28980+ <source-position filename="src/adw-spinner.h" line="22"/>
28981+ <implements name="Gtk.Accessible"/>
28982+ <implements name="Gtk.Buildable"/>
28983+ <implements name="Gtk.ConstraintTarget"/>
28984+ <constructor name="new" c:identifier="adw_spinner_new" version="1.6">
1572828985 <doc xml:space="preserve"
15729- filename="src/adw-animation-target.c"
15730- line="348">Creates a new `AdwPropertyAnimationTarget` for the @property_name property on
15731-@object.</doc>
15732- <source-position filename="src/adw-animation-target.h" line="51"/>
15733- <return-value transfer-ownership="full">
28986+ filename="src/adw-spinner.c"
28987+ line="135">Creates a new `AdwSpinner`.</doc>
28988+ <source-position filename="src/adw-spinner.h" line="25"/>
28989+ <return-value transfer-ownership="none">
1573428990 <doc xml:space="preserve"
15735- filename="src/adw-animation-target.c"
15736- line="356">the newly created `AdwPropertyAnimationTarget`</doc>
15737- <type name="AnimationTarget" c:type="AdwAnimationTarget*"/>
28991+ filename="src/adw-spinner.c"
28992+ line="140">the newly created `AdwSpinner`</doc>
28993+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
1573828994 </return-value>
15739- <parameters>
15740- <parameter name="object" transfer-ownership="none">
15741- <doc xml:space="preserve"
15742- filename="src/adw-animation-target.c"
15743- line="350">an object to be animated</doc>
15744- <type name="GObject.Object" c:type="GObject*"/>
15745- </parameter>
15746- <parameter name="property_name" transfer-ownership="none">
15747- <doc xml:space="preserve"
15748- filename="src/adw-animation-target.c"
15749- line="351">the name of the property on @object to animate</doc>
15750- <type name="utf8" c:type="const char*"/>
15751- </parameter>
15752- </parameters>
1575328995 </constructor>
15754- <constructor name="new_for_pspec"
15755- c:identifier="adw_property_animation_target_new_for_pspec"
15756- version="1.2">
28996+ </class>
28997+ <record name="SpinnerClass"
28998+ c:type="AdwSpinnerClass"
28999+ glib:is-gtype-struct-for="Spinner">
29000+ <source-position filename="src/adw-spinner.h" line="22"/>
29001+ <field name="parent_class">
29002+ <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
29003+ </field>
29004+ </record>
29005+ <class name="SpinnerPaintable"
29006+ c:symbol-prefix="spinner_paintable"
29007+ c:type="AdwSpinnerPaintable"
29008+ version="1.6"
29009+ parent="GObject.Object"
29010+ final="1"
29011+ glib:type-name="AdwSpinnerPaintable"
29012+ glib:get-type="adw_spinner_paintable_get_type"
29013+ glib:type-struct="SpinnerPaintableClass">
29014+ <doc xml:space="preserve"
29015+ filename="src/adw-spinner-paintable.c"
29016+ line="37">A paintable showing a loading spinner.
29017+
29018+&lt;picture&gt;
29019+ &lt;source srcset="spinner-dark.png" media="(prefers-color-scheme: dark)"&gt;
29020+ &lt;img src="spinner.png" alt="spinner"&gt;
29021+&lt;/picture&gt;
29022+
29023+`AdwSpinnerPaintable` size varies depending on the available space, but is
29024+capped at 64×64 pixels.
29025+
29026+To be able to animate, `AdwSpinnerPaintable` needs a widget. It will be
29027+animated according to that widget's frame clock, and only if that widget is
29028+mapped. Ideally it should be the same widget the paintable is displayed in,
29029+but that's not a requirement.
29030+
29031+Most applications should be using [class@Spinner] instead.
29032+`AdwSpinnerPaintable` is provided for the cases where using a widget is
29033+impractical or impossible, such as [property@StatusPage:paintable]:
29034+
29035+```xml
29036+&lt;object class="AdwStatusPage" id="status_page"&gt;
29037+ &lt;property name="paintable"&gt;
29038+ &lt;object class="AdwSpinnerPaintable"&gt;
29039+ &lt;property name="widget"&gt;status_page&lt;/property&gt;
29040+ &lt;/object&gt;
29041+ &lt;/property&gt;
29042+ &lt;!-- ... --&gt;
29043+&lt;/object&gt;
29044+```</doc>
29045+ <source-position filename="src/adw-spinner-paintable.h" line="22"/>
29046+ <implements name="Gdk.Paintable"/>
29047+ <implements name="Gtk.SymbolicPaintable"/>
29048+ <constructor name="new"
29049+ c:identifier="adw_spinner_paintable_new"
29050+ version="1.6">
1575729051 <doc xml:space="preserve"
15758- filename="src/adw-animation-target.c"
15759- line="378">Creates a new `AdwPropertyAnimationTarget` for the @pspec property on
15760-@object.</doc>
15761- <source-position filename="src/adw-animation-target.h" line="54"/>
29052+ filename="src/adw-spinner-paintable.c"
29053+ line="419">Creates a new `AdwSpinnerPaintable` for @widget.</doc>
29054+ <source-position filename="src/adw-spinner-paintable.h" line="25"/>
1576229055 <return-value transfer-ownership="full">
1576329056 <doc xml:space="preserve"
15764- filename="src/adw-animation-target.c"
15765- line="386">new newly created `AdwPropertyAnimationTarget`</doc>
15766- <type name="AnimationTarget" c:type="AdwAnimationTarget*"/>
29057+ filename="src/adw-spinner-paintable.c"
29058+ line="425">the newly created `AdwSpinnerPaintable`</doc>
29059+ <type name="SpinnerPaintable" c:type="AdwSpinnerPaintable*"/>
1576729060 </return-value>
1576829061 <parameters>
15769- <parameter name="object" transfer-ownership="none">
15770- <doc xml:space="preserve"
15771- filename="src/adw-animation-target.c"
15772- line="380">an object to be animated</doc>
15773- <type name="GObject.Object" c:type="GObject*"/>
15774- </parameter>
15775- <parameter name="pspec" transfer-ownership="none">
29062+ <parameter name="widget"
29063+ transfer-ownership="none"
29064+ nullable="1"
29065+ allow-none="1">
1577629066 <doc xml:space="preserve"
15777- filename="src/adw-animation-target.c"
15778- line="381">the param spec of the property on @object to animate</doc>
15779- <type name="GObject.ParamSpec" c:type="GParamSpec*"/>
29067+ filename="src/adw-spinner-paintable.c"
29068+ line="421">the widget used for frame clock</doc>
29069+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
1578029070 </parameter>
1578129071 </parameters>
1578229072 </constructor>
15783- <method name="get_object"
15784- c:identifier="adw_property_animation_target_get_object"
15785- glib:get-property="object"
15786- version="1.2">
15787- <attribute name="org.gtk.Method.get_property" value="object"/>
29073+ <method name="get_widget"
29074+ c:identifier="adw_spinner_paintable_get_widget"
29075+ glib:get-property="widget"
29076+ version="1.6">
1578829077 <doc xml:space="preserve"
15789- filename="src/adw-animation-target.c"
15790- line="403">Gets the object animated by @self.
15791-
15792-The `AdwPropertyAnimationTarget` instance does not hold a strong reference on
15793-the object; make sure the object is kept alive throughout the target's
15794-lifetime.</doc>
15795- <source-position filename="src/adw-animation-target.h" line="58"/>
15796- <return-value transfer-ownership="none">
15797- <doc xml:space="preserve"
15798- filename="src/adw-animation-target.c"
15799- line="413">the animated object</doc>
15800- <type name="GObject.Object" c:type="GObject*"/>
29078+ filename="src/adw-spinner-paintable.c"
29079+ line="439">Gets the widget used for frame clock.</doc>
29080+ <source-position filename="src/adw-spinner-paintable.h" line="28"/>
29081+ <return-value transfer-ownership="none" nullable="1">
29082+ <doc xml:space="preserve"
29083+ filename="src/adw-spinner-paintable.c"
29084+ line="445">the widget</doc>
29085+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
1580129086 </return-value>
1580229087 <parameters>
1580329088 <instance-parameter name="self" transfer-ownership="none">
1580429089 <doc xml:space="preserve"
15805- filename="src/adw-animation-target.c"
15806- line="405">a property animation target</doc>
15807- <type name="PropertyAnimationTarget"
15808- c:type="AdwPropertyAnimationTarget*"/>
29090+ filename="src/adw-spinner-paintable.c"
29091+ line="441">a spinner paintable</doc>
29092+ <type name="SpinnerPaintable" c:type="AdwSpinnerPaintable*"/>
1580929093 </instance-parameter>
1581029094 </parameters>
1581129095 </method>
15812- <method name="get_pspec"
15813- c:identifier="adw_property_animation_target_get_pspec"
15814- glib:get-property="pspec"
15815- version="1.2">
15816- <attribute name="org.gtk.Method.get_property" value="pspec"/>
29096+ <method name="set_widget"
29097+ c:identifier="adw_spinner_paintable_set_widget"
29098+ glib:set-property="widget"
29099+ version="1.6">
1581729100 <doc xml:space="preserve"
15818- filename="src/adw-animation-target.c"
15819- line="425">Gets the `GParamSpec` of the property animated by @self.</doc>
15820- <source-position filename="src/adw-animation-target.h" line="60"/>
29101+ filename="src/adw-spinner-paintable.c"
29102+ line="457">Sets the widget used for frame clock.</doc>
29103+ <source-position filename="src/adw-spinner-paintable.h" line="30"/>
1582129104 <return-value transfer-ownership="none">
15822- <doc xml:space="preserve"
15823- filename="src/adw-animation-target.c"
15824- line="431">the animated property's `GParamSpec`</doc>
15825- <type name="GObject.ParamSpec" c:type="GParamSpec*"/>
29105+ <type name="none" c:type="void"/>
1582629106 </return-value>
1582729107 <parameters>
1582829108 <instance-parameter name="self" transfer-ownership="none">
1582929109 <doc xml:space="preserve"
15830- filename="src/adw-animation-target.c"
15831- line="427">a property animation target</doc>
15832- <type name="PropertyAnimationTarget"
15833- c:type="AdwPropertyAnimationTarget*"/>
29110+ filename="src/adw-spinner-paintable.c"
29111+ line="459">a spinner paintable</doc>
29112+ <type name="SpinnerPaintable" c:type="AdwSpinnerPaintable*"/>
1583429113 </instance-parameter>
29114+ <parameter name="widget"
29115+ transfer-ownership="none"
29116+ nullable="1"
29117+ allow-none="1">
29118+ <doc xml:space="preserve"
29119+ filename="src/adw-spinner-paintable.c"
29120+ line="460">the widget to use for frame clock</doc>
29121+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
29122+ </parameter>
1583529123 </parameters>
1583629124 </method>
15837- <property name="object"
15838- version="1.2"
15839- writable="1"
15840- construct-only="1"
15841- transfer-ownership="none"
15842- getter="get_object">
15843- <attribute name="org.gtk.Property.get"
15844- value="adw_property_animation_target_get_object"/>
15845- <doc xml:space="preserve"
15846- filename="src/adw-animation-target.c"
15847- line="310">The object whose property will be animated.
15848-
15849-The `AdwPropertyAnimationTarget` instance does not hold a strong reference
15850-on the object; make sure the object is kept alive throughout the target's
15851-lifetime.</doc>
15852- <type name="GObject.Object"/>
15853- </property>
15854- <property name="pspec"
15855- version="1.2"
29125+ <property name="widget"
29126+ version="1.6"
1585629127 writable="1"
15857- construct-only="1"
1585829128 transfer-ownership="none"
15859- getter="get_pspec">
15860- <attribute name="org.gtk.Property.get"
15861- value="adw_property_animation_target_get_pspec"/>
29129+ setter="set_widget"
29130+ getter="get_widget">
1586229131 <doc xml:space="preserve"
15863- filename="src/adw-animation-target.c"
15864- line="326">The `GParamSpec` of the property to be animated.</doc>
15865- <type name="GObject.ParamSpec"/>
29132+ filename="src/adw-spinner-paintable.c"
29133+ line="265">The widget the spinner uses for frame clock.</doc>
29134+ <type name="Gtk.Widget"/>
1586629135 </property>
1586729136 </class>
15868- <record name="PropertyAnimationTargetClass"
15869- c:type="AdwPropertyAnimationTargetClass"
15870- disguised="1"
15871- opaque="1"
15872- glib:is-gtype-struct-for="PropertyAnimationTarget">
15873- <source-position filename="src/adw-animation-target.h" line="48"/>
29137+ <record name="SpinnerPaintableClass"
29138+ c:type="AdwSpinnerPaintableClass"
29139+ glib:is-gtype-struct-for="SpinnerPaintable">
29140+ <source-position filename="src/adw-spinner-paintable.h" line="22"/>
29141+ <field name="parent_class">
29142+ <type name="GObject.ObjectClass" c:type="GObjectClass"/>
29143+ </field>
1587429144 </record>
15875- <enumeration name="ResponseAppearance"
15876- version="1.2"
15877- glib:type-name="AdwResponseAppearance"
15878- glib:get-type="adw_response_appearance_get_type"
15879- c:type="AdwResponseAppearance">
15880- <doc xml:space="preserve"
15881- filename="src/adw-message-dialog.c"
15882- line="154">Describes the possible styles of [class@MessageDialog] response buttons.
15883-
15884-See [method@MessageDialog.set_response_appearance].</doc>
15885- <member name="default"
15886- value="0"
15887- c:identifier="ADW_RESPONSE_DEFAULT"
15888- glib:nick="default"
15889- glib:name="ADW_RESPONSE_DEFAULT">
15890- <doc xml:space="preserve"
15891- filename="src/adw-message-dialog.c"
15892- line="156">the default appearance.</doc>
15893- </member>
15894- <member name="suggested"
15895- value="1"
15896- c:identifier="ADW_RESPONSE_SUGGESTED"
15897- glib:nick="suggested"
15898- glib:name="ADW_RESPONSE_SUGGESTED">
15899- <doc xml:space="preserve"
15900- filename="src/adw-message-dialog.c"
15901- line="157">used to denote important responses such as the
15902- affirmative action.</doc>
15903- </member>
15904- <member name="destructive"
15905- value="2"
15906- c:identifier="ADW_RESPONSE_DESTRUCTIVE"
15907- glib:nick="destructive"
15908- glib:name="ADW_RESPONSE_DESTRUCTIVE">
15909- <doc xml:space="preserve"
15910- filename="src/adw-message-dialog.c"
15911- line="159">used to draw attention to the potentially damaging
15912- consequences of using the response. This appearance acts as a warning to
15913- the user.</doc>
15914- </member>
15915- </enumeration>
1591629145 <class name="SplitButton"
1591729146 c:symbol-prefix="split_button"
1591829147 c:type="AdwSplitButton"
@@ -15956,6 +29185,17 @@ The main CSS node will contain the `.image-button` or `.text-button` style
1595629185 classes matching the button contents. The nested button nodes will never
1595729186 contain them.
1595829187
29188+## Style classes
29189+
29190+`AdwSplitButton` can use some of the same style classes as [class@Gtk.Button]:
29191+
29192+- [`.suggested-action`](style-classes.html#suggested-action)
29193+- [`.destructive-action`](style-classes.html#destructive-action)
29194+- [`.flat`](style-classes.html#flat)
29195+- [`.raised`](style-classes.html#raised)
29196+
29197+Other style classes, like `.pill`, cannot be used.
29198+
1595929199 ## Accessibility
1596029200
1596129201 `AdwSplitButton` uses the `GTK_ACCESSIBLE_ROLE_GROUP` role.</doc>
@@ -15967,34 +29207,56 @@ contain them.
1596729207 <constructor name="new" c:identifier="adw_split_button_new">
1596829208 <doc xml:space="preserve"
1596929209 filename="src/adw-split-button.c"
15970- line="582">Creates a new `AdwSplitButton`.</doc>
29210+ line="617">Creates a new `AdwSplitButton`.</doc>
1597129211 <source-position filename="src/adw-split-button.h" line="25"/>
1597229212 <return-value transfer-ownership="none">
1597329213 <doc xml:space="preserve"
1597429214 filename="src/adw-split-button.c"
15975- line="587">the newly created `AdwSplitButton`</doc>
29215+ line="622">the newly created `AdwSplitButton`</doc>
1597629216 <type name="Gtk.Widget" c:type="GtkWidget*"/>
1597729217 </return-value>
1597829218 </constructor>
29219+ <method name="get_can_shrink"
29220+ c:identifier="adw_split_button_get_can_shrink"
29221+ glib:get-property="can-shrink"
29222+ version="1.4">
29223+ <doc xml:space="preserve"
29224+ filename="src/adw-split-button.c"
29225+ line="821">gets whether the button can be smaller than the natural size of its contents.</doc>
29226+ <source-position filename="src/adw-split-button.h" line="52"/>
29227+ <return-value transfer-ownership="none">
29228+ <doc xml:space="preserve"
29229+ filename="src/adw-split-button.c"
29230+ line="827">whether the button can shrink</doc>
29231+ <type name="gboolean" c:type="gboolean"/>
29232+ </return-value>
29233+ <parameters>
29234+ <instance-parameter name="self" transfer-ownership="none">
29235+ <doc xml:space="preserve"
29236+ filename="src/adw-split-button.c"
29237+ line="823">a split button</doc>
29238+ <type name="SplitButton" c:type="AdwSplitButton*"/>
29239+ </instance-parameter>
29240+ </parameters>
29241+ </method>
1597929242 <method name="get_child"
1598029243 c:identifier="adw_split_button_get_child"
1598129244 glib:get-property="child">
15982- <attribute name="org.gtk.Method.get_property" value="child"/>
1598329245 <doc xml:space="preserve"
1598429246 filename="src/adw-split-button.c"
15985- line="733">Gets the child widget.</doc>
29247+ line="768">Gets the child widget.</doc>
1598629248 <source-position filename="src/adw-split-button.h" line="46"/>
1598729249 <return-value transfer-ownership="none" nullable="1">
1598829250 <doc xml:space="preserve"
1598929251 filename="src/adw-split-button.c"
15990- line="739">the child widget</doc>
29252+ line="774">the child widget</doc>
1599129253 <type name="Gtk.Widget" c:type="GtkWidget*"/>
1599229254 </return-value>
1599329255 <parameters>
1599429256 <instance-parameter name="self" transfer-ownership="none">
1599529257 <doc xml:space="preserve"
1599629258 filename="src/adw-split-button.c"
15997- line="735">a split button</doc>
29259+ line="770">a split button</doc>
1599829260 <type name="SplitButton" c:type="AdwSplitButton*"/>
1599929261 </instance-parameter>
1600029262 </parameters>
@@ -16002,22 +29264,21 @@ contain them.
1600229264 <method name="get_direction"
1600329265 c:identifier="adw_split_button_get_direction"
1600429266 glib:get-property="direction">
16005- <attribute name="org.gtk.Method.get_property" value="direction"/>
1600629267 <doc xml:space="preserve"
1600729268 filename="src/adw-split-button.c"
16008- line="866">Gets the direction in which the popup will be popped up.</doc>
16009- <source-position filename="src/adw-split-button.h" line="64"/>
29269+ line="953">Gets the direction in which the popup will be popped up.</doc>
29270+ <source-position filename="src/adw-split-button.h" line="70"/>
1601029271 <return-value transfer-ownership="none">
1601129272 <doc xml:space="preserve"
1601229273 filename="src/adw-split-button.c"
16013- line="872">the direction</doc>
29274+ line="959">the direction</doc>
1601429275 <type name="Gtk.ArrowType" c:type="GtkArrowType"/>
1601529276 </return-value>
1601629277 <parameters>
1601729278 <instance-parameter name="self" transfer-ownership="none">
1601829279 <doc xml:space="preserve"
1601929280 filename="src/adw-split-button.c"
16020- line="868">a split button</doc>
29281+ line="955">a split button</doc>
1602129282 <type name="SplitButton" c:type="AdwSplitButton*"/>
1602229283 </instance-parameter>
1602329284 </parameters>
@@ -16026,23 +29287,21 @@ contain them.
1602629287 c:identifier="adw_split_button_get_dropdown_tooltip"
1602729288 glib:get-property="dropdown-tooltip"
1602829289 version="1.2">
16029- <attribute name="org.gtk.Method.get_property"
16030- value="dropdown-tooltip"/>
1603129290 <doc xml:space="preserve"
1603229291 filename="src/adw-split-button.c"
16033- line="910">Gets the tooltip of the dropdown button of @self.</doc>
16034- <source-position filename="src/adw-split-button.h" line="70"/>
29292+ line="997">Gets the tooltip of the dropdown button of @self.</doc>
29293+ <source-position filename="src/adw-split-button.h" line="76"/>
1603529294 <return-value transfer-ownership="none">
1603629295 <doc xml:space="preserve"
1603729296 filename="src/adw-split-button.c"
16038- line="916">the dropdown tooltip of @self</doc>
29297+ line="1003">the dropdown tooltip of @self</doc>
1603929298 <type name="utf8" c:type="const char*"/>
1604029299 </return-value>
1604129300 <parameters>
1604229301 <instance-parameter name="self" transfer-ownership="none">
1604329302 <doc xml:space="preserve"
1604429303 filename="src/adw-split-button.c"
16045- line="912">a split button</doc>
29304+ line="999">a split button</doc>
1604629305 <type name="SplitButton" c:type="AdwSplitButton*"/>
1604729306 </instance-parameter>
1604829307 </parameters>
@@ -16050,22 +29309,21 @@ contain them.
1605029309 <method name="get_icon_name"
1605129310 c:identifier="adw_split_button_get_icon_name"
1605229311 glib:get-property="icon-name">
16053- <attribute name="org.gtk.Method.get_property" value="icon-name"/>
1605429312 <doc xml:space="preserve"
1605529313 filename="src/adw-split-button.c"
16056- line="683">Gets the name of the icon used to automatically populate the button.</doc>
29314+ line="718">Gets the name of the icon used to automatically populate the button.</doc>
1605729315 <source-position filename="src/adw-split-button.h" line="40"/>
1605829316 <return-value transfer-ownership="none" nullable="1">
1605929317 <doc xml:space="preserve"
1606029318 filename="src/adw-split-button.c"
16061- line="689">the icon name</doc>
29319+ line="724">the icon name</doc>
1606229320 <type name="utf8" c:type="const char*"/>
1606329321 </return-value>
1606429322 <parameters>
1606529323 <instance-parameter name="self" transfer-ownership="none">
1606629324 <doc xml:space="preserve"
1606729325 filename="src/adw-split-button.c"
16068- line="685">a split button</doc>
29326+ line="720">a split button</doc>
1606929327 <type name="SplitButton" c:type="AdwSplitButton*"/>
1607029328 </instance-parameter>
1607129329 </parameters>
@@ -16073,22 +29331,21 @@ contain them.
1607329331 <method name="get_label"
1607429332 c:identifier="adw_split_button_get_label"
1607529333 glib:get-property="label">
16076- <attribute name="org.gtk.Method.get_property" value="label"/>
1607729334 <doc xml:space="preserve"
1607829335 filename="src/adw-split-button.c"
16079- line="595">Gets the label for @self.</doc>
29336+ line="630">Gets the label for @self.</doc>
1608029337 <source-position filename="src/adw-split-button.h" line="28"/>
1608129338 <return-value transfer-ownership="none" nullable="1">
1608229339 <doc xml:space="preserve"
1608329340 filename="src/adw-split-button.c"
16084- line="601">the label for @self</doc>
29341+ line="636">the label for @self</doc>
1608529342 <type name="utf8" c:type="const char*"/>
1608629343 </return-value>
1608729344 <parameters>
1608829345 <instance-parameter name="self" transfer-ownership="none">
1608929346 <doc xml:space="preserve"
1609029347 filename="src/adw-split-button.c"
16091- line="597">a split button</doc>
29348+ line="632">a split button</doc>
1609229349 <type name="SplitButton" c:type="AdwSplitButton*"/>
1609329350 </instance-parameter>
1609429351 </parameters>
@@ -16096,22 +29353,21 @@ contain them.
1609629353 <method name="get_menu_model"
1609729354 c:identifier="adw_split_button_get_menu_model"
1609829355 glib:get-property="menu-model">
16099- <attribute name="org.gtk.Method.get_property" value="menu-model"/>
1610029356 <doc xml:space="preserve"
1610129357 filename="src/adw-split-button.c"
16102- line="782">Gets the menu model from which the popup will be created.</doc>
16103- <source-position filename="src/adw-split-button.h" line="52"/>
29358+ line="869">Gets the menu model from which the popup will be created.</doc>
29359+ <source-position filename="src/adw-split-button.h" line="58"/>
1610429360 <return-value transfer-ownership="none" nullable="1">
1610529361 <doc xml:space="preserve"
1610629362 filename="src/adw-split-button.c"
16107- line="788">the menu model</doc>
29363+ line="875">the menu model</doc>
1610829364 <type name="Gio.MenuModel" c:type="GMenuModel*"/>
1610929365 </return-value>
1611029366 <parameters>
1611129367 <instance-parameter name="self" transfer-ownership="none">
1611229368 <doc xml:space="preserve"
1611329369 filename="src/adw-split-button.c"
16114- line="784">a split button</doc>
29370+ line="871">a split button</doc>
1611529371 <type name="SplitButton" c:type="AdwSplitButton*"/>
1611629372 </instance-parameter>
1611729373 </parameters>
@@ -16119,22 +29375,21 @@ contain them.
1611929375 <method name="get_popover"
1612029376 c:identifier="adw_split_button_get_popover"
1612129377 glib:get-property="popover">
16122- <attribute name="org.gtk.Method.get_property" value="popover"/>
1612329378 <doc xml:space="preserve"
1612429379 filename="src/adw-split-button.c"
16125- line="826">Gets the popover that will be popped up when the dropdown is clicked.</doc>
16126- <source-position filename="src/adw-split-button.h" line="58"/>
29380+ line="913">Gets the popover that will be popped up when the dropdown is clicked.</doc>
29381+ <source-position filename="src/adw-split-button.h" line="64"/>
1612729382 <return-value transfer-ownership="none" nullable="1">
1612829383 <doc xml:space="preserve"
1612929384 filename="src/adw-split-button.c"
16130- line="832">the popover</doc>
29385+ line="919">the popover</doc>
1613129386 <type name="Gtk.Popover" c:type="GtkPopover*"/>
1613229387 </return-value>
1613329388 <parameters>
1613429389 <instance-parameter name="self" transfer-ownership="none">
1613529390 <doc xml:space="preserve"
1613629391 filename="src/adw-split-button.c"
16137- line="828">a split button</doc>
29392+ line="915">a split button</doc>
1613829393 <type name="SplitButton" c:type="AdwSplitButton*"/>
1613929394 </instance-parameter>
1614029395 </parameters>
@@ -16142,22 +29397,21 @@ contain them.
1614229397 <method name="get_use_underline"
1614329398 c:identifier="adw_split_button_get_use_underline"
1614429399 glib:get-property="use-underline">
16145- <attribute name="org.gtk.Method.get_property" value="use-underline"/>
1614629400 <doc xml:space="preserve"
1614729401 filename="src/adw-split-button.c"
16148- line="644">Gets whether an underline in the text indicates a mnemonic.</doc>
29402+ line="679">Gets whether an underline in the text indicates a mnemonic.</doc>
1614929403 <source-position filename="src/adw-split-button.h" line="34"/>
1615029404 <return-value transfer-ownership="none">
1615129405 <doc xml:space="preserve"
1615229406 filename="src/adw-split-button.c"
16153- line="650">whether an underline in the text indicates a mnemonic</doc>
29407+ line="685">whether an underline in the text indicates a mnemonic</doc>
1615429408 <type name="gboolean" c:type="gboolean"/>
1615529409 </return-value>
1615629410 <parameters>
1615729411 <instance-parameter name="self" transfer-ownership="none">
1615829412 <doc xml:space="preserve"
1615929413 filename="src/adw-split-button.c"
16160- line="646">a split button</doc>
29414+ line="681">a split button</doc>
1616129415 <type name="SplitButton" c:type="AdwSplitButton*"/>
1616229416 </instance-parameter>
1616329417 </parameters>
@@ -16165,8 +29419,8 @@ contain them.
1616529419 <method name="popdown" c:identifier="adw_split_button_popdown">
1616629420 <doc xml:space="preserve"
1616729421 filename="src/adw-split-button.c"
16168- line="976">Dismisses the menu.</doc>
16169- <source-position filename="src/adw-split-button.h" line="78"/>
29422+ line="1063">Dismisses the menu.</doc>
29423+ <source-position filename="src/adw-split-button.h" line="84"/>
1617029424 <return-value transfer-ownership="none">
1617129425 <type name="none" c:type="void"/>
1617229426 </return-value>
@@ -16174,7 +29428,7 @@ contain them.
1617429428 <instance-parameter name="self" transfer-ownership="none">
1617529429 <doc xml:space="preserve"
1617629430 filename="src/adw-split-button.c"
16177- line="978">a split button</doc>
29431+ line="1065">a split button</doc>
1617829432 <type name="SplitButton" c:type="AdwSplitButton*"/>
1617929433 </instance-parameter>
1618029434 </parameters>
@@ -16182,8 +29436,33 @@ contain them.
1618229436 <method name="popup" c:identifier="adw_split_button_popup">
1618329437 <doc xml:space="preserve"
1618429438 filename="src/adw-split-button.c"
16185- line="962">Pops up the menu.</doc>
16186- <source-position filename="src/adw-split-button.h" line="76"/>
29439+ line="1049">Pops up the menu.</doc>
29440+ <source-position filename="src/adw-split-button.h" line="82"/>
29441+ <return-value transfer-ownership="none">
29442+ <type name="none" c:type="void"/>
29443+ </return-value>
29444+ <parameters>
29445+ <instance-parameter name="self" transfer-ownership="none">
29446+ <doc xml:space="preserve"
29447+ filename="src/adw-split-button.c"
29448+ line="1051">a split button</doc>
29449+ <type name="SplitButton" c:type="AdwSplitButton*"/>
29450+ </instance-parameter>
29451+ </parameters>
29452+ </method>
29453+ <method name="set_can_shrink"
29454+ c:identifier="adw_split_button_set_can_shrink"
29455+ glib:set-property="can-shrink"
29456+ version="1.4">
29457+ <doc xml:space="preserve"
29458+ filename="src/adw-split-button.c"
29459+ line="839">Sets whether the button can be smaller than the natural size of its contents.
29460+
29461+If set to `TRUE`, the label will ellipsize.
29462+
29463+See [method@Gtk.Button.set_can_shrink] and
29464+[method@Gtk.MenuButton.set_can_shrink].</doc>
29465+ <source-position filename="src/adw-split-button.h" line="54"/>
1618729466 <return-value transfer-ownership="none">
1618829467 <type name="none" c:type="void"/>
1618929468 </return-value>
@@ -16191,18 +29470,23 @@ contain them.
1619129470 <instance-parameter name="self" transfer-ownership="none">
1619229471 <doc xml:space="preserve"
1619329472 filename="src/adw-split-button.c"
16194- line="964">a split button</doc>
29473+ line="841">a split button</doc>
1619529474 <type name="SplitButton" c:type="AdwSplitButton*"/>
1619629475 </instance-parameter>
29476+ <parameter name="can_shrink" transfer-ownership="none">
29477+ <doc xml:space="preserve"
29478+ filename="src/adw-split-button.c"
29479+ line="842">whether the button can shrink</doc>
29480+ <type name="gboolean" c:type="gboolean"/>
29481+ </parameter>
1619729482 </parameters>
1619829483 </method>
1619929484 <method name="set_child"
1620029485 c:identifier="adw_split_button_set_child"
1620129486 glib:set-property="child">
16202- <attribute name="org.gtk.Method.set_property" value="child"/>
1620329487 <doc xml:space="preserve"
1620429488 filename="src/adw-split-button.c"
16205- line="749">Sets the child widget.
29489+ line="784">Sets the child widget.
1620629490
1620729491 Setting the child widget will set [property@SplitButton:label] and
1620829492 [property@SplitButton:icon-name] to `NULL`.</doc>
@@ -16214,7 +29498,7 @@ Setting the child widget will set [property@SplitButton:label] and
1621429498 <instance-parameter name="self" transfer-ownership="none">
1621529499 <doc xml:space="preserve"
1621629500 filename="src/adw-split-button.c"
16217- line="751">a split button</doc>
29501+ line="786">a split button</doc>
1621829502 <type name="SplitButton" c:type="AdwSplitButton*"/>
1621929503 </instance-parameter>
1622029504 <parameter name="child"
@@ -16223,7 +29507,7 @@ Setting the child widget will set [property@SplitButton:label] and
1622329507 allow-none="1">
1622429508 <doc xml:space="preserve"
1622529509 filename="src/adw-split-button.c"
16226- line="752">the new child widget</doc>
29510+ line="787">the new child widget</doc>
1622729511 <type name="Gtk.Widget" c:type="GtkWidget*"/>
1622829512 </parameter>
1622929513 </parameters>
@@ -16231,10 +29515,9 @@ Setting the child widget will set [property@SplitButton:label] and
1623129515 <method name="set_direction"
1623229516 c:identifier="adw_split_button_set_direction"
1623329517 glib:set-property="direction">
16234- <attribute name="org.gtk.Method.set_property" value="direction"/>
1623529518 <doc xml:space="preserve"
1623629519 filename="src/adw-split-button.c"
16237- line="882">Sets the direction in which the popup will be popped up.
29520+ line="969">Sets the direction in which the popup will be popped up.
1623829521
1623929522 The dropdown arrow icon will point at the same direction.
1624029523
@@ -16242,7 +29525,7 @@ If the does not fit in the available space in the given direction, GTK will
1624229525 try its best to keep it inside the screen and fully visible.
1624329526
1624429527 If you pass `GTK_ARROW_NONE`, it's equivalent to `GTK_ARROW_DOWN`.</doc>
16245- <source-position filename="src/adw-split-button.h" line="66"/>
29528+ <source-position filename="src/adw-split-button.h" line="72"/>
1624629529 <return-value transfer-ownership="none">
1624729530 <type name="none" c:type="void"/>
1624829531 </return-value>
@@ -16250,13 +29533,13 @@ If you pass `GTK_ARROW_NONE`, it's equivalent to `GTK_ARROW_DOWN`.</doc>
1625029533 <instance-parameter name="self" transfer-ownership="none">
1625129534 <doc xml:space="preserve"
1625229535 filename="src/adw-split-button.c"
16253- line="884">a split button</doc>
29536+ line="971">a split button</doc>
1625429537 <type name="SplitButton" c:type="AdwSplitButton*"/>
1625529538 </instance-parameter>
1625629539 <parameter name="direction" transfer-ownership="none">
1625729540 <doc xml:space="preserve"
1625829541 filename="src/adw-split-button.c"
16259- line="885">the direction</doc>
29542+ line="972">the direction</doc>
1626029543 <type name="Gtk.ArrowType" c:type="GtkArrowType"/>
1626129544 </parameter>
1626229545 </parameters>
@@ -16265,14 +29548,12 @@ If you pass `GTK_ARROW_NONE`, it's equivalent to `GTK_ARROW_DOWN`.</doc>
1626529548 c:identifier="adw_split_button_set_dropdown_tooltip"
1626629549 glib:set-property="dropdown-tooltip"
1626729550 version="1.2">
16268- <attribute name="org.gtk.Method.set_property"
16269- value="dropdown-tooltip"/>
1627029551 <doc xml:space="preserve"
1627129552 filename="src/adw-split-button.c"
16272- line="931">Sets the tooltip of the dropdown button of @self.
29553+ line="1018">Sets the tooltip of the dropdown button of @self.
1627329554
1627429555 The tooltip can be marked up with the Pango text markup language.</doc>
16275- <source-position filename="src/adw-split-button.h" line="72"/>
29556+ <source-position filename="src/adw-split-button.h" line="78"/>
1627629557 <return-value transfer-ownership="none">
1627729558 <type name="none" c:type="void"/>
1627829559 </return-value>
@@ -16280,13 +29561,13 @@ The tooltip can be marked up with the Pango text markup language.</doc>
1628029561 <instance-parameter name="self" transfer-ownership="none">
1628129562 <doc xml:space="preserve"
1628229563 filename="src/adw-split-button.c"
16283- line="933">a split button</doc>
29564+ line="1020">a split button</doc>
1628429565 <type name="SplitButton" c:type="AdwSplitButton*"/>
1628529566 </instance-parameter>
1628629567 <parameter name="tooltip" transfer-ownership="none">
1628729568 <doc xml:space="preserve"
1628829569 filename="src/adw-split-button.c"
16289- line="934">the dropdown tooltip of @self</doc>
29570+ line="1021">the dropdown tooltip of @self</doc>
1629029571 <type name="utf8" c:type="const char*"/>
1629129572 </parameter>
1629229573 </parameters>
@@ -16294,10 +29575,9 @@ The tooltip can be marked up with the Pango text markup language.</doc>
1629429575 <method name="set_icon_name"
1629529576 c:identifier="adw_split_button_set_icon_name"
1629629577 glib:set-property="icon-name">
16297- <attribute name="org.gtk.Method.set_property" value="icon-name"/>
1629829578 <doc xml:space="preserve"
1629929579 filename="src/adw-split-button.c"
16300- line="699">Sets the name of the icon used to automatically populate the button.
29580+ line="734">Sets the name of the icon used to automatically populate the button.
1630129581
1630229582 Setting the icon name will set [property@SplitButton:label] and
1630329583 [property@SplitButton:child] to `NULL`.</doc>
@@ -16309,13 +29589,13 @@ Setting the icon name will set [property@SplitButton:label] and
1630929589 <instance-parameter name="self" transfer-ownership="none">
1631029590 <doc xml:space="preserve"
1631129591 filename="src/adw-split-button.c"
16312- line="701">a split button</doc>
29592+ line="736">a split button</doc>
1631329593 <type name="SplitButton" c:type="AdwSplitButton*"/>
1631429594 </instance-parameter>
1631529595 <parameter name="icon_name" transfer-ownership="none">
1631629596 <doc xml:space="preserve"
1631729597 filename="src/adw-split-button.c"
16318- line="702">the icon name to set</doc>
29598+ line="737">the icon name to set</doc>
1631929599 <type name="utf8" c:type="const char*"/>
1632029600 </parameter>
1632129601 </parameters>
@@ -16323,10 +29603,9 @@ Setting the icon name will set [property@SplitButton:label] and
1632329603 <method name="set_label"
1632429604 c:identifier="adw_split_button_set_label"
1632529605 glib:set-property="label">
16326- <attribute name="org.gtk.Method.set_property" value="label"/>
1632729606 <doc xml:space="preserve"
1632829607 filename="src/adw-split-button.c"
16329- line="611">Sets the label for @self.
29608+ line="646">Sets the label for @self.
1633029609
1633129610 Setting the label will set [property@SplitButton:icon-name] and
1633229611 [property@SplitButton:child] to `NULL`.</doc>
@@ -16338,13 +29617,13 @@ Setting the label will set [property@SplitButton:icon-name] and
1633829617 <instance-parameter name="self" transfer-ownership="none">
1633929618 <doc xml:space="preserve"
1634029619 filename="src/adw-split-button.c"
16341- line="613">a split button</doc>
29620+ line="648">a split button</doc>
1634229621 <type name="SplitButton" c:type="AdwSplitButton*"/>
1634329622 </instance-parameter>
1634429623 <parameter name="label" transfer-ownership="none">
1634529624 <doc xml:space="preserve"
1634629625 filename="src/adw-split-button.c"
16347- line="614">the label to set</doc>
29626+ line="649">the label to set</doc>
1634829627 <type name="utf8" c:type="const char*"/>
1634929628 </parameter>
1635029629 </parameters>
@@ -16352,10 +29631,9 @@ Setting the label will set [property@SplitButton:icon-name] and
1635229631 <method name="set_menu_model"
1635329632 c:identifier="adw_split_button_set_menu_model"
1635429633 glib:set-property="menu-model">
16355- <attribute name="org.gtk.Method.set_property" value="menu-model"/>
1635629634 <doc xml:space="preserve"
1635729635 filename="src/adw-split-button.c"
16358- line="798">Sets the menu model from which the popup will be created.
29636+ line="885">Sets the menu model from which the popup will be created.
1635929637
1636029638 If the menu model is `NULL`, the dropdown is disabled.
1636129639
@@ -16365,7 +29643,7 @@ documented for this function.
1636529643
1636629644 If [property@SplitButton:popover] is already set, it will be dissociated from
1636729645 the button, and the property is set to `NULL`.</doc>
16368- <source-position filename="src/adw-split-button.h" line="54"/>
29646+ <source-position filename="src/adw-split-button.h" line="60"/>
1636929647 <return-value transfer-ownership="none">
1637029648 <type name="none" c:type="void"/>
1637129649 </return-value>
@@ -16373,7 +29651,7 @@ the button, and the property is set to `NULL`.</doc>
1637329651 <instance-parameter name="self" transfer-ownership="none">
1637429652 <doc xml:space="preserve"
1637529653 filename="src/adw-split-button.c"
16376- line="800">a split button</doc>
29654+ line="887">a split button</doc>
1637729655 <type name="SplitButton" c:type="AdwSplitButton*"/>
1637829656 </instance-parameter>
1637929657 <parameter name="menu_model"
@@ -16382,7 +29660,7 @@ the button, and the property is set to `NULL`.</doc>
1638229660 allow-none="1">
1638329661 <doc xml:space="preserve"
1638429662 filename="src/adw-split-button.c"
16385- line="801">the menu model</doc>
29663+ line="888">the menu model</doc>
1638629664 <type name="Gio.MenuModel" c:type="GMenuModel*"/>
1638729665 </parameter>
1638829666 </parameters>
@@ -16390,16 +29668,15 @@ the button, and the property is set to `NULL`.</doc>
1639029668 <method name="set_popover"
1639129669 c:identifier="adw_split_button_set_popover"
1639229670 glib:set-property="popover">
16393- <attribute name="org.gtk.Method.set_property" value="popover"/>
1639429671 <doc xml:space="preserve"
1639529672 filename="src/adw-split-button.c"
16396- line="842">Sets the popover that will be popped up when the dropdown is clicked.
29673+ line="929">Sets the popover that will be popped up when the dropdown is clicked.
1639729674
1639829675 If the popover is `NULL`, the dropdown is disabled.
1639929676
1640029677 If [property@SplitButton:menu-model] is set, the menu model is dissociated
1640129678 from the button, and the property is set to `NULL`.</doc>
16402- <source-position filename="src/adw-split-button.h" line="60"/>
29679+ <source-position filename="src/adw-split-button.h" line="66"/>
1640329680 <return-value transfer-ownership="none">
1640429681 <type name="none" c:type="void"/>
1640529682 </return-value>
@@ -16407,7 +29684,7 @@ from the button, and the property is set to `NULL`.</doc>
1640729684 <instance-parameter name="self" transfer-ownership="none">
1640829685 <doc xml:space="preserve"
1640929686 filename="src/adw-split-button.c"
16410- line="844">a split button</doc>
29687+ line="931">a split button</doc>
1641129688 <type name="SplitButton" c:type="AdwSplitButton*"/>
1641229689 </instance-parameter>
1641329690 <parameter name="popover"
@@ -16416,7 +29693,7 @@ from the button, and the property is set to `NULL`.</doc>
1641629693 allow-none="1">
1641729694 <doc xml:space="preserve"
1641829695 filename="src/adw-split-button.c"
16419- line="845">the popover</doc>
29696+ line="932">the popover</doc>
1642029697 <type name="Gtk.Popover" c:type="GtkPopover*"/>
1642129698 </parameter>
1642229699 </parameters>
@@ -16424,10 +29701,9 @@ from the button, and the property is set to `NULL`.</doc>
1642429701 <method name="set_use_underline"
1642529702 c:identifier="adw_split_button_set_use_underline"
1642629703 glib:set-property="use-underline">
16427- <attribute name="org.gtk.Method.set_property" value="use-underline"/>
1642829704 <doc xml:space="preserve"
1642929705 filename="src/adw-split-button.c"
16430- line="660">Sets whether an underline in the text indicates a mnemonic.
29706+ line="695">Sets whether an underline in the text indicates a mnemonic.
1643129707
1643229708 See [property@SplitButton:label].</doc>
1643329709 <source-position filename="src/adw-split-button.h" line="36"/>
@@ -16438,29 +29714,42 @@ See [property@SplitButton:label].</doc>
1643829714 <instance-parameter name="self" transfer-ownership="none">
1643929715 <doc xml:space="preserve"
1644029716 filename="src/adw-split-button.c"
16441- line="662">a split button</doc>
29717+ line="697">a split button</doc>
1644229718 <type name="SplitButton" c:type="AdwSplitButton*"/>
1644329719 </instance-parameter>
1644429720 <parameter name="use_underline" transfer-ownership="none">
1644529721 <doc xml:space="preserve"
1644629722 filename="src/adw-split-button.c"
16447- line="663">whether an underline in the text indicates a mnemonic</doc>
29723+ line="698">whether an underline in the text indicates a mnemonic</doc>
1644829724 <type name="gboolean" c:type="gboolean"/>
1644929725 </parameter>
1645029726 </parameters>
1645129727 </method>
29728+ <property name="can-shrink"
29729+ version="1.4"
29730+ writable="1"
29731+ transfer-ownership="none"
29732+ setter="set_can_shrink"
29733+ getter="get_can_shrink"
29734+ default-value="FALSE">
29735+ <doc xml:space="preserve"
29736+ filename="src/adw-split-button.c"
29737+ line="353">Whether the button can be smaller than the natural size of its contents.
29738+
29739+If set to `TRUE`, the label will ellipsize.
29740+
29741+See [property@Gtk.Button:can-shrink] and
29742+[property@Gtk.MenuButton:can-shrink].</doc>
29743+ <type name="gboolean" c:type="gboolean"/>
29744+ </property>
1645229745 <property name="child"
1645329746 writable="1"
1645429747 transfer-ownership="none"
1645529748 setter="set_child"
1645629749 getter="get_child">
16457- <attribute name="org.gtk.Property.get"
16458- value="adw_split_button_get_child"/>
16459- <attribute name="org.gtk.Property.set"
16460- value="adw_split_button_set_child"/>
1646129750 <doc xml:space="preserve"
1646229751 filename="src/adw-split-button.c"
16463- line="322">The child widget.
29752+ line="340">The child widget.
1646429753
1646529754 Setting the child widget will set [property@SplitButton:label] and
1646629755 [property@SplitButton:icon-name] to `NULL`.</doc>
@@ -16472,13 +29761,9 @@ Setting the child widget will set [property@SplitButton:label] and
1647229761 setter="set_direction"
1647329762 getter="get_direction"
1647429763 default-value="GTK_ARROW_DOWN">
16475- <attribute name="org.gtk.Property.get"
16476- value="adw_split_button_get_direction"/>
16477- <attribute name="org.gtk.Property.set"
16478- value="adw_split_button_set_direction"/>
1647929764 <doc xml:space="preserve"
1648029765 filename="src/adw-split-button.c"
16481- line="369">The direction in which the popup will be popped up.
29766+ line="404">The direction in which the popup will be popped up.
1648229767
1648329768 The dropdown arrow icon will point at the same direction.
1648429769
@@ -16494,13 +29779,9 @@ If you pass `GTK_ARROW_NONE`, it's equivalent to `GTK_ARROW_DOWN`.</doc>
1649429779 transfer-ownership="none"
1649529780 setter="set_dropdown_tooltip"
1649629781 getter="get_dropdown_tooltip">
16497- <attribute name="org.gtk.Property.get"
16498- value="adw_split_button_get_dropdown_tooltip"/>
16499- <attribute name="org.gtk.Property.set"
16500- value="adw_split_button_set_dropdown_tooltip"/>
1650129782 <doc xml:space="preserve"
1650229783 filename="src/adw-split-button.c"
16503- line="387">The tooltip of the dropdown button.
29784+ line="422">The tooltip of the dropdown button.
1650429785
1650529786 The tooltip can be marked up with the Pango text markup language.</doc>
1650629787 <type name="utf8" c:type="gchar*"/>
@@ -16511,13 +29792,9 @@ The tooltip can be marked up with the Pango text markup language.</doc>
1651129792 setter="set_icon_name"
1651229793 getter="get_icon_name"
1651329794 default-value="NULL">
16514- <attribute name="org.gtk.Property.get"
16515- value="adw_split_button_get_icon_name"/>
16516- <attribute name="org.gtk.Property.set"
16517- value="adw_split_button_set_icon_name"/>
1651829795 <doc xml:space="preserve"
1651929796 filename="src/adw-split-button.c"
16520- line="309">The name of the icon used to automatically populate the button.
29797+ line="327">The name of the icon used to automatically populate the button.
1652129798
1652229799 Setting the icon name will set [property@SplitButton:label] and
1652329800 [property@SplitButton:child] to `NULL`.</doc>
@@ -16529,13 +29806,9 @@ Setting the icon name will set [property@SplitButton:label] and
1652929806 setter="set_label"
1653029807 getter="get_label"
1653129808 default-value="NULL">
16532- <attribute name="org.gtk.Property.get"
16533- value="adw_split_button_get_label"/>
16534- <attribute name="org.gtk.Property.set"
16535- value="adw_split_button_set_label"/>
1653629809 <doc xml:space="preserve"
1653729810 filename="src/adw-split-button.c"
16538- line="284">The label for the button.
29811+ line="302">The label for the button.
1653929812
1654029813 Setting the label will set [property@SplitButton:icon-name] and
1654129814 [property@SplitButton:child] to `NULL`.</doc>
@@ -16546,13 +29819,9 @@ Setting the label will set [property@SplitButton:icon-name] and
1654629819 transfer-ownership="none"
1654729820 setter="set_menu_model"
1654829821 getter="get_menu_model">
16549- <attribute name="org.gtk.Property.get"
16550- value="adw_split_button_get_menu_model"/>
16551- <attribute name="org.gtk.Property.set"
16552- value="adw_split_button_set_menu_model"/>
1655329822 <doc xml:space="preserve"
1655429823 filename="src/adw-split-button.c"
16555- line="335">The `GMenuModel` from which the popup will be created.
29824+ line="370">The `GMenuModel` from which the popup will be created.
1655629825
1655729826 If the menu model is `NULL`, the dropdown is disabled.
1655829827
@@ -16569,13 +29838,9 @@ from the button, and the property is set to `NULL`.</doc>
1656929838 transfer-ownership="none"
1657029839 setter="set_popover"
1657129840 getter="get_popover">
16572- <attribute name="org.gtk.Property.get"
16573- value="adw_split_button_get_popover"/>
16574- <attribute name="org.gtk.Property.set"
16575- value="adw_split_button_set_popover"/>
1657629841 <doc xml:space="preserve"
1657729842 filename="src/adw-split-button.c"
16578- line="354">The `GtkPopover` that will be popped up when the dropdown is clicked.
29843+ line="389">The `GtkPopover` that will be popped up when the dropdown is clicked.
1657929844
1658029845 If the popover is `NULL`, the dropdown is disabled.
1658129846
@@ -16589,13 +29854,9 @@ from the button, and the property is set to `NULL`.</doc>
1658929854 setter="set_use_underline"
1659029855 getter="get_use_underline"
1659129856 default-value="FALSE">
16592- <attribute name="org.gtk.Property.get"
16593- value="adw_split_button_get_use_underline"/>
16594- <attribute name="org.gtk.Property.set"
16595- value="adw_split_button_set_use_underline"/>
1659629857 <doc xml:space="preserve"
1659729858 filename="src/adw-split-button.c"
16598- line="297">Whether an underline in the text indicates a mnemonic.
29859+ line="315">Whether an underline in the text indicates a mnemonic.
1659929860
1660029861 See [property@SplitButton:label].</doc>
1660129862 <type name="gboolean" c:type="gboolean"/>
@@ -16603,7 +29864,7 @@ See [property@SplitButton:label].</doc>
1660329864 <glib:signal name="activate" when="first" action="1">
1660429865 <doc xml:space="preserve"
1660529866 filename="src/adw-split-button.c"
16606- line="423">Emitted to animate press then release.
29867+ line="458">Emitted to animate press then release.
1660729868
1660829869 This is an action signal. Applications should never connect to this signal,
1660929870 but use the [signal@SplitButton::clicked] signal.</doc>
@@ -16614,7 +29875,7 @@ but use the [signal@SplitButton::clicked] signal.</doc>
1661429875 <glib:signal name="clicked" when="first" action="1">
1661529876 <doc xml:space="preserve"
1661629877 filename="src/adw-split-button.c"
16617- line="406">Emitted when the button has been activated (pressed and released).</doc>
29878+ line="441">Emitted when the button has been activated (pressed and released).</doc>
1661829879 <return-value transfer-ownership="none">
1661929880 <type name="none" c:type="void"/>
1662029881 </return-value>
@@ -16786,7 +30047,6 @@ See also [method@SpringAnimation.calculate_value].</doc>
1678630047 <method name="get_clamp"
1678730048 c:identifier="adw_spring_animation_get_clamp"
1678830049 glib:get-property="clamp">
16789- <attribute name="org.gtk.Method.get_property" value="clamp"/>
1679030050 <doc xml:space="preserve"
1679130051 filename="src/adw-spring-animation.c"
1679230052 line="790">Gets whether @self should be clamped.</doc>
@@ -16809,7 +30069,6 @@ See also [method@SpringAnimation.calculate_value].</doc>
1680930069 <method name="get_epsilon"
1681030070 c:identifier="adw_spring_animation_get_epsilon"
1681130071 glib:get-property="epsilon">
16812- <attribute name="org.gtk.Method.get_property" value="epsilon"/>
1681330072 <doc xml:space="preserve"
1681430073 filename="src/adw-spring-animation.c"
1681530074 line="739">Gets the precision of the spring.</doc>
@@ -16832,8 +30091,6 @@ See also [method@SpringAnimation.calculate_value].</doc>
1683230091 <method name="get_estimated_duration"
1683330092 c:identifier="adw_spring_animation_get_estimated_duration"
1683430093 glib:get-property="estimated-duration">
16835- <attribute name="org.gtk.Method.get_property"
16836- value="estimated-duration"/>
1683730094 <doc xml:space="preserve"
1683830095 filename="src/adw-spring-animation.c"
1683930096 line="889">Gets the estimated duration of @self, in milliseconds.
@@ -16858,8 +30115,6 @@ Can be [const@DURATION_INFINITE] if the spring damping is set to 0.</doc>
1685830115 <method name="get_initial_velocity"
1685930116 c:identifier="adw_spring_animation_get_initial_velocity"
1686030117 glib:get-property="initial-velocity">
16861- <attribute name="org.gtk.Method.get_property"
16862- value="initial-velocity"/>
1686330118 <doc xml:space="preserve"
1686430119 filename="src/adw-spring-animation.c"
1686530120 line="698">Gets the initial velocity of @self.</doc>
@@ -16882,7 +30137,6 @@ Can be [const@DURATION_INFINITE] if the spring damping is set to 0.</doc>
1688230137 <method name="get_spring_params"
1688330138 c:identifier="adw_spring_animation_get_spring_params"
1688430139 glib:get-property="spring-params">
16885- <attribute name="org.gtk.Method.get_property" value="spring-params"/>
1688630140 <doc xml:space="preserve"
1688730141 filename="src/adw-spring-animation.c"
1688830142 line="657">Gets the physical parameters of the spring of @self.</doc>
@@ -16905,7 +30159,6 @@ Can be [const@DURATION_INFINITE] if the spring damping is set to 0.</doc>
1690530159 <method name="get_value_from"
1690630160 c:identifier="adw_spring_animation_get_value_from"
1690730161 glib:get-property="value-from">
16908- <attribute name="org.gtk.Method.get_property" value="value-from"/>
1690930162 <doc xml:space="preserve"
1691030163 filename="src/adw-spring-animation.c"
1691130164 line="573">Gets the value @self will animate from.</doc>
@@ -16928,7 +30181,6 @@ Can be [const@DURATION_INFINITE] if the spring damping is set to 0.</doc>
1692830181 <method name="get_value_to"
1692930182 c:identifier="adw_spring_animation_get_value_to"
1693030183 glib:get-property="value-to">
16931- <attribute name="org.gtk.Method.get_property" value="value-to"/>
1693230184 <doc xml:space="preserve"
1693330185 filename="src/adw-spring-animation.c"
1693430186 line="615">Gets the value @self will animate to.</doc>
@@ -16951,7 +30203,6 @@ Can be [const@DURATION_INFINITE] if the spring damping is set to 0.</doc>
1695130203 <method name="get_velocity"
1695230204 c:identifier="adw_spring_animation_get_velocity"
1695330205 glib:get-property="velocity">
16954- <attribute name="org.gtk.Method.get_property" value="velocity"/>
1695530206 <doc xml:space="preserve"
1695630207 filename="src/adw-spring-animation.c"
1695730208 line="907">Gets the current velocity of @self.</doc>
@@ -16974,7 +30225,6 @@ Can be [const@DURATION_INFINITE] if the spring damping is set to 0.</doc>
1697430225 <method name="set_clamp"
1697530226 c:identifier="adw_spring_animation_set_clamp"
1697630227 glib:set-property="clamp">
16977- <attribute name="org.gtk.Method.set_property" value="clamp"/>
1697830228 <doc xml:space="preserve"
1697930229 filename="src/adw-spring-animation.c"
1698030230 line="806">Sets whether @self should be clamped.
@@ -17006,7 +30256,6 @@ relative negative [property@SpringAnimation:initial-velocity] is set.</doc>
1700630256 <method name="set_epsilon"
1700730257 c:identifier="adw_spring_animation_set_epsilon"
1700830258 glib:set-property="epsilon">
17009- <attribute name="org.gtk.Method.set_property" value="epsilon"/>
1701030259 <doc xml:space="preserve"
1701130260 filename="src/adw-spring-animation.c"
1701230261 line="755">Sets the precision of the spring.
@@ -17043,8 +30292,6 @@ The default value is 0.001.</doc>
1704330292 <method name="set_initial_velocity"
1704430293 c:identifier="adw_spring_animation_set_initial_velocity"
1704530294 glib:set-property="initial-velocity">
17046- <attribute name="org.gtk.Method.set_property"
17047- value="initial-velocity"/>
1704830295 <doc xml:space="preserve"
1704930296 filename="src/adw-spring-animation.c"
1705030297 line="714">Sets the initial velocity of @self.
@@ -17072,7 +30319,6 @@ Initial velocity affects only the animation curve, but not its duration.</doc>
1707230319 <method name="set_spring_params"
1707330320 c:identifier="adw_spring_animation_set_spring_params"
1707430321 glib:set-property="spring-params">
17075- <attribute name="org.gtk.Method.set_property" value="spring-params"/>
1707630322 <doc xml:space="preserve"
1707730323 filename="src/adw-spring-animation.c"
1707830324 line="673">Sets the physical parameters of the spring of @self.</doc>
@@ -17098,7 +30344,6 @@ Initial velocity affects only the animation curve, but not its duration.</doc>
1709830344 <method name="set_value_from"
1709930345 c:identifier="adw_spring_animation_set_value_from"
1710030346 glib:set-property="value-from">
17101- <attribute name="org.gtk.Method.set_property" value="value-from"/>
1710230347 <doc xml:space="preserve"
1710330348 filename="src/adw-spring-animation.c"
1710430349 line="589">Sets the value @self will animate from.
@@ -17127,7 +30372,6 @@ The animation will start at this value and end at
1712730372 <method name="set_value_to"
1712830373 c:identifier="adw_spring_animation_set_value_to"
1712930374 glib:set-property="value-to">
17130- <attribute name="org.gtk.Method.set_property" value="value-to"/>
1713130375 <doc xml:space="preserve"
1713230376 filename="src/adw-spring-animation.c"
1713330377 line="631">Sets the value @self will animate to.
@@ -17159,10 +30403,6 @@ this value.</doc>
1715930403 setter="set_clamp"
1716030404 getter="get_clamp"
1716130405 default-value="FALSE">
17162- <attribute name="org.gtk.Property.get"
17163- value="adw_spring_animation_get_clamp"/>
17164- <attribute name="org.gtk.Property.set"
17165- value="adw_spring_animation_set_clamp"/>
1716630406 <doc xml:space="preserve"
1716730407 filename="src/adw-spring-animation.c"
1716830408 line="480">Whether the animation should be clamped.
@@ -17180,10 +30420,6 @@ relative negative [property@SpringAnimation:initial-velocity] is set.</doc>
1718030420 setter="set_epsilon"
1718130421 getter="get_epsilon"
1718230422 default-value="0.001000">
17183- <attribute name="org.gtk.Property.get"
17184- value="adw_spring_animation_get_epsilon"/>
17185- <attribute name="org.gtk.Property.set"
17186- value="adw_spring_animation_set_epsilon"/>
1718730423 <doc xml:space="preserve"
1718830424 filename="src/adw-spring-animation.c"
1718930425 line="457">Precision of the spring.
@@ -17204,8 +30440,6 @@ The default value is 0.001.</doc>
1720430440 transfer-ownership="none"
1720530441 getter="get_estimated_duration"
1720630442 default-value="0">
17207- <attribute name="org.gtk.Property.get"
17208- value="adw_spring_animation_get_estimated_duration"/>
1720930443 <doc xml:space="preserve"
1721030444 filename="src/adw-spring-animation.c"
1721130445 line="496">Estimated duration of the animation, in milliseconds.
@@ -17219,10 +30453,6 @@ Can be [const@DURATION_INFINITE] if the spring damping is set to 0.</doc>
1721930453 setter="set_initial_velocity"
1722030454 getter="get_initial_velocity"
1722130455 default-value="0.000000">
17222- <attribute name="org.gtk.Property.get"
17223- value="adw_spring_animation_get_initial_velocity"/>
17224- <attribute name="org.gtk.Property.set"
17225- value="adw_spring_animation_set_initial_velocity"/>
1722630456 <doc xml:space="preserve"
1722730457 filename="src/adw-spring-animation.c"
1722830458 line="443">The initial velocity to start the animation with.
@@ -17236,10 +30466,6 @@ Initial velocity affects only the animation curve, but not its duration.</doc>
1723630466 transfer-ownership="none"
1723730467 setter="set_spring_params"
1723830468 getter="get_spring_params">
17239- <attribute name="org.gtk.Property.get"
17240- value="adw_spring_animation_get_spring_params"/>
17241- <attribute name="org.gtk.Property.set"
17242- value="adw_spring_animation_set_spring_params"/>
1724330469 <doc xml:space="preserve"
1724430470 filename="src/adw-spring-animation.c"
1724530471 line="433">Physical parameters describing the spring.</doc>
@@ -17252,10 +30478,6 @@ Initial velocity affects only the animation curve, but not its duration.</doc>
1725230478 setter="set_value_from"
1725330479 getter="get_value_from"
1725430480 default-value="0.000000">
17255- <attribute name="org.gtk.Property.get"
17256- value="adw_spring_animation_get_value_from"/>
17257- <attribute name="org.gtk.Property.set"
17258- value="adw_spring_animation_set_value_from"/>
1725930481 <doc xml:space="preserve"
1726030482 filename="src/adw-spring-animation.c"
1726130483 line="403">The value to animate from.
@@ -17271,10 +30493,6 @@ The animation will start at this value and end at
1727130493 setter="set_value_to"
1727230494 getter="get_value_to"
1727330495 default-value="0.000000">
17274- <attribute name="org.gtk.Property.get"
17275- value="adw_spring_animation_get_value_to"/>
17276- <attribute name="org.gtk.Property.set"
17277- value="adw_spring_animation_set_value_to"/>
1727830496 <doc xml:space="preserve"
1727930497 filename="src/adw-spring-animation.c"
1728030498 line="418">The value to animate to.
@@ -17287,8 +30505,6 @@ at this value.</doc>
1728730505 transfer-ownership="none"
1728830506 getter="get_velocity"
1728930507 default-value="0.000000">
17290- <attribute name="org.gtk.Property.get"
17291- value="adw_spring_animation_get_velocity"/>
1729230508 <doc xml:space="preserve"
1729330509 filename="src/adw-spring-animation.c"
1729430510 line="510">Current velocity of the animation.</doc>
@@ -17547,6 +30763,8 @@ If the last reference is dropped, the structure is freed.</doc>
1754730763 <class name="Squeezer"
1754830764 c:symbol-prefix="squeezer"
1754930765 c:type="AdwSqueezer"
30766+ deprecated="1"
30767+ deprecated-version="1.4"
1755030768 parent="Gtk.Widget"
1755130769 final="1"
1755230770 glib:type-name="AdwSqueezer"
@@ -17576,256 +30794,284 @@ with [property@Squeezer:transition-type].
1757630794 ## CSS nodes
1757730795
1757830796 `AdwSqueezer` has a single CSS node with name `squeezer`.</doc>
30797+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1757930798 <source-position filename="src/adw-squeezer.h" line="38"/>
1758030799 <implements name="Gtk.Accessible"/>
1758130800 <implements name="Gtk.Buildable"/>
1758230801 <implements name="Gtk.ConstraintTarget"/>
1758330802 <implements name="Gtk.Orientable"/>
17584- <constructor name="new" c:identifier="adw_squeezer_new">
30803+ <constructor name="new"
30804+ c:identifier="adw_squeezer_new"
30805+ deprecated="1"
30806+ deprecated-version="1.4">
1758530807 <doc xml:space="preserve"
1758630808 filename="src/adw-squeezer.c"
17587- line="1307">Creates a new `AdwSqueezer`.</doc>
30809+ line="1335">Creates a new `AdwSqueezer`.</doc>
30810+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1758830811 <source-position filename="src/adw-squeezer.h" line="46"/>
1758930812 <return-value transfer-ownership="none">
1759030813 <doc xml:space="preserve"
1759130814 filename="src/adw-squeezer.c"
17592- line="1312">the newly created `AdwSqueezer`</doc>
30815+ line="1340">the newly created `AdwSqueezer`</doc>
1759330816 <type name="Gtk.Widget" c:type="GtkWidget*"/>
1759430817 </return-value>
1759530818 </constructor>
17596- <method name="add" c:identifier="adw_squeezer_add">
30819+ <method name="add"
30820+ c:identifier="adw_squeezer_add"
30821+ deprecated="1"
30822+ deprecated-version="1.4">
1759730823 <doc xml:space="preserve"
1759830824 filename="src/adw-squeezer.c"
17599- line="1320">Adds a child to @self.</doc>
30825+ line="1350">Adds a child to @self.</doc>
30826+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1760030827 <source-position filename="src/adw-squeezer.h" line="49"/>
1760130828 <return-value transfer-ownership="none">
1760230829 <doc xml:space="preserve"
1760330830 filename="src/adw-squeezer.c"
17604- line="1327">the [class@SqueezerPage] for @child</doc>
30831+ line="1357">the [class@SqueezerPage] for @child</doc>
1760530832 <type name="SqueezerPage" c:type="AdwSqueezerPage*"/>
1760630833 </return-value>
1760730834 <parameters>
1760830835 <instance-parameter name="self" transfer-ownership="none">
1760930836 <doc xml:space="preserve"
1761030837 filename="src/adw-squeezer.c"
17611- line="1322">a squeezer</doc>
30838+ line="1352">a squeezer</doc>
1761230839 <type name="Squeezer" c:type="AdwSqueezer*"/>
1761330840 </instance-parameter>
1761430841 <parameter name="child" transfer-ownership="none">
1761530842 <doc xml:space="preserve"
1761630843 filename="src/adw-squeezer.c"
17617- line="1323">the widget to add</doc>
30844+ line="1353">the widget to add</doc>
1761830845 <type name="Gtk.Widget" c:type="GtkWidget*"/>
1761930846 </parameter>
1762030847 </parameters>
1762130848 </method>
1762230849 <method name="get_allow_none"
1762330850 c:identifier="adw_squeezer_get_allow_none"
17624- glib:get-property="allow-none">
17625- <attribute name="org.gtk.Method.get_property" value="allow-none"/>
30851+ glib:get-property="allow-none"
30852+ deprecated="1"
30853+ deprecated-version="1.4">
1762630854 <doc xml:space="preserve"
1762730855 filename="src/adw-squeezer.c"
17628- line="1508">Gets whether to allow squeezing beyond the last child's minimum size.</doc>
30856+ line="1556">Gets whether to allow squeezing beyond the last child's minimum size.</doc>
30857+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1762930858 <source-position filename="src/adw-squeezer.h" line="75"/>
1763030859 <return-value transfer-ownership="none">
1763130860 <doc xml:space="preserve"
1763230861 filename="src/adw-squeezer.c"
17633- line="1514">whether @self allows squeezing beyond the last child</doc>
30862+ line="1562">whether @self allows squeezing beyond the last child</doc>
1763430863 <type name="gboolean" c:type="gboolean"/>
1763530864 </return-value>
1763630865 <parameters>
1763730866 <instance-parameter name="self" transfer-ownership="none">
1763830867 <doc xml:space="preserve"
1763930868 filename="src/adw-squeezer.c"
17640- line="1510">a squeezer</doc>
30869+ line="1558">a squeezer</doc>
1764130870 <type name="Squeezer" c:type="AdwSqueezer*"/>
1764230871 </instance-parameter>
1764330872 </parameters>
1764430873 </method>
1764530874 <method name="get_homogeneous"
1764630875 c:identifier="adw_squeezer_get_homogeneous"
17647- glib:get-property="homogeneous">
17648- <attribute name="org.gtk.Method.get_property" value="homogeneous"/>
30876+ glib:get-property="homogeneous"
30877+ deprecated="1"
30878+ deprecated-version="1.4">
1764930879 <doc xml:space="preserve"
1765030880 filename="src/adw-squeezer.c"
17651- line="1414">Gets whether all children have the same size for the opposite orientation.</doc>
30881+ line="1452">Gets whether all children have the same size for the opposite orientation.</doc>
30882+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1765230883 <source-position filename="src/adw-squeezer.h" line="63"/>
1765330884 <return-value transfer-ownership="none">
1765430885 <doc xml:space="preserve"
1765530886 filename="src/adw-squeezer.c"
17656- line="1420">whether @self is homogeneous</doc>
30887+ line="1458">whether @self is homogeneous</doc>
1765730888 <type name="gboolean" c:type="gboolean"/>
1765830889 </return-value>
1765930890 <parameters>
1766030891 <instance-parameter name="self" transfer-ownership="none">
1766130892 <doc xml:space="preserve"
1766230893 filename="src/adw-squeezer.c"
17663- line="1416">a squeezer</doc>
30894+ line="1454">a squeezer</doc>
1766430895 <type name="Squeezer" c:type="AdwSqueezer*"/>
1766530896 </instance-parameter>
1766630897 </parameters>
1766730898 </method>
1766830899 <method name="get_interpolate_size"
1766930900 c:identifier="adw_squeezer_get_interpolate_size"
17670- glib:get-property="interpolate-size">
17671- <attribute name="org.gtk.Method.get_property"
17672- value="interpolate-size"/>
30901+ glib:get-property="interpolate-size"
30902+ deprecated="1"
30903+ deprecated-version="1.4">
1767330904 <doc xml:space="preserve"
1767430905 filename="src/adw-squeezer.c"
17675- line="1646">Gets whether @self interpolates its size when changing the visible child.</doc>
30906+ line="1708">Gets whether @self interpolates its size when changing the visible child.</doc>
30907+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1767630908 <source-position filename="src/adw-squeezer.h" line="96"/>
1767730909 <return-value transfer-ownership="none">
1767830910 <doc xml:space="preserve"
1767930911 filename="src/adw-squeezer.c"
17680- line="1652">whether the size is interpolated</doc>
30912+ line="1714">whether the size is interpolated</doc>
1768130913 <type name="gboolean" c:type="gboolean"/>
1768230914 </return-value>
1768330915 <parameters>
1768430916 <instance-parameter name="self" transfer-ownership="none">
1768530917 <doc xml:space="preserve"
1768630918 filename="src/adw-squeezer.c"
17687- line="1648">A squeezer</doc>
30919+ line="1710">A squeezer</doc>
1768830920 <type name="Squeezer" c:type="AdwSqueezer*"/>
1768930921 </instance-parameter>
1769030922 </parameters>
1769130923 </method>
17692- <method name="get_page" c:identifier="adw_squeezer_get_page">
30924+ <method name="get_page"
30925+ c:identifier="adw_squeezer_get_page"
30926+ deprecated="1"
30927+ deprecated-version="1.4">
1769330928 <doc xml:space="preserve"
1769430929 filename="src/adw-squeezer.c"
17695- line="1379">Returns the [class@SqueezerPage] object for @child.</doc>
30930+ line="1413">Returns the [class@SqueezerPage] object for @child.</doc>
30931+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1769630932 <source-position filename="src/adw-squeezer.h" line="56"/>
1769730933 <return-value transfer-ownership="none">
1769830934 <doc xml:space="preserve"
1769930935 filename="src/adw-squeezer.c"
17700- line="1386">the page object for @child</doc>
30936+ line="1420">the page object for @child</doc>
1770130937 <type name="SqueezerPage" c:type="AdwSqueezerPage*"/>
1770230938 </return-value>
1770330939 <parameters>
1770430940 <instance-parameter name="self" transfer-ownership="none">
1770530941 <doc xml:space="preserve"
1770630942 filename="src/adw-squeezer.c"
17707- line="1381">a squeezer</doc>
30943+ line="1415">a squeezer</doc>
1770830944 <type name="Squeezer" c:type="AdwSqueezer*"/>
1770930945 </instance-parameter>
1771030946 <parameter name="child" transfer-ownership="none">
1771130947 <doc xml:space="preserve"
1771230948 filename="src/adw-squeezer.c"
17713- line="1382">a child of @self</doc>
30949+ line="1416">a child of @self</doc>
1771430950 <type name="Gtk.Widget" c:type="GtkWidget*"/>
1771530951 </parameter>
1771630952 </parameters>
1771730953 </method>
1771830954 <method name="get_pages"
1771930955 c:identifier="adw_squeezer_get_pages"
17720- glib:get-property="pages">
17721- <attribute name="org.gtk.Method.get_property" value="pages"/>
30956+ glib:get-property="pages"
30957+ deprecated="1"
30958+ deprecated-version="1.4">
1772230959 <doc xml:space="preserve"
1772330960 filename="src/adw-squeezer.c"
17724- line="1779">Returns a [iface@Gio.ListModel] that contains the pages of @self.
30961+ line="1853">Returns a [iface@Gio.ListModel] that contains the pages of @self.
1772530962
1772630963 This can be used to keep an up-to-date view. The model also implements
1772730964 [iface@Gtk.SelectionModel] and can be used to track the visible page.</doc>
30965+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1772830966 <source-position filename="src/adw-squeezer.h" line="114"/>
1772930967 <return-value transfer-ownership="full">
1773030968 <doc xml:space="preserve"
1773130969 filename="src/adw-squeezer.c"
17732- line="1788">a `GtkSelectionModel` for the squeezer's children</doc>
30970+ line="1862">a `GtkSelectionModel` for the squeezer's children</doc>
1773330971 <type name="Gtk.SelectionModel" c:type="GtkSelectionModel*"/>
1773430972 </return-value>
1773530973 <parameters>
1773630974 <instance-parameter name="self" transfer-ownership="none">
1773730975 <doc xml:space="preserve"
1773830976 filename="src/adw-squeezer.c"
17739- line="1781">a squeezer</doc>
30977+ line="1855">a squeezer</doc>
1774030978 <type name="Squeezer" c:type="AdwSqueezer*"/>
1774130979 </instance-parameter>
1774230980 </parameters>
1774330981 </method>
1774430982 <method name="get_switch_threshold_policy"
1774530983 c:identifier="adw_squeezer_get_switch_threshold_policy"
17746- glib:get-property="switch-threshold-policy">
17747- <attribute name="org.gtk.Method.get_property"
17748- value="switch-threshold-policy"/>
30984+ glib:get-property="switch-threshold-policy"
30985+ deprecated="1"
30986+ deprecated-version="1.4">
1774930987 <doc xml:space="preserve"
1775030988 filename="src/adw-squeezer.c"
17751- line="1460">Gets the switch threshold policy for @self.</doc>
30989+ line="1502">Gets the switch threshold policy for @self.</doc>
30990+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1775230991 <source-position filename="src/adw-squeezer.h" line="69"/>
1775330992 <return-value transfer-ownership="none">
30993+ <doc xml:space="preserve"
30994+ filename="src/adw-squeezer.c"
30995+ line="1508">the fold threshold policy</doc>
1775430996 <type name="FoldThresholdPolicy" c:type="AdwFoldThresholdPolicy"/>
1775530997 </return-value>
1775630998 <parameters>
1775730999 <instance-parameter name="self" transfer-ownership="none">
1775831000 <doc xml:space="preserve"
1775931001 filename="src/adw-squeezer.c"
17760- line="1462">a squeezer</doc>
31002+ line="1504">a squeezer</doc>
1776131003 <type name="Squeezer" c:type="AdwSqueezer*"/>
1776231004 </instance-parameter>
1776331005 </parameters>
1776431006 </method>
1776531007 <method name="get_transition_duration"
1776631008 c:identifier="adw_squeezer_get_transition_duration"
17767- glib:get-property="transition-duration">
17768- <attribute name="org.gtk.Method.get_property"
17769- value="transition-duration"/>
31009+ glib:get-property="transition-duration"
31010+ deprecated="1"
31011+ deprecated-version="1.4">
1777031012 <doc xml:space="preserve"
1777131013 filename="src/adw-squeezer.c"
17772- line="1553">Gets the transition animation duration for @self.</doc>
31014+ line="1605">Gets the transition animation duration for @self.</doc>
31015+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1777331016 <source-position filename="src/adw-squeezer.h" line="81"/>
1777431017 <return-value transfer-ownership="none">
1777531018 <doc xml:space="preserve"
1777631019 filename="src/adw-squeezer.c"
17777- line="1559">the transition duration, in milliseconds</doc>
31020+ line="1611">the transition duration, in milliseconds</doc>
1777831021 <type name="guint" c:type="guint"/>
1777931022 </return-value>
1778031023 <parameters>
1778131024 <instance-parameter name="self" transfer-ownership="none">
1778231025 <doc xml:space="preserve"
1778331026 filename="src/adw-squeezer.c"
17784- line="1555">a squeezer</doc>
31027+ line="1607">a squeezer</doc>
1778531028 <type name="Squeezer" c:type="AdwSqueezer*"/>
1778631029 </instance-parameter>
1778731030 </parameters>
1778831031 </method>
1778931032 <method name="get_transition_running"
1779031033 c:identifier="adw_squeezer_get_transition_running"
17791- glib:get-property="transition-running">
17792- <attribute name="org.gtk.Method.get_property"
17793- value="transition-running"/>
31034+ glib:get-property="transition-running"
31035+ deprecated="1"
31036+ deprecated-version="1.4">
1779431037 <doc xml:space="preserve"
1779531038 filename="src/adw-squeezer.c"
17796- line="1626">Gets whether a transition is currently running for @self.
31039+ line="1686">Gets whether a transition is currently running for @self.
1779731040
1779831041 If a transition is impossible, the property value will be set to `TRUE` and
1779931042 then immediately to `FALSE`, so it's possible to rely on its notifications
1780031043 to know that a transition has happened.</doc>
31044+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1780131045 <source-position filename="src/adw-squeezer.h" line="93"/>
1780231046 <return-value transfer-ownership="none">
1780331047 <doc xml:space="preserve"
1780431048 filename="src/adw-squeezer.c"
17805- line="1636">whether a transition is currently running</doc>
31049+ line="1696">whether a transition is currently running</doc>
1780631050 <type name="gboolean" c:type="gboolean"/>
1780731051 </return-value>
1780831052 <parameters>
1780931053 <instance-parameter name="self" transfer-ownership="none">
1781031054 <doc xml:space="preserve"
1781131055 filename="src/adw-squeezer.c"
17812- line="1628">a squeezer</doc>
31056+ line="1688">a squeezer</doc>
1781331057 <type name="Squeezer" c:type="AdwSqueezer*"/>
1781431058 </instance-parameter>
1781531059 </parameters>
1781631060 </method>
1781731061 <method name="get_transition_type"
1781831062 c:identifier="adw_squeezer_get_transition_type"
17819- glib:get-property="transition-type">
17820- <attribute name="org.gtk.Method.get_property" value="transition-type"/>
31063+ glib:get-property="transition-type"
31064+ deprecated="1"
31065+ deprecated-version="1.4">
1782131066 <doc xml:space="preserve"
1782231067 filename="src/adw-squeezer.c"
17823- line="1590">Gets the type of animation used for transitions between children in @self.</doc>
31068+ line="1646">Gets the type of animation used for transitions between children in @self.</doc>
31069+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1782431070 <source-position filename="src/adw-squeezer.h" line="87"/>
1782531071 <return-value transfer-ownership="none">
1782631072 <doc xml:space="preserve"
1782731073 filename="src/adw-squeezer.c"
17828- line="1596">the current transition type of @self</doc>
31074+ line="1652">the current transition type of @self</doc>
1782931075 <type name="SqueezerTransitionType"
1783031076 c:type="AdwSqueezerTransitionType"/>
1783131077 </return-value>
@@ -17833,84 +31079,94 @@ to know that a transition has happened.</doc>
1783331079 <instance-parameter name="self" transfer-ownership="none">
1783431080 <doc xml:space="preserve"
1783531081 filename="src/adw-squeezer.c"
17836- line="1592">a squeezer</doc>
31082+ line="1648">a squeezer</doc>
1783731083 <type name="Squeezer" c:type="AdwSqueezer*"/>
1783831084 </instance-parameter>
1783931085 </parameters>
1784031086 </method>
1784131087 <method name="get_visible_child"
1784231088 c:identifier="adw_squeezer_get_visible_child"
17843- glib:get-property="visible-child">
17844- <attribute name="org.gtk.Method.get_property" value="visible-child"/>
31089+ glib:get-property="visible-child"
31090+ deprecated="1"
31091+ deprecated-version="1.4">
1784531092 <doc xml:space="preserve"
1784631093 filename="src/adw-squeezer.c"
17847- line="1398">Gets the currently visible child of @self.</doc>
31094+ line="1434">Gets the currently visible child of @self.</doc>
31095+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1784831096 <source-position filename="src/adw-squeezer.h" line="60"/>
1784931097 <return-value transfer-ownership="none" nullable="1">
1785031098 <doc xml:space="preserve"
1785131099 filename="src/adw-squeezer.c"
17852- line="1404">the visible child</doc>
31100+ line="1440">the visible child</doc>
1785331101 <type name="Gtk.Widget" c:type="GtkWidget*"/>
1785431102 </return-value>
1785531103 <parameters>
1785631104 <instance-parameter name="self" transfer-ownership="none">
1785731105 <doc xml:space="preserve"
1785831106 filename="src/adw-squeezer.c"
17859- line="1400">a squeezer</doc>
31107+ line="1436">a squeezer</doc>
1786031108 <type name="Squeezer" c:type="AdwSqueezer*"/>
1786131109 </instance-parameter>
1786231110 </parameters>
1786331111 </method>
1786431112 <method name="get_xalign"
1786531113 c:identifier="adw_squeezer_get_xalign"
17866- glib:get-property="xalign">
17867- <attribute name="org.gtk.Method.get_property" value="xalign"/>
31114+ glib:get-property="xalign"
31115+ deprecated="1"
31116+ deprecated-version="1.4">
1786831117 <doc xml:space="preserve"
1786931118 filename="src/adw-squeezer.c"
17870- line="1689">Gets the horizontal alignment, from 0 (start) to 1 (end).</doc>
31119+ line="1755">Gets the horizontal alignment, from 0 (start) to 1 (end).</doc>
31120+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1787131121 <source-position filename="src/adw-squeezer.h" line="102"/>
1787231122 <return-value transfer-ownership="none">
1787331123 <doc xml:space="preserve"
1787431124 filename="src/adw-squeezer.c"
17875- line="1695">the alignment value</doc>
31125+ line="1761">the alignment value</doc>
1787631126 <type name="gfloat" c:type="float"/>
1787731127 </return-value>
1787831128 <parameters>
1787931129 <instance-parameter name="self" transfer-ownership="none">
1788031130 <doc xml:space="preserve"
1788131131 filename="src/adw-squeezer.c"
17882- line="1691">a squeezer</doc>
31132+ line="1757">a squeezer</doc>
1788331133 <type name="Squeezer" c:type="AdwSqueezer*"/>
1788431134 </instance-parameter>
1788531135 </parameters>
1788631136 </method>
1788731137 <method name="get_yalign"
1788831138 c:identifier="adw_squeezer_get_yalign"
17889- glib:get-property="yalign">
17890- <attribute name="org.gtk.Method.get_property" value="yalign"/>
31139+ glib:get-property="yalign"
31140+ deprecated="1"
31141+ deprecated-version="1.4">
1789131142 <doc xml:space="preserve"
1789231143 filename="src/adw-squeezer.c"
17893- line="1734">Gets the vertical alignment, from 0 (top) to 1 (bottom).</doc>
31144+ line="1804">Gets the vertical alignment, from 0 (top) to 1 (bottom).</doc>
31145+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1789431146 <source-position filename="src/adw-squeezer.h" line="108"/>
1789531147 <return-value transfer-ownership="none">
1789631148 <doc xml:space="preserve"
1789731149 filename="src/adw-squeezer.c"
17898- line="1740">the alignment value</doc>
31150+ line="1810">the alignment value</doc>
1789931151 <type name="gfloat" c:type="float"/>
1790031152 </return-value>
1790131153 <parameters>
1790231154 <instance-parameter name="self" transfer-ownership="none">
1790331155 <doc xml:space="preserve"
1790431156 filename="src/adw-squeezer.c"
17905- line="1736">a squeezer</doc>
31157+ line="1806">a squeezer</doc>
1790631158 <type name="Squeezer" c:type="AdwSqueezer*"/>
1790731159 </instance-parameter>
1790831160 </parameters>
1790931161 </method>
17910- <method name="remove" c:identifier="adw_squeezer_remove">
31162+ <method name="remove"
31163+ c:identifier="adw_squeezer_remove"
31164+ deprecated="1"
31165+ deprecated-version="1.4">
1791131166 <doc xml:space="preserve"
1791231167 filename="src/adw-squeezer.c"
17913- line="1348">Removes a child widget from @self.</doc>
31168+ line="1380">Removes a child widget from @self.</doc>
31169+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1791431170 <source-position filename="src/adw-squeezer.h" line="52"/>
1791531171 <return-value transfer-ownership="none">
1791631172 <type name="none" c:type="void"/>
@@ -17919,28 +31175,30 @@ to know that a transition has happened.</doc>
1791931175 <instance-parameter name="self" transfer-ownership="none">
1792031176 <doc xml:space="preserve"
1792131177 filename="src/adw-squeezer.c"
17922- line="1350">a squeezer</doc>
31178+ line="1382">a squeezer</doc>
1792331179 <type name="Squeezer" c:type="AdwSqueezer*"/>
1792431180 </instance-parameter>
1792531181 <parameter name="child" transfer-ownership="none">
1792631182 <doc xml:space="preserve"
1792731183 filename="src/adw-squeezer.c"
17928- line="1351">the child to remove</doc>
31184+ line="1383">the child to remove</doc>
1792931185 <type name="Gtk.Widget" c:type="GtkWidget*"/>
1793031186 </parameter>
1793131187 </parameters>
1793231188 </method>
1793331189 <method name="set_allow_none"
1793431190 c:identifier="adw_squeezer_set_allow_none"
17935- glib:set-property="allow-none">
17936- <attribute name="org.gtk.Method.set_property" value="allow-none"/>
31191+ glib:set-property="allow-none"
31192+ deprecated="1"
31193+ deprecated-version="1.4">
1793731194 <doc xml:space="preserve"
1793831195 filename="src/adw-squeezer.c"
17939- line="1524">Sets whether to allow squeezing beyond the last child's minimum size.
31196+ line="1574">Sets whether to allow squeezing beyond the last child's minimum size.
1794031197
1794131198 If set to `TRUE`, the squeezer can shrink to the point where no child can be
1794231199 shown. This is functionally equivalent to appending a widget with 0×0 minimum
1794331200 size.</doc>
31201+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1794431202 <source-position filename="src/adw-squeezer.h" line="77"/>
1794531203 <return-value transfer-ownership="none">
1794631204 <type name="none" c:type="void"/>
@@ -17949,28 +31207,30 @@ size.</doc>
1794931207 <instance-parameter name="self" transfer-ownership="none">
1795031208 <doc xml:space="preserve"
1795131209 filename="src/adw-squeezer.c"
17952- line="1526">a squeezer</doc>
31210+ line="1576">a squeezer</doc>
1795331211 <type name="Squeezer" c:type="AdwSqueezer*"/>
1795431212 </instance-parameter>
1795531213 <parameter name="allow_none" transfer-ownership="none">
1795631214 <doc xml:space="preserve"
1795731215 filename="src/adw-squeezer.c"
17958- line="1527">whether @self allows squeezing beyond the last child</doc>
31216+ line="1577">whether @self allows squeezing beyond the last child</doc>
1795931217 <type name="gboolean" c:type="gboolean"/>
1796031218 </parameter>
1796131219 </parameters>
1796231220 </method>
1796331221 <method name="set_homogeneous"
1796431222 c:identifier="adw_squeezer_set_homogeneous"
17965- glib:set-property="homogeneous">
17966- <attribute name="org.gtk.Method.set_property" value="homogeneous"/>
31223+ glib:set-property="homogeneous"
31224+ deprecated="1"
31225+ deprecated-version="1.4">
1796731226 <doc xml:space="preserve"
1796831227 filename="src/adw-squeezer.c"
17969- line="1430">Sets whether all children have the same size for the opposite orientation.
31228+ line="1470">Sets whether all children have the same size for the opposite orientation.
1797031229
1797131230 For example, if a squeezer is horizontal and is homogeneous, it will request
1797231231 the same height for all its children. If it isn't, the squeezer may change
1797331232 size when a different child becomes visible.</doc>
31233+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1797431234 <source-position filename="src/adw-squeezer.h" line="65"/>
1797531235 <return-value transfer-ownership="none">
1797631236 <type name="none" c:type="void"/>
@@ -17979,30 +31239,31 @@ size when a different child becomes visible.</doc>
1797931239 <instance-parameter name="self" transfer-ownership="none">
1798031240 <doc xml:space="preserve"
1798131241 filename="src/adw-squeezer.c"
17982- line="1432">a squeezer</doc>
31242+ line="1472">a squeezer</doc>
1798331243 <type name="Squeezer" c:type="AdwSqueezer*"/>
1798431244 </instance-parameter>
1798531245 <parameter name="homogeneous" transfer-ownership="none">
1798631246 <doc xml:space="preserve"
1798731247 filename="src/adw-squeezer.c"
17988- line="1433">whether @self is homogeneous</doc>
31248+ line="1473">whether @self is homogeneous</doc>
1798931249 <type name="gboolean" c:type="gboolean"/>
1799031250 </parameter>
1799131251 </parameters>
1799231252 </method>
1799331253 <method name="set_interpolate_size"
1799431254 c:identifier="adw_squeezer_set_interpolate_size"
17995- glib:set-property="interpolate-size">
17996- <attribute name="org.gtk.Method.set_property"
17997- value="interpolate-size"/>
31255+ glib:set-property="interpolate-size"
31256+ deprecated="1"
31257+ deprecated-version="1.4">
1799831258 <doc xml:space="preserve"
1799931259 filename="src/adw-squeezer.c"
18000- line="1662">Sets whether @self interpolates its size when changing the visible child.
31260+ line="1726">Sets whether @self interpolates its size when changing the visible child.
1800131261
1800231262 If `TRUE`, the squeezer will interpolate its size between the one of the
1800331263 previous visible child and the one of the new visible child, according to the
1800431264 set transition duration and the orientation, e.g. if the squeezer is
1800531265 horizontal, it will interpolate the its height.</doc>
31266+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1800631267 <source-position filename="src/adw-squeezer.h" line="98"/>
1800731268 <return-value transfer-ownership="none">
1800831269 <type name="none" c:type="void"/>
@@ -18011,25 +31272,25 @@ horizontal, it will interpolate the its height.</doc>
1801131272 <instance-parameter name="self" transfer-ownership="none">
1801231273 <doc xml:space="preserve"
1801331274 filename="src/adw-squeezer.c"
18014- line="1664">A squeezer</doc>
31275+ line="1728">A squeezer</doc>
1801531276 <type name="Squeezer" c:type="AdwSqueezer*"/>
1801631277 </instance-parameter>
1801731278 <parameter name="interpolate_size" transfer-ownership="none">
1801831279 <doc xml:space="preserve"
1801931280 filename="src/adw-squeezer.c"
18020- line="1665">whether to interpolate the size</doc>
31281+ line="1729">whether to interpolate the size</doc>
1802131282 <type name="gboolean" c:type="gboolean"/>
1802231283 </parameter>
1802331284 </parameters>
1802431285 </method>
1802531286 <method name="set_switch_threshold_policy"
1802631287 c:identifier="adw_squeezer_set_switch_threshold_policy"
18027- glib:set-property="switch-threshold-policy">
18028- <attribute name="org.gtk.Method.set_property"
18029- value="switch-threshold-policy"/>
31288+ glib:set-property="switch-threshold-policy"
31289+ deprecated="1"
31290+ deprecated-version="1.4">
1803031291 <doc xml:space="preserve"
1803131292 filename="src/adw-squeezer.c"
18032- line="1475">Sets the switch threshold policy for @self.
31293+ line="1521">Sets the switch threshold policy for @self.
1803331294
1803431295 Determines when the squeezer will switch children.
1803531296
@@ -18039,6 +31300,7 @@ it will switch as soon as the visible child doesn't get their natural size.
1803931300
1804031301 This can be useful if you have a long ellipsizing label and want to let it
1804131302 ellipsize instead of immediately switching.</doc>
31303+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1804231304 <source-position filename="src/adw-squeezer.h" line="71"/>
1804331305 <return-value transfer-ownership="none">
1804431306 <type name="none" c:type="void"/>
@@ -18047,25 +31309,26 @@ ellipsize instead of immediately switching.</doc>
1804731309 <instance-parameter name="self" transfer-ownership="none">
1804831310 <doc xml:space="preserve"
1804931311 filename="src/adw-squeezer.c"
18050- line="1477">a squeezer</doc>
31312+ line="1523">a squeezer</doc>
1805131313 <type name="Squeezer" c:type="AdwSqueezer*"/>
1805231314 </instance-parameter>
1805331315 <parameter name="policy" transfer-ownership="none">
1805431316 <doc xml:space="preserve"
1805531317 filename="src/adw-squeezer.c"
18056- line="1478">the policy to use</doc>
31318+ line="1524">the policy to use</doc>
1805731319 <type name="FoldThresholdPolicy" c:type="AdwFoldThresholdPolicy"/>
1805831320 </parameter>
1805931321 </parameters>
1806031322 </method>
1806131323 <method name="set_transition_duration"
1806231324 c:identifier="adw_squeezer_set_transition_duration"
18063- glib:set-property="transition-duration">
18064- <attribute name="org.gtk.Method.set_property"
18065- value="transition-duration"/>
31325+ glib:set-property="transition-duration"
31326+ deprecated="1"
31327+ deprecated-version="1.4">
1806631328 <doc xml:space="preserve"
1806731329 filename="src/adw-squeezer.c"
18068- line="1569">Sets the transition animation duration for @self.</doc>
31330+ line="1623">Sets the transition animation duration for @self.</doc>
31331+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1806931332 <source-position filename="src/adw-squeezer.h" line="83"/>
1807031333 <return-value transfer-ownership="none">
1807131334 <type name="none" c:type="void"/>
@@ -18074,24 +31337,26 @@ ellipsize instead of immediately switching.</doc>
1807431337 <instance-parameter name="self" transfer-ownership="none">
1807531338 <doc xml:space="preserve"
1807631339 filename="src/adw-squeezer.c"
18077- line="1571">a squeezer</doc>
31340+ line="1625">a squeezer</doc>
1807831341 <type name="Squeezer" c:type="AdwSqueezer*"/>
1807931342 </instance-parameter>
1808031343 <parameter name="duration" transfer-ownership="none">
1808131344 <doc xml:space="preserve"
1808231345 filename="src/adw-squeezer.c"
18083- line="1572">the new duration, in milliseconds</doc>
31346+ line="1626">the new duration, in milliseconds</doc>
1808431347 <type name="guint" c:type="guint"/>
1808531348 </parameter>
1808631349 </parameters>
1808731350 </method>
1808831351 <method name="set_transition_type"
1808931352 c:identifier="adw_squeezer_set_transition_type"
18090- glib:set-property="transition-type">
18091- <attribute name="org.gtk.Method.set_property" value="transition-type"/>
31353+ glib:set-property="transition-type"
31354+ deprecated="1"
31355+ deprecated-version="1.4">
1809231356 <doc xml:space="preserve"
1809331357 filename="src/adw-squeezer.c"
18094- line="1606">Sets the type of animation used for transitions between children in @self.</doc>
31358+ line="1664">Sets the type of animation used for transitions between children in @self.</doc>
31359+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1809531360 <source-position filename="src/adw-squeezer.h" line="89"/>
1809631361 <return-value transfer-ownership="none">
1809731362 <type name="none" c:type="void"/>
@@ -18100,13 +31365,13 @@ ellipsize instead of immediately switching.</doc>
1810031365 <instance-parameter name="self" transfer-ownership="none">
1810131366 <doc xml:space="preserve"
1810231367 filename="src/adw-squeezer.c"
18103- line="1608">a squeezer</doc>
31368+ line="1666">a squeezer</doc>
1810431369 <type name="Squeezer" c:type="AdwSqueezer*"/>
1810531370 </instance-parameter>
1810631371 <parameter name="transition" transfer-ownership="none">
1810731372 <doc xml:space="preserve"
1810831373 filename="src/adw-squeezer.c"
18109- line="1609">the new transition type</doc>
31374+ line="1667">the new transition type</doc>
1811031375 <type name="SqueezerTransitionType"
1811131376 c:type="AdwSqueezerTransitionType"/>
1811231377 </parameter>
@@ -18114,17 +31379,19 @@ ellipsize instead of immediately switching.</doc>
1811431379 </method>
1811531380 <method name="set_xalign"
1811631381 c:identifier="adw_squeezer_set_xalign"
18117- glib:set-property="xalign">
18118- <attribute name="org.gtk.Method.set_property" value="xalign"/>
31382+ glib:set-property="xalign"
31383+ deprecated="1"
31384+ deprecated-version="1.4">
1811931385 <doc xml:space="preserve"
1812031386 filename="src/adw-squeezer.c"
18121- line="1705">Sets the horizontal alignment, from 0 (start) to 1 (end).
31387+ line="1773">Sets the horizontal alignment, from 0 (start) to 1 (end).
1812231388
1812331389 This affects the children allocation during transitions, when they exceed the
1812431390 size of the squeezer.
1812531391
1812631392 For example, 0.5 means the child will be centered, 0 means it will keep the
1812731393 start side aligned and overflow the end side, and 1 means the opposite.</doc>
31394+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1812831395 <source-position filename="src/adw-squeezer.h" line="104"/>
1812931396 <return-value transfer-ownership="none">
1813031397 <type name="none" c:type="void"/>
@@ -18133,30 +31400,32 @@ start side aligned and overflow the end side, and 1 means the opposite.</doc>
1813331400 <instance-parameter name="self" transfer-ownership="none">
1813431401 <doc xml:space="preserve"
1813531402 filename="src/adw-squeezer.c"
18136- line="1707">a squeezer</doc>
31403+ line="1775">a squeezer</doc>
1813731404 <type name="Squeezer" c:type="AdwSqueezer*"/>
1813831405 </instance-parameter>
1813931406 <parameter name="xalign" transfer-ownership="none">
1814031407 <doc xml:space="preserve"
1814131408 filename="src/adw-squeezer.c"
18142- line="1708">the new alignment value</doc>
31409+ line="1776">the new alignment value</doc>
1814331410 <type name="gfloat" c:type="float"/>
1814431411 </parameter>
1814531412 </parameters>
1814631413 </method>
1814731414 <method name="set_yalign"
1814831415 c:identifier="adw_squeezer_set_yalign"
18149- glib:set-property="yalign">
18150- <attribute name="org.gtk.Method.set_property" value="yalign"/>
31416+ glib:set-property="yalign"
31417+ deprecated="1"
31418+ deprecated-version="1.4">
1815131419 <doc xml:space="preserve"
1815231420 filename="src/adw-squeezer.c"
18153- line="1750">Sets the vertical alignment, from 0 (top) to 1 (bottom).
31421+ line="1822">Sets the vertical alignment, from 0 (top) to 1 (bottom).
1815431422
1815531423 This affects the children allocation during transitions, when they exceed the
1815631424 size of the squeezer.
1815731425
1815831426 For example, 0.5 means the child will be centered, 0 means it will keep the
1815931427 top side aligned and overflow the bottom side, and 1 means the opposite.</doc>
31428+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1816031429 <source-position filename="src/adw-squeezer.h" line="110"/>
1816131430 <return-value transfer-ownership="none">
1816231431 <type name="none" c:type="void"/>
@@ -18165,98 +31434,97 @@ top side aligned and overflow the bottom side, and 1 means the opposite.</doc>
1816531434 <instance-parameter name="self" transfer-ownership="none">
1816631435 <doc xml:space="preserve"
1816731436 filename="src/adw-squeezer.c"
18168- line="1752">a squeezer</doc>
31437+ line="1824">a squeezer</doc>
1816931438 <type name="Squeezer" c:type="AdwSqueezer*"/>
1817031439 </instance-parameter>
1817131440 <parameter name="yalign" transfer-ownership="none">
1817231441 <doc xml:space="preserve"
1817331442 filename="src/adw-squeezer.c"
18174- line="1753">the new alignment value</doc>
31443+ line="1825">the new alignment value</doc>
1817531444 <type name="gfloat" c:type="float"/>
1817631445 </parameter>
1817731446 </parameters>
1817831447 </method>
1817931448 <property name="allow-none"
31449+ deprecated="1"
31450+ deprecated-version="1.4"
1818031451 writable="1"
1818131452 transfer-ownership="none"
1818231453 setter="set_allow_none"
1818331454 getter="get_allow_none"
1818431455 default-value="FALSE">
18185- <attribute name="org.gtk.Property.get"
18186- value="adw_squeezer_get_allow_none"/>
18187- <attribute name="org.gtk.Property.set"
18188- value="adw_squeezer_set_allow_none"/>
1818931456 <doc xml:space="preserve"
1819031457 filename="src/adw-squeezer.c"
18191- line="1076">Whether to allow squeezing beyond the last child's minimum size.
31458+ line="1082">Whether to allow squeezing beyond the last child's minimum size.
1819231459
1819331460 If set to `TRUE`, the squeezer can shrink to the point where no child can
1819431461 be shown. This is functionally equivalent to appending a widget with 0×0
1819531462 minimum size.</doc>
31463+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1819631464 <type name="gboolean" c:type="gboolean"/>
1819731465 </property>
1819831466 <property name="homogeneous"
31467+ deprecated="1"
31468+ deprecated-version="1.4"
1819931469 writable="1"
1820031470 transfer-ownership="none"
1820131471 setter="set_homogeneous"
1820231472 getter="get_homogeneous"
1820331473 default-value="FALSE">
18204- <attribute name="org.gtk.Property.get"
18205- value="adw_squeezer_get_homogeneous"/>
18206- <attribute name="org.gtk.Property.set"
18207- value="adw_squeezer_set_homogeneous"/>
1820831474 <doc xml:space="preserve"
1820931475 filename="src/adw-squeezer.c"
18210- line="1042">Whether all children have the same size for the opposite orientation.
31476+ line="1044">Whether all children have the same size for the opposite orientation.
1821131477
1821231478 For example, if a squeezer is horizontal and is homogeneous, it will
1821331479 request the same height for all its children. If it isn't, the squeezer may
1821431480 change size when a different child becomes visible.</doc>
31481+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1821531482 <type name="gboolean" c:type="gboolean"/>
1821631483 </property>
1821731484 <property name="interpolate-size"
31485+ deprecated="1"
31486+ deprecated-version="1.4"
1821831487 writable="1"
1821931488 transfer-ownership="none"
1822031489 setter="set_interpolate_size"
1822131490 getter="get_interpolate_size"
1822231491 default-value="FALSE">
18223- <attribute name="org.gtk.Property.get"
18224- value="adw_squeezer_get_interpolate_size"/>
18225- <attribute name="org.gtk.Property.set"
18226- value="adw_squeezer_set_interpolate_size"/>
1822731492 <doc xml:space="preserve"
1822831493 filename="src/adw-squeezer.c"
18229- line="1125">Whether the squeezer interpolates its size when changing the visible child.
31494+ line="1139">Whether the squeezer interpolates its size when changing the visible child.
1823031495
1823131496 If `TRUE`, the squeezer will interpolate its size between the one of the
1823231497 previous visible child and the one of the new visible child, according to
1823331498 the set transition duration and the orientation, e.g. if the squeezer is
1823431499 horizontal, it will interpolate the its height.</doc>
31500+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1823531501 <type name="gboolean" c:type="gboolean"/>
1823631502 </property>
18237- <property name="pages" transfer-ownership="none" getter="get_pages">
18238- <attribute name="org.gtk.Property.get" value="adw_squeezer_get_pages"/>
31503+ <property name="pages"
31504+ deprecated="1"
31505+ deprecated-version="1.4"
31506+ transfer-ownership="none"
31507+ getter="get_pages">
1823931508 <doc xml:space="preserve"
1824031509 filename="src/adw-squeezer.c"
18241- line="1174">A selection model with the squeezer's pages.
31510+ line="1194">A selection model with the squeezer's pages.
1824231511
1824331512 This can be used to keep an up-to-date view. The model also implements
1824431513 [iface@Gtk.SelectionModel] and can be used to track the visible page.</doc>
31514+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1824531515 <type name="Gtk.SelectionModel"/>
1824631516 </property>
1824731517 <property name="switch-threshold-policy"
31518+ deprecated="1"
31519+ deprecated-version="1.4"
1824831520 writable="1"
1824931521 transfer-ownership="none"
1825031522 setter="set_switch_threshold_policy"
1825131523 getter="get_switch_threshold_policy"
1825231524 default-value="ADW_FOLD_THRESHOLD_POLICY_NATURAL">
18253- <attribute name="org.gtk.Property.get"
18254- value="adw_squeezer_get_switch_threshold_policy"/>
18255- <attribute name="org.gtk.Property.set"
18256- value="adw_squeezer_set_switch_threshold_policy"/>
1825731525 <doc xml:space="preserve"
1825831526 filename="src/adw-squeezer.c"
18259- line="1056">The switch threshold policy.
31527+ line="1060">The switch threshold policy.
1826031528
1826131529 Determines when the squeezer will switch children.
1826231530
@@ -18266,103 +31534,102 @@ it will switch as soon as the visible child doesn't get their natural size.
1826631534
1826731535 This can be useful if you have a long ellipsizing label and want to let it
1826831536 ellipsize instead of immediately switching.</doc>
31537+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1826931538 <type name="FoldThresholdPolicy"/>
1827031539 </property>
1827131540 <property name="transition-duration"
31541+ deprecated="1"
31542+ deprecated-version="1.4"
1827231543 writable="1"
1827331544 transfer-ownership="none"
1827431545 setter="set_transition_duration"
1827531546 getter="get_transition_duration"
1827631547 default-value="200">
18277- <attribute name="org.gtk.Property.get"
18278- value="adw_squeezer_get_transition_duration"/>
18279- <attribute name="org.gtk.Property.set"
18280- value="adw_squeezer_set_transition_duration"/>
1828131548 <doc xml:space="preserve"
1828231549 filename="src/adw-squeezer.c"
18283- line="1090">The transition animation duration, in milliseconds.</doc>
31550+ line="1098">The transition animation duration, in milliseconds.</doc>
31551+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1828431552 <type name="guint" c:type="guint"/>
1828531553 </property>
1828631554 <property name="transition-running"
31555+ deprecated="1"
31556+ deprecated-version="1.4"
1828731557 transfer-ownership="none"
1828831558 getter="get_transition_running"
1828931559 default-value="FALSE">
18290- <attribute name="org.gtk.Property.get"
18291- value="adw_squeezer_get_transition_running"/>
1829231560 <doc xml:space="preserve"
1829331561 filename="src/adw-squeezer.c"
18294- line="1111">Whether a transition is currently running.
31562+ line="1123">Whether a transition is currently running.
1829531563
1829631564 If a transition is impossible, the property value will be set to `TRUE` and
1829731565 then immediately to `FALSE`, so it's possible to rely on its notifications
1829831566 to know that a transition has happened.</doc>
31567+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1829931568 <type name="gboolean" c:type="gboolean"/>
1830031569 </property>
1830131570 <property name="transition-type"
31571+ deprecated="1"
31572+ deprecated-version="1.4"
1830231573 writable="1"
1830331574 transfer-ownership="none"
1830431575 setter="set_transition_type"
1830531576 getter="get_transition_type"
1830631577 default-value="ADW_SQUEEZER_TRANSITION_TYPE_NONE">
18307- <attribute name="org.gtk.Property.get"
18308- value="adw_squeezer_get_transition_type"/>
18309- <attribute name="org.gtk.Property.set"
18310- value="adw_squeezer_set_transition_type"/>
1831131578 <doc xml:space="preserve"
1831231579 filename="src/adw-squeezer.c"
18313- line="1100">The type of animation used for transitions between children.</doc>
31580+ line="1110">The type of animation used for transitions between children.</doc>
31581+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1831431582 <type name="SqueezerTransitionType"/>
1831531583 </property>
1831631584 <property name="visible-child"
31585+ deprecated="1"
31586+ deprecated-version="1.4"
1831731587 transfer-ownership="none"
1831831588 getter="get_visible_child">
18319- <attribute name="org.gtk.Property.get"
18320- value="adw_squeezer_get_visible_child"/>
1832131589 <doc xml:space="preserve"
1832231590 filename="src/adw-squeezer.c"
1832331591 line="1032">The currently visible child.</doc>
31592+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1832431593 <type name="Gtk.Widget"/>
1832531594 </property>
1832631595 <property name="xalign"
31596+ deprecated="1"
31597+ deprecated-version="1.4"
1832731598 writable="1"
1832831599 transfer-ownership="none"
1832931600 setter="set_xalign"
1833031601 getter="get_xalign"
1833131602 default-value="0.500000">
18332- <attribute name="org.gtk.Property.get"
18333- value="adw_squeezer_get_xalign"/>
18334- <attribute name="org.gtk.Property.set"
18335- value="adw_squeezer_set_xalign"/>
1833631603 <doc xml:space="preserve"
1833731604 filename="src/adw-squeezer.c"
18338- line="1140">The horizontal alignment, from 0 (start) to 1 (end).
31605+ line="1156">The horizontal alignment, from 0 (start) to 1 (end).
1833931606
1834031607 This affects the children allocation during transitions, when they exceed
1834131608 the size of the squeezer.
1834231609
1834331610 For example, 0.5 means the child will be centered, 0 means it will keep the
1834431611 start side aligned and overflow the end side, and 1 means the opposite.</doc>
31612+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1834531613 <type name="gfloat" c:type="gfloat"/>
1834631614 </property>
1834731615 <property name="yalign"
31616+ deprecated="1"
31617+ deprecated-version="1.4"
1834831618 writable="1"
1834931619 transfer-ownership="none"
1835031620 setter="set_yalign"
1835131621 getter="get_yalign"
1835231622 default-value="0.500000">
18353- <attribute name="org.gtk.Property.get"
18354- value="adw_squeezer_get_yalign"/>
18355- <attribute name="org.gtk.Property.set"
18356- value="adw_squeezer_set_yalign"/>
1835731623 <doc xml:space="preserve"
1835831624 filename="src/adw-squeezer.c"
18359- line="1157">The vertical alignment, from 0 (top) to 1 (bottom).
31625+ line="1175">The vertical alignment, from 0 (top) to 1 (bottom).
1836031626
1836131627 This affects the children allocation during transitions, when they exceed
1836231628 the size of the squeezer.
1836331629
1836431630 For example, 0.5 means the child will be centered, 0 means it will keep the
1836531631 top side aligned and overflow the bottom side, and 1 means the opposite.</doc>
31632+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1836631633 <type name="gfloat" c:type="gfloat"/>
1836731634 </property>
1836831635 </class>
@@ -18377,6 +31644,8 @@ top side aligned and overflow the bottom side, and 1 means the opposite.</doc>
1837731644 <class name="SqueezerPage"
1837831645 c:symbol-prefix="squeezer_page"
1837931646 c:type="AdwSqueezerPage"
31647+ deprecated="1"
31648+ deprecated-version="1.4"
1838031649 parent="GObject.Object"
1838131650 final="1"
1838231651 glib:type-name="AdwSqueezerPage"
@@ -18384,61 +31653,67 @@ top side aligned and overflow the bottom side, and 1 means the opposite.</doc>
1838431653 glib:type-struct="SqueezerPageClass">
1838531654 <doc xml:space="preserve"
1838631655 filename="src/adw-squeezer.c"
18387- line="53">An auxiliary class used by [class@Squeezer].</doc>
31656+ line="55">An auxiliary class used by [class@Squeezer].</doc>
31657+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1838831658 <source-position filename="src/adw-squeezer.h" line="24"/>
1838931659 <method name="get_child"
1839031660 c:identifier="adw_squeezer_page_get_child"
18391- glib:get-property="child">
18392- <attribute name="org.gtk.Method.get_property" value="child"/>
31661+ glib:get-property="child"
31662+ deprecated="1"
31663+ deprecated-version="1.4">
1839331664 <doc xml:space="preserve"
1839431665 filename="src/adw-squeezer.c"
18395- line="1236">Returns the squeezer child to which @self belongs.</doc>
31666+ line="1258">Returns the squeezer child to which @self belongs.</doc>
31667+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1839631668 <source-position filename="src/adw-squeezer.h" line="27"/>
1839731669 <return-value transfer-ownership="none">
1839831670 <doc xml:space="preserve"
1839931671 filename="src/adw-squeezer.c"
18400- line="1242">the child to which @self belongs</doc>
31672+ line="1264">the child to which @self belongs</doc>
1840131673 <type name="Gtk.Widget" c:type="GtkWidget*"/>
1840231674 </return-value>
1840331675 <parameters>
1840431676 <instance-parameter name="self" transfer-ownership="none">
1840531677 <doc xml:space="preserve"
1840631678 filename="src/adw-squeezer.c"
18407- line="1238">a squeezer page</doc>
31679+ line="1260">a squeezer page</doc>
1840831680 <type name="SqueezerPage" c:type="AdwSqueezerPage*"/>
1840931681 </instance-parameter>
1841031682 </parameters>
1841131683 </method>
1841231684 <method name="get_enabled"
1841331685 c:identifier="adw_squeezer_page_get_enabled"
18414- glib:get-property="enabled">
18415- <attribute name="org.gtk.Method.get_property" value="enabled"/>
31686+ glib:get-property="enabled"
31687+ deprecated="1"
31688+ deprecated-version="1.4">
1841631689 <doc xml:space="preserve"
1841731690 filename="src/adw-squeezer.c"
18418- line="1252">Gets whether @self is enabled.</doc>
31691+ line="1276">Gets whether @self is enabled.</doc>
31692+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1841931693 <source-position filename="src/adw-squeezer.h" line="30"/>
1842031694 <return-value transfer-ownership="none">
1842131695 <doc xml:space="preserve"
1842231696 filename="src/adw-squeezer.c"
18423- line="1258">whether @self is enabled</doc>
31697+ line="1282">whether @self is enabled</doc>
1842431698 <type name="gboolean" c:type="gboolean"/>
1842531699 </return-value>
1842631700 <parameters>
1842731701 <instance-parameter name="self" transfer-ownership="none">
1842831702 <doc xml:space="preserve"
1842931703 filename="src/adw-squeezer.c"
18430- line="1254">a squeezer page</doc>
31704+ line="1278">a squeezer page</doc>
1843131705 <type name="SqueezerPage" c:type="AdwSqueezerPage*"/>
1843231706 </instance-parameter>
1843331707 </parameters>
1843431708 </method>
1843531709 <method name="set_enabled"
1843631710 c:identifier="adw_squeezer_page_set_enabled"
18437- glib:set-property="enabled">
18438- <attribute name="org.gtk.Method.set_property" value="enabled"/>
31711+ glib:set-property="enabled"
31712+ deprecated="1"
31713+ deprecated-version="1.4">
1843931714 <doc xml:space="preserve"
1844031715 filename="src/adw-squeezer.c"
18441- line="1268">Sets whether @self is enabled.
31716+ line="1294">Sets whether @self is enabled.
1844231717
1844331718 If a child is disabled, it will be ignored when looking for the child
1844431719 fitting the available size best.
@@ -18448,6 +31723,7 @@ in the available space.
1844831723
1844931724 This can be used e.g. to ensure a certain child is hidden below a certain
1845031725 window width, or any other constraint you find suitable.</doc>
31726+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1845131727 <source-position filename="src/adw-squeezer.h" line="32"/>
1845231728 <return-value transfer-ownership="none">
1845331729 <type name="none" c:type="void"/>
@@ -18456,42 +31732,41 @@ window width, or any other constraint you find suitable.</doc>
1845631732 <instance-parameter name="self" transfer-ownership="none">
1845731733 <doc xml:space="preserve"
1845831734 filename="src/adw-squeezer.c"
18459- line="1270">a squeezer page</doc>
31735+ line="1296">a squeezer page</doc>
1846031736 <type name="SqueezerPage" c:type="AdwSqueezerPage*"/>
1846131737 </instance-parameter>
1846231738 <parameter name="enabled" transfer-ownership="none">
1846331739 <doc xml:space="preserve"
1846431740 filename="src/adw-squeezer.c"
18465- line="1271">whether @self is enabled</doc>
31741+ line="1297">whether @self is enabled</doc>
1846631742 <type name="gboolean" c:type="gboolean"/>
1846731743 </parameter>
1846831744 </parameters>
1846931745 </method>
1847031746 <property name="child"
31747+ deprecated="1"
31748+ deprecated-version="1.4"
1847131749 writable="1"
1847231750 construct-only="1"
1847331751 transfer-ownership="none"
1847431752 getter="get_child">
18475- <attribute name="org.gtk.Property.get"
18476- value="adw_squeezer_page_get_child"/>
1847731753 <doc xml:space="preserve"
1847831754 filename="src/adw-squeezer.c"
18479- line="214">The the squeezer child to which the page belongs.</doc>
31755+ line="217">The the squeezer child to which the page belongs.</doc>
31756+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1848031757 <type name="Gtk.Widget"/>
1848131758 </property>
1848231759 <property name="enabled"
31760+ deprecated="1"
31761+ deprecated-version="1.4"
1848331762 writable="1"
1848431763 transfer-ownership="none"
1848531764 setter="set_enabled"
1848631765 getter="get_enabled"
1848731766 default-value="TRUE">
18488- <attribute name="org.gtk.Property.get"
18489- value="adw_squeezer_page_get_enabled"/>
18490- <attribute name="org.gtk.Property.set"
18491- value="adw_squeezer_page_set_enabled"/>
1849231767 <doc xml:space="preserve"
1849331768 filename="src/adw-squeezer.c"
18494- line="224">Whether the child is enabled.
31769+ line="229">Whether the child is enabled.
1849531770
1849631771 If a child is disabled, it will be ignored when looking for the child
1849731772 fitting the available size best.
@@ -18501,6 +31776,7 @@ fits in the available space.
1850131776
1850231777 This can be used e.g. to ensure a certain child is hidden below a certain
1850331778 window width, or any other constraint you find suitable.</doc>
31779+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1850431780 <type name="gboolean" c:type="gboolean"/>
1850531781 </property>
1850631782 </class>
@@ -18513,12 +31789,15 @@ window width, or any other constraint you find suitable.</doc>
1851331789 </field>
1851431790 </record>
1851531791 <enumeration name="SqueezerTransitionType"
31792+ deprecated="1"
31793+ deprecated-version="1.4"
1851631794 glib:type-name="AdwSqueezerTransitionType"
1851731795 glib:get-type="adw_squeezer_transition_type_get_type"
1851831796 c:type="AdwSqueezerTransitionType">
1851931797 <doc xml:space="preserve"
1852031798 filename="src/adw-squeezer.c"
18521- line="59">Describes the possible transitions in a [class@Squeezer] widget.</doc>
31799+ line="63">Describes the possible transitions in a [class@Squeezer] widget.</doc>
31800+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwsqueezer)</doc-deprecated>
1852231801 <member name="none"
1852331802 value="0"
1852431803 c:identifier="ADW_SQUEEZER_TRANSITION_TYPE_NONE"
@@ -18526,7 +31805,7 @@ window width, or any other constraint you find suitable.</doc>
1852631805 glib:name="ADW_SQUEEZER_TRANSITION_TYPE_NONE">
1852731806 <doc xml:space="preserve"
1852831807 filename="src/adw-squeezer.c"
18529- line="61">No transition</doc>
31808+ line="65">No transition</doc>
1853031809 </member>
1853131810 <member name="crossfade"
1853231811 value="1"
@@ -18535,7 +31814,7 @@ window width, or any other constraint you find suitable.</doc>
1853531814 glib:name="ADW_SQUEEZER_TRANSITION_TYPE_CROSSFADE">
1853631815 <doc xml:space="preserve"
1853731816 filename="src/adw-squeezer.c"
18538- line="62">A cross-fade</doc>
31817+ line="66">A cross-fade</doc>
1853931818 </member>
1854031819 </enumeration>
1854131820 <class name="StatusPage"
@@ -18548,7 +31827,7 @@ window width, or any other constraint you find suitable.</doc>
1854831827 glib:type-struct="StatusPageClass">
1854931828 <doc xml:space="preserve"
1855031829 filename="src/adw-status-page.c"
18551- line="13">A page used for empty/error states and similar use-cases.
31830+ line="14">A page used for empty/error states and similar use-cases.
1855231831
1855331832 &lt;picture&gt;
1855431833 &lt;source srcset="status-page-dark.png" media="(prefers-color-scheme: dark)"&gt;
@@ -18562,9 +31841,21 @@ custom widget which is displayed below them.
1856231841
1856331842 `AdwStatusPage` has a main CSS node with name `statuspage`.
1856431843
31844+When setting an [class@SpinnerPaintable] as [property@StatusPage:paintable],
31845+the main nodes gains the `.spinner` style class for a more compact
31846+appearance.
31847+
31848+## Style classes
31849+
1856531850 `AdwStatusPage` can use the
1856631851 [`.compact`](style-classes.html#compact-status-page) style class for when it
18567-needs to fit into a small space such a sidebar or a popover.</doc>
31852+needs to fit into a small space such a sidebar or a popover, similar to when
31853+using a spinner as the paintable.
31854+
31855+&lt;picture&gt;
31856+ &lt;source srcset="status-page-compact-dark.png" media="(prefers-color-scheme: dark)"&gt;
31857+ &lt;img src="status-page-compact.png" alt="status-page-compact"&gt;
31858+&lt;/picture&gt;</doc>
1856831859 <source-position filename="src/adw-status-page.h" line="22"/>
1856931860 <implements name="Gtk.Accessible"/>
1857031861 <implements name="Gtk.Buildable"/>
@@ -18572,34 +31863,33 @@ needs to fit into a small space such a sidebar or a popover.</doc>
1857231863 <constructor name="new" c:identifier="adw_status_page_new">
1857331864 <doc xml:space="preserve"
1857431865 filename="src/adw-status-page.c"
18575- line="292">Creates a new `AdwStatusPage`.</doc>
31866+ line="307">Creates a new `AdwStatusPage`.</doc>
1857631867 <source-position filename="src/adw-status-page.h" line="25"/>
1857731868 <return-value transfer-ownership="none">
1857831869 <doc xml:space="preserve"
1857931870 filename="src/adw-status-page.c"
18580- line="297">the newly created `AdwStatusPage`</doc>
31871+ line="312">the newly created `AdwStatusPage`</doc>
1858131872 <type name="Gtk.Widget" c:type="GtkWidget*"/>
1858231873 </return-value>
1858331874 </constructor>
1858431875 <method name="get_child"
1858531876 c:identifier="adw_status_page_get_child"
1858631877 glib:get-property="child">
18587- <attribute name="org.gtk.Method.get_property" value="child"/>
1858831878 <doc xml:space="preserve"
1858931879 filename="src/adw-status-page.c"
18590- line="481">Gets the child widget of @self.</doc>
31880+ line="501">Gets the child widget of @self.</doc>
1859131881 <source-position filename="src/adw-status-page.h" line="52"/>
1859231882 <return-value transfer-ownership="none" nullable="1">
1859331883 <doc xml:space="preserve"
1859431884 filename="src/adw-status-page.c"
18595- line="487">the child widget of @self</doc>
31885+ line="507">the child widget of @self</doc>
1859631886 <type name="Gtk.Widget" c:type="GtkWidget*"/>
1859731887 </return-value>
1859831888 <parameters>
1859931889 <instance-parameter name="self" transfer-ownership="none">
1860031890 <doc xml:space="preserve"
1860131891 filename="src/adw-status-page.c"
18602- line="483">a status page</doc>
31892+ line="503">a status page</doc>
1860331893 <type name="StatusPage" c:type="AdwStatusPage*"/>
1860431894 </instance-parameter>
1860531895 </parameters>
@@ -18607,22 +31897,21 @@ needs to fit into a small space such a sidebar or a popover.</doc>
1860731897 <method name="get_description"
1860831898 c:identifier="adw_status_page_get_description"
1860931899 glib:get-property="description">
18610- <attribute name="org.gtk.Method.get_property" value="description"/>
1861131900 <doc xml:space="preserve"
1861231901 filename="src/adw-status-page.c"
18613- line="442">Gets the description for @self.</doc>
31902+ line="462">Gets the description markup for @self.</doc>
1861431903 <source-position filename="src/adw-status-page.h" line="46"/>
1861531904 <return-value transfer-ownership="none" nullable="1">
1861631905 <doc xml:space="preserve"
1861731906 filename="src/adw-status-page.c"
18618- line="448">the description</doc>
31907+ line="468">the description</doc>
1861931908 <type name="utf8" c:type="const char*"/>
1862031909 </return-value>
1862131910 <parameters>
1862231911 <instance-parameter name="self" transfer-ownership="none">
1862331912 <doc xml:space="preserve"
1862431913 filename="src/adw-status-page.c"
18625- line="444">a status page</doc>
31914+ line="464">a status page</doc>
1862631915 <type name="StatusPage" c:type="AdwStatusPage*"/>
1862731916 </instance-parameter>
1862831917 </parameters>
@@ -18630,22 +31919,21 @@ needs to fit into a small space such a sidebar or a popover.</doc>
1863031919 <method name="get_icon_name"
1863131920 c:identifier="adw_status_page_get_icon_name"
1863231921 glib:get-property="icon-name">
18633- <attribute name="org.gtk.Method.get_property" value="icon-name"/>
1863431922 <doc xml:space="preserve"
1863531923 filename="src/adw-status-page.c"
18636- line="305">Gets the icon name for @self.</doc>
31924+ line="320">Gets the icon name for @self.</doc>
1863731925 <source-position filename="src/adw-status-page.h" line="28"/>
1863831926 <return-value transfer-ownership="none" nullable="1">
1863931927 <doc xml:space="preserve"
1864031928 filename="src/adw-status-page.c"
18641- line="311">the icon name</doc>
31929+ line="326">the icon name</doc>
1864231930 <type name="utf8" c:type="const char*"/>
1864331931 </return-value>
1864431932 <parameters>
1864531933 <instance-parameter name="self" transfer-ownership="none">
1864631934 <doc xml:space="preserve"
1864731935 filename="src/adw-status-page.c"
18648- line="307">a status page</doc>
31936+ line="322">a status page</doc>
1864931937 <type name="StatusPage" c:type="AdwStatusPage*"/>
1865031938 </instance-parameter>
1865131939 </parameters>
@@ -18653,22 +31941,21 @@ needs to fit into a small space such a sidebar or a popover.</doc>
1865331941 <method name="get_paintable"
1865431942 c:identifier="adw_status_page_get_paintable"
1865531943 glib:get-property="paintable">
18656- <attribute name="org.gtk.Method.get_property" value="paintable"/>
1865731944 <doc xml:space="preserve"
1865831945 filename="src/adw-status-page.c"
18659- line="354">Gets the paintable for @self.</doc>
31946+ line="368">Gets the paintable for @self.</doc>
1866031947 <source-position filename="src/adw-status-page.h" line="34"/>
1866131948 <return-value transfer-ownership="none" nullable="1">
1866231949 <doc xml:space="preserve"
1866331950 filename="src/adw-status-page.c"
18664- line="360">the paintable</doc>
31951+ line="374">the paintable</doc>
1866531952 <type name="Gdk.Paintable" c:type="GdkPaintable*"/>
1866631953 </return-value>
1866731954 <parameters>
1866831955 <instance-parameter name="self" transfer-ownership="none">
1866931956 <doc xml:space="preserve"
1867031957 filename="src/adw-status-page.c"
18671- line="356">a status page</doc>
31958+ line="370">a status page</doc>
1867231959 <type name="StatusPage" c:type="AdwStatusPage*"/>
1867331960 </instance-parameter>
1867431961 </parameters>
@@ -18676,22 +31963,21 @@ needs to fit into a small space such a sidebar or a popover.</doc>
1867631963 <method name="get_title"
1867731964 c:identifier="adw_status_page_get_title"
1867831965 glib:get-property="title">
18679- <attribute name="org.gtk.Method.get_property" value="title"/>
1868031966 <doc xml:space="preserve"
1868131967 filename="src/adw-status-page.c"
18682- line="403">Gets the title for @self.</doc>
31968+ line="423">Gets the title for @self.</doc>
1868331969 <source-position filename="src/adw-status-page.h" line="40"/>
1868431970 <return-value transfer-ownership="none">
1868531971 <doc xml:space="preserve"
1868631972 filename="src/adw-status-page.c"
18687- line="409">the title</doc>
31973+ line="429">the title</doc>
1868831974 <type name="utf8" c:type="const char*"/>
1868931975 </return-value>
1869031976 <parameters>
1869131977 <instance-parameter name="self" transfer-ownership="none">
1869231978 <doc xml:space="preserve"
1869331979 filename="src/adw-status-page.c"
18694- line="405">a status page</doc>
31980+ line="425">a status page</doc>
1869531981 <type name="StatusPage" c:type="AdwStatusPage*"/>
1869631982 </instance-parameter>
1869731983 </parameters>
@@ -18699,10 +31985,9 @@ needs to fit into a small space such a sidebar or a popover.</doc>
1869931985 <method name="set_child"
1870031986 c:identifier="adw_status_page_set_child"
1870131987 glib:set-property="child">
18702- <attribute name="org.gtk.Method.set_property" value="child"/>
1870331988 <doc xml:space="preserve"
1870431989 filename="src/adw-status-page.c"
18705- line="497">Sets the child widget of @self.</doc>
31990+ line="517">Sets the child widget of @self.</doc>
1870631991 <source-position filename="src/adw-status-page.h" line="54"/>
1870731992 <return-value transfer-ownership="none">
1870831993 <type name="none" c:type="void"/>
@@ -18711,7 +31996,7 @@ needs to fit into a small space such a sidebar or a popover.</doc>
1871131996 <instance-parameter name="self" transfer-ownership="none">
1871231997 <doc xml:space="preserve"
1871331998 filename="src/adw-status-page.c"
18714- line="499">a status page</doc>
31999+ line="519">a status page</doc>
1871532000 <type name="StatusPage" c:type="AdwStatusPage*"/>
1871632001 </instance-parameter>
1871732002 <parameter name="child"
@@ -18720,7 +32005,7 @@ needs to fit into a small space such a sidebar or a popover.</doc>
1872032005 allow-none="1">
1872132006 <doc xml:space="preserve"
1872232007 filename="src/adw-status-page.c"
18723- line="500">the child widget</doc>
32008+ line="520">the child widget</doc>
1872432009 <type name="Gtk.Widget" c:type="GtkWidget*"/>
1872532010 </parameter>
1872632011 </parameters>
@@ -18728,12 +32013,11 @@ needs to fit into a small space such a sidebar or a popover.</doc>
1872832013 <method name="set_description"
1872932014 c:identifier="adw_status_page_set_description"
1873032015 glib:set-property="description">
18731- <attribute name="org.gtk.Method.set_property" value="description"/>
1873232016 <doc xml:space="preserve"
1873332017 filename="src/adw-status-page.c"
18734- line="458">Sets the description for @self.
32018+ line="478">Sets the description markup for @self.
1873532019
18736-The description is displayed below the title.</doc>
32020+The description is displayed below the title. It is parsed as Pango markup.</doc>
1873732021 <source-position filename="src/adw-status-page.h" line="48"/>
1873832022 <return-value transfer-ownership="none">
1873932023 <type name="none" c:type="void"/>
@@ -18742,7 +32026,7 @@ The description is displayed below the title.</doc>
1874232026 <instance-parameter name="self" transfer-ownership="none">
1874332027 <doc xml:space="preserve"
1874432028 filename="src/adw-status-page.c"
18745- line="460">a status page</doc>
32029+ line="480">a status page</doc>
1874632030 <type name="StatusPage" c:type="AdwStatusPage*"/>
1874732031 </instance-parameter>
1874832032 <parameter name="description"
@@ -18751,7 +32035,7 @@ The description is displayed below the title.</doc>
1875132035 allow-none="1">
1875232036 <doc xml:space="preserve"
1875332037 filename="src/adw-status-page.c"
18754- line="461">the description</doc>
32038+ line="481">the description</doc>
1875532039 <type name="utf8" c:type="const char*"/>
1875632040 </parameter>
1875732041 </parameters>
@@ -18759,10 +32043,9 @@ The description is displayed below the title.</doc>
1875932043 <method name="set_icon_name"
1876032044 c:identifier="adw_status_page_set_icon_name"
1876132045 glib:set-property="icon-name">
18762- <attribute name="org.gtk.Method.set_property" value="icon-name"/>
1876332046 <doc xml:space="preserve"
1876432047 filename="src/adw-status-page.c"
18765- line="321">Sets the icon name for @self.
32048+ line="336">Sets the icon name for @self.
1876632049
1876732050 Changing this will set [property@StatusPage:paintable] to `NULL`.</doc>
1876832051 <source-position filename="src/adw-status-page.h" line="30"/>
@@ -18773,7 +32056,7 @@ Changing this will set [property@StatusPage:paintable] to `NULL`.</doc>
1877332056 <instance-parameter name="self" transfer-ownership="none">
1877432057 <doc xml:space="preserve"
1877532058 filename="src/adw-status-page.c"
18776- line="323">a status page</doc>
32059+ line="338">a status page</doc>
1877732060 <type name="StatusPage" c:type="AdwStatusPage*"/>
1877832061 </instance-parameter>
1877932062 <parameter name="icon_name"
@@ -18782,7 +32065,7 @@ Changing this will set [property@StatusPage:paintable] to `NULL`.</doc>
1878232065 allow-none="1">
1878332066 <doc xml:space="preserve"
1878432067 filename="src/adw-status-page.c"
18785- line="324">the icon name</doc>
32068+ line="339">the icon name</doc>
1878632069 <type name="utf8" c:type="const char*"/>
1878732070 </parameter>
1878832071 </parameters>
@@ -18790,10 +32073,9 @@ Changing this will set [property@StatusPage:paintable] to `NULL`.</doc>
1879032073 <method name="set_paintable"
1879132074 c:identifier="adw_status_page_set_paintable"
1879232075 glib:set-property="paintable">
18793- <attribute name="org.gtk.Method.set_property" value="paintable"/>
1879432076 <doc xml:space="preserve"
1879532077 filename="src/adw-status-page.c"
18796- line="370">Sets the paintable for @self.
32078+ line="384">Sets the paintable for @self.
1879732079
1879832080 Changing this will set [property@StatusPage:icon-name] to `NULL`.</doc>
1879932081 <source-position filename="src/adw-status-page.h" line="36"/>
@@ -18804,7 +32086,7 @@ Changing this will set [property@StatusPage:icon-name] to `NULL`.</doc>
1880432086 <instance-parameter name="self" transfer-ownership="none">
1880532087 <doc xml:space="preserve"
1880632088 filename="src/adw-status-page.c"
18807- line="372">a status page</doc>
32089+ line="386">a status page</doc>
1880832090 <type name="StatusPage" c:type="AdwStatusPage*"/>
1880932091 </instance-parameter>
1881032092 <parameter name="paintable"
@@ -18813,7 +32095,7 @@ Changing this will set [property@StatusPage:icon-name] to `NULL`.</doc>
1881332095 allow-none="1">
1881432096 <doc xml:space="preserve"
1881532097 filename="src/adw-status-page.c"
18816- line="373">the paintable</doc>
32098+ line="387">the paintable</doc>
1881732099 <type name="Gdk.Paintable" c:type="GdkPaintable*"/>
1881832100 </parameter>
1881932101 </parameters>
@@ -18821,12 +32103,11 @@ Changing this will set [property@StatusPage:icon-name] to `NULL`.</doc>
1882132103 <method name="set_title"
1882232104 c:identifier="adw_status_page_set_title"
1882332105 glib:set-property="title">
18824- <attribute name="org.gtk.Method.set_property" value="title"/>
1882532106 <doc xml:space="preserve"
1882632107 filename="src/adw-status-page.c"
18827- line="419">Sets the title for @self.
32108+ line="439">Sets the title for @self.
1882832109
18829-The title is displayed below the icon.</doc>
32110+The title is displayed below the icon. It is not parsed as Pango markup.</doc>
1883032111 <source-position filename="src/adw-status-page.h" line="42"/>
1883132112 <return-value transfer-ownership="none">
1883232113 <type name="none" c:type="void"/>
@@ -18835,13 +32116,13 @@ The title is displayed below the icon.</doc>
1883532116 <instance-parameter name="self" transfer-ownership="none">
1883632117 <doc xml:space="preserve"
1883732118 filename="src/adw-status-page.c"
18838- line="421">a status page</doc>
32119+ line="441">a status page</doc>
1883932120 <type name="StatusPage" c:type="AdwStatusPage*"/>
1884032121 </instance-parameter>
1884132122 <parameter name="title" transfer-ownership="none">
1884232123 <doc xml:space="preserve"
1884332124 filename="src/adw-status-page.c"
18844- line="422">the title</doc>
32125+ line="442">the title</doc>
1884532126 <type name="utf8" c:type="const char*"/>
1884632127 </parameter>
1884732128 </parameters>
@@ -18851,13 +32132,9 @@ The title is displayed below the icon.</doc>
1885132132 transfer-ownership="none"
1885232133 setter="set_child"
1885332134 getter="get_child">
18854- <attribute name="org.gtk.Property.get"
18855- value="adw_status_page_get_child"/>
18856- <attribute name="org.gtk.Property.set"
18857- value="adw_status_page_set_child"/>
1885832135 <doc xml:space="preserve"
1885932136 filename="src/adw-status-page.c"
18860- line="234">The child widget.</doc>
32137+ line="249">The child widget.</doc>
1886132138 <type name="Gtk.Widget"/>
1886232139 </property>
1886332140 <property name="description"
@@ -18865,13 +32142,9 @@ The title is displayed below the icon.</doc>
1886532142 transfer-ownership="none"
1886632143 setter="set_description"
1886732144 getter="get_description">
18868- <attribute name="org.gtk.Property.get"
18869- value="adw_status_page_get_description"/>
18870- <attribute name="org.gtk.Property.set"
18871- value="adw_status_page_set_description"/>
1887232145 <doc xml:space="preserve"
1887332146 filename="src/adw-status-page.c"
18874- line="224">The description to be displayed below the title.</doc>
32147+ line="239">The description markup to be displayed below the title.</doc>
1887532148 <type name="utf8" c:type="gchar*"/>
1887632149 </property>
1887732150 <property name="icon-name"
@@ -18880,13 +32153,9 @@ The title is displayed below the icon.</doc>
1888032153 setter="set_icon_name"
1888132154 getter="get_icon_name"
1888232155 default-value="NULL">
18883- <attribute name="org.gtk.Property.get"
18884- value="adw_status_page_get_icon_name"/>
18885- <attribute name="org.gtk.Property.set"
18886- value="adw_status_page_set_icon_name"/>
1888732156 <doc xml:space="preserve"
1888832157 filename="src/adw-status-page.c"
18889- line="190">The name of the icon to be used.
32158+ line="203">The name of the icon to be used.
1889032159
1889132160 Changing this will set [property@StatusPage:paintable] to `NULL`.</doc>
1889232161 <type name="utf8" c:type="gchar*"/>
@@ -18896,13 +32165,9 @@ Changing this will set [property@StatusPage:paintable] to `NULL`.</doc>
1889632165 transfer-ownership="none"
1889732166 setter="set_paintable"
1889832167 getter="get_paintable">
18899- <attribute name="org.gtk.Property.get"
18900- value="adw_status_page_get_paintable"/>
18901- <attribute name="org.gtk.Property.set"
18902- value="adw_status_page_set_paintable"/>
1890332168 <doc xml:space="preserve"
1890432169 filename="src/adw-status-page.c"
18905- line="202">The paintable to be used.
32170+ line="215">The paintable to be used.
1890632171
1890732172 Changing this will set [property@StatusPage:icon-name] to `NULL`.</doc>
1890832173 <type name="Gdk.Paintable"/>
@@ -18912,13 +32177,11 @@ Changing this will set [property@StatusPage:icon-name] to `NULL`.</doc>
1891232177 transfer-ownership="none"
1891332178 setter="set_title"
1891432179 getter="get_title">
18915- <attribute name="org.gtk.Property.get"
18916- value="adw_status_page_get_title"/>
18917- <attribute name="org.gtk.Property.set"
18918- value="adw_status_page_set_title"/>
1891932180 <doc xml:space="preserve"
1892032181 filename="src/adw-status-page.c"
18921- line="214">The title to be displayed below the icon.</doc>
32182+ line="227">The title to be displayed below the icon.
32183+
32184+It is not parsed as Pango markup.</doc>
1892232185 <type name="utf8" c:type="gchar*"/>
1892332186 </property>
1892432187 </class>
@@ -18940,30 +32203,32 @@ Changing this will set [property@StatusPage:icon-name] to `NULL`.</doc>
1894032203 glib:type-struct="StyleManagerClass">
1894132204 <doc xml:space="preserve"
1894232205 filename="src/adw-style-manager.c"
18943- line="34">A class for managing application-wide styling.
32206+ line="35">A class for managing application-wide styling.
1894432207
1894532208 `AdwStyleManager` provides a way to query and influence the application
18946-styles, such as whether to use dark or high contrast appearance.
32209+styles, such as whether to use dark style, the system accent color or high
32210+contrast appearance.
1894732211
1894832212 It allows to set the color scheme via the
1894932213 [property@StyleManager:color-scheme] property, and to query the current
18950-appearance, as well as whether a system-wide color scheme preference exists.</doc>
18951- <source-position filename="src/adw-style-manager.h" line="33"/>
32214+appearance, as well as whether a system-wide color scheme and accent color
32215+preferences exists.</doc>
32216+ <source-position filename="src/adw-style-manager.h" line="35"/>
1895232217 <function name="get_default"
1895332218 c:identifier="adw_style_manager_get_default">
1895432219 <doc xml:space="preserve"
1895532220 filename="src/adw-style-manager.c"
18956- line="512">Gets the default `AdwStyleManager` instance.
32221+ line="644">Gets the default `AdwStyleManager` instance.
1895732222
1895832223 It manages all [class@Gdk.Display] instances unless the style manager for
1895932224 that display has an override.
1896032225
1896132226 See [func@StyleManager.get_for_display].</doc>
18962- <source-position filename="src/adw-style-manager.h" line="36"/>
32227+ <source-position filename="src/adw-style-manager.h" line="38"/>
1896332228 <return-value transfer-ownership="none">
1896432229 <doc xml:space="preserve"
1896532230 filename="src/adw-style-manager.c"
18966- line="522">the default style manager</doc>
32231+ line="654">the default style manager</doc>
1896732232 <type name="StyleManager" c:type="AdwStyleManager*"/>
1896832233 </return-value>
1896932234 </function>
@@ -18971,47 +32236,99 @@ See [func@StyleManager.get_for_display].</doc>
1897132236 c:identifier="adw_style_manager_get_for_display">
1897232237 <doc xml:space="preserve"
1897332238 filename="src/adw-style-manager.c"
18974- line="533">Gets the `AdwStyleManager` instance managing @display.
32239+ line="665">Gets the `AdwStyleManager` instance managing @display.
32240+
32241+It can be used to override styles for that specific display instead of the
32242+whole application.
32243+
32244+Most applications should use [func@StyleManager.get_default] instead.</doc>
32245+ <source-position filename="src/adw-style-manager.h" line="40"/>
32246+ <return-value transfer-ownership="none">
32247+ <doc xml:space="preserve"
32248+ filename="src/adw-style-manager.c"
32249+ line="676">the style manager for @display</doc>
32250+ <type name="StyleManager" c:type="AdwStyleManager*"/>
32251+ </return-value>
32252+ <parameters>
32253+ <parameter name="display" transfer-ownership="none">
32254+ <doc xml:space="preserve"
32255+ filename="src/adw-style-manager.c"
32256+ line="667">a `GdkDisplay`</doc>
32257+ <type name="Gdk.Display" c:type="GdkDisplay*"/>
32258+ </parameter>
32259+ </parameters>
32260+ </function>
32261+ <method name="get_accent_color"
32262+ c:identifier="adw_style_manager_get_accent_color"
32263+ glib:get-property="accent-color"
32264+ version="1.6">
32265+ <doc xml:space="preserve"
32266+ filename="src/adw-style-manager.c"
32267+ line="875">Gets the current system accent color.
32268+
32269+See also [property@StyleManager:accent-color-rgba].</doc>
32270+ <source-position filename="src/adw-style-manager.h" line="63"/>
32271+ <return-value transfer-ownership="none">
32272+ <doc xml:space="preserve"
32273+ filename="src/adw-style-manager.c"
32274+ line="883">the current system accent color</doc>
32275+ <type name="AccentColor" c:type="AdwAccentColor"/>
32276+ </return-value>
32277+ <parameters>
32278+ <instance-parameter name="self" transfer-ownership="none">
32279+ <doc xml:space="preserve"
32280+ filename="src/adw-style-manager.c"
32281+ line="877">a style manager</doc>
32282+ <type name="StyleManager" c:type="AdwStyleManager*"/>
32283+ </instance-parameter>
32284+ </parameters>
32285+ </method>
32286+ <method name="get_accent_color_rgba"
32287+ c:identifier="adw_style_manager_get_accent_color_rgba"
32288+ glib:get-property="accent-color-rgba"
32289+ version="1.6">
32290+ <doc xml:space="preserve"
32291+ filename="src/adw-style-manager.c"
32292+ line="895">Gets the current system accent color as a `GdkRGBA`.
1897532293
18976-It can be used to override styles for that specific display instead of the
18977-whole application.
32294+Equivalent to calling [func@AccentColor.to_rgba] on the value of
32295+[property@StyleManager:accent-color].
1897832296
18979-Most applications should use [func@StyleManager.get_default] instead.</doc>
18980- <source-position filename="src/adw-style-manager.h" line="38"/>
18981- <return-value transfer-ownership="none">
32297+This is a background color. The matching foreground color is white.</doc>
32298+ <source-position filename="src/adw-style-manager.h" line="66"/>
32299+ <return-value transfer-ownership="full">
1898232300 <doc xml:space="preserve"
1898332301 filename="src/adw-style-manager.c"
18984- line="544">the style manager for @display</doc>
18985- <type name="StyleManager" c:type="AdwStyleManager*"/>
32302+ line="906">the current system accent color</doc>
32303+ <type name="Gdk.RGBA" c:type="GdkRGBA*"/>
1898632304 </return-value>
1898732305 <parameters>
18988- <parameter name="display" transfer-ownership="none">
32306+ <instance-parameter name="self" transfer-ownership="none">
1898932307 <doc xml:space="preserve"
1899032308 filename="src/adw-style-manager.c"
18991- line="535">a `GdkDisplay`</doc>
18992- <type name="Gdk.Display" c:type="GdkDisplay*"/>
18993- </parameter>
32309+ line="897">a style manager</doc>
32310+ <type name="StyleManager" c:type="AdwStyleManager*"/>
32311+ </instance-parameter>
1899432312 </parameters>
18995- </function>
32313+ </method>
1899632314 <method name="get_color_scheme"
1899732315 c:identifier="adw_style_manager_get_color_scheme"
1899832316 glib:get-property="color-scheme">
18999- <attribute name="org.gtk.Method.get_property" value="color-scheme"/>
1900032317 <doc xml:space="preserve"
1900132318 filename="src/adw-style-manager.c"
19002- line="578">Gets the requested application color scheme.</doc>
19003- <source-position filename="src/adw-style-manager.h" line="44"/>
32319+ line="710">Gets the requested application color scheme.</doc>
32320+ <source-position filename="src/adw-style-manager.h" line="46"/>
1900432321 <return-value transfer-ownership="none">
1900532322 <doc xml:space="preserve"
1900632323 filename="src/adw-style-manager.c"
19007- line="584">the color scheme</doc>
32324+ line="716">the color scheme</doc>
1900832325 <type name="ColorScheme" c:type="AdwColorScheme"/>
1900932326 </return-value>
1901032327 <parameters>
1901132328 <instance-parameter name="self" transfer-ownership="none">
1901232329 <doc xml:space="preserve"
1901332330 filename="src/adw-style-manager.c"
19014- line="580">a style manager</doc>
32331+ line="712">a style manager</doc>
1901532332 <type name="StyleManager" c:type="AdwStyleManager*"/>
1901632333 </instance-parameter>
1901732334 </parameters>
@@ -19019,25 +32336,24 @@ Most applications should use [func@StyleManager.get_default] instead.</doc>
1901932336 <method name="get_dark"
1902032337 c:identifier="adw_style_manager_get_dark"
1902132338 glib:get-property="dark">
19022- <attribute name="org.gtk.Method.get_property" value="dark"/>
1902332339 <doc xml:space="preserve"
1902432340 filename="src/adw-style-manager.c"
19025- line="682">Gets whether the application is using dark appearance.
32341+ line="814">Gets whether the application is using dark appearance.
1902632342
1902732343 This can be used to query the current appearance, as requested via
1902832344 [property@StyleManager:color-scheme].</doc>
19029- <source-position filename="src/adw-style-manager.h" line="53"/>
32345+ <source-position filename="src/adw-style-manager.h" line="55"/>
1903032346 <return-value transfer-ownership="none">
1903132347 <doc xml:space="preserve"
1903232348 filename="src/adw-style-manager.c"
19033- line="691">whether the application is using dark appearance</doc>
32349+ line="823">whether the application is using dark appearance</doc>
1903432350 <type name="gboolean" c:type="gboolean"/>
1903532351 </return-value>
1903632352 <parameters>
1903732353 <instance-parameter name="self" transfer-ownership="none">
1903832354 <doc xml:space="preserve"
1903932355 filename="src/adw-style-manager.c"
19040- line="684">a style manager</doc>
32356+ line="816">a style manager</doc>
1904132357 <type name="StyleManager" c:type="AdwStyleManager*"/>
1904232358 </instance-parameter>
1904332359 </parameters>
@@ -19045,25 +32361,24 @@ This can be used to query the current appearance, as requested via
1904532361 <method name="get_display"
1904632362 c:identifier="adw_style_manager_get_display"
1904732363 glib:get-property="display">
19048- <attribute name="org.gtk.Method.get_property" value="display"/>
1904932364 <doc xml:space="preserve"
1905032365 filename="src/adw-style-manager.c"
19051- line="559">Gets the display the style manager is associated with.
32366+ line="691">Gets the display the style manager is associated with.
1905232367
1905332368 The display will be `NULL` for the style manager returned by
1905432369 [func@StyleManager.get_default].</doc>
19055- <source-position filename="src/adw-style-manager.h" line="41"/>
32370+ <source-position filename="src/adw-style-manager.h" line="43"/>
1905632371 <return-value transfer-ownership="none" nullable="1">
1905732372 <doc xml:space="preserve"
1905832373 filename="src/adw-style-manager.c"
19059- line="568">the display</doc>
32374+ line="700">the display</doc>
1906032375 <type name="Gdk.Display" c:type="GdkDisplay*"/>
1906132376 </return-value>
1906232377 <parameters>
1906332378 <instance-parameter name="self" transfer-ownership="none">
1906432379 <doc xml:space="preserve"
1906532380 filename="src/adw-style-manager.c"
19066- line="561">a style manager</doc>
32381+ line="693">a style manager</doc>
1906732382 <type name="StyleManager" c:type="AdwStyleManager*"/>
1906832383 </instance-parameter>
1906932384 </parameters>
@@ -19071,24 +32386,52 @@ The display will be `NULL` for the style manager returned by
1907132386 <method name="get_high_contrast"
1907232387 c:identifier="adw_style_manager_get_high_contrast"
1907332388 glib:get-property="high-contrast">
19074- <attribute name="org.gtk.Method.get_property" value="high-contrast"/>
1907532389 <doc xml:space="preserve"
1907632390 filename="src/adw-style-manager.c"
19077- line="701">Gets whether the application is using high contrast appearance.
32391+ line="833">Gets whether the application is using high contrast appearance.
1907832392
1907932393 This cannot be overridden by applications.</doc>
19080- <source-position filename="src/adw-style-manager.h" line="55"/>
32394+ <source-position filename="src/adw-style-manager.h" line="57"/>
32395+ <return-value transfer-ownership="none">
32396+ <doc xml:space="preserve"
32397+ filename="src/adw-style-manager.c"
32398+ line="841">whether the application is using high contrast appearance</doc>
32399+ <type name="gboolean" c:type="gboolean"/>
32400+ </return-value>
32401+ <parameters>
32402+ <instance-parameter name="self" transfer-ownership="none">
32403+ <doc xml:space="preserve"
32404+ filename="src/adw-style-manager.c"
32405+ line="835">a style manager</doc>
32406+ <type name="StyleManager" c:type="AdwStyleManager*"/>
32407+ </instance-parameter>
32408+ </parameters>
32409+ </method>
32410+ <method name="get_system_supports_accent_colors"
32411+ c:identifier="adw_style_manager_get_system_supports_accent_colors"
32412+ glib:get-property="system-supports-accent-colors"
32413+ version="1.6">
32414+ <doc xml:space="preserve"
32415+ filename="src/adw-style-manager.c"
32416+ line="851">Gets whether the system supports accent colors.
32417+
32418+This can be used to check if the current environment provides an accent color
32419+preference. For example, applications might want to show a preference for
32420+choosing accent color if it's set to `FALSE`.
32421+
32422+See [property@StyleManager:accent-color].</doc>
32423+ <source-position filename="src/adw-style-manager.h" line="60"/>
1908132424 <return-value transfer-ownership="none">
1908232425 <doc xml:space="preserve"
1908332426 filename="src/adw-style-manager.c"
19084- line="709">whether the application is using high contrast appearance</doc>
32427+ line="863">whether the system supports accent colors</doc>
1908532428 <type name="gboolean" c:type="gboolean"/>
1908632429 </return-value>
1908732430 <parameters>
1908832431 <instance-parameter name="self" transfer-ownership="none">
1908932432 <doc xml:space="preserve"
1909032433 filename="src/adw-style-manager.c"
19091- line="703">a style manager</doc>
32434+ line="853">a style manager</doc>
1909232435 <type name="StyleManager" c:type="AdwStyleManager*"/>
1909332436 </instance-parameter>
1909432437 </parameters>
@@ -19096,27 +32439,25 @@ This cannot be overridden by applications.</doc>
1909632439 <method name="get_system_supports_color_schemes"
1909732440 c:identifier="adw_style_manager_get_system_supports_color_schemes"
1909832441 glib:get-property="system-supports-color-schemes">
19099- <attribute name="org.gtk.Method.get_property"
19100- value="system-supports-color-schemes"/>
1910132442 <doc xml:space="preserve"
1910232443 filename="src/adw-style-manager.c"
19103- line="662">Gets whether the system supports color schemes.
32444+ line="794">Gets whether the system supports color schemes.
1910432445
1910532446 This can be used to check if the current environment provides a color scheme
1910632447 preference. For example, applications might want to show a separate
1910732448 appearance switcher if it's set to `FALSE`.</doc>
19108- <source-position filename="src/adw-style-manager.h" line="50"/>
32449+ <source-position filename="src/adw-style-manager.h" line="52"/>
1910932450 <return-value transfer-ownership="none">
1911032451 <doc xml:space="preserve"
1911132452 filename="src/adw-style-manager.c"
19112- line="672">whether the system supports color schemes</doc>
32453+ line="804">whether the system supports color schemes</doc>
1911332454 <type name="gboolean" c:type="gboolean"/>
1911432455 </return-value>
1911532456 <parameters>
1911632457 <instance-parameter name="self" transfer-ownership="none">
1911732458 <doc xml:space="preserve"
1911832459 filename="src/adw-style-manager.c"
19119- line="664">a style manager</doc>
32460+ line="796">a style manager</doc>
1912032461 <type name="StyleManager" c:type="AdwStyleManager*"/>
1912132462 </instance-parameter>
1912232463 </parameters>
@@ -19124,10 +32465,9 @@ appearance switcher if it's set to `FALSE`.</doc>
1912432465 <method name="set_color_scheme"
1912532466 c:identifier="adw_style_manager_set_color_scheme"
1912632467 glib:set-property="color-scheme">
19127- <attribute name="org.gtk.Method.set_property" value="color-scheme"/>
1912832468 <doc xml:space="preserve"
1912932469 filename="src/adw-style-manager.c"
19130- line="594">Sets the requested application color scheme.
32470+ line="726">Sets the requested application color scheme.
1913132471
1913232472 The effective appearance will be decided based on the application color
1913332473 scheme and the system preferred color scheme. The
@@ -19158,7 +32498,7 @@ For the default style manager, `ADW_COLOR_SCHEME_DEFAULT` is equivalent to
1915832498 The [property@StyleManager:system-supports-color-schemes] property can be
1915932499 used to check if the current environment provides a color scheme
1916032500 preference.</doc>
19161- <source-position filename="src/adw-style-manager.h" line="46"/>
32501+ <source-position filename="src/adw-style-manager.h" line="48"/>
1916232502 <return-value transfer-ownership="none">
1916332503 <type name="none" c:type="void"/>
1916432504 </return-value>
@@ -19166,30 +32506,52 @@ preference.</doc>
1916632506 <instance-parameter name="self" transfer-ownership="none">
1916732507 <doc xml:space="preserve"
1916832508 filename="src/adw-style-manager.c"
19169- line="596">a style manager</doc>
32509+ line="728">a style manager</doc>
1917032510 <type name="StyleManager" c:type="AdwStyleManager*"/>
1917132511 </instance-parameter>
1917232512 <parameter name="color_scheme" transfer-ownership="none">
1917332513 <doc xml:space="preserve"
1917432514 filename="src/adw-style-manager.c"
19175- line="597">the color scheme</doc>
32515+ line="729">the color scheme</doc>
1917632516 <type name="ColorScheme" c:type="AdwColorScheme"/>
1917732517 </parameter>
1917832518 </parameters>
1917932519 </method>
32520+ <property name="accent-color"
32521+ version="1.6"
32522+ transfer-ownership="none"
32523+ getter="get_accent_color"
32524+ default-value="ADW_ACCENT_COLOR_BLUE">
32525+ <doc xml:space="preserve"
32526+ filename="src/adw-style-manager.c"
32527+ line="574">The current system accent color.
32528+
32529+See also [property@StyleManager:accent-color-rgba].</doc>
32530+ <type name="AccentColor"/>
32531+ </property>
32532+ <property name="accent-color-rgba"
32533+ version="1.6"
32534+ transfer-ownership="none"
32535+ getter="get_accent_color_rgba">
32536+ <doc xml:space="preserve"
32537+ filename="src/adw-style-manager.c"
32538+ line="589">The current system accent color as a `GdkRGBA`.
32539+
32540+Equivalent to calling [func@AccentColor.to_rgba] on the value of
32541+[property@StyleManager:accent-color].
32542+
32543+This is a background color. The matching foreground color is white.</doc>
32544+ <type name="Gdk.RGBA"/>
32545+ </property>
1918032546 <property name="color-scheme"
1918132547 writable="1"
1918232548 transfer-ownership="none"
1918332549 setter="set_color_scheme"
1918432550 getter="get_color_scheme"
1918532551 default-value="ADW_COLOR_SCHEME_DEFAULT">
19186- <attribute name="org.gtk.Property.get"
19187- value="adw_style_manager_get_color_scheme"/>
19188- <attribute name="org.gtk.Property.set"
19189- value="adw_style_manager_set_color_scheme"/>
1919032552 <doc xml:space="preserve"
1919132553 filename="src/adw-style-manager.c"
19192- line="392">The requested application color scheme.
32554+ line="474">The requested application color scheme.
1919332555
1919432556 The effective appearance will be decided based on the application color
1919532557 scheme and the system preferred color scheme. The
@@ -19226,11 +32588,9 @@ preference.</doc>
1922632588 transfer-ownership="none"
1922732589 getter="get_dark"
1922832590 default-value="FALSE">
19229- <attribute name="org.gtk.Property.get"
19230- value="adw_style_manager_get_dark"/>
1923132591 <doc xml:space="preserve"
1923232592 filename="src/adw-style-manager.c"
19233- line="449">Whether the application is using dark appearance.
32593+ line="531">Whether the application is using dark appearance.
1923432594
1923532595 This property can be used to query the current appearance, as requested via
1923632596 [property@StyleManager:color-scheme].</doc>
@@ -19241,11 +32601,9 @@ This property can be used to query the current appearance, as requested via
1924132601 construct-only="1"
1924232602 transfer-ownership="none"
1924332603 getter="get_display">
19244- <attribute name="org.gtk.Property.get"
19245- value="adw_style_manager_get_display"/>
1924632604 <doc xml:space="preserve"
1924732605 filename="src/adw-style-manager.c"
19248- line="379">The display the style manager is associated with.
32606+ line="461">The display the style manager is associated with.
1924932607
1925032608 The display will be `NULL` for the style manager returned by
1925132609 [func@StyleManager.get_default].</doc>
@@ -19255,24 +32613,36 @@ The display will be `NULL` for the style manager returned by
1925532613 transfer-ownership="none"
1925632614 getter="get_high_contrast"
1925732615 default-value="FALSE">
19258- <attribute name="org.gtk.Property.get"
19259- value="adw_style_manager_get_high_contrast"/>
1926032616 <doc xml:space="preserve"
1926132617 filename="src/adw-style-manager.c"
19262- line="462">Whether the application is using high contrast appearance.
32618+ line="544">Whether the application is using high contrast appearance.
1926332619
1926432620 This cannot be overridden by applications.</doc>
1926532621 <type name="gboolean" c:type="gboolean"/>
1926632622 </property>
32623+ <property name="system-supports-accent-colors"
32624+ version="1.6"
32625+ transfer-ownership="none"
32626+ getter="get_system_supports_accent_colors"
32627+ default-value="FALSE">
32628+ <doc xml:space="preserve"
32629+ filename="src/adw-style-manager.c"
32630+ line="556">Whether the system supports accent colors.
32631+
32632+This property can be used to check if the current environment provides an
32633+accent color preference. For example, applications might want to show a
32634+preference for choosing accent color if it's set to `FALSE`.
32635+
32636+See [property@StyleManager:accent-color].</doc>
32637+ <type name="gboolean" c:type="gboolean"/>
32638+ </property>
1926732639 <property name="system-supports-color-schemes"
1926832640 transfer-ownership="none"
1926932641 getter="get_system_supports_color_schemes"
1927032642 default-value="FALSE">
19271- <attribute name="org.gtk.Property.get"
19272- value="adw_style_manager_get_system_supports_color_schemes"/>
1927332643 <doc xml:space="preserve"
1927432644 filename="src/adw-style-manager.c"
19275- line="433">Whether the system supports color schemes.
32645+ line="515">Whether the system supports color schemes.
1927632646
1927732647 This property can be used to check if the current environment provides a
1927832648 color scheme preference. For example, applications might want to show a
@@ -19285,7 +32655,7 @@ See [property@StyleManager:color-scheme].</doc>
1928532655 <record name="StyleManagerClass"
1928632656 c:type="AdwStyleManagerClass"
1928732657 glib:is-gtype-struct-for="StyleManager">
19288- <source-position filename="src/adw-style-manager.h" line="33"/>
32658+ <source-position filename="src/adw-style-manager.h" line="35"/>
1928932659 <field name="parent_class">
1929032660 <type name="GObject.ObjectClass" c:type="GObjectClass"/>
1929132661 </field>
@@ -19300,7 +32670,8 @@ See [property@StyleManager:color-scheme].</doc>
1930032670 glib:type-struct="SwipeTrackerClass">
1930132671 <doc xml:space="preserve"
1930232672 filename="src/adw-swipe-tracker.c"
19303- line="34">A swipe tracker used in [class@Carousel], [class@Flap] and [class@Leaflet].
32673+ line="35">A swipe tracker used in [class@Carousel], [class@NavigationView] and
32674+[class@OverlaySplitView].
1930432675
1930532676 The `AdwSwipeTracker` object can be used for implementing widgets with swipe
1930632677 gestures. It supports touch-based swipes, pointer dragging, and touchpad
@@ -19315,19 +32686,19 @@ direction.</doc>
1931532686 <constructor name="new" c:identifier="adw_swipe_tracker_new">
1931632687 <doc xml:space="preserve"
1931732688 filename="src/adw-swipe-tracker.c"
19318- line="1191">Creates a new `AdwSwipeTracker` for @widget.</doc>
32689+ line="1392">Creates a new `AdwSwipeTracker` for @widget.</doc>
1931932690 <source-position filename="src/adw-swipe-tracker.h" line="26"/>
1932032691 <return-value transfer-ownership="full">
1932132692 <doc xml:space="preserve"
1932232693 filename="src/adw-swipe-tracker.c"
19323- line="1197">the newly created `AdwSwipeTracker`</doc>
32694+ line="1398">the newly created `AdwSwipeTracker`</doc>
1932432695 <type name="SwipeTracker" c:type="AdwSwipeTracker*"/>
1932532696 </return-value>
1932632697 <parameters>
1932732698 <parameter name="swipeable" transfer-ownership="none">
1932832699 <doc xml:space="preserve"
1932932700 filename="src/adw-swipe-tracker.c"
19330- line="1193">a widget to add the tracker on</doc>
32701+ line="1394">a widget to add the tracker on</doc>
1933132702 <type name="Swipeable" c:type="AdwSwipeable*"/>
1933232703 </parameter>
1933332704 </parameters>
@@ -19335,23 +32706,21 @@ direction.</doc>
1933532706 <method name="get_allow_long_swipes"
1933632707 c:identifier="adw_swipe_tracker_get_allow_long_swipes"
1933732708 glib:get-property="allow-long-swipes">
19338- <attribute name="org.gtk.Method.get_property"
19339- value="allow-long-swipes"/>
1934032709 <doc xml:space="preserve"
1934132710 filename="src/adw-swipe-tracker.c"
19342- line="1354">Gets whether to allow swiping for more than one snap point at a time.</doc>
32711+ line="1555">Gets whether to allow swiping for more than one snap point at a time.</doc>
1934332712 <source-position filename="src/adw-swipe-tracker.h" line="50"/>
1934432713 <return-value transfer-ownership="none">
1934532714 <doc xml:space="preserve"
1934632715 filename="src/adw-swipe-tracker.c"
19347- line="1360">whether long swipes are allowed</doc>
32716+ line="1561">whether long swipes are allowed</doc>
1934832717 <type name="gboolean" c:type="gboolean"/>
1934932718 </return-value>
1935032719 <parameters>
1935132720 <instance-parameter name="self" transfer-ownership="none">
1935232721 <doc xml:space="preserve"
1935332722 filename="src/adw-swipe-tracker.c"
19354- line="1356">a swipe tracker</doc>
32723+ line="1557">a swipe tracker</doc>
1935532724 <type name="SwipeTracker" c:type="AdwSwipeTracker*"/>
1935632725 </instance-parameter>
1935732726 </parameters>
@@ -19359,23 +32728,44 @@ direction.</doc>
1935932728 <method name="get_allow_mouse_drag"
1936032729 c:identifier="adw_swipe_tracker_get_allow_mouse_drag"
1936132730 glib:get-property="allow-mouse-drag">
19362- <attribute name="org.gtk.Method.get_property"
19363- value="allow-mouse-drag"/>
1936432731 <doc xml:space="preserve"
1936532732 filename="src/adw-swipe-tracker.c"
19366- line="1313">Gets whether @self can be dragged with mouse pointer.</doc>
32733+ line="1514">Gets whether @self can be dragged with mouse pointer.</doc>
1936732734 <source-position filename="src/adw-swipe-tracker.h" line="44"/>
1936832735 <return-value transfer-ownership="none">
1936932736 <doc xml:space="preserve"
1937032737 filename="src/adw-swipe-tracker.c"
19371- line="1319">whether mouse dragging is allowed</doc>
32738+ line="1520">whether mouse dragging is allowed</doc>
32739+ <type name="gboolean" c:type="gboolean"/>
32740+ </return-value>
32741+ <parameters>
32742+ <instance-parameter name="self" transfer-ownership="none">
32743+ <doc xml:space="preserve"
32744+ filename="src/adw-swipe-tracker.c"
32745+ line="1516">a swipe tracker</doc>
32746+ <type name="SwipeTracker" c:type="AdwSwipeTracker*"/>
32747+ </instance-parameter>
32748+ </parameters>
32749+ </method>
32750+ <method name="get_allow_window_handle"
32751+ c:identifier="adw_swipe_tracker_get_allow_window_handle"
32752+ glib:get-property="allow-window-handle"
32753+ version="1.5">
32754+ <doc xml:space="preserve"
32755+ filename="src/adw-swipe-tracker.c"
32756+ line="1683">Gets whether to allow touchscreen swiping from `GtkWindowHandle`.</doc>
32757+ <source-position filename="src/adw-swipe-tracker.h" line="68"/>
32758+ <return-value transfer-ownership="none">
32759+ <doc xml:space="preserve"
32760+ filename="src/adw-swipe-tracker.c"
32761+ line="1689">whether swiping from window handles is allowed</doc>
1937232762 <type name="gboolean" c:type="gboolean"/>
1937332763 </return-value>
1937432764 <parameters>
1937532765 <instance-parameter name="self" transfer-ownership="none">
1937632766 <doc xml:space="preserve"
1937732767 filename="src/adw-swipe-tracker.c"
19378- line="1315">a swipe tracker</doc>
32768+ line="1685">a swipe tracker</doc>
1937932769 <type name="SwipeTracker" c:type="AdwSwipeTracker*"/>
1938032770 </instance-parameter>
1938132771 </parameters>
@@ -19383,22 +32773,44 @@ direction.</doc>
1938332773 <method name="get_enabled"
1938432774 c:identifier="adw_swipe_tracker_get_enabled"
1938532775 glib:get-property="enabled">
19386- <attribute name="org.gtk.Method.get_property" value="enabled"/>
1938732776 <doc xml:space="preserve"
1938832777 filename="src/adw-swipe-tracker.c"
19389- line="1225">Gets whether @self is enabled.</doc>
32778+ line="1426">Gets whether @self is enabled.</doc>
1939032779 <source-position filename="src/adw-swipe-tracker.h" line="32"/>
1939132780 <return-value transfer-ownership="none">
1939232781 <doc xml:space="preserve"
1939332782 filename="src/adw-swipe-tracker.c"
19394- line="1231">whether @self is enabled</doc>
32783+ line="1432">whether @self is enabled</doc>
32784+ <type name="gboolean" c:type="gboolean"/>
32785+ </return-value>
32786+ <parameters>
32787+ <instance-parameter name="self" transfer-ownership="none">
32788+ <doc xml:space="preserve"
32789+ filename="src/adw-swipe-tracker.c"
32790+ line="1428">a swipe tracker</doc>
32791+ <type name="SwipeTracker" c:type="AdwSwipeTracker*"/>
32792+ </instance-parameter>
32793+ </parameters>
32794+ </method>
32795+ <method name="get_lower_overshoot"
32796+ c:identifier="adw_swipe_tracker_get_lower_overshoot"
32797+ glib:get-property="lower-overshoot"
32798+ version="1.4">
32799+ <doc xml:space="preserve"
32800+ filename="src/adw-swipe-tracker.c"
32801+ line="1597">Gets whether to allow swiping past the first available snap point.</doc>
32802+ <source-position filename="src/adw-swipe-tracker.h" line="56"/>
32803+ <return-value transfer-ownership="none">
32804+ <doc xml:space="preserve"
32805+ filename="src/adw-swipe-tracker.c"
32806+ line="1603">whether to allow swiping past the first available snap point</doc>
1939532807 <type name="gboolean" c:type="gboolean"/>
1939632808 </return-value>
1939732809 <parameters>
1939832810 <instance-parameter name="self" transfer-ownership="none">
1939932811 <doc xml:space="preserve"
1940032812 filename="src/adw-swipe-tracker.c"
19401- line="1227">a swipe tracker</doc>
32813+ line="1599">a swipe tracker</doc>
1940232814 <type name="SwipeTracker" c:type="AdwSwipeTracker*"/>
1940332815 </instance-parameter>
1940432816 </parameters>
@@ -19406,22 +32818,21 @@ direction.</doc>
1940632818 <method name="get_reversed"
1940732819 c:identifier="adw_swipe_tracker_get_reversed"
1940832820 glib:get-property="reversed">
19409- <attribute name="org.gtk.Method.get_property" value="reversed"/>
1941032821 <doc xml:space="preserve"
1941132822 filename="src/adw-swipe-tracker.c"
19412- line="1272">Gets whether @self is reversing the swipe direction.</doc>
32823+ line="1473">Gets whether @self is reversing the swipe direction.</doc>
1941332824 <source-position filename="src/adw-swipe-tracker.h" line="38"/>
1941432825 <return-value transfer-ownership="none">
1941532826 <doc xml:space="preserve"
1941632827 filename="src/adw-swipe-tracker.c"
19417- line="1278">whether the direction is reversed</doc>
32828+ line="1479">whether the direction is reversed</doc>
1941832829 <type name="gboolean" c:type="gboolean"/>
1941932830 </return-value>
1942032831 <parameters>
1942132832 <instance-parameter name="self" transfer-ownership="none">
1942232833 <doc xml:space="preserve"
1942332834 filename="src/adw-swipe-tracker.c"
19424- line="1274">a swipe tracker</doc>
32835+ line="1475">a swipe tracker</doc>
1942532836 <type name="SwipeTracker" c:type="AdwSwipeTracker*"/>
1942632837 </instance-parameter>
1942732838 </parameters>
@@ -19429,22 +32840,44 @@ direction.</doc>
1942932840 <method name="get_swipeable"
1943032841 c:identifier="adw_swipe_tracker_get_swipeable"
1943132842 glib:get-property="swipeable">
19432- <attribute name="org.gtk.Method.get_property" value="swipeable"/>
1943332843 <doc xml:space="preserve"
1943432844 filename="src/adw-swipe-tracker.c"
19435- line="1209">Get the widget @self is attached to.</doc>
32845+ line="1410">Get the widget @self is attached to.</doc>
1943632846 <source-position filename="src/adw-swipe-tracker.h" line="29"/>
1943732847 <return-value transfer-ownership="none">
1943832848 <doc xml:space="preserve"
1943932849 filename="src/adw-swipe-tracker.c"
19440- line="1215">the swipeable widget</doc>
32850+ line="1416">the swipeable widget</doc>
1944132851 <type name="Swipeable" c:type="AdwSwipeable*"/>
1944232852 </return-value>
1944332853 <parameters>
1944432854 <instance-parameter name="self" transfer-ownership="none">
1944532855 <doc xml:space="preserve"
1944632856 filename="src/adw-swipe-tracker.c"
19447- line="1211">a swipe tracker</doc>
32857+ line="1412">a swipe tracker</doc>
32858+ <type name="SwipeTracker" c:type="AdwSwipeTracker*"/>
32859+ </instance-parameter>
32860+ </parameters>
32861+ </method>
32862+ <method name="get_upper_overshoot"
32863+ c:identifier="adw_swipe_tracker_get_upper_overshoot"
32864+ glib:get-property="upper-overshoot"
32865+ version="1.4">
32866+ <doc xml:space="preserve"
32867+ filename="src/adw-swipe-tracker.c"
32868+ line="1640">Gets whether to allow swiping past the last available snap point.</doc>
32869+ <source-position filename="src/adw-swipe-tracker.h" line="62"/>
32870+ <return-value transfer-ownership="none">
32871+ <doc xml:space="preserve"
32872+ filename="src/adw-swipe-tracker.c"
32873+ line="1646">whether to allow swiping past the last available snap point</doc>
32874+ <type name="gboolean" c:type="gboolean"/>
32875+ </return-value>
32876+ <parameters>
32877+ <instance-parameter name="self" transfer-ownership="none">
32878+ <doc xml:space="preserve"
32879+ filename="src/adw-swipe-tracker.c"
32880+ line="1642">a swipe tracker</doc>
1944832881 <type name="SwipeTracker" c:type="AdwSwipeTracker*"/>
1944932882 </instance-parameter>
1945032883 </parameters>
@@ -19452,11 +32885,9 @@ direction.</doc>
1945232885 <method name="set_allow_long_swipes"
1945332886 c:identifier="adw_swipe_tracker_set_allow_long_swipes"
1945432887 glib:set-property="allow-long-swipes">
19455- <attribute name="org.gtk.Method.set_property"
19456- value="allow-long-swipes"/>
1945732888 <doc xml:space="preserve"
1945832889 filename="src/adw-swipe-tracker.c"
19459- line="1370">Sets whether to allow swiping for more than one snap point at a time.
32890+ line="1571">Sets whether to allow swiping for more than one snap point at a time.
1946032891
1946132892 If the value is `FALSE`, each swipe can only move to the adjacent snap
1946232893 points.</doc>
@@ -19468,13 +32899,13 @@ points.</doc>
1946832899 <instance-parameter name="self" transfer-ownership="none">
1946932900 <doc xml:space="preserve"
1947032901 filename="src/adw-swipe-tracker.c"
19471- line="1372">a swipe tracker</doc>
32902+ line="1573">a swipe tracker</doc>
1947232903 <type name="SwipeTracker" c:type="AdwSwipeTracker*"/>
1947332904 </instance-parameter>
1947432905 <parameter name="allow_long_swipes" transfer-ownership="none">
1947532906 <doc xml:space="preserve"
1947632907 filename="src/adw-swipe-tracker.c"
19477- line="1373">whether to allow long swipes</doc>
32908+ line="1574">whether to allow long swipes</doc>
1947832909 <type name="gboolean" c:type="gboolean"/>
1947932910 </parameter>
1948032911 </parameters>
@@ -19482,11 +32913,9 @@ points.</doc>
1948232913 <method name="set_allow_mouse_drag"
1948332914 c:identifier="adw_swipe_tracker_set_allow_mouse_drag"
1948432915 glib:set-property="allow-mouse-drag">
19485- <attribute name="org.gtk.Method.set_property"
19486- value="allow-mouse-drag"/>
1948732916 <doc xml:space="preserve"
1948832917 filename="src/adw-swipe-tracker.c"
19489- line="1329">Sets whether @self can be dragged with mouse pointer.</doc>
32918+ line="1530">Sets whether @self can be dragged with mouse pointer.</doc>
1949032919 <source-position filename="src/adw-swipe-tracker.h" line="46"/>
1949132920 <return-value transfer-ownership="none">
1949232921 <type name="none" c:type="void"/>
@@ -19495,13 +32924,41 @@ points.</doc>
1949532924 <instance-parameter name="self" transfer-ownership="none">
1949632925 <doc xml:space="preserve"
1949732926 filename="src/adw-swipe-tracker.c"
19498- line="1331">a swipe tracker</doc>
32927+ line="1532">a swipe tracker</doc>
1949932928 <type name="SwipeTracker" c:type="AdwSwipeTracker*"/>
1950032929 </instance-parameter>
1950132930 <parameter name="allow_mouse_drag" transfer-ownership="none">
1950232931 <doc xml:space="preserve"
1950332932 filename="src/adw-swipe-tracker.c"
19504- line="1332">whether to allow mouse dragging</doc>
32933+ line="1533">whether to allow mouse dragging</doc>
32934+ <type name="gboolean" c:type="gboolean"/>
32935+ </parameter>
32936+ </parameters>
32937+ </method>
32938+ <method name="set_allow_window_handle"
32939+ c:identifier="adw_swipe_tracker_set_allow_window_handle"
32940+ glib:set-property="allow-window-handle"
32941+ version="1.5">
32942+ <doc xml:space="preserve"
32943+ filename="src/adw-swipe-tracker.c"
32944+ line="1701">Sets whether to allow touchscreen swiping from `GtkWindowHandle`.
32945+
32946+Setting it to `TRUE` will make dragging the window impossible.</doc>
32947+ <source-position filename="src/adw-swipe-tracker.h" line="70"/>
32948+ <return-value transfer-ownership="none">
32949+ <type name="none" c:type="void"/>
32950+ </return-value>
32951+ <parameters>
32952+ <instance-parameter name="self" transfer-ownership="none">
32953+ <doc xml:space="preserve"
32954+ filename="src/adw-swipe-tracker.c"
32955+ line="1703">a swipe tracker</doc>
32956+ <type name="SwipeTracker" c:type="AdwSwipeTracker*"/>
32957+ </instance-parameter>
32958+ <parameter name="allow_window_handle" transfer-ownership="none">
32959+ <doc xml:space="preserve"
32960+ filename="src/adw-swipe-tracker.c"
32961+ line="1704">whether to allow swiping from window handles</doc>
1950532962 <type name="gboolean" c:type="gboolean"/>
1950632963 </parameter>
1950732964 </parameters>
@@ -19509,10 +32966,9 @@ points.</doc>
1950932966 <method name="set_enabled"
1951032967 c:identifier="adw_swipe_tracker_set_enabled"
1951132968 glib:set-property="enabled">
19512- <attribute name="org.gtk.Method.set_property" value="enabled"/>
1951332969 <doc xml:space="preserve"
1951432970 filename="src/adw-swipe-tracker.c"
19515- line="1241">Sets whether @self is enabled.
32971+ line="1442">Sets whether @self is enabled.
1951632972
1951732973 When it's not enabled, no events will be processed. Usually widgets will want
1951832974 to expose this via a property.</doc>
@@ -19524,13 +32980,39 @@ to expose this via a property.</doc>
1952432980 <instance-parameter name="self" transfer-ownership="none">
1952532981 <doc xml:space="preserve"
1952632982 filename="src/adw-swipe-tracker.c"
19527- line="1243">a swipe tracker</doc>
32983+ line="1444">a swipe tracker</doc>
1952832984 <type name="SwipeTracker" c:type="AdwSwipeTracker*"/>
1952932985 </instance-parameter>
1953032986 <parameter name="enabled" transfer-ownership="none">
1953132987 <doc xml:space="preserve"
1953232988 filename="src/adw-swipe-tracker.c"
19533- line="1244">whether @self is enabled</doc>
32989+ line="1445">whether @self is enabled</doc>
32990+ <type name="gboolean" c:type="gboolean"/>
32991+ </parameter>
32992+ </parameters>
32993+ </method>
32994+ <method name="set_lower_overshoot"
32995+ c:identifier="adw_swipe_tracker_set_lower_overshoot"
32996+ glib:set-property="lower-overshoot"
32997+ version="1.4">
32998+ <doc xml:space="preserve"
32999+ filename="src/adw-swipe-tracker.c"
33000+ line="1615">Sets whether to allow swiping past the first available snap point.</doc>
33001+ <source-position filename="src/adw-swipe-tracker.h" line="58"/>
33002+ <return-value transfer-ownership="none">
33003+ <type name="none" c:type="void"/>
33004+ </return-value>
33005+ <parameters>
33006+ <instance-parameter name="self" transfer-ownership="none">
33007+ <doc xml:space="preserve"
33008+ filename="src/adw-swipe-tracker.c"
33009+ line="1617">a swipe tracker</doc>
33010+ <type name="SwipeTracker" c:type="AdwSwipeTracker*"/>
33011+ </instance-parameter>
33012+ <parameter name="overshoot" transfer-ownership="none">
33013+ <doc xml:space="preserve"
33014+ filename="src/adw-swipe-tracker.c"
33015+ line="1618">whether to allow swiping past the first available snap point</doc>
1953433016 <type name="gboolean" c:type="gboolean"/>
1953533017 </parameter>
1953633018 </parameters>
@@ -19538,10 +33020,9 @@ to expose this via a property.</doc>
1953833020 <method name="set_reversed"
1953933021 c:identifier="adw_swipe_tracker_set_reversed"
1954033022 glib:set-property="reversed">
19541- <attribute name="org.gtk.Method.set_property" value="reversed"/>
1954233023 <doc xml:space="preserve"
1954333024 filename="src/adw-swipe-tracker.c"
19544- line="1288">Sets whether to reverse the swipe direction.
33025+ line="1489">Sets whether to reverse the swipe direction.
1954533026
1954633027 If the swipe tracker is horizontal, it can be used for supporting RTL text
1954733028 direction.</doc>
@@ -19553,13 +33034,39 @@ direction.</doc>
1955333034 <instance-parameter name="self" transfer-ownership="none">
1955433035 <doc xml:space="preserve"
1955533036 filename="src/adw-swipe-tracker.c"
19556- line="1290">a swipe tracker</doc>
33037+ line="1491">a swipe tracker</doc>
1955733038 <type name="SwipeTracker" c:type="AdwSwipeTracker*"/>
1955833039 </instance-parameter>
1955933040 <parameter name="reversed" transfer-ownership="none">
1956033041 <doc xml:space="preserve"
1956133042 filename="src/adw-swipe-tracker.c"
19562- line="1291">whether to reverse the swipe direction</doc>
33043+ line="1492">whether to reverse the swipe direction</doc>
33044+ <type name="gboolean" c:type="gboolean"/>
33045+ </parameter>
33046+ </parameters>
33047+ </method>
33048+ <method name="set_upper_overshoot"
33049+ c:identifier="adw_swipe_tracker_set_upper_overshoot"
33050+ glib:set-property="upper-overshoot"
33051+ version="1.4">
33052+ <doc xml:space="preserve"
33053+ filename="src/adw-swipe-tracker.c"
33054+ line="1658">Sets whether to allow swiping past the last available snap point.</doc>
33055+ <source-position filename="src/adw-swipe-tracker.h" line="64"/>
33056+ <return-value transfer-ownership="none">
33057+ <type name="none" c:type="void"/>
33058+ </return-value>
33059+ <parameters>
33060+ <instance-parameter name="self" transfer-ownership="none">
33061+ <doc xml:space="preserve"
33062+ filename="src/adw-swipe-tracker.c"
33063+ line="1660">a swipe tracker</doc>
33064+ <type name="SwipeTracker" c:type="AdwSwipeTracker*"/>
33065+ </instance-parameter>
33066+ <parameter name="overshoot" transfer-ownership="none">
33067+ <doc xml:space="preserve"
33068+ filename="src/adw-swipe-tracker.c"
33069+ line="1661">whether to allow swiping past the last available snap point</doc>
1956333070 <type name="gboolean" c:type="gboolean"/>
1956433071 </parameter>
1956533072 </parameters>
@@ -19568,11 +33075,11 @@ direction.</doc>
1956833075 c:identifier="adw_swipe_tracker_shift_position">
1956933076 <doc xml:space="preserve"
1957033077 filename="src/adw-swipe-tracker.c"
19571- line="1396">Moves the current progress value by @delta.
33078+ line="1728">Moves the current progress value by @delta.
1957233079
1957333080 This can be used to adjust the current position if snap points move during
1957433081 the gesture.</doc>
19575- <source-position filename="src/adw-swipe-tracker.h" line="56"/>
33082+ <source-position filename="src/adw-swipe-tracker.h" line="74"/>
1957633083 <return-value transfer-ownership="none">
1957733084 <type name="none" c:type="void"/>
1957833085 </return-value>
@@ -19580,13 +33087,13 @@ the gesture.</doc>
1958033087 <instance-parameter name="self" transfer-ownership="none">
1958133088 <doc xml:space="preserve"
1958233089 filename="src/adw-swipe-tracker.c"
19583- line="1398">a swipe tracker</doc>
33090+ line="1730">a swipe tracker</doc>
1958433091 <type name="SwipeTracker" c:type="AdwSwipeTracker*"/>
1958533092 </instance-parameter>
1958633093 <parameter name="delta" transfer-ownership="none">
1958733094 <doc xml:space="preserve"
1958833095 filename="src/adw-swipe-tracker.c"
19589- line="1399">the position delta</doc>
33096+ line="1731">the position delta</doc>
1959033097 <type name="gdouble" c:type="double"/>
1959133098 </parameter>
1959233099 </parameters>
@@ -19597,13 +33104,9 @@ the gesture.</doc>
1959733104 setter="set_allow_long_swipes"
1959833105 getter="get_allow_long_swipes"
1959933106 default-value="FALSE">
19600- <attribute name="org.gtk.Property.get"
19601- value="adw_swipe_tracker_get_allow_long_swipes"/>
19602- <attribute name="org.gtk.Property.set"
19603- value="adw_swipe_tracker_set_allow_long_swipes"/>
1960433107 <doc xml:space="preserve"
1960533108 filename="src/adw-swipe-tracker.c"
19606- line="1070">Whether to allow swiping for more than one snap point at a time.
33109+ line="1233">Whether to allow swiping for more than one snap point at a time.
1960733110
1960833111 If the value is `FALSE`, each swipe can only move to the adjacent snap
1960933112 points.</doc>
@@ -19615,13 +33118,23 @@ points.</doc>
1961533118 setter="set_allow_mouse_drag"
1961633119 getter="get_allow_mouse_drag"
1961733120 default-value="FALSE">
19618- <attribute name="org.gtk.Property.get"
19619- value="adw_swipe_tracker_get_allow_mouse_drag"/>
19620- <attribute name="org.gtk.Property.set"
19621- value="adw_swipe_tracker_set_allow_mouse_drag"/>
1962233121 <doc xml:space="preserve"
1962333122 filename="src/adw-swipe-tracker.c"
19624- line="1060">Whether to allow dragging with mouse pointer.</doc>
33123+ line="1223">Whether to allow dragging with mouse pointer.</doc>
33124+ <type name="gboolean" c:type="gboolean"/>
33125+ </property>
33126+ <property name="allow-window-handle"
33127+ version="1.5"
33128+ writable="1"
33129+ transfer-ownership="none"
33130+ setter="set_allow_window_handle"
33131+ getter="get_allow_window_handle"
33132+ default-value="FALSE">
33133+ <doc xml:space="preserve"
33134+ filename="src/adw-swipe-tracker.c"
33135+ line="1270">Whether to allow touchscreen swiping from `GtkWindowHandle`.
33136+
33137+This will make dragging the window impossible.</doc>
1962533138 <type name="gboolean" c:type="gboolean"/>
1962633139 </property>
1962733140 <property name="enabled"
@@ -19630,31 +33143,35 @@ points.</doc>
1963033143 setter="set_enabled"
1963133144 getter="get_enabled"
1963233145 default-value="TRUE">
19633- <attribute name="org.gtk.Property.get"
19634- value="adw_swipe_tracker_get_enabled"/>
19635- <attribute name="org.gtk.Property.set"
19636- value="adw_swipe_tracker_set_enabled"/>
1963733146 <doc xml:space="preserve"
1963833147 filename="src/adw-swipe-tracker.c"
19639- line="1034">Whether the swipe tracker is enabled.
33148+ line="1197">Whether the swipe tracker is enabled.
1964033149
1964133150 When it's not enabled, no events will be processed. Usually widgets will
1964233151 want to expose this via a property.</doc>
1964333152 <type name="gboolean" c:type="gboolean"/>
1964433153 </property>
33154+ <property name="lower-overshoot"
33155+ version="1.4"
33156+ writable="1"
33157+ transfer-ownership="none"
33158+ setter="set_lower_overshoot"
33159+ getter="get_lower_overshoot"
33160+ default-value="FALSE">
33161+ <doc xml:space="preserve"
33162+ filename="src/adw-swipe-tracker.c"
33163+ line="1246">Whether to allow swiping past the first available snap point.</doc>
33164+ <type name="gboolean" c:type="gboolean"/>
33165+ </property>
1964533166 <property name="reversed"
1964633167 writable="1"
1964733168 transfer-ownership="none"
1964833169 setter="set_reversed"
1964933170 getter="get_reversed"
1965033171 default-value="FALSE">
19651- <attribute name="org.gtk.Property.get"
19652- value="adw_swipe_tracker_get_reversed"/>
19653- <attribute name="org.gtk.Property.set"
19654- value="adw_swipe_tracker_set_reversed"/>
1965533172 <doc xml:space="preserve"
1965633173 filename="src/adw-swipe-tracker.c"
19657- line="1047">Whether to reverse the swipe direction.
33174+ line="1210">Whether to reverse the swipe direction.
1965833175
1965933176 If the swipe tracker is horizontal, it can be used for supporting RTL text
1966033177 direction.</doc>
@@ -19665,17 +33182,27 @@ direction.</doc>
1966533182 construct-only="1"
1966633183 transfer-ownership="none"
1966733184 getter="get_swipeable">
19668- <attribute name="org.gtk.Property.get"
19669- value="adw_swipe_tracker_get_swipeable"/>
1967033185 <doc xml:space="preserve"
1967133186 filename="src/adw-swipe-tracker.c"
19672- line="1024">The widget the swipe tracker is attached to.</doc>
33187+ line="1187">The widget the swipe tracker is attached to.</doc>
1967333188 <type name="Swipeable"/>
1967433189 </property>
33190+ <property name="upper-overshoot"
33191+ version="1.4"
33192+ writable="1"
33193+ transfer-ownership="none"
33194+ setter="set_upper_overshoot"
33195+ getter="get_upper_overshoot"
33196+ default-value="FALSE">
33197+ <doc xml:space="preserve"
33198+ filename="src/adw-swipe-tracker.c"
33199+ line="1258">Whether to allow swiping past the last available snap point.</doc>
33200+ <type name="gboolean" c:type="gboolean"/>
33201+ </property>
1967533202 <glib:signal name="begin-swipe" when="first">
1967633203 <doc xml:space="preserve"
1967733204 filename="src/adw-swipe-tracker.c"
19678- line="1113">This signal is emitted right before a swipe will be started, after the
33205+ line="1314">This signal is emitted right before a swipe will be started, after the
1967933206 drag threshold has been passed.</doc>
1968033207 <return-value transfer-ownership="none">
1968133208 <type name="none" c:type="void"/>
@@ -19684,7 +33211,7 @@ drag threshold has been passed.</doc>
1968433211 <glib:signal name="end-swipe" when="first">
1968533212 <doc xml:space="preserve"
1968633213 filename="src/adw-swipe-tracker.c"
19687- line="1153">This signal is emitted as soon as the gesture has stopped.
33214+ line="1354">This signal is emitted as soon as the gesture has stopped.
1968833215
1968933216 The user is expected to animate the deceleration from the current progress
1969033217 value to @to with an animation using @velocity as the initial velocity,
@@ -19697,13 +33224,13 @@ fit for this.</doc>
1969733224 <parameter name="velocity" transfer-ownership="none">
1969833225 <doc xml:space="preserve"
1969933226 filename="src/adw-swipe-tracker.c"
19700- line="1156">the velocity of the swipe</doc>
33227+ line="1357">the velocity of the swipe</doc>
1970133228 <type name="gdouble" c:type="gdouble"/>
1970233229 </parameter>
1970333230 <parameter name="to" transfer-ownership="none">
1970433231 <doc xml:space="preserve"
1970533232 filename="src/adw-swipe-tracker.c"
19706- line="1157">the progress value to animate to</doc>
33233+ line="1358">the progress value to animate to</doc>
1970733234 <type name="gdouble" c:type="gdouble"/>
1970833235 </parameter>
1970933236 </parameters>
@@ -19711,7 +33238,7 @@ fit for this.</doc>
1971133238 <glib:signal name="prepare" when="first">
1971233239 <doc xml:space="preserve"
1971333240 filename="src/adw-swipe-tracker.c"
19714- line="1089">This signal is emitted when a possible swipe is detected.
33241+ line="1290">This signal is emitted when a possible swipe is detected.
1971533242
1971633243 The @direction value can be used to restrict the swipe to a certain
1971733244 direction.</doc>
@@ -19722,7 +33249,7 @@ direction.</doc>
1972233249 <parameter name="direction" transfer-ownership="none">
1972333250 <doc xml:space="preserve"
1972433251 filename="src/adw-swipe-tracker.c"
19725- line="1092">the direction of the swipe</doc>
33252+ line="1293">the direction of the swipe</doc>
1972633253 <type name="NavigationDirection"/>
1972733254 </parameter>
1972833255 </parameters>
@@ -19730,7 +33257,7 @@ direction.</doc>
1973033257 <glib:signal name="update-swipe" when="first">
1973133258 <doc xml:space="preserve"
1973233259 filename="src/adw-swipe-tracker.c"
19733- line="1132">This signal is emitted every time the progress value changes.</doc>
33260+ line="1333">This signal is emitted every time the progress value changes.</doc>
1973433261 <return-value transfer-ownership="none">
1973533262 <type name="none" c:type="void"/>
1973633263 </return-value>
@@ -19738,7 +33265,7 @@ direction.</doc>
1973833265 <parameter name="progress" transfer-ownership="none">
1973933266 <doc xml:space="preserve"
1974033267 filename="src/adw-swipe-tracker.c"
19741- line="1135">the current animation progress value</doc>
33268+ line="1336">the current animation progress value</doc>
1974233269 <type name="gdouble" c:type="gdouble"/>
1974333270 </parameter>
1974433271 </parameters>
@@ -20069,6 +33596,9 @@ If not implemented, the default implementation returns the allocation of
2006933596 <type name="GObject.TypeInterface" c:type="GTypeInterface"/>
2007033597 </field>
2007133598 <field name="get_distance">
33599+ <doc xml:space="preserve"
33600+ filename="src/adw-swipeable.h"
33601+ line="28">Gets the swipe distance.</doc>
2007233602 <callback name="get_distance">
2007333603 <source-position filename="src/adw-swipeable.h" line="40"/>
2007433604 <return-value transfer-ownership="none">
@@ -20088,6 +33618,9 @@ If not implemented, the default implementation returns the allocation of
2008833618 </callback>
2008933619 </field>
2009033620 <field name="get_snap_points">
33621+ <doc xml:space="preserve"
33622+ filename="src/adw-swipeable.h"
33623+ line="29">Gets the snap points.</doc>
2009133624 <callback name="get_snap_points">
2009233625 <source-position filename="src/adw-swipeable.h" line="41"/>
2009333626 <return-value transfer-ownership="full">
@@ -20118,6 +33651,9 @@ If not implemented, the default implementation returns the allocation of
2011833651 </callback>
2011933652 </field>
2012033653 <field name="get_progress">
33654+ <doc xml:space="preserve"
33655+ filename="src/adw-swipeable.h"
33656+ line="30">Gets the current progress.</doc>
2012133657 <callback name="get_progress">
2012233658 <source-position filename="src/adw-swipeable.h" line="43"/>
2012333659 <return-value transfer-ownership="none">
@@ -20137,6 +33673,9 @@ If not implemented, the default implementation returns the allocation of
2013733673 </callback>
2013833674 </field>
2013933675 <field name="get_cancel_progress">
33676+ <doc xml:space="preserve"
33677+ filename="src/adw-swipeable.h"
33678+ line="31">Gets the cancel progress.</doc>
2014033679 <callback name="get_cancel_progress">
2014133680 <source-position filename="src/adw-swipeable.h" line="44"/>
2014233681 <return-value transfer-ownership="none">
@@ -20156,6 +33695,9 @@ If not implemented, the default implementation returns the allocation of
2015633695 </callback>
2015733696 </field>
2015833697 <field name="get_swipe_area">
33698+ <doc xml:space="preserve"
33699+ filename="src/adw-swipeable.h"
33700+ line="32">Gets the swipeable rectangle.</doc>
2015933701 <callback name="get_swipe_area">
2016033702 <source-position filename="src/adw-swipeable.h" line="45"/>
2016133703 <return-value transfer-ownership="none">
@@ -20199,6 +33741,134 @@ If not implemented, the default implementation returns the allocation of
2019933741 </array>
2020033742 </field>
2020133743 </record>
33744+ <class name="SwitchRow"
33745+ c:symbol-prefix="switch_row"
33746+ c:type="AdwSwitchRow"
33747+ version="1.4"
33748+ parent="ActionRow"
33749+ final="1"
33750+ glib:type-name="AdwSwitchRow"
33751+ glib:get-type="adw_switch_row_get_type"
33752+ glib:type-struct="SwitchRowClass">
33753+ <doc xml:space="preserve"
33754+ filename="src/adw-switch-row.c"
33755+ line="11">A [class@Gtk.ListBoxRow] used to represent two states.
33756+
33757+&lt;picture&gt;
33758+ &lt;source srcset="switch-row-dark.png" media="(prefers-color-scheme: dark)"&gt;
33759+ &lt;img src="switch-row.png" alt="switch-row"&gt;
33760+&lt;/picture&gt;
33761+
33762+The `AdwSwitchRow` widget contains a [class@Gtk.Switch] that allows the user
33763+to select between two states: "on" or "off". When activated, the row will
33764+invert its active state.
33765+
33766+The user can control the switch by activating the row or by dragging on the
33767+switch handle.
33768+
33769+See [class@Gtk.Switch] for details.
33770+
33771+Example of an `AdwSwitchRow` UI definition:
33772+```xml
33773+&lt;object class="AdwSwitchRow"&gt;
33774+ &lt;property name="title" translatable="yes"&gt;Switch Row&lt;/property&gt;
33775+ &lt;signal name="notify::active" handler="switch_row_notify_active_cb"/&gt;
33776+&lt;/object&gt;
33777+```
33778+
33779+The [property@SwitchRow:active] property should be connected to in order to
33780+monitor changes to the active state.
33781+
33782+## Accessibility
33783+
33784+`AdwSwitchRow` uses the `GTK_ACCESSIBLE_ROLE_SWITCH` role.</doc>
33785+ <source-position filename="src/adw-switch-row.h" line="22"/>
33786+ <implements name="Gtk.Accessible"/>
33787+ <implements name="Gtk.Actionable"/>
33788+ <implements name="Gtk.Buildable"/>
33789+ <implements name="Gtk.ConstraintTarget"/>
33790+ <constructor name="new" c:identifier="adw_switch_row_new" version="1.4">
33791+ <doc xml:space="preserve"
33792+ filename="src/adw-switch-row.c"
33793+ line="174">Creates a new `AdwSwitchRow`.</doc>
33794+ <source-position filename="src/adw-switch-row.h" line="25"/>
33795+ <return-value transfer-ownership="none">
33796+ <doc xml:space="preserve"
33797+ filename="src/adw-switch-row.c"
33798+ line="179">the newly created `AdwSwitchRow`</doc>
33799+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
33800+ </return-value>
33801+ </constructor>
33802+ <method name="get_active"
33803+ c:identifier="adw_switch_row_get_active"
33804+ glib:get-property="active"
33805+ version="1.4">
33806+ <doc xml:space="preserve"
33807+ filename="src/adw-switch-row.c"
33808+ line="189">Gets whether @self is in its "on" or "off" position.</doc>
33809+ <source-position filename="src/adw-switch-row.h" line="28"/>
33810+ <return-value transfer-ownership="none">
33811+ <doc xml:space="preserve"
33812+ filename="src/adw-switch-row.c"
33813+ line="195">whether @self is active or not</doc>
33814+ <type name="gboolean" c:type="gboolean"/>
33815+ </return-value>
33816+ <parameters>
33817+ <instance-parameter name="self" transfer-ownership="none">
33818+ <doc xml:space="preserve"
33819+ filename="src/adw-switch-row.c"
33820+ line="191">a switch row</doc>
33821+ <type name="SwitchRow" c:type="AdwSwitchRow*"/>
33822+ </instance-parameter>
33823+ </parameters>
33824+ </method>
33825+ <method name="set_active"
33826+ c:identifier="adw_switch_row_set_active"
33827+ glib:set-property="active"
33828+ version="1.4">
33829+ <doc xml:space="preserve"
33830+ filename="src/adw-switch-row.c"
33831+ line="207">Sets whether @self is in its "on" or "off" position</doc>
33832+ <source-position filename="src/adw-switch-row.h" line="30"/>
33833+ <return-value transfer-ownership="none">
33834+ <type name="none" c:type="void"/>
33835+ </return-value>
33836+ <parameters>
33837+ <instance-parameter name="self" transfer-ownership="none">
33838+ <doc xml:space="preserve"
33839+ filename="src/adw-switch-row.c"
33840+ line="209">a switch row</doc>
33841+ <type name="SwitchRow" c:type="AdwSwitchRow*"/>
33842+ </instance-parameter>
33843+ <parameter name="is_active" transfer-ownership="none">
33844+ <doc xml:space="preserve"
33845+ filename="src/adw-switch-row.c"
33846+ line="210">whether @self should be active</doc>
33847+ <type name="gboolean" c:type="gboolean"/>
33848+ </parameter>
33849+ </parameters>
33850+ </method>
33851+ <property name="active"
33852+ version="1.4"
33853+ writable="1"
33854+ transfer-ownership="none"
33855+ setter="set_active"
33856+ getter="get_active"
33857+ default-value="FALSE">
33858+ <doc xml:space="preserve"
33859+ filename="src/adw-switch-row.c"
33860+ line="133">Whether the switch row is in the "on" or "off" position.</doc>
33861+ <type name="gboolean" c:type="gboolean"/>
33862+ </property>
33863+ </class>
33864+ <record name="SwitchRowClass"
33865+ c:type="AdwSwitchRowClass"
33866+ glib:is-gtype-struct-for="SwitchRow">
33867+ <source-position filename="src/adw-switch-row.h" line="22"/>
33868+ <field name="parent_class">
33869+ <type name="ActionRowClass" c:type="AdwActionRowClass"/>
33870+ </field>
33871+ </record>
2020233872 <class name="TabBar"
2020333873 c:symbol-prefix="tab_bar"
2020433874 c:type="AdwTabBar"
@@ -20217,7 +33887,7 @@ If not implemented, the default implementation returns the allocation of
2021733887 &lt;/picture&gt;
2021833888
2021933889 The `AdwTabBar` widget is a tab bar that can be used with conjunction with
20220-`AdwTabView`.
33890+`AdwTabView`. It is typically used as a top bar within [class@ToolbarView].
2022133891
2022233892 `AdwTabBar` can autohide and can optionally contain action widgets on both
2022333893 sides of the tabs.
@@ -20228,7 +33898,19 @@ area.
2022833898
2022933899 ## CSS nodes
2023033900
20231-`AdwTabBar` has a single CSS node with name `tabbar`.</doc>
33901+`AdwTabBar` has a single CSS node with name `tabbar`.
33902+
33903+## Style classes
33904+
33905+By default `AdwTabBar` look like a part of an `AdwHeaderBar` and is intended
33906+to be used directly attached to one or used as a [class@ToolbarView] toolbar.
33907+The [`.inline`](style-classes.html#inline) style class removes its background,
33908+so that it can be used in different contexts instead.
33909+
33910+&lt;picture&gt;
33911+ &lt;source srcset="tab-bar-inline-dark.png" media="(prefers-color-scheme: dark)"&gt;
33912+ &lt;img src="tab-bar-inline.png" alt="tab-bar-inline"&gt;
33913+&lt;/picture&gt;</doc>
2023233914 <source-position filename="src/adw-tab-bar.h" line="26"/>
2023333915 <implements name="Gtk.Accessible"/>
2023433916 <implements name="Gtk.Buildable"/>
@@ -20236,34 +33918,33 @@ area.
2023633918 <constructor name="new" c:identifier="adw_tab_bar_new">
2023733919 <doc xml:space="preserve"
2023833920 filename="src/adw-tab-bar.c"
20239- line="690">Creates a new `AdwTabBar`.</doc>
33921+ line="747">Creates a new `AdwTabBar`.</doc>
2024033922 <source-position filename="src/adw-tab-bar.h" line="29"/>
2024133923 <return-value transfer-ownership="none">
2024233924 <doc xml:space="preserve"
2024333925 filename="src/adw-tab-bar.c"
20244- line="695">the newly created `AdwTabBar`</doc>
33926+ line="752">the newly created `AdwTabBar`</doc>
2024533927 <type name="TabBar" c:type="AdwTabBar*"/>
2024633928 </return-value>
2024733929 </constructor>
2024833930 <method name="get_autohide"
2024933931 c:identifier="adw_tab_bar_get_autohide"
2025033932 glib:get-property="autohide">
20251- <attribute name="org.gtk.Method.get_property" value="autohide"/>
2025233933 <doc xml:space="preserve"
2025333934 filename="src/adw-tab-bar.c"
20254- line="881">Gets whether the tabs automatically hide.</doc>
33935+ line="938">Gets whether the tabs automatically hide.</doc>
2025533936 <source-position filename="src/adw-tab-bar.h" line="50"/>
2025633937 <return-value transfer-ownership="none">
2025733938 <doc xml:space="preserve"
2025833939 filename="src/adw-tab-bar.c"
20259- line="887">whether the tabs automatically hide</doc>
33940+ line="944">whether the tabs automatically hide</doc>
2026033941 <type name="gboolean" c:type="gboolean"/>
2026133942 </return-value>
2026233943 <parameters>
2026333944 <instance-parameter name="self" transfer-ownership="none">
2026433945 <doc xml:space="preserve"
2026533946 filename="src/adw-tab-bar.c"
20266- line="883">a tab bar</doc>
33947+ line="940">a tab bar</doc>
2026733948 <type name="TabBar" c:type="AdwTabBar*"/>
2026833949 </instance-parameter>
2026933950 </parameters>
@@ -20271,23 +33952,21 @@ area.
2027133952 <method name="get_end_action_widget"
2027233953 c:identifier="adw_tab_bar_get_end_action_widget"
2027333954 glib:get-property="end-action-widget">
20274- <attribute name="org.gtk.Method.get_property"
20275- value="end-action-widget"/>
2027633955 <doc xml:space="preserve"
2027733956 filename="src/adw-tab-bar.c"
20278- line="838">Gets the widget shown after the tabs.</doc>
33957+ line="895">Gets the widget shown after the tabs.</doc>
2027933958 <source-position filename="src/adw-tab-bar.h" line="44"/>
2028033959 <return-value transfer-ownership="none" nullable="1">
2028133960 <doc xml:space="preserve"
2028233961 filename="src/adw-tab-bar.c"
20283- line="844">the widget shown after the tabs</doc>
33962+ line="901">the widget shown after the tabs</doc>
2028433963 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2028533964 </return-value>
2028633965 <parameters>
2028733966 <instance-parameter name="self" transfer-ownership="none">
2028833967 <doc xml:space="preserve"
2028933968 filename="src/adw-tab-bar.c"
20290- line="840">a tab bar</doc>
33969+ line="897">a tab bar</doc>
2029133970 <type name="TabBar" c:type="AdwTabBar*"/>
2029233971 </instance-parameter>
2029333972 </parameters>
@@ -20295,22 +33974,44 @@ area.
2029533974 <method name="get_expand_tabs"
2029633975 c:identifier="adw_tab_bar_get_expand_tabs"
2029733976 glib:get-property="expand-tabs">
20298- <attribute name="org.gtk.Method.get_property" value="expand-tabs"/>
2029933977 <doc xml:space="preserve"
2030033978 filename="src/adw-tab-bar.c"
20301- line="945">Gets whether tabs expand to full width.</doc>
33979+ line="1002">Gets whether tabs expand to full width.</doc>
2030233980 <source-position filename="src/adw-tab-bar.h" line="59"/>
2030333981 <return-value transfer-ownership="none">
2030433982 <doc xml:space="preserve"
2030533983 filename="src/adw-tab-bar.c"
20306- line="951">whether tabs expand to full width.</doc>
33984+ line="1008">whether tabs expand to full width.</doc>
2030733985 <type name="gboolean" c:type="gboolean"/>
2030833986 </return-value>
2030933987 <parameters>
2031033988 <instance-parameter name="self" transfer-ownership="none">
2031133989 <doc xml:space="preserve"
2031233990 filename="src/adw-tab-bar.c"
20313- line="947">a tab bar</doc>
33991+ line="1004">a tab bar</doc>
33992+ <type name="TabBar" c:type="AdwTabBar*"/>
33993+ </instance-parameter>
33994+ </parameters>
33995+ </method>
33996+ <method name="get_extra_drag_preferred_action"
33997+ c:identifier="adw_tab_bar_get_extra_drag_preferred_action"
33998+ glib:get-property="extra-drag-preferred-action"
33999+ version="1.4">
34000+ <doc xml:space="preserve"
34001+ filename="src/adw-tab-bar.c"
34002+ line="1119">Gets the current action during a drop on the extra_drop_target.</doc>
34003+ <source-position filename="src/adw-tab-bar.h" line="77"/>
34004+ <return-value transfer-ownership="none">
34005+ <doc xml:space="preserve"
34006+ filename="src/adw-tab-bar.c"
34007+ line="1125">the drag action of the current drop.</doc>
34008+ <type name="Gdk.DragAction" c:type="GdkDragAction"/>
34009+ </return-value>
34010+ <parameters>
34011+ <instance-parameter name="self" transfer-ownership="none">
34012+ <doc xml:space="preserve"
34013+ filename="src/adw-tab-bar.c"
34014+ line="1121">a tab bar</doc>
2031434015 <type name="TabBar" c:type="AdwTabBar*"/>
2031534016 </instance-parameter>
2031634017 </parameters>
@@ -20321,19 +34022,19 @@ area.
2032134022 version="1.3">
2032234023 <doc xml:space="preserve"
2032334024 filename="src/adw-tab-bar.c"
20324- line="1062">Gets whether drop data should be preloaded on hover.</doc>
20325- <source-position filename="src/adw-tab-bar.h" line="77"/>
34025+ line="1137">Gets whether drop data should be preloaded on hover.</doc>
34026+ <source-position filename="src/adw-tab-bar.h" line="80"/>
2032634027 <return-value transfer-ownership="none">
2032734028 <doc xml:space="preserve"
2032834029 filename="src/adw-tab-bar.c"
20329- line="1068">whether drop data should be preloaded on hover</doc>
34030+ line="1143">whether drop data should be preloaded on hover</doc>
2033034031 <type name="gboolean" c:type="gboolean"/>
2033134032 </return-value>
2033234033 <parameters>
2033334034 <instance-parameter name="self" transfer-ownership="none">
2033434035 <doc xml:space="preserve"
2033534036 filename="src/adw-tab-bar.c"
20336- line="1064">a tab bar</doc>
34037+ line="1139">a tab bar</doc>
2033734038 <type name="TabBar" c:type="AdwTabBar*"/>
2033834039 </instance-parameter>
2033934040 </parameters>
@@ -20341,22 +34042,21 @@ area.
2034134042 <method name="get_inverted"
2034234043 c:identifier="adw_tab_bar_get_inverted"
2034334044 glib:get-property="inverted">
20344- <attribute name="org.gtk.Method.get_property" value="inverted"/>
2034534045 <doc xml:space="preserve"
2034634046 filename="src/adw-tab-bar.c"
20347- line="987">Gets whether tabs use inverted layout.</doc>
34047+ line="1044">Gets whether tabs use inverted layout.</doc>
2034834048 <source-position filename="src/adw-tab-bar.h" line="65"/>
2034934049 <return-value transfer-ownership="none">
2035034050 <doc xml:space="preserve"
2035134051 filename="src/adw-tab-bar.c"
20352- line="993">whether tabs use inverted layout</doc>
34052+ line="1050">whether tabs use inverted layout</doc>
2035334053 <type name="gboolean" c:type="gboolean"/>
2035434054 </return-value>
2035534055 <parameters>
2035634056 <instance-parameter name="self" transfer-ownership="none">
2035734057 <doc xml:space="preserve"
2035834058 filename="src/adw-tab-bar.c"
20359- line="989">a tab bar</doc>
34059+ line="1046">a tab bar</doc>
2036034060 <type name="TabBar" c:type="AdwTabBar*"/>
2036134061 </instance-parameter>
2036234062 </parameters>
@@ -20364,24 +34064,23 @@ area.
2036434064 <method name="get_is_overflowing"
2036534065 c:identifier="adw_tab_bar_get_is_overflowing"
2036634066 glib:get-property="is-overflowing">
20367- <attribute name="org.gtk.Method.get_property" value="is-overflowing"/>
2036834067 <doc xml:space="preserve"
2036934068 filename="src/adw-tab-bar.c"
20370- line="1106">Gets whether @self is overflowing.
34069+ line="1181">Gets whether @self is overflowing.
2037134070
2037234071 If `TRUE`, all tabs cannot be displayed at once and require scrolling.</doc>
20373- <source-position filename="src/adw-tab-bar.h" line="83"/>
34072+ <source-position filename="src/adw-tab-bar.h" line="86"/>
2037434073 <return-value transfer-ownership="none">
2037534074 <doc xml:space="preserve"
2037634075 filename="src/adw-tab-bar.c"
20377- line="1114">whether @self is overflowing</doc>
34076+ line="1189">whether @self is overflowing</doc>
2037834077 <type name="gboolean" c:type="gboolean"/>
2037934078 </return-value>
2038034079 <parameters>
2038134080 <instance-parameter name="self" transfer-ownership="none">
2038234081 <doc xml:space="preserve"
2038334082 filename="src/adw-tab-bar.c"
20384- line="1108">a tab bar</doc>
34083+ line="1183">a tab bar</doc>
2038534084 <type name="TabBar" c:type="AdwTabBar*"/>
2038634085 </instance-parameter>
2038734086 </parameters>
@@ -20389,23 +34088,21 @@ If `TRUE`, all tabs cannot be displayed at once and require scrolling.</doc>
2038934088 <method name="get_start_action_widget"
2039034089 c:identifier="adw_tab_bar_get_start_action_widget"
2039134090 glib:get-property="start-action-widget">
20392- <attribute name="org.gtk.Method.get_property"
20393- value="start-action-widget"/>
2039434091 <doc xml:space="preserve"
2039534092 filename="src/adw-tab-bar.c"
20396- line="795">Gets the widget shown before the tabs.</doc>
34093+ line="852">Gets the widget shown before the tabs.</doc>
2039734094 <source-position filename="src/adw-tab-bar.h" line="38"/>
2039834095 <return-value transfer-ownership="none" nullable="1">
2039934096 <doc xml:space="preserve"
2040034097 filename="src/adw-tab-bar.c"
20401- line="801">the widget shown before the tabs</doc>
34098+ line="858">the widget shown before the tabs</doc>
2040234099 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2040334100 </return-value>
2040434101 <parameters>
2040534102 <instance-parameter name="self" transfer-ownership="none">
2040634103 <doc xml:space="preserve"
2040734104 filename="src/adw-tab-bar.c"
20408- line="797">a tab bar</doc>
34105+ line="854">a tab bar</doc>
2040934106 <type name="TabBar" c:type="AdwTabBar*"/>
2041034107 </instance-parameter>
2041134108 </parameters>
@@ -20413,24 +34110,23 @@ If `TRUE`, all tabs cannot be displayed at once and require scrolling.</doc>
2041334110 <method name="get_tabs_revealed"
2041434111 c:identifier="adw_tab_bar_get_tabs_revealed"
2041534112 glib:get-property="tabs-revealed">
20416- <attribute name="org.gtk.Method.get_property" value="tabs-revealed"/>
2041734113 <doc xml:space="preserve"
2041834114 filename="src/adw-tab-bar.c"
20419- line="927">Gets whether the tabs are currently revealed.
34115+ line="984">Gets whether the tabs are currently revealed.
2042034116
2042134117 See [property@TabBar:autohide].</doc>
2042234118 <source-position filename="src/adw-tab-bar.h" line="56"/>
2042334119 <return-value transfer-ownership="none">
2042434120 <doc xml:space="preserve"
2042534121 filename="src/adw-tab-bar.c"
20426- line="935">whether the tabs are currently revealed</doc>
34122+ line="992">whether the tabs are currently revealed</doc>
2042734123 <type name="gboolean" c:type="gboolean"/>
2042834124 </return-value>
2042934125 <parameters>
2043034126 <instance-parameter name="self" transfer-ownership="none">
2043134127 <doc xml:space="preserve"
2043234128 filename="src/adw-tab-bar.c"
20433- line="929">a tab bar</doc>
34129+ line="986">a tab bar</doc>
2043434130 <type name="TabBar" c:type="AdwTabBar*"/>
2043534131 </instance-parameter>
2043634132 </parameters>
@@ -20438,22 +34134,21 @@ See [property@TabBar:autohide].</doc>
2043834134 <method name="get_view"
2043934135 c:identifier="adw_tab_bar_get_view"
2044034136 glib:get-property="view">
20441- <attribute name="org.gtk.Method.get_property" value="view"/>
2044234137 <doc xml:space="preserve"
2044334138 filename="src/adw-tab-bar.c"
20444- line="703">Gets the tab view @self controls.</doc>
34139+ line="760">Gets the tab view @self controls.</doc>
2044534140 <source-position filename="src/adw-tab-bar.h" line="32"/>
2044634141 <return-value transfer-ownership="none" nullable="1">
2044734142 <doc xml:space="preserve"
2044834143 filename="src/adw-tab-bar.c"
20449- line="709">the view @self controls</doc>
34144+ line="766">the view @self controls</doc>
2045034145 <type name="TabView" c:type="AdwTabView*"/>
2045134146 </return-value>
2045234147 <parameters>
2045334148 <instance-parameter name="self" transfer-ownership="none">
2045434149 <doc xml:space="preserve"
2045534150 filename="src/adw-tab-bar.c"
20456- line="705">a tab bar</doc>
34151+ line="762">a tab bar</doc>
2045734152 <type name="TabBar" c:type="AdwTabBar*"/>
2045834153 </instance-parameter>
2045934154 </parameters>
@@ -20461,10 +34156,9 @@ See [property@TabBar:autohide].</doc>
2046134156 <method name="set_autohide"
2046234157 c:identifier="adw_tab_bar_set_autohide"
2046334158 glib:set-property="autohide">
20464- <attribute name="org.gtk.Method.set_property" value="autohide"/>
2046534159 <doc xml:space="preserve"
2046634160 filename="src/adw-tab-bar.c"
20467- line="897">Sets whether the tabs automatically hide.
34161+ line="954">Sets whether the tabs automatically hide.
2046834162
2046934163 If set to `TRUE`, the tab bar disappears when [property@TabBar:view] has 0
2047034164 or 1 tab, no pinned tabs, and no tab is being transferred.
@@ -20478,13 +34172,13 @@ See [property@TabBar:tabs-revealed].</doc>
2047834172 <instance-parameter name="self" transfer-ownership="none">
2047934173 <doc xml:space="preserve"
2048034174 filename="src/adw-tab-bar.c"
20481- line="899">a tab bar</doc>
34175+ line="956">a tab bar</doc>
2048234176 <type name="TabBar" c:type="AdwTabBar*"/>
2048334177 </instance-parameter>
2048434178 <parameter name="autohide" transfer-ownership="none">
2048534179 <doc xml:space="preserve"
2048634180 filename="src/adw-tab-bar.c"
20487- line="900">whether the tabs automatically hide</doc>
34181+ line="957">whether the tabs automatically hide</doc>
2048834182 <type name="gboolean" c:type="gboolean"/>
2048934183 </parameter>
2049034184 </parameters>
@@ -20492,11 +34186,9 @@ See [property@TabBar:tabs-revealed].</doc>
2049234186 <method name="set_end_action_widget"
2049334187 c:identifier="adw_tab_bar_set_end_action_widget"
2049434188 glib:set-property="end-action-widget">
20495- <attribute name="org.gtk.Method.set_property"
20496- value="end-action-widget"/>
2049734189 <doc xml:space="preserve"
2049834190 filename="src/adw-tab-bar.c"
20499- line="854">Sets the widget to show after the tabs.</doc>
34191+ line="911">Sets the widget to show after the tabs.</doc>
2050034192 <source-position filename="src/adw-tab-bar.h" line="46"/>
2050134193 <return-value transfer-ownership="none">
2050234194 <type name="none" c:type="void"/>
@@ -20505,7 +34197,7 @@ See [property@TabBar:tabs-revealed].</doc>
2050534197 <instance-parameter name="self" transfer-ownership="none">
2050634198 <doc xml:space="preserve"
2050734199 filename="src/adw-tab-bar.c"
20508- line="856">a tab bar</doc>
34200+ line="913">a tab bar</doc>
2050934201 <type name="TabBar" c:type="AdwTabBar*"/>
2051034202 </instance-parameter>
2051134203 <parameter name="widget"
@@ -20514,7 +34206,7 @@ See [property@TabBar:tabs-revealed].</doc>
2051434206 allow-none="1">
2051534207 <doc xml:space="preserve"
2051634208 filename="src/adw-tab-bar.c"
20517- line="857">the widget to show after the tabs</doc>
34209+ line="914">the widget to show after the tabs</doc>
2051834210 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2051934211 </parameter>
2052034212 </parameters>
@@ -20522,10 +34214,9 @@ See [property@TabBar:tabs-revealed].</doc>
2052234214 <method name="set_expand_tabs"
2052334215 c:identifier="adw_tab_bar_set_expand_tabs"
2052434216 glib:set-property="expand-tabs">
20525- <attribute name="org.gtk.Method.set_property" value="expand-tabs"/>
2052634217 <doc xml:space="preserve"
2052734218 filename="src/adw-tab-bar.c"
20528- line="961">Sets whether tabs expand to full width.
34219+ line="1018">Sets whether tabs expand to full width.
2052934220
2053034221 If set to `TRUE`, the tabs will always vary width filling the whole width
2053134222 when possible, otherwise tabs will always have the minimum possible size.</doc>
@@ -20537,13 +34228,13 @@ when possible, otherwise tabs will always have the minimum possible size.</doc>
2053734228 <instance-parameter name="self" transfer-ownership="none">
2053834229 <doc xml:space="preserve"
2053934230 filename="src/adw-tab-bar.c"
20540- line="963">a tab bar</doc>
34231+ line="1020">a tab bar</doc>
2054134232 <type name="TabBar" c:type="AdwTabBar*"/>
2054234233 </instance-parameter>
2054334234 <parameter name="expand_tabs" transfer-ownership="none">
2054434235 <doc xml:space="preserve"
2054534236 filename="src/adw-tab-bar.c"
20546- line="964">whether to expand tabs</doc>
34237+ line="1021">whether to expand tabs</doc>
2054734238 <type name="gboolean" c:type="gboolean"/>
2054834239 </parameter>
2054934240 </parameters>
@@ -20554,10 +34245,10 @@ when possible, otherwise tabs will always have the minimum possible size.</doc>
2055434245 version="1.3">
2055534246 <doc xml:space="preserve"
2055634247 filename="src/adw-tab-bar.c"
20557- line="1080">Sets whether drop data should be preloaded on hover.
34248+ line="1155">Sets whether drop data should be preloaded on hover.
2055834249
2055934250 See [property@Gtk.DropTarget:preload].</doc>
20560- <source-position filename="src/adw-tab-bar.h" line="79"/>
34251+ <source-position filename="src/adw-tab-bar.h" line="82"/>
2056134252 <return-value transfer-ownership="none">
2056234253 <type name="none" c:type="void"/>
2056334254 </return-value>
@@ -20565,13 +34256,13 @@ See [property@Gtk.DropTarget:preload].</doc>
2056534256 <instance-parameter name="self" transfer-ownership="none">
2056634257 <doc xml:space="preserve"
2056734258 filename="src/adw-tab-bar.c"
20568- line="1082">a tab bar</doc>
34259+ line="1157">a tab bar</doc>
2056934260 <type name="TabBar" c:type="AdwTabBar*"/>
2057034261 </instance-parameter>
2057134262 <parameter name="preload" transfer-ownership="none">
2057234263 <doc xml:space="preserve"
2057334264 filename="src/adw-tab-bar.c"
20574- line="1083">whether to preload drop data</doc>
34265+ line="1158">whether to preload drop data</doc>
2057534266 <type name="gboolean" c:type="gboolean"/>
2057634267 </parameter>
2057734268 </parameters>
@@ -20579,10 +34270,9 @@ See [property@Gtk.DropTarget:preload].</doc>
2057934270 <method name="set_inverted"
2058034271 c:identifier="adw_tab_bar_set_inverted"
2058134272 glib:set-property="inverted">
20582- <attribute name="org.gtk.Method.set_property" value="inverted"/>
2058334273 <doc xml:space="preserve"
2058434274 filename="src/adw-tab-bar.c"
20585- line="1003">Sets whether tabs tabs use inverted layout.
34275+ line="1060">Sets whether tabs tabs use inverted layout.
2058634276
2058734277 If set to `TRUE`, non-pinned tabs will have the close button at the beginning
2058834278 and the indicator at the end rather than the opposite.</doc>
@@ -20594,13 +34284,13 @@ and the indicator at the end rather than the opposite.</doc>
2059434284 <instance-parameter name="self" transfer-ownership="none">
2059534285 <doc xml:space="preserve"
2059634286 filename="src/adw-tab-bar.c"
20597- line="1005">a tab bar</doc>
34287+ line="1062">a tab bar</doc>
2059834288 <type name="TabBar" c:type="AdwTabBar*"/>
2059934289 </instance-parameter>
2060034290 <parameter name="inverted" transfer-ownership="none">
2060134291 <doc xml:space="preserve"
2060234292 filename="src/adw-tab-bar.c"
20603- line="1006">whether tabs use inverted layout</doc>
34293+ line="1063">whether tabs use inverted layout</doc>
2060434294 <type name="gboolean" c:type="gboolean"/>
2060534295 </parameter>
2060634296 </parameters>
@@ -20608,11 +34298,9 @@ and the indicator at the end rather than the opposite.</doc>
2060834298 <method name="set_start_action_widget"
2060934299 c:identifier="adw_tab_bar_set_start_action_widget"
2061034300 glib:set-property="start-action-widget">
20611- <attribute name="org.gtk.Method.set_property"
20612- value="start-action-widget"/>
2061334301 <doc xml:space="preserve"
2061434302 filename="src/adw-tab-bar.c"
20615- line="811">Sets the widget to show before the tabs.</doc>
34303+ line="868">Sets the widget to show before the tabs.</doc>
2061634304 <source-position filename="src/adw-tab-bar.h" line="40"/>
2061734305 <return-value transfer-ownership="none">
2061834306 <type name="none" c:type="void"/>
@@ -20621,7 +34309,7 @@ and the indicator at the end rather than the opposite.</doc>
2062134309 <instance-parameter name="self" transfer-ownership="none">
2062234310 <doc xml:space="preserve"
2062334311 filename="src/adw-tab-bar.c"
20624- line="813">a tab bar</doc>
34312+ line="870">a tab bar</doc>
2062534313 <type name="TabBar" c:type="AdwTabBar*"/>
2062634314 </instance-parameter>
2062734315 <parameter name="widget"
@@ -20630,7 +34318,7 @@ and the indicator at the end rather than the opposite.</doc>
2063034318 allow-none="1">
2063134319 <doc xml:space="preserve"
2063234320 filename="src/adw-tab-bar.c"
20633- line="814">the widget to show before the tabs</doc>
34321+ line="871">the widget to show before the tabs</doc>
2063434322 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2063534323 </parameter>
2063634324 </parameters>
@@ -20638,10 +34326,9 @@ and the indicator at the end rather than the opposite.</doc>
2063834326 <method name="set_view"
2063934327 c:identifier="adw_tab_bar_set_view"
2064034328 glib:set-property="view">
20641- <attribute name="org.gtk.Method.set_property" value="view"/>
2064234329 <doc xml:space="preserve"
2064334330 filename="src/adw-tab-bar.c"
20644- line="719">Sets the tab view @self controls.</doc>
34331+ line="776">Sets the tab view @self controls.</doc>
2064534332 <source-position filename="src/adw-tab-bar.h" line="34"/>
2064634333 <return-value transfer-ownership="none">
2064734334 <type name="none" c:type="void"/>
@@ -20650,7 +34337,7 @@ and the indicator at the end rather than the opposite.</doc>
2065034337 <instance-parameter name="self" transfer-ownership="none">
2065134338 <doc xml:space="preserve"
2065234339 filename="src/adw-tab-bar.c"
20653- line="721">a tab bar</doc>
34340+ line="778">a tab bar</doc>
2065434341 <type name="TabBar" c:type="AdwTabBar*"/>
2065534342 </instance-parameter>
2065634343 <parameter name="view"
@@ -20659,7 +34346,7 @@ and the indicator at the end rather than the opposite.</doc>
2065934346 allow-none="1">
2066034347 <doc xml:space="preserve"
2066134348 filename="src/adw-tab-bar.c"
20662- line="722">a tab view</doc>
34349+ line="779">a tab view</doc>
2066334350 <type name="TabView" c:type="AdwTabView*"/>
2066434351 </parameter>
2066534352 </parameters>
@@ -20668,7 +34355,7 @@ and the indicator at the end rather than the opposite.</doc>
2066834355 c:identifier="adw_tab_bar_setup_extra_drop_target">
2066934356 <doc xml:space="preserve"
2067034357 filename="src/adw-tab-bar.c"
20671- line="1029">Sets the supported types for this drop target.
34358+ line="1086">Sets the supported types for this drop target.
2067234359
2067334360 Sets up an extra drop target on tabs.
2067434361
@@ -20687,13 +34374,13 @@ The [signal@TabBar::extra-drag-drop] signal can be used to handle the drop.</doc
2068734374 <instance-parameter name="self" transfer-ownership="none">
2068834375 <doc xml:space="preserve"
2068934376 filename="src/adw-tab-bar.c"
20690- line="1031">a tab bar</doc>
34377+ line="1088">a tab bar</doc>
2069134378 <type name="TabBar" c:type="AdwTabBar*"/>
2069234379 </instance-parameter>
2069334380 <parameter name="actions" transfer-ownership="none">
2069434381 <doc xml:space="preserve"
2069534382 filename="src/adw-tab-bar.c"
20696- line="1032">the supported actions</doc>
34383+ line="1089">the supported actions</doc>
2069734384 <type name="Gdk.DragAction" c:type="GdkDragAction"/>
2069834385 </parameter>
2069934386 <parameter name="types"
@@ -20702,7 +34389,7 @@ The [signal@TabBar::extra-drag-drop] signal can be used to handle the drop.</doc
2070234389 allow-none="1">
2070334390 <doc xml:space="preserve"
2070434391 filename="src/adw-tab-bar.c"
20705- line="1033">
34392+ line="1090">
2070634393 all supported `GType`s that can be dropped</doc>
2070734394 <array length="2" zero-terminated="0" c:type="GType*">
2070834395 <type name="GType" c:type="GType"/>
@@ -20711,7 +34398,7 @@ The [signal@TabBar::extra-drag-drop] signal can be used to handle the drop.</doc
2071134398 <parameter name="n_types" transfer-ownership="none">
2071234399 <doc xml:space="preserve"
2071334400 filename="src/adw-tab-bar.c"
20714- line="1035">number of @types</doc>
34401+ line="1092">number of @types</doc>
2071534402 <type name="gsize" c:type="gsize"/>
2071634403 </parameter>
2071734404 </parameters>
@@ -20722,13 +34409,9 @@ The [signal@TabBar::extra-drag-drop] signal can be used to handle the drop.</doc
2072234409 setter="set_autohide"
2072334410 getter="get_autohide"
2072434411 default-value="TRUE">
20725- <attribute name="org.gtk.Property.get"
20726- value="adw_tab_bar_get_autohide"/>
20727- <attribute name="org.gtk.Property.set"
20728- value="adw_tab_bar_set_autohide"/>
2072934412 <doc xml:space="preserve"
2073034413 filename="src/adw-tab-bar.c"
20731- line="462">Whether the tabs automatically hide.
34414+ line="493">Whether the tabs automatically hide.
2073234415
2073334416 If set to `TRUE`, the tab bar disappears when [property@TabBar:view] has 0
2073434417 or 1 tab, no pinned tabs, and no tab is being transferred.
@@ -20741,13 +34424,9 @@ See [property@TabBar:tabs-revealed].</doc>
2074134424 transfer-ownership="none"
2074234425 setter="set_end_action_widget"
2074334426 getter="get_end_action_widget">
20744- <attribute name="org.gtk.Property.get"
20745- value="adw_tab_bar_get_end_action_widget"/>
20746- <attribute name="org.gtk.Property.set"
20747- value="adw_tab_bar_set_end_action_widget"/>
2074834427 <doc xml:space="preserve"
2074934428 filename="src/adw-tab-bar.c"
20750- line="452">The widget shown after the tabs.</doc>
34429+ line="483">The widget shown after the tabs.</doc>
2075134430 <type name="Gtk.Widget"/>
2075234431 </property>
2075334432 <property name="expand-tabs"
@@ -20756,18 +34435,29 @@ See [property@TabBar:tabs-revealed].</doc>
2075634435 setter="set_expand_tabs"
2075734436 getter="get_expand_tabs"
2075834437 default-value="TRUE">
20759- <attribute name="org.gtk.Property.get"
20760- value="adw_tab_bar_get_expand_tabs"/>
20761- <attribute name="org.gtk.Property.set"
20762- value="adw_tab_bar_set_expand_tabs"/>
2076334438 <doc xml:space="preserve"
2076434439 filename="src/adw-tab-bar.c"
20765- line="489">Whether tabs expand to full width.
34440+ line="520">Whether tabs expand to full width.
2076634441
2076734442 If set to `TRUE`, the tabs will always vary width filling the whole width
2076834443 when possible, otherwise tabs will always have the minimum possible size.</doc>
2076934444 <type name="gboolean" c:type="gboolean"/>
2077034445 </property>
34446+ <property name="extra-drag-preferred-action"
34447+ version="1.4"
34448+ transfer-ownership="none"
34449+ getter="get_extra_drag_preferred_action"
34450+ default-value="0">
34451+ <doc xml:space="preserve"
34452+ filename="src/adw-tab-bar.c"
34453+ line="558">The unique action on the `current-drop` of the
34454+[signal@TabBar::extra-drag-drop].
34455+
34456+This property should only be used during a [signal@TabBar::extra-drag-drop]
34457+and is always a subset of what was originally passed to
34458+[method@TabBar.setup_extra_drop_target].</doc>
34459+ <type name="Gdk.DragAction"/>
34460+ </property>
2077134461 <property name="extra-drag-preload"
2077234462 version="1.3"
2077334463 writable="1"
@@ -20775,13 +34465,9 @@ when possible, otherwise tabs will always have the minimum possible size.</doc>
2077534465 setter="set_extra_drag_preload"
2077634466 getter="get_extra_drag_preload"
2077734467 default-value="FALSE">
20778- <attribute name="org.gtk.Property.get"
20779- value="adw_tab_bar_get_extra_drag_preload"/>
20780- <attribute name="org.gtk.Property.set"
20781- value="adw_tab_bar_set_extra_drag_preload"/>
2078234468 <doc xml:space="preserve"
2078334469 filename="src/adw-tab-bar.c"
20784- line="527">Whether the drop data should be preloaded on hover.
34470+ line="575">Whether the drop data should be preloaded on hover.
2078534471
2078634472 See [property@Gtk.DropTarget:preload].</doc>
2078734473 <type name="gboolean" c:type="gboolean"/>
@@ -20792,13 +34478,9 @@ See [property@Gtk.DropTarget:preload].</doc>
2079234478 setter="set_inverted"
2079334479 getter="get_inverted"
2079434480 default-value="FALSE">
20795- <attribute name="org.gtk.Property.get"
20796- value="adw_tab_bar_get_inverted"/>
20797- <attribute name="org.gtk.Property.set"
20798- value="adw_tab_bar_set_inverted"/>
2079934481 <doc xml:space="preserve"
2080034482 filename="src/adw-tab-bar.c"
20801- line="502">Whether tabs use inverted layout.
34483+ line="533">Whether tabs use inverted layout.
2080234484
2080334485 If set to `TRUE`, non-pinned tabs will have the close button at the
2080434486 beginning and the indicator at the end rather than the opposite.</doc>
@@ -20808,11 +34490,9 @@ beginning and the indicator at the end rather than the opposite.</doc>
2080834490 transfer-ownership="none"
2080934491 getter="get_is_overflowing"
2081034492 default-value="FALSE">
20811- <attribute name="org.gtk.Property.get"
20812- value="adw_tab_bar_get_is_overflowing"/>
2081334493 <doc xml:space="preserve"
2081434494 filename="src/adw-tab-bar.c"
20815- line="515">Whether the tab bar is overflowing.
34495+ line="546">Whether the tab bar is overflowing.
2081634496
2081734497 If `TRUE`, all tabs cannot be displayed at once and require scrolling.</doc>
2081834498 <type name="gboolean" c:type="gboolean"/>
@@ -20822,24 +34502,18 @@ If `TRUE`, all tabs cannot be displayed at once and require scrolling.</doc>
2082234502 transfer-ownership="none"
2082334503 setter="set_start_action_widget"
2082434504 getter="get_start_action_widget">
20825- <attribute name="org.gtk.Property.get"
20826- value="adw_tab_bar_get_start_action_widget"/>
20827- <attribute name="org.gtk.Property.set"
20828- value="adw_tab_bar_set_start_action_widget"/>
2082934505 <doc xml:space="preserve"
2083034506 filename="src/adw-tab-bar.c"
20831- line="442">The widget shown before the tabs.</doc>
34507+ line="473">The widget shown before the tabs.</doc>
2083234508 <type name="Gtk.Widget"/>
2083334509 </property>
2083434510 <property name="tabs-revealed"
2083534511 transfer-ownership="none"
2083634512 getter="get_tabs_revealed"
2083734513 default-value="FALSE">
20838- <attribute name="org.gtk.Property.get"
20839- value="adw_tab_bar_get_tabs_revealed"/>
2084034514 <doc xml:space="preserve"
2084134515 filename="src/adw-tab-bar.c"
20842- line="477">Whether the tabs are currently revealed.
34516+ line="508">Whether the tabs are currently revealed.
2084334517
2084434518 See [property@TabBar:autohide].</doc>
2084534519 <type name="gboolean" c:type="gboolean"/>
@@ -20849,17 +34523,15 @@ See [property@TabBar:autohide].</doc>
2084934523 transfer-ownership="none"
2085034524 setter="set_view"
2085134525 getter="get_view">
20852- <attribute name="org.gtk.Property.get" value="adw_tab_bar_get_view"/>
20853- <attribute name="org.gtk.Property.set" value="adw_tab_bar_set_view"/>
2085434526 <doc xml:space="preserve"
2085534527 filename="src/adw-tab-bar.c"
20856- line="432">The tab view the tab bar controls.</doc>
34528+ line="463">The tab view the tab bar controls.</doc>
2085734529 <type name="TabView"/>
2085834530 </property>
2085934531 <glib:signal name="extra-drag-drop" when="last">
2086034532 <doc xml:space="preserve"
2086134533 filename="src/adw-tab-bar.c"
20862- line="543">This signal is emitted when content is dropped onto a tab.
34534+ line="591">This signal is emitted when content is dropped onto a tab.
2086334535
2086434536 The content must be of one of the types set up via
2086534537 [method@TabBar.setup_extra_drop_target].
@@ -20868,20 +34540,20 @@ See [signal@Gtk.DropTarget::drop].</doc>
2086834540 <return-value transfer-ownership="none">
2086934541 <doc xml:space="preserve"
2087034542 filename="src/adw-tab-bar.c"
20871- line="556">whether the drop was accepted for @page</doc>
34543+ line="604">whether the drop was accepted for @page</doc>
2087234544 <type name="gboolean" c:type="gboolean"/>
2087334545 </return-value>
2087434546 <parameters>
2087534547 <parameter name="page" transfer-ownership="none">
2087634548 <doc xml:space="preserve"
2087734549 filename="src/adw-tab-bar.c"
20878- line="546">the page matching the tab the content was dropped onto</doc>
34550+ line="594">the page matching the tab the content was dropped onto</doc>
2087934551 <type name="TabPage"/>
2088034552 </parameter>
2088134553 <parameter name="value" transfer-ownership="none">
2088234554 <doc xml:space="preserve"
2088334555 filename="src/adw-tab-bar.c"
20884- line="547">the `GValue` being dropped</doc>
34556+ line="595">the `GValue` being dropped</doc>
2088534557 <type name="GObject.Value"/>
2088634558 </parameter>
2088734559 </parameters>
@@ -20889,7 +34561,7 @@ See [signal@Gtk.DropTarget::drop].</doc>
2088934561 <glib:signal name="extra-drag-value" when="last" version="1.3">
2089034562 <doc xml:space="preserve"
2089134563 filename="src/adw-tab-bar.c"
20892- line="570">This signal is emitted when the dropped content is preloaded.
34564+ line="618">This signal is emitted when the dropped content is preloaded.
2089334565
2089434566 In order for data to be preloaded, [property@TabBar:extra-drag-preload]
2089534567 must be set to `TRUE`.
@@ -20901,20 +34573,20 @@ See [property@Gtk.DropTarget:value].</doc>
2090134573 <return-value transfer-ownership="none">
2090234574 <doc xml:space="preserve"
2090334575 filename="src/adw-tab-bar.c"
20904- line="586">the preferred action for the drop on @page</doc>
34576+ line="634">the preferred action for the drop on @page</doc>
2090534577 <type name="Gdk.DragAction"/>
2090634578 </return-value>
2090734579 <parameters>
2090834580 <parameter name="page" transfer-ownership="none">
2090934581 <doc xml:space="preserve"
2091034582 filename="src/adw-tab-bar.c"
20911- line="573">the page matching the tab the content was dropped onto</doc>
34583+ line="621">the page matching the tab the content was dropped onto</doc>
2091234584 <type name="TabPage"/>
2091334585 </parameter>
2091434586 <parameter name="value" transfer-ownership="none">
2091534587 <doc xml:space="preserve"
2091634588 filename="src/adw-tab-bar.c"
20917- line="574">the `GValue` being dropped</doc>
34589+ line="622">the `GValue` being dropped</doc>
2091834590 <type name="GObject.Value"/>
2091934591 </parameter>
2092034592 </parameters>
@@ -20939,7 +34611,7 @@ See [property@Gtk.DropTarget:value].</doc>
2093934611 glib:type-struct="TabButtonClass">
2094034612 <doc xml:space="preserve"
2094134613 filename="src/adw-tab-button.c"
20942- line="21">A button that displays the number of [class@TabView] pages.
34614+ line="18">A button that displays the number of [class@TabView] pages.
2094334615
2094434616 &lt;picture&gt;
2094534617 &lt;source srcset="tab-button-dark.png" media="(prefers-color-scheme: dark)"&gt;
@@ -20975,12 +34647,12 @@ bar, typically opening an [class@TabOverview] on click, e.g. via the
2097534647 <constructor name="new" c:identifier="adw_tab_button_new" version="1.3">
2097634648 <doc xml:space="preserve"
2097734649 filename="src/adw-tab-button.c"
20978- line="429">Creates a new `AdwTabButton`.</doc>
34650+ line="388">Creates a new `AdwTabButton`.</doc>
2097934651 <source-position filename="src/adw-tab-button.h" line="28"/>
2098034652 <return-value transfer-ownership="none">
2098134653 <doc xml:space="preserve"
2098234654 filename="src/adw-tab-button.c"
20983- line="434">the newly created `AdwTabButton`</doc>
34655+ line="393">the newly created `AdwTabButton`</doc>
2098434656 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2098534657 </return-value>
2098634658 </constructor>
@@ -20988,22 +34660,21 @@ bar, typically opening an [class@TabOverview] on click, e.g. via the
2098834660 c:identifier="adw_tab_button_get_view"
2098934661 glib:get-property="view"
2099034662 version="1.3">
20991- <attribute name="org.gtk.Method.get_property" value="view"/>
2099234663 <doc xml:space="preserve"
2099334664 filename="src/adw-tab-button.c"
20994- line="444">Gets the tab view @self displays.</doc>
34665+ line="403">Gets the tab view @self displays.</doc>
2099534666 <source-position filename="src/adw-tab-button.h" line="31"/>
2099634667 <return-value transfer-ownership="none" nullable="1">
2099734668 <doc xml:space="preserve"
2099834669 filename="src/adw-tab-button.c"
20999- line="450">the tab view</doc>
34670+ line="409">the tab view</doc>
2100034671 <type name="TabView" c:type="AdwTabView*"/>
2100134672 </return-value>
2100234673 <parameters>
2100334674 <instance-parameter name="self" transfer-ownership="none">
2100434675 <doc xml:space="preserve"
2100534676 filename="src/adw-tab-button.c"
21006- line="446">a tab button</doc>
34677+ line="405">a tab button</doc>
2100734678 <type name="TabButton" c:type="AdwTabButton*"/>
2100834679 </instance-parameter>
2100934680 </parameters>
@@ -21012,10 +34683,9 @@ bar, typically opening an [class@TabOverview] on click, e.g. via the
2101234683 c:identifier="adw_tab_button_set_view"
2101334684 glib:set-property="view"
2101434685 version="1.3">
21015- <attribute name="org.gtk.Method.set_property" value="view"/>
2101634686 <doc xml:space="preserve"
2101734687 filename="src/adw-tab-button.c"
21018- line="462">Sets the tab view to display.</doc>
34688+ line="421">Sets the tab view to display.</doc>
2101934689 <source-position filename="src/adw-tab-button.h" line="33"/>
2102034690 <return-value transfer-ownership="none">
2102134691 <type name="none" c:type="void"/>
@@ -21024,7 +34694,7 @@ bar, typically opening an [class@TabOverview] on click, e.g. via the
2102434694 <instance-parameter name="self" transfer-ownership="none">
2102534695 <doc xml:space="preserve"
2102634696 filename="src/adw-tab-button.c"
21027- line="464">a tab button</doc>
34697+ line="423">a tab button</doc>
2102834698 <type name="TabButton" c:type="AdwTabButton*"/>
2102934699 </instance-parameter>
2103034700 <parameter name="view"
@@ -21033,7 +34703,7 @@ bar, typically opening an [class@TabOverview] on click, e.g. via the
2103334703 allow-none="1">
2103434704 <doc xml:space="preserve"
2103534705 filename="src/adw-tab-button.c"
21036- line="465">a tab view</doc>
34706+ line="424">a tab view</doc>
2103734707 <type name="TabView" c:type="AdwTabView*"/>
2103834708 </parameter>
2103934709 </parameters>
@@ -21044,19 +34714,15 @@ bar, typically opening an [class@TabOverview] on click, e.g. via the
2104434714 transfer-ownership="none"
2104534715 setter="set_view"
2104634716 getter="get_view">
21047- <attribute name="org.gtk.Property.get"
21048- value="adw_tab_button_get_view"/>
21049- <attribute name="org.gtk.Property.set"
21050- value="adw_tab_button_set_view"/>
2105134717 <doc xml:space="preserve"
2105234718 filename="src/adw-tab-button.c"
21053- line="283">The view the tab button displays.</doc>
34719+ line="251">The view the tab button displays.</doc>
2105434720 <type name="TabView"/>
2105534721 </property>
2105634722 <glib:signal name="activate" when="first" action="1" version="1.3">
2105734723 <doc xml:space="preserve"
2105834724 filename="src/adw-tab-button.c"
21059- line="321">Emitted to animate press then release.
34725+ line="289">Emitted to animate press then release.
2106034726
2106134727 This is an action signal. Applications should never connect to this signal,
2106234728 but use the [signal@TabButton::clicked] signal.</doc>
@@ -21067,7 +34733,7 @@ but use the [signal@TabButton::clicked] signal.</doc>
2106734733 <glib:signal name="clicked" when="first" action="1" version="1.3">
2106834734 <doc xml:space="preserve"
2106934735 filename="src/adw-tab-button.c"
21070- line="300">Emitted when the button has been activated (pressed and released).</doc>
34736+ line="268">Emitted when the button has been activated (pressed and released).</doc>
2107134737 <return-value transfer-ownership="none">
2107234738 <type name="none" c:type="void"/>
2107334739 </return-value>
@@ -21157,12 +34823,12 @@ opening and closing itself. They can be convenient when used together with
2115734823 version="1.3">
2115834824 <doc xml:space="preserve"
2115934825 filename="src/adw-tab-overview.c"
21160- line="1840">Creates a new `AdwTabOverview`.</doc>
34826+ line="1907">Creates a new `AdwTabOverview`.</doc>
2116134827 <source-position filename="src/adw-tab-overview.h" line="28"/>
2116234828 <return-value transfer-ownership="none">
2116334829 <doc xml:space="preserve"
2116434830 filename="src/adw-tab-overview.c"
21165- line="1845">the newly created `AdwTabOverview`</doc>
34831+ line="1912">the newly created `AdwTabOverview`</doc>
2116634832 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2116734833 </return-value>
2116834834 </constructor>
@@ -21170,22 +34836,21 @@ opening and closing itself. They can be convenient when used together with
2117034836 c:identifier="adw_tab_overview_get_child"
2117134837 glib:get-property="child"
2117234838 version="1.3">
21173- <attribute name="org.gtk.Method.get_property" value="child"/>
2117434839 <doc xml:space="preserve"
2117534840 filename="src/adw-tab-overview.c"
21176- line="1951">Gets the child widget of @self.</doc>
34841+ line="2018">Gets the child widget of @self.</doc>
2117734842 <source-position filename="src/adw-tab-overview.h" line="37"/>
2117834843 <return-value transfer-ownership="none" nullable="1">
2117934844 <doc xml:space="preserve"
2118034845 filename="src/adw-tab-overview.c"
21181- line="1957">the child widget of @self</doc>
34846+ line="2024">the child widget of @self</doc>
2118234847 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2118334848 </return-value>
2118434849 <parameters>
2118534850 <instance-parameter name="self" transfer-ownership="none">
2118634851 <doc xml:space="preserve"
2118734852 filename="src/adw-tab-overview.c"
21188- line="1953">a `AdwTabOveview`</doc>
34853+ line="2020">a tab overview</doc>
2118934854 <type name="TabOverview" c:type="AdwTabOverview*"/>
2119034855 </instance-parameter>
2119134856 </parameters>
@@ -21194,22 +34859,21 @@ opening and closing itself. They can be convenient when used together with
2119434859 c:identifier="adw_tab_overview_get_enable_new_tab"
2119534860 glib:get-property="enable-new-tab"
2119634861 version="1.3">
21197- <attribute name="org.gtk.Method.get_property" value="enable-new-tab"/>
2119834862 <doc xml:space="preserve"
2119934863 filename="src/adw-tab-overview.c"
21200- line="2236">Gets whether to new tab button is enabled for @self.</doc>
34864+ line="2298">Gets whether to new tab button is enabled for @self.</doc>
2120134865 <source-position filename="src/adw-tab-overview.h" line="64"/>
2120234866 <return-value transfer-ownership="none">
2120334867 <doc xml:space="preserve"
2120434868 filename="src/adw-tab-overview.c"
21205- line="2242">whether new tab button is enabled</doc>
34869+ line="2304">whether new tab button is enabled</doc>
2120634870 <type name="gboolean" c:type="gboolean"/>
2120734871 </return-value>
2120834872 <parameters>
2120934873 <instance-parameter name="self" transfer-ownership="none">
2121034874 <doc xml:space="preserve"
2121134875 filename="src/adw-tab-overview.c"
21212- line="2238">a tab overview</doc>
34876+ line="2300">a tab overview</doc>
2121334877 <type name="TabOverview" c:type="AdwTabOverview*"/>
2121434878 </instance-parameter>
2121534879 </parameters>
@@ -21218,22 +34882,44 @@ opening and closing itself. They can be convenient when used together with
2121834882 c:identifier="adw_tab_overview_get_enable_search"
2121934883 glib:get-property="enable-search"
2122034884 version="1.3">
21221- <attribute name="org.gtk.Method.get_property" value="enable-search"/>
2122234885 <doc xml:space="preserve"
2122334886 filename="src/adw-tab-overview.c"
21224- line="2156">Gets whether search in tabs is enabled for @self.</doc>
34887+ line="2218">Gets whether search in tabs is enabled for @self.</doc>
2122534888 <source-position filename="src/adw-tab-overview.h" line="55"/>
2122634889 <return-value transfer-ownership="none">
2122734890 <doc xml:space="preserve"
2122834891 filename="src/adw-tab-overview.c"
21229- line="2162">whether search is enabled</doc>
34892+ line="2224">whether search is enabled</doc>
2123034893 <type name="gboolean" c:type="gboolean"/>
2123134894 </return-value>
2123234895 <parameters>
2123334896 <instance-parameter name="self" transfer-ownership="none">
2123434897 <doc xml:space="preserve"
2123534898 filename="src/adw-tab-overview.c"
21236- line="2158">a tab overview</doc>
34899+ line="2220">a tab overview</doc>
34900+ <type name="TabOverview" c:type="AdwTabOverview*"/>
34901+ </instance-parameter>
34902+ </parameters>
34903+ </method>
34904+ <method name="get_extra_drag_preferred_action"
34905+ c:identifier="adw_tab_overview_get_extra_drag_preferred_action"
34906+ glib:get-property="extra-drag-preferred-action"
34907+ version="1.4">
34908+ <doc xml:space="preserve"
34909+ filename="src/adw-tab-overview.c"
34910+ line="2540">Gets the current action during a drop on the extra_drop_target.</doc>
34911+ <source-position filename="src/adw-tab-overview.h" line="94"/>
34912+ <return-value transfer-ownership="none">
34913+ <doc xml:space="preserve"
34914+ filename="src/adw-tab-overview.c"
34915+ line="2546">the drag action of the current drop.</doc>
34916+ <type name="Gdk.DragAction" c:type="GdkDragAction"/>
34917+ </return-value>
34918+ <parameters>
34919+ <instance-parameter name="self" transfer-ownership="none">
34920+ <doc xml:space="preserve"
34921+ filename="src/adw-tab-overview.c"
34922+ line="2542">a tab overview</doc>
2123734923 <type name="TabOverview" c:type="AdwTabOverview*"/>
2123834924 </instance-parameter>
2123934925 </parameters>
@@ -21242,23 +34928,21 @@ opening and closing itself. They can be convenient when used together with
2124234928 c:identifier="adw_tab_overview_get_extra_drag_preload"
2124334929 glib:get-property="extra-drag-preload"
2124434930 version="1.3">
21245- <attribute name="org.gtk.Method.get_property"
21246- value="extra-drag-preload"/>
2124734931 <doc xml:space="preserve"
2124834932 filename="src/adw-tab-overview.c"
21249- line="2478">Gets whether drop data should be preloaded on hover.</doc>
21250- <source-position filename="src/adw-tab-overview.h" line="94"/>
34933+ line="2558">Gets whether drop data should be preloaded on hover.</doc>
34934+ <source-position filename="src/adw-tab-overview.h" line="97"/>
2125134935 <return-value transfer-ownership="none">
2125234936 <doc xml:space="preserve"
2125334937 filename="src/adw-tab-overview.c"
21254- line="2484">whether drop data should be preloaded on hover</doc>
34938+ line="2564">whether drop data should be preloaded on hover</doc>
2125534939 <type name="gboolean" c:type="gboolean"/>
2125634940 </return-value>
2125734941 <parameters>
2125834942 <instance-parameter name="self" transfer-ownership="none">
2125934943 <doc xml:space="preserve"
2126034944 filename="src/adw-tab-overview.c"
21261- line="2480">a tab overview</doc>
34945+ line="2560">a tab overview</doc>
2126234946 <type name="TabOverview" c:type="AdwTabOverview*"/>
2126334947 </instance-parameter>
2126434948 </parameters>
@@ -21267,22 +34951,21 @@ opening and closing itself. They can be convenient when used together with
2126734951 c:identifier="adw_tab_overview_get_inverted"
2126834952 glib:get-property="inverted"
2126934953 version="1.3">
21270- <attribute name="org.gtk.Method.get_property" value="inverted"/>
2127134954 <doc xml:space="preserve"
2127234955 filename="src/adw-tab-overview.c"
21273- line="2109">Gets whether thumbnails use inverted layout.</doc>
34956+ line="2171">Gets whether thumbnails use inverted layout.</doc>
2127434957 <source-position filename="src/adw-tab-overview.h" line="49"/>
2127534958 <return-value transfer-ownership="none">
2127634959 <doc xml:space="preserve"
2127734960 filename="src/adw-tab-overview.c"
21278- line="2115">whether thumbnails use inverted layout</doc>
34961+ line="2177">whether thumbnails use inverted layout</doc>
2127934962 <type name="gboolean" c:type="gboolean"/>
2128034963 </return-value>
2128134964 <parameters>
2128234965 <instance-parameter name="self" transfer-ownership="none">
2128334966 <doc xml:space="preserve"
2128434967 filename="src/adw-tab-overview.c"
21285- line="2111">a tab overview</doc>
34968+ line="2173">a tab overview</doc>
2128634969 <type name="TabOverview" c:type="AdwTabOverview*"/>
2128734970 </instance-parameter>
2128834971 </parameters>
@@ -21291,22 +34974,21 @@ opening and closing itself. They can be convenient when used together with
2129134974 c:identifier="adw_tab_overview_get_open"
2129234975 glib:get-property="open"
2129334976 version="1.3">
21294- <attribute name="org.gtk.Method.get_property" value="open"/>
2129534977 <doc xml:space="preserve"
2129634978 filename="src/adw-tab-overview.c"
21297- line="1993">Gets whether @self is open.</doc>
34979+ line="2063">Gets whether @self is open.</doc>
2129834980 <source-position filename="src/adw-tab-overview.h" line="43"/>
2129934981 <return-value transfer-ownership="none">
2130034982 <doc xml:space="preserve"
2130134983 filename="src/adw-tab-overview.c"
21302- line="1999">whether the overview is open</doc>
34984+ line="2069">whether the overview is open</doc>
2130334985 <type name="gboolean" c:type="gboolean"/>
2130434986 </return-value>
2130534987 <parameters>
2130634988 <instance-parameter name="self" transfer-ownership="none">
2130734989 <doc xml:space="preserve"
2130834990 filename="src/adw-tab-overview.c"
21309- line="1995">a tab overview</doc>
34991+ line="2065">a tab overview</doc>
2131034992 <type name="TabOverview" c:type="AdwTabOverview*"/>
2131134993 </instance-parameter>
2131234994 </parameters>
@@ -21315,24 +34997,23 @@ opening and closing itself. They can be convenient when used together with
2131534997 c:identifier="adw_tab_overview_get_search_active"
2131634998 glib:get-property="search-active"
2131734999 version="1.3">
21318- <attribute name="org.gtk.Method.get_property" value="search-active"/>
2131935000 <doc xml:space="preserve"
2132035001 filename="src/adw-tab-overview.c"
21321- line="2216">Gets whether search is currently active for @self.
35002+ line="2278">Gets whether search is currently active for @self.
2132235003
2132335004 See [property@TabOverview:enable-search].</doc>
2132435005 <source-position filename="src/adw-tab-overview.h" line="61"/>
2132535006 <return-value transfer-ownership="none">
2132635007 <doc xml:space="preserve"
2132735008 filename="src/adw-tab-overview.c"
21328- line="2224">whether search is active</doc>
35009+ line="2286">whether search is active</doc>
2132935010 <type name="gboolean" c:type="gboolean"/>
2133035011 </return-value>
2133135012 <parameters>
2133235013 <instance-parameter name="self" transfer-ownership="none">
2133335014 <doc xml:space="preserve"
2133435015 filename="src/adw-tab-overview.c"
21335- line="2218">a tab overview</doc>
35016+ line="2280">a tab overview</doc>
2133635017 <type name="TabOverview" c:type="AdwTabOverview*"/>
2133735018 </instance-parameter>
2133835019 </parameters>
@@ -21341,22 +35022,21 @@ See [property@TabOverview:enable-search].</doc>
2134135022 c:identifier="adw_tab_overview_get_secondary_menu"
2134235023 glib:get-property="secondary-menu"
2134335024 version="1.3">
21344- <attribute name="org.gtk.Method.get_property" value="secondary-menu"/>
2134535025 <doc xml:space="preserve"
2134635026 filename="src/adw-tab-overview.c"
21347- line="2283">Gets the secondary menu model for @self.</doc>
35027+ line="2345">Gets the secondary menu model for @self.</doc>
2134835028 <source-position filename="src/adw-tab-overview.h" line="70"/>
2134935029 <return-value transfer-ownership="none" nullable="1">
2135035030 <doc xml:space="preserve"
2135135031 filename="src/adw-tab-overview.c"
21352- line="2289">the secondary menu model</doc>
35032+ line="2351">the secondary menu model</doc>
2135335033 <type name="Gio.MenuModel" c:type="GMenuModel*"/>
2135435034 </return-value>
2135535035 <parameters>
2135635036 <instance-parameter name="self" transfer-ownership="none">
2135735037 <doc xml:space="preserve"
2135835038 filename="src/adw-tab-overview.c"
21359- line="2285">a tab overview</doc>
35039+ line="2347">a tab overview</doc>
2136035040 <type name="TabOverview" c:type="AdwTabOverview*"/>
2136135041 </instance-parameter>
2136235042 </parameters>
@@ -21365,23 +35045,21 @@ See [property@TabOverview:enable-search].</doc>
2136535045 c:identifier="adw_tab_overview_get_show_end_title_buttons"
2136635046 glib:get-property="show-end-title-buttons"
2136735047 version="1.3">
21368- <attribute name="org.gtk.Method.get_property"
21369- value="show-end-title-buttons"/>
2137035048 <doc xml:space="preserve"
2137135049 filename="src/adw-tab-overview.c"
21372- line="2378">Gets whether end title buttons are shown in @self's header bar.</doc>
35050+ line="2440">Gets whether end title buttons are shown in @self's header bar.</doc>
2137335051 <source-position filename="src/adw-tab-overview.h" line="82"/>
2137435052 <return-value transfer-ownership="none">
2137535053 <doc xml:space="preserve"
2137635054 filename="src/adw-tab-overview.c"
21377- line="2384">whether end title buttons are shown</doc>
35055+ line="2446">whether end title buttons are shown</doc>
2137835056 <type name="gboolean" c:type="gboolean"/>
2137935057 </return-value>
2138035058 <parameters>
2138135059 <instance-parameter name="self" transfer-ownership="none">
2138235060 <doc xml:space="preserve"
2138335061 filename="src/adw-tab-overview.c"
21384- line="2380">a tab overview</doc>
35062+ line="2442">a tab overview</doc>
2138535063 <type name="TabOverview" c:type="AdwTabOverview*"/>
2138635064 </instance-parameter>
2138735065 </parameters>
@@ -21390,23 +35068,21 @@ See [property@TabOverview:enable-search].</doc>
2139035068 c:identifier="adw_tab_overview_get_show_start_title_buttons"
2139135069 glib:get-property="show-start-title-buttons"
2139235070 version="1.3">
21393- <attribute name="org.gtk.Method.get_property"
21394- value="show-start-title-buttons"/>
2139535071 <doc xml:space="preserve"
2139635072 filename="src/adw-tab-overview.c"
21397- line="2330">Gets whether start title buttons are shown in @self's header bar.</doc>
35073+ line="2392">Gets whether start title buttons are shown in @self's header bar.</doc>
2139835074 <source-position filename="src/adw-tab-overview.h" line="76"/>
2139935075 <return-value transfer-ownership="none">
2140035076 <doc xml:space="preserve"
2140135077 filename="src/adw-tab-overview.c"
21402- line="2336">whether start title buttons are shown</doc>
35078+ line="2398">whether start title buttons are shown</doc>
2140335079 <type name="gboolean" c:type="gboolean"/>
2140435080 </return-value>
2140535081 <parameters>
2140635082 <instance-parameter name="self" transfer-ownership="none">
2140735083 <doc xml:space="preserve"
2140835084 filename="src/adw-tab-overview.c"
21409- line="2332">a tab overview</doc>
35085+ line="2394">a tab overview</doc>
2141035086 <type name="TabOverview" c:type="AdwTabOverview*"/>
2141135087 </instance-parameter>
2141235088 </parameters>
@@ -21415,22 +35091,21 @@ See [property@TabOverview:enable-search].</doc>
2141535091 c:identifier="adw_tab_overview_get_view"
2141635092 glib:get-property="view"
2141735093 version="1.3">
21418- <attribute name="org.gtk.Method.get_property" value="view"/>
2141935094 <doc xml:space="preserve"
2142035095 filename="src/adw-tab-overview.c"
21421- line="1855">Gets the tab view @self controls.</doc>
35096+ line="1922">Gets the tab view @self controls.</doc>
2142235097 <source-position filename="src/adw-tab-overview.h" line="31"/>
2142335098 <return-value transfer-ownership="none" nullable="1">
2142435099 <doc xml:space="preserve"
2142535100 filename="src/adw-tab-overview.c"
21426- line="1861">the tab view</doc>
35101+ line="1928">the tab view</doc>
2142735102 <type name="TabView" c:type="AdwTabView*"/>
2142835103 </return-value>
2142935104 <parameters>
2143035105 <instance-parameter name="self" transfer-ownership="none">
2143135106 <doc xml:space="preserve"
2143235107 filename="src/adw-tab-overview.c"
21433- line="1857">a tab overview</doc>
35108+ line="1924">a tab overview</doc>
2143435109 <type name="TabOverview" c:type="AdwTabOverview*"/>
2143535110 </instance-parameter>
2143635111 </parameters>
@@ -21439,10 +35114,9 @@ See [property@TabOverview:enable-search].</doc>
2143935114 c:identifier="adw_tab_overview_set_child"
2144035115 glib:set-property="child"
2144135116 version="1.3">
21442- <attribute name="org.gtk.Method.set_property" value="child"/>
2144335117 <doc xml:space="preserve"
2144435118 filename="src/adw-tab-overview.c"
21445- line="1969">Sets the child widget of @self.</doc>
35119+ line="2036">Sets the child widget of @self.</doc>
2144635120 <source-position filename="src/adw-tab-overview.h" line="39"/>
2144735121 <return-value transfer-ownership="none">
2144835122 <type name="none" c:type="void"/>
@@ -21451,7 +35125,7 @@ See [property@TabOverview:enable-search].</doc>
2145135125 <instance-parameter name="self" transfer-ownership="none">
2145235126 <doc xml:space="preserve"
2145335127 filename="src/adw-tab-overview.c"
21454- line="1971">a tab overview</doc>
35128+ line="2038">a tab overview</doc>
2145535129 <type name="TabOverview" c:type="AdwTabOverview*"/>
2145635130 </instance-parameter>
2145735131 <parameter name="child"
@@ -21460,7 +35134,7 @@ See [property@TabOverview:enable-search].</doc>
2146035134 allow-none="1">
2146135135 <doc xml:space="preserve"
2146235136 filename="src/adw-tab-overview.c"
21463- line="1972">the child widget</doc>
35137+ line="2039">the child widget</doc>
2146435138 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2146535139 </parameter>
2146635140 </parameters>
@@ -21469,10 +35143,9 @@ See [property@TabOverview:enable-search].</doc>
2146935143 c:identifier="adw_tab_overview_set_enable_new_tab"
2147035144 glib:set-property="enable-new-tab"
2147135145 version="1.3">
21472- <attribute name="org.gtk.Method.set_property" value="enable-new-tab"/>
2147335146 <doc xml:space="preserve"
2147435147 filename="src/adw-tab-overview.c"
21475- line="2254">Sets whether to enable new tab button for @self.
35148+ line="2316">Sets whether to enable new tab button for @self.
2147635149
2147735150 Connect to the [signal@TabOverview::create-tab] signal to use it.</doc>
2147835151 <source-position filename="src/adw-tab-overview.h" line="66"/>
@@ -21483,13 +35156,13 @@ Connect to the [signal@TabOverview::create-tab] signal to use it.</doc>
2148335156 <instance-parameter name="self" transfer-ownership="none">
2148435157 <doc xml:space="preserve"
2148535158 filename="src/adw-tab-overview.c"
21486- line="2256">a tab overview</doc>
35159+ line="2318">a tab overview</doc>
2148735160 <type name="TabOverview" c:type="AdwTabOverview*"/>
2148835161 </instance-parameter>
2148935162 <parameter name="enable_new_tab" transfer-ownership="none">
2149035163 <doc xml:space="preserve"
2149135164 filename="src/adw-tab-overview.c"
21492- line="2257">whether to enable new tab button</doc>
35165+ line="2319">whether to enable new tab button</doc>
2149335166 <type name="gboolean" c:type="gboolean"/>
2149435167 </parameter>
2149535168 </parameters>
@@ -21498,10 +35171,9 @@ Connect to the [signal@TabOverview::create-tab] signal to use it.</doc>
2149835171 c:identifier="adw_tab_overview_set_enable_search"
2149935172 glib:set-property="enable-search"
2150035173 version="1.3">
21501- <attribute name="org.gtk.Method.set_property" value="enable-search"/>
2150235174 <doc xml:space="preserve"
2150335175 filename="src/adw-tab-overview.c"
21504- line="2174">Sets whether to enable search in tabs for @self.
35176+ line="2236">Sets whether to enable search in tabs for @self.
2150535177
2150635178 Search matches tab titles and tooltips, as well as keywords, set via
2150735179 [property@TabPage:keyword]. Use keywords to search in e.g. page URLs in a web
@@ -21519,13 +35191,13 @@ active.</doc>
2151935191 <instance-parameter name="self" transfer-ownership="none">
2152035192 <doc xml:space="preserve"
2152135193 filename="src/adw-tab-overview.c"
21522- line="2176">a tab overview</doc>
35194+ line="2238">a tab overview</doc>
2152335195 <type name="TabOverview" c:type="AdwTabOverview*"/>
2152435196 </instance-parameter>
2152535197 <parameter name="enable_search" transfer-ownership="none">
2152635198 <doc xml:space="preserve"
2152735199 filename="src/adw-tab-overview.c"
21528- line="2177">whether to enable search</doc>
35200+ line="2239">whether to enable search</doc>
2152935201 <type name="gboolean" c:type="gboolean"/>
2153035202 </parameter>
2153135203 </parameters>
@@ -21534,14 +35206,12 @@ active.</doc>
2153435206 c:identifier="adw_tab_overview_set_extra_drag_preload"
2153535207 glib:set-property="extra-drag-preload"
2153635208 version="1.3">
21537- <attribute name="org.gtk.Method.set_property"
21538- value="extra-drag-preload"/>
2153935209 <doc xml:space="preserve"
2154035210 filename="src/adw-tab-overview.c"
21541- line="2496">Sets whether drop data should be preloaded on hover.
35211+ line="2576">Sets whether drop data should be preloaded on hover.
2154235212
2154335213 See [property@Gtk.DropTarget:preload].</doc>
21544- <source-position filename="src/adw-tab-overview.h" line="96"/>
35214+ <source-position filename="src/adw-tab-overview.h" line="99"/>
2154535215 <return-value transfer-ownership="none">
2154635216 <type name="none" c:type="void"/>
2154735217 </return-value>
@@ -21549,13 +35219,13 @@ See [property@Gtk.DropTarget:preload].</doc>
2154935219 <instance-parameter name="self" transfer-ownership="none">
2155035220 <doc xml:space="preserve"
2155135221 filename="src/adw-tab-overview.c"
21552- line="2498">a tab overview</doc>
35222+ line="2578">a tab overview</doc>
2155335223 <type name="TabOverview" c:type="AdwTabOverview*"/>
2155435224 </instance-parameter>
2155535225 <parameter name="preload" transfer-ownership="none">
2155635226 <doc xml:space="preserve"
2155735227 filename="src/adw-tab-overview.c"
21558- line="2499">whether to preload drop data</doc>
35228+ line="2579">whether to preload drop data</doc>
2155935229 <type name="gboolean" c:type="gboolean"/>
2156035230 </parameter>
2156135231 </parameters>
@@ -21564,10 +35234,9 @@ See [property@Gtk.DropTarget:preload].</doc>
2156435234 c:identifier="adw_tab_overview_set_inverted"
2156535235 glib:set-property="inverted"
2156635236 version="1.3">
21567- <attribute name="org.gtk.Method.set_property" value="inverted"/>
2156835237 <doc xml:space="preserve"
2156935238 filename="src/adw-tab-overview.c"
21570- line="2127">Sets whether thumbnails use inverted layout.
35239+ line="2189">Sets whether thumbnails use inverted layout.
2157135240
2157235241 If set to `TRUE`, thumbnails will have the close or unpin button at the
2157335242 beginning and the indicator at the end rather than the other way around.</doc>
@@ -21579,13 +35248,13 @@ beginning and the indicator at the end rather than the other way around.</doc>
2157935248 <instance-parameter name="self" transfer-ownership="none">
2158035249 <doc xml:space="preserve"
2158135250 filename="src/adw-tab-overview.c"
21582- line="2129">a tab overview</doc>
35251+ line="2191">a tab overview</doc>
2158335252 <type name="TabOverview" c:type="AdwTabOverview*"/>
2158435253 </instance-parameter>
2158535254 <parameter name="inverted" transfer-ownership="none">
2158635255 <doc xml:space="preserve"
2158735256 filename="src/adw-tab-overview.c"
21588- line="2130">whether thumbnails use inverted layout</doc>
35257+ line="2192">whether thumbnails use inverted layout</doc>
2158935258 <type name="gboolean" c:type="gboolean"/>
2159035259 </parameter>
2159135260 </parameters>
@@ -21594,10 +35263,9 @@ beginning and the indicator at the end rather than the other way around.</doc>
2159435263 c:identifier="adw_tab_overview_set_open"
2159535264 glib:set-property="open"
2159635265 version="1.3">
21597- <attribute name="org.gtk.Method.set_property" value="open"/>
2159835266 <doc xml:space="preserve"
2159935267 filename="src/adw-tab-overview.c"
21600- line="2011">Sets whether the to open @self.</doc>
35268+ line="2081">Sets whether the to open @self.</doc>
2160135269 <source-position filename="src/adw-tab-overview.h" line="45"/>
2160235270 <return-value transfer-ownership="none">
2160335271 <type name="none" c:type="void"/>
@@ -21606,13 +35274,13 @@ beginning and the indicator at the end rather than the other way around.</doc>
2160635274 <instance-parameter name="self" transfer-ownership="none">
2160735275 <doc xml:space="preserve"
2160835276 filename="src/adw-tab-overview.c"
21609- line="2013">a tab overview</doc>
35277+ line="2083">a tab overview</doc>
2161035278 <type name="TabOverview" c:type="AdwTabOverview*"/>
2161135279 </instance-parameter>
2161235280 <parameter name="open" transfer-ownership="none">
2161335281 <doc xml:space="preserve"
2161435282 filename="src/adw-tab-overview.c"
21615- line="2014">whether the overview is open</doc>
35283+ line="2084">whether the overview is open</doc>
2161635284 <type name="gboolean" c:type="gboolean"/>
2161735285 </parameter>
2161835286 </parameters>
@@ -21621,10 +35289,9 @@ beginning and the indicator at the end rather than the other way around.</doc>
2162135289 c:identifier="adw_tab_overview_set_secondary_menu"
2162235290 glib:set-property="secondary-menu"
2162335291 version="1.3">
21624- <attribute name="org.gtk.Method.set_property" value="secondary-menu"/>
2162535292 <doc xml:space="preserve"
2162635293 filename="src/adw-tab-overview.c"
21627- line="2301">Sets the secondary menu model for @self.
35294+ line="2363">Sets the secondary menu model for @self.
2162835295
2162935296 Use it to add extra actions, e.g. to open a new window or undo closed tab.</doc>
2163035297 <source-position filename="src/adw-tab-overview.h" line="72"/>
@@ -21635,7 +35302,7 @@ Use it to add extra actions, e.g. to open a new window or undo closed tab.</doc>
2163535302 <instance-parameter name="self" transfer-ownership="none">
2163635303 <doc xml:space="preserve"
2163735304 filename="src/adw-tab-overview.c"
21638- line="2303">a tab overview</doc>
35305+ line="2365">a tab overview</doc>
2163935306 <type name="TabOverview" c:type="AdwTabOverview*"/>
2164035307 </instance-parameter>
2164135308 <parameter name="secondary_menu"
@@ -21644,7 +35311,7 @@ Use it to add extra actions, e.g. to open a new window or undo closed tab.</doc>
2164435311 allow-none="1">
2164535312 <doc xml:space="preserve"
2164635313 filename="src/adw-tab-overview.c"
21647- line="2304">a menu model</doc>
35314+ line="2366">a menu model</doc>
2164835315 <type name="Gio.MenuModel" c:type="GMenuModel*"/>
2164935316 </parameter>
2165035317 </parameters>
@@ -21653,11 +35320,9 @@ Use it to add extra actions, e.g. to open a new window or undo closed tab.</doc>
2165335320 c:identifier="adw_tab_overview_set_show_end_title_buttons"
2165435321 glib:set-property="show-end-title-buttons"
2165535322 version="1.3">
21656- <attribute name="org.gtk.Method.set_property"
21657- value="show-end-title-buttons"/>
2165835323 <doc xml:space="preserve"
2165935324 filename="src/adw-tab-overview.c"
21660- line="2396">Sets whether to show end title buttons in @self's header bar.
35325+ line="2458">Sets whether to show end title buttons in @self's header bar.
2166135326
2166235327 See [property@HeaderBar:show-start-title-buttons] for the other side.</doc>
2166335328 <source-position filename="src/adw-tab-overview.h" line="84"/>
@@ -21668,13 +35333,13 @@ See [property@HeaderBar:show-start-title-buttons] for the other side.</doc>
2166835333 <instance-parameter name="self" transfer-ownership="none">
2166935334 <doc xml:space="preserve"
2167035335 filename="src/adw-tab-overview.c"
21671- line="2398">a tab overview</doc>
35336+ line="2460">a tab overview</doc>
2167235337 <type name="TabOverview" c:type="AdwTabOverview*"/>
2167335338 </instance-parameter>
2167435339 <parameter name="show_end_title_buttons" transfer-ownership="none">
2167535340 <doc xml:space="preserve"
2167635341 filename="src/adw-tab-overview.c"
21677- line="2399">whether to show end title buttons</doc>
35342+ line="2461">whether to show end title buttons</doc>
2167835343 <type name="gboolean" c:type="gboolean"/>
2167935344 </parameter>
2168035345 </parameters>
@@ -21683,11 +35348,9 @@ See [property@HeaderBar:show-start-title-buttons] for the other side.</doc>
2168335348 c:identifier="adw_tab_overview_set_show_start_title_buttons"
2168435349 glib:set-property="show-start-title-buttons"
2168535350 version="1.3">
21686- <attribute name="org.gtk.Method.set_property"
21687- value="show-start-title-buttons"/>
2168835351 <doc xml:space="preserve"
2168935352 filename="src/adw-tab-overview.c"
21690- line="2348">Sets whether to show start title buttons in @self's header bar.
35353+ line="2410">Sets whether to show start title buttons in @self's header bar.
2169135354
2169235355 See [property@HeaderBar:show-end-title-buttons] for the other side.</doc>
2169335356 <source-position filename="src/adw-tab-overview.h" line="78"/>
@@ -21698,13 +35361,13 @@ See [property@HeaderBar:show-end-title-buttons] for the other side.</doc>
2169835361 <instance-parameter name="self" transfer-ownership="none">
2169935362 <doc xml:space="preserve"
2170035363 filename="src/adw-tab-overview.c"
21701- line="2350">a tab overview</doc>
35364+ line="2412">a tab overview</doc>
2170235365 <type name="TabOverview" c:type="AdwTabOverview*"/>
2170335366 </instance-parameter>
2170435367 <parameter name="show_start_title_buttons" transfer-ownership="none">
2170535368 <doc xml:space="preserve"
2170635369 filename="src/adw-tab-overview.c"
21707- line="2351">whether to show start title buttons</doc>
35370+ line="2413">whether to show start title buttons</doc>
2170835371 <type name="gboolean" c:type="gboolean"/>
2170935372 </parameter>
2171035373 </parameters>
@@ -21713,10 +35376,9 @@ See [property@HeaderBar:show-end-title-buttons] for the other side.</doc>
2171335376 c:identifier="adw_tab_overview_set_view"
2171435377 glib:set-property="view"
2171535378 version="1.3">
21716- <attribute name="org.gtk.Method.set_property" value="view"/>
2171735379 <doc xml:space="preserve"
2171835380 filename="src/adw-tab-overview.c"
21719- line="1873">Sets the tab view to control.
35381+ line="1940">Sets the tab view to control.
2172035382
2172135383 The view must be inside @self, see [property@TabOverview:child].</doc>
2172235384 <source-position filename="src/adw-tab-overview.h" line="33"/>
@@ -21727,7 +35389,7 @@ The view must be inside @self, see [property@TabOverview:child].</doc>
2172735389 <instance-parameter name="self" transfer-ownership="none">
2172835390 <doc xml:space="preserve"
2172935391 filename="src/adw-tab-overview.c"
21730- line="1875">a tab overview</doc>
35392+ line="1942">a tab overview</doc>
2173135393 <type name="TabOverview" c:type="AdwTabOverview*"/>
2173235394 </instance-parameter>
2173335395 <parameter name="view"
@@ -21736,7 +35398,7 @@ The view must be inside @self, see [property@TabOverview:child].</doc>
2173635398 allow-none="1">
2173735399 <doc xml:space="preserve"
2173835400 filename="src/adw-tab-overview.c"
21739- line="1876">a tab view</doc>
35401+ line="1943">a tab view</doc>
2174035402 <type name="TabView" c:type="AdwTabView*"/>
2174135403 </parameter>
2174235404 </parameters>
@@ -21746,7 +35408,7 @@ The view must be inside @self, see [property@TabOverview:child].</doc>
2174635408 version="1.3">
2174735409 <doc xml:space="preserve"
2174835410 filename="src/adw-tab-overview.c"
21749- line="2426">Sets the supported types for this drop target.
35411+ line="2488">Sets the supported types for this drop target.
2175035412
2175135413 Sets up an extra drop target on tabs.
2175235414
@@ -21766,13 +35428,13 @@ drop.</doc>
2176635428 <instance-parameter name="self" transfer-ownership="none">
2176735429 <doc xml:space="preserve"
2176835430 filename="src/adw-tab-overview.c"
21769- line="2428">a tab overview</doc>
35431+ line="2490">a tab overview</doc>
2177035432 <type name="TabOverview" c:type="AdwTabOverview*"/>
2177135433 </instance-parameter>
2177235434 <parameter name="actions" transfer-ownership="none">
2177335435 <doc xml:space="preserve"
2177435436 filename="src/adw-tab-overview.c"
21775- line="2429">the supported actions</doc>
35437+ line="2491">the supported actions</doc>
2177635438 <type name="Gdk.DragAction" c:type="GdkDragAction"/>
2177735439 </parameter>
2177835440 <parameter name="types"
@@ -21781,7 +35443,7 @@ drop.</doc>
2178135443 allow-none="1">
2178235444 <doc xml:space="preserve"
2178335445 filename="src/adw-tab-overview.c"
21784- line="2430">
35446+ line="2492">
2178535447 all supported `GType`s that can be dropped</doc>
2178635448 <array length="2" zero-terminated="0" c:type="GType*">
2178735449 <type name="GType" c:type="GType"/>
@@ -21790,7 +35452,7 @@ drop.</doc>
2179035452 <parameter name="n_types" transfer-ownership="none">
2179135453 <doc xml:space="preserve"
2179235454 filename="src/adw-tab-overview.c"
21793- line="2432">number of @types</doc>
35455+ line="2494">number of @types</doc>
2179435456 <type name="gsize" c:type="gsize"/>
2179535457 </parameter>
2179635458 </parameters>
@@ -21801,13 +35463,9 @@ drop.</doc>
2180135463 transfer-ownership="none"
2180235464 setter="set_child"
2180335465 getter="get_child">
21804- <attribute name="org.gtk.Property.get"
21805- value="adw_tab_overview_get_child"/>
21806- <attribute name="org.gtk.Property.set"
21807- value="adw_tab_overview_set_child"/>
2180835466 <doc xml:space="preserve"
2180935467 filename="src/adw-tab-overview.c"
21810- line="1511">The child widget.</doc>
35468+ line="1554">The child widget.</doc>
2181135469 <type name="Gtk.Widget"/>
2181235470 </property>
2181335471 <property name="enable-new-tab"
@@ -21817,13 +35475,9 @@ drop.</doc>
2181735475 setter="set_enable_new_tab"
2181835476 getter="get_enable_new_tab"
2181935477 default-value="FALSE">
21820- <attribute name="org.gtk.Property.get"
21821- value="adw_tab_overview_get_enable_new_tab"/>
21822- <attribute name="org.gtk.Property.set"
21823- value="adw_tab_overview_set_enable_new_tab"/>
2182435478 <doc xml:space="preserve"
2182535479 filename="src/adw-tab-overview.c"
21826- line="1585">Whether to enable new tab button.
35480+ line="1628">Whether to enable new tab button.
2182735481
2182835482 Connect to the [signal@TabOverview::create-tab] signal to use it.</doc>
2182935483 <type name="gboolean" c:type="gboolean"/>
@@ -21835,13 +35489,9 @@ Connect to the [signal@TabOverview::create-tab] signal to use it.</doc>
2183535489 setter="set_enable_search"
2183635490 getter="get_enable_search"
2183735491 default-value="TRUE">
21838- <attribute name="org.gtk.Property.get"
21839- value="adw_tab_overview_get_enable_search"/>
21840- <attribute name="org.gtk.Property.set"
21841- value="adw_tab_overview_set_enable_search"/>
2184235492 <doc xml:space="preserve"
2184335493 filename="src/adw-tab-overview.c"
21844- line="1550">Whether to enable search in tabs.
35494+ line="1593">Whether to enable search in tabs.
2184535495
2184635496 Search matches tab titles and tooltips, as well as keywords, set via
2184735497 [property@TabPage:keyword]. Use keywords to search in e.g. page URLs in a
@@ -21853,6 +35503,21 @@ Use [property@TabOverview:search-active] to check out if search is
2185335503 currently active.</doc>
2185435504 <type name="gboolean" c:type="gboolean"/>
2185535505 </property>
35506+ <property name="extra-drag-preferred-action"
35507+ version="1.4"
35508+ transfer-ownership="none"
35509+ getter="get_extra_drag_preferred_action"
35510+ default-value="0">
35511+ <doc xml:space="preserve"
35512+ filename="src/adw-tab-overview.c"
35513+ line="1684">The unique action on the `current-drop` of the
35514+[signal@TabOverview::extra-drag-drop].
35515+
35516+This property should only be used during a
35517+[signal@TabOverview::extra-drag-drop] and is always a subset of what was
35518+originally passed to [method@TabOverview.setup_extra_drop_target].</doc>
35519+ <type name="Gdk.DragAction"/>
35520+ </property>
2185635521 <property name="extra-drag-preload"
2185735522 version="1.3"
2185835523 writable="1"
@@ -21860,13 +35525,9 @@ currently active.</doc>
2186035525 setter="set_extra_drag_preload"
2186135526 getter="get_extra_drag_preload"
2186235527 default-value="FALSE">
21863- <attribute name="org.gtk.Property.get"
21864- value="adw_tab_overview_get_extra_drag_preload"/>
21865- <attribute name="org.gtk.Property.set"
21866- value="adw_tab_overview_set_extra_drag_preload"/>
2186735528 <doc xml:space="preserve"
2186835529 filename="src/adw-tab-overview.c"
21869- line="1641">Whether the drop data should be preloaded on hover.
35530+ line="1701">Whether the drop data should be preloaded on hover.
2187035531
2187135532 See [property@Gtk.DropTarget:preload].</doc>
2187235533 <type name="gboolean" c:type="gboolean"/>
@@ -21878,13 +35539,9 @@ See [property@Gtk.DropTarget:preload].</doc>
2187835539 setter="set_inverted"
2187935540 getter="get_inverted"
2188035541 default-value="FALSE">
21881- <attribute name="org.gtk.Property.get"
21882- value="adw_tab_overview_get_inverted"/>
21883- <attribute name="org.gtk.Property.set"
21884- value="adw_tab_overview_set_inverted"/>
2188535542 <doc xml:space="preserve"
2188635543 filename="src/adw-tab-overview.c"
21887- line="1535">Whether thumbnails use inverted layout.
35544+ line="1578">Whether thumbnails use inverted layout.
2188835545
2188935546 If set to `TRUE`, thumbnails will have the close or unpin buttons at the
2189035547 beginning and the indicator at the end rather than the other way around.</doc>
@@ -21897,13 +35554,9 @@ beginning and the indicator at the end rather than the other way around.</doc>
2189735554 setter="set_open"
2189835555 getter="get_open"
2189935556 default-value="FALSE">
21900- <attribute name="org.gtk.Property.get"
21901- value="adw_tab_overview_get_open"/>
21902- <attribute name="org.gtk.Property.set"
21903- value="adw_tab_overview_set_open"/>
2190435557 <doc xml:space="preserve"
2190535558 filename="src/adw-tab-overview.c"
21906- line="1523">Whether the overview is open.</doc>
35559+ line="1566">Whether the overview is open.</doc>
2190735560 <type name="gboolean" c:type="gboolean"/>
2190835561 </property>
2190935562 <property name="search-active"
@@ -21911,11 +35564,9 @@ beginning and the indicator at the end rather than the other way around.</doc>
2191135564 transfer-ownership="none"
2191235565 getter="get_search_active"
2191335566 default-value="FALSE">
21914- <attribute name="org.gtk.Property.get"
21915- value="adw_tab_overview_get_search_active"/>
2191635567 <doc xml:space="preserve"
2191735568 filename="src/adw-tab-overview.c"
21918- line="1571">Whether search is currently active.
35569+ line="1614">Whether search is currently active.
2191935570
2192035571 See [property@TabOverview:enable-search].</doc>
2192135572 <type name="gboolean" c:type="gboolean"/>
@@ -21926,13 +35577,9 @@ See [property@TabOverview:enable-search].</doc>
2192635577 transfer-ownership="none"
2192735578 setter="set_secondary_menu"
2192835579 getter="get_secondary_menu">
21929- <attribute name="org.gtk.Property.get"
21930- value="adw_tab_overview_get_secondary_menu"/>
21931- <attribute name="org.gtk.Property.set"
21932- value="adw_tab_overview_set_secondary_menu"/>
2193335580 <doc xml:space="preserve"
2193435581 filename="src/adw-tab-overview.c"
21935- line="1599">The secondary menu model.
35582+ line="1642">The secondary menu model.
2193635583
2193735584 Use it to add extra actions, e.g. to open a new window or undo closed tab.</doc>
2193835585 <type name="Gio.MenuModel"/>
@@ -21944,13 +35591,9 @@ Use it to add extra actions, e.g. to open a new window or undo closed tab.</doc>
2194435591 setter="set_show_end_title_buttons"
2194535592 getter="get_show_end_title_buttons"
2194635593 default-value="TRUE">
21947- <attribute name="org.gtk.Property.get"
21948- value="adw_tab_overview_get_show_end_title_buttons"/>
21949- <attribute name="org.gtk.Property.set"
21950- value="adw_tab_overview_set_show_end_title_buttons"/>
2195135594 <doc xml:space="preserve"
2195235595 filename="src/adw-tab-overview.c"
21953- line="1627">Whether to show end title buttons in the overview's header bar.
35596+ line="1670">Whether to show end title buttons in the overview's header bar.
2195435597
2195535598 See [property@HeaderBar:show-start-title-buttons] for the other side.</doc>
2195635599 <type name="gboolean" c:type="gboolean"/>
@@ -21962,13 +35605,9 @@ See [property@HeaderBar:show-start-title-buttons] for the other side.</doc>
2196235605 setter="set_show_start_title_buttons"
2196335606 getter="get_show_start_title_buttons"
2196435607 default-value="TRUE">
21965- <attribute name="org.gtk.Property.get"
21966- value="adw_tab_overview_get_show_start_title_buttons"/>
21967- <attribute name="org.gtk.Property.set"
21968- value="adw_tab_overview_set_show_start_title_buttons"/>
2196935608 <doc xml:space="preserve"
2197035609 filename="src/adw-tab-overview.c"
21971- line="1613">Whether to show start title buttons in the overview's header bar.
35610+ line="1656">Whether to show start title buttons in the overview's header bar.
2197235611
2197335612 See [property@HeaderBar:show-end-title-buttons] for the other side.</doc>
2197435613 <type name="gboolean" c:type="gboolean"/>
@@ -21979,13 +35618,9 @@ See [property@HeaderBar:show-end-title-buttons] for the other side.</doc>
2197935618 transfer-ownership="none"
2198035619 setter="set_view"
2198135620 getter="get_view">
21982- <attribute name="org.gtk.Property.get"
21983- value="adw_tab_overview_get_view"/>
21984- <attribute name="org.gtk.Property.set"
21985- value="adw_tab_overview_set_view"/>
2198635621 <doc xml:space="preserve"
2198735622 filename="src/adw-tab-overview.c"
21988- line="1497">The tab view the overview controls.
35623+ line="1540">The tab view the overview controls.
2198935624
2199035625 The view must be inside the tab overview, see [property@TabOverview:child].</doc>
2199135626 <type name="TabView"/>
@@ -21993,7 +35628,7 @@ The view must be inside the tab overview, see [property@TabOverview:child].</doc
2199335628 <glib:signal name="create-tab" when="last" version="1.3">
2199435629 <doc xml:space="preserve"
2199535630 filename="src/adw-tab-overview.c"
21996- line="1657">Emitted when a tab needs to be created;
35631+ line="1717">Emitted when a tab needs to be created.
2199735632
2199835633 This can happen after the new tab button has been pressed, see
2199935634 [property@TabOverview:enable-new-tab].
@@ -22003,14 +35638,14 @@ The signal handler is expected to create a new page in the corresponding
2200335638 <return-value transfer-ownership="none">
2200435639 <doc xml:space="preserve"
2200535640 filename="src/adw-tab-overview.c"
22006- line="1669">the newly created page</doc>
35641+ line="1729">the newly created page</doc>
2200735642 <type name="TabPage"/>
2200835643 </return-value>
2200935644 </glib:signal>
2201035645 <glib:signal name="extra-drag-drop" when="last" version="1.3">
2201135646 <doc xml:space="preserve"
2201235647 filename="src/adw-tab-overview.c"
22013- line="1687">This signal is emitted when content is dropped onto a tab.
35648+ line="1747">This signal is emitted when content is dropped onto a tab.
2201435649
2201535650 The content must be of one of the types set up via
2201635651 [method@TabOverview.setup_extra_drop_target].
@@ -22019,20 +35654,20 @@ See [signal@Gtk.DropTarget::drop].</doc>
2201935654 <return-value transfer-ownership="none">
2202035655 <doc xml:space="preserve"
2202135656 filename="src/adw-tab-overview.c"
22022- line="1700">whether the drop was accepted for @page</doc>
35657+ line="1760">whether the drop was accepted for @page</doc>
2202335658 <type name="gboolean" c:type="gboolean"/>
2202435659 </return-value>
2202535660 <parameters>
2202635661 <parameter name="page" transfer-ownership="none">
2202735662 <doc xml:space="preserve"
2202835663 filename="src/adw-tab-overview.c"
22029- line="1690">the page matching the tab the content was dropped onto</doc>
35664+ line="1750">the page matching the tab the content was dropped onto</doc>
2203035665 <type name="TabPage"/>
2203135666 </parameter>
2203235667 <parameter name="value" transfer-ownership="none">
2203335668 <doc xml:space="preserve"
2203435669 filename="src/adw-tab-overview.c"
22035- line="1691">the `GValue` being dropped</doc>
35670+ line="1751">the `GValue` being dropped</doc>
2203635671 <type name="GObject.Value"/>
2203735672 </parameter>
2203835673 </parameters>
@@ -22040,7 +35675,7 @@ See [signal@Gtk.DropTarget::drop].</doc>
2204035675 <glib:signal name="extra-drag-value" when="last" version="1.3">
2204135676 <doc xml:space="preserve"
2204235677 filename="src/adw-tab-overview.c"
22043- line="1716">This signal is emitted when the dropped content is preloaded.
35678+ line="1776">This signal is emitted when the dropped content is preloaded.
2204435679
2204535680 In order for data to be preloaded, [property@TabOverview:extra-drag-preload]
2204635681 must be set to `TRUE`.
@@ -22052,20 +35687,20 @@ See [property@Gtk.DropTarget:value].</doc>
2205235687 <return-value transfer-ownership="none">
2205335688 <doc xml:space="preserve"
2205435689 filename="src/adw-tab-overview.c"
22055- line="1732">the preferred action for the drop on @page</doc>
35690+ line="1792">the preferred action for the drop on @page</doc>
2205635691 <type name="Gdk.DragAction"/>
2205735692 </return-value>
2205835693 <parameters>
2205935694 <parameter name="page" transfer-ownership="none">
2206035695 <doc xml:space="preserve"
2206135696 filename="src/adw-tab-overview.c"
22062- line="1719">the page matching the tab the content was dropped onto</doc>
35697+ line="1779">the page matching the tab the content was dropped onto</doc>
2206335698 <type name="TabPage"/>
2206435699 </parameter>
2206535700 <parameter name="value" transfer-ownership="none">
2206635701 <doc xml:space="preserve"
2206735702 filename="src/adw-tab-overview.c"
22068- line="1720">the `GValue` being dropped</doc>
35703+ line="1780">the `GValue` being dropped</doc>
2206935704 <type name="GObject.Value"/>
2207035705 </parameter>
2207135706 </parameters>
@@ -22089,28 +35724,27 @@ See [property@Gtk.DropTarget:value].</doc>
2208935724 glib:type-struct="TabPageClass">
2209035725 <doc xml:space="preserve"
2209135726 filename="src/adw-tab-view.c"
22092- line="73">An auxiliary class used by [class@TabView].</doc>
35727+ line="77">An auxiliary class used by [class@TabView].</doc>
2209335728 <source-position filename="src/adw-tab-view.h" line="42"/>
2209435729 <implements name="Gtk.Accessible"/>
2209535730 <method name="get_child"
2209635731 c:identifier="adw_tab_page_get_child"
2209735732 glib:get-property="child">
22098- <attribute name="org.gtk.Method.get_property" value="child"/>
2209935733 <doc xml:space="preserve"
2210035734 filename="src/adw-tab-view.c"
22101- line="2650">Gets the child of @self.</doc>
35735+ line="2813">Gets the child of @self.</doc>
2210235736 <source-position filename="src/adw-tab-view.h" line="45"/>
2210335737 <return-value transfer-ownership="none">
2210435738 <doc xml:space="preserve"
2210535739 filename="src/adw-tab-view.c"
22106- line="2656">the child of @self</doc>
35740+ line="2819">the child of @self</doc>
2210735741 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2210835742 </return-value>
2210935743 <parameters>
2211035744 <instance-parameter name="self" transfer-ownership="none">
2211135745 <doc xml:space="preserve"
2211235746 filename="src/adw-tab-view.c"
22113- line="2652">a tab page</doc>
35747+ line="2815">a tab page</doc>
2211435748 <type name="TabPage" c:type="AdwTabPage*"/>
2211535749 </instance-parameter>
2211635750 </parameters>
@@ -22118,22 +35752,21 @@ See [property@Gtk.DropTarget:value].</doc>
2211835752 <method name="get_icon"
2211935753 c:identifier="adw_tab_page_get_icon"
2212035754 glib:get-property="icon">
22121- <attribute name="org.gtk.Method.get_property" value="icon"/>
2212235755 <doc xml:space="preserve"
2212335756 filename="src/adw-tab-view.c"
22124- line="2810">Gets the icon of @self.</doc>
35757+ line="2967">Gets the icon of @self.</doc>
2212535758 <source-position filename="src/adw-tab-view.h" line="69"/>
2212635759 <return-value transfer-ownership="none" nullable="1">
2212735760 <doc xml:space="preserve"
2212835761 filename="src/adw-tab-view.c"
22129- line="2816">the icon of @self</doc>
35762+ line="2973">the icon of @self</doc>
2213035763 <type name="Gio.Icon" c:type="GIcon*"/>
2213135764 </return-value>
2213235765 <parameters>
2213335766 <instance-parameter name="self" transfer-ownership="none">
2213435767 <doc xml:space="preserve"
2213535768 filename="src/adw-tab-view.c"
22136- line="2812">a tab page</doc>
35769+ line="2969">a tab page</doc>
2213735770 <type name="TabPage" c:type="AdwTabPage*"/>
2213835771 </instance-parameter>
2213935772 </parameters>
@@ -22141,23 +35774,21 @@ See [property@Gtk.DropTarget:value].</doc>
2214135774 <method name="get_indicator_activatable"
2214235775 c:identifier="adw_tab_page_get_indicator_activatable"
2214335776 glib:get-property="indicator-activatable">
22144- <attribute name="org.gtk.Method.get_property"
22145- value="indicator-activatable"/>
2214635777 <doc xml:space="preserve"
2214735778 filename="src/adw-tab-view.c"
22148- line="3000">Gets whether the indicator of @self is activatable.</doc>
35779+ line="3150">Gets whether the indicator of @self is activatable.</doc>
2214935780 <source-position filename="src/adw-tab-view.h" line="93"/>
2215035781 <return-value transfer-ownership="none">
2215135782 <doc xml:space="preserve"
2215235783 filename="src/adw-tab-view.c"
22153- line="3007">whether the indicator is activatable</doc>
35784+ line="3157">whether the indicator is activatable</doc>
2215435785 <type name="gboolean" c:type="gboolean"/>
2215535786 </return-value>
2215635787 <parameters>
2215735788 <instance-parameter name="self" transfer-ownership="none">
2215835789 <doc xml:space="preserve"
2215935790 filename="src/adw-tab-view.c"
22160- line="3002">a tab page</doc>
35791+ line="3152">a tab page</doc>
2216135792 <type name="TabPage" c:type="AdwTabPage*"/>
2216235793 </instance-parameter>
2216335794 </parameters>
@@ -22165,22 +35796,21 @@ See [property@Gtk.DropTarget:value].</doc>
2216535796 <method name="get_indicator_icon"
2216635797 c:identifier="adw_tab_page_get_indicator_icon"
2216735798 glib:get-property="indicator-icon">
22168- <attribute name="org.gtk.Method.get_property" value="indicator-icon"/>
2216935799 <doc xml:space="preserve"
2217035800 filename="src/adw-tab-view.c"
22171- line="2899">Gets the indicator icon of @self.</doc>
35801+ line="3054">Gets the indicator icon of @self.</doc>
2217235802 <source-position filename="src/adw-tab-view.h" line="81"/>
2217335803 <return-value transfer-ownership="none" nullable="1">
2217435804 <doc xml:space="preserve"
2217535805 filename="src/adw-tab-view.c"
22176- line="2905">the indicator icon of @self</doc>
35806+ line="3060">the indicator icon of @self</doc>
2217735807 <type name="Gio.Icon" c:type="GIcon*"/>
2217835808 </return-value>
2217935809 <parameters>
2218035810 <instance-parameter name="self" transfer-ownership="none">
2218135811 <doc xml:space="preserve"
2218235812 filename="src/adw-tab-view.c"
22183- line="2901">a tab page</doc>
35813+ line="3056">a tab page</doc>
2218435814 <type name="TabPage" c:type="AdwTabPage*"/>
2218535815 </instance-parameter>
2218635816 </parameters>
@@ -22189,23 +35819,21 @@ See [property@Gtk.DropTarget:value].</doc>
2218935819 c:identifier="adw_tab_page_get_indicator_tooltip"
2219035820 glib:get-property="indicator-tooltip"
2219135821 version="1.2">
22192- <attribute name="org.gtk.Method.get_property"
22193- value="indicator-tooltip"/>
2219435822 <doc xml:space="preserve"
2219535823 filename="src/adw-tab-view.c"
22196- line="2953">Gets the tooltip of the indicator icon of @self.</doc>
35824+ line="3106">Gets the tooltip of the indicator icon of @self.</doc>
2219735825 <source-position filename="src/adw-tab-view.h" line="87"/>
2219835826 <return-value transfer-ownership="none">
2219935827 <doc xml:space="preserve"
2220035828 filename="src/adw-tab-view.c"
22201- line="2959">the indicator tooltip of @self</doc>
35829+ line="3112">the indicator tooltip of @self</doc>
2220235830 <type name="utf8" c:type="const char*"/>
2220335831 </return-value>
2220435832 <parameters>
2220535833 <instance-parameter name="self" transfer-ownership="none">
2220635834 <doc xml:space="preserve"
2220735835 filename="src/adw-tab-view.c"
22208- line="2955">a tab page</doc>
35836+ line="3108">a tab page</doc>
2220935837 <type name="TabPage" c:type="AdwTabPage*"/>
2221035838 </instance-parameter>
2221135839 </parameters>
@@ -22214,22 +35842,21 @@ See [property@Gtk.DropTarget:value].</doc>
2221435842 c:identifier="adw_tab_page_get_keyword"
2221535843 glib:get-property="keyword"
2221635844 version="1.3">
22217- <attribute name="org.gtk.Method.get_property" value="keyword"/>
2221835845 <doc xml:space="preserve"
2221935846 filename="src/adw-tab-view.c"
22220- line="3094">Gets the search keyword of @self.</doc>
35847+ line="3244">Gets the search keyword of @self.</doc>
2222135848 <source-position filename="src/adw-tab-view.h" line="105"/>
2222235849 <return-value transfer-ownership="none" nullable="1">
2222335850 <doc xml:space="preserve"
2222435851 filename="src/adw-tab-view.c"
22225- line="3100">the search keyword of @self</doc>
35852+ line="3250">the search keyword of @self</doc>
2222635853 <type name="utf8" c:type="const char*"/>
2222735854 </return-value>
2222835855 <parameters>
2222935856 <instance-parameter name="self" transfer-ownership="none">
2223035857 <doc xml:space="preserve"
2223135858 filename="src/adw-tab-view.c"
22232- line="3096">a tab page</doc>
35859+ line="3246">a tab page</doc>
2223335860 <type name="TabPage" c:type="AdwTabPage*"/>
2223435861 </instance-parameter>
2223535862 </parameters>
@@ -22238,22 +35865,21 @@ See [property@Gtk.DropTarget:value].</doc>
2223835865 c:identifier="adw_tab_page_get_live_thumbnail"
2223935866 glib:get-property="live-thumbnail"
2224035867 version="1.3">
22241- <attribute name="org.gtk.Method.get_property" value="live-thumbnail"/>
2224235868 <doc xml:space="preserve"
2224335869 filename="src/adw-tab-view.c"
22244- line="3245">Gets whether to live thumbnail is enabled @self.</doc>
35870+ line="3392">Gets whether to live thumbnail is enabled @self.</doc>
2224535871 <source-position filename="src/adw-tab-view.h" line="123"/>
2224635872 <return-value transfer-ownership="none">
2224735873 <doc xml:space="preserve"
2224835874 filename="src/adw-tab-view.c"
22249- line="3251">whether live thumbnail is enabled</doc>
35875+ line="3398">whether live thumbnail is enabled</doc>
2225035876 <type name="gboolean" c:type="gboolean"/>
2225135877 </return-value>
2225235878 <parameters>
2225335879 <instance-parameter name="self" transfer-ownership="none">
2225435880 <doc xml:space="preserve"
2225535881 filename="src/adw-tab-view.c"
22256- line="3247">a tab overview</doc>
35882+ line="3394">a tab overview</doc>
2225735883 <type name="TabPage" c:type="AdwTabPage*"/>
2225835884 </instance-parameter>
2225935885 </parameters>
@@ -22261,22 +35887,21 @@ See [property@Gtk.DropTarget:value].</doc>
2226135887 <method name="get_loading"
2226235888 c:identifier="adw_tab_page_get_loading"
2226335889 glib:get-property="loading">
22264- <attribute name="org.gtk.Method.get_property" value="loading"/>
2226535890 <doc xml:space="preserve"
2226635891 filename="src/adw-tab-view.c"
22267- line="2854">Gets whether @self is loading.</doc>
35892+ line="3009">Gets whether @self is loading.</doc>
2226835893 <source-position filename="src/adw-tab-view.h" line="75"/>
2226935894 <return-value transfer-ownership="none">
2227035895 <doc xml:space="preserve"
2227135896 filename="src/adw-tab-view.c"
22272- line="2860">whether @self is loading</doc>
35897+ line="3015">whether @self is loading</doc>
2227335898 <type name="gboolean" c:type="gboolean"/>
2227435899 </return-value>
2227535900 <parameters>
2227635901 <instance-parameter name="self" transfer-ownership="none">
2227735902 <doc xml:space="preserve"
2227835903 filename="src/adw-tab-view.c"
22279- line="2856">a tab page</doc>
35904+ line="3011">a tab page</doc>
2228035905 <type name="TabPage" c:type="AdwTabPage*"/>
2228135906 </instance-parameter>
2228235907 </parameters>
@@ -22284,22 +35909,21 @@ See [property@Gtk.DropTarget:value].</doc>
2228435909 <method name="get_needs_attention"
2228535910 c:identifier="adw_tab_page_get_needs_attention"
2228635911 glib:get-property="needs-attention">
22287- <attribute name="org.gtk.Method.get_property" value="needs-attention"/>
2228835912 <doc xml:space="preserve"
2228935913 filename="src/adw-tab-view.c"
22290- line="3045">Gets whether @self needs attention.</doc>
35914+ line="3195">Gets whether @self needs attention.</doc>
2229135915 <source-position filename="src/adw-tab-view.h" line="99"/>
2229235916 <return-value transfer-ownership="none">
2229335917 <doc xml:space="preserve"
2229435918 filename="src/adw-tab-view.c"
22295- line="3051">whether @self needs attention</doc>
35919+ line="3201">whether @self needs attention</doc>
2229635920 <type name="gboolean" c:type="gboolean"/>
2229735921 </return-value>
2229835922 <parameters>
2229935923 <instance-parameter name="self" transfer-ownership="none">
2230035924 <doc xml:space="preserve"
2230135925 filename="src/adw-tab-view.c"
22302- line="3047">a tab page</doc>
35926+ line="3197">a tab page</doc>
2230335927 <type name="TabPage" c:type="AdwTabPage*"/>
2230435928 </instance-parameter>
2230535929 </parameters>
@@ -22307,24 +35931,23 @@ See [property@Gtk.DropTarget:value].</doc>
2230735931 <method name="get_parent"
2230835932 c:identifier="adw_tab_page_get_parent"
2230935933 glib:get-property="parent">
22310- <attribute name="org.gtk.Method.get_property" value="parent"/>
2231135934 <doc xml:space="preserve"
2231235935 filename="src/adw-tab-view.c"
22313- line="2666">Gets the parent page of @self.
35936+ line="2829">Gets the parent page of @self.
2231435937
2231535938 See [method@TabView.add_page] and [method@TabView.close_page].</doc>
2231635939 <source-position filename="src/adw-tab-view.h" line="48"/>
2231735940 <return-value transfer-ownership="none" nullable="1">
2231835941 <doc xml:space="preserve"
2231935942 filename="src/adw-tab-view.c"
22320- line="2674">the parent page</doc>
35943+ line="2837">the parent page</doc>
2232135944 <type name="TabPage" c:type="AdwTabPage*"/>
2232235945 </return-value>
2232335946 <parameters>
2232435947 <instance-parameter name="self" transfer-ownership="none">
2232535948 <doc xml:space="preserve"
2232635949 filename="src/adw-tab-view.c"
22327- line="2668">a tab page</doc>
35950+ line="2831">a tab page</doc>
2232835951 <type name="TabPage" c:type="AdwTabPage*"/>
2232935952 </instance-parameter>
2233035953 </parameters>
@@ -22332,24 +35955,23 @@ See [method@TabView.add_page] and [method@TabView.close_page].</doc>
2233235955 <method name="get_pinned"
2233335956 c:identifier="adw_tab_page_get_pinned"
2233435957 glib:get-property="pinned">
22335- <attribute name="org.gtk.Method.get_property" value="pinned"/>
2233635958 <doc xml:space="preserve"
2233735959 filename="src/adw-tab-view.c"
22338- line="2700">Gets whether @self is pinned.
35960+ line="2863">Gets whether @self is pinned.
2233935961
2234035962 See [method@TabView.set_page_pinned].</doc>
2234135963 <source-position filename="src/adw-tab-view.h" line="54"/>
2234235964 <return-value transfer-ownership="none">
2234335965 <doc xml:space="preserve"
2234435966 filename="src/adw-tab-view.c"
22345- line="2708">whether @self is pinned</doc>
35967+ line="2871">whether @self is pinned</doc>
2234635968 <type name="gboolean" c:type="gboolean"/>
2234735969 </return-value>
2234835970 <parameters>
2234935971 <instance-parameter name="self" transfer-ownership="none">
2235035972 <doc xml:space="preserve"
2235135973 filename="src/adw-tab-view.c"
22352- line="2702">a tab page</doc>
35974+ line="2865">a tab page</doc>
2235335975 <type name="TabPage" c:type="AdwTabPage*"/>
2235435976 </instance-parameter>
2235535977 </parameters>
@@ -22357,22 +35979,21 @@ See [method@TabView.set_page_pinned].</doc>
2235735979 <method name="get_selected"
2235835980 c:identifier="adw_tab_page_get_selected"
2235935981 glib:get-property="selected">
22360- <attribute name="org.gtk.Method.get_property" value="selected"/>
2236135982 <doc xml:space="preserve"
2236235983 filename="src/adw-tab-view.c"
22363- line="2684">Gets whether @self is selected.</doc>
35984+ line="2847">Gets whether @self is selected.</doc>
2236435985 <source-position filename="src/adw-tab-view.h" line="51"/>
2236535986 <return-value transfer-ownership="none">
2236635987 <doc xml:space="preserve"
2236735988 filename="src/adw-tab-view.c"
22368- line="2690">whether @self is selected</doc>
35989+ line="2853">whether @self is selected</doc>
2236935990 <type name="gboolean" c:type="gboolean"/>
2237035991 </return-value>
2237135992 <parameters>
2237235993 <instance-parameter name="self" transfer-ownership="none">
2237335994 <doc xml:space="preserve"
2237435995 filename="src/adw-tab-view.c"
22375- line="2686">a tab page</doc>
35996+ line="2849">a tab page</doc>
2237635997 <type name="TabPage" c:type="AdwTabPage*"/>
2237735998 </instance-parameter>
2237835999 </parameters>
@@ -22381,23 +36002,21 @@ See [method@TabView.set_page_pinned].</doc>
2238136002 c:identifier="adw_tab_page_get_thumbnail_xalign"
2238236003 glib:get-property="thumbnail-xalign"
2238336004 version="1.3">
22384- <attribute name="org.gtk.Method.get_property"
22385- value="thumbnail-xalign"/>
2238636005 <doc xml:space="preserve"
2238736006 filename="src/adw-tab-view.c"
22388- line="3141">Gets the horizontal alignment of the thumbnail for @self.</doc>
36007+ line="3288">Gets the horizontal alignment of the thumbnail for @self.</doc>
2238936008 <source-position filename="src/adw-tab-view.h" line="111"/>
2239036009 <return-value transfer-ownership="none">
2239136010 <doc xml:space="preserve"
2239236011 filename="src/adw-tab-view.c"
22393- line="3147">the horizontal alignment</doc>
36012+ line="3294">the horizontal alignment</doc>
2239436013 <type name="gfloat" c:type="float"/>
2239536014 </return-value>
2239636015 <parameters>
2239736016 <instance-parameter name="self" transfer-ownership="none">
2239836017 <doc xml:space="preserve"
2239936018 filename="src/adw-tab-view.c"
22400- line="3143">a tab page</doc>
36019+ line="3290">a tab page</doc>
2240136020 <type name="TabPage" c:type="AdwTabPage*"/>
2240236021 </instance-parameter>
2240336022 </parameters>
@@ -22406,23 +36025,21 @@ See [method@TabView.set_page_pinned].</doc>
2240636025 c:identifier="adw_tab_page_get_thumbnail_yalign"
2240736026 glib:get-property="thumbnail-yalign"
2240836027 version="1.3">
22409- <attribute name="org.gtk.Method.get_property"
22410- value="thumbnail-yalign"/>
2241136028 <doc xml:space="preserve"
2241236029 filename="src/adw-tab-view.c"
22413- line="3193">Gets the vertical alignment of the thumbnail for @self.</doc>
36030+ line="3340">Gets the vertical alignment of the thumbnail for @self.</doc>
2241436031 <source-position filename="src/adw-tab-view.h" line="117"/>
2241536032 <return-value transfer-ownership="none">
2241636033 <doc xml:space="preserve"
2241736034 filename="src/adw-tab-view.c"
22418- line="3199">the vertical alignment</doc>
36035+ line="3346">the vertical alignment</doc>
2241936036 <type name="gfloat" c:type="float"/>
2242036037 </return-value>
2242136038 <parameters>
2242236039 <instance-parameter name="self" transfer-ownership="none">
2242336040 <doc xml:space="preserve"
2242436041 filename="src/adw-tab-view.c"
22425- line="3195">a tab overview</doc>
36042+ line="3342">a tab overview</doc>
2242636043 <type name="TabPage" c:type="AdwTabPage*"/>
2242736044 </instance-parameter>
2242836045 </parameters>
@@ -22430,22 +36047,21 @@ See [method@TabView.set_page_pinned].</doc>
2243036047 <method name="get_title"
2243136048 c:identifier="adw_tab_page_get_title"
2243236049 glib:get-property="title">
22433- <attribute name="org.gtk.Method.get_property" value="title"/>
2243436050 <doc xml:space="preserve"
2243536051 filename="src/adw-tab-view.c"
22436- line="2718">Gets the title of @self.</doc>
36052+ line="2881">Gets the title of @self.</doc>
2243736053 <source-position filename="src/adw-tab-view.h" line="57"/>
2243836054 <return-value transfer-ownership="none">
2243936055 <doc xml:space="preserve"
2244036056 filename="src/adw-tab-view.c"
22441- line="2724">the title of @self</doc>
36057+ line="2887">the title of @self</doc>
2244236058 <type name="utf8" c:type="const char*"/>
2244336059 </return-value>
2244436060 <parameters>
2244536061 <instance-parameter name="self" transfer-ownership="none">
2244636062 <doc xml:space="preserve"
2244736063 filename="src/adw-tab-view.c"
22448- line="2720">a tab page</doc>
36064+ line="2883">a tab page</doc>
2244936065 <type name="TabPage" c:type="AdwTabPage*"/>
2245036066 </instance-parameter>
2245136067 </parameters>
@@ -22453,22 +36069,21 @@ See [method@TabView.set_page_pinned].</doc>
2245336069 <method name="get_tooltip"
2245436070 c:identifier="adw_tab_page_get_tooltip"
2245536071 glib:get-property="tooltip">
22456- <attribute name="org.gtk.Method.get_property" value="tooltip"/>
2245736072 <doc xml:space="preserve"
2245836073 filename="src/adw-tab-view.c"
22459- line="2767">Gets the tooltip of @self.</doc>
36074+ line="2927">Gets the tooltip of @self.</doc>
2246036075 <source-position filename="src/adw-tab-view.h" line="63"/>
2246136076 <return-value transfer-ownership="none" nullable="1">
2246236077 <doc xml:space="preserve"
2246336078 filename="src/adw-tab-view.c"
22464- line="2773">the tooltip of @self</doc>
36079+ line="2933">the tooltip of @self</doc>
2246536080 <type name="utf8" c:type="const char*"/>
2246636081 </return-value>
2246736082 <parameters>
2246836083 <instance-parameter name="self" transfer-ownership="none">
2246936084 <doc xml:space="preserve"
2247036085 filename="src/adw-tab-view.c"
22471- line="2769">a tab page</doc>
36086+ line="2929">a tab page</doc>
2247236087 <type name="TabPage" c:type="AdwTabPage*"/>
2247336088 </instance-parameter>
2247436089 </parameters>
@@ -22478,7 +36093,7 @@ See [method@TabView.set_page_pinned].</doc>
2247836093 version="1.3">
2247936094 <doc xml:space="preserve"
2248036095 filename="src/adw-tab-view.c"
22481- line="3299">Invalidates thumbnail for @self.
36096+ line="3446">Invalidates thumbnail for @self.
2248236097
2248336098 If an [class@TabOverview] is open, the thumbnail representing @self will be
2248436099 immediately updated. Otherwise it will be update when opening the overview.
@@ -22494,7 +36109,7 @@ See also [method@TabView.invalidate_thumbnails].</doc>
2249436109 <instance-parameter name="self" transfer-ownership="none">
2249536110 <doc xml:space="preserve"
2249636111 filename="src/adw-tab-view.c"
22497- line="3301">a tab page</doc>
36112+ line="3448">a tab page</doc>
2249836113 <type name="TabPage" c:type="AdwTabPage*"/>
2249936114 </instance-parameter>
2250036115 </parameters>
@@ -22502,10 +36117,9 @@ See also [method@TabView.invalidate_thumbnails].</doc>
2250236117 <method name="set_icon"
2250336118 c:identifier="adw_tab_page_set_icon"
2250436119 glib:set-property="icon">
22505- <attribute name="org.gtk.Method.set_property" value="icon"/>
2250636120 <doc xml:space="preserve"
2250736121 filename="src/adw-tab-view.c"
22508- line="2826">Sets the icon of @self.
36122+ line="2983">Sets the icon of @self.
2250936123
2251036124 [class@TabBar] and [class@TabOverview] display the icon next to the title,
2251136125 unless [property@TabPage:loading] is set to `TRUE`.
@@ -22520,7 +36134,7 @@ unless [property@TabPage:loading] is set to `TRUE`.
2252036134 <instance-parameter name="self" transfer-ownership="none">
2252136135 <doc xml:space="preserve"
2252236136 filename="src/adw-tab-view.c"
22523- line="2828">a tab page</doc>
36137+ line="2985">a tab page</doc>
2252436138 <type name="TabPage" c:type="AdwTabPage*"/>
2252536139 </instance-parameter>
2252636140 <parameter name="icon"
@@ -22529,7 +36143,7 @@ unless [property@TabPage:loading] is set to `TRUE`.
2252936143 allow-none="1">
2253036144 <doc xml:space="preserve"
2253136145 filename="src/adw-tab-view.c"
22532- line="2829">the icon of @self</doc>
36146+ line="2986">the icon of @self</doc>
2253336147 <type name="Gio.Icon" c:type="GIcon*"/>
2253436148 </parameter>
2253536149 </parameters>
@@ -22537,11 +36151,9 @@ unless [property@TabPage:loading] is set to `TRUE`.
2253736151 <method name="set_indicator_activatable"
2253836152 c:identifier="adw_tab_page_set_indicator_activatable"
2253936153 glib:set-property="indicator-activatable">
22540- <attribute name="org.gtk.Method.set_property"
22541- value="indicator-activatable"/>
2254236154 <doc xml:space="preserve"
2254336155 filename="src/adw-tab-view.c"
22544- line="3017">Sets whether the indicator of @self is activatable.
36156+ line="3167">Sets whether the indicator of @self is activatable.
2254536157
2254636158 If set to `TRUE`, [signal@TabView::indicator-activated] will be emitted
2254736159 when the indicator icon is clicked.
@@ -22555,13 +36167,13 @@ If [property@TabPage:indicator-icon] is not set, does nothing.</doc>
2255536167 <instance-parameter name="self" transfer-ownership="none">
2255636168 <doc xml:space="preserve"
2255736169 filename="src/adw-tab-view.c"
22558- line="3019">a tab page</doc>
36170+ line="3169">a tab page</doc>
2255936171 <type name="TabPage" c:type="AdwTabPage*"/>
2256036172 </instance-parameter>
2256136173 <parameter name="activatable" transfer-ownership="none">
2256236174 <doc xml:space="preserve"
2256336175 filename="src/adw-tab-view.c"
22564- line="3020">whether the indicator is activatable</doc>
36176+ line="3170">whether the indicator is activatable</doc>
2256536177 <type name="gboolean" c:type="gboolean"/>
2256636178 </parameter>
2256736179 </parameters>
@@ -22569,10 +36181,9 @@ If [property@TabPage:indicator-icon] is not set, does nothing.</doc>
2256936181 <method name="set_indicator_icon"
2257036182 c:identifier="adw_tab_page_set_indicator_icon"
2257136183 glib:set-property="indicator-icon">
22572- <attribute name="org.gtk.Method.set_property" value="indicator-icon"/>
2257336184 <doc xml:space="preserve"
2257436185 filename="src/adw-tab-view.c"
22575- line="2915">Sets the indicator icon of @self.
36186+ line="3070">Sets the indicator icon of @self.
2257636187
2257736188 A common use case is an audio or camera indicator in a web browser.
2257836189
@@ -22597,7 +36208,7 @@ indicator icon can act as a button.</doc>
2259736208 <instance-parameter name="self" transfer-ownership="none">
2259836209 <doc xml:space="preserve"
2259936210 filename="src/adw-tab-view.c"
22600- line="2917">a tab page</doc>
36211+ line="3072">a tab page</doc>
2260136212 <type name="TabPage" c:type="AdwTabPage*"/>
2260236213 </instance-parameter>
2260336214 <parameter name="indicator_icon"
@@ -22606,7 +36217,7 @@ indicator icon can act as a button.</doc>
2260636217 allow-none="1">
2260736218 <doc xml:space="preserve"
2260836219 filename="src/adw-tab-view.c"
22609- line="2918">the indicator icon of @self</doc>
36220+ line="3073">the indicator icon of @self</doc>
2261036221 <type name="Gio.Icon" c:type="GIcon*"/>
2261136222 </parameter>
2261236223 </parameters>
@@ -22615,11 +36226,9 @@ indicator icon can act as a button.</doc>
2261536226 c:identifier="adw_tab_page_set_indicator_tooltip"
2261636227 glib:set-property="indicator-tooltip"
2261736228 version="1.2">
22618- <attribute name="org.gtk.Method.set_property"
22619- value="indicator-tooltip"/>
2262036229 <doc xml:space="preserve"
2262136230 filename="src/adw-tab-view.c"
22622- line="2971">Sets the tooltip of the indicator icon of @self.
36231+ line="3124">Sets the tooltip of the indicator icon of @self.
2262336232
2262436233 The tooltip can be marked up with the Pango text markup language.
2262536234
@@ -22632,13 +36241,13 @@ See [property@TabPage:indicator-icon].</doc>
2263236241 <instance-parameter name="self" transfer-ownership="none">
2263336242 <doc xml:space="preserve"
2263436243 filename="src/adw-tab-view.c"
22635- line="2973">a tab page</doc>
36244+ line="3126">a tab page</doc>
2263636245 <type name="TabPage" c:type="AdwTabPage*"/>
2263736246 </instance-parameter>
2263836247 <parameter name="tooltip" transfer-ownership="none">
2263936248 <doc xml:space="preserve"
2264036249 filename="src/adw-tab-view.c"
22641- line="2974">the indicator tooltip of @self</doc>
36250+ line="3127">the indicator tooltip of @self</doc>
2264236251 <type name="utf8" c:type="const char*"/>
2264336252 </parameter>
2264436253 </parameters>
@@ -22647,10 +36256,9 @@ See [property@TabPage:indicator-icon].</doc>
2264736256 c:identifier="adw_tab_page_set_keyword"
2264836257 glib:set-property="keyword"
2264936258 version="1.3">
22650- <attribute name="org.gtk.Method.set_property" value="keyword"/>
2265136259 <doc xml:space="preserve"
2265236260 filename="src/adw-tab-view.c"
22653- line="3112">Sets the search keyword for @self.
36261+ line="3262">Sets the search keyword for @self.
2265436262
2265536263 [class@TabOverview] can search pages by their keywords in addition to their
2265636264 titles and tooltips.
@@ -22664,13 +36272,13 @@ Keywords allow to include e.g. page URLs into tab search in a web browser.</doc>
2266436272 <instance-parameter name="self" transfer-ownership="none">
2266536273 <doc xml:space="preserve"
2266636274 filename="src/adw-tab-view.c"
22667- line="3114">a tab page</doc>
36275+ line="3264">a tab page</doc>
2266836276 <type name="TabPage" c:type="AdwTabPage*"/>
2266936277 </instance-parameter>
2267036278 <parameter name="keyword" transfer-ownership="none">
2267136279 <doc xml:space="preserve"
2267236280 filename="src/adw-tab-view.c"
22673- line="3115">the search keyword</doc>
36281+ line="3265">the search keyword</doc>
2267436282 <type name="utf8" c:type="const char*"/>
2267536283 </parameter>
2267636284 </parameters>
@@ -22679,10 +36287,9 @@ Keywords allow to include e.g. page URLs into tab search in a web browser.</doc>
2267936287 c:identifier="adw_tab_page_set_live_thumbnail"
2268036288 glib:set-property="live-thumbnail"
2268136289 version="1.3">
22682- <attribute name="org.gtk.Method.set_property" value="live-thumbnail"/>
2268336290 <doc xml:space="preserve"
2268436291 filename="src/adw-tab-view.c"
22685- line="3263">Sets whether to enable live thumbnail for @self.
36292+ line="3410">Sets whether to enable live thumbnail for @self.
2268636293
2268736294 When set to `TRUE`, @self's thumbnail in [class@TabOverview] will update
2268836295 immediately when @self is redrawn or resized.
@@ -22699,13 +36306,13 @@ selected, and otherwise it will be static and will only update when
2269936306 <instance-parameter name="self" transfer-ownership="none">
2270036307 <doc xml:space="preserve"
2270136308 filename="src/adw-tab-view.c"
22702- line="3265">a tab page</doc>
36309+ line="3412">a tab page</doc>
2270336310 <type name="TabPage" c:type="AdwTabPage*"/>
2270436311 </instance-parameter>
2270536312 <parameter name="live_thumbnail" transfer-ownership="none">
2270636313 <doc xml:space="preserve"
2270736314 filename="src/adw-tab-view.c"
22708- line="3266">whether to enable live thumbnail</doc>
36315+ line="3413">whether to enable live thumbnail</doc>
2270936316 <type name="gboolean" c:type="gboolean"/>
2271036317 </parameter>
2271136318 </parameters>
@@ -22713,10 +36320,9 @@ selected, and otherwise it will be static and will only update when
2271336320 <method name="set_loading"
2271436321 c:identifier="adw_tab_page_set_loading"
2271536322 glib:set-property="loading">
22716- <attribute name="org.gtk.Method.set_property" value="loading"/>
2271736323 <doc xml:space="preserve"
2271836324 filename="src/adw-tab-view.c"
22719- line="2870">Sets whether @self is loading.
36325+ line="3025">Sets whether @self is loading.
2272036326
2272136327 If set to `TRUE`, [class@TabBar] and [class@TabOverview] will display a
2272236328 spinner in place of icon.
@@ -22731,13 +36337,13 @@ status will not be visible with `AdwTabBar`.</doc>
2273136337 <instance-parameter name="self" transfer-ownership="none">
2273236338 <doc xml:space="preserve"
2273336339 filename="src/adw-tab-view.c"
22734- line="2872">a tab page</doc>
36340+ line="3027">a tab page</doc>
2273536341 <type name="TabPage" c:type="AdwTabPage*"/>
2273636342 </instance-parameter>
2273736343 <parameter name="loading" transfer-ownership="none">
2273836344 <doc xml:space="preserve"
2273936345 filename="src/adw-tab-view.c"
22740- line="2873">whether @self is loading</doc>
36346+ line="3028">whether @self is loading</doc>
2274136347 <type name="gboolean" c:type="gboolean"/>
2274236348 </parameter>
2274336349 </parameters>
@@ -22745,10 +36351,9 @@ status will not be visible with `AdwTabBar`.</doc>
2274536351 <method name="set_needs_attention"
2274636352 c:identifier="adw_tab_page_set_needs_attention"
2274736353 glib:set-property="needs-attention">
22748- <attribute name="org.gtk.Method.set_property" value="needs-attention"/>
2274936354 <doc xml:space="preserve"
2275036355 filename="src/adw-tab-view.c"
22751- line="3061">Sets whether @self needs attention.
36356+ line="3211">Sets whether @self needs attention.
2275236357
2275336358 [class@TabBar] will display a line under the tab representing the page if
2275436359 set to `TRUE`. If the tab is not visible, the corresponding edge of the tab
@@ -22767,13 +36372,13 @@ selected have [property@TabPage:needs-attention] set to `TRUE`.</doc>
2276736372 <instance-parameter name="self" transfer-ownership="none">
2276836373 <doc xml:space="preserve"
2276936374 filename="src/adw-tab-view.c"
22770- line="3063">a tab page</doc>
36375+ line="3213">a tab page</doc>
2277136376 <type name="TabPage" c:type="AdwTabPage*"/>
2277236377 </instance-parameter>
2277336378 <parameter name="needs_attention" transfer-ownership="none">
2277436379 <doc xml:space="preserve"
2277536380 filename="src/adw-tab-view.c"
22776- line="3064">whether @self needs attention</doc>
36381+ line="3214">whether @self needs attention</doc>
2277736382 <type name="gboolean" c:type="gboolean"/>
2277836383 </parameter>
2277936384 </parameters>
@@ -22782,11 +36387,9 @@ selected have [property@TabPage:needs-attention] set to `TRUE`.</doc>
2278236387 c:identifier="adw_tab_page_set_thumbnail_xalign"
2278336388 glib:set-property="thumbnail-xalign"
2278436389 version="1.3">
22785- <attribute name="org.gtk.Method.set_property"
22786- value="thumbnail-xalign"/>
2278736390 <doc xml:space="preserve"
2278836391 filename="src/adw-tab-view.c"
22789- line="3159">Sets the horizontal alignment of the thumbnail for @self.
36392+ line="3306">Sets the horizontal alignment of the thumbnail for @self.
2279036393
2279136394 If the page is so wide that [class@TabOverview] can't display it completely
2279236395 and has to crop it, horizontal alignment will determine which part of the
@@ -22804,13 +36407,13 @@ The default horizontal alignment is 0.</doc>
2280436407 <instance-parameter name="self" transfer-ownership="none">
2280536408 <doc xml:space="preserve"
2280636409 filename="src/adw-tab-view.c"
22807- line="3161">a tab page</doc>
36410+ line="3308">a tab page</doc>
2280836411 <type name="TabPage" c:type="AdwTabPage*"/>
2280936412 </instance-parameter>
2281036413 <parameter name="xalign" transfer-ownership="none">
2281136414 <doc xml:space="preserve"
2281236415 filename="src/adw-tab-view.c"
22813- line="3162">the new value</doc>
36416+ line="3309">the new value</doc>
2281436417 <type name="gfloat" c:type="float"/>
2281536418 </parameter>
2281636419 </parameters>
@@ -22819,11 +36422,9 @@ The default horizontal alignment is 0.</doc>
2281936422 c:identifier="adw_tab_page_set_thumbnail_yalign"
2282036423 glib:set-property="thumbnail-yalign"
2282136424 version="1.3">
22822- <attribute name="org.gtk.Method.set_property"
22823- value="thumbnail-yalign"/>
2282436425 <doc xml:space="preserve"
2282536426 filename="src/adw-tab-view.c"
22826- line="3211">Sets the vertical alignment of the thumbnail for @self.
36427+ line="3358">Sets the vertical alignment of the thumbnail for @self.
2282736428
2282836429 If the page is so tall that [class@TabOverview] can't display it completely
2282936430 and has to crop it, vertical alignment will determine which part of the page
@@ -22841,13 +36442,13 @@ The default vertical alignment is 0.</doc>
2284136442 <instance-parameter name="self" transfer-ownership="none">
2284236443 <doc xml:space="preserve"
2284336444 filename="src/adw-tab-view.c"
22844- line="3213">a tab page</doc>
36445+ line="3360">a tab page</doc>
2284536446 <type name="TabPage" c:type="AdwTabPage*"/>
2284636447 </instance-parameter>
2284736448 <parameter name="yalign" transfer-ownership="none">
2284836449 <doc xml:space="preserve"
2284936450 filename="src/adw-tab-view.c"
22850- line="3214">the new value</doc>
36451+ line="3361">the new value</doc>
2285136452 <type name="gfloat" c:type="float"/>
2285236453 </parameter>
2285336454 </parameters>
@@ -22855,10 +36456,9 @@ The default vertical alignment is 0.</doc>
2285536456 <method name="set_title"
2285636457 c:identifier="adw_tab_page_set_title"
2285736458 glib:set-property="title">
22858- <attribute name="org.gtk.Method.set_property" value="title"/>
2285936459 <doc xml:space="preserve"
2286036460 filename="src/adw-tab-view.c"
22861- line="2734">[class@TabBar] will display it in the center of the tab unless it's pinned,
36461+ line="2897">[class@TabBar] will display it in the center of the tab unless it's pinned,
2286236462 and will use it as a tooltip unless [property@TabPage:tooltip] is set.
2286336463
2286436464 [class@TabOverview] will display it below the thumbnail unless it's pinned,
@@ -22874,13 +36474,13 @@ Sets the title of @self.</doc>
2287436474 <instance-parameter name="self" transfer-ownership="none">
2287536475 <doc xml:space="preserve"
2287636476 filename="src/adw-tab-view.c"
22877- line="2736">a tab page</doc>
36477+ line="2899">a tab page</doc>
2287836478 <type name="TabPage" c:type="AdwTabPage*"/>
2287936479 </instance-parameter>
2288036480 <parameter name="title" transfer-ownership="none">
2288136481 <doc xml:space="preserve"
2288236482 filename="src/adw-tab-view.c"
22883- line="2737">the title of @self</doc>
36483+ line="2900">the title of @self</doc>
2288436484 <type name="utf8" c:type="const char*"/>
2288536485 </parameter>
2288636486 </parameters>
@@ -22888,10 +36488,9 @@ Sets the title of @self.</doc>
2288836488 <method name="set_tooltip"
2288936489 c:identifier="adw_tab_page_set_tooltip"
2289036490 glib:set-property="tooltip">
22891- <attribute name="org.gtk.Method.set_property" value="tooltip"/>
2289236491 <doc xml:space="preserve"
2289336492 filename="src/adw-tab-view.c"
22894- line="2783">Sets the tooltip of @self.
36493+ line="2943">Sets the tooltip of @self.
2289536494
2289636495 The tooltip can be marked up with the Pango text markup language.
2289736496
@@ -22905,13 +36504,13 @@ If not set, [class@TabBar] and [class@TabOverview] will use
2290536504 <instance-parameter name="self" transfer-ownership="none">
2290636505 <doc xml:space="preserve"
2290736506 filename="src/adw-tab-view.c"
22908- line="2785">a tab page</doc>
36507+ line="2945">a tab page</doc>
2290936508 <type name="TabPage" c:type="AdwTabPage*"/>
2291036509 </instance-parameter>
2291136510 <parameter name="tooltip" transfer-ownership="none">
2291236511 <doc xml:space="preserve"
2291336512 filename="src/adw-tab-view.c"
22914- line="2786">the tooltip of @self</doc>
36513+ line="2946">the tooltip of @self</doc>
2291536514 <type name="utf8" c:type="const char*"/>
2291636515 </parameter>
2291736516 </parameters>
@@ -22921,10 +36520,9 @@ If not set, [class@TabBar] and [class@TabOverview] will use
2292136520 construct-only="1"
2292236521 transfer-ownership="none"
2292336522 getter="get_child">
22924- <attribute name="org.gtk.Property.get" value="adw_tab_page_get_child"/>
2292536523 <doc xml:space="preserve"
2292636524 filename="src/adw-tab-view.c"
22927- line="557">The child of the page.</doc>
36525+ line="558">The child of the page.</doc>
2292836526 <type name="Gtk.Widget"/>
2292936527 </property>
2293036528 <property name="icon"
@@ -22932,11 +36530,9 @@ If not set, [class@TabBar] and [class@TabOverview] will use
2293236530 transfer-ownership="none"
2293336531 setter="set_icon"
2293436532 getter="get_icon">
22935- <attribute name="org.gtk.Property.get" value="adw_tab_page_get_icon"/>
22936- <attribute name="org.gtk.Property.set" value="adw_tab_page_set_icon"/>
2293736533 <doc xml:space="preserve"
2293836534 filename="src/adw-tab-view.c"
22939- line="633">The icon of the page.
36535+ line="634">The icon of the page.
2294036536
2294136537 [class@TabBar] and [class@TabOverview] display the icon next to the title,
2294236538 unless [property@TabPage:loading] is set to `TRUE`.
@@ -22951,13 +36547,9 @@ unless [property@TabPage:loading] is set to `TRUE`.
2295136547 setter="set_indicator_activatable"
2295236548 getter="get_indicator_activatable"
2295336549 default-value="FALSE">
22954- <attribute name="org.gtk.Property.get"
22955- value="adw_tab_page_get_indicator_activatable"/>
22956- <attribute name="org.gtk.Property.set"
22957- value="adw_tab_page_set_indicator_activatable"/>
2295836550 <doc xml:space="preserve"
2295936551 filename="src/adw-tab-view.c"
22960- line="707">Whether the indicator icon is activatable.
36552+ line="708">Whether the indicator icon is activatable.
2296136553
2296236554 If set to `TRUE`, [signal@TabView::indicator-activated] will be emitted
2296336555 when the indicator icon is clicked.
@@ -22970,13 +36562,9 @@ If [property@TabPage:indicator-icon] is not set, does nothing.</doc>
2297036562 transfer-ownership="none"
2297136563 setter="set_indicator_icon"
2297236564 getter="get_indicator_icon">
22973- <attribute name="org.gtk.Property.get"
22974- value="adw_tab_page_get_indicator_icon"/>
22975- <attribute name="org.gtk.Property.set"
22976- value="adw_tab_page_set_indicator_icon"/>
2297736565 <doc xml:space="preserve"
2297836566 filename="src/adw-tab-view.c"
22979- line="665">An indicator icon for the page.
36567+ line="666">An indicator icon for the page.
2298036568
2298136569 A common use case is an audio or camera indicator in a web browser.
2298236570
@@ -23001,13 +36589,9 @@ indicator icon can act as a button.</doc>
2300136589 transfer-ownership="none"
2300236590 setter="set_indicator_tooltip"
2300336591 getter="get_indicator_tooltip">
23004- <attribute name="org.gtk.Property.get"
23005- value="adw_tab_page_get_indicator_tooltip"/>
23006- <attribute name="org.gtk.Property.set"
23007- value="adw_tab_page_set_indicator_tooltip"/>
2300836592 <doc xml:space="preserve"
2300936593 filename="src/adw-tab-view.c"
23010- line="691">The tooltip of the indicator icon.
36594+ line="692">The tooltip of the indicator icon.
2301136595
2301236596 The tooltip can be marked up with the Pango text markup language.
2301336597
@@ -23020,13 +36604,9 @@ See [property@TabPage:indicator-icon].</doc>
2302036604 transfer-ownership="none"
2302136605 setter="set_keyword"
2302236606 getter="get_keyword">
23023- <attribute name="org.gtk.Property.get"
23024- value="adw_tab_page_get_keyword"/>
23025- <attribute name="org.gtk.Property.set"
23026- value="adw_tab_page_set_keyword"/>
2302736607 <doc xml:space="preserve"
2302836608 filename="src/adw-tab-view.c"
23029- line="742">The search keyboard of the page.
36609+ line="743">The search keyboard of the page.
2303036610
2303136611 [class@TabOverview] can search pages by their keywords in addition to their
2303236612 titles and tooltips.
@@ -23041,13 +36621,9 @@ Keywords allow to include e.g. page URLs into tab search in a web browser.</doc>
2304136621 setter="set_live_thumbnail"
2304236622 getter="get_live_thumbnail"
2304336623 default-value="FALSE">
23044- <attribute name="org.gtk.Property.get"
23045- value="adw_tab_page_get_live_thumbnail"/>
23046- <attribute name="org.gtk.Property.set"
23047- value="adw_tab_page_set_live_thumbnail"/>
2304836624 <doc xml:space="preserve"
2304936625 filename="src/adw-tab-view.c"
23050- line="803">Whether to enable live thumbnail for this page.
36626+ line="804">Whether to enable live thumbnail for this page.
2305136627
2305236628 When set to `TRUE`, the page's thumbnail in [class@TabOverview] will update
2305336629 immediately when the page is redrawn or resized.
@@ -23064,13 +36640,9 @@ selected, and otherwise it will be static and will only update when
2306436640 setter="set_loading"
2306536641 getter="get_loading"
2306636642 default-value="FALSE">
23067- <attribute name="org.gtk.Property.get"
23068- value="adw_tab_page_get_loading"/>
23069- <attribute name="org.gtk.Property.set"
23070- value="adw_tab_page_set_loading"/>
2307136643 <doc xml:space="preserve"
2307236644 filename="src/adw-tab-view.c"
23073- line="649">Whether the page is loading.
36645+ line="650">Whether the page is loading.
2307436646
2307536647 If set to `TRUE`, [class@TabBar] and [class@TabOverview] will display a
2307636648 spinner in place of icon.
@@ -23085,13 +36657,9 @@ loading status will not be visible with `AdwTabBar`.</doc>
2308536657 setter="set_needs_attention"
2308636658 getter="get_needs_attention"
2308736659 default-value="FALSE">
23088- <attribute name="org.gtk.Property.get"
23089- value="adw_tab_page_get_needs_attention"/>
23090- <attribute name="org.gtk.Property.set"
23091- value="adw_tab_page_set_needs_attention"/>
2309236660 <doc xml:space="preserve"
2309336661 filename="src/adw-tab-view.c"
23094- line="722">Whether the page needs attention.
36662+ line="723">Whether the page needs attention.
2309536663
2309636664 [class@TabBar] will display a line under the tab representing the page if
2309736665 set to `TRUE`. If the tab is not visible, the corresponding edge of the tab
@@ -23109,11 +36677,9 @@ selected have this property set to `TRUE`.</doc>
2310936677 construct-only="1"
2311036678 transfer-ownership="none"
2311136679 getter="get_parent">
23112- <attribute name="org.gtk.Property.get"
23113- value="adw_tab_page_get_parent"/>
2311436680 <doc xml:space="preserve"
2311536681 filename="src/adw-tab-view.c"
23116- line="567">The parent page of the page.
36682+ line="568">The parent page of the page.
2311736683
2311836684 See [method@TabView.add_page] and [method@TabView.close_page].</doc>
2311936685 <type name="TabPage"/>
@@ -23122,11 +36688,9 @@ See [method@TabView.add_page] and [method@TabView.close_page].</doc>
2312236688 transfer-ownership="none"
2312336689 getter="get_pinned"
2312436690 default-value="FALSE">
23125- <attribute name="org.gtk.Property.get"
23126- value="adw_tab_page_get_pinned"/>
2312736691 <doc xml:space="preserve"
2312836692 filename="src/adw-tab-view.c"
23129- line="589">Whether the page is pinned.
36693+ line="590">Whether the page is pinned.
2313036694
2313136695 See [method@TabView.set_page_pinned].</doc>
2313236696 <type name="gboolean" c:type="gboolean"/>
@@ -23135,11 +36699,9 @@ See [method@TabView.set_page_pinned].</doc>
2313536699 transfer-ownership="none"
2313636700 getter="get_selected"
2313736701 default-value="FALSE">
23138- <attribute name="org.gtk.Property.get"
23139- value="adw_tab_page_get_selected"/>
2314036702 <doc xml:space="preserve"
2314136703 filename="src/adw-tab-view.c"
23142- line="579">Whether the page is selected.</doc>
36704+ line="580">Whether the page is selected.</doc>
2314336705 <type name="gboolean" c:type="gboolean"/>
2314436706 </property>
2314536707 <property name="thumbnail-xalign"
@@ -23149,13 +36711,9 @@ See [method@TabView.set_page_pinned].</doc>
2314936711 setter="set_thumbnail_xalign"
2315036712 getter="get_thumbnail_xalign"
2315136713 default-value="0.000000">
23152- <attribute name="org.gtk.Property.get"
23153- value="adw_tab_page_get_thumbnail_xalign"/>
23154- <attribute name="org.gtk.Property.set"
23155- value="adw_tab_page_set_thumbnail_xalign"/>
2315636714 <doc xml:space="preserve"
2315736715 filename="src/adw-tab-view.c"
23158- line="759">The horizontal alignment of the page thumbnail.
36716+ line="760">The horizontal alignment of the page thumbnail.
2315936717
2316036718 If the page is so wide that [class@TabOverview] can't display it completely
2316136719 and has to crop it, horizontal alignment will determine which part of the
@@ -23174,13 +36732,9 @@ The default horizontal alignment is 0.</doc>
2317436732 setter="set_thumbnail_yalign"
2317536733 getter="get_thumbnail_yalign"
2317636734 default-value="0.000000">
23177- <attribute name="org.gtk.Property.get"
23178- value="adw_tab_page_get_thumbnail_yalign"/>
23179- <attribute name="org.gtk.Property.set"
23180- value="adw_tab_page_set_thumbnail_yalign"/>
2318136735 <doc xml:space="preserve"
2318236736 filename="src/adw-tab-view.c"
23183- line="781">The vertical alignment of the page thumbnail.
36737+ line="782">The vertical alignment of the page thumbnail.
2318436738
2318536739 If the page is so tall that [class@TabOverview] can't display it completely
2318636740 and has to crop it, vertical alignment will determine which part of the
@@ -23197,11 +36751,9 @@ The default vertical alignment is 0.</doc>
2319736751 transfer-ownership="none"
2319836752 setter="set_title"
2319936753 getter="get_title">
23200- <attribute name="org.gtk.Property.get" value="adw_tab_page_get_title"/>
23201- <attribute name="org.gtk.Property.set" value="adw_tab_page_set_title"/>
2320236754 <doc xml:space="preserve"
2320336755 filename="src/adw-tab-view.c"
23204- line="601">The title of the page.
36756+ line="602">The title of the page.
2320536757
2320636758 [class@TabBar] will display it in the center of the tab unless it's pinned,
2320736759 and will use it as a tooltip unless [property@TabPage:tooltip] is set.
@@ -23216,13 +36768,9 @@ or inside the card otherwise, and will use it as a tooltip unless
2321636768 transfer-ownership="none"
2321736769 setter="set_tooltip"
2321836770 getter="get_tooltip">
23219- <attribute name="org.gtk.Property.get"
23220- value="adw_tab_page_get_tooltip"/>
23221- <attribute name="org.gtk.Property.set"
23222- value="adw_tab_page_set_tooltip"/>
2322336771 <doc xml:space="preserve"
2322436772 filename="src/adw-tab-view.c"
23225- line="618">The tooltip of the page.
36773+ line="619">The tooltip of the page.
2322636774
2322736775 The tooltip can be marked up with the Pango text markup language.
2322836776
@@ -23249,7 +36797,7 @@ If not set, [class@TabBar] and [class@TabOverview] will use
2324936797 glib:type-struct="TabViewClass">
2325036798 <doc xml:space="preserve"
2325136799 filename="src/adw-tab-view.c"
23252- line="27">A dynamic tabbed container.
36800+ line="31">A dynamic tabbed container.
2325336801
2325436802 `AdwTabView` is a container which shows one child at a time. While it
2325536803 provides keyboard shortcuts for switching between pages, it does not provide
@@ -23297,19 +36845,19 @@ are the accessible parent objects of the child widgets.</doc>
2329736845 <constructor name="new" c:identifier="adw_tab_view_new">
2329836846 <doc xml:space="preserve"
2329936847 filename="src/adw-tab-view.c"
23300- line="3335">Creates a new `AdwTabView`.</doc>
36848+ line="3485">Creates a new `AdwTabView`.</doc>
2330136849 <source-position filename="src/adw-tab-view.h" line="137"/>
2330236850 <return-value transfer-ownership="none">
2330336851 <doc xml:space="preserve"
2330436852 filename="src/adw-tab-view.c"
23305- line="3340">the newly created `AdwTabView`</doc>
36853+ line="3490">the newly created `AdwTabView`</doc>
2330636854 <type name="TabView" c:type="AdwTabView*"/>
2330736855 </return-value>
2330836856 </constructor>
2330936857 <method name="add_page" c:identifier="adw_tab_view_add_page">
2331036858 <doc xml:space="preserve"
2331136859 filename="src/adw-tab-view.c"
23312- line="3918">Adds @child to @self with @parent as the parent.
36860+ line="4068">Adds @child to @self with @parent as the parent.
2331336861
2331436862 This function can be used to automatically position new pages, and to select
2331536863 the correct page when this page is closed while being selected (see
@@ -23320,20 +36868,20 @@ If @parent is `NULL`, this function is equivalent to [method@TabView.append].</d
2332036868 <return-value transfer-ownership="none">
2332136869 <doc xml:space="preserve"
2332236870 filename="src/adw-tab-view.c"
23323- line="3932">the page object representing @child</doc>
36871+ line="4082">the page object representing @child</doc>
2332436872 <type name="TabPage" c:type="AdwTabPage*"/>
2332536873 </return-value>
2332636874 <parameters>
2332736875 <instance-parameter name="self" transfer-ownership="none">
2332836876 <doc xml:space="preserve"
2332936877 filename="src/adw-tab-view.c"
23330- line="3920">a tab view</doc>
36878+ line="4070">a tab view</doc>
2333136879 <type name="TabView" c:type="AdwTabView*"/>
2333236880 </instance-parameter>
2333336881 <parameter name="child" transfer-ownership="none">
2333436882 <doc xml:space="preserve"
2333536883 filename="src/adw-tab-view.c"
23336- line="3921">a widget to add</doc>
36884+ line="4071">a widget to add</doc>
2333736885 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2333836886 </parameter>
2333936887 <parameter name="parent"
@@ -23342,7 +36890,7 @@ If @parent is `NULL`, this function is equivalent to [method@TabView.append].</d
2334236890 allow-none="1">
2334336891 <doc xml:space="preserve"
2334436892 filename="src/adw-tab-view.c"
23345- line="3922">a parent page for @child</doc>
36893+ line="4072">a parent page for @child</doc>
2334636894 <type name="TabPage" c:type="AdwTabPage*"/>
2334736895 </parameter>
2334836896 </parameters>
@@ -23352,7 +36900,7 @@ If @parent is `NULL`, this function is equivalent to [method@TabView.append].</d
2335236900 version="1.2">
2335336901 <doc xml:space="preserve"
2335436902 filename="src/adw-tab-view.c"
23355- line="3714">Adds @shortcuts for @self.
36903+ line="3864">Adds @shortcuts for @self.
2335636904
2335736905 See [property@TabView:shortcuts] for details.</doc>
2335836906 <source-position filename="src/adw-tab-view.h" line="176"/>
@@ -23363,13 +36911,13 @@ See [property@TabView:shortcuts] for details.</doc>
2336336911 <instance-parameter name="self" transfer-ownership="none">
2336436912 <doc xml:space="preserve"
2336536913 filename="src/adw-tab-view.c"
23366- line="3716">a tab view</doc>
36914+ line="3866">a tab view</doc>
2336736915 <type name="TabView" c:type="AdwTabView*"/>
2336836916 </instance-parameter>
2336936917 <parameter name="shortcuts" transfer-ownership="none">
2337036918 <doc xml:space="preserve"
2337136919 filename="src/adw-tab-view.c"
23372- line="3717">the shortcuts to add</doc>
36920+ line="3867">the shortcuts to add</doc>
2337336921 <type name="TabViewShortcuts" c:type="AdwTabViewShortcuts"/>
2337436922 </parameter>
2337536923 </parameters>
@@ -23377,25 +36925,25 @@ See [property@TabView:shortcuts] for details.</doc>
2337736925 <method name="append" c:identifier="adw_tab_view_append">
2337836926 <doc xml:space="preserve"
2337936927 filename="src/adw-tab-view.c"
23380- line="4015">Inserts @child as the last non-pinned page.</doc>
36928+ line="4168">Inserts @child as the last non-pinned page.</doc>
2338136929 <source-position filename="src/adw-tab-view.h" line="212"/>
2338236930 <return-value transfer-ownership="none">
2338336931 <doc xml:space="preserve"
2338436932 filename="src/adw-tab-view.c"
23385- line="4022">the page object representing @child</doc>
36933+ line="4175">the page object representing @child</doc>
2338636934 <type name="TabPage" c:type="AdwTabPage*"/>
2338736935 </return-value>
2338836936 <parameters>
2338936937 <instance-parameter name="self" transfer-ownership="none">
2339036938 <doc xml:space="preserve"
2339136939 filename="src/adw-tab-view.c"
23392- line="4017">a tab view</doc>
36940+ line="4170">a tab view</doc>
2339336941 <type name="TabView" c:type="AdwTabView*"/>
2339436942 </instance-parameter>
2339536943 <parameter name="child" transfer-ownership="none">
2339636944 <doc xml:space="preserve"
2339736945 filename="src/adw-tab-view.c"
23398- line="4018">a widget to add</doc>
36946+ line="4171">a widget to add</doc>
2339936947 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2340036948 </parameter>
2340136949 </parameters>
@@ -23403,25 +36951,25 @@ See [property@TabView:shortcuts] for details.</doc>
2340336951 <method name="append_pinned" c:identifier="adw_tab_view_append_pinned">
2340436952 <doc xml:space="preserve"
2340536953 filename="src/adw-tab-view.c"
23406- line="4079">Inserts @child as the last pinned page.</doc>
36954+ line="4234">Inserts @child as the last pinned page.</doc>
2340736955 <source-position filename="src/adw-tab-view.h" line="223"/>
2340836956 <return-value transfer-ownership="none">
2340936957 <doc xml:space="preserve"
2341036958 filename="src/adw-tab-view.c"
23411- line="4086">the page object representing @child</doc>
36959+ line="4241">the page object representing @child</doc>
2341236960 <type name="TabPage" c:type="AdwTabPage*"/>
2341336961 </return-value>
2341436962 <parameters>
2341536963 <instance-parameter name="self" transfer-ownership="none">
2341636964 <doc xml:space="preserve"
2341736965 filename="src/adw-tab-view.c"
23418- line="4081">a tab view</doc>
36966+ line="4236">a tab view</doc>
2341936967 <type name="TabView" c:type="AdwTabView*"/>
2342036968 </instance-parameter>
2342136969 <parameter name="child" transfer-ownership="none">
2342236970 <doc xml:space="preserve"
2342336971 filename="src/adw-tab-view.c"
23424- line="4082">a widget to add</doc>
36972+ line="4237">a widget to add</doc>
2342536973 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2342636974 </parameter>
2342736975 </parameters>
@@ -23430,7 +36978,7 @@ See [property@TabView:shortcuts] for details.</doc>
2343036978 c:identifier="adw_tab_view_close_other_pages">
2343136979 <doc xml:space="preserve"
2343236980 filename="src/adw-tab-view.c"
23433- line="4179">Requests to close all pages other than @page.</doc>
36981+ line="4335">Requests to close all pages other than @page.</doc>
2343436982 <source-position filename="src/adw-tab-view.h" line="235"/>
2343536983 <return-value transfer-ownership="none">
2343636984 <type name="none" c:type="void"/>
@@ -23439,13 +36987,13 @@ See [property@TabView:shortcuts] for details.</doc>
2343936987 <instance-parameter name="self" transfer-ownership="none">
2344036988 <doc xml:space="preserve"
2344136989 filename="src/adw-tab-view.c"
23442- line="4181">a tab view</doc>
36990+ line="4337">a tab view</doc>
2344336991 <type name="TabView" c:type="AdwTabView*"/>
2344436992 </instance-parameter>
2344536993 <parameter name="page" transfer-ownership="none">
2344636994 <doc xml:space="preserve"
2344736995 filename="src/adw-tab-view.c"
23448- line="4182">a page of @self</doc>
36996+ line="4338">a page of @self</doc>
2344936997 <type name="TabPage" c:type="AdwTabPage*"/>
2345036998 </parameter>
2345136999 </parameters>
@@ -23453,7 +37001,7 @@ See [property@TabView:shortcuts] for details.</doc>
2345337001 <method name="close_page" c:identifier="adw_tab_view_close_page">
2345437002 <doc xml:space="preserve"
2345537003 filename="src/adw-tab-view.c"
23456- line="4098">Requests to close @page.
37004+ line="4254">Requests to close @page.
2345737005
2345837006 Calling this function will result in the [signal@TabView::close-page] signal
2345937007 being emitted for @page. Closing the page can then be confirmed or
@@ -23483,13 +37031,13 @@ are pinned, the parent will be selected instead.</doc>
2348337031 <instance-parameter name="self" transfer-ownership="none">
2348437032 <doc xml:space="preserve"
2348537033 filename="src/adw-tab-view.c"
23486- line="4100">a tab view</doc>
37034+ line="4256">a tab view</doc>
2348737035 <type name="TabView" c:type="AdwTabView*"/>
2348837036 </instance-parameter>
2348937037 <parameter name="page" transfer-ownership="none">
2349037038 <doc xml:space="preserve"
2349137039 filename="src/adw-tab-view.c"
23492- line="4101">a page of @self</doc>
37040+ line="4257">a page of @self</doc>
2349337041 <type name="TabPage" c:type="AdwTabPage*"/>
2349437042 </parameter>
2349537043 </parameters>
@@ -23498,7 +37046,7 @@ are pinned, the parent will be selected instead.</doc>
2349837046 c:identifier="adw_tab_view_close_page_finish">
2349937047 <doc xml:space="preserve"
2350037048 filename="src/adw-tab-view.c"
23501- line="4143">Completes a [method@TabView.close_page] call for @page.
37049+ line="4299">Completes a [method@TabView.close_page] call for @page.
2350237050
2350337051 If @confirm is `TRUE`, @page will be closed. If it's `FALSE`, it will be
2350437052 reverted to its previous state and [method@TabView.close_page] can be called
@@ -23514,19 +37062,19 @@ This function should not be called unless a custom handler for
2351437062 <instance-parameter name="self" transfer-ownership="none">
2351537063 <doc xml:space="preserve"
2351637064 filename="src/adw-tab-view.c"
23517- line="4145">a tab view</doc>
37065+ line="4301">a tab view</doc>
2351837066 <type name="TabView" c:type="AdwTabView*"/>
2351937067 </instance-parameter>
2352037068 <parameter name="page" transfer-ownership="none">
2352137069 <doc xml:space="preserve"
2352237070 filename="src/adw-tab-view.c"
23523- line="4146">a page of @self</doc>
37071+ line="4302">a page of @self</doc>
2352437072 <type name="TabPage" c:type="AdwTabPage*"/>
2352537073 </parameter>
2352637074 <parameter name="confirm" transfer-ownership="none">
2352737075 <doc xml:space="preserve"
2352837076 filename="src/adw-tab-view.c"
23529- line="4147">whether to confirm or deny closing @page</doc>
37077+ line="4303">whether to confirm or deny closing @page</doc>
2353037078 <type name="gboolean" c:type="gboolean"/>
2353137079 </parameter>
2353237080 </parameters>
@@ -23535,7 +37083,7 @@ This function should not be called unless a custom handler for
2353537083 c:identifier="adw_tab_view_close_pages_after">
2353637084 <doc xml:space="preserve"
2353737085 filename="src/adw-tab-view.c"
23538- line="4232">Requests to close all pages after @page.</doc>
37086+ line="4388">Requests to close all pages after @page.</doc>
2353937087 <source-position filename="src/adw-tab-view.h" line="241"/>
2354037088 <return-value transfer-ownership="none">
2354137089 <type name="none" c:type="void"/>
@@ -23544,13 +37092,13 @@ This function should not be called unless a custom handler for
2354437092 <instance-parameter name="self" transfer-ownership="none">
2354537093 <doc xml:space="preserve"
2354637094 filename="src/adw-tab-view.c"
23547- line="4234">a tab view</doc>
37095+ line="4390">a tab view</doc>
2354837096 <type name="TabView" c:type="AdwTabView*"/>
2354937097 </instance-parameter>
2355037098 <parameter name="page" transfer-ownership="none">
2355137099 <doc xml:space="preserve"
2355237100 filename="src/adw-tab-view.c"
23553- line="4235">a page of @self</doc>
37101+ line="4391">a page of @self</doc>
2355437102 <type name="TabPage" c:type="AdwTabPage*"/>
2355537103 </parameter>
2355637104 </parameters>
@@ -23559,7 +37107,7 @@ This function should not be called unless a custom handler for
2355937107 c:identifier="adw_tab_view_close_pages_before">
2356037108 <doc xml:space="preserve"
2356137109 filename="src/adw-tab-view.c"
23562- line="4206">Requests to close all pages before @page.</doc>
37110+ line="4362">Requests to close all pages before @page.</doc>
2356337111 <source-position filename="src/adw-tab-view.h" line="238"/>
2356437112 <return-value transfer-ownership="none">
2356537113 <type name="none" c:type="void"/>
@@ -23568,13 +37116,13 @@ This function should not be called unless a custom handler for
2356837116 <instance-parameter name="self" transfer-ownership="none">
2356937117 <doc xml:space="preserve"
2357037118 filename="src/adw-tab-view.c"
23571- line="4208">a tab view</doc>
37119+ line="4364">a tab view</doc>
2357237120 <type name="TabView" c:type="AdwTabView*"/>
2357337121 </instance-parameter>
2357437122 <parameter name="page" transfer-ownership="none">
2357537123 <doc xml:space="preserve"
2357637124 filename="src/adw-tab-view.c"
23577- line="4209">a page of @self</doc>
37125+ line="4365">a page of @self</doc>
2357837126 <type name="TabPage" c:type="AdwTabPage*"/>
2357937127 </parameter>
2358037128 </parameters>
@@ -23582,22 +37130,21 @@ This function should not be called unless a custom handler for
2358237130 <method name="get_default_icon"
2358337131 c:identifier="adw_tab_view_get_default_icon"
2358437132 glib:get-property="default-icon">
23585- <attribute name="org.gtk.Method.get_property" value="default-icon"/>
2358637133 <doc xml:space="preserve"
2358737134 filename="src/adw-tab-view.c"
23588- line="3567">Gets the default icon of @self.</doc>
37135+ line="3717">Gets the default icon of @self.</doc>
2358937136 <source-position filename="src/adw-tab-view.h" line="159"/>
2359037137 <return-value transfer-ownership="none">
2359137138 <doc xml:space="preserve"
2359237139 filename="src/adw-tab-view.c"
23593- line="3573">the default icon of @self.</doc>
37140+ line="3723">the default icon of @self.</doc>
2359437141 <type name="Gio.Icon" c:type="GIcon*"/>
2359537142 </return-value>
2359637143 <parameters>
2359737144 <instance-parameter name="self" transfer-ownership="none">
2359837145 <doc xml:space="preserve"
2359937146 filename="src/adw-tab-view.c"
23600- line="3569">a tab view</doc>
37147+ line="3719">a tab view</doc>
2360137148 <type name="TabView" c:type="AdwTabView*"/>
2360237149 </instance-parameter>
2360337150 </parameters>
@@ -23605,11 +37152,9 @@ This function should not be called unless a custom handler for
2360537152 <method name="get_is_transferring_page"
2360637153 c:identifier="adw_tab_view_get_is_transferring_page"
2360737154 glib:get-property="is-transferring-page">
23608- <attribute name="org.gtk.Method.get_property"
23609- value="is-transferring-page"/>
2361037155 <doc xml:space="preserve"
2361137156 filename="src/adw-tab-view.c"
23612- line="3382">Whether a page is being transferred.
37157+ line="3532">Whether a page is being transferred.
2361337158
2361437159 The corresponding property will be set to `TRUE` when a drag-n-drop tab
2361537160 transfer starts on any `AdwTabView`, and to `FALSE` after it ends.
@@ -23620,14 +37165,14 @@ be safely dropped on the tab view.</doc>
2362037165 <return-value transfer-ownership="none">
2362137166 <doc xml:space="preserve"
2362237167 filename="src/adw-tab-view.c"
23623- line="3394">whether a page is being transferred</doc>
37168+ line="3544">whether a page is being transferred</doc>
2362437169 <type name="gboolean" c:type="gboolean"/>
2362537170 </return-value>
2362637171 <parameters>
2362737172 <instance-parameter name="self" transfer-ownership="none">
2362837173 <doc xml:space="preserve"
2362937174 filename="src/adw-tab-view.c"
23630- line="3384">a tab view</doc>
37175+ line="3534">a tab view</doc>
2363137176 <type name="TabView" c:type="AdwTabView*"/>
2363237177 </instance-parameter>
2363337178 </parameters>
@@ -23635,22 +37180,21 @@ be safely dropped on the tab view.</doc>
2363537180 <method name="get_menu_model"
2363637181 c:identifier="adw_tab_view_get_menu_model"
2363737182 glib:get-property="menu-model">
23638- <attribute name="org.gtk.Method.get_property" value="menu-model"/>
2363937183 <doc xml:space="preserve"
2364037184 filename="src/adw-tab-view.c"
23641- line="3624">Gets the tab context menu model for @self.</doc>
37185+ line="3774">Gets the tab context menu model for @self.</doc>
2364237186 <source-position filename="src/adw-tab-view.h" line="165"/>
2364337187 <return-value transfer-ownership="none" nullable="1">
2364437188 <doc xml:space="preserve"
2364537189 filename="src/adw-tab-view.c"
23646- line="3630">the tab context menu model for @self</doc>
37190+ line="3780">the tab context menu model for @self</doc>
2364737191 <type name="Gio.MenuModel" c:type="GMenuModel*"/>
2364837192 </return-value>
2364937193 <parameters>
2365037194 <instance-parameter name="self" transfer-ownership="none">
2365137195 <doc xml:space="preserve"
2365237196 filename="src/adw-tab-view.c"
23653- line="3626">a tab view</doc>
37197+ line="3776">a tab view</doc>
2365437198 <type name="TabView" c:type="AdwTabView*"/>
2365537199 </instance-parameter>
2365637200 </parameters>
@@ -23658,22 +37202,21 @@ be safely dropped on the tab view.</doc>
2365837202 <method name="get_n_pages"
2365937203 c:identifier="adw_tab_view_get_n_pages"
2366037204 glib:get-property="n-pages">
23661- <attribute name="org.gtk.Method.get_property" value="n-pages"/>
2366237205 <doc xml:space="preserve"
2366337206 filename="src/adw-tab-view.c"
23664- line="3348">Gets the number of pages in @self.</doc>
37207+ line="3498">Gets the number of pages in @self.</doc>
2366537208 <source-position filename="src/adw-tab-view.h" line="140"/>
2366637209 <return-value transfer-ownership="none">
2366737210 <doc xml:space="preserve"
2366837211 filename="src/adw-tab-view.c"
23669- line="3354">the number of pages in @self</doc>
37212+ line="3504">the number of pages in @self</doc>
2367037213 <type name="gint" c:type="int"/>
2367137214 </return-value>
2367237215 <parameters>
2367337216 <instance-parameter name="self" transfer-ownership="none">
2367437217 <doc xml:space="preserve"
2367537218 filename="src/adw-tab-view.c"
23676- line="3350">a tab view</doc>
37219+ line="3500">a tab view</doc>
2367737220 <type name="TabView" c:type="AdwTabView*"/>
2367837221 </instance-parameter>
2367937222 </parameters>
@@ -23681,24 +37224,23 @@ be safely dropped on the tab view.</doc>
2368137224 <method name="get_n_pinned_pages"
2368237225 c:identifier="adw_tab_view_get_n_pinned_pages"
2368337226 glib:get-property="n-pinned-pages">
23684- <attribute name="org.gtk.Method.get_property" value="n-pinned-pages"/>
2368537227 <doc xml:space="preserve"
2368637228 filename="src/adw-tab-view.c"
23687- line="3364">Gets the number of pinned pages in @self.
37229+ line="3514">Gets the number of pinned pages in @self.
2368837230
2368937231 See [method@TabView.set_page_pinned].</doc>
2369037232 <source-position filename="src/adw-tab-view.h" line="142"/>
2369137233 <return-value transfer-ownership="none">
2369237234 <doc xml:space="preserve"
2369337235 filename="src/adw-tab-view.c"
23694- line="3372">the number of pinned pages in @self</doc>
37236+ line="3522">the number of pinned pages in @self</doc>
2369537237 <type name="gint" c:type="int"/>
2369637238 </return-value>
2369737239 <parameters>
2369837240 <instance-parameter name="self" transfer-ownership="none">
2369937241 <doc xml:space="preserve"
2370037242 filename="src/adw-tab-view.c"
23701- line="3366">a tab view</doc>
37243+ line="3516">a tab view</doc>
2370237244 <type name="TabView" c:type="AdwTabView*"/>
2370337245 </instance-parameter>
2370437246 </parameters>
@@ -23706,25 +37248,25 @@ See [method@TabView.set_page_pinned].</doc>
2370637248 <method name="get_nth_page" c:identifier="adw_tab_view_get_nth_page">
2370737249 <doc xml:space="preserve"
2370837250 filename="src/adw-tab-view.c"
23709- line="3863">Gets the [class@TabPage] representing the child at @position.</doc>
37251+ line="4013">Gets the [class@TabPage] representing the child at @position.</doc>
2371037252 <source-position filename="src/adw-tab-view.h" line="192"/>
2371137253 <return-value transfer-ownership="none">
2371237254 <doc xml:space="preserve"
2371337255 filename="src/adw-tab-view.c"
23714- line="3870">the page object at @position</doc>
37256+ line="4020">the page object at @position</doc>
2371537257 <type name="TabPage" c:type="AdwTabPage*"/>
2371637258 </return-value>
2371737259 <parameters>
2371837260 <instance-parameter name="self" transfer-ownership="none">
2371937261 <doc xml:space="preserve"
2372037262 filename="src/adw-tab-view.c"
23721- line="3865">a tab view</doc>
37263+ line="4015">a tab view</doc>
2372237264 <type name="TabView" c:type="AdwTabView*"/>
2372337265 </instance-parameter>
2372437266 <parameter name="position" transfer-ownership="none">
2372537267 <doc xml:space="preserve"
2372637268 filename="src/adw-tab-view.c"
23727- line="3866">the index of the page in @self, starting from 0</doc>
37269+ line="4016">the index of the page in @self, starting from 0</doc>
2372837270 <type name="gint" c:type="int"/>
2372937271 </parameter>
2373037272 </parameters>
@@ -23732,25 +37274,25 @@ See [method@TabView.set_page_pinned].</doc>
2373237274 <method name="get_page" c:identifier="adw_tab_view_get_page">
2373337275 <doc xml:space="preserve"
2373437276 filename="src/adw-tab-view.c"
23735- line="3834">Gets the [class@TabPage] object representing @child.</doc>
37277+ line="3984">Gets the [class@TabPage] object representing @child.</doc>
2373637278 <source-position filename="src/adw-tab-view.h" line="188"/>
2373737279 <return-value transfer-ownership="none">
2373837280 <doc xml:space="preserve"
2373937281 filename="src/adw-tab-view.c"
23740- line="3841">the page object for @child</doc>
37282+ line="3991">the page object for @child</doc>
2374137283 <type name="TabPage" c:type="AdwTabPage*"/>
2374237284 </return-value>
2374337285 <parameters>
2374437286 <instance-parameter name="self" transfer-ownership="none">
2374537287 <doc xml:space="preserve"
2374637288 filename="src/adw-tab-view.c"
23747- line="3836">a tab view</doc>
37289+ line="3986">a tab view</doc>
2374837290 <type name="TabView" c:type="AdwTabView*"/>
2374937291 </instance-parameter>
2375037292 <parameter name="child" transfer-ownership="none">
2375137293 <doc xml:space="preserve"
2375237294 filename="src/adw-tab-view.c"
23753- line="3837">a child in @self</doc>
37295+ line="3987">a child in @self</doc>
2375437296 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2375537297 </parameter>
2375637298 </parameters>
@@ -23759,25 +37301,25 @@ See [method@TabView.set_page_pinned].</doc>
2375937301 c:identifier="adw_tab_view_get_page_position">
2376037302 <doc xml:space="preserve"
2376137303 filename="src/adw-tab-view.c"
23762- line="3889">Finds the position of @page in @self, starting from 0.</doc>
37304+ line="4039">Finds the position of @page in @self, starting from 0.</doc>
2376337305 <source-position filename="src/adw-tab-view.h" line="196"/>
2376437306 <return-value transfer-ownership="none">
2376537307 <doc xml:space="preserve"
2376637308 filename="src/adw-tab-view.c"
23767- line="3896">the position of @page in @self</doc>
37309+ line="4046">the position of @page in @self</doc>
2376837310 <type name="gint" c:type="int"/>
2376937311 </return-value>
2377037312 <parameters>
2377137313 <instance-parameter name="self" transfer-ownership="none">
2377237314 <doc xml:space="preserve"
2377337315 filename="src/adw-tab-view.c"
23774- line="3891">a tab view</doc>
37316+ line="4041">a tab view</doc>
2377537317 <type name="TabView" c:type="AdwTabView*"/>
2377637318 </instance-parameter>
2377737319 <parameter name="page" transfer-ownership="none">
2377837320 <doc xml:space="preserve"
2377937321 filename="src/adw-tab-view.c"
23780- line="3892">a page of @self</doc>
37322+ line="4042">a page of @self</doc>
2378137323 <type name="TabPage" c:type="AdwTabPage*"/>
2378237324 </parameter>
2378337325 </parameters>
@@ -23785,10 +37327,9 @@ See [method@TabView.set_page_pinned].</doc>
2378537327 <method name="get_pages"
2378637328 c:identifier="adw_tab_view_get_pages"
2378737329 glib:get-property="pages">
23788- <attribute name="org.gtk.Method.get_property" value="pages"/>
2378937330 <doc xml:space="preserve"
2379037331 filename="src/adw-tab-view.c"
23791- line="4504">Returns a [iface@Gio.ListModel] that contains the pages of @self.
37332+ line="4660">Returns a [iface@Gio.ListModel] that contains the pages of @self.
2379237333
2379337334 This can be used to keep an up-to-date view. The model also implements
2379437335 [iface@Gtk.SelectionModel] and can be used to track and change the selected
@@ -23797,14 +37338,14 @@ page.</doc>
2379737338 <return-value transfer-ownership="full">
2379837339 <doc xml:space="preserve"
2379937340 filename="src/adw-tab-view.c"
23800- line="4514">a `GtkSelectionModel` for the pages of @self</doc>
37341+ line="4670">a `GtkSelectionModel` for the pages of @self</doc>
2380137342 <type name="Gtk.SelectionModel" c:type="GtkSelectionModel*"/>
2380237343 </return-value>
2380337344 <parameters>
2380437345 <instance-parameter name="self" transfer-ownership="none">
2380537346 <doc xml:space="preserve"
2380637347 filename="src/adw-tab-view.c"
23807- line="4506">a tab view</doc>
37348+ line="4662">a tab view</doc>
2380837349 <type name="TabView" c:type="AdwTabView*"/>
2380937350 </instance-parameter>
2381037351 </parameters>
@@ -23812,22 +37353,21 @@ page.</doc>
2381237353 <method name="get_selected_page"
2381337354 c:identifier="adw_tab_view_get_selected_page"
2381437355 glib:get-property="selected-page">
23815- <attribute name="org.gtk.Method.get_property" value="selected-page"/>
2381637356 <doc xml:space="preserve"
2381737357 filename="src/adw-tab-view.c"
23818- line="3404">Gets the currently selected page in @self.</doc>
37358+ line="3554">Gets the currently selected page in @self.</doc>
2381937359 <source-position filename="src/adw-tab-view.h" line="148"/>
2382037360 <return-value transfer-ownership="none" nullable="1">
2382137361 <doc xml:space="preserve"
2382237362 filename="src/adw-tab-view.c"
23823- line="3410">the selected page</doc>
37363+ line="3560">the selected page</doc>
2382437364 <type name="TabPage" c:type="AdwTabPage*"/>
2382537365 </return-value>
2382637366 <parameters>
2382737367 <instance-parameter name="self" transfer-ownership="none">
2382837368 <doc xml:space="preserve"
2382937369 filename="src/adw-tab-view.c"
23830- line="3406">a tab view</doc>
37370+ line="3556">a tab view</doc>
2383137371 <type name="TabView" c:type="AdwTabView*"/>
2383237372 </instance-parameter>
2383337373 </parameters>
@@ -23836,22 +37376,21 @@ page.</doc>
2383637376 c:identifier="adw_tab_view_get_shortcuts"
2383737377 glib:get-property="shortcuts"
2383837378 version="1.2">
23839- <attribute name="org.gtk.Method.get_property" value="shortcuts"/>
2384037379 <doc xml:space="preserve"
2384137380 filename="src/adw-tab-view.c"
23842- line="3666">Gets the enabled shortcuts for @self.</doc>
37381+ line="3816">Gets the enabled shortcuts for @self.</doc>
2384337382 <source-position filename="src/adw-tab-view.h" line="171"/>
2384437383 <return-value transfer-ownership="none">
2384537384 <doc xml:space="preserve"
2384637385 filename="src/adw-tab-view.c"
23847- line="3672">the shortcut mask</doc>
37386+ line="3822">the shortcut mask</doc>
2384837387 <type name="TabViewShortcuts" c:type="AdwTabViewShortcuts"/>
2384937388 </return-value>
2385037389 <parameters>
2385137390 <instance-parameter name="self" transfer-ownership="none">
2385237391 <doc xml:space="preserve"
2385337392 filename="src/adw-tab-view.c"
23854- line="3668">a tab view</doc>
37393+ line="3818">a tab view</doc>
2385537394 <type name="TabView" c:type="AdwTabView*"/>
2385637395 </instance-parameter>
2385737396 </parameters>
@@ -23859,7 +37398,7 @@ page.</doc>
2385937398 <method name="insert" c:identifier="adw_tab_view_insert">
2386037399 <doc xml:space="preserve"
2386137400 filename="src/adw-tab-view.c"
23862- line="3970">Inserts a non-pinned page at @position.
37401+ line="4121">Inserts a non-pinned page at @position.
2386337402
2386437403 It's an error to try to insert a page before a pinned page, in that case
2386537404 [method@TabView.insert_pinned] should be used instead.</doc>
@@ -23867,26 +37406,26 @@ It's an error to try to insert a page before a pinned page, in that case
2386737406 <return-value transfer-ownership="none">
2386837407 <doc xml:space="preserve"
2386937408 filename="src/adw-tab-view.c"
23870- line="3981">the page object representing @child</doc>
37409+ line="4132">the page object representing @child</doc>
2387137410 <type name="TabPage" c:type="AdwTabPage*"/>
2387237411 </return-value>
2387337412 <parameters>
2387437413 <instance-parameter name="self" transfer-ownership="none">
2387537414 <doc xml:space="preserve"
2387637415 filename="src/adw-tab-view.c"
23877- line="3972">a tab view</doc>
37416+ line="4123">a tab view</doc>
2387837417 <type name="TabView" c:type="AdwTabView*"/>
2387937418 </instance-parameter>
2388037419 <parameter name="child" transfer-ownership="none">
2388137420 <doc xml:space="preserve"
2388237421 filename="src/adw-tab-view.c"
23883- line="3973">a widget to add</doc>
37422+ line="4124">a widget to add</doc>
2388437423 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2388537424 </parameter>
2388637425 <parameter name="position" transfer-ownership="none">
2388737426 <doc xml:space="preserve"
2388837427 filename="src/adw-tab-view.c"
23889- line="3974">the position to add @child at, starting from 0</doc>
37428+ line="4125">the position to add @child at, starting from 0</doc>
2389037429 <type name="gint" c:type="int"/>
2389137430 </parameter>
2389237431 </parameters>
@@ -23894,7 +37433,7 @@ It's an error to try to insert a page before a pinned page, in that case
2389437433 <method name="insert_pinned" c:identifier="adw_tab_view_insert_pinned">
2389537434 <doc xml:space="preserve"
2389637435 filename="src/adw-tab-view.c"
23897- line="4034">Inserts a pinned page at @position.
37436+ line="4188">Inserts a pinned page at @position.
2389837437
2389937438 It's an error to try to insert a pinned page after a non-pinned page, in
2390037439 that case [method@TabView.insert] should be used instead.</doc>
@@ -23902,26 +37441,26 @@ that case [method@TabView.insert] should be used instead.</doc>
2390237441 <return-value transfer-ownership="none">
2390337442 <doc xml:space="preserve"
2390437443 filename="src/adw-tab-view.c"
23905- line="4045">the page object representing @child</doc>
37444+ line="4199">the page object representing @child</doc>
2390637445 <type name="TabPage" c:type="AdwTabPage*"/>
2390737446 </return-value>
2390837447 <parameters>
2390937448 <instance-parameter name="self" transfer-ownership="none">
2391037449 <doc xml:space="preserve"
2391137450 filename="src/adw-tab-view.c"
23912- line="4036">a tab view</doc>
37451+ line="4190">a tab view</doc>
2391337452 <type name="TabView" c:type="AdwTabView*"/>
2391437453 </instance-parameter>
2391537454 <parameter name="child" transfer-ownership="none">
2391637455 <doc xml:space="preserve"
2391737456 filename="src/adw-tab-view.c"
23918- line="4037">a widget to add</doc>
37457+ line="4191">a widget to add</doc>
2391937458 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2392037459 </parameter>
2392137460 <parameter name="position" transfer-ownership="none">
2392237461 <doc xml:space="preserve"
2392337462 filename="src/adw-tab-view.c"
23924- line="4038">the position to add @child at, starting from 0</doc>
37463+ line="4192">the position to add @child at, starting from 0</doc>
2392537464 <type name="gint" c:type="int"/>
2392637465 </parameter>
2392737466 </parameters>
@@ -23931,7 +37470,7 @@ that case [method@TabView.insert] should be used instead.</doc>
2393137470 version="1.3">
2393237471 <doc xml:space="preserve"
2393337472 filename="src/adw-tab-view.c"
23934- line="4531">Invalidates thumbnails for all pages in @self.
37473+ line="4685">Invalidates thumbnails for all pages in @self.
2393537474
2393637475 This is a convenience method, equivalent to calling
2393737476 [method@TabPage.invalidate_thumbnail] on each page.</doc>
@@ -23943,7 +37482,7 @@ This is a convenience method, equivalent to calling
2394337482 <instance-parameter name="self" transfer-ownership="none">
2394437483 <doc xml:space="preserve"
2394537484 filename="src/adw-tab-view.c"
23946- line="4533">a tab view</doc>
37485+ line="4687">a tab view</doc>
2394737486 <type name="TabView" c:type="AdwTabView*"/>
2394837487 </instance-parameter>
2394937488 </parameters>
@@ -23951,25 +37490,25 @@ This is a convenience method, equivalent to calling
2395137490 <method name="prepend" c:identifier="adw_tab_view_prepend">
2395237491 <doc xml:space="preserve"
2395337492 filename="src/adw-tab-view.c"
23954- line="3996">Inserts @child as the first non-pinned page.</doc>
37493+ line="4148">Inserts @child as the first non-pinned page.</doc>
2395537494 <source-position filename="src/adw-tab-view.h" line="209"/>
2395637495 <return-value transfer-ownership="none">
2395737496 <doc xml:space="preserve"
2395837497 filename="src/adw-tab-view.c"
23959- line="4003">the page object representing @child</doc>
37498+ line="4155">the page object representing @child</doc>
2396037499 <type name="TabPage" c:type="AdwTabPage*"/>
2396137500 </return-value>
2396237501 <parameters>
2396337502 <instance-parameter name="self" transfer-ownership="none">
2396437503 <doc xml:space="preserve"
2396537504 filename="src/adw-tab-view.c"
23966- line="3998">a tab view</doc>
37505+ line="4150">a tab view</doc>
2396737506 <type name="TabView" c:type="AdwTabView*"/>
2396837507 </instance-parameter>
2396937508 <parameter name="child" transfer-ownership="none">
2397037509 <doc xml:space="preserve"
2397137510 filename="src/adw-tab-view.c"
23972- line="3999">a widget to add</doc>
37511+ line="4151">a widget to add</doc>
2397337512 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2397437513 </parameter>
2397537514 </parameters>
@@ -23977,25 +37516,25 @@ This is a convenience method, equivalent to calling
2397737516 <method name="prepend_pinned" c:identifier="adw_tab_view_prepend_pinned">
2397837517 <doc xml:space="preserve"
2397937518 filename="src/adw-tab-view.c"
23980- line="4060">Inserts @child as the first pinned page.</doc>
37519+ line="4214">Inserts @child as the first pinned page.</doc>
2398137520 <source-position filename="src/adw-tab-view.h" line="220"/>
2398237521 <return-value transfer-ownership="none">
2398337522 <doc xml:space="preserve"
2398437523 filename="src/adw-tab-view.c"
23985- line="4067">the page object representing @child</doc>
37524+ line="4221">the page object representing @child</doc>
2398637525 <type name="TabPage" c:type="AdwTabPage*"/>
2398737526 </return-value>
2398837527 <parameters>
2398937528 <instance-parameter name="self" transfer-ownership="none">
2399037529 <doc xml:space="preserve"
2399137530 filename="src/adw-tab-view.c"
23992- line="4062">a tab view</doc>
37531+ line="4216">a tab view</doc>
2399337532 <type name="TabView" c:type="AdwTabView*"/>
2399437533 </instance-parameter>
2399537534 <parameter name="child" transfer-ownership="none">
2399637535 <doc xml:space="preserve"
2399737536 filename="src/adw-tab-view.c"
23998- line="4063">a widget to add</doc>
37537+ line="4217">a widget to add</doc>
2399937538 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2400037539 </parameter>
2400137540 </parameters>
@@ -24005,7 +37544,7 @@ This is a convenience method, equivalent to calling
2400537544 version="1.2">
2400637545 <doc xml:space="preserve"
2400737546 filename="src/adw-tab-view.c"
24008- line="3735">Removes @shortcuts from @self.
37547+ line="3885">Removes @shortcuts from @self.
2400937548
2401037549 See [property@TabView:shortcuts] for details.</doc>
2401137550 <source-position filename="src/adw-tab-view.h" line="179"/>
@@ -24016,13 +37555,13 @@ See [property@TabView:shortcuts] for details.</doc>
2401637555 <instance-parameter name="self" transfer-ownership="none">
2401737556 <doc xml:space="preserve"
2401837557 filename="src/adw-tab-view.c"
24019- line="3737">a tab view</doc>
37558+ line="3887">a tab view</doc>
2402037559 <type name="TabView" c:type="AdwTabView*"/>
2402137560 </instance-parameter>
2402237561 <parameter name="shortcuts" transfer-ownership="none">
2402337562 <doc xml:space="preserve"
2402437563 filename="src/adw-tab-view.c"
24025- line="3738">the shortcuts to reomve</doc>
37564+ line="3888">the shortcuts to remove</doc>
2402637565 <type name="TabViewShortcuts" c:type="AdwTabViewShortcuts"/>
2402737566 </parameter>
2402837567 </parameters>
@@ -24031,25 +37570,25 @@ See [property@TabView:shortcuts] for details.</doc>
2403137570 c:identifier="adw_tab_view_reorder_backward">
2403237571 <doc xml:space="preserve"
2403337572 filename="src/adw-tab-view.c"
24034- line="4314">Reorders @page to before its previous page if possible.</doc>
37573+ line="4470">Reorders @page to before its previous page if possible.</doc>
2403537574 <source-position filename="src/adw-tab-view.h" line="249"/>
2403637575 <return-value transfer-ownership="none">
2403737576 <doc xml:space="preserve"
2403837577 filename="src/adw-tab-view.c"
24039- line="4321">whether @page was moved</doc>
37578+ line="4477">whether @page was moved</doc>
2404037579 <type name="gboolean" c:type="gboolean"/>
2404137580 </return-value>
2404237581 <parameters>
2404337582 <instance-parameter name="self" transfer-ownership="none">
2404437583 <doc xml:space="preserve"
2404537584 filename="src/adw-tab-view.c"
24046- line="4316">a tab view</doc>
37585+ line="4472">a tab view</doc>
2404737586 <type name="TabView" c:type="AdwTabView*"/>
2404837587 </instance-parameter>
2404937588 <parameter name="page" transfer-ownership="none">
2405037589 <doc xml:space="preserve"
2405137590 filename="src/adw-tab-view.c"
24052- line="4317">a page of @self</doc>
37591+ line="4473">a page of @self</doc>
2405337592 <type name="TabPage" c:type="AdwTabPage*"/>
2405437593 </parameter>
2405537594 </parameters>
@@ -24057,25 +37596,25 @@ See [property@TabView:shortcuts] for details.</doc>
2405737596 <method name="reorder_first" c:identifier="adw_tab_view_reorder_first">
2405837597 <doc xml:space="preserve"
2405937598 filename="src/adw-tab-view.c"
24060- line="4376">Reorders @page to the first possible position.</doc>
37599+ line="4532">Reorders @page to the first possible position.</doc>
2406137600 <source-position filename="src/adw-tab-view.h" line="255"/>
2406237601 <return-value transfer-ownership="none">
2406337602 <doc xml:space="preserve"
2406437603 filename="src/adw-tab-view.c"
24065- line="4383">whether @page was moved</doc>
37604+ line="4539">whether @page was moved</doc>
2406637605 <type name="gboolean" c:type="gboolean"/>
2406737606 </return-value>
2406837607 <parameters>
2406937608 <instance-parameter name="self" transfer-ownership="none">
2407037609 <doc xml:space="preserve"
2407137610 filename="src/adw-tab-view.c"
24072- line="4378">a tab view</doc>
37611+ line="4534">a tab view</doc>
2407337612 <type name="TabView" c:type="AdwTabView*"/>
2407437613 </instance-parameter>
2407537614 <parameter name="page" transfer-ownership="none">
2407637615 <doc xml:space="preserve"
2407737616 filename="src/adw-tab-view.c"
24078- line="4379">a page of @self</doc>
37617+ line="4535">a page of @self</doc>
2407937618 <type name="TabPage" c:type="AdwTabPage*"/>
2408037619 </parameter>
2408137620 </parameters>
@@ -24084,25 +37623,25 @@ See [property@TabView:shortcuts] for details.</doc>
2408437623 c:identifier="adw_tab_view_reorder_forward">
2408537624 <doc xml:space="preserve"
2408637625 filename="src/adw-tab-view.c"
24087- line="4345">Reorders @page to after its next page if possible.</doc>
37626+ line="4501">Reorders @page to after its next page if possible.</doc>
2408837627 <source-position filename="src/adw-tab-view.h" line="252"/>
2408937628 <return-value transfer-ownership="none">
2409037629 <doc xml:space="preserve"
2409137630 filename="src/adw-tab-view.c"
24092- line="4352">whether @page was moved</doc>
37631+ line="4508">whether @page was moved</doc>
2409337632 <type name="gboolean" c:type="gboolean"/>
2409437633 </return-value>
2409537634 <parameters>
2409637635 <instance-parameter name="self" transfer-ownership="none">
2409737636 <doc xml:space="preserve"
2409837637 filename="src/adw-tab-view.c"
24099- line="4347">a tab view</doc>
37638+ line="4503">a tab view</doc>
2410037639 <type name="TabView" c:type="AdwTabView*"/>
2410137640 </instance-parameter>
2410237641 <parameter name="page" transfer-ownership="none">
2410337642 <doc xml:space="preserve"
2410437643 filename="src/adw-tab-view.c"
24105- line="4348">a page of @self</doc>
37644+ line="4504">a page of @self</doc>
2410637645 <type name="TabPage" c:type="AdwTabPage*"/>
2410737646 </parameter>
2410837647 </parameters>
@@ -24110,25 +37649,25 @@ See [property@TabView:shortcuts] for details.</doc>
2411037649 <method name="reorder_last" c:identifier="adw_tab_view_reorder_last">
2411137650 <doc xml:space="preserve"
2411237651 filename="src/adw-tab-view.c"
24113- line="4402">Reorders @page to the last possible position.</doc>
37652+ line="4558">Reorders @page to the last possible position.</doc>
2411437653 <source-position filename="src/adw-tab-view.h" line="258"/>
2411537654 <return-value transfer-ownership="none">
2411637655 <doc xml:space="preserve"
2411737656 filename="src/adw-tab-view.c"
24118- line="4409">whether @page was moved</doc>
37657+ line="4565">whether @page was moved</doc>
2411937658 <type name="gboolean" c:type="gboolean"/>
2412037659 </return-value>
2412137660 <parameters>
2412237661 <instance-parameter name="self" transfer-ownership="none">
2412337662 <doc xml:space="preserve"
2412437663 filename="src/adw-tab-view.c"
24125- line="4404">a tab view</doc>
37664+ line="4560">a tab view</doc>
2412637665 <type name="TabView" c:type="AdwTabView*"/>
2412737666 </instance-parameter>
2412837667 <parameter name="page" transfer-ownership="none">
2412937668 <doc xml:space="preserve"
2413037669 filename="src/adw-tab-view.c"
24131- line="4405">a page of @self</doc>
37670+ line="4561">a page of @self</doc>
2413237671 <type name="TabPage" c:type="AdwTabPage*"/>
2413337672 </parameter>
2413437673 </parameters>
@@ -24136,7 +37675,7 @@ See [property@TabView:shortcuts] for details.</doc>
2413637675 <method name="reorder_page" c:identifier="adw_tab_view_reorder_page">
2413737676 <doc xml:space="preserve"
2413837677 filename="src/adw-tab-view.c"
24139- line="4258">Reorders @page to @position.
37678+ line="4414">Reorders @page to @position.
2414037679
2414137680 It's a programmer error to try to reorder a pinned page after a non-pinned
2414237681 one, or a non-pinned page before a pinned one.</doc>
@@ -24144,26 +37683,26 @@ one, or a non-pinned page before a pinned one.</doc>
2414437683 <return-value transfer-ownership="none">
2414537684 <doc xml:space="preserve"
2414637685 filename="src/adw-tab-view.c"
24147- line="4269">whether @page was moved</doc>
37686+ line="4425">whether @page was moved</doc>
2414837687 <type name="gboolean" c:type="gboolean"/>
2414937688 </return-value>
2415037689 <parameters>
2415137690 <instance-parameter name="self" transfer-ownership="none">
2415237691 <doc xml:space="preserve"
2415337692 filename="src/adw-tab-view.c"
24154- line="4260">a tab view</doc>
37693+ line="4416">a tab view</doc>
2415537694 <type name="TabView" c:type="AdwTabView*"/>
2415637695 </instance-parameter>
2415737696 <parameter name="page" transfer-ownership="none">
2415837697 <doc xml:space="preserve"
2415937698 filename="src/adw-tab-view.c"
24160- line="4261">a page of @self</doc>
37699+ line="4417">a page of @self</doc>
2416137700 <type name="TabPage" c:type="AdwTabPage*"/>
2416237701 </parameter>
2416337702 <parameter name="position" transfer-ownership="none">
2416437703 <doc xml:space="preserve"
2416537704 filename="src/adw-tab-view.c"
24166- line="4262">the position to insert the page at, starting at 0</doc>
37705+ line="4418">the position to insert the page at, starting at 0</doc>
2416737706 <type name="gint" c:type="int"/>
2416837707 </parameter>
2416937708 </parameters>
@@ -24172,21 +37711,21 @@ one, or a non-pinned page before a pinned one.</doc>
2417237711 c:identifier="adw_tab_view_select_next_page">
2417337712 <doc xml:space="preserve"
2417437713 filename="src/adw-tab-view.c"
24175- line="3476">Selects the page after the currently selected page.
37714+ line="3626">Selects the page after the currently selected page.
2417637715
2417737716 If the last page was already selected, this function does nothing.</doc>
2417837717 <source-position filename="src/adw-tab-view.h" line="156"/>
2417937718 <return-value transfer-ownership="none">
2418037719 <doc xml:space="preserve"
2418137720 filename="src/adw-tab-view.c"
24182- line="3484">whether the selected page was changed</doc>
37721+ line="3634">whether the selected page was changed</doc>
2418337722 <type name="gboolean" c:type="gboolean"/>
2418437723 </return-value>
2418537724 <parameters>
2418637725 <instance-parameter name="self" transfer-ownership="none">
2418737726 <doc xml:space="preserve"
2418837727 filename="src/adw-tab-view.c"
24189- line="3478">a tab view</doc>
37728+ line="3628">a tab view</doc>
2419037729 <type name="TabView" c:type="AdwTabView*"/>
2419137730 </instance-parameter>
2419237731 </parameters>
@@ -24195,21 +37734,21 @@ If the last page was already selected, this function does nothing.</doc>
2419537734 c:identifier="adw_tab_view_select_previous_page">
2419637735 <doc xml:space="preserve"
2419737736 filename="src/adw-tab-view.c"
24198- line="3443">Selects the page before the currently selected page.
37737+ line="3593">Selects the page before the currently selected page.
2419937738
2420037739 If the first page was already selected, this function does nothing.</doc>
2420137740 <source-position filename="src/adw-tab-view.h" line="154"/>
2420237741 <return-value transfer-ownership="none">
2420337742 <doc xml:space="preserve"
2420437743 filename="src/adw-tab-view.c"
24205- line="3451">whether the selected page was changed</doc>
37744+ line="3601">whether the selected page was changed</doc>
2420637745 <type name="gboolean" c:type="gboolean"/>
2420737746 </return-value>
2420837747 <parameters>
2420937748 <instance-parameter name="self" transfer-ownership="none">
2421037749 <doc xml:space="preserve"
2421137750 filename="src/adw-tab-view.c"
24212- line="3445">a tab view</doc>
37751+ line="3595">a tab view</doc>
2421337752 <type name="TabView" c:type="AdwTabView*"/>
2421437753 </instance-parameter>
2421537754 </parameters>
@@ -24217,10 +37756,9 @@ If the first page was already selected, this function does nothing.</doc>
2421737756 <method name="set_default_icon"
2421837757 c:identifier="adw_tab_view_set_default_icon"
2421937758 glib:set-property="default-icon">
24220- <attribute name="org.gtk.Method.set_property" value="default-icon"/>
2422137759 <doc xml:space="preserve"
2422237760 filename="src/adw-tab-view.c"
24223- line="3583">Sets the default page icon for @self.
37761+ line="3733">Sets the default page icon for @self.
2422437762
2422537763 If a page doesn't provide its own icon via [property@TabPage:icon], a default
2422637764 icon may be used instead for contexts where having an icon is necessary.
@@ -24240,13 +37778,13 @@ By default, the `adw-tab-icon-missing-symbolic` icon is used.</doc>
2424037778 <instance-parameter name="self" transfer-ownership="none">
2424137779 <doc xml:space="preserve"
2424237780 filename="src/adw-tab-view.c"
24243- line="3585">a tab view</doc>
37781+ line="3735">a tab view</doc>
2424437782 <type name="TabView" c:type="AdwTabView*"/>
2424537783 </instance-parameter>
2424637784 <parameter name="default_icon" transfer-ownership="none">
2424737785 <doc xml:space="preserve"
2424837786 filename="src/adw-tab-view.c"
24249- line="3586">the default icon</doc>
37787+ line="3736">the default icon</doc>
2425037788 <type name="Gio.Icon" c:type="GIcon*"/>
2425137789 </parameter>
2425237790 </parameters>
@@ -24254,10 +37792,9 @@ By default, the `adw-tab-icon-missing-symbolic` icon is used.</doc>
2425437792 <method name="set_menu_model"
2425537793 c:identifier="adw_tab_view_set_menu_model"
2425637794 glib:set-property="menu-model">
24257- <attribute name="org.gtk.Method.set_property" value="menu-model"/>
2425837795 <doc xml:space="preserve"
2425937796 filename="src/adw-tab-view.c"
24260- line="3640">Sets the tab context menu model for @self.
37797+ line="3790">Sets the tab context menu model for @self.
2426137798
2426237799 When a context menu is shown for a tab, it will be constructed from the
2426337800 provided menu model. Use the [signal@TabView::setup-menu] signal to set up
@@ -24270,7 +37807,7 @@ the menu actions for the particular tab.</doc>
2427037807 <instance-parameter name="self" transfer-ownership="none">
2427137808 <doc xml:space="preserve"
2427237809 filename="src/adw-tab-view.c"
24273- line="3642">a tab view</doc>
37810+ line="3792">a tab view</doc>
2427437811 <type name="TabView" c:type="AdwTabView*"/>
2427537812 </instance-parameter>
2427637813 <parameter name="menu_model"
@@ -24279,7 +37816,7 @@ the menu actions for the particular tab.</doc>
2427937816 allow-none="1">
2428037817 <doc xml:space="preserve"
2428137818 filename="src/adw-tab-view.c"
24282- line="3643">a menu model</doc>
37819+ line="3793">a menu model</doc>
2428337820 <type name="Gio.MenuModel" c:type="GMenuModel*"/>
2428437821 </parameter>
2428537822 </parameters>
@@ -24288,7 +37825,7 @@ the menu actions for the particular tab.</doc>
2428837825 c:identifier="adw_tab_view_set_page_pinned">
2428937826 <doc xml:space="preserve"
2429037827 filename="src/adw-tab-view.c"
24291- line="3756">Pins or unpins @page.
37828+ line="3906">Pins or unpins @page.
2429237829
2429337830 Pinned pages are guaranteed to be placed before all non-pinned pages; at any
2429437831 given moment the first [property@TabView:n-pinned-pages] pages in @self are
@@ -24325,19 +37862,19 @@ Changes the value of the [property@TabPage:pinned] property.</doc>
2432537862 <instance-parameter name="self" transfer-ownership="none">
2432637863 <doc xml:space="preserve"
2432737864 filename="src/adw-tab-view.c"
24328- line="3758">a tab view</doc>
37865+ line="3908">a tab view</doc>
2432937866 <type name="TabView" c:type="AdwTabView*"/>
2433037867 </instance-parameter>
2433137868 <parameter name="page" transfer-ownership="none">
2433237869 <doc xml:space="preserve"
2433337870 filename="src/adw-tab-view.c"
24334- line="3759">a page of @self</doc>
37871+ line="3909">a page of @self</doc>
2433537872 <type name="TabPage" c:type="AdwTabPage*"/>
2433637873 </parameter>
2433737874 <parameter name="pinned" transfer-ownership="none">
2433837875 <doc xml:space="preserve"
2433937876 filename="src/adw-tab-view.c"
24340- line="3760">whether @page should be pinned</doc>
37877+ line="3910">whether @page should be pinned</doc>
2434137878 <type name="gboolean" c:type="gboolean"/>
2434237879 </parameter>
2434337880 </parameters>
@@ -24345,10 +37882,9 @@ Changes the value of the [property@TabPage:pinned] property.</doc>
2434537882 <method name="set_selected_page"
2434637883 c:identifier="adw_tab_view_set_selected_page"
2434737884 glib:set-property="selected-page">
24348- <attribute name="org.gtk.Method.set_property" value="selected-page"/>
2434937885 <doc xml:space="preserve"
2435037886 filename="src/adw-tab-view.c"
24351- line="3420">Sets the currently selected page in @self.</doc>
37887+ line="3570">Sets the currently selected page in @self.</doc>
2435237888 <source-position filename="src/adw-tab-view.h" line="150"/>
2435337889 <return-value transfer-ownership="none">
2435437890 <type name="none" c:type="void"/>
@@ -24357,13 +37893,13 @@ Changes the value of the [property@TabPage:pinned] property.</doc>
2435737893 <instance-parameter name="self" transfer-ownership="none">
2435837894 <doc xml:space="preserve"
2435937895 filename="src/adw-tab-view.c"
24360- line="3422">a tab view</doc>
37896+ line="3572">a tab view</doc>
2436137897 <type name="TabView" c:type="AdwTabView*"/>
2436237898 </instance-parameter>
2436337899 <parameter name="selected_page" transfer-ownership="none">
2436437900 <doc xml:space="preserve"
2436537901 filename="src/adw-tab-view.c"
24366- line="3423">a page in @self</doc>
37902+ line="3573">a page in @self</doc>
2436737903 <type name="TabPage" c:type="AdwTabPage*"/>
2436837904 </parameter>
2436937905 </parameters>
@@ -24372,10 +37908,9 @@ Changes the value of the [property@TabPage:pinned] property.</doc>
2437237908 c:identifier="adw_tab_view_set_shortcuts"
2437337909 glib:set-property="shortcuts"
2437437910 version="1.2">
24375- <attribute name="org.gtk.Method.set_property" value="shortcuts"/>
2437637911 <doc xml:space="preserve"
2437737912 filename="src/adw-tab-view.c"
24378- line="3684">Sets the enabled shortcuts for @self.
37913+ line="3834">Sets the enabled shortcuts for @self.
2437937914
2438037915 See [flags@TabViewShortcuts] for the list of the available shortcuts. All of
2438137916 the shortcuts are enabled by default.
@@ -24390,13 +37925,13 @@ a convenient way to manage individual shortcuts.</doc>
2439037925 <instance-parameter name="self" transfer-ownership="none">
2439137926 <doc xml:space="preserve"
2439237927 filename="src/adw-tab-view.c"
24393- line="3686">a tab view</doc>
37928+ line="3836">a tab view</doc>
2439437929 <type name="TabView" c:type="AdwTabView*"/>
2439537930 </instance-parameter>
2439637931 <parameter name="shortcuts" transfer-ownership="none">
2439737932 <doc xml:space="preserve"
2439837933 filename="src/adw-tab-view.c"
24399- line="3687">the new shortcuts</doc>
37934+ line="3837">the new shortcuts</doc>
2440037935 <type name="TabViewShortcuts" c:type="AdwTabViewShortcuts"/>
2440137936 </parameter>
2440237937 </parameters>
@@ -24404,7 +37939,7 @@ a convenient way to manage individual shortcuts.</doc>
2440437939 <method name="transfer_page" c:identifier="adw_tab_view_transfer_page">
2440537940 <doc xml:space="preserve"
2440637941 filename="src/adw-tab-view.c"
24407- line="4466">Transfers @page from @self to @other_view.
37942+ line="4622">Transfers @page from @self to @other_view.
2440837943
2440937944 The @page object will be reused.
2441037945
@@ -24418,25 +37953,25 @@ one, or a non-pinned page before a pinned one.</doc>
2441837953 <instance-parameter name="self" transfer-ownership="none">
2441937954 <doc xml:space="preserve"
2442037955 filename="src/adw-tab-view.c"
24421- line="4468">a tab view</doc>
37956+ line="4624">a tab view</doc>
2442237957 <type name="TabView" c:type="AdwTabView*"/>
2442337958 </instance-parameter>
2442437959 <parameter name="page" transfer-ownership="none">
2442537960 <doc xml:space="preserve"
2442637961 filename="src/adw-tab-view.c"
24427- line="4469">a page of @self</doc>
37962+ line="4625">a page of @self</doc>
2442837963 <type name="TabPage" c:type="AdwTabPage*"/>
2442937964 </parameter>
2443037965 <parameter name="other_view" transfer-ownership="none">
2443137966 <doc xml:space="preserve"
2443237967 filename="src/adw-tab-view.c"
24433- line="4470">the tab view to transfer the page to</doc>
37968+ line="4626">the tab view to transfer the page to</doc>
2443437969 <type name="TabView" c:type="AdwTabView*"/>
2443537970 </parameter>
2443637971 <parameter name="position" transfer-ownership="none">
2443737972 <doc xml:space="preserve"
2443837973 filename="src/adw-tab-view.c"
24439- line="4471">the position to insert the page at, starting at 0</doc>
37974+ line="4627">the position to insert the page at, starting at 0</doc>
2444037975 <type name="gint" c:type="int"/>
2444137976 </parameter>
2444237977 </parameters>
@@ -24446,13 +37981,9 @@ one, or a non-pinned page before a pinned one.</doc>
2444637981 transfer-ownership="none"
2444737982 setter="set_default_icon"
2444837983 getter="get_default_icon">
24449- <attribute name="org.gtk.Property.get"
24450- value="adw_tab_view_get_default_icon"/>
24451- <attribute name="org.gtk.Property.set"
24452- value="adw_tab_view_set_default_icon"/>
2445337984 <doc xml:space="preserve"
2445437985 filename="src/adw-tab-view.c"
24455- line="2307">Default page icon.
37986+ line="2465">Default page icon.
2445637987
2445737988 If a page doesn't provide its own icon via [property@TabPage:icon], a
2445837989 default icon may be used instead for contexts where having an icon is
@@ -24472,11 +38003,9 @@ By default, the `adw-tab-icon-missing-symbolic` icon is used.</doc>
2447238003 transfer-ownership="none"
2447338004 getter="get_is_transferring_page"
2447438005 default-value="FALSE">
24475- <attribute name="org.gtk.Property.get"
24476- value="adw_tab_view_get_is_transferring_page"/>
2447738006 <doc xml:space="preserve"
2447838007 filename="src/adw-tab-view.c"
24479- line="2281">Whether a page is being transferred.
38008+ line="2439">Whether a page is being transferred.
2448038009
2448138010 This property will be set to `TRUE` when a drag-n-drop tab transfer starts
2448238011 on any `AdwTabView`, and to `FALSE` after it ends.
@@ -24490,13 +38019,9 @@ be safely dropped on the tab view.</doc>
2449038019 transfer-ownership="none"
2449138020 setter="set_menu_model"
2449238021 getter="get_menu_model">
24493- <attribute name="org.gtk.Property.get"
24494- value="adw_tab_view_get_menu_model"/>
24495- <attribute name="org.gtk.Property.set"
24496- value="adw_tab_view_set_menu_model"/>
2449738022 <doc xml:space="preserve"
2449838023 filename="src/adw-tab-view.c"
24499- line="2330">Tab context menu model.
38024+ line="2488">Tab context menu model.
2450038025
2450138026 When a context menu is shown for a tab, it will be constructed from the
2450238027 provided menu model. Use the [signal@TabView::setup-menu] signal to set up
@@ -24507,31 +38032,26 @@ the menu actions for the particular tab.</doc>
2450738032 transfer-ownership="none"
2450838033 getter="get_n_pages"
2450938034 default-value="0">
24510- <attribute name="org.gtk.Property.get"
24511- value="adw_tab_view_get_n_pages"/>
2451238035 <doc xml:space="preserve"
2451338036 filename="src/adw-tab-view.c"
24514- line="2259">The number of pages in the tab view.</doc>
38037+ line="2417">The number of pages in the tab view.</doc>
2451538038 <type name="gint" c:type="gint"/>
2451638039 </property>
2451738040 <property name="n-pinned-pages"
2451838041 transfer-ownership="none"
2451938042 getter="get_n_pinned_pages"
2452038043 default-value="0">
24521- <attribute name="org.gtk.Property.get"
24522- value="adw_tab_view_get_n_pinned_pages"/>
2452338044 <doc xml:space="preserve"
2452438045 filename="src/adw-tab-view.c"
24525- line="2269">The number of pinned pages in the tab view.
38046+ line="2427">The number of pinned pages in the tab view.
2452638047
2452738048 See [method@TabView.set_page_pinned].</doc>
2452838049 <type name="gint" c:type="gint"/>
2452938050 </property>
2453038051 <property name="pages" transfer-ownership="none" getter="get_pages">
24531- <attribute name="org.gtk.Property.get" value="adw_tab_view_get_pages"/>
2453238052 <doc xml:space="preserve"
2453338053 filename="src/adw-tab-view.c"
24534- line="2363">A selection model with the tab view's pages.
38054+ line="2521">A selection model with the tab view's pages.
2453538055
2453638056 This can be used to keep an up-to-date view. The model also implements
2453738057 [iface@Gtk.SelectionModel] and can be used to track and change the selected
@@ -24543,13 +38063,9 @@ page.</doc>
2454338063 transfer-ownership="none"
2454438064 setter="set_selected_page"
2454538065 getter="get_selected_page">
24546- <attribute name="org.gtk.Property.get"
24547- value="adw_tab_view_get_selected_page"/>
24548- <attribute name="org.gtk.Property.set"
24549- value="adw_tab_view_set_selected_page"/>
2455038066 <doc xml:space="preserve"
2455138067 filename="src/adw-tab-view.c"
24552- line="2297">The currently selected page.</doc>
38068+ line="2455">The currently selected page.</doc>
2455338069 <type name="TabPage"/>
2455438070 </property>
2455538071 <property name="shortcuts"
@@ -24559,13 +38075,9 @@ page.</doc>
2455938075 setter="set_shortcuts"
2456038076 getter="get_shortcuts"
2456138077 default-value="ADW_TAB_VIEW_SHORTCUT_CONTROL_TAB | ADW_TAB_VIEW_SHORTCUT_CONTROL_SHIFT_TAB | ADW_TAB_VIEW_SHORTCUT_CONTROL_PAGE_UP | ADW_TAB_VIEW_SHORTCUT_CONTROL_PAGE_DOWN | ADW_TAB_VIEW_SHORTCUT_CONTROL_HOME | ADW_TAB_VIEW_SHORTCUT_CONTROL_END | ADW_TAB_VIEW_SHORTCUT_CONTROL_SHIFT_PAGE_UP | ADW_TAB_VIEW_SHORTCUT_CONTROL_SHIFT_PAGE_DOWN | ADW_TAB_VIEW_SHORTCUT_CONTROL_SHIFT_HOME | ADW_TAB_VIEW_SHORTCUT_CONTROL_SHIFT_END | ADW_TAB_VIEW_SHORTCUT_ALT_DIGITS | ADW_TAB_VIEW_SHORTCUT_ALT_ZERO">
24562- <attribute name="org.gtk.Property.get"
24563- value="adw_tab_view_get_shortcuts"/>
24564- <attribute name="org.gtk.Property.set"
24565- value="adw_tab_view_set_shortcuts"/>
2456638078 <doc xml:space="preserve"
2456738079 filename="src/adw-tab-view.c"
24568- line="2344">The enabled shortcuts.
38080+ line="2502">The enabled shortcuts.
2456938081
2457038082 See [flags@TabViewShortcuts] for the list of the available shortcuts. All
2457138083 of the shortcuts are enabled by default.
@@ -24577,7 +38089,7 @@ provide a convenient way to manage individual shortcuts.</doc>
2457738089 <glib:signal name="close-page" when="last">
2457838090 <doc xml:space="preserve"
2457938091 filename="src/adw-tab-view.c"
24580- line="2456">Emitted after [method@TabView.close_page] has been called for @page.
38092+ line="2614">Emitted after [method@TabView.close_page] has been called for @page.
2458138093
2458238094 The handler is expected to call [method@TabView.close_page_finish] to
2458338095 confirm or reject the closing.
@@ -24602,15 +38114,21 @@ the handler, so can be used to do asynchronous checks before confirming the
2460238114 closing.
2460338115
2460438116 A typical reason to connect to this signal is to show a confirmation dialog
24605-for closing a tab.</doc>
38117+for closing a tab.
38118+
38119+The signal handler should return `GDK_EVENT_STOP` to stop propagation or
38120+`GDK_EVENT_CONTINUE` to invoke the default handler.</doc>
2460638121 <return-value transfer-ownership="none">
38122+ <doc xml:space="preserve"
38123+ filename="src/adw-tab-view.c"
38124+ line="2649">whether propagation should be stopped</doc>
2460738125 <type name="gboolean" c:type="gboolean"/>
2460838126 </return-value>
2460938127 <parameters>
2461038128 <parameter name="page" transfer-ownership="none">
2461138129 <doc xml:space="preserve"
2461238130 filename="src/adw-tab-view.c"
24613- line="2459">a page of @self</doc>
38131+ line="2617">a page of @self</doc>
2461438132 <type name="TabPage"/>
2461538133 </parameter>
2461638134 </parameters>
@@ -24618,7 +38136,7 @@ for closing a tab.</doc>
2461838136 <glib:signal name="create-window" when="last">
2461938137 <doc xml:space="preserve"
2462038138 filename="src/adw-tab-view.c"
24621- line="2529">Emitted when a tab should be transferred into a new window.
38139+ line="2692">Emitted when a tab should be transferred into a new window.
2462238140
2462338141 This can happen after a tab has been dropped on desktop.
2462438142
@@ -24627,14 +38145,14 @@ needed and return its `AdwTabView` that the page will be transferred into.</doc>
2462738145 <return-value transfer-ownership="none" nullable="1">
2462838146 <doc xml:space="preserve"
2462938147 filename="src/adw-tab-view.c"
24630- line="2540">the `AdwTabView` from the new window</doc>
38148+ line="2703">the `AdwTabView` from the new window</doc>
2463138149 <type name="TabView"/>
2463238150 </return-value>
2463338151 </glib:signal>
2463438152 <glib:signal name="indicator-activated" when="last">
2463538153 <doc xml:space="preserve"
2463638154 filename="src/adw-tab-view.c"
24637- line="2556">Emitted after the indicator icon on @page has been activated.
38155+ line="2719">Emitted after the indicator icon on @page has been activated.
2463838156
2463938157 See [property@TabPage:indicator-icon] and
2464038158 [property@TabPage:indicator-activatable].</doc>
@@ -24645,7 +38163,7 @@ See [property@TabPage:indicator-icon] and
2464538163 <parameter name="page" transfer-ownership="none">
2464638164 <doc xml:space="preserve"
2464738165 filename="src/adw-tab-view.c"
24648- line="2559">a page of @self</doc>
38166+ line="2722">a page of @self</doc>
2464938167 <type name="TabPage"/>
2465038168 </parameter>
2465138169 </parameters>
@@ -24653,7 +38171,7 @@ See [property@TabPage:indicator-icon] and
2465338171 <glib:signal name="page-attached" when="last">
2465438172 <doc xml:space="preserve"
2465538173 filename="src/adw-tab-view.c"
24656- line="2379">Emitted when a page has been created or transferred to @self.
38174+ line="2537">Emitted when a page has been created or transferred to @self.
2465738175
2465838176 A typical reason to connect to this signal would be to connect to page
2465938177 signals for things such as updating window title.</doc>
@@ -24664,13 +38182,13 @@ signals for things such as updating window title.</doc>
2466438182 <parameter name="page" transfer-ownership="none">
2466538183 <doc xml:space="preserve"
2466638184 filename="src/adw-tab-view.c"
24667- line="2382">a page of @self</doc>
38185+ line="2540">a page of @self</doc>
2466838186 <type name="TabPage"/>
2466938187 </parameter>
2467038188 <parameter name="position" transfer-ownership="none">
2467138189 <doc xml:space="preserve"
2467238190 filename="src/adw-tab-view.c"
24673- line="2383">the position of the page, starting from 0</doc>
38191+ line="2541">the position of the page, starting from 0</doc>
2467438192 <type name="gint" c:type="gint"/>
2467538193 </parameter>
2467638194 </parameters>
@@ -24678,7 +38196,7 @@ signals for things such as updating window title.</doc>
2467838196 <glib:signal name="page-detached" when="last">
2467938197 <doc xml:space="preserve"
2468038198 filename="src/adw-tab-view.c"
24681- line="2404">Emitted when a page has been removed or transferred to another view.
38199+ line="2562">Emitted when a page has been removed or transferred to another view.
2468238200
2468338201 A typical reason to connect to this signal would be to disconnect signal
2468438202 handlers connected in the [signal@TabView::page-attached] handler.
@@ -24694,13 +38212,13 @@ child dispose handler for that or do it in sync with your
2469438212 <parameter name="page" transfer-ownership="none">
2469538213 <doc xml:space="preserve"
2469638214 filename="src/adw-tab-view.c"
24697- line="2407">a page of @self</doc>
38215+ line="2565">a page of @self</doc>
2469838216 <type name="TabPage"/>
2469938217 </parameter>
2470038218 <parameter name="position" transfer-ownership="none">
2470138219 <doc xml:space="preserve"
2470238220 filename="src/adw-tab-view.c"
24703- line="2408">the position of the removed page, starting from 0</doc>
38221+ line="2566">the position of the removed page, starting from 0</doc>
2470438222 <type name="gint" c:type="gint"/>
2470538223 </parameter>
2470638224 </parameters>
@@ -24708,7 +38226,7 @@ child dispose handler for that or do it in sync with your
2470838226 <glib:signal name="page-reordered" when="last">
2470938227 <doc xml:space="preserve"
2471038228 filename="src/adw-tab-view.c"
24711- line="2434">Emitted after @page has been reordered to @position.</doc>
38229+ line="2592">Emitted after @page has been reordered to @position.</doc>
2471238230 <return-value transfer-ownership="none">
2471338231 <type name="none" c:type="void"/>
2471438232 </return-value>
@@ -24716,13 +38234,13 @@ child dispose handler for that or do it in sync with your
2471638234 <parameter name="page" transfer-ownership="none">
2471738235 <doc xml:space="preserve"
2471838236 filename="src/adw-tab-view.c"
24719- line="2437">a page of @self</doc>
38237+ line="2595">a page of @self</doc>
2472038238 <type name="TabPage"/>
2472138239 </parameter>
2472238240 <parameter name="position" transfer-ownership="none">
2472338241 <doc xml:space="preserve"
2472438242 filename="src/adw-tab-view.c"
24725- line="2438">the position @page was moved to, starting at 0</doc>
38243+ line="2596">the position @page was moved to, starting at 0</doc>
2472638244 <type name="gint" c:type="gint"/>
2472738245 </parameter>
2472838246 </parameters>
@@ -24730,7 +38248,7 @@ child dispose handler for that or do it in sync with your
2473038248 <glib:signal name="setup-menu" when="last">
2473138249 <doc xml:space="preserve"
2473238250 filename="src/adw-tab-view.c"
24733- line="2503">Emitted when a context menu is opened or closed for @page.
38251+ line="2666">Emitted when a context menu is opened or closed for @page.
2473438252
2473538253 If the menu has been closed, @page will be set to `NULL`.
2473638254
@@ -24746,7 +38264,7 @@ disable actions not applicable to @page.</doc>
2474638264 allow-none="1">
2474738265 <doc xml:space="preserve"
2474838266 filename="src/adw-tab-view.c"
24749- line="2506">a page of @self</doc>
38267+ line="2669">a page of @self</doc>
2475038268 <type name="TabPage"/>
2475138269 </parameter>
2475238270 </parameters>
@@ -24767,7 +38285,7 @@ disable actions not applicable to @page.</doc>
2476738285 c:type="AdwTabViewShortcuts">
2476838286 <doc xml:space="preserve"
2476938287 filename="src/adw-tab-view.c"
24770- line="79">Describes available shortcuts in an [class@TabView].
38288+ line="83">Describes available shortcuts in an [class@TabView].
2477138289
2477238290 Shortcuts can be set with [property@TabView:shortcuts], or added/removed
2477338291 individually with [method@TabView.add_shortcuts] and
@@ -24781,7 +38299,7 @@ New values may be added to this enumeration over time.</doc>
2478138299 glib:name="ADW_TAB_VIEW_SHORTCUT_NONE">
2478238300 <doc xml:space="preserve"
2478338301 filename="src/adw-tab-view.c"
24784- line="81">No shortcuts</doc>
38302+ line="85">No shortcuts</doc>
2478538303 </member>
2478638304 <member name="control_tab"
2478738305 value="1"
@@ -24790,7 +38308,7 @@ New values may be added to this enumeration over time.</doc>
2479038308 glib:name="ADW_TAB_VIEW_SHORTCUT_CONTROL_TAB">
2479138309 <doc xml:space="preserve"
2479238310 filename="src/adw-tab-view.c"
24793- line="82">&lt;kbd&gt;Ctrl&lt;/kbd&gt;+&lt;kbd&gt;Tab&lt;/kbd&gt; - switch to the next page, with looping</doc>
38311+ line="86">&lt;kbd&gt;Ctrl&lt;/kbd&gt;+&lt;kbd&gt;Tab&lt;/kbd&gt; - switch to the next page</doc>
2479438312 </member>
2479538313 <member name="control_shift_tab"
2479638314 value="2"
@@ -24799,8 +38317,8 @@ New values may be added to this enumeration over time.</doc>
2479938317 glib:name="ADW_TAB_VIEW_SHORTCUT_CONTROL_SHIFT_TAB">
2480038318 <doc xml:space="preserve"
2480138319 filename="src/adw-tab-view.c"
24802- line="84">&lt;kbd&gt;Shift&lt;/kbd&gt;+&lt;kbd&gt;Ctrl&lt;/kbd&gt;+&lt;kbd&gt;Tab&lt;/kbd&gt; - switch to the previous
24803- page, with looping</doc>
38320+ line="88">&lt;kbd&gt;Shift&lt;/kbd&gt;+&lt;kbd&gt;Ctrl&lt;/kbd&gt;+&lt;kbd&gt;Tab&lt;/kbd&gt; - switch to the previous
38321+ page</doc>
2480438322 </member>
2480538323 <member name="control_page_up"
2480638324 value="4"
@@ -24809,7 +38327,7 @@ New values may be added to this enumeration over time.</doc>
2480938327 glib:name="ADW_TAB_VIEW_SHORTCUT_CONTROL_PAGE_UP">
2481038328 <doc xml:space="preserve"
2481138329 filename="src/adw-tab-view.c"
24812- line="87">&lt;kbd&gt;Ctrl&lt;/kbd&gt;+&lt;kbd&gt;Page Up&lt;/kbd&gt; - switch to the previous page</doc>
38330+ line="91">&lt;kbd&gt;Ctrl&lt;/kbd&gt;+&lt;kbd&gt;Page Up&lt;/kbd&gt; - switch to the previous page</doc>
2481338331 </member>
2481438332 <member name="control_page_down"
2481538333 value="8"
@@ -24818,7 +38336,7 @@ New values may be added to this enumeration over time.</doc>
2481838336 glib:name="ADW_TAB_VIEW_SHORTCUT_CONTROL_PAGE_DOWN">
2481938337 <doc xml:space="preserve"
2482038338 filename="src/adw-tab-view.c"
24821- line="89">&lt;kbd&gt;Ctrl&lt;/kbd&gt;+&lt;kbd&gt;Page Down&lt;/kbd&gt; - switch to the next page</doc>
38339+ line="93">&lt;kbd&gt;Ctrl&lt;/kbd&gt;+&lt;kbd&gt;Page Down&lt;/kbd&gt; - switch to the next page</doc>
2482238340 </member>
2482338341 <member name="control_home"
2482438342 value="16"
@@ -24827,7 +38345,7 @@ New values may be added to this enumeration over time.</doc>
2482738345 glib:name="ADW_TAB_VIEW_SHORTCUT_CONTROL_HOME">
2482838346 <doc xml:space="preserve"
2482938347 filename="src/adw-tab-view.c"
24830- line="91">&lt;kbd&gt;Ctrl&lt;/kbd&gt;+&lt;kbd&gt;Home&lt;/kbd&gt; - switch to the first page</doc>
38348+ line="95">&lt;kbd&gt;Ctrl&lt;/kbd&gt;+&lt;kbd&gt;Home&lt;/kbd&gt; - switch to the first page</doc>
2483138349 </member>
2483238350 <member name="control_end"
2483338351 value="32"
@@ -24836,7 +38354,7 @@ New values may be added to this enumeration over time.</doc>
2483638354 glib:name="ADW_TAB_VIEW_SHORTCUT_CONTROL_END">
2483738355 <doc xml:space="preserve"
2483838356 filename="src/adw-tab-view.c"
24839- line="93">&lt;kbd&gt;Ctrl&lt;/kbd&gt;+&lt;kbd&gt;End&lt;/kbd&gt; - switch to the last page</doc>
38357+ line="97">&lt;kbd&gt;Ctrl&lt;/kbd&gt;+&lt;kbd&gt;End&lt;/kbd&gt; - switch to the last page</doc>
2484038358 </member>
2484138359 <member name="control_shift_page_up"
2484238360 value="64"
@@ -24845,7 +38363,7 @@ New values may be added to this enumeration over time.</doc>
2484538363 glib:name="ADW_TAB_VIEW_SHORTCUT_CONTROL_SHIFT_PAGE_UP">
2484638364 <doc xml:space="preserve"
2484738365 filename="src/adw-tab-view.c"
24848- line="95">&lt;kbd&gt;Ctrl&lt;/kbd&gt;+&lt;kbd&gt;Shift&lt;/kbd&gt;+&lt;kbd&gt;Page Up&lt;/kbd&gt; - move the selected
38366+ line="99">&lt;kbd&gt;Ctrl&lt;/kbd&gt;+&lt;kbd&gt;Shift&lt;/kbd&gt;+&lt;kbd&gt;Page Up&lt;/kbd&gt; - move the selected
2484938367 page backward</doc>
2485038368 </member>
2485138369 <member name="control_shift_page_down"
@@ -24855,7 +38373,7 @@ New values may be added to this enumeration over time.</doc>
2485538373 glib:name="ADW_TAB_VIEW_SHORTCUT_CONTROL_SHIFT_PAGE_DOWN">
2485638374 <doc xml:space="preserve"
2485738375 filename="src/adw-tab-view.c"
24858- line="98">&lt;kbd&gt;Ctrl&lt;/kbd&gt;+&lt;kbd&gt;Shift&lt;/kbd&gt;+&lt;kbd&gt;Page Down&lt;/kbd&gt; - move the selected
38376+ line="102">&lt;kbd&gt;Ctrl&lt;/kbd&gt;+&lt;kbd&gt;Shift&lt;/kbd&gt;+&lt;kbd&gt;Page Down&lt;/kbd&gt; - move the selected
2485938377 page forward</doc>
2486038378 </member>
2486138379 <member name="control_shift_home"
@@ -24865,7 +38383,7 @@ New values may be added to this enumeration over time.</doc>
2486538383 glib:name="ADW_TAB_VIEW_SHORTCUT_CONTROL_SHIFT_HOME">
2486638384 <doc xml:space="preserve"
2486738385 filename="src/adw-tab-view.c"
24868- line="101">&lt;kbd&gt;Ctrl&lt;/kbd&gt;+&lt;kbd&gt;Shift&lt;/kbd&gt;+&lt;kbd&gt;Home&lt;/kbd&gt; - move the selected page
38386+ line="105">&lt;kbd&gt;Ctrl&lt;/kbd&gt;+&lt;kbd&gt;Shift&lt;/kbd&gt;+&lt;kbd&gt;Home&lt;/kbd&gt; - move the selected page
2486938387 at the start</doc>
2487038388 </member>
2487138389 <member name="control_shift_end"
@@ -24875,7 +38393,7 @@ New values may be added to this enumeration over time.</doc>
2487538393 glib:name="ADW_TAB_VIEW_SHORTCUT_CONTROL_SHIFT_END">
2487638394 <doc xml:space="preserve"
2487738395 filename="src/adw-tab-view.c"
24878- line="104">&lt;kbd&gt;Ctrl&lt;/kbd&gt;+&lt;kbd&gt;Shift&lt;/kbd&gt;+&lt;kbd&gt;End&lt;/kbd&gt; - move the current page at
38396+ line="108">&lt;kbd&gt;Ctrl&lt;/kbd&gt;+&lt;kbd&gt;Shift&lt;/kbd&gt;+&lt;kbd&gt;End&lt;/kbd&gt; - move the current page at
2487938397 the end</doc>
2488038398 </member>
2488138399 <member name="alt_digits"
@@ -24885,7 +38403,7 @@ New values may be added to this enumeration over time.</doc>
2488538403 glib:name="ADW_TAB_VIEW_SHORTCUT_ALT_DIGITS">
2488638404 <doc xml:space="preserve"
2488738405 filename="src/adw-tab-view.c"
24888- line="107">&lt;kbd&gt;Alt&lt;/kbd&gt;+&lt;kbd&gt;1&lt;/kbd&gt;⋯&lt;kbd&gt;9&lt;/kbd&gt; - switch to pages 1-9</doc>
38406+ line="111">&lt;kbd&gt;Alt&lt;/kbd&gt;+&lt;kbd&gt;1&lt;/kbd&gt;⋯&lt;kbd&gt;9&lt;/kbd&gt; - switch to pages 1-9</doc>
2488938407 </member>
2489038408 <member name="alt_zero"
2489138409 value="2048"
@@ -24894,7 +38412,7 @@ New values may be added to this enumeration over time.</doc>
2489438412 glib:name="ADW_TAB_VIEW_SHORTCUT_ALT_ZERO">
2489538413 <doc xml:space="preserve"
2489638414 filename="src/adw-tab-view.c"
24897- line="109">&lt;kbd&gt;Alt&lt;/kbd&gt;+&lt;kbd&gt;0&lt;/kbd&gt; - switch to page 10</doc>
38415+ line="113">&lt;kbd&gt;Alt&lt;/kbd&gt;+&lt;kbd&gt;0&lt;/kbd&gt; - switch to page 10</doc>
2489838416 </member>
2489938417 <member name="all_shortcuts"
2490038418 value="4095"
@@ -24903,7 +38421,7 @@ New values may be added to this enumeration over time.</doc>
2490338421 glib:name="ADW_TAB_VIEW_SHORTCUT_ALL_SHORTCUTS">
2490438422 <doc xml:space="preserve"
2490538423 filename="src/adw-tab-view.c"
24906- line="111">All of the shortcuts</doc>
38424+ line="115">All of the shortcuts</doc>
2490738425 </member>
2490838426 </bitfield>
2490938427 <class name="TimedAnimation"
@@ -24981,7 +38499,6 @@ to @to.</doc>
2498138499 <method name="get_alternate"
2498238500 c:identifier="adw_timed_animation_get_alternate"
2498338501 glib:get-property="alternate">
24984- <attribute name="org.gtk.Method.get_property" value="alternate"/>
2498538502 <doc xml:space="preserve"
2498638503 filename="src/adw-timed-animation.c"
2498738504 line="600">Gets whether @self changes direction on every iteration.</doc>
@@ -25004,7 +38521,6 @@ to @to.</doc>
2500438521 <method name="get_duration"
2500538522 c:identifier="adw_timed_animation_get_duration"
2500638523 glib:get-property="duration">
25007- <attribute name="org.gtk.Method.get_property" value="duration"/>
2500838524 <doc xml:space="preserve"
2500938525 filename="src/adw-timed-animation.c"
2501038526 line="444">Gets the duration of @self.</doc>
@@ -25027,7 +38543,6 @@ to @to.</doc>
2502738543 <method name="get_easing"
2502838544 c:identifier="adw_timed_animation_get_easing"
2502938545 glib:get-property="easing">
25030- <attribute name="org.gtk.Method.get_property" value="easing"/>
2503138546 <doc xml:space="preserve"
2503238547 filename="src/adw-timed-animation.c"
2503338548 line="483">Gets the easing function @self uses.</doc>
@@ -25050,7 +38565,6 @@ to @to.</doc>
2505038565 <method name="get_repeat_count"
2505138566 c:identifier="adw_timed_animation_get_repeat_count"
2505238567 glib:get-property="repeat-count">
25053- <attribute name="org.gtk.Method.get_property" value="repeat-count"/>
2505438568 <doc xml:space="preserve"
2505538569 filename="src/adw-timed-animation.c"
2505638570 line="524">Gets the number of times @self will play.</doc>
@@ -25073,7 +38587,6 @@ to @to.</doc>
2507338587 <method name="get_reverse"
2507438588 c:identifier="adw_timed_animation_get_reverse"
2507538589 glib:get-property="reverse">
25076- <attribute name="org.gtk.Method.get_property" value="reverse"/>
2507738590 <doc xml:space="preserve"
2507838591 filename="src/adw-timed-animation.c"
2507938592 line="563">Gets whether @self plays backwards.</doc>
@@ -25096,7 +38609,6 @@ to @to.</doc>
2509638609 <method name="get_value_from"
2509738610 c:identifier="adw_timed_animation_get_value_from"
2509838611 glib:get-property="value-from">
25099- <attribute name="org.gtk.Method.get_property" value="value-from"/>
2510038612 <doc xml:space="preserve"
2510138613 filename="src/adw-timed-animation.c"
2510238614 line="358">Gets the value @self will animate from.</doc>
@@ -25119,7 +38631,6 @@ to @to.</doc>
2511938631 <method name="get_value_to"
2512038632 c:identifier="adw_timed_animation_get_value_to"
2512138633 glib:get-property="value-to">
25122- <attribute name="org.gtk.Method.get_property" value="value-to"/>
2512338634 <doc xml:space="preserve"
2512438635 filename="src/adw-timed-animation.c"
2512538636 line="401">Gets the value @self will animate to.</doc>
@@ -25142,7 +38653,6 @@ to @to.</doc>
2514238653 <method name="set_alternate"
2514338654 c:identifier="adw_timed_animation_set_alternate"
2514438655 glib:set-property="alternate">
25145- <attribute name="org.gtk.Method.set_property" value="alternate"/>
2514638656 <doc xml:space="preserve"
2514738657 filename="src/adw-timed-animation.c"
2514838658 line="616">Sets whether @self changes direction on every iteration.</doc>
@@ -25168,7 +38678,6 @@ to @to.</doc>
2516838678 <method name="set_duration"
2516938679 c:identifier="adw_timed_animation_set_duration"
2517038680 glib:set-property="duration">
25171- <attribute name="org.gtk.Method.set_property" value="duration"/>
2517238681 <doc xml:space="preserve"
2517338682 filename="src/adw-timed-animation.c"
2517438683 line="460">Sets the duration of @self.
@@ -25196,7 +38705,6 @@ If the animation repeats more than once, sets the duration of one iteration.</do
2519638705 <method name="set_easing"
2519738706 c:identifier="adw_timed_animation_set_easing"
2519838707 glib:set-property="easing">
25199- <attribute name="org.gtk.Method.set_property" value="easing"/>
2520038708 <doc xml:space="preserve"
2520138709 filename="src/adw-timed-animation.c"
2520238710 line="500">Sets the easing function @self will use.
@@ -25224,7 +38732,6 @@ See [enum@Easing] for the description of specific easing functions.</doc>
2522438732 <method name="set_repeat_count"
2522538733 c:identifier="adw_timed_animation_set_repeat_count"
2522638734 glib:set-property="repeat-count">
25227- <attribute name="org.gtk.Method.set_property" value="repeat-count"/>
2522838735 <doc xml:space="preserve"
2522938736 filename="src/adw-timed-animation.c"
2523038737 line="540">Sets the number of times @self will play.
@@ -25252,7 +38759,6 @@ If set to 0, @self will repeat endlessly.</doc>
2525238759 <method name="set_reverse"
2525338760 c:identifier="adw_timed_animation_set_reverse"
2525438761 glib:set-property="reverse">
25255- <attribute name="org.gtk.Method.set_property" value="reverse"/>
2525638762 <doc xml:space="preserve"
2525738763 filename="src/adw-timed-animation.c"
2525838764 line="579">Sets whether @self plays backwards.</doc>
@@ -25278,7 +38784,6 @@ If set to 0, @self will repeat endlessly.</doc>
2527838784 <method name="set_value_from"
2527938785 c:identifier="adw_timed_animation_set_value_from"
2528038786 glib:set-property="value-from">
25281- <attribute name="org.gtk.Method.set_property" value="value-from"/>
2528238787 <doc xml:space="preserve"
2528338788 filename="src/adw-timed-animation.c"
2528438789 line="374">Sets the value @self will animate from.
@@ -25310,7 +38815,6 @@ this value instead.</doc>
2531038815 <method name="set_value_to"
2531138816 c:identifier="adw_timed_animation_set_value_to"
2531238817 glib:set-property="value-to">
25313- <attribute name="org.gtk.Method.set_property" value="value-to"/>
2531438818 <doc xml:space="preserve"
2531538819 filename="src/adw-timed-animation.c"
2531638820 line="417">Sets the value @self will animate to.
@@ -25346,10 +38850,6 @@ at this value instead.</doc>
2534638850 setter="set_alternate"
2534738851 getter="get_alternate"
2534838852 default-value="FALSE">
25349- <attribute name="org.gtk.Property.get"
25350- value="adw_timed_animation_get_alternate"/>
25351- <attribute name="org.gtk.Property.set"
25352- value="adw_timed_animation_set_alternate"/>
2535338853 <doc xml:space="preserve"
2535438854 filename="src/adw-timed-animation.c"
2535538855 line="302">Whether the animation changes direction on every iteration.</doc>
@@ -25362,10 +38862,6 @@ at this value instead.</doc>
2536238862 setter="set_duration"
2536338863 getter="get_duration"
2536438864 default-value="0">
25365- <attribute name="org.gtk.Property.get"
25366- value="adw_timed_animation_get_duration"/>
25367- <attribute name="org.gtk.Property.set"
25368- value="adw_timed_animation_set_duration"/>
2536938865 <doc xml:space="preserve"
2537038866 filename="src/adw-timed-animation.c"
2537138867 line="246">Duration of the animation, in milliseconds.
@@ -25383,10 +38879,6 @@ iteration.</doc>
2538338879 setter="set_easing"
2538438880 getter="get_easing"
2538538881 default-value="ADW_EASE_OUT_CUBIC">
25386- <attribute name="org.gtk.Property.get"
25387- value="adw_timed_animation_get_easing"/>
25388- <attribute name="org.gtk.Property.set"
25389- value="adw_timed_animation_set_easing"/>
2539038882 <doc xml:space="preserve"
2539138883 filename="src/adw-timed-animation.c"
2539238884 line="263">Easing function used in the animation.
@@ -25403,10 +38895,6 @@ See [enum@Easing] for the description of specific easing functions.</doc>
2540338895 setter="set_repeat_count"
2540438896 getter="get_repeat_count"
2540538897 default-value="1">
25406- <attribute name="org.gtk.Property.get"
25407- value="adw_timed_animation_get_repeat_count"/>
25408- <attribute name="org.gtk.Property.set"
25409- value="adw_timed_animation_set_repeat_count"/>
2541038898 <doc xml:space="preserve"
2541138899 filename="src/adw-timed-animation.c"
2541238900 line="278">Number of times the animation will play.
@@ -25421,10 +38909,6 @@ If set to 0, the animation will repeat endlessly.</doc>
2542138909 setter="set_reverse"
2542238910 getter="get_reverse"
2542338911 default-value="FALSE">
25424- <attribute name="org.gtk.Property.get"
25425- value="adw_timed_animation_get_reverse"/>
25426- <attribute name="org.gtk.Property.set"
25427- value="adw_timed_animation_set_reverse"/>
2542838912 <doc xml:space="preserve"
2542938913 filename="src/adw-timed-animation.c"
2543038914 line="292">Whether the animation plays backwards.</doc>
@@ -25437,10 +38921,6 @@ If set to 0, the animation will repeat endlessly.</doc>
2543738921 setter="set_value_from"
2543838922 getter="get_value_from"
2543938923 default-value="0.000000">
25440- <attribute name="org.gtk.Property.get"
25441- value="adw_timed_animation_get_value_from"/>
25442- <attribute name="org.gtk.Property.set"
25443- value="adw_timed_animation_set_value_from"/>
2544438924 <doc xml:space="preserve"
2544538925 filename="src/adw-timed-animation.c"
2544638926 line="210">The value to animate from.
@@ -25459,10 +38939,6 @@ this value instead.</doc>
2545938939 setter="set_value_to"
2546038940 getter="get_value_to"
2546138941 default-value="0.000000">
25462- <attribute name="org.gtk.Property.get"
25463- value="adw_timed_animation_get_value_to"/>
25464- <attribute name="org.gtk.Property.set"
25465- value="adw_timed_animation_set_value_to"/>
2546638942 <doc xml:space="preserve"
2546738943 filename="src/adw-timed-animation.c"
2546838944 line="228">The value to animate to.
@@ -25513,6 +38989,9 @@ signal when disappearing.
2551338989 [property@Toast:priority] determines how it behaves if another toast is
2551438990 already being displayed.
2551538991
38992+Toast titles use Pango markup by default, set [property@Toast:use-markup] to
38993+`FALSE` if this is unwanted.
38994+
2551638995 [property@Toast:custom-title] can be used to replace the title label with a
2551738996 custom widget.
2551838997
@@ -25586,96 +39065,507 @@ delete_item (MyWindow *self,
2558639065 return;
2558739066 }
2558839067
25589- title =
25590- g_strdup_printf (ngettext ("&lt;span font_features='tnum=1'&gt;%d&lt;/span&gt; item deleted",
25591- "&lt;span font_features='tnum=1'&gt;%d&lt;/span&gt; items deleted",
25592- n_items), n_items);
39068+ title =
39069+ g_strdup_printf (ngettext ("&lt;span font_features='tnum=1'&gt;%d&lt;/span&gt; item deleted",
39070+ "&lt;span font_features='tnum=1'&gt;%d&lt;/span&gt; items deleted",
39071+ n_items), n_items);
39072+
39073+ adw_toast_set_title (self-&gt;undo_toast, title);
39074+
39075+ // Bump the toast timeout
39076+ adw_toast_overlay_add_toast (self-&gt;toast_overlay, g_object_ref (self-&gt;undo_toast));
39077+}
39078+
39079+static void
39080+my_window_class_init (MyWindowClass *klass)
39081+{
39082+ GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (klass);
39083+
39084+ gtk_widget_class_install_action (widget_class, "toast.undo", NULL, toast_undo_cb);
39085+}
39086+```
39087+
39088+&lt;picture&gt;
39089+ &lt;source srcset="toast-undo-dark.png" media="(prefers-color-scheme: dark)"&gt;
39090+ &lt;img src="toast-undo.png" alt="toast-undo"&gt;
39091+&lt;/picture&gt;</doc>
39092+ <source-position filename="src/adw-toast.h" line="28"/>
39093+ <constructor name="new" c:identifier="adw_toast_new">
39094+ <doc xml:space="preserve"
39095+ filename="src/adw-toast.c"
39096+ line="481">Creates a new `AdwToast`.
39097+
39098+The toast will use @title as its title.
39099+
39100+@title can be marked up with the Pango text markup language.</doc>
39101+ <source-position filename="src/adw-toast.h" line="31"/>
39102+ <return-value transfer-ownership="full">
39103+ <doc xml:space="preserve"
39104+ filename="src/adw-toast.c"
39105+ line="491">the new created `AdwToast`</doc>
39106+ <type name="Toast" c:type="AdwToast*"/>
39107+ </return-value>
39108+ <parameters>
39109+ <parameter name="title" transfer-ownership="none">
39110+ <doc xml:space="preserve"
39111+ filename="src/adw-toast.c"
39112+ line="483">the title to be displayed</doc>
39113+ <type name="utf8" c:type="const char*"/>
39114+ </parameter>
39115+ </parameters>
39116+ </constructor>
39117+ <constructor name="new_format"
39118+ c:identifier="adw_toast_new_format"
39119+ version="1.2"
39120+ introspectable="0">
39121+ <doc xml:space="preserve"
39122+ filename="src/adw-toast.c"
39123+ line="503">Creates a new `AdwToast`.
39124+
39125+The toast will use the format string as its title.
39126+
39127+See also: [ctor@Toast.new]</doc>
39128+ <source-position filename="src/adw-toast.h" line="33"/>
39129+ <return-value transfer-ownership="full">
39130+ <doc xml:space="preserve"
39131+ filename="src/adw-toast.c"
39132+ line="514">the newly created toast object</doc>
39133+ <type name="Toast" c:type="AdwToast*"/>
39134+ </return-value>
39135+ <parameters>
39136+ <parameter name="format" transfer-ownership="none">
39137+ <doc xml:space="preserve"
39138+ filename="src/adw-toast.c"
39139+ line="505">the formatted string for the toast title</doc>
39140+ <type name="utf8" c:type="const char*"/>
39141+ </parameter>
39142+ <parameter name="..." transfer-ownership="none">
39143+ <doc xml:space="preserve"
39144+ filename="src/adw-toast.c"
39145+ line="506">the parameters to insert into the format string</doc>
39146+ <varargs/>
39147+ </parameter>
39148+ </parameters>
39149+ </constructor>
39150+ <method name="dismiss" c:identifier="adw_toast_dismiss">
39151+ <doc xml:space="preserve"
39152+ filename="src/adw-toast.c"
39153+ line="936">Dismisses @self.
39154+
39155+Does nothing if @self has already been dismissed, or hasn't been added to an
39156+[class@ToastOverlay].</doc>
39157+ <source-position filename="src/adw-toast.h" line="92"/>
39158+ <return-value transfer-ownership="none">
39159+ <type name="none" c:type="void"/>
39160+ </return-value>
39161+ <parameters>
39162+ <instance-parameter name="self" transfer-ownership="none">
39163+ <doc xml:space="preserve"
39164+ filename="src/adw-toast.c"
39165+ line="938">a toast</doc>
39166+ <type name="Toast" c:type="AdwToast*"/>
39167+ </instance-parameter>
39168+ </parameters>
39169+ </method>
39170+ <method name="get_action_name"
39171+ c:identifier="adw_toast_get_action_name"
39172+ glib:get-property="action-name">
39173+ <doc xml:space="preserve"
39174+ filename="src/adw-toast.c"
39175+ line="636">Gets the name of the associated action.</doc>
39176+ <source-position filename="src/adw-toast.h" line="49"/>
39177+ <return-value transfer-ownership="none" nullable="1">
39178+ <doc xml:space="preserve"
39179+ filename="src/adw-toast.c"
39180+ line="642">the action name</doc>
39181+ <type name="utf8" c:type="const char*"/>
39182+ </return-value>
39183+ <parameters>
39184+ <instance-parameter name="self" transfer-ownership="none">
39185+ <doc xml:space="preserve"
39186+ filename="src/adw-toast.c"
39187+ line="638">a toast</doc>
39188+ <type name="Toast" c:type="AdwToast*"/>
39189+ </instance-parameter>
39190+ </parameters>
39191+ </method>
39192+ <method name="get_action_target_value"
39193+ c:identifier="adw_toast_get_action_target_value"
39194+ glib:get-property="action-target">
39195+ <doc xml:space="preserve"
39196+ filename="src/adw-toast.c"
39197+ line="675">Gets the parameter for action invocations.</doc>
39198+ <source-position filename="src/adw-toast.h" line="55"/>
39199+ <return-value transfer-ownership="none" nullable="1">
39200+ <doc xml:space="preserve"
39201+ filename="src/adw-toast.c"
39202+ line="681">the action target</doc>
39203+ <type name="GLib.Variant" c:type="GVariant*"/>
39204+ </return-value>
39205+ <parameters>
39206+ <instance-parameter name="self" transfer-ownership="none">
39207+ <doc xml:space="preserve"
39208+ filename="src/adw-toast.c"
39209+ line="677">a toast</doc>
39210+ <type name="Toast" c:type="AdwToast*"/>
39211+ </instance-parameter>
39212+ </parameters>
39213+ </method>
39214+ <method name="get_button_label"
39215+ c:identifier="adw_toast_get_button_label"
39216+ glib:get-property="button-label">
39217+ <doc xml:space="preserve"
39218+ filename="src/adw-toast.c"
39219+ line="595">Gets the label to show on the button.</doc>
39220+ <source-position filename="src/adw-toast.h" line="43"/>
39221+ <return-value transfer-ownership="none" nullable="1">
39222+ <doc xml:space="preserve"
39223+ filename="src/adw-toast.c"
39224+ line="601">the button label</doc>
39225+ <type name="utf8" c:type="const char*"/>
39226+ </return-value>
39227+ <parameters>
39228+ <instance-parameter name="self" transfer-ownership="none">
39229+ <doc xml:space="preserve"
39230+ filename="src/adw-toast.c"
39231+ line="597">a toast</doc>
39232+ <type name="Toast" c:type="AdwToast*"/>
39233+ </instance-parameter>
39234+ </parameters>
39235+ </method>
39236+ <method name="get_custom_title"
39237+ c:identifier="adw_toast_get_custom_title"
39238+ glib:get-property="custom-title"
39239+ version="1.2">
39240+ <doc xml:space="preserve"
39241+ filename="src/adw-toast.c"
39242+ line="880">Gets the custom title widget of @self.</doc>
39243+ <source-position filename="src/adw-toast.h" line="80"/>
39244+ <return-value transfer-ownership="none" nullable="1">
39245+ <doc xml:space="preserve"
39246+ filename="src/adw-toast.c"
39247+ line="886">the custom title widget</doc>
39248+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
39249+ </return-value>
39250+ <parameters>
39251+ <instance-parameter name="self" transfer-ownership="none">
39252+ <doc xml:space="preserve"
39253+ filename="src/adw-toast.c"
39254+ line="882">a toast</doc>
39255+ <type name="Toast" c:type="AdwToast*"/>
39256+ </instance-parameter>
39257+ </parameters>
39258+ </method>
39259+ <method name="get_priority"
39260+ c:identifier="adw_toast_get_priority"
39261+ glib:get-property="priority">
39262+ <doc xml:space="preserve"
39263+ filename="src/adw-toast.c"
39264+ line="790">Gets priority for @self.</doc>
39265+ <source-position filename="src/adw-toast.h" line="68"/>
39266+ <return-value transfer-ownership="none">
39267+ <doc xml:space="preserve"
39268+ filename="src/adw-toast.c"
39269+ line="796">the priority</doc>
39270+ <type name="ToastPriority" c:type="AdwToastPriority"/>
39271+ </return-value>
39272+ <parameters>
39273+ <instance-parameter name="self" transfer-ownership="none">
39274+ <doc xml:space="preserve"
39275+ filename="src/adw-toast.c"
39276+ line="792">a toast</doc>
39277+ <type name="Toast" c:type="AdwToast*"/>
39278+ </instance-parameter>
39279+ </parameters>
39280+ </method>
39281+ <method name="get_timeout"
39282+ c:identifier="adw_toast_get_timeout"
39283+ glib:get-property="timeout">
39284+ <doc xml:space="preserve"
39285+ filename="src/adw-toast.c"
39286+ line="837">Gets timeout for @self.</doc>
39287+ <source-position filename="src/adw-toast.h" line="74"/>
39288+ <return-value transfer-ownership="none">
39289+ <doc xml:space="preserve"
39290+ filename="src/adw-toast.c"
39291+ line="843">the timeout</doc>
39292+ <type name="guint" c:type="guint"/>
39293+ </return-value>
39294+ <parameters>
39295+ <instance-parameter name="self" transfer-ownership="none">
39296+ <doc xml:space="preserve"
39297+ filename="src/adw-toast.c"
39298+ line="839">a toast</doc>
39299+ <type name="Toast" c:type="AdwToast*"/>
39300+ </instance-parameter>
39301+ </parameters>
39302+ </method>
39303+ <method name="get_title"
39304+ c:identifier="adw_toast_get_title"
39305+ glib:get-property="title">
39306+ <doc xml:space="preserve"
39307+ filename="src/adw-toast.c"
39308+ line="539">Gets the title that will be displayed on the toast.
39309+
39310+If a custom title has been set with [method@Adw.Toast.set_custom_title]
39311+the return value will be %NULL.</doc>
39312+ <source-position filename="src/adw-toast.h" line="37"/>
39313+ <return-value transfer-ownership="none" nullable="1">
39314+ <doc xml:space="preserve"
39315+ filename="src/adw-toast.c"
39316+ line="548">the title</doc>
39317+ <type name="utf8" c:type="const char*"/>
39318+ </return-value>
39319+ <parameters>
39320+ <instance-parameter name="self" transfer-ownership="none">
39321+ <doc xml:space="preserve"
39322+ filename="src/adw-toast.c"
39323+ line="541">a toast</doc>
39324+ <type name="Toast" c:type="AdwToast*"/>
39325+ </instance-parameter>
39326+ </parameters>
39327+ </method>
39328+ <method name="get_use_markup"
39329+ c:identifier="adw_toast_get_use_markup"
39330+ glib:get-property="use-markup"
39331+ version="1.4">
39332+ <doc xml:space="preserve"
39333+ filename="src/adw-toast.c"
39334+ line="974">Gets whether to use Pango markup for the toast title.</doc>
39335+ <source-position filename="src/adw-toast.h" line="86"/>
39336+ <return-value transfer-ownership="none">
39337+ <doc xml:space="preserve"
39338+ filename="src/adw-toast.c"
39339+ line="980">whether the toast uses markup</doc>
39340+ <type name="gboolean" c:type="gboolean"/>
39341+ </return-value>
39342+ <parameters>
39343+ <instance-parameter name="self" transfer-ownership="none">
39344+ <doc xml:space="preserve"
39345+ filename="src/adw-toast.c"
39346+ line="976">a toast</doc>
39347+ <type name="Toast" c:type="AdwToast*"/>
39348+ </instance-parameter>
39349+ </parameters>
39350+ </method>
39351+ <method name="set_action_name"
39352+ c:identifier="adw_toast_set_action_name"
39353+ glib:set-property="action-name">
39354+ <doc xml:space="preserve"
39355+ filename="src/adw-toast.c"
39356+ line="652">Sets the name of the associated action.
2559339357
25594- adw_toast_set_title (self-&gt;undo_toast, title);
39358+It will be activated when clicking the button.
2559539359
25596- // Bump the toast timeout
25597- adw_toast_overlay_add_toast (self-&gt;toast_overlay, g_object_ref (self-&gt;undo_toast));
25598-}
39360+See [property@Toast:action-target].</doc>
39361+ <source-position filename="src/adw-toast.h" line="51"/>
39362+ <return-value transfer-ownership="none">
39363+ <type name="none" c:type="void"/>
39364+ </return-value>
39365+ <parameters>
39366+ <instance-parameter name="self" transfer-ownership="none">
39367+ <doc xml:space="preserve"
39368+ filename="src/adw-toast.c"
39369+ line="654">a toast</doc>
39370+ <type name="Toast" c:type="AdwToast*"/>
39371+ </instance-parameter>
39372+ <parameter name="action_name"
39373+ transfer-ownership="none"
39374+ nullable="1"
39375+ allow-none="1">
39376+ <doc xml:space="preserve"
39377+ filename="src/adw-toast.c"
39378+ line="655">the action name</doc>
39379+ <type name="utf8" c:type="const char*"/>
39380+ </parameter>
39381+ </parameters>
39382+ </method>
39383+ <method name="set_action_target"
39384+ c:identifier="adw_toast_set_action_target"
39385+ introspectable="0">
39386+ <doc xml:space="preserve"
39387+ filename="src/adw-toast.c"
39388+ line="721">Sets the parameter for action invocations.
2559939389
25600-static void
25601-my_window_class_init (MyWindowClass *klass)
25602-{
25603- GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (klass);
39390+This is a convenience function that calls [ctor@GLib.Variant.new] for
39391+@format_string and uses the result to call
39392+[method@Toast.set_action_target_value].
2560439393
25605- gtk_widget_class_install_action (widget_class, "toast.undo", NULL, toast_undo_cb);
25606-}
25607-```
39394+If you are setting a string-valued target and want to set
39395+the action name at the same time, you can use
39396+[method@Toast.set_detailed_action_name].</doc>
39397+ <source-position filename="src/adw-toast.h" line="60"/>
39398+ <return-value transfer-ownership="none">
39399+ <type name="none" c:type="void"/>
39400+ </return-value>
39401+ <parameters>
39402+ <instance-parameter name="self" transfer-ownership="none">
39403+ <doc xml:space="preserve"
39404+ filename="src/adw-toast.c"
39405+ line="723">a toast</doc>
39406+ <type name="Toast" c:type="AdwToast*"/>
39407+ </instance-parameter>
39408+ <parameter name="format_string"
39409+ transfer-ownership="none"
39410+ nullable="1"
39411+ allow-none="1">
39412+ <doc xml:space="preserve"
39413+ filename="src/adw-toast.c"
39414+ line="724">a variant format string</doc>
39415+ <type name="utf8" c:type="const char*"/>
39416+ </parameter>
39417+ <parameter name="..." transfer-ownership="none">
39418+ <doc xml:space="preserve"
39419+ filename="src/adw-toast.c"
39420+ line="725">arguments appropriate for @target_format</doc>
39421+ <varargs/>
39422+ </parameter>
39423+ </parameters>
39424+ </method>
39425+ <method name="set_action_target_value"
39426+ c:identifier="adw_toast_set_action_target_value"
39427+ glib:set-property="action-target">
39428+ <doc xml:space="preserve"
39429+ filename="src/adw-toast.c"
39430+ line="691">Sets the parameter for action invocations.
2560839431
25609-&lt;picture&gt;
25610- &lt;source srcset="toast-undo-dark.png" media="(prefers-color-scheme: dark)"&gt;
25611- &lt;img src="toast-undo.png" alt="toast-undo"&gt;
25612-&lt;/picture&gt;</doc>
25613- <source-position filename="src/adw-toast.h" line="28"/>
25614- <constructor name="new" c:identifier="adw_toast_new">
39432+If the @action_target variant has a floating reference this function
39433+will sink it.</doc>
39434+ <source-position filename="src/adw-toast.h" line="57"/>
39435+ <return-value transfer-ownership="none">
39436+ <type name="none" c:type="void"/>
39437+ </return-value>
39438+ <parameters>
39439+ <instance-parameter name="self" transfer-ownership="none">
39440+ <doc xml:space="preserve"
39441+ filename="src/adw-toast.c"
39442+ line="693">a toast</doc>
39443+ <type name="Toast" c:type="AdwToast*"/>
39444+ </instance-parameter>
39445+ <parameter name="action_target"
39446+ transfer-ownership="none"
39447+ nullable="1"
39448+ allow-none="1">
39449+ <doc xml:space="preserve"
39450+ filename="src/adw-toast.c"
39451+ line="694">the action target</doc>
39452+ <type name="GLib.Variant" c:type="GVariant*"/>
39453+ </parameter>
39454+ </parameters>
39455+ </method>
39456+ <method name="set_button_label"
39457+ c:identifier="adw_toast_set_button_label"
39458+ glib:set-property="button-label">
2561539459 <doc xml:space="preserve"
2561639460 filename="src/adw-toast.c"
25617- line="455">Creates a new `AdwToast`.
39461+ line="611">Sets the label to show on the button.
2561839462
25619-The toast will use @title as its title.
39463+Underlines in the button text can be used to indicate a mnemonic.
2562039464
25621-@title can be marked up with the Pango text markup language.</doc>
25622- <source-position filename="src/adw-toast.h" line="31"/>
25623- <return-value transfer-ownership="full">
25624- <doc xml:space="preserve"
25625- filename="src/adw-toast.c"
25626- line="465">the new created `AdwToast`</doc>
25627- <type name="Toast" c:type="AdwToast*"/>
39465+If set to `NULL`, the button won't be shown.
39466+
39467+See [property@Toast:action-name].</doc>
39468+ <source-position filename="src/adw-toast.h" line="45"/>
39469+ <return-value transfer-ownership="none">
39470+ <type name="none" c:type="void"/>
2562839471 </return-value>
2562939472 <parameters>
25630- <parameter name="title" transfer-ownership="none">
39473+ <instance-parameter name="self" transfer-ownership="none">
39474+ <doc xml:space="preserve"
39475+ filename="src/adw-toast.c"
39476+ line="613">a toast</doc>
39477+ <type name="Toast" c:type="AdwToast*"/>
39478+ </instance-parameter>
39479+ <parameter name="button_label"
39480+ transfer-ownership="none"
39481+ nullable="1"
39482+ allow-none="1">
2563139483 <doc xml:space="preserve"
2563239484 filename="src/adw-toast.c"
25633- line="457">the title to be displayed</doc>
39485+ line="614">a button label</doc>
2563439486 <type name="utf8" c:type="const char*"/>
2563539487 </parameter>
2563639488 </parameters>
25637- </constructor>
25638- <constructor name="new_format"
25639- c:identifier="adw_toast_new_format"
25640- version="1.2"
25641- introspectable="0">
39489+ </method>
39490+ <method name="set_custom_title"
39491+ c:identifier="adw_toast_set_custom_title"
39492+ glib:set-property="custom-title"
39493+ version="1.2">
2564239494 <doc xml:space="preserve"
2564339495 filename="src/adw-toast.c"
25644- line="477">Creates a new `AdwToast`.
39496+ line="898">Sets the custom title widget of @self.
2564539497
25646-The toast will use the format string as its title.
39498+It will be displayed instead of the title if set. In this case,
39499+[property@Toast:title] is ignored.
2564739500
25648-See also: [ctor@Toast.new]</doc>
25649- <source-position filename="src/adw-toast.h" line="33"/>
25650- <return-value transfer-ownership="full">
25651- <doc xml:space="preserve"
25652- filename="src/adw-toast.c"
25653- line="488">the newly created toast object</doc>
25654- <type name="Toast" c:type="AdwToast*"/>
39501+Setting a custom title will unset [property@Toast:title].</doc>
39502+ <source-position filename="src/adw-toast.h" line="82"/>
39503+ <return-value transfer-ownership="none">
39504+ <type name="none" c:type="void"/>
2565539505 </return-value>
2565639506 <parameters>
25657- <parameter name="format" transfer-ownership="none">
39507+ <instance-parameter name="self" transfer-ownership="none">
2565839508 <doc xml:space="preserve"
2565939509 filename="src/adw-toast.c"
25660- line="479">the formatted string for the toast title</doc>
25661- <type name="utf8" c:type="const char*"/>
39510+ line="900">a toast</doc>
39511+ <type name="Toast" c:type="AdwToast*"/>
39512+ </instance-parameter>
39513+ <parameter name="widget"
39514+ transfer-ownership="none"
39515+ nullable="1"
39516+ allow-none="1">
39517+ <doc xml:space="preserve"
39518+ filename="src/adw-toast.c"
39519+ line="901">the custom title widget</doc>
39520+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
2566239521 </parameter>
25663- <parameter name="..." transfer-ownership="none">
39522+ </parameters>
39523+ </method>
39524+ <method name="set_detailed_action_name"
39525+ c:identifier="adw_toast_set_detailed_action_name">
39526+ <doc xml:space="preserve"
39527+ filename="src/adw-toast.c"
39528+ line="751">Sets the action name and its parameter.
39529+
39530+@detailed_action_name is a string in the format accepted by
39531+[func@Gio.Action.parse_detailed_name].</doc>
39532+ <source-position filename="src/adw-toast.h" line="64"/>
39533+ <return-value transfer-ownership="none">
39534+ <type name="none" c:type="void"/>
39535+ </return-value>
39536+ <parameters>
39537+ <instance-parameter name="self" transfer-ownership="none">
2566439538 <doc xml:space="preserve"
2566539539 filename="src/adw-toast.c"
25666- line="480">the parameters to insert into the format string</doc>
25667- <varargs/>
39540+ line="753">a toast</doc>
39541+ <type name="Toast" c:type="AdwToast*"/>
39542+ </instance-parameter>
39543+ <parameter name="detailed_action_name"
39544+ transfer-ownership="none"
39545+ nullable="1"
39546+ allow-none="1">
39547+ <doc xml:space="preserve"
39548+ filename="src/adw-toast.c"
39549+ line="754">the detailed action name</doc>
39550+ <type name="utf8" c:type="const char*"/>
2566839551 </parameter>
2566939552 </parameters>
25670- </constructor>
25671- <method name="dismiss" c:identifier="adw_toast_dismiss">
39553+ </method>
39554+ <method name="set_priority"
39555+ c:identifier="adw_toast_set_priority"
39556+ glib:set-property="priority">
2567239557 <doc xml:space="preserve"
2567339558 filename="src/adw-toast.c"
25674- line="914">Dismisses @self.
39559+ line="806">Sets priority for @self.
2567539560
25676-Does nothing if @self has already been dismissed, or hasn't been added to an
25677-[class@ToastOverlay].</doc>
25678- <source-position filename="src/adw-toast.h" line="86"/>
39561+Priority controls how the toast behaves when another toast is already
39562+being displayed.
39563+
39564+If @priority is `ADW_TOAST_PRIORITY_NORMAL`, the toast will be queued.
39565+
39566+If @priority is `ADW_TOAST_PRIORITY_HIGH`, the toast will be displayed
39567+immediately, pushing the previous toast into the queue instead.</doc>
39568+ <source-position filename="src/adw-toast.h" line="70"/>
2567939569 <return-value transfer-ownership="none">
2568039570 <type name="none" c:type="void"/>
2568139571 </return-value>
@@ -25683,842 +39573,1402 @@ Does nothing if @self has already been dismissed, or hasn't been added to an
2568339573 <instance-parameter name="self" transfer-ownership="none">
2568439574 <doc xml:space="preserve"
2568539575 filename="src/adw-toast.c"
25686- line="916">a toast</doc>
39576+ line="808">a toast</doc>
2568739577 <type name="Toast" c:type="AdwToast*"/>
2568839578 </instance-parameter>
39579+ <parameter name="priority" transfer-ownership="none">
39580+ <doc xml:space="preserve"
39581+ filename="src/adw-toast.c"
39582+ line="809">the priority</doc>
39583+ <type name="ToastPriority" c:type="AdwToastPriority"/>
39584+ </parameter>
2568939585 </parameters>
2569039586 </method>
25691- <method name="get_action_name"
25692- c:identifier="adw_toast_get_action_name"
25693- glib:get-property="action-name">
25694- <attribute name="org.gtk.Method.get_property" value="action-name"/>
39587+ <method name="set_timeout"
39588+ c:identifier="adw_toast_set_timeout"
39589+ glib:set-property="timeout">
2569539590 <doc xml:space="preserve"
2569639591 filename="src/adw-toast.c"
25697- line="614">Gets the name of the associated action.</doc>
25698- <source-position filename="src/adw-toast.h" line="49"/>
25699- <return-value transfer-ownership="none" nullable="1">
25700- <doc xml:space="preserve"
25701- filename="src/adw-toast.c"
25702- line="620">the action name</doc>
25703- <type name="utf8" c:type="const char*"/>
39592+ line="853">Sets timeout for @self.
39593+
39594+If @timeout is 0, the toast is displayed indefinitely until manually
39595+dismissed.
39596+
39597+Toasts cannot disappear while being hovered, pressed (on touchscreen), or
39598+have keyboard focus inside them.</doc>
39599+ <source-position filename="src/adw-toast.h" line="76"/>
39600+ <return-value transfer-ownership="none">
39601+ <type name="none" c:type="void"/>
2570439602 </return-value>
2570539603 <parameters>
2570639604 <instance-parameter name="self" transfer-ownership="none">
2570739605 <doc xml:space="preserve"
2570839606 filename="src/adw-toast.c"
25709- line="616">a toast</doc>
39607+ line="855">a toast</doc>
2571039608 <type name="Toast" c:type="AdwToast*"/>
2571139609 </instance-parameter>
39610+ <parameter name="timeout" transfer-ownership="none">
39611+ <doc xml:space="preserve"
39612+ filename="src/adw-toast.c"
39613+ line="856">the timeout</doc>
39614+ <type name="guint" c:type="guint"/>
39615+ </parameter>
2571239616 </parameters>
2571339617 </method>
25714- <method name="get_action_target_value"
25715- c:identifier="adw_toast_get_action_target_value">
25716- <attribute name="org.gtk.Method.get_property" value="action-target"/>
39618+ <method name="set_title"
39619+ c:identifier="adw_toast_set_title"
39620+ glib:set-property="title">
2571739621 <doc xml:space="preserve"
2571839622 filename="src/adw-toast.c"
25719- line="656">Gets the parameter for action invocations.</doc>
25720- <source-position filename="src/adw-toast.h" line="55"/>
25721- <return-value transfer-ownership="none" nullable="1">
25722- <doc xml:space="preserve"
25723- filename="src/adw-toast.c"
25724- line="662">the action target</doc>
25725- <type name="GLib.Variant" c:type="GVariant*"/>
39623+ line="561">Sets the title that will be displayed on the toast.
39624+
39625+The title can be marked up with the Pango text markup language.
39626+
39627+Setting a title will unset [property@Toast:custom-title].
39628+
39629+If [property@Toast:custom-title] is set, it will be used instead.</doc>
39630+ <source-position filename="src/adw-toast.h" line="39"/>
39631+ <return-value transfer-ownership="none">
39632+ <type name="none" c:type="void"/>
2572639633 </return-value>
2572739634 <parameters>
2572839635 <instance-parameter name="self" transfer-ownership="none">
2572939636 <doc xml:space="preserve"
2573039637 filename="src/adw-toast.c"
25731- line="658">a toast</doc>
39638+ line="563">a toast</doc>
2573239639 <type name="Toast" c:type="AdwToast*"/>
2573339640 </instance-parameter>
39641+ <parameter name="title" transfer-ownership="none">
39642+ <doc xml:space="preserve"
39643+ filename="src/adw-toast.c"
39644+ line="564">a title</doc>
39645+ <type name="utf8" c:type="const char*"/>
39646+ </parameter>
2573439647 </parameters>
2573539648 </method>
25736- <method name="get_button_label"
25737- c:identifier="adw_toast_get_button_label"
25738- glib:get-property="button-label">
25739- <attribute name="org.gtk.Method.get_property" value="button-label"/>
39649+ <method name="set_use_markup"
39650+ c:identifier="adw_toast_set_use_markup"
39651+ glib:set-property="use-markup"
39652+ version="1.4">
2574039653 <doc xml:space="preserve"
2574139654 filename="src/adw-toast.c"
25742- line="570">Gets the label to show on the button.</doc>
25743- <source-position filename="src/adw-toast.h" line="43"/>
25744- <return-value transfer-ownership="none" nullable="1">
25745- <doc xml:space="preserve"
25746- filename="src/adw-toast.c"
25747- line="576">the button label</doc>
25748- <type name="utf8" c:type="const char*"/>
39655+ line="992">Whether to use Pango markup for the toast title.
39656+
39657+See also [func@Pango.parse_markup].</doc>
39658+ <source-position filename="src/adw-toast.h" line="88"/>
39659+ <return-value transfer-ownership="none">
39660+ <type name="none" c:type="void"/>
2574939661 </return-value>
2575039662 <parameters>
2575139663 <instance-parameter name="self" transfer-ownership="none">
2575239664 <doc xml:space="preserve"
2575339665 filename="src/adw-toast.c"
25754- line="572">a toast</doc>
39666+ line="994">a toast</doc>
2575539667 <type name="Toast" c:type="AdwToast*"/>
2575639668 </instance-parameter>
39669+ <parameter name="use_markup" transfer-ownership="none">
39670+ <doc xml:space="preserve"
39671+ filename="src/adw-toast.c"
39672+ line="995">whether to use markup</doc>
39673+ <type name="gboolean" c:type="gboolean"/>
39674+ </parameter>
2575739675 </parameters>
2575839676 </method>
25759- <method name="get_custom_title"
25760- c:identifier="adw_toast_get_custom_title"
25761- glib:get-property="custom-title"
25762- version="1.2">
25763- <attribute name="org.gtk.Method.get_property" value="custom-title"/>
39677+ <property name="action-name"
39678+ writable="1"
39679+ transfer-ownership="none"
39680+ setter="set_action_name"
39681+ getter="get_action_name"
39682+ default-value="NULL">
39683+ <doc xml:space="preserve"
39684+ filename="src/adw-toast.c"
39685+ line="337">The name of the associated action.
39686+
39687+It will be activated when clicking the button.
39688+
39689+See [property@Toast:action-target].</doc>
39690+ <type name="utf8" c:type="gchar*"/>
39691+ </property>
39692+ <property name="action-target"
39693+ writable="1"
39694+ transfer-ownership="none"
39695+ setter="set_action_target_value"
39696+ getter="get_action_target_value">
39697+ <doc xml:space="preserve"
39698+ filename="src/adw-toast.c"
39699+ line="351">The parameter for action invocations.</doc>
39700+ <type name="GLib.Variant"/>
39701+ </property>
39702+ <property name="button-label"
39703+ writable="1"
39704+ transfer-ownership="none"
39705+ setter="set_button_label"
39706+ getter="get_button_label"
39707+ default-value="NULL">
39708+ <doc xml:space="preserve"
39709+ filename="src/adw-toast.c"
39710+ line="321">The label to show on the button.
39711+
39712+Underlines in the button text can be used to indicate a mnemonic.
39713+
39714+If set to `NULL`, the button won't be shown.
39715+
39716+See [property@Toast:action-name].</doc>
39717+ <type name="utf8" c:type="gchar*"/>
39718+ </property>
39719+ <property name="custom-title"
39720+ version="1.2"
39721+ writable="1"
39722+ transfer-ownership="none"
39723+ setter="set_custom_title"
39724+ getter="get_custom_title">
39725+ <doc xml:space="preserve"
39726+ filename="src/adw-toast.c"
39727+ line="397">The custom title widget.
39728+
39729+It will be displayed instead of the title if set. In this case,
39730+[property@Toast:title] is ignored.
39731+
39732+Setting a custom title will unset [property@Toast:title].</doc>
39733+ <type name="Gtk.Widget"/>
39734+ </property>
39735+ <property name="priority"
39736+ writable="1"
39737+ transfer-ownership="none"
39738+ setter="set_priority"
39739+ getter="get_priority"
39740+ default-value="ADW_TOAST_PRIORITY_NORMAL">
39741+ <doc xml:space="preserve"
39742+ filename="src/adw-toast.c"
39743+ line="362">The priority of the toast.
39744+
39745+Priority controls how the toast behaves when another toast is already
39746+being displayed.
39747+
39748+If the priority is `ADW_TOAST_PRIORITY_NORMAL`, the toast will be queued.
39749+
39750+If the priority is `ADW_TOAST_PRIORITY_HIGH`, the toast will be displayed
39751+immediately, pushing the previous toast into the queue instead.</doc>
39752+ <type name="ToastPriority"/>
39753+ </property>
39754+ <property name="timeout"
39755+ writable="1"
39756+ transfer-ownership="none"
39757+ setter="set_timeout"
39758+ getter="get_timeout"
39759+ default-value="5">
39760+ <doc xml:space="preserve"
39761+ filename="src/adw-toast.c"
39762+ line="381">The timeout of the toast, in seconds.
39763+
39764+If timeout is 0, the toast is displayed indefinitely until manually
39765+dismissed.
39766+
39767+Toasts cannot disappear while being hovered, pressed (on touchscreen), or
39768+have keyboard focus inside them.</doc>
39769+ <type name="guint" c:type="guint"/>
39770+ </property>
39771+ <property name="title"
39772+ writable="1"
39773+ transfer-ownership="none"
39774+ setter="set_title"
39775+ getter="get_title">
39776+ <doc xml:space="preserve"
39777+ filename="src/adw-toast.c"
39778+ line="305">The title of the toast.
39779+
39780+The title can be marked up with the Pango text markup language.
39781+
39782+Setting a title will unset [property@Toast:custom-title].
39783+
39784+If [property@Toast:custom-title] is set, it will be used instead.</doc>
39785+ <type name="utf8" c:type="gchar*"/>
39786+ </property>
39787+ <property name="use-markup"
39788+ version="1.4"
39789+ writable="1"
39790+ transfer-ownership="none"
39791+ setter="set_use_markup"
39792+ getter="get_use_markup"
39793+ default-value="TRUE">
39794+ <doc xml:space="preserve"
39795+ filename="src/adw-toast.c"
39796+ line="414">Whether to use Pango markup for the toast title.
39797+
39798+See also [func@Pango.parse_markup].</doc>
39799+ <type name="gboolean" c:type="gboolean"/>
39800+ </property>
39801+ <glib:signal name="button-clicked" when="last" version="1.2">
39802+ <doc xml:space="preserve"
39803+ filename="src/adw-toast.c"
39804+ line="447">Emitted after the button has been clicked.
39805+
39806+It can be used as an alternative to setting an action.</doc>
39807+ <return-value transfer-ownership="none">
39808+ <type name="none" c:type="void"/>
39809+ </return-value>
39810+ </glib:signal>
39811+ <glib:signal name="dismissed" when="first">
39812+ <doc xml:space="preserve"
39813+ filename="src/adw-toast.c"
39814+ line="430">Emitted when the toast has been dismissed.</doc>
39815+ <return-value transfer-ownership="none">
39816+ <type name="none" c:type="void"/>
39817+ </return-value>
39818+ </glib:signal>
39819+ </class>
39820+ <record name="ToastClass"
39821+ c:type="AdwToastClass"
39822+ glib:is-gtype-struct-for="Toast">
39823+ <source-position filename="src/adw-toast.h" line="28"/>
39824+ <field name="parent_class">
39825+ <type name="GObject.ObjectClass" c:type="GObjectClass"/>
39826+ </field>
39827+ </record>
39828+ <class name="ToastOverlay"
39829+ c:symbol-prefix="toast_overlay"
39830+ c:type="AdwToastOverlay"
39831+ parent="Gtk.Widget"
39832+ final="1"
39833+ glib:type-name="AdwToastOverlay"
39834+ glib:get-type="adw_toast_overlay_get_type"
39835+ glib:type-struct="ToastOverlayClass">
39836+ <doc xml:space="preserve"
39837+ filename="src/adw-toast-overlay.c"
39838+ line="25">A widget showing toasts above its content.
39839+
39840+&lt;picture&gt;
39841+ &lt;source srcset="toast-overlay-dark.png" media="(prefers-color-scheme: dark)"&gt;
39842+ &lt;img src="toast-overlay.png" alt="toast-overlay"&gt;
39843+&lt;/picture&gt;
39844+
39845+Much like [class@Gtk.Overlay], `AdwToastOverlay` is a container with a single
39846+main child, on top of which it can display a [class@Toast], overlaid.
39847+Toasts can be shown with [method@ToastOverlay.add_toast].
39848+
39849+See [class@Toast] for details.
39850+
39851+## CSS nodes
39852+
39853+```
39854+toastoverlay
39855+├── [child]
39856+├── toast
39857+┊ ├── widget
39858+┊ │ ├── [label.heading]
39859+ │ ╰── [custom title]
39860+ ├── [button]
39861+ ╰── button.circular.flat
39862+```
39863+
39864+`AdwToastOverlay`'s CSS node is called `toastoverlay`. It contains the child,
39865+as well as zero or more `toast` subnodes.
39866+
39867+Each of the `toast` nodes contains a `widget` subnode, optionally a `button`
39868+subnode, and another `button` subnode with `.circular` and `.flat` style
39869+classes.
39870+
39871+The `widget` subnode contains a `label` subnode with the `.heading` style
39872+class, or a custom widget provided by the application.
39873+
39874+## Accessibility
39875+
39876+`AdwToastOverlay` uses the `GTK_ACCESSIBLE_ROLE_TAB_GROUP` role.</doc>
39877+ <source-position filename="src/adw-toast-overlay.h" line="23"/>
39878+ <implements name="Gtk.Accessible"/>
39879+ <implements name="Gtk.Buildable"/>
39880+ <implements name="Gtk.ConstraintTarget"/>
39881+ <constructor name="new" c:identifier="adw_toast_overlay_new">
2576439882 <doc xml:space="preserve"
25765- filename="src/adw-toast.c"
25766- line="861">Gets the custom title widget of @self.</doc>
25767- <source-position filename="src/adw-toast.h" line="80"/>
25768- <return-value transfer-ownership="none" nullable="1">
39883+ filename="src/adw-toast-overlay.c"
39884+ line="574">Creates a new `AdwToastOverlay`.</doc>
39885+ <source-position filename="src/adw-toast-overlay.h" line="26"/>
39886+ <return-value transfer-ownership="none">
2576939887 <doc xml:space="preserve"
25770- filename="src/adw-toast.c"
25771- line="867">the custom title widget</doc>
39888+ filename="src/adw-toast-overlay.c"
39889+ line="579">the new created `AdwToastOverlay`</doc>
2577239890 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2577339891 </return-value>
25774- <parameters>
25775- <instance-parameter name="self" transfer-ownership="none">
25776- <doc xml:space="preserve"
25777- filename="src/adw-toast.c"
25778- line="863">a toast</doc>
25779- <type name="Toast" c:type="AdwToast*"/>
25780- </instance-parameter>
25781- </parameters>
25782- </method>
25783- <method name="get_priority"
25784- c:identifier="adw_toast_get_priority"
25785- glib:get-property="priority">
25786- <attribute name="org.gtk.Method.get_property" value="priority"/>
39892+ </constructor>
39893+ <method name="add_toast" c:identifier="adw_toast_overlay_add_toast">
2578739894 <doc xml:space="preserve"
25788- filename="src/adw-toast.c"
25789- line="771">Gets priority for @self.</doc>
25790- <source-position filename="src/adw-toast.h" line="68"/>
39895+ filename="src/adw-toast-overlay.c"
39896+ line="634">Displays @toast.
39897+
39898+Only one toast can be shown at a time; if a toast is already being displayed,
39899+either @toast or the original toast will be placed in a queue, depending on
39900+the priority of @toast. See [property@Toast:priority].
39901+
39902+If called on a toast that's already displayed, its timeout will be reset.
39903+
39904+If called on a toast currently in the queue, the toast will be bumped
39905+forward to be shown as soon as possible.</doc>
39906+ <source-position filename="src/adw-toast-overlay.h" line="35"/>
2579139907 <return-value transfer-ownership="none">
25792- <doc xml:space="preserve"
25793- filename="src/adw-toast.c"
25794- line="777">the priority</doc>
25795- <type name="ToastPriority" c:type="AdwToastPriority"/>
39908+ <type name="none" c:type="void"/>
2579639909 </return-value>
2579739910 <parameters>
2579839911 <instance-parameter name="self" transfer-ownership="none">
2579939912 <doc xml:space="preserve"
25800- filename="src/adw-toast.c"
25801- line="773">a toast</doc>
25802- <type name="Toast" c:type="AdwToast*"/>
39913+ filename="src/adw-toast-overlay.c"
39914+ line="636">a toast overlay</doc>
39915+ <type name="ToastOverlay" c:type="AdwToastOverlay*"/>
2580339916 </instance-parameter>
25804- </parameters>
25805- </method>
25806- <method name="get_timeout"
25807- c:identifier="adw_toast_get_timeout"
25808- glib:get-property="timeout">
25809- <attribute name="org.gtk.Method.get_property" value="timeout"/>
25810- <doc xml:space="preserve"
25811- filename="src/adw-toast.c"
25812- line="818">Gets timeout for @self.</doc>
25813- <source-position filename="src/adw-toast.h" line="74"/>
25814- <return-value transfer-ownership="none">
25815- <doc xml:space="preserve"
25816- filename="src/adw-toast.c"
25817- line="824">the timeout</doc>
25818- <type name="guint" c:type="guint"/>
25819- </return-value>
25820- <parameters>
25821- <instance-parameter name="self" transfer-ownership="none">
39917+ <parameter name="toast" transfer-ownership="full">
2582239918 <doc xml:space="preserve"
25823- filename="src/adw-toast.c"
25824- line="820">a toast</doc>
39919+ filename="src/adw-toast-overlay.c"
39920+ line="637">a toast</doc>
2582539921 <type name="Toast" c:type="AdwToast*"/>
25826- </instance-parameter>
39922+ </parameter>
2582739923 </parameters>
2582839924 </method>
25829- <method name="get_title"
25830- c:identifier="adw_toast_get_title"
25831- glib:get-property="title">
25832- <attribute name="org.gtk.Method.get_property" value="title"/>
39925+ <method name="get_child"
39926+ c:identifier="adw_toast_overlay_get_child"
39927+ glib:get-property="child">
2583339928 <doc xml:space="preserve"
25834- filename="src/adw-toast.c"
25835- line="513">Gets the title that will be displayed on the toast.
25836-
25837-If a custom title has been set with [method@Adw.Toast.set_custom_title]
25838-the return value will be %NULL.</doc>
25839- <source-position filename="src/adw-toast.h" line="37"/>
39929+ filename="src/adw-toast-overlay.c"
39930+ line="587">Gets the child widget of @self.</doc>
39931+ <source-position filename="src/adw-toast-overlay.h" line="29"/>
2584039932 <return-value transfer-ownership="none" nullable="1">
2584139933 <doc xml:space="preserve"
25842- filename="src/adw-toast.c"
25843- line="522">the title</doc>
25844- <type name="utf8" c:type="const char*"/>
39934+ filename="src/adw-toast-overlay.c"
39935+ line="593">the child widget of @self</doc>
39936+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
2584539937 </return-value>
2584639938 <parameters>
2584739939 <instance-parameter name="self" transfer-ownership="none">
2584839940 <doc xml:space="preserve"
25849- filename="src/adw-toast.c"
25850- line="515">a toast</doc>
25851- <type name="Toast" c:type="AdwToast*"/>
39941+ filename="src/adw-toast-overlay.c"
39942+ line="589">a toast overlay</doc>
39943+ <type name="ToastOverlay" c:type="AdwToastOverlay*"/>
2585239944 </instance-parameter>
2585339945 </parameters>
2585439946 </method>
25855- <method name="set_action_name"
25856- c:identifier="adw_toast_set_action_name"
25857- glib:set-property="action-name">
25858- <attribute name="org.gtk.Method.set_property" value="action-name"/>
39947+ <method name="set_child"
39948+ c:identifier="adw_toast_overlay_set_child"
39949+ glib:set-property="child">
2585939950 <doc xml:space="preserve"
25860- filename="src/adw-toast.c"
25861- line="630">Sets the name of the associated action.
25862-
25863-It will be activated when clicking the button.
25864-
25865-See [property@Toast:action-target].</doc>
25866- <source-position filename="src/adw-toast.h" line="51"/>
39951+ filename="src/adw-toast-overlay.c"
39952+ line="603">Sets the child widget of @self.</doc>
39953+ <source-position filename="src/adw-toast-overlay.h" line="31"/>
2586739954 <return-value transfer-ownership="none">
2586839955 <type name="none" c:type="void"/>
2586939956 </return-value>
2587039957 <parameters>
2587139958 <instance-parameter name="self" transfer-ownership="none">
2587239959 <doc xml:space="preserve"
25873- filename="src/adw-toast.c"
25874- line="632">a toast</doc>
25875- <type name="Toast" c:type="AdwToast*"/>
39960+ filename="src/adw-toast-overlay.c"
39961+ line="605">a toast overlay</doc>
39962+ <type name="ToastOverlay" c:type="AdwToastOverlay*"/>
2587639963 </instance-parameter>
25877- <parameter name="action_name"
39964+ <parameter name="child"
2587839965 transfer-ownership="none"
2587939966 nullable="1"
2588039967 allow-none="1">
2588139968 <doc xml:space="preserve"
25882- filename="src/adw-toast.c"
25883- line="633">the action name</doc>
25884- <type name="utf8" c:type="const char*"/>
39969+ filename="src/adw-toast-overlay.c"
39970+ line="606">the child widget</doc>
39971+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
2588539972 </parameter>
2588639973 </parameters>
2588739974 </method>
25888- <method name="set_action_target"
25889- c:identifier="adw_toast_set_action_target"
25890- glib:set-property="action-target"
25891- introspectable="0">
39975+ <property name="child"
39976+ writable="1"
39977+ transfer-ownership="none"
39978+ setter="set_child"
39979+ getter="get_child">
39980+ <doc xml:space="preserve"
39981+ filename="src/adw-toast-overlay.c"
39982+ line="524">The child widget.</doc>
39983+ <type name="Gtk.Widget"/>
39984+ </property>
39985+ </class>
39986+ <record name="ToastOverlayClass"
39987+ c:type="AdwToastOverlayClass"
39988+ glib:is-gtype-struct-for="ToastOverlay">
39989+ <source-position filename="src/adw-toast-overlay.h" line="23"/>
39990+ <field name="parent_class">
39991+ <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
39992+ </field>
39993+ </record>
39994+ <enumeration name="ToastPriority"
39995+ glib:type-name="AdwToastPriority"
39996+ glib:get-type="adw_toast_priority_get_type"
39997+ c:type="AdwToastPriority">
39998+ <doc xml:space="preserve"
39999+ filename="src/adw-toast.c"
40000+ line="14">[class@Toast] behavior when another toast is already displayed.</doc>
40001+ <member name="normal"
40002+ value="0"
40003+ c:identifier="ADW_TOAST_PRIORITY_NORMAL"
40004+ glib:nick="normal"
40005+ glib:name="ADW_TOAST_PRIORITY_NORMAL">
40006+ <doc xml:space="preserve"
40007+ filename="src/adw-toast.c"
40008+ line="16">the toast will be queued if another toast is
40009+ already displayed.</doc>
40010+ </member>
40011+ <member name="high"
40012+ value="1"
40013+ c:identifier="ADW_TOAST_PRIORITY_HIGH"
40014+ glib:nick="high"
40015+ glib:name="ADW_TOAST_PRIORITY_HIGH">
2589240016 <doc xml:space="preserve"
2589340017 filename="src/adw-toast.c"
25894- line="702">Sets the parameter for action invocations.
40018+ line="18">the toast will be displayed immediately, pushing
40019+ the previous toast into the queue instead.</doc>
40020+ </member>
40021+ </enumeration>
40022+ <enumeration name="ToolbarStyle"
40023+ version="1.4"
40024+ glib:type-name="AdwToolbarStyle"
40025+ glib:get-type="adw_toolbar_style_get_type"
40026+ c:type="AdwToolbarStyle">
40027+ <doc xml:space="preserve"
40028+ filename="src/adw-toolbar-view.c"
40029+ line="119">Describes the possible top or bottom bar styles in an [class@ToolbarView]
40030+widget.
40031+
40032+`ADW_TOOLBAR_FLAT` is suitable for simple content, such as
40033+[class@StatusPage] or [class@PreferencesPage], where the background at the
40034+top and bottom parts of the page is uniform. Additionally, windows with
40035+sidebars should always use this style.
40036+
40037+&lt;picture style="min-width: 33%; display: inline-block;"&gt;
40038+ &lt;source srcset="toolbar-view-flat-1-dark.png" media="(prefers-color-scheme: dark)"&gt;
40039+ &lt;img src="toolbar-view-flat-1.png" alt="toolbar-view-flat-1"&gt;
40040+&lt;/picture&gt;
40041+&lt;picture style="min-width: 33%; display: inline-block;"&gt;
40042+ &lt;source srcset="toolbar-view-flat-2-dark.png" media="(prefers-color-scheme: dark)"&gt;
40043+ &lt;img src="toolbar-view-flat-2.png" alt="toolbar-view-flat-2"&gt;
40044+&lt;/picture&gt;
2589540045
25896-This is a convenience function that calls [ctor@GLib.Variant.new] for
25897-@format_string and uses the result to call
25898-[method@Toast.set_action_target_value].
40046+`ADW_TOOLBAR_RAISED` style is suitable for content such as
40047+[utility panes](https://developer.gnome.org/hig/patterns/containers/utility-panes.html),
40048+where some elements are directly adjacent to the top/bottom bars, or
40049+[class@TabView], where each page can have a different background.
2589940050
25900-If you are setting a string-valued target and want to set
25901-the action name at the same time, you can use
25902-[method@Toast.set_detailed_action_name].</doc>
25903- <source-position filename="src/adw-toast.h" line="60"/>
40051+`ADW_TOOLBAR_RAISED_BORDER` style is similar to `ADW_TOOLBAR_RAISED`, but
40052+with the shadow replaced with a more subtle border. It's intended to be used
40053+in applications like image viewers, where a shadow over the content might be
40054+undesired.
40055+
40056+&lt;picture style="min-width: 33%; display: inline-block;"&gt;
40057+ &lt;source srcset="toolbar-view-raised-dark.png" media="(prefers-color-scheme: dark)"&gt;
40058+ &lt;img src="toolbar-view-raised.png" alt="toolbar-view-raised"&gt;
40059+&lt;/picture&gt;
40060+&lt;picture style="min-width: 33%; display: inline-block;"&gt;
40061+ &lt;source srcset="toolbar-view-raised-border-dark.png" media="(prefers-color-scheme: dark)"&gt;
40062+ &lt;img src="toolbar-view-raised-border.png" alt="toolbar-view-raised-border"&gt;
40063+&lt;/picture&gt;
40064+
40065+See [property@ToolbarView:top-bar-style] and
40066+[property@ToolbarView:bottom-bar-style].
40067+
40068+New values may be added to this enumeration over time.</doc>
40069+ <member name="flat"
40070+ value="0"
40071+ c:identifier="ADW_TOOLBAR_FLAT"
40072+ glib:nick="flat"
40073+ glib:name="ADW_TOOLBAR_FLAT">
40074+ <doc xml:space="preserve"
40075+ filename="src/adw-toolbar-view.c"
40076+ line="121">No background, shadow only for scrolled content</doc>
40077+ </member>
40078+ <member name="raised"
40079+ value="1"
40080+ c:identifier="ADW_TOOLBAR_RAISED"
40081+ glib:nick="raised"
40082+ glib:name="ADW_TOOLBAR_RAISED">
40083+ <doc xml:space="preserve"
40084+ filename="src/adw-toolbar-view.c"
40085+ line="122">Opaque background with a persistent shadow</doc>
40086+ </member>
40087+ <member name="raised_border"
40088+ value="2"
40089+ c:identifier="ADW_TOOLBAR_RAISED_BORDER"
40090+ glib:nick="raised-border"
40091+ glib:name="ADW_TOOLBAR_RAISED_BORDER">
40092+ <doc xml:space="preserve"
40093+ filename="src/adw-toolbar-view.c"
40094+ line="123">Opaque background with a persistent border</doc>
40095+ </member>
40096+ </enumeration>
40097+ <class name="ToolbarView"
40098+ c:symbol-prefix="toolbar_view"
40099+ c:type="AdwToolbarView"
40100+ version="1.4"
40101+ parent="Gtk.Widget"
40102+ final="1"
40103+ glib:type-name="AdwToolbarView"
40104+ glib:get-type="adw_toolbar_view_get_type"
40105+ glib:type-struct="ToolbarViewClass">
40106+ <doc xml:space="preserve"
40107+ filename="src/adw-toolbar-view.c"
40108+ line="14">A widget containing a page, as well as top and/or bottom bars.
40109+
40110+&lt;picture&gt;
40111+ &lt;source srcset="toolbar-view-dark.png" media="(prefers-color-scheme: dark)"&gt;
40112+ &lt;img src="toolbar-view.png" alt="toolbar-view"&gt;
40113+&lt;/picture&gt;
40114+
40115+`AdwToolbarView` has a single content widget and one or multiple top and
40116+bottom bars, shown at the top and bottom sides respectively.
40117+
40118+Example of an `AdwToolbarView` UI definition:
40119+```xml
40120+&lt;object class="AdwToolbarView"&gt;
40121+ &lt;child type="top"&gt;
40122+ &lt;object class="AdwHeaderBar"/&gt;
40123+ &lt;/child&gt;
40124+ &lt;property name="content"&gt;
40125+ &lt;object class="AdwPreferencesPage"&gt;
40126+ &lt;!-- ... --&gt;
40127+ &lt;/object&gt;
40128+ &lt;/property&gt;
40129+&lt;/object&gt;
40130+```
40131+
40132+The following kinds of top and bottom bars are supported:
40133+
40134+- [class@HeaderBar]
40135+- [class@TabBar]
40136+- [class@ViewSwitcherBar]
40137+- [class@Gtk.ActionBar]
40138+- [class@Gtk.HeaderBar]
40139+- [class@Gtk.PopoverMenuBar]
40140+- [class@Gtk.SearchBar]
40141+- Any [class@Gtk.Box] or a similar widget with the
40142+ [`.toolbar`](style-classes.html#toolbars) style class
40143+
40144+By default, top and bottom bars are flat and scrolling content has a subtle
40145+undershoot shadow, same as when using the
40146+[`.undershoot-top`](style-classes.html#undershoot-indicators) and
40147+[`.undershoot-bottom`](style-classes.html#undershoot-indicators) style
40148+classes. This works well in most cases, e.g. with [class@StatusPage] or
40149+[class@PreferencesPage], where the background at the top and bottom parts of
40150+the page is uniform. Additionally, windows with sidebars should always use
40151+this style.
40152+
40153+[property@ToolbarView:top-bar-style] and
40154+[property@ToolbarView:bottom-bar-style] properties can be used add an opaque
40155+background and a persistent shadow to top and bottom bars, this can be useful
40156+for content such as [utility panes](https://developer.gnome.org/hig/patterns/containers/utility-panes.html),
40157+where some elements are adjacent to the top/bottom bars, or [class@TabView],
40158+where each page can have a different background.
40159+
40160+&lt;picture style="min-width: 33%; display: inline-block;"&gt;
40161+ &lt;source srcset="toolbar-view-flat-1-dark.png" media="(prefers-color-scheme: dark)"&gt;
40162+ &lt;img src="toolbar-view-flat-1.png" alt="toolbar-view-flat-1"&gt;
40163+&lt;/picture&gt;
40164+&lt;picture style="min-width: 33%; display: inline-block;"&gt;
40165+ &lt;source srcset="toolbar-view-flat-2-dark.png" media="(prefers-color-scheme: dark)"&gt;
40166+ &lt;img src="toolbar-view-flat-2.png" alt="toolbar-view-flat-2"&gt;
40167+&lt;/picture&gt;
40168+&lt;picture style="min-width: 33%; display: inline-block;"&gt;
40169+ &lt;source srcset="toolbar-view-raised-dark.png" media="(prefers-color-scheme: dark)"&gt;
40170+ &lt;img src="toolbar-view-raised.png" alt="toolbar-view-raised"&gt;
40171+&lt;/picture&gt;
40172+
40173+`AdwToolbarView` ensures the top and bottom bars have consistent backdrop
40174+styles and vertical spacing. For comparison:
40175+
40176+&lt;picture style="min-width: 40%; display: inline-block;"&gt;
40177+ &lt;source srcset="toolbar-view-spacing-dark.png" media="(prefers-color-scheme: dark)"&gt;
40178+ &lt;img src="toolbar-view-spacing.png" alt="toolbar-view-spacing"&gt;
40179+&lt;/picture&gt;
40180+&lt;picture style="min-width: 40%; display: inline-block;"&gt;
40181+ &lt;source srcset="toolbar-view-spacing-box-dark.png" media="(prefers-color-scheme: dark)"&gt;
40182+ &lt;img src="toolbar-view-spacing-box.png" alt="toolbar-view-spacing-box"&gt;
40183+&lt;/picture&gt;
40184+
40185+Any top and bottom bars can also be dragged to move the window, equivalent
40186+to putting them into a [class@Gtk.WindowHandle].
40187+
40188+Content is typically place between top and bottom bars, but can also extend
40189+behind them. This is controlled with the
40190+[property@ToolbarView:extend-content-to-top-edge] and
40191+[property@ToolbarView:extend-content-to-bottom-edge] properties.
40192+
40193+Top and bottom bars can be hidden and revealed with an animation using the
40194+[property@ToolbarView:reveal-top-bars] and
40195+[property@ToolbarView:reveal-bottom-bars] properties.
40196+
40197+## `AdwToolbarView` as `GtkBuildable`
40198+
40199+The `AdwToolbarView` implementation of the [iface@Gtk.Buildable] interface
40200+supports adding a top bar by specifying “top” as the “type” attribute of a
40201+`&lt;child&gt;` element, or adding a bottom bar by specifying “bottom”.
40202+
40203+## Accessibility
40204+
40205+`AdwToolbarView` uses the `GTK_ACCESSIBLE_ROLE_GROUP` role.</doc>
40206+ <source-position filename="src/adw-toolbar-view.h" line="31"/>
40207+ <implements name="Gtk.Accessible"/>
40208+ <implements name="Gtk.Buildable"/>
40209+ <implements name="Gtk.ConstraintTarget"/>
40210+ <constructor name="new"
40211+ c:identifier="adw_toolbar_view_new"
40212+ version="1.4">
40213+ <doc xml:space="preserve"
40214+ filename="src/adw-toolbar-view.c"
40215+ line="759">Creates a new `AdwToolbarView`.</doc>
40216+ <source-position filename="src/adw-toolbar-view.h" line="34"/>
2590440217 <return-value transfer-ownership="none">
25905- <type name="none" c:type="void"/>
25906- </return-value>
25907- <parameters>
25908- <instance-parameter name="self" transfer-ownership="none">
25909- <doc xml:space="preserve"
25910- filename="src/adw-toast.c"
25911- line="704">a toast</doc>
25912- <type name="Toast" c:type="AdwToast*"/>
25913- </instance-parameter>
25914- <parameter name="format_string"
25915- transfer-ownership="none"
25916- nullable="1"
25917- allow-none="1">
25918- <doc xml:space="preserve"
25919- filename="src/adw-toast.c"
25920- line="705">a variant format string</doc>
25921- <type name="utf8" c:type="const char*"/>
25922- </parameter>
25923- <parameter name="..." transfer-ownership="none">
25924- <doc xml:space="preserve"
25925- filename="src/adw-toast.c"
25926- line="706">arguments appropriate for @target_format</doc>
25927- <varargs/>
25928- </parameter>
25929- </parameters>
25930- </method>
25931- <method name="set_action_target_value"
25932- c:identifier="adw_toast_set_action_target_value">
25933- <attribute name="org.gtk.Method.set_property" value="action-target"/>
40218+ <doc xml:space="preserve"
40219+ filename="src/adw-toolbar-view.c"
40220+ line="764">the newly created `AdwToolbarView`</doc>
40221+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
40222+ </return-value>
40223+ </constructor>
40224+ <method name="add_bottom_bar"
40225+ c:identifier="adw_toolbar_view_add_bottom_bar"
40226+ version="1.4">
2593440227 <doc xml:space="preserve"
25935- filename="src/adw-toast.c"
25936- line="672">Sets the parameter for action invocations.
25937-
25938-If the @action_target variant has a floating reference this function
25939-will sink it.</doc>
25940- <source-position filename="src/adw-toast.h" line="57"/>
40228+ filename="src/adw-toolbar-view.c"
40229+ line="850">Adds a bottom bar to @self.</doc>
40230+ <source-position filename="src/adw-toolbar-view.h" line="47"/>
2594140231 <return-value transfer-ownership="none">
2594240232 <type name="none" c:type="void"/>
2594340233 </return-value>
2594440234 <parameters>
2594540235 <instance-parameter name="self" transfer-ownership="none">
2594640236 <doc xml:space="preserve"
25947- filename="src/adw-toast.c"
25948- line="674">a toast</doc>
25949- <type name="Toast" c:type="AdwToast*"/>
40237+ filename="src/adw-toolbar-view.c"
40238+ line="852">a toolbar view</doc>
40239+ <type name="ToolbarView" c:type="AdwToolbarView*"/>
2595040240 </instance-parameter>
25951- <parameter name="action_target"
25952- transfer-ownership="none"
25953- nullable="1"
25954- allow-none="1">
40241+ <parameter name="widget" transfer-ownership="none">
2595540242 <doc xml:space="preserve"
25956- filename="src/adw-toast.c"
25957- line="675">the action target</doc>
25958- <type name="GLib.Variant" c:type="GVariant*"/>
40243+ filename="src/adw-toolbar-view.c"
40244+ line="853">a widget</doc>
40245+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
2595940246 </parameter>
2596040247 </parameters>
2596140248 </method>
25962- <method name="set_button_label"
25963- c:identifier="adw_toast_set_button_label"
25964- glib:set-property="button-label">
25965- <attribute name="org.gtk.Method.set_property" value="button-label"/>
40249+ <method name="add_top_bar"
40250+ c:identifier="adw_toolbar_view_add_top_bar"
40251+ version="1.4">
2596640252 <doc xml:space="preserve"
25967- filename="src/adw-toast.c"
25968- line="586">Sets the label to show on the button.
25969-
25970-Underlines in the button text can be used to indicate a mnemonic.
25971-
25972-If set to `NULL`, the button won't be shown.
25973-
25974-See [property@Toast:action-name].</doc>
25975- <source-position filename="src/adw-toast.h" line="45"/>
40253+ filename="src/adw-toolbar-view.c"
40254+ line="825">Adds a top bar to @self.</doc>
40255+ <source-position filename="src/adw-toolbar-view.h" line="43"/>
2597640256 <return-value transfer-ownership="none">
2597740257 <type name="none" c:type="void"/>
2597840258 </return-value>
2597940259 <parameters>
2598040260 <instance-parameter name="self" transfer-ownership="none">
2598140261 <doc xml:space="preserve"
25982- filename="src/adw-toast.c"
25983- line="588">a toast</doc>
25984- <type name="Toast" c:type="AdwToast*"/>
40262+ filename="src/adw-toolbar-view.c"
40263+ line="827">a toolbar view</doc>
40264+ <type name="ToolbarView" c:type="AdwToolbarView*"/>
2598540265 </instance-parameter>
25986- <parameter name="button_label"
25987- transfer-ownership="none"
25988- nullable="1"
25989- allow-none="1">
40266+ <parameter name="widget" transfer-ownership="none">
2599040267 <doc xml:space="preserve"
25991- filename="src/adw-toast.c"
25992- line="589">a button label</doc>
25993- <type name="utf8" c:type="const char*"/>
40268+ filename="src/adw-toolbar-view.c"
40269+ line="828">a widget</doc>
40270+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
2599440271 </parameter>
2599540272 </parameters>
2599640273 </method>
25997- <method name="set_custom_title"
25998- c:identifier="adw_toast_set_custom_title"
25999- glib:set-property="custom-title"
26000- version="1.2">
26001- <attribute name="org.gtk.Method.set_property" value="custom-title"/>
40274+ <method name="get_bottom_bar_height"
40275+ c:identifier="adw_toolbar_view_get_bottom_bar_height"
40276+ glib:get-property="bottom-bar-height"
40277+ version="1.4">
2600240278 <doc xml:space="preserve"
26003- filename="src/adw-toast.c"
26004- line="879">Sets the custom title widget of @self.
40279+ filename="src/adw-toolbar-view.c"
40280+ line="1316">Gets the current bottom bar height for @self.
2600540281
26006-It will be displayed instead of the title if set. In this case,
26007-[property@Toast:title] is ignored.
40282+Bottom bar height does change depending on
40283+[property@ToolbarView:reveal-bottom-bars], including during the transition.
2600840284
26009-Setting a custom title will unset [property@Toast:title].</doc>
26010- <source-position filename="src/adw-toast.h" line="82"/>
40285+See [method@ToolbarView.get_top_bar_height].</doc>
40286+ <source-position filename="src/adw-toolbar-view.h" line="93"/>
2601140287 <return-value transfer-ownership="none">
26012- <type name="none" c:type="void"/>
40288+ <doc xml:space="preserve"
40289+ filename="src/adw-toolbar-view.c"
40290+ line="1327">the current bottom bar height</doc>
40291+ <type name="gint" c:type="int"/>
2601340292 </return-value>
2601440293 <parameters>
2601540294 <instance-parameter name="self" transfer-ownership="none">
2601640295 <doc xml:space="preserve"
26017- filename="src/adw-toast.c"
26018- line="881">a toast</doc>
26019- <type name="Toast" c:type="AdwToast*"/>
40296+ filename="src/adw-toolbar-view.c"
40297+ line="1318">a toolbar view</doc>
40298+ <type name="ToolbarView" c:type="AdwToolbarView*"/>
2602040299 </instance-parameter>
26021- <parameter name="widget"
26022- transfer-ownership="none"
26023- nullable="1"
26024- allow-none="1">
26025- <doc xml:space="preserve"
26026- filename="src/adw-toast.c"
26027- line="882">the custom title widget</doc>
26028- <type name="Gtk.Widget" c:type="GtkWidget*"/>
26029- </parameter>
2603040300 </parameters>
2603140301 </method>
26032- <method name="set_detailed_action_name"
26033- c:identifier="adw_toast_set_detailed_action_name">
40302+ <method name="get_bottom_bar_style"
40303+ c:identifier="adw_toolbar_view_get_bottom_bar_style"
40304+ glib:get-property="bottom-bar-style"
40305+ version="1.4">
2603440306 <doc xml:space="preserve"
26035- filename="src/adw-toast.c"
26036- line="732">Sets the action name and its parameter.
26037-
26038-@detailed_action_name is a string in the format accepted by
26039-[func@Gio.Action.parse_detailed_name].</doc>
26040- <source-position filename="src/adw-toast.h" line="64"/>
40307+ filename="src/adw-toolbar-view.c"
40308+ line="1001">Gets appearance of the bottom bars for @self.</doc>
40309+ <source-position filename="src/adw-toolbar-view.h" line="61"/>
2604140310 <return-value transfer-ownership="none">
26042- <type name="none" c:type="void"/>
40311+ <doc xml:space="preserve"
40312+ filename="src/adw-toolbar-view.c"
40313+ line="1007">bottom bar style</doc>
40314+ <type name="ToolbarStyle" c:type="AdwToolbarStyle"/>
2604340315 </return-value>
2604440316 <parameters>
2604540317 <instance-parameter name="self" transfer-ownership="none">
2604640318 <doc xml:space="preserve"
26047- filename="src/adw-toast.c"
26048- line="734">a toast</doc>
26049- <type name="Toast" c:type="AdwToast*"/>
40319+ filename="src/adw-toolbar-view.c"
40320+ line="1003">a toolbar view</doc>
40321+ <type name="ToolbarView" c:type="AdwToolbarView*"/>
2605040322 </instance-parameter>
26051- <parameter name="detailed_action_name"
26052- transfer-ownership="none"
26053- nullable="1"
26054- allow-none="1">
40323+ </parameters>
40324+ </method>
40325+ <method name="get_content"
40326+ c:identifier="adw_toolbar_view_get_content"
40327+ glib:get-property="content"
40328+ version="1.4">
40329+ <doc xml:space="preserve"
40330+ filename="src/adw-toolbar-view.c"
40331+ line="774">Gets the content widget for @self.</doc>
40332+ <source-position filename="src/adw-toolbar-view.h" line="37"/>
40333+ <return-value transfer-ownership="none" nullable="1">
40334+ <doc xml:space="preserve"
40335+ filename="src/adw-toolbar-view.c"
40336+ line="780">the content widget</doc>
40337+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
40338+ </return-value>
40339+ <parameters>
40340+ <instance-parameter name="self" transfer-ownership="none">
2605540341 <doc xml:space="preserve"
26056- filename="src/adw-toast.c"
26057- line="735">the detailed action name</doc>
26058- <type name="utf8" c:type="const char*"/>
26059- </parameter>
40342+ filename="src/adw-toolbar-view.c"
40343+ line="776">a toolbar view</doc>
40344+ <type name="ToolbarView" c:type="AdwToolbarView*"/>
40345+ </instance-parameter>
2606040346 </parameters>
2606140347 </method>
26062- <method name="set_priority"
26063- c:identifier="adw_toast_set_priority"
26064- glib:set-property="priority">
26065- <attribute name="org.gtk.Method.set_property" value="priority"/>
40348+ <method name="get_extend_content_to_bottom_edge"
40349+ c:identifier="adw_toolbar_view_get_extend_content_to_bottom_edge"
40350+ glib:get-property="extend-content-to-bottom-edge"
40351+ version="1.4">
2606640352 <doc xml:space="preserve"
26067- filename="src/adw-toast.c"
26068- line="787">Sets priority for @self.
26069-
26070-Priority controls how the toast behaves when another toast is already
26071-being displayed.
26072-
26073-If @priority is `ADW_TOAST_PRIORITY_NORMAL`, the toast will be queued.
26074-
26075-If @priority is `ADW_TOAST_PRIORITY_HIGH`, the toast will be displayed
26076-immediately, pushing the previous toast into the queue instead.</doc>
26077- <source-position filename="src/adw-toast.h" line="70"/>
40353+ filename="src/adw-toolbar-view.c"
40354+ line="1241">Gets whether the content widget can extend behind bottom bars.</doc>
40355+ <source-position filename="src/adw-toolbar-view.h" line="85"/>
2607840356 <return-value transfer-ownership="none">
26079- <type name="none" c:type="void"/>
40357+ <doc xml:space="preserve"
40358+ filename="src/adw-toolbar-view.c"
40359+ line="1247">whether content extends behind bottom bars</doc>
40360+ <type name="gboolean" c:type="gboolean"/>
2608040361 </return-value>
2608140362 <parameters>
2608240363 <instance-parameter name="self" transfer-ownership="none">
2608340364 <doc xml:space="preserve"
26084- filename="src/adw-toast.c"
26085- line="789">a toast</doc>
26086- <type name="Toast" c:type="AdwToast*"/>
40365+ filename="src/adw-toolbar-view.c"
40366+ line="1243">a toolbar view</doc>
40367+ <type name="ToolbarView" c:type="AdwToolbarView*"/>
2608740368 </instance-parameter>
26088- <parameter name="priority" transfer-ownership="none">
26089- <doc xml:space="preserve"
26090- filename="src/adw-toast.c"
26091- line="790">the priority</doc>
26092- <type name="ToastPriority" c:type="AdwToastPriority"/>
26093- </parameter>
2609440369 </parameters>
2609540370 </method>
26096- <method name="set_timeout"
26097- c:identifier="adw_toast_set_timeout"
26098- glib:set-property="timeout">
26099- <attribute name="org.gtk.Method.set_property" value="timeout"/>
40371+ <method name="get_extend_content_to_top_edge"
40372+ c:identifier="adw_toolbar_view_get_extend_content_to_top_edge"
40373+ glib:get-property="extend-content-to-top-edge"
40374+ version="1.4">
2610040375 <doc xml:space="preserve"
26101- filename="src/adw-toast.c"
26102- line="834">Sets timeout for @self.
26103-
26104-If @timeout is 0, the toast is displayed indefinitely until manually
26105-dismissed.
26106-
26107-Toasts cannot disappear while being hovered, pressed (on touchscreen), or
26108-have keyboard focus inside them.</doc>
26109- <source-position filename="src/adw-toast.h" line="76"/>
40376+ filename="src/adw-toolbar-view.c"
40377+ line="1189">Gets whether the content widget can extend behind top bars.</doc>
40378+ <source-position filename="src/adw-toolbar-view.h" line="79"/>
2611040379 <return-value transfer-ownership="none">
26111- <type name="none" c:type="void"/>
40380+ <doc xml:space="preserve"
40381+ filename="src/adw-toolbar-view.c"
40382+ line="1195">whether content extends behind top bars</doc>
40383+ <type name="gboolean" c:type="gboolean"/>
2611240384 </return-value>
2611340385 <parameters>
2611440386 <instance-parameter name="self" transfer-ownership="none">
2611540387 <doc xml:space="preserve"
26116- filename="src/adw-toast.c"
26117- line="836">a toast</doc>
26118- <type name="Toast" c:type="AdwToast*"/>
40388+ filename="src/adw-toolbar-view.c"
40389+ line="1191">a toolbar view</doc>
40390+ <type name="ToolbarView" c:type="AdwToolbarView*"/>
2611940391 </instance-parameter>
26120- <parameter name="timeout" transfer-ownership="none">
26121- <doc xml:space="preserve"
26122- filename="src/adw-toast.c"
26123- line="837">the timeout</doc>
26124- <type name="guint" c:type="guint"/>
26125- </parameter>
2612640392 </parameters>
2612740393 </method>
26128- <method name="set_title"
26129- c:identifier="adw_toast_set_title"
26130- glib:set-property="title">
26131- <attribute name="org.gtk.Method.set_property" value="title"/>
40394+ <method name="get_reveal_bottom_bars"
40395+ c:identifier="adw_toolbar_view_get_reveal_bottom_bars"
40396+ glib:get-property="reveal-bottom-bars"
40397+ version="1.4">
2613240398 <doc xml:space="preserve"
26133- filename="src/adw-toast.c"
26134- line="535">Sets the title that will be displayed on the toast.
26135-
26136-The title can be marked up with the Pango text markup language.
26137-
26138-Setting a title will unset [property@Toast:custom-title].
26139-
26140-If [property@Toast:custom-title] is set, it will be used instead.</doc>
26141- <source-position filename="src/adw-toast.h" line="39"/>
40399+ filename="src/adw-toolbar-view.c"
40400+ line="1138">Gets whether bottom bars are revealed for @self.</doc>
40401+ <source-position filename="src/adw-toolbar-view.h" line="73"/>
2614240402 <return-value transfer-ownership="none">
26143- <type name="none" c:type="void"/>
40403+ <doc xml:space="preserve"
40404+ filename="src/adw-toolbar-view.c"
40405+ line="1144">whether bottom bars are revealed</doc>
40406+ <type name="gboolean" c:type="gboolean"/>
2614440407 </return-value>
2614540408 <parameters>
2614640409 <instance-parameter name="self" transfer-ownership="none">
2614740410 <doc xml:space="preserve"
26148- filename="src/adw-toast.c"
26149- line="537">a toast</doc>
26150- <type name="Toast" c:type="AdwToast*"/>
40411+ filename="src/adw-toolbar-view.c"
40412+ line="1140">a toolbar view</doc>
40413+ <type name="ToolbarView" c:type="AdwToolbarView*"/>
2615140414 </instance-parameter>
26152- <parameter name="title" transfer-ownership="none">
26153- <doc xml:space="preserve"
26154- filename="src/adw-toast.c"
26155- line="538">a title</doc>
26156- <type name="utf8" c:type="const char*"/>
26157- </parameter>
2615840415 </parameters>
2615940416 </method>
26160- <property name="action-name"
26161- writable="1"
26162- transfer-ownership="none"
26163- setter="set_action_name"
26164- getter="get_action_name"
26165- default-value="NULL">
26166- <attribute name="org.gtk.Property.get"
26167- value="adw_toast_get_action_name"/>
26168- <attribute name="org.gtk.Property.set"
26169- value="adw_toast_set_action_name"/>
40417+ <method name="get_reveal_top_bars"
40418+ c:identifier="adw_toolbar_view_get_reveal_top_bars"
40419+ glib:get-property="reveal-top-bars"
40420+ version="1.4">
2617040421 <doc xml:space="preserve"
26171- filename="src/adw-toast.c"
26172- line="326">The name of the associated action.
26173-
26174-It will be activated when clicking the button.
26175-
26176-See [property@Toast:action-target].</doc>
26177- <type name="utf8" c:type="gchar*"/>
26178- </property>
26179- <property name="action-target"
26180- writable="1"
26181- transfer-ownership="none"
26182- setter="set_action_target">
26183- <attribute name="org.gtk.Property.get"
26184- value="adw_toast_get_action_target_value"/>
26185- <attribute name="org.gtk.Property.set"
26186- value="adw_toast_set_action_target_value"/>
26187- <doc xml:space="preserve"
26188- filename="src/adw-toast.c"
26189- line="340">The parameter for action invocations.</doc>
26190- <type name="GLib.Variant"/>
26191- </property>
26192- <property name="button-label"
26193- writable="1"
26194- transfer-ownership="none"
26195- setter="set_button_label"
26196- getter="get_button_label"
26197- default-value="NULL">
26198- <attribute name="org.gtk.Property.get"
26199- value="adw_toast_get_button_label"/>
26200- <attribute name="org.gtk.Property.set"
26201- value="adw_toast_set_button_label"/>
40422+ filename="src/adw-toolbar-view.c"
40423+ line="1087">Gets whether top bars are revealed for @self.</doc>
40424+ <source-position filename="src/adw-toolbar-view.h" line="67"/>
40425+ <return-value transfer-ownership="none">
40426+ <doc xml:space="preserve"
40427+ filename="src/adw-toolbar-view.c"
40428+ line="1093">whether top bars are revealed</doc>
40429+ <type name="gboolean" c:type="gboolean"/>
40430+ </return-value>
40431+ <parameters>
40432+ <instance-parameter name="self" transfer-ownership="none">
40433+ <doc xml:space="preserve"
40434+ filename="src/adw-toolbar-view.c"
40435+ line="1089">a toolbar view</doc>
40436+ <type name="ToolbarView" c:type="AdwToolbarView*"/>
40437+ </instance-parameter>
40438+ </parameters>
40439+ </method>
40440+ <method name="get_top_bar_height"
40441+ c:identifier="adw_toolbar_view_get_top_bar_height"
40442+ glib:get-property="top-bar-height"
40443+ version="1.4">
2620240444 <doc xml:space="preserve"
26203- filename="src/adw-toast.c"
26204- line="310">The label to show on the button.
26205-
26206-Underlines in the button text can be used to indicate a mnemonic.
40445+ filename="src/adw-toolbar-view.c"
40446+ line="1293">Gets the current top bar height for @self.
2620740447
26208-If set to `NULL`, the button won't be shown.
40448+Top bar height does change depending on
40449+[property@ToolbarView:reveal-top-bars], including during the transition.
2620940450
26210-See [property@Toast:action-name].</doc>
26211- <type name="utf8" c:type="gchar*"/>
26212- </property>
26213- <property name="custom-title"
26214- version="1.2"
26215- writable="1"
26216- transfer-ownership="none"
26217- setter="set_custom_title"
26218- getter="get_custom_title">
26219- <attribute name="org.gtk.Property.get"
26220- value="adw_toast_get_custom_title"/>
26221- <attribute name="org.gtk.Property.set"
26222- value="adw_toast_set_custom_title"/>
40451+See [method@ToolbarView.get_bottom_bar_height].</doc>
40452+ <source-position filename="src/adw-toolbar-view.h" line="91"/>
40453+ <return-value transfer-ownership="none">
40454+ <doc xml:space="preserve"
40455+ filename="src/adw-toolbar-view.c"
40456+ line="1304">the current top bar height</doc>
40457+ <type name="gint" c:type="int"/>
40458+ </return-value>
40459+ <parameters>
40460+ <instance-parameter name="self" transfer-ownership="none">
40461+ <doc xml:space="preserve"
40462+ filename="src/adw-toolbar-view.c"
40463+ line="1295">a toolbar view</doc>
40464+ <type name="ToolbarView" c:type="AdwToolbarView*"/>
40465+ </instance-parameter>
40466+ </parameters>
40467+ </method>
40468+ <method name="get_top_bar_style"
40469+ c:identifier="adw_toolbar_view_get_top_bar_style"
40470+ glib:get-property="top-bar-style"
40471+ version="1.4">
2622340472 <doc xml:space="preserve"
26224- filename="src/adw-toast.c"
26225- line="386">The custom title widget.
26226-
26227-It will be displayed instead of the title if set. In this case,
26228-[property@Toast:title] is ignored.
26229-
26230-Setting a custom title will unset [property@Toast:title].</doc>
26231- <type name="Gtk.Widget"/>
26232- </property>
26233- <property name="priority"
26234- writable="1"
26235- transfer-ownership="none"
26236- setter="set_priority"
26237- getter="get_priority"
26238- default-value="ADW_TOAST_PRIORITY_NORMAL">
26239- <attribute name="org.gtk.Property.get" value="adw_toast_get_priority"/>
26240- <attribute name="org.gtk.Property.set" value="adw_toast_set_priority"/>
40473+ filename="src/adw-toolbar-view.c"
40474+ line="915">Gets appearance of the top bars for @self.</doc>
40475+ <source-position filename="src/adw-toolbar-view.h" line="55"/>
40476+ <return-value transfer-ownership="none">
40477+ <doc xml:space="preserve"
40478+ filename="src/adw-toolbar-view.c"
40479+ line="921">top bar style</doc>
40480+ <type name="ToolbarStyle" c:type="AdwToolbarStyle"/>
40481+ </return-value>
40482+ <parameters>
40483+ <instance-parameter name="self" transfer-ownership="none">
40484+ <doc xml:space="preserve"
40485+ filename="src/adw-toolbar-view.c"
40486+ line="917">a toolbar view</doc>
40487+ <type name="ToolbarView" c:type="AdwToolbarView*"/>
40488+ </instance-parameter>
40489+ </parameters>
40490+ </method>
40491+ <method name="remove"
40492+ c:identifier="adw_toolbar_view_remove"
40493+ version="1.4">
2624140494 <doc xml:space="preserve"
26242- filename="src/adw-toast.c"
26243- line="351">The priority of the toast.
26244-
26245-Priority controls how the toast behaves when another toast is already
26246-being displayed.
26247-
26248-If the priority is `ADW_TOAST_PRIORITY_NORMAL`, the toast will be queued.
26249-
26250-If the priority is `ADW_TOAST_PRIORITY_HIGH`, the toast will be displayed
26251-immediately, pushing the previous toast into the queue instead.</doc>
26252- <type name="ToastPriority"/>
26253- </property>
26254- <property name="timeout"
26255- writable="1"
26256- transfer-ownership="none"
26257- setter="set_timeout"
26258- getter="get_timeout"
26259- default-value="5">
26260- <attribute name="org.gtk.Property.get" value="adw_toast_get_timeout"/>
26261- <attribute name="org.gtk.Property.set" value="adw_toast_set_timeout"/>
40495+ filename="src/adw-toolbar-view.c"
40496+ line="875">Removes a child from @self.</doc>
40497+ <source-position filename="src/adw-toolbar-view.h" line="51"/>
40498+ <return-value transfer-ownership="none">
40499+ <type name="none" c:type="void"/>
40500+ </return-value>
40501+ <parameters>
40502+ <instance-parameter name="self" transfer-ownership="none">
40503+ <doc xml:space="preserve"
40504+ filename="src/adw-toolbar-view.c"
40505+ line="877">a toolbar view</doc>
40506+ <type name="ToolbarView" c:type="AdwToolbarView*"/>
40507+ </instance-parameter>
40508+ <parameter name="widget" transfer-ownership="none">
40509+ <doc xml:space="preserve"
40510+ filename="src/adw-toolbar-view.c"
40511+ line="878">the child to be removed</doc>
40512+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
40513+ </parameter>
40514+ </parameters>
40515+ </method>
40516+ <method name="set_bottom_bar_style"
40517+ c:identifier="adw_toolbar_view_set_bottom_bar_style"
40518+ glib:set-property="bottom-bar-style"
40519+ version="1.4">
2626240520 <doc xml:space="preserve"
26263- filename="src/adw-toast.c"
26264- line="370">The timeout of the toast, in seconds.
26265-
26266-If timeout is 0, the toast is displayed indefinitely until manually
26267-dismissed.
40521+ filename="src/adw-toolbar-view.c"
40522+ line="1019">Sets appearance of the bottom bars for @self.
2626840523
26269-Toasts cannot disappear while being hovered, pressed (on touchscreen), or
26270-have keyboard focus inside them.</doc>
26271- <type name="guint" c:type="guint"/>
26272- </property>
26273- <property name="title"
26274- writable="1"
26275- transfer-ownership="none"
26276- setter="set_title"
26277- getter="get_title">
26278- <attribute name="org.gtk.Property.get" value="adw_toast_get_title"/>
26279- <attribute name="org.gtk.Property.set" value="adw_toast_set_title"/>
26280- <doc xml:space="preserve"
26281- filename="src/adw-toast.c"
26282- line="294">The title of the toast.
40524+If set to `ADW_TOOLBAR_FLAT`, bottom bars are flat and scrolling content has
40525+a subtle undershoot shadow when touching them, same as the
40526+[`.undershoot-bottom`](style-classes.html#undershoot-indicators)
40527+style class. This works well for simple content, e.g. [class@StatusPage] or
40528+[class@PreferencesPage], where the background at the bottom of the page is
40529+uniform. Additionally, windows with sidebars should always use this style.
2628340530
26284-The title can be marked up with the Pango text markup language.
40531+Undershoot shadow is only present if a bottom bar is actually present and
40532+visible. It is also never present if
40533+[property@ToolbarView:extend-content-to-bottom-edge] is set to `TRUE`.
2628540534
26286-Setting a title will unset [property@Toast:custom-title].
40535+If set to `ADW_TOOLBAR_RAISED`, bottom bars have an opaque background and a
40536+persistent shadow, this is suitable for content such as
40537+[utility panes](https://developer.gnome.org/hig/patterns/containers/utility-panes.html),
40538+where some elements are directly adjacent to the bottom bars, or
40539+[class@TabView], where each page can have a different background.
2628740540
26288-If [property@Toast:custom-title] is set, it will be used instead.</doc>
26289- <type name="utf8" c:type="gchar*"/>
26290- </property>
26291- <glib:signal name="button-clicked" when="last" version="1.2">
26292- <doc xml:space="preserve"
26293- filename="src/adw-toast.c"
26294- line="422">Emitted after the button has been clicked.
40541+`ADW_TOOLBAR_RAISED_BORDER` is similar to `ADW_TOOLBAR_RAISED`, but the
40542+shadow is replaced with a more subtle border. This can be useful for
40543+applications like image viewers.
2629540544
26296-It can be used as an alternative to setting an action.</doc>
40545+See also [method@ToolbarView.set_top_bar_style].</doc>
40546+ <source-position filename="src/adw-toolbar-view.h" line="63"/>
2629740547 <return-value transfer-ownership="none">
2629840548 <type name="none" c:type="void"/>
2629940549 </return-value>
26300- </glib:signal>
26301- <glib:signal name="dismissed" when="first">
40550+ <parameters>
40551+ <instance-parameter name="self" transfer-ownership="none">
40552+ <doc xml:space="preserve"
40553+ filename="src/adw-toolbar-view.c"
40554+ line="1021">a toolbar view</doc>
40555+ <type name="ToolbarView" c:type="AdwToolbarView*"/>
40556+ </instance-parameter>
40557+ <parameter name="style" transfer-ownership="none">
40558+ <doc xml:space="preserve"
40559+ filename="src/adw-toolbar-view.c"
40560+ line="1022">bottom bar style</doc>
40561+ <type name="ToolbarStyle" c:type="AdwToolbarStyle"/>
40562+ </parameter>
40563+ </parameters>
40564+ </method>
40565+ <method name="set_content"
40566+ c:identifier="adw_toolbar_view_set_content"
40567+ glib:set-property="content"
40568+ version="1.4">
2630240569 <doc xml:space="preserve"
26303- filename="src/adw-toast.c"
26304- line="405">Emitted when the toast has been dismissed.</doc>
40570+ filename="src/adw-toolbar-view.c"
40571+ line="792">Sets the content widget for @self.</doc>
40572+ <source-position filename="src/adw-toolbar-view.h" line="39"/>
2630540573 <return-value transfer-ownership="none">
2630640574 <type name="none" c:type="void"/>
2630740575 </return-value>
26308- </glib:signal>
26309- </class>
26310- <record name="ToastClass"
26311- c:type="AdwToastClass"
26312- glib:is-gtype-struct-for="Toast">
26313- <source-position filename="src/adw-toast.h" line="28"/>
26314- <field name="parent_class">
26315- <type name="GObject.ObjectClass" c:type="GObjectClass"/>
26316- </field>
26317- </record>
26318- <class name="ToastOverlay"
26319- c:symbol-prefix="toast_overlay"
26320- c:type="AdwToastOverlay"
26321- parent="Gtk.Widget"
26322- final="1"
26323- glib:type-name="AdwToastOverlay"
26324- glib:get-type="adw_toast_overlay_get_type"
26325- glib:type-struct="ToastOverlayClass">
26326- <doc xml:space="preserve"
26327- filename="src/adw-toast-overlay.c"
26328- line="24">A widget showing toasts above its content.
26329-
26330-&lt;picture&gt;
26331- &lt;source srcset="toast-overlay-dark.png" media="(prefers-color-scheme: dark)"&gt;
26332- &lt;img src="toast-overlay.png" alt="toast-overlay"&gt;
26333-&lt;/picture&gt;
26334-
26335-Much like [class@Gtk.Overlay], `AdwToastOverlay` is a container with a single
26336-main child, on top of which it can display a [class@Toast], overlaid.
26337-Toasts can be shown with [method@ToastOverlay.add_toast].
26338-
26339-See [class@Toast] for details.
26340-
26341-## CSS nodes
26342-
26343-```
26344-toastoverlay
26345-├── [child]
26346-├── toast
26347-┊ ├── widget
26348-┊ │ ├── [label.heading]
26349- │ ╰── [custom title]
26350- ├── [button]
26351- ╰── button.circular.flat
26352-```
26353-
26354-`AdwToastOverlay`'s CSS node is called `toastoverlay`. It contains the child,
26355-as well as zero or more `toast` subnodes.
40576+ <parameters>
40577+ <instance-parameter name="self" transfer-ownership="none">
40578+ <doc xml:space="preserve"
40579+ filename="src/adw-toolbar-view.c"
40580+ line="794">a toolbar view</doc>
40581+ <type name="ToolbarView" c:type="AdwToolbarView*"/>
40582+ </instance-parameter>
40583+ <parameter name="content"
40584+ transfer-ownership="none"
40585+ nullable="1"
40586+ allow-none="1">
40587+ <doc xml:space="preserve"
40588+ filename="src/adw-toolbar-view.c"
40589+ line="795">the content widget</doc>
40590+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
40591+ </parameter>
40592+ </parameters>
40593+ </method>
40594+ <method name="set_extend_content_to_bottom_edge"
40595+ c:identifier="adw_toolbar_view_set_extend_content_to_bottom_edge"
40596+ glib:set-property="extend-content-to-bottom-edge"
40597+ version="1.4">
40598+ <doc xml:space="preserve"
40599+ filename="src/adw-toolbar-view.c"
40600+ line="1259">Sets whether the content widget can extend behind bottom bars.
2635640601
26357-Each of the `toast` nodes contains a `widget` subnode, optionally a `button`
26358-subnode, and another `button` subnode with `.circular` and `.flat` style
26359-classes.
40602+This can be used in combination with [property@ToolbarView:reveal-bottom-bars]
40603+to show and hide toolbars in fullscreen.
2636040604
26361-The `widget` subnode contains a `label` subnode with the `.heading` style
26362-class, or a custom widget provided by the application.
40605+See [method@ToolbarView.set_extend_content_to_top_edge].</doc>
40606+ <source-position filename="src/adw-toolbar-view.h" line="87"/>
40607+ <return-value transfer-ownership="none">
40608+ <type name="none" c:type="void"/>
40609+ </return-value>
40610+ <parameters>
40611+ <instance-parameter name="self" transfer-ownership="none">
40612+ <doc xml:space="preserve"
40613+ filename="src/adw-toolbar-view.c"
40614+ line="1261">a toolbar view</doc>
40615+ <type name="ToolbarView" c:type="AdwToolbarView*"/>
40616+ </instance-parameter>
40617+ <parameter name="extend" transfer-ownership="none">
40618+ <doc xml:space="preserve"
40619+ filename="src/adw-toolbar-view.c"
40620+ line="1262">whether content extends behind bottom bars</doc>
40621+ <type name="gboolean" c:type="gboolean"/>
40622+ </parameter>
40623+ </parameters>
40624+ </method>
40625+ <method name="set_extend_content_to_top_edge"
40626+ c:identifier="adw_toolbar_view_set_extend_content_to_top_edge"
40627+ glib:set-property="extend-content-to-top-edge"
40628+ version="1.4">
40629+ <doc xml:space="preserve"
40630+ filename="src/adw-toolbar-view.c"
40631+ line="1207">Sets whether the content widget can extend behind top bars.
2636340632
26364-## Accessibility
40633+This can be used in combination with [property@ToolbarView:reveal-top-bars]
40634+to show and hide toolbars in fullscreen.
2636540635
26366-`AdwToastOverlay` uses the `GTK_ACCESSIBLE_ROLE_TAB_GROUP` role.</doc>
26367- <source-position filename="src/adw-toast-overlay.h" line="23"/>
26368- <implements name="Gtk.Accessible"/>
26369- <implements name="Gtk.Buildable"/>
26370- <implements name="Gtk.ConstraintTarget"/>
26371- <constructor name="new" c:identifier="adw_toast_overlay_new">
26372- <doc xml:space="preserve"
26373- filename="src/adw-toast-overlay.c"
26374- line="549">Creates a new `AdwToastOverlay`.</doc>
26375- <source-position filename="src/adw-toast-overlay.h" line="26"/>
40636+See [method@ToolbarView.set_extend_content_to_bottom_edge].</doc>
40637+ <source-position filename="src/adw-toolbar-view.h" line="81"/>
2637640638 <return-value transfer-ownership="none">
26377- <doc xml:space="preserve"
26378- filename="src/adw-toast-overlay.c"
26379- line="554">the new created `AdwToastOverlay`</doc>
26380- <type name="Gtk.Widget" c:type="GtkWidget*"/>
40639+ <type name="none" c:type="void"/>
2638140640 </return-value>
26382- </constructor>
26383- <method name="add_toast" c:identifier="adw_toast_overlay_add_toast">
40641+ <parameters>
40642+ <instance-parameter name="self" transfer-ownership="none">
40643+ <doc xml:space="preserve"
40644+ filename="src/adw-toolbar-view.c"
40645+ line="1209">a toolbar view</doc>
40646+ <type name="ToolbarView" c:type="AdwToolbarView*"/>
40647+ </instance-parameter>
40648+ <parameter name="extend" transfer-ownership="none">
40649+ <doc xml:space="preserve"
40650+ filename="src/adw-toolbar-view.c"
40651+ line="1210">whether content extends behind top bars</doc>
40652+ <type name="gboolean" c:type="gboolean"/>
40653+ </parameter>
40654+ </parameters>
40655+ </method>
40656+ <method name="set_reveal_bottom_bars"
40657+ c:identifier="adw_toolbar_view_set_reveal_bottom_bars"
40658+ glib:set-property="reveal-bottom-bars"
40659+ version="1.4">
2638440660 <doc xml:space="preserve"
26385- filename="src/adw-toast-overlay.c"
26386- line="606">Displays @toast.
40661+ filename="src/adw-toolbar-view.c"
40662+ line="1156">Sets whether bottom bars are revealed for @self.
2638740663
26388-Only one toast can be shown at a time; if a toast is already being displayed,
26389-either @toast or the original toast will be placed in a queue, depending on
26390-the priority of @toast. See [property@Toast:priority].
40664+The transition will be animated.
2639140665
26392-If called on a toast that's already displayed, its timeout will be reset.
40666+This can be used in combination with
40667+[property@ToolbarView:extend-content-to-bottom-edge] to show and hide
40668+toolbars in fullscreen.
2639340669
26394-If called on a toast currently in the queue, the toast will be bumped
26395-forward to be shown as soon as possible.</doc>
26396- <source-position filename="src/adw-toast-overlay.h" line="35"/>
40670+See [method@ToolbarView.set_reveal_top_bars].</doc>
40671+ <source-position filename="src/adw-toolbar-view.h" line="75"/>
2639740672 <return-value transfer-ownership="none">
2639840673 <type name="none" c:type="void"/>
2639940674 </return-value>
2640040675 <parameters>
2640140676 <instance-parameter name="self" transfer-ownership="none">
2640240677 <doc xml:space="preserve"
26403- filename="src/adw-toast-overlay.c"
26404- line="608">a toast overlay</doc>
26405- <type name="ToastOverlay" c:type="AdwToastOverlay*"/>
40678+ filename="src/adw-toolbar-view.c"
40679+ line="1158">a toolbar view</doc>
40680+ <type name="ToolbarView" c:type="AdwToolbarView*"/>
2640640681 </instance-parameter>
26407- <parameter name="toast" transfer-ownership="full">
40682+ <parameter name="reveal" transfer-ownership="none">
2640840683 <doc xml:space="preserve"
26409- filename="src/adw-toast-overlay.c"
26410- line="609">a toast</doc>
26411- <type name="Toast" c:type="AdwToast*"/>
40684+ filename="src/adw-toolbar-view.c"
40685+ line="1159">whether to reveal bottom bars</doc>
40686+ <type name="gboolean" c:type="gboolean"/>
2641240687 </parameter>
2641340688 </parameters>
2641440689 </method>
26415- <method name="get_child"
26416- c:identifier="adw_toast_overlay_get_child"
26417- glib:get-property="child">
26418- <attribute name="org.gtk.Method.get_property" value="child"/>
40690+ <method name="set_reveal_top_bars"
40691+ c:identifier="adw_toolbar_view_set_reveal_top_bars"
40692+ glib:set-property="reveal-top-bars"
40693+ version="1.4">
2641940694 <doc xml:space="preserve"
26420- filename="src/adw-toast-overlay.c"
26421- line="562">Gets the child widget of @self.</doc>
26422- <source-position filename="src/adw-toast-overlay.h" line="29"/>
26423- <return-value transfer-ownership="none" nullable="1">
26424- <doc xml:space="preserve"
26425- filename="src/adw-toast-overlay.c"
26426- line="568">the child widget of @self</doc>
26427- <type name="Gtk.Widget" c:type="GtkWidget*"/>
40695+ filename="src/adw-toolbar-view.c"
40696+ line="1105">Sets whether top bars are revealed for @self.
40697+
40698+The transition will be animated.
40699+
40700+This can be used in combination with
40701+[property@ToolbarView:extend-content-to-top-edge] to show and hide toolbars
40702+in fullscreen.
40703+
40704+See [method@ToolbarView.set_reveal_bottom_bars].</doc>
40705+ <source-position filename="src/adw-toolbar-view.h" line="69"/>
40706+ <return-value transfer-ownership="none">
40707+ <type name="none" c:type="void"/>
2642840708 </return-value>
2642940709 <parameters>
2643040710 <instance-parameter name="self" transfer-ownership="none">
2643140711 <doc xml:space="preserve"
26432- filename="src/adw-toast-overlay.c"
26433- line="564">a toast overlay</doc>
26434- <type name="ToastOverlay" c:type="AdwToastOverlay*"/>
40712+ filename="src/adw-toolbar-view.c"
40713+ line="1107">a toolbar view</doc>
40714+ <type name="ToolbarView" c:type="AdwToolbarView*"/>
2643540715 </instance-parameter>
40716+ <parameter name="reveal" transfer-ownership="none">
40717+ <doc xml:space="preserve"
40718+ filename="src/adw-toolbar-view.c"
40719+ line="1108">whether to reveal top bars</doc>
40720+ <type name="gboolean" c:type="gboolean"/>
40721+ </parameter>
2643640722 </parameters>
2643740723 </method>
26438- <method name="set_child"
26439- c:identifier="adw_toast_overlay_set_child"
26440- glib:set-property="child">
26441- <attribute name="org.gtk.Method.set_property" value="child"/>
40724+ <method name="set_top_bar_style"
40725+ c:identifier="adw_toolbar_view_set_top_bar_style"
40726+ glib:set-property="top-bar-style"
40727+ version="1.4">
2644240728 <doc xml:space="preserve"
26443- filename="src/adw-toast-overlay.c"
26444- line="578">Sets the child widget of @self.</doc>
26445- <source-position filename="src/adw-toast-overlay.h" line="31"/>
40729+ filename="src/adw-toolbar-view.c"
40730+ line="933">Sets appearance of the top bars for @self.
40731+
40732+If set to `ADW_TOOLBAR_FLAT`, top bars are flat and scrolling content has a
40733+subtle undershoot shadow when touching them, same as the
40734+[`.undershoot-top`](style-classes.html#undershoot-indicators)
40735+style class. This works well for simple content, e.g. [class@StatusPage] or
40736+[class@PreferencesPage], where the background at the top of the page is
40737+uniform. Additionally, windows with sidebars should always use this style.
40738+
40739+Undershoot shadow is only present if a top bar is actually present and
40740+visible. It is also never present if
40741+[property@ToolbarView:extend-content-to-top-edge] is set to `TRUE`.
40742+
40743+If set to `ADW_TOOLBAR_RAISED`, top bars have an opaque background and a
40744+persistent shadow, this is suitable for content such as
40745+[utility panes](https://developer.gnome.org/hig/patterns/containers/utility-panes.html),
40746+where some elements are directly adjacent to the top bars, or
40747+[class@TabView], where each page can have a different background.
40748+
40749+`ADW_TOOLBAR_RAISED_BORDER` is similar to `ADW_TOOLBAR_RAISED`, but the
40750+shadow is replaced with a more subtle border. This can be useful for
40751+applications like image viewers.
40752+
40753+See also [method@ToolbarView.set_bottom_bar_style].</doc>
40754+ <source-position filename="src/adw-toolbar-view.h" line="57"/>
2644640755 <return-value transfer-ownership="none">
2644740756 <type name="none" c:type="void"/>
2644840757 </return-value>
2644940758 <parameters>
2645040759 <instance-parameter name="self" transfer-ownership="none">
2645140760 <doc xml:space="preserve"
26452- filename="src/adw-toast-overlay.c"
26453- line="580">a toast overlay</doc>
26454- <type name="ToastOverlay" c:type="AdwToastOverlay*"/>
40761+ filename="src/adw-toolbar-view.c"
40762+ line="935">a toolbar view</doc>
40763+ <type name="ToolbarView" c:type="AdwToolbarView*"/>
2645540764 </instance-parameter>
26456- <parameter name="child"
26457- transfer-ownership="none"
26458- nullable="1"
26459- allow-none="1">
40765+ <parameter name="style" transfer-ownership="none">
2646040766 <doc xml:space="preserve"
26461- filename="src/adw-toast-overlay.c"
26462- line="581">the child widget</doc>
26463- <type name="Gtk.Widget" c:type="GtkWidget*"/>
40767+ filename="src/adw-toolbar-view.c"
40768+ line="936">top bar style</doc>
40769+ <type name="ToolbarStyle" c:type="AdwToolbarStyle"/>
2646440770 </parameter>
2646540771 </parameters>
2646640772 </method>
26467- <property name="child"
40773+ <property name="bottom-bar-height"
40774+ version="1.4"
40775+ transfer-ownership="none"
40776+ getter="get_bottom_bar_height"
40777+ default-value="0">
40778+ <doc xml:space="preserve"
40779+ filename="src/adw-toolbar-view.c"
40780+ line="671">The current bottom bar height.
40781+
40782+Bottom bar height does change depending on
40783+[property@ToolbarView:reveal-bottom-bars], including during the transition.
40784+
40785+See [property@ToolbarView:top-bar-height].</doc>
40786+ <type name="gint" c:type="gint"/>
40787+ </property>
40788+ <property name="bottom-bar-style"
40789+ version="1.4"
40790+ writable="1"
40791+ transfer-ownership="none"
40792+ setter="set_bottom_bar_style"
40793+ getter="get_bottom_bar_style"
40794+ default-value="ADW_TOOLBAR_FLAT">
40795+ <doc xml:space="preserve"
40796+ filename="src/adw-toolbar-view.c"
40797+ line="543">Appearance of the bottom bars.
40798+
40799+If set to `ADW_TOOLBAR_FLAT`, bottom bars are flat and scrolling content
40800+has a subtle undershoot shadow when touching them, same as the
40801+[`.undershoot-bottom`](style-classes.html#undershoot-indicators)
40802+style class. This works well for simple content, e.g. [class@StatusPage] or
40803+[class@PreferencesPage], where the background at the bottom of the page is
40804+uniform. Additionally, windows with sidebars should always use this style.
40805+
40806+Undershoot shadow is only present if a bottom bar is actually present and
40807+visible. It is also never present if
40808+[property@ToolbarView:extend-content-to-bottom-edge] is set to `TRUE`.
40809+
40810+If set to `ADW_TOOLBAR_RAISED`, bottom bars have an opaque background and a
40811+persistent shadow, this is suitable for content such as
40812+[utility panes](https://developer.gnome.org/hig/patterns/containers/utility-panes.html),
40813+where some elements are directly adjacent to the bottom bars, or
40814+[class@TabView], where each page can have a different background.
40815+
40816+`ADW_TOOLBAR_RAISED_BORDER` is similar to `ADW_TOOLBAR_RAISED`, but the
40817+shadow is replaced with a more subtle border. This can be useful for
40818+applications like image viewers.
40819+
40820+See also [property@ToolbarView:top-bar-style].</doc>
40821+ <type name="ToolbarStyle"/>
40822+ </property>
40823+ <property name="content"
40824+ version="1.4"
40825+ writable="1"
40826+ transfer-ownership="none"
40827+ setter="set_content"
40828+ getter="get_content">
40829+ <doc xml:space="preserve"
40830+ filename="src/adw-toolbar-view.c"
40831+ line="495">The content widget.</doc>
40832+ <type name="Gtk.Widget"/>
40833+ </property>
40834+ <property name="extend-content-to-bottom-edge"
40835+ version="1.4"
40836+ writable="1"
40837+ transfer-ownership="none"
40838+ setter="set_extend_content_to_bottom_edge"
40839+ getter="get_extend_content_to_bottom_edge"
40840+ default-value="FALSE">
40841+ <doc xml:space="preserve"
40842+ filename="src/adw-toolbar-view.c"
40843+ line="636">Whether the content widget can extend behind bottom bars.
40844+
40845+This can be used in combination with
40846+[property@ToolbarView:reveal-bottom-bars] to show and hide toolbars in
40847+fullscreen.
40848+
40849+See [property@ToolbarView:extend-content-to-top-edge].</doc>
40850+ <type name="gboolean" c:type="gboolean"/>
40851+ </property>
40852+ <property name="extend-content-to-top-edge"
40853+ version="1.4"
40854+ writable="1"
40855+ transfer-ownership="none"
40856+ setter="set_extend_content_to_top_edge"
40857+ getter="get_extend_content_to_top_edge"
40858+ default-value="FALSE">
40859+ <doc xml:space="preserve"
40860+ filename="src/adw-toolbar-view.c"
40861+ line="619">Whether the content widget can extend behind top bars.
40862+
40863+This can be used in combination with [property@ToolbarView:reveal-top-bars]
40864+to show and hide toolbars in fullscreen.
40865+
40866+See [property@ToolbarView:extend-content-to-bottom-edge].</doc>
40867+ <type name="gboolean" c:type="gboolean"/>
40868+ </property>
40869+ <property name="reveal-bottom-bars"
40870+ version="1.4"
40871+ writable="1"
40872+ transfer-ownership="none"
40873+ setter="set_reveal_bottom_bars"
40874+ getter="get_reveal_bottom_bars"
40875+ default-value="TRUE">
40876+ <doc xml:space="preserve"
40877+ filename="src/adw-toolbar-view.c"
40878+ line="599">Whether bottom bars are visible.
40879+
40880+The transition will be animated.
40881+
40882+This can be used in combination with
40883+[property@ToolbarView:extend-content-to-bottom-edge] to show and hide
40884+toolbars in fullscreen.
40885+
40886+See [property@ToolbarView:reveal-top-bars].</doc>
40887+ <type name="gboolean" c:type="gboolean"/>
40888+ </property>
40889+ <property name="reveal-top-bars"
40890+ version="1.4"
40891+ writable="1"
40892+ transfer-ownership="none"
40893+ setter="set_reveal_top_bars"
40894+ getter="get_reveal_top_bars"
40895+ default-value="TRUE">
40896+ <doc xml:space="preserve"
40897+ filename="src/adw-toolbar-view.c"
40898+ line="579">Whether top bars are revealed.
40899+
40900+The transition will be animated.
40901+
40902+This can be used in combination with
40903+[property@ToolbarView:extend-content-to-top-edge] to show and hide toolbars
40904+in fullscreen.
40905+
40906+See [property@ToolbarView:reveal-bottom-bars].</doc>
40907+ <type name="gboolean" c:type="gboolean"/>
40908+ </property>
40909+ <property name="top-bar-height"
40910+ version="1.4"
40911+ transfer-ownership="none"
40912+ getter="get_top_bar_height"
40913+ default-value="0">
40914+ <doc xml:space="preserve"
40915+ filename="src/adw-toolbar-view.c"
40916+ line="654">The current top bar height.
40917+
40918+Top bar height does change depending [property@ToolbarView:reveal-top-bars],
40919+including during the transition.
40920+
40921+See [property@ToolbarView:bottom-bar-height].</doc>
40922+ <type name="gint" c:type="gint"/>
40923+ </property>
40924+ <property name="top-bar-style"
40925+ version="1.4"
2646840926 writable="1"
2646940927 transfer-ownership="none"
26470- setter="set_child"
26471- getter="get_child">
26472- <attribute name="org.gtk.Property.get"
26473- value="adw_toast_overlay_get_child"/>
26474- <attribute name="org.gtk.Property.set"
26475- value="adw_toast_overlay_set_child"/>
40928+ setter="set_top_bar_style"
40929+ getter="get_top_bar_style"
40930+ default-value="ADW_TOOLBAR_FLAT">
2647640931 <doc xml:space="preserve"
26477- filename="src/adw-toast-overlay.c"
26478- line="499">The child widget.</doc>
26479- <type name="Gtk.Widget"/>
40932+ filename="src/adw-toolbar-view.c"
40933+ line="507">Appearance of the top bars.
40934+
40935+If set to `ADW_TOOLBAR_FLAT`, top bars are flat and scrolling content has a
40936+subtle undershoot shadow when touching them, same as the
40937+[`.undershoot-top`](style-classes.html#undershoot-indicators)
40938+style class. This works well for simple content, e.g. [class@StatusPage] or
40939+[class@PreferencesPage], where the background at the top of the page is
40940+uniform. Additionally, windows with sidebars should always use this style.
40941+
40942+Undershoot shadow is only present if a top bar is actually present and
40943+visible. It is also never present if
40944+[property@ToolbarView:extend-content-to-top-edge] is set to `TRUE`.
40945+
40946+If set to `ADW_TOOLBAR_RAISED`, top bars have an opaque background and a
40947+persistent shadow, this is suitable for content such as
40948+[utility panes](https://developer.gnome.org/hig/patterns/containers/utility-panes.html),
40949+where some elements are directly adjacent to the top bars, or
40950+[class@TabView], where each page can have a different background.
40951+
40952+`ADW_TOOLBAR_RAISED_BORDER` is similar to `ADW_TOOLBAR_RAISED`, but the
40953+shadow is replaced with a more subtle border. This can be useful for
40954+applications like image viewers.
40955+
40956+See also [property@ToolbarView:bottom-bar-style].</doc>
40957+ <type name="ToolbarStyle"/>
2648040958 </property>
2648140959 </class>
26482- <record name="ToastOverlayClass"
26483- c:type="AdwToastOverlayClass"
26484- glib:is-gtype-struct-for="ToastOverlay">
26485- <source-position filename="src/adw-toast-overlay.h" line="23"/>
40960+ <record name="ToolbarViewClass"
40961+ c:type="AdwToolbarViewClass"
40962+ glib:is-gtype-struct-for="ToolbarView">
40963+ <source-position filename="src/adw-toolbar-view.h" line="31"/>
2648640964 <field name="parent_class">
2648740965 <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
2648840966 </field>
2648940967 </record>
26490- <enumeration name="ToastPriority"
26491- glib:type-name="AdwToastPriority"
26492- glib:get-type="adw_toast_priority_get_type"
26493- c:type="AdwToastPriority">
26494- <doc xml:space="preserve"
26495- filename="src/adw-toast.c"
26496- line="14">[class@Toast] behavior when another toast is already displayed.</doc>
26497- <member name="normal"
26498- value="0"
26499- c:identifier="ADW_TOAST_PRIORITY_NORMAL"
26500- glib:nick="normal"
26501- glib:name="ADW_TOAST_PRIORITY_NORMAL">
26502- <doc xml:space="preserve"
26503- filename="src/adw-toast.c"
26504- line="16">the toast will be queued if another toast is
26505- already displayed.</doc>
26506- </member>
26507- <member name="high"
26508- value="1"
26509- c:identifier="ADW_TOAST_PRIORITY_HIGH"
26510- glib:nick="high"
26511- glib:name="ADW_TOAST_PRIORITY_HIGH">
26512- <doc xml:space="preserve"
26513- filename="src/adw-toast.c"
26514- line="18">the toast will be displayed immediately, pushing
26515- the previous toast into the queue instead.</doc>
26516- </member>
26517- </enumeration>
2651840968 <function-macro name="UNAVAILABLE"
2651940969 c:identifier="ADW_UNAVAILABLE"
2652040970 introspectable="0">
26521- <source-position filename="src/adw-version.h" line="187"/>
40971+ <source-position filename="src/adw-version.h" line="271"/>
2652240972 <parameters>
2652340973 <parameter name="major">
2652440974 </parameter>
@@ -26526,7 +40976,7 @@ forward to be shown as soon as possible.</doc>
2652640976 </parameter>
2652740977 </parameters>
2652840978 </function-macro>
26529- <constant name="VERSION_S" value="1.3.3" c:type="ADW_VERSION_S">
40979+ <constant name="VERSION_S" value="1.6.4" c:type="ADW_VERSION_S">
2653040980 <doc xml:space="preserve"
2653140981 filename="src/adw-version.h"
2653240982 line="45">Adwaita version, encoded as a string, useful for printing and
@@ -26605,37 +41055,37 @@ which are the accessible parent objects of the child widgets.</doc>
2660541055 <constructor name="new" c:identifier="adw_view_stack_new">
2660641056 <doc xml:space="preserve"
2660741057 filename="src/adw-view-stack.c"
26608- line="1490">Creates a new `AdwViewStack`.</doc>
41058+ line="1610">Creates a new `AdwViewStack`.</doc>
2660941059 <source-position filename="src/adw-view-stack.h" line="81"/>
2661041060 <return-value transfer-ownership="none">
2661141061 <doc xml:space="preserve"
2661241062 filename="src/adw-view-stack.c"
26613- line="1495">the newly created `AdwViewStack`</doc>
41063+ line="1615">the newly created `AdwViewStack`</doc>
2661441064 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2661541065 </return-value>
2661641066 </constructor>
2661741067 <method name="add" c:identifier="adw_view_stack_add">
2661841068 <doc xml:space="preserve"
2661941069 filename="src/adw-view-stack.c"
26620- line="1503">Adds a child to @self.</doc>
41070+ line="1623">Adds a child to @self.</doc>
2662141071 <source-position filename="src/adw-view-stack.h" line="84"/>
2662241072 <return-value transfer-ownership="none">
2662341073 <doc xml:space="preserve"
2662441074 filename="src/adw-view-stack.c"
26625- line="1510">the [class@ViewStackPage] for @child</doc>
41075+ line="1630">the [class@ViewStackPage] for @child</doc>
2662641076 <type name="ViewStackPage" c:type="AdwViewStackPage*"/>
2662741077 </return-value>
2662841078 <parameters>
2662941079 <instance-parameter name="self" transfer-ownership="none">
2663041080 <doc xml:space="preserve"
2663141081 filename="src/adw-view-stack.c"
26632- line="1505">a view stack</doc>
41082+ line="1625">a view stack</doc>
2663341083 <type name="ViewStack" c:type="AdwViewStack*"/>
2663441084 </instance-parameter>
2663541085 <parameter name="child" transfer-ownership="none">
2663641086 <doc xml:space="preserve"
2663741087 filename="src/adw-view-stack.c"
26638- line="1506">the widget to add</doc>
41088+ line="1626">the widget to add</doc>
2663941089 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2664041090 </parameter>
2664141091 </parameters>
@@ -26643,27 +41093,27 @@ which are the accessible parent objects of the child widgets.</doc>
2664341093 <method name="add_named" c:identifier="adw_view_stack_add_named">
2664441094 <doc xml:space="preserve"
2664541095 filename="src/adw-view-stack.c"
26646- line="1522">Adds a child to @self.
41096+ line="1643">Adds a child to @self.
2664741097
2664841098 The child is identified by the @name.</doc>
2664941099 <source-position filename="src/adw-view-stack.h" line="87"/>
2665041100 <return-value transfer-ownership="none">
2665141101 <doc xml:space="preserve"
2665241102 filename="src/adw-view-stack.c"
26653- line="1532">the `AdwViewStackPage` for @child</doc>
41103+ line="1653">the `AdwViewStackPage` for @child</doc>
2665441104 <type name="ViewStackPage" c:type="AdwViewStackPage*"/>
2665541105 </return-value>
2665641106 <parameters>
2665741107 <instance-parameter name="self" transfer-ownership="none">
2665841108 <doc xml:space="preserve"
2665941109 filename="src/adw-view-stack.c"
26660- line="1524">a view stack</doc>
41110+ line="1645">a view stack</doc>
2666141111 <type name="ViewStack" c:type="AdwViewStack*"/>
2666241112 </instance-parameter>
2666341113 <parameter name="child" transfer-ownership="none">
2666441114 <doc xml:space="preserve"
2666541115 filename="src/adw-view-stack.c"
26666- line="1525">the widget to add</doc>
41116+ line="1646">the widget to add</doc>
2666741117 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2666841118 </parameter>
2666941119 <parameter name="name"
@@ -26672,7 +41122,7 @@ The child is identified by the @name.</doc>
2667241122 allow-none="1">
2667341123 <doc xml:space="preserve"
2667441124 filename="src/adw-view-stack.c"
26675- line="1526">the name for @child</doc>
41125+ line="1647">the name for @child</doc>
2667641126 <type name="utf8" c:type="const char*"/>
2667741127 </parameter>
2667841128 </parameters>
@@ -26680,7 +41130,7 @@ The child is identified by the @name.</doc>
2668041130 <method name="add_titled" c:identifier="adw_view_stack_add_titled">
2668141131 <doc xml:space="preserve"
2668241132 filename="src/adw-view-stack.c"
26683- line="1545">Adds a child to @self.
41133+ line="1667">Adds a child to @self.
2668441134
2668541135 The child is identified by the @name. The @title will be used by
2668641136 [class@ViewSwitcher] to represent @child, so it should be short.</doc>
@@ -26688,20 +41138,20 @@ The child is identified by the @name. The @title will be used by
2668841138 <return-value transfer-ownership="none">
2668941139 <doc xml:space="preserve"
2669041140 filename="src/adw-view-stack.c"
26691- line="1557">the `AdwViewStackPage` for @child</doc>
41141+ line="1679">the `AdwViewStackPage` for @child</doc>
2669241142 <type name="ViewStackPage" c:type="AdwViewStackPage*"/>
2669341143 </return-value>
2669441144 <parameters>
2669541145 <instance-parameter name="self" transfer-ownership="none">
2669641146 <doc xml:space="preserve"
2669741147 filename="src/adw-view-stack.c"
26698- line="1547">a view stack</doc>
41148+ line="1669">a view stack</doc>
2669941149 <type name="ViewStack" c:type="AdwViewStack*"/>
2670041150 </instance-parameter>
2670141151 <parameter name="child" transfer-ownership="none">
2670241152 <doc xml:space="preserve"
2670341153 filename="src/adw-view-stack.c"
26704- line="1548">the widget to add</doc>
41154+ line="1670">the widget to add</doc>
2670541155 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2670641156 </parameter>
2670741157 <parameter name="name"
@@ -26710,13 +41160,13 @@ The child is identified by the @name. The @title will be used by
2671041160 allow-none="1">
2671141161 <doc xml:space="preserve"
2671241162 filename="src/adw-view-stack.c"
26713- line="1549">the name for @child</doc>
41163+ line="1671">the name for @child</doc>
2671441164 <type name="utf8" c:type="const char*"/>
2671541165 </parameter>
2671641166 <parameter name="title" transfer-ownership="none">
2671741167 <doc xml:space="preserve"
2671841168 filename="src/adw-view-stack.c"
26719- line="1550">a human-readable title for @child</doc>
41169+ line="1672">a human-readable title for @child</doc>
2672041170 <type name="utf8" c:type="const char*"/>
2672141171 </parameter>
2672241172 </parameters>
@@ -26726,7 +41176,7 @@ The child is identified by the @name. The @title will be used by
2672641176 version="1.2">
2672741177 <doc xml:space="preserve"
2672841178 filename="src/adw-view-stack.c"
26729- line="1571">Adds a child to @self.
41179+ line="1694">Adds a child to @self.
2673041180
2673141181 The child is identified by the @name. The @title and @icon_name will be used
2673241182 by [class@ViewSwitcher] to represent @child.</doc>
@@ -26734,20 +41184,20 @@ by [class@ViewSwitcher] to represent @child.</doc>
2673441184 <return-value transfer-ownership="none">
2673541185 <doc xml:space="preserve"
2673641186 filename="src/adw-view-stack.c"
26737- line="1584">the `AdwViewStackPage` for @child</doc>
41187+ line="1707">the `AdwViewStackPage` for @child</doc>
2673841188 <type name="ViewStackPage" c:type="AdwViewStackPage*"/>
2673941189 </return-value>
2674041190 <parameters>
2674141191 <instance-parameter name="self" transfer-ownership="none">
2674241192 <doc xml:space="preserve"
2674341193 filename="src/adw-view-stack.c"
26744- line="1573">a view stack</doc>
41194+ line="1696">a view stack</doc>
2674541195 <type name="ViewStack" c:type="AdwViewStack*"/>
2674641196 </instance-parameter>
2674741197 <parameter name="child" transfer-ownership="none">
2674841198 <doc xml:space="preserve"
2674941199 filename="src/adw-view-stack.c"
26750- line="1574">the widget to add</doc>
41200+ line="1697">the widget to add</doc>
2675141201 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2675241202 </parameter>
2675341203 <parameter name="name"
@@ -26756,19 +41206,19 @@ by [class@ViewSwitcher] to represent @child.</doc>
2675641206 allow-none="1">
2675741207 <doc xml:space="preserve"
2675841208 filename="src/adw-view-stack.c"
26759- line="1575">the name for @child</doc>
41209+ line="1698">the name for @child</doc>
2676041210 <type name="utf8" c:type="const char*"/>
2676141211 </parameter>
2676241212 <parameter name="title" transfer-ownership="none">
2676341213 <doc xml:space="preserve"
2676441214 filename="src/adw-view-stack.c"
26765- line="1576">a human-readable title for @child</doc>
41215+ line="1699">a human-readable title for @child</doc>
2676641216 <type name="utf8" c:type="const char*"/>
2676741217 </parameter>
2676841218 <parameter name="icon_name" transfer-ownership="none">
2676941219 <doc xml:space="preserve"
2677041220 filename="src/adw-view-stack.c"
26771- line="1577">an icon name for @child</doc>
41221+ line="1700">an icon name for @child</doc>
2677241222 <type name="utf8" c:type="const char*"/>
2677341223 </parameter>
2677441224 </parameters>
@@ -26777,25 +41227,25 @@ by [class@ViewSwitcher] to represent @child.</doc>
2677741227 c:identifier="adw_view_stack_get_child_by_name">
2677841228 <doc xml:space="preserve"
2677941229 filename="src/adw-view-stack.c"
26780- line="1651">Finds the child with @name in @self.</doc>
41230+ line="1775">Finds the child with @name in @self.</doc>
2678141231 <source-position filename="src/adw-view-stack.h" line="111"/>
2678241232 <return-value transfer-ownership="none" nullable="1">
2678341233 <doc xml:space="preserve"
2678441234 filename="src/adw-view-stack.c"
26785- line="1658">the requested child</doc>
41235+ line="1782">the requested child</doc>
2678641236 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2678741237 </return-value>
2678841238 <parameters>
2678941239 <instance-parameter name="self" transfer-ownership="none">
2679041240 <doc xml:space="preserve"
2679141241 filename="src/adw-view-stack.c"
26792- line="1653">a view stack</doc>
41242+ line="1777">a view stack</doc>
2679341243 <type name="ViewStack" c:type="AdwViewStack*"/>
2679441244 </instance-parameter>
2679541245 <parameter name="name" transfer-ownership="none">
2679641246 <doc xml:space="preserve"
2679741247 filename="src/adw-view-stack.c"
26798- line="1654">the name of the child to find</doc>
41248+ line="1778">the name of the child to find</doc>
2679941249 <type name="utf8" c:type="const char*"/>
2680041250 </parameter>
2680141251 </parameters>
@@ -26803,22 +41253,21 @@ by [class@ViewSwitcher] to represent @child.</doc>
2680341253 <method name="get_hhomogeneous"
2680441254 c:identifier="adw_view_stack_get_hhomogeneous"
2680541255 glib:get-property="hhomogeneous">
26806- <attribute name="org.gtk.Method.get_property" value="hhomogeneous"/>
2680741256 <doc xml:space="preserve"
2680841257 filename="src/adw-view-stack.c"
26809- line="1766">Gets whether @self is horizontally homogeneous.</doc>
41258+ line="1890">Gets whether @self is horizontally homogeneous.</doc>
2681041259 <source-position filename="src/adw-view-stack.h" line="127"/>
2681141260 <return-value transfer-ownership="none">
2681241261 <doc xml:space="preserve"
2681341262 filename="src/adw-view-stack.c"
26814- line="1772">whether @self is horizontally homogeneous</doc>
41263+ line="1896">whether @self is horizontally homogeneous</doc>
2681541264 <type name="gboolean" c:type="gboolean"/>
2681641265 </return-value>
2681741266 <parameters>
2681841267 <instance-parameter name="self" transfer-ownership="none">
2681941268 <doc xml:space="preserve"
2682041269 filename="src/adw-view-stack.c"
26821- line="1768">a view stack</doc>
41270+ line="1892">a view stack</doc>
2682241271 <type name="ViewStack" c:type="AdwViewStack*"/>
2682341272 </instance-parameter>
2682441273 </parameters>
@@ -26826,25 +41275,25 @@ by [class@ViewSwitcher] to represent @child.</doc>
2682641275 <method name="get_page" c:identifier="adw_view_stack_get_page">
2682741276 <doc xml:space="preserve"
2682841277 filename="src/adw-view-stack.c"
26829- line="1632">Gets the [class@ViewStackPage] object for @child.</doc>
41278+ line="1756">Gets the [class@ViewStackPage] object for @child.</doc>
2683041279 <source-position filename="src/adw-view-stack.h" line="107"/>
2683141280 <return-value transfer-ownership="none">
2683241281 <doc xml:space="preserve"
2683341282 filename="src/adw-view-stack.c"
26834- line="1639">the page object for @child</doc>
41283+ line="1763">the page object for @child</doc>
2683541284 <type name="ViewStackPage" c:type="AdwViewStackPage*"/>
2683641285 </return-value>
2683741286 <parameters>
2683841287 <instance-parameter name="self" transfer-ownership="none">
2683941288 <doc xml:space="preserve"
2684041289 filename="src/adw-view-stack.c"
26841- line="1634">a view stack</doc>
41290+ line="1758">a view stack</doc>
2684241291 <type name="ViewStack" c:type="AdwViewStack*"/>
2684341292 </instance-parameter>
2684441293 <parameter name="child" transfer-ownership="none">
2684541294 <doc xml:space="preserve"
2684641295 filename="src/adw-view-stack.c"
26847- line="1635">a child of @self</doc>
41296+ line="1759">a child of @self</doc>
2684841297 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2684941298 </parameter>
2685041299 </parameters>
@@ -26852,10 +41301,9 @@ by [class@ViewSwitcher] to represent @child.</doc>
2685241301 <method name="get_pages"
2685341302 c:identifier="adw_view_stack_get_pages"
2685441303 glib:get-property="pages">
26855- <attribute name="org.gtk.Method.get_property" value="pages"/>
2685641304 <doc xml:space="preserve"
2685741305 filename="src/adw-view-stack.c"
26858- line="1862">Returns a [iface@Gio.ListModel] that contains the pages of the stack.
41306+ line="1986">Returns a [iface@Gio.ListModel] that contains the pages of the stack.
2685941307
2686041308 This can be used to keep an up-to-date view. The model also implements
2686141309 [iface@Gtk.SelectionModel] and can be used to track and change the visible
@@ -26864,14 +41312,14 @@ page.</doc>
2686441312 <return-value transfer-ownership="full">
2686541313 <doc xml:space="preserve"
2686641314 filename="src/adw-view-stack.c"
26867- line="1872">a `GtkSelectionModel` for the stack's children</doc>
41315+ line="1996">a `GtkSelectionModel` for the stack's children</doc>
2686841316 <type name="Gtk.SelectionModel" c:type="GtkSelectionModel*"/>
2686941317 </return-value>
2687041318 <parameters>
2687141319 <instance-parameter name="self" transfer-ownership="none">
2687241320 <doc xml:space="preserve"
2687341321 filename="src/adw-view-stack.c"
26874- line="1864">a view stack</doc>
41322+ line="1988">a view stack</doc>
2687541323 <type name="ViewStack" c:type="AdwViewStack*"/>
2687641324 </instance-parameter>
2687741325 </parameters>
@@ -26879,22 +41327,21 @@ page.</doc>
2687941327 <method name="get_vhomogeneous"
2688041328 c:identifier="adw_view_stack_get_vhomogeneous"
2688141329 glib:get-property="vhomogeneous">
26882- <attribute name="org.gtk.Method.get_property" value="vhomogeneous"/>
2688341330 <doc xml:space="preserve"
2688441331 filename="src/adw-view-stack.c"
26885- line="1814">Gets whether @self is vertically homogeneous.</doc>
41332+ line="1938">Gets whether @self is vertically homogeneous.</doc>
2688641333 <source-position filename="src/adw-view-stack.h" line="133"/>
2688741334 <return-value transfer-ownership="none">
2688841335 <doc xml:space="preserve"
2688941336 filename="src/adw-view-stack.c"
26890- line="1820">whether @self is vertically homogeneous</doc>
41337+ line="1944">whether @self is vertically homogeneous</doc>
2689141338 <type name="gboolean" c:type="gboolean"/>
2689241339 </return-value>
2689341340 <parameters>
2689441341 <instance-parameter name="self" transfer-ownership="none">
2689541342 <doc xml:space="preserve"
2689641343 filename="src/adw-view-stack.c"
26897- line="1816">a view stack</doc>
41344+ line="1940">a view stack</doc>
2689841345 <type name="ViewStack" c:type="AdwViewStack*"/>
2689941346 </instance-parameter>
2690041347 </parameters>
@@ -26902,22 +41349,21 @@ page.</doc>
2690241349 <method name="get_visible_child"
2690341350 c:identifier="adw_view_stack_get_visible_child"
2690441351 glib:get-property="visible-child">
26905- <attribute name="org.gtk.Method.get_property" value="visible-child"/>
2690641352 <doc xml:space="preserve"
2690741353 filename="src/adw-view-stack.c"
26908- line="1674">Gets the currently visible child of @self, .</doc>
41354+ line="1798">Gets the currently visible child of @self.</doc>
2690941355 <source-position filename="src/adw-view-stack.h" line="115"/>
2691041356 <return-value transfer-ownership="none" nullable="1">
2691141357 <doc xml:space="preserve"
2691241358 filename="src/adw-view-stack.c"
26913- line="1680">the visible child</doc>
41359+ line="1804">the visible child</doc>
2691441360 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2691541361 </return-value>
2691641362 <parameters>
2691741363 <instance-parameter name="self" transfer-ownership="none">
2691841364 <doc xml:space="preserve"
2691941365 filename="src/adw-view-stack.c"
26920- line="1676">a view stack</doc>
41366+ line="1800">a view stack</doc>
2692141367 <type name="ViewStack" c:type="AdwViewStack*"/>
2692241368 </instance-parameter>
2692341369 </parameters>
@@ -26925,23 +41371,21 @@ page.</doc>
2692541371 <method name="get_visible_child_name"
2692641372 c:identifier="adw_view_stack_get_visible_child_name"
2692741373 glib:get-property="visible-child-name">
26928- <attribute name="org.gtk.Method.get_property"
26929- value="visible-child-name"/>
2693041374 <doc xml:space="preserve"
2693141375 filename="src/adw-view-stack.c"
26932- line="1718">Returns the name of the currently visible child of @self.</doc>
41376+ line="1842">Returns the name of the currently visible child of @self.</doc>
2693341377 <source-position filename="src/adw-view-stack.h" line="121"/>
2693441378 <return-value transfer-ownership="none" nullable="1">
2693541379 <doc xml:space="preserve"
2693641380 filename="src/adw-view-stack.c"
26937- line="1724">the name of the visible child</doc>
41381+ line="1848">the name of the visible child</doc>
2693841382 <type name="utf8" c:type="const char*"/>
2693941383 </return-value>
2694041384 <parameters>
2694141385 <instance-parameter name="self" transfer-ownership="none">
2694241386 <doc xml:space="preserve"
2694341387 filename="src/adw-view-stack.c"
26944- line="1720">a view stack</doc>
41388+ line="1844">a view stack</doc>
2694541389 <type name="ViewStack" c:type="AdwViewStack*"/>
2694641390 </instance-parameter>
2694741391 </parameters>
@@ -26949,7 +41393,7 @@ page.</doc>
2694941393 <method name="remove" c:identifier="adw_view_stack_remove">
2695041394 <doc xml:space="preserve"
2695141395 filename="src/adw-view-stack.c"
26952- line="1601">Removes a child widget from @self.</doc>
41396+ line="1725">Removes a child widget from @self.</doc>
2695341397 <source-position filename="src/adw-view-stack.h" line="103"/>
2695441398 <return-value transfer-ownership="none">
2695541399 <type name="none" c:type="void"/>
@@ -26958,13 +41402,13 @@ page.</doc>
2695841402 <instance-parameter name="self" transfer-ownership="none">
2695941403 <doc xml:space="preserve"
2696041404 filename="src/adw-view-stack.c"
26961- line="1603">a view stack</doc>
41405+ line="1727">a view stack</doc>
2696241406 <type name="ViewStack" c:type="AdwViewStack*"/>
2696341407 </instance-parameter>
2696441408 <parameter name="child" transfer-ownership="none">
2696541409 <doc xml:space="preserve"
2696641410 filename="src/adw-view-stack.c"
26967- line="1604">the child to remove</doc>
41411+ line="1728">the child to remove</doc>
2696841412 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2696941413 </parameter>
2697041414 </parameters>
@@ -26972,10 +41416,9 @@ page.</doc>
2697241416 <method name="set_hhomogeneous"
2697341417 c:identifier="adw_view_stack_set_hhomogeneous"
2697441418 glib:set-property="hhomogeneous">
26975- <attribute name="org.gtk.Method.set_property" value="hhomogeneous"/>
2697641419 <doc xml:space="preserve"
2697741420 filename="src/adw-view-stack.c"
26978- line="1782">Sets @self to be horizontally homogeneous or not.
41421+ line="1906">Sets @self to be horizontally homogeneous or not.
2697941422
2698041423 If the stack is horizontally homogeneous, it allocates the same width for
2698141424 all children.
@@ -26990,13 +41433,13 @@ visible.</doc>
2699041433 <instance-parameter name="self" transfer-ownership="none">
2699141434 <doc xml:space="preserve"
2699241435 filename="src/adw-view-stack.c"
26993- line="1784">a view stack</doc>
41436+ line="1908">a view stack</doc>
2699441437 <type name="ViewStack" c:type="AdwViewStack*"/>
2699541438 </instance-parameter>
2699641439 <parameter name="hhomogeneous" transfer-ownership="none">
2699741440 <doc xml:space="preserve"
2699841441 filename="src/adw-view-stack.c"
26999- line="1785">whether to make @self horizontally homogeneous</doc>
41442+ line="1909">whether to make @self horizontally homogeneous</doc>
2700041443 <type name="gboolean" c:type="gboolean"/>
2700141444 </parameter>
2700241445 </parameters>
@@ -27004,10 +41447,9 @@ visible.</doc>
2700441447 <method name="set_vhomogeneous"
2700541448 c:identifier="adw_view_stack_set_vhomogeneous"
2700641449 glib:set-property="vhomogeneous">
27007- <attribute name="org.gtk.Method.set_property" value="vhomogeneous"/>
2700841450 <doc xml:space="preserve"
2700941451 filename="src/adw-view-stack.c"
27010- line="1830">Sets @self to be vertically homogeneous or not.
41452+ line="1954">Sets @self to be vertically homogeneous or not.
2701141453
2701241454 If the stack is vertically homogeneous, it allocates the same height for
2701341455 all children.
@@ -27022,13 +41464,13 @@ visible.</doc>
2702241464 <instance-parameter name="self" transfer-ownership="none">
2702341465 <doc xml:space="preserve"
2702441466 filename="src/adw-view-stack.c"
27025- line="1832">a view stack</doc>
41467+ line="1956">a view stack</doc>
2702641468 <type name="ViewStack" c:type="AdwViewStack*"/>
2702741469 </instance-parameter>
2702841470 <parameter name="vhomogeneous" transfer-ownership="none">
2702941471 <doc xml:space="preserve"
2703041472 filename="src/adw-view-stack.c"
27031- line="1833">whether to make @self vertically homogeneous</doc>
41473+ line="1957">whether to make @self vertically homogeneous</doc>
2703241474 <type name="gboolean" c:type="gboolean"/>
2703341475 </parameter>
2703441476 </parameters>
@@ -27036,10 +41478,9 @@ visible.</doc>
2703641478 <method name="set_visible_child"
2703741479 c:identifier="adw_view_stack_set_visible_child"
2703841480 glib:set-property="visible-child">
27039- <attribute name="org.gtk.Method.set_property" value="visible-child"/>
2704041481 <doc xml:space="preserve"
2704141482 filename="src/adw-view-stack.c"
27042- line="1690">Makes @child the visible child of @self.</doc>
41483+ line="1814">Makes @child the visible child of @self.</doc>
2704341484 <source-position filename="src/adw-view-stack.h" line="117"/>
2704441485 <return-value transfer-ownership="none">
2704541486 <type name="none" c:type="void"/>
@@ -27048,13 +41489,13 @@ visible.</doc>
2704841489 <instance-parameter name="self" transfer-ownership="none">
2704941490 <doc xml:space="preserve"
2705041491 filename="src/adw-view-stack.c"
27051- line="1692">a view stack</doc>
41492+ line="1816">a view stack</doc>
2705241493 <type name="ViewStack" c:type="AdwViewStack*"/>
2705341494 </instance-parameter>
2705441495 <parameter name="child" transfer-ownership="none">
2705541496 <doc xml:space="preserve"
2705641497 filename="src/adw-view-stack.c"
27057- line="1693">a child of @self</doc>
41498+ line="1817">a child of @self</doc>
2705841499 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2705941500 </parameter>
2706041501 </parameters>
@@ -27062,11 +41503,9 @@ visible.</doc>
2706241503 <method name="set_visible_child_name"
2706341504 c:identifier="adw_view_stack_set_visible_child_name"
2706441505 glib:set-property="visible-child-name">
27065- <attribute name="org.gtk.Method.set_property"
27066- value="visible-child-name"/>
2706741506 <doc xml:space="preserve"
2706841507 filename="src/adw-view-stack.c"
27069- line="1734">Makes the child with @name visible.
41508+ line="1858">Makes the child with @name visible.
2707041509
2707141510 See [property@ViewStack:visible-child].</doc>
2707241511 <source-position filename="src/adw-view-stack.h" line="123"/>
@@ -27077,13 +41516,13 @@ See [property@ViewStack:visible-child].</doc>
2707741516 <instance-parameter name="self" transfer-ownership="none">
2707841517 <doc xml:space="preserve"
2707941518 filename="src/adw-view-stack.c"
27080- line="1736">a view stack</doc>
41519+ line="1860">a view stack</doc>
2708141520 <type name="ViewStack" c:type="AdwViewStack*"/>
2708241521 </instance-parameter>
2708341522 <parameter name="name" transfer-ownership="none">
2708441523 <doc xml:space="preserve"
2708541524 filename="src/adw-view-stack.c"
27086- line="1737">the name of the child</doc>
41525+ line="1861">the name of the child</doc>
2708741526 <type name="utf8" c:type="const char*"/>
2708841527 </parameter>
2708941528 </parameters>
@@ -27094,13 +41533,9 @@ See [property@ViewStack:visible-child].</doc>
2709441533 setter="set_hhomogeneous"
2709541534 getter="get_hhomogeneous"
2709641535 default-value="TRUE">
27097- <attribute name="org.gtk.Property.get"
27098- value="adw_view_stack_get_hhomogeneous"/>
27099- <attribute name="org.gtk.Property.set"
27100- value="adw_view_stack_set_hhomogeneous"/>
2710141536 <doc xml:space="preserve"
2710241537 filename="src/adw-view-stack.c"
27103- line="1042">Whether the stack is horizontally homogeneous.
41538+ line="1171">Whether the stack is horizontally homogeneous.
2710441539
2710541540 If the stack is horizontally homogeneous, it allocates the same width for
2710641541 all children.
@@ -27110,11 +41545,9 @@ visible.</doc>
2711041545 <type name="gboolean" c:type="gboolean"/>
2711141546 </property>
2711241547 <property name="pages" transfer-ownership="none" getter="get_pages">
27113- <attribute name="org.gtk.Property.get"
27114- value="adw_view_stack_get_pages"/>
2711541548 <doc xml:space="preserve"
2711641549 filename="src/adw-view-stack.c"
27117- line="1096">A selection model with the stack's pages.
41550+ line="1225">A selection model with the stack's pages.
2711841551
2711941552 This can be used to keep an up-to-date view. The model also implements
2712041553 [iface@Gtk.SelectionModel] and can be used to track and change the visible
@@ -27127,13 +41560,9 @@ page.</doc>
2712741560 setter="set_vhomogeneous"
2712841561 getter="get_vhomogeneous"
2712941562 default-value="TRUE">
27130- <attribute name="org.gtk.Property.get"
27131- value="adw_view_stack_get_vhomogeneous"/>
27132- <attribute name="org.gtk.Property.set"
27133- value="adw_view_stack_set_vhomogeneous"/>
2713441563 <doc xml:space="preserve"
2713541564 filename="src/adw-view-stack.c"
27136- line="1058">Whether the stack is vertically homogeneous.
41565+ line="1187">Whether the stack is vertically homogeneous.
2713741566
2713841567 If the stack is vertically homogeneous, it allocates the same height for
2713941568 all children.
@@ -27147,13 +41576,9 @@ visible.</doc>
2714741576 transfer-ownership="none"
2714841577 setter="set_visible_child"
2714941578 getter="get_visible_child">
27150- <attribute name="org.gtk.Property.get"
27151- value="adw_view_stack_get_visible_child"/>
27152- <attribute name="org.gtk.Property.set"
27153- value="adw_view_stack_set_visible_child"/>
2715441579 <doc xml:space="preserve"
2715541580 filename="src/adw-view-stack.c"
27156- line="1074">The widget currently visible in the stack.</doc>
41581+ line="1203">The widget currently visible in the stack.</doc>
2715741582 <type name="Gtk.Widget"/>
2715841583 </property>
2715941584 <property name="visible-child-name"
@@ -27162,13 +41587,9 @@ visible.</doc>
2716241587 setter="set_visible_child_name"
2716341588 getter="get_visible_child_name"
2716441589 default-value="NULL">
27165- <attribute name="org.gtk.Property.get"
27166- value="adw_view_stack_get_visible_child_name"/>
27167- <attribute name="org.gtk.Property.set"
27168- value="adw_view_stack_set_visible_child_name"/>
2716941590 <doc xml:space="preserve"
2717041591 filename="src/adw-view-stack.c"
27171- line="1084">The name of the widget currently visible in the stack.
41592+ line="1213">The name of the widget currently visible in the stack.
2717241593
2717341594 See [property@ViewStack:visible-child].</doc>
2717441595 <type name="utf8" c:type="gchar*"/>
@@ -27198,22 +41619,21 @@ See [property@ViewStack:visible-child].</doc>
2719841619 <method name="get_badge_number"
2719941620 c:identifier="adw_view_stack_page_get_badge_number"
2720041621 glib:get-property="badge-number">
27201- <attribute name="org.gtk.Method.get_property" value="badge-number"/>
2720241622 <doc xml:space="preserve"
2720341623 filename="src/adw-view-stack.c"
27204- line="1400">Gets the badge number for this page.</doc>
41624+ line="1520">Gets the badge number for this page.</doc>
2720541625 <source-position filename="src/adw-view-stack.h" line="64"/>
2720641626 <return-value transfer-ownership="none">
2720741627 <doc xml:space="preserve"
2720841628 filename="src/adw-view-stack.c"
27209- line="1406">the badge number for this page</doc>
41629+ line="1526">the badge number for this page</doc>
2721041630 <type name="guint" c:type="guint"/>
2721141631 </return-value>
2721241632 <parameters>
2721341633 <instance-parameter name="self" transfer-ownership="none">
2721441634 <doc xml:space="preserve"
2721541635 filename="src/adw-view-stack.c"
27216- line="1402">a view stack page</doc>
41636+ line="1522">a view stack page</doc>
2721741637 <type name="ViewStackPage" c:type="AdwViewStackPage*"/>
2721841638 </instance-parameter>
2721941639 </parameters>
@@ -27221,22 +41641,21 @@ See [property@ViewStack:visible-child].</doc>
2722141641 <method name="get_child"
2722241642 c:identifier="adw_view_stack_page_get_child"
2722341643 glib:get-property="child">
27224- <attribute name="org.gtk.Method.get_property" value="child"/>
2722541644 <doc xml:space="preserve"
2722641645 filename="src/adw-view-stack.c"
27227- line="1164">Gets the stack child to which @self belongs.</doc>
41646+ line="1293">Gets the stack child to which @self belongs.</doc>
2722841647 <source-position filename="src/adw-view-stack.h" line="31"/>
2722941648 <return-value transfer-ownership="none">
2723041649 <doc xml:space="preserve"
2723141650 filename="src/adw-view-stack.c"
27232- line="1170">the child to which @self belongs</doc>
41651+ line="1299">the child to which @self belongs</doc>
2723341652 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2723441653 </return-value>
2723541654 <parameters>
2723641655 <instance-parameter name="self" transfer-ownership="none">
2723741656 <doc xml:space="preserve"
2723841657 filename="src/adw-view-stack.c"
27239- line="1166">a view stack page</doc>
41658+ line="1295">a view stack page</doc>
2724041659 <type name="ViewStackPage" c:type="AdwViewStackPage*"/>
2724141660 </instance-parameter>
2724241661 </parameters>
@@ -27244,22 +41663,21 @@ See [property@ViewStack:visible-child].</doc>
2724441663 <method name="get_icon_name"
2724541664 c:identifier="adw_view_stack_page_get_icon_name"
2724641665 glib:get-property="icon-name">
27247- <attribute name="org.gtk.Method.get_property" value="icon-name"/>
2724841666 <doc xml:space="preserve"
2724941667 filename="src/adw-view-stack.c"
27250- line="1321">Gets the icon name of the page.</doc>
41668+ line="1444">Gets the icon name of the page.</doc>
2725141669 <source-position filename="src/adw-view-stack.h" line="52"/>
2725241670 <return-value transfer-ownership="none" nullable="1">
2725341671 <doc xml:space="preserve"
2725441672 filename="src/adw-view-stack.c"
27255- line="1327">the icon name of the page</doc>
41673+ line="1450">the icon name of the page</doc>
2725641674 <type name="utf8" c:type="const char*"/>
2725741675 </return-value>
2725841676 <parameters>
2725941677 <instance-parameter name="self" transfer-ownership="none">
2726041678 <doc xml:space="preserve"
2726141679 filename="src/adw-view-stack.c"
27262- line="1323">a view stack page</doc>
41680+ line="1446">a view stack page</doc>
2726341681 <type name="ViewStackPage" c:type="AdwViewStackPage*"/>
2726441682 </instance-parameter>
2726541683 </parameters>
@@ -27267,22 +41685,21 @@ See [property@ViewStack:visible-child].</doc>
2726741685 <method name="get_name"
2726841686 c:identifier="adw_view_stack_page_get_name"
2726941687 glib:get-property="name">
27270- <attribute name="org.gtk.Method.get_property" value="name"/>
2727141688 <doc xml:space="preserve"
2727241689 filename="src/adw-view-stack.c"
27273- line="1180">Gets the name of the page.</doc>
41690+ line="1309">Gets the name of the page.</doc>
2727441691 <source-position filename="src/adw-view-stack.h" line="34"/>
2727541692 <return-value transfer-ownership="none" nullable="1">
2727641693 <doc xml:space="preserve"
2727741694 filename="src/adw-view-stack.c"
27278- line="1186">the name of the page</doc>
41695+ line="1315">the name of the page</doc>
2727941696 <type name="utf8" c:type="const char*"/>
2728041697 </return-value>
2728141698 <parameters>
2728241699 <instance-parameter name="self" transfer-ownership="none">
2728341700 <doc xml:space="preserve"
2728441701 filename="src/adw-view-stack.c"
27285- line="1182">a view stack page</doc>
41702+ line="1311">a view stack page</doc>
2728641703 <type name="ViewStackPage" c:type="AdwViewStackPage*"/>
2728741704 </instance-parameter>
2728841705 </parameters>
@@ -27290,22 +41707,21 @@ See [property@ViewStack:visible-child].</doc>
2729041707 <method name="get_needs_attention"
2729141708 c:identifier="adw_view_stack_page_get_needs_attention"
2729241709 glib:get-property="needs-attention">
27293- <attribute name="org.gtk.Method.get_property" value="needs-attention"/>
2729441710 <doc xml:space="preserve"
2729541711 filename="src/adw-view-stack.c"
27296- line="1359">Gets whether the page requires the user attention.</doc>
41712+ line="1479">Gets whether the page requires the user attention.</doc>
2729741713 <source-position filename="src/adw-view-stack.h" line="58"/>
2729841714 <return-value transfer-ownership="none">
2729941715 <doc xml:space="preserve"
2730041716 filename="src/adw-view-stack.c"
27301- line="1365">whether the page needs attention</doc>
41717+ line="1485">whether the page needs attention</doc>
2730241718 <type name="gboolean" c:type="gboolean"/>
2730341719 </return-value>
2730441720 <parameters>
2730541721 <instance-parameter name="self" transfer-ownership="none">
2730641722 <doc xml:space="preserve"
2730741723 filename="src/adw-view-stack.c"
27308- line="1361">a view stack page</doc>
41724+ line="1481">a view stack page</doc>
2730941725 <type name="ViewStackPage" c:type="AdwViewStackPage*"/>
2731041726 </instance-parameter>
2731141727 </parameters>
@@ -27313,22 +41729,21 @@ See [property@ViewStack:visible-child].</doc>
2731341729 <method name="get_title"
2731441730 c:identifier="adw_view_stack_page_get_title"
2731541731 glib:get-property="title">
27316- <attribute name="org.gtk.Method.get_property" value="title"/>
2731741732 <doc xml:space="preserve"
2731841733 filename="src/adw-view-stack.c"
27319- line="1244">Gets the page title.</doc>
41734+ line="1370">Gets the page title.</doc>
2732041735 <source-position filename="src/adw-view-stack.h" line="40"/>
2732141736 <return-value transfer-ownership="none" nullable="1">
2732241737 <doc xml:space="preserve"
2732341738 filename="src/adw-view-stack.c"
27324- line="1250">the page title</doc>
41739+ line="1376">the page title</doc>
2732541740 <type name="utf8" c:type="const char*"/>
2732641741 </return-value>
2732741742 <parameters>
2732841743 <instance-parameter name="self" transfer-ownership="none">
2732941744 <doc xml:space="preserve"
2733041745 filename="src/adw-view-stack.c"
27331- line="1246">a view stack page</doc>
41746+ line="1372">a view stack page</doc>
2733241747 <type name="ViewStackPage" c:type="AdwViewStackPage*"/>
2733341748 </instance-parameter>
2733441749 </parameters>
@@ -27336,22 +41751,21 @@ See [property@ViewStack:visible-child].</doc>
2733641751 <method name="get_use_underline"
2733741752 c:identifier="adw_view_stack_page_get_use_underline"
2733841753 glib:get-property="use-underline">
27339- <attribute name="org.gtk.Method.get_property" value="use-underline"/>
2734041754 <doc xml:space="preserve"
2734141755 filename="src/adw-view-stack.c"
27342- line="1286">Gets whether underlines in the page title indicate mnemonics.</doc>
41756+ line="1409">Gets whether underlines in the page title indicate mnemonics.</doc>
2734341757 <source-position filename="src/adw-view-stack.h" line="46"/>
2734441758 <return-value transfer-ownership="none">
2734541759 <doc xml:space="preserve"
2734641760 filename="src/adw-view-stack.c"
27347- line="1292">whether underlines in the page title indicate mnemonics</doc>
41761+ line="1415">whether underlines in the page title indicate mnemonics</doc>
2734841762 <type name="gboolean" c:type="gboolean"/>
2734941763 </return-value>
2735041764 <parameters>
2735141765 <instance-parameter name="self" transfer-ownership="none">
2735241766 <doc xml:space="preserve"
2735341767 filename="src/adw-view-stack.c"
27354- line="1288">a view stack page</doc>
41768+ line="1411">a view stack page</doc>
2735541769 <type name="ViewStackPage" c:type="AdwViewStackPage*"/>
2735641770 </instance-parameter>
2735741771 </parameters>
@@ -27359,10 +41773,9 @@ See [property@ViewStack:visible-child].</doc>
2735941773 <method name="get_visible"
2736041774 c:identifier="adw_view_stack_page_get_visible"
2736141775 glib:get-property="visible">
27362- <attribute name="org.gtk.Method.get_property" value="visible"/>
2736341776 <doc xml:space="preserve"
2736441777 filename="src/adw-view-stack.c"
27365- line="1442">Gets whether @self is visible in its `AdwViewStack`.
41778+ line="1562">Gets whether @self is visible in its `AdwViewStack`.
2736641779
2736741780 This is independent from the [property@Gtk.Widget:visible]
2736841781 property of its widget.</doc>
@@ -27370,14 +41783,14 @@ property of its widget.</doc>
2737041783 <return-value transfer-ownership="none">
2737141784 <doc xml:space="preserve"
2737241785 filename="src/adw-view-stack.c"
27373- line="1451">whether @self is visible</doc>
41786+ line="1571">whether @self is visible</doc>
2737441787 <type name="gboolean" c:type="gboolean"/>
2737541788 </return-value>
2737641789 <parameters>
2737741790 <instance-parameter name="self" transfer-ownership="none">
2737841791 <doc xml:space="preserve"
2737941792 filename="src/adw-view-stack.c"
27380- line="1444">a view stack page</doc>
41793+ line="1564">a view stack page</doc>
2738141794 <type name="ViewStackPage" c:type="AdwViewStackPage*"/>
2738241795 </instance-parameter>
2738341796 </parameters>
@@ -27385,10 +41798,9 @@ property of its widget.</doc>
2738541798 <method name="set_badge_number"
2738641799 c:identifier="adw_view_stack_page_set_badge_number"
2738741800 glib:set-property="badge-number">
27388- <attribute name="org.gtk.Method.set_property" value="badge-number"/>
2738941801 <doc xml:space="preserve"
2739041802 filename="src/adw-view-stack.c"
27391- line="1416">Sets the badge number for this page.
41803+ line="1536">Sets the badge number for this page.
2739241804
2739341805 [class@ViewSwitcher] can display it as a badge next to the page icon. It is
2739441806 commonly used to display a number of unread items within the page.
@@ -27402,13 +41814,13 @@ It can be used together with [property@ViewStack{age}:needs-attention].</doc>
2740241814 <instance-parameter name="self" transfer-ownership="none">
2740341815 <doc xml:space="preserve"
2740441816 filename="src/adw-view-stack.c"
27405- line="1418">a view stack page</doc>
41817+ line="1538">a view stack page</doc>
2740641818 <type name="ViewStackPage" c:type="AdwViewStackPage*"/>
2740741819 </instance-parameter>
2740841820 <parameter name="badge_number" transfer-ownership="none">
2740941821 <doc xml:space="preserve"
2741041822 filename="src/adw-view-stack.c"
27411- line="1419">the new value to set</doc>
41823+ line="1539">the new value to set</doc>
2741241824 <type name="guint" c:type="guint"/>
2741341825 </parameter>
2741441826 </parameters>
@@ -27416,10 +41828,9 @@ It can be used together with [property@ViewStack{age}:needs-attention].</doc>
2741641828 <method name="set_icon_name"
2741741829 c:identifier="adw_view_stack_page_set_icon_name"
2741841830 glib:set-property="icon-name">
27419- <attribute name="org.gtk.Method.set_property" value="icon-name"/>
2742041831 <doc xml:space="preserve"
2742141832 filename="src/adw-view-stack.c"
27422- line="1337">Sets the icon name of the page.</doc>
41833+ line="1460">Sets the icon name of the page.</doc>
2742341834 <source-position filename="src/adw-view-stack.h" line="54"/>
2742441835 <return-value transfer-ownership="none">
2742541836 <type name="none" c:type="void"/>
@@ -27428,7 +41839,7 @@ It can be used together with [property@ViewStack{age}:needs-attention].</doc>
2742841839 <instance-parameter name="self" transfer-ownership="none">
2742941840 <doc xml:space="preserve"
2743041841 filename="src/adw-view-stack.c"
27431- line="1339">a view stack page</doc>
41842+ line="1462">a view stack page</doc>
2743241843 <type name="ViewStackPage" c:type="AdwViewStackPage*"/>
2743341844 </instance-parameter>
2743441845 <parameter name="icon_name"
@@ -27437,7 +41848,7 @@ It can be used together with [property@ViewStack{age}:needs-attention].</doc>
2743741848 allow-none="1">
2743841849 <doc xml:space="preserve"
2743941850 filename="src/adw-view-stack.c"
27440- line="1340">the icon name</doc>
41851+ line="1463">the icon name</doc>
2744141852 <type name="utf8" c:type="const char*"/>
2744241853 </parameter>
2744341854 </parameters>
@@ -27445,10 +41856,9 @@ It can be used together with [property@ViewStack{age}:needs-attention].</doc>
2744541856 <method name="set_name"
2744641857 c:identifier="adw_view_stack_page_set_name"
2744741858 glib:set-property="name">
27448- <attribute name="org.gtk.Method.set_property" value="name"/>
2744941859 <doc xml:space="preserve"
2745041860 filename="src/adw-view-stack.c"
27451- line="1196">Sets the name of the page.</doc>
41861+ line="1325">Sets the name of the page.</doc>
2745241862 <source-position filename="src/adw-view-stack.h" line="36"/>
2745341863 <return-value transfer-ownership="none">
2745441864 <type name="none" c:type="void"/>
@@ -27457,7 +41867,7 @@ It can be used together with [property@ViewStack{age}:needs-attention].</doc>
2745741867 <instance-parameter name="self" transfer-ownership="none">
2745841868 <doc xml:space="preserve"
2745941869 filename="src/adw-view-stack.c"
27460- line="1198">a view stack page</doc>
41870+ line="1327">a view stack page</doc>
2746141871 <type name="ViewStackPage" c:type="AdwViewStackPage*"/>
2746241872 </instance-parameter>
2746341873 <parameter name="name"
@@ -27466,7 +41876,7 @@ It can be used together with [property@ViewStack{age}:needs-attention].</doc>
2746641876 allow-none="1">
2746741877 <doc xml:space="preserve"
2746841878 filename="src/adw-view-stack.c"
27469- line="1199">the page name</doc>
41879+ line="1328">the page name</doc>
2747041880 <type name="utf8" c:type="const char*"/>
2747141881 </parameter>
2747241882 </parameters>
@@ -27474,10 +41884,9 @@ It can be used together with [property@ViewStack{age}:needs-attention].</doc>
2747441884 <method name="set_needs_attention"
2747541885 c:identifier="adw_view_stack_page_set_needs_attention"
2747641886 glib:set-property="needs-attention">
27477- <attribute name="org.gtk.Method.set_property" value="needs-attention"/>
2747841887 <doc xml:space="preserve"
2747941888 filename="src/adw-view-stack.c"
27480- line="1375">Sets whether the page requires the user attention.
41889+ line="1495">Sets whether the page requires the user attention.
2748141890
2748241891 [class@ViewSwitcher] will display it as a dot next to the page icon.</doc>
2748341892 <source-position filename="src/adw-view-stack.h" line="60"/>
@@ -27488,13 +41897,13 @@ It can be used together with [property@ViewStack{age}:needs-attention].</doc>
2748841897 <instance-parameter name="self" transfer-ownership="none">
2748941898 <doc xml:space="preserve"
2749041899 filename="src/adw-view-stack.c"
27491- line="1377">a view stack page</doc>
41900+ line="1497">a view stack page</doc>
2749241901 <type name="ViewStackPage" c:type="AdwViewStackPage*"/>
2749341902 </instance-parameter>
2749441903 <parameter name="needs_attention" transfer-ownership="none">
2749541904 <doc xml:space="preserve"
2749641905 filename="src/adw-view-stack.c"
27497- line="1378">the new value to set</doc>
41906+ line="1498">the new value to set</doc>
2749841907 <type name="gboolean" c:type="gboolean"/>
2749941908 </parameter>
2750041909 </parameters>
@@ -27502,10 +41911,9 @@ It can be used together with [property@ViewStack{age}:needs-attention].</doc>
2750241911 <method name="set_title"
2750341912 c:identifier="adw_view_stack_page_set_title"
2750441913 glib:set-property="title">
27505- <attribute name="org.gtk.Method.set_property" value="title"/>
2750641914 <doc xml:space="preserve"
2750741915 filename="src/adw-view-stack.c"
27508- line="1260">Sets the page title.</doc>
41916+ line="1386">Sets the page title.</doc>
2750941917 <source-position filename="src/adw-view-stack.h" line="42"/>
2751041918 <return-value transfer-ownership="none">
2751141919 <type name="none" c:type="void"/>
@@ -27514,7 +41922,7 @@ It can be used together with [property@ViewStack{age}:needs-attention].</doc>
2751441922 <instance-parameter name="self" transfer-ownership="none">
2751541923 <doc xml:space="preserve"
2751641924 filename="src/adw-view-stack.c"
27517- line="1262">a view stack page</doc>
41925+ line="1388">a view stack page</doc>
2751841926 <type name="ViewStackPage" c:type="AdwViewStackPage*"/>
2751941927 </instance-parameter>
2752041928 <parameter name="title"
@@ -27523,7 +41931,7 @@ It can be used together with [property@ViewStack{age}:needs-attention].</doc>
2752341931 allow-none="1">
2752441932 <doc xml:space="preserve"
2752541933 filename="src/adw-view-stack.c"
27526- line="1263">the page title</doc>
41934+ line="1389">the page title</doc>
2752741935 <type name="utf8" c:type="const char*"/>
2752841936 </parameter>
2752941937 </parameters>
@@ -27531,10 +41939,9 @@ It can be used together with [property@ViewStack{age}:needs-attention].</doc>
2753141939 <method name="set_use_underline"
2753241940 c:identifier="adw_view_stack_page_set_use_underline"
2753341941 glib:set-property="use-underline">
27534- <attribute name="org.gtk.Method.set_property" value="use-underline"/>
2753541942 <doc xml:space="preserve"
2753641943 filename="src/adw-view-stack.c"
27537- line="1300">Sets whether underlines in the page title indicate mnemonics.</doc>
41944+ line="1423">Sets whether underlines in the page title indicate mnemonics.</doc>
2753841945 <source-position filename="src/adw-view-stack.h" line="48"/>
2753941946 <return-value transfer-ownership="none">
2754041947 <type name="none" c:type="void"/>
@@ -27543,13 +41950,13 @@ It can be used together with [property@ViewStack{age}:needs-attention].</doc>
2754341950 <instance-parameter name="self" transfer-ownership="none">
2754441951 <doc xml:space="preserve"
2754541952 filename="src/adw-view-stack.c"
27546- line="1302">a view stack page</doc>
41953+ line="1425">a view stack page</doc>
2754741954 <type name="ViewStackPage" c:type="AdwViewStackPage*"/>
2754841955 </instance-parameter>
2754941956 <parameter name="use_underline" transfer-ownership="none">
2755041957 <doc xml:space="preserve"
2755141958 filename="src/adw-view-stack.c"
27552- line="1303">the new value to set</doc>
41959+ line="1426">the new value to set</doc>
2755341960 <type name="gboolean" c:type="gboolean"/>
2755441961 </parameter>
2755541962 </parameters>
@@ -27557,10 +41964,9 @@ It can be used together with [property@ViewStack{age}:needs-attention].</doc>
2755741964 <method name="set_visible"
2755841965 c:identifier="adw_view_stack_page_set_visible"
2755941966 glib:set-property="visible">
27560- <attribute name="org.gtk.Method.set_property" value="visible"/>
2756141967 <doc xml:space="preserve"
2756241968 filename="src/adw-view-stack.c"
27563- line="1461">Sets whether @page is visible in its `AdwViewStack`.
41969+ line="1581">Sets whether @page is visible in its `AdwViewStack`.
2756441970
2756541971 This is independent from the [property@Gtk.Widget:visible] property of
2756641972 [property@ViewStackPage:child].</doc>
@@ -27572,13 +41978,13 @@ This is independent from the [property@Gtk.Widget:visible] property of
2757241978 <instance-parameter name="self" transfer-ownership="none">
2757341979 <doc xml:space="preserve"
2757441980 filename="src/adw-view-stack.c"
27575- line="1463">a view stack page</doc>
41981+ line="1583">a view stack page</doc>
2757641982 <type name="ViewStackPage" c:type="AdwViewStackPage*"/>
2757741983 </instance-parameter>
2757841984 <parameter name="visible" transfer-ownership="none">
2757941985 <doc xml:space="preserve"
2758041986 filename="src/adw-view-stack.c"
27581- line="1464">whether @self is visible</doc>
41987+ line="1584">whether @self is visible</doc>
2758241988 <type name="gboolean" c:type="gboolean"/>
2758341989 </parameter>
2758441990 </parameters>
@@ -27589,13 +41995,9 @@ This is independent from the [property@Gtk.Widget:visible] property of
2758941995 setter="set_badge_number"
2759041996 getter="get_badge_number"
2759141997 default-value="0">
27592- <attribute name="org.gtk.Property.get"
27593- value="adw_view_stack_page_get_badge_number"/>
27594- <attribute name="org.gtk.Property.set"
27595- value="adw_view_stack_page_set_badge_number"/>
2759641998 <doc xml:space="preserve"
2759741999 filename="src/adw-view-stack.c"
27598- line="345">The badge number for this page.
42000+ line="369">The badge number for this page.
2759942001
2760042002 [class@ViewSwitcher] can display it as a badge next to the page icon. It is
2760142003 commonly used to display a number of unread items within the page.
@@ -27608,11 +42010,9 @@ It can be used together with [property@ViewStack{age}:needs-attention].</doc>
2760842010 construct-only="1"
2760942011 transfer-ownership="none"
2761042012 getter="get_child">
27611- <attribute name="org.gtk.Property.get"
27612- value="adw_view_stack_page_get_child"/>
2761342013 <doc xml:space="preserve"
2761442014 filename="src/adw-view-stack.c"
27615- line="283">The stack child to which the page belongs.</doc>
42015+ line="307">The stack child to which the page belongs.</doc>
2761642016 <type name="Gtk.Widget"/>
2761742017 </property>
2761842018 <property name="icon-name"
@@ -27621,13 +42021,9 @@ It can be used together with [property@ViewStack{age}:needs-attention].</doc>
2762142021 setter="set_icon_name"
2762242022 getter="get_icon_name"
2762342023 default-value="NULL">
27624- <attribute name="org.gtk.Property.get"
27625- value="adw_view_stack_page_get_icon_name"/>
27626- <attribute name="org.gtk.Property.set"
27627- value="adw_view_stack_page_set_icon_name"/>
2762842024 <doc xml:space="preserve"
2762942025 filename="src/adw-view-stack.c"
27630- line="323">The icon name of the child page.</doc>
42026+ line="347">The icon name of the child page.</doc>
2763142027 <type name="utf8" c:type="gchar*"/>
2763242028 </property>
2763342029 <property name="name"
@@ -27636,13 +42032,9 @@ It can be used together with [property@ViewStack{age}:needs-attention].</doc>
2763642032 setter="set_name"
2763742033 getter="get_name"
2763842034 default-value="NULL">
27639- <attribute name="org.gtk.Property.get"
27640- value="adw_view_stack_page_get_name"/>
27641- <attribute name="org.gtk.Property.set"
27642- value="adw_view_stack_page_set_name"/>
2764342035 <doc xml:space="preserve"
2764442036 filename="src/adw-view-stack.c"
27645- line="293">The name of the child page.</doc>
42037+ line="317">The name of the child page.</doc>
2764642038 <type name="utf8" c:type="gchar*"/>
2764742039 </property>
2764842040 <property name="needs-attention"
@@ -27651,13 +42043,9 @@ It can be used together with [property@ViewStack{age}:needs-attention].</doc>
2765142043 setter="set_needs_attention"
2765242044 getter="get_needs_attention"
2765342045 default-value="FALSE">
27654- <attribute name="org.gtk.Property.get"
27655- value="adw_view_stack_page_get_needs_attention"/>
27656- <attribute name="org.gtk.Property.set"
27657- value="adw_view_stack_page_set_needs_attention"/>
2765842046 <doc xml:space="preserve"
2765942047 filename="src/adw-view-stack.c"
27660- line="333">Whether the page requires the user attention.
42048+ line="357">Whether the page requires the user attention.
2766142049
2766242050 [class@ViewSwitcher] will display it as a dot next to the page icon.</doc>
2766342051 <type name="gboolean" c:type="gboolean"/>
@@ -27668,13 +42056,9 @@ It can be used together with [property@ViewStack{age}:needs-attention].</doc>
2766842056 setter="set_title"
2766942057 getter="get_title"
2767042058 default-value="NULL">
27671- <attribute name="org.gtk.Property.get"
27672- value="adw_view_stack_page_get_title"/>
27673- <attribute name="org.gtk.Property.set"
27674- value="adw_view_stack_page_set_title"/>
2767542059 <doc xml:space="preserve"
2767642060 filename="src/adw-view-stack.c"
27677- line="303">The title of the child page.</doc>
42061+ line="327">The title of the child page.</doc>
2767842062 <type name="utf8" c:type="gchar*"/>
2767942063 </property>
2768042064 <property name="use-underline"
@@ -27683,13 +42067,9 @@ It can be used together with [property@ViewStack{age}:needs-attention].</doc>
2768342067 setter="set_use_underline"
2768442068 getter="get_use_underline"
2768542069 default-value="FALSE">
27686- <attribute name="org.gtk.Property.get"
27687- value="adw_view_stack_page_get_use_underline"/>
27688- <attribute name="org.gtk.Property.set"
27689- value="adw_view_stack_page_set_use_underline"/>
2769042070 <doc xml:space="preserve"
2769142071 filename="src/adw-view-stack.c"
27692- line="313">Whether an embedded underline in the title indicates a mnemonic.</doc>
42072+ line="337">Whether an embedded underline in the title indicates a mnemonic.</doc>
2769342073 <type name="gboolean" c:type="gboolean"/>
2769442074 </property>
2769542075 <property name="visible"
@@ -27698,13 +42078,9 @@ It can be used together with [property@ViewStack{age}:needs-attention].</doc>
2769842078 setter="set_visible"
2769942079 getter="get_visible"
2770042080 default-value="TRUE">
27701- <attribute name="org.gtk.Property.get"
27702- value="adw_view_stack_page_get_visible"/>
27703- <attribute name="org.gtk.Property.set"
27704- value="adw_view_stack_page_set_visible"/>
2770542081 <doc xml:space="preserve"
2770642082 filename="src/adw-view-stack.c"
27707- line="360">Whether this page is visible.
42083+ line="384">Whether this page is visible.
2770842084
2770942085 This is independent from the [property@Gtk.Widget:visible] property of
2771042086 [property@ViewStackPage:child].</doc>
@@ -27719,6 +42095,103 @@ This is independent from the [property@Gtk.Widget:visible] property of
2771942095 <type name="GObject.ObjectClass" c:type="GObjectClass"/>
2772042096 </field>
2772142097 </record>
42098+ <class name="ViewStackPages"
42099+ c:symbol-prefix="view_stack_pages"
42100+ c:type="AdwViewStackPages"
42101+ version="1.4"
42102+ parent="GObject.Object"
42103+ final="1"
42104+ glib:type-name="AdwViewStackPages"
42105+ glib:get-type="adw_view_stack_pages_get_type"
42106+ glib:type-struct="ViewStackPagesClass">
42107+ <doc xml:space="preserve"
42108+ filename="src/adw-view-stack.c"
42109+ line="86">An auxiliary class used by [class@ViewStack].
42110+
42111+See [property@ViewStack:pages].</doc>
42112+ <source-position filename="src/adw-view-stack.h" line="144"/>
42113+ <implements name="Gio.ListModel"/>
42114+ <implements name="Gtk.SelectionModel"/>
42115+ <method name="get_selected_page"
42116+ c:identifier="adw_view_stack_pages_get_selected_page"
42117+ glib:get-property="selected-page"
42118+ version="1.4">
42119+ <doc xml:space="preserve"
42120+ filename="src/adw-view-stack.c"
42121+ line="578">Gets the [class@ViewStackPage] for the visible child of a view stack
42122+
42123+Gets the [class@ViewStackPage] for the visible child of the associated stack.
42124+
42125+Returns `NULL` if there's no selected page.</doc>
42126+ <source-position filename="src/adw-view-stack.h" line="147"/>
42127+ <return-value transfer-ownership="none" nullable="1">
42128+ <doc xml:space="preserve"
42129+ filename="src/adw-view-stack.c"
42130+ line="588">the stack page</doc>
42131+ <type name="ViewStackPage" c:type="AdwViewStackPage*"/>
42132+ </return-value>
42133+ <parameters>
42134+ <instance-parameter name="self" transfer-ownership="none">
42135+ <doc xml:space="preserve"
42136+ filename="src/adw-view-stack.c"
42137+ line="580">a [class@ViewStackPages]</doc>
42138+ <type name="ViewStackPages" c:type="AdwViewStackPages*"/>
42139+ </instance-parameter>
42140+ </parameters>
42141+ </method>
42142+ <method name="set_selected_page"
42143+ c:identifier="adw_view_stack_pages_set_selected_page"
42144+ glib:set-property="selected-page"
42145+ version="1.4">
42146+ <doc xml:space="preserve"
42147+ filename="src/adw-view-stack.c"
42148+ line="608">Sets the visible child in the associated [class@ViewStack].
42149+
42150+See [property@ViewStack:visible-child].</doc>
42151+ <source-position filename="src/adw-view-stack.h" line="149"/>
42152+ <return-value transfer-ownership="none">
42153+ <type name="none" c:type="void"/>
42154+ </return-value>
42155+ <parameters>
42156+ <instance-parameter name="self" transfer-ownership="none">
42157+ <doc xml:space="preserve"
42158+ filename="src/adw-view-stack.c"
42159+ line="610">a [class@ViewStackPages]</doc>
42160+ <type name="ViewStackPages" c:type="AdwViewStackPages*"/>
42161+ </instance-parameter>
42162+ <parameter name="page" transfer-ownership="none">
42163+ <doc xml:space="preserve"
42164+ filename="src/adw-view-stack.c"
42165+ line="611">a stack page within the associated stack</doc>
42166+ <type name="ViewStackPage" c:type="AdwViewStackPage*"/>
42167+ </parameter>
42168+ </parameters>
42169+ </method>
42170+ <property name="selected-page"
42171+ version="1.4"
42172+ writable="1"
42173+ transfer-ownership="none"
42174+ setter="set_selected_page"
42175+ getter="get_selected_page">
42176+ <doc xml:space="preserve"
42177+ filename="src/adw-view-stack.c"
42178+ line="687">The selected [class@ViewStackPage] within the [class@ViewStackPages].
42179+
42180+This can be used to keep an up-to-date view of the [class@ViewStackPage] for
42181+The visible [class@ViewStackPage] within the associated [class@ViewStackPages].
42182+
42183+This can be used to keep an up-to-date view of the visible child.</doc>
42184+ <type name="ViewStackPage"/>
42185+ </property>
42186+ </class>
42187+ <record name="ViewStackPagesClass"
42188+ c:type="AdwViewStackPagesClass"
42189+ glib:is-gtype-struct-for="ViewStackPages">
42190+ <source-position filename="src/adw-view-stack.h" line="144"/>
42191+ <field name="parent_class">
42192+ <type name="GObject.ObjectClass" c:type="GObjectClass"/>
42193+ </field>
42194+ </record>
2772242195 <class name="ViewSwitcher"
2772342196 c:symbol-prefix="view_switcher"
2772442197 c:type="AdwViewSwitcher"
@@ -27744,8 +42217,49 @@ contained in a [class@ViewStack] in a similar fashion to
2774442217 displayed side by side, or icon on top of the label. This can be controlled
2774542218 via the [property@ViewSwitcher:policy] property.
2774642219
27747-Most applications should be using [class@ViewSwitcherBar] and
27748-[class@ViewSwitcherTitle].
42220+`AdwViewSwitcher` is intended to be used in a header bar together with
42221+[class@ViewSwitcherBar] at the bottom of the window, and a [class@Breakpoint]
42222+showing the view switcher bar on narrow sizes, while removing the view
42223+switcher from the header bar, as follows:
42224+
42225+```xml
42226+&lt;object class="AdwWindow"&gt;
42227+ &lt;child&gt;
42228+ &lt;object class="AdwBreakpoint"&gt;
42229+ &lt;condition&gt;max-width: 550sp&lt;/condition&gt;
42230+ &lt;setter object="switcher_bar" property="reveal"&gt;True&lt;/setter&gt;
42231+ &lt;setter object="header_bar" property="title-widget"/&gt;
42232+ &lt;/object&gt;
42233+ &lt;/child&gt;
42234+ &lt;property name="content"&gt;
42235+ &lt;object class="AdwToolbarView"&gt;
42236+ &lt;child type="top"&gt;
42237+ &lt;object class="AdwHeaderBar" id="header_bar"&gt;
42238+ &lt;property name="title-widget"&gt;
42239+ &lt;object class="AdwViewSwitcher"&gt;
42240+ &lt;property name="stack"&gt;stack&lt;/property&gt;
42241+ &lt;property name="policy"&gt;wide&lt;/property&gt;
42242+ &lt;/object&gt;
42243+ &lt;/property&gt;
42244+ &lt;/object&gt;
42245+ &lt;/child&gt;
42246+ &lt;property name="content"&gt;
42247+ &lt;object class="AdwViewStack" id="stack"/&gt;
42248+ &lt;/property&gt;
42249+ &lt;child type="bottom"&gt;
42250+ &lt;object class="AdwViewSwitcherBar" id="switcher_bar"&gt;
42251+ &lt;property name="stack"&gt;stack&lt;/property&gt;
42252+ &lt;/object&gt;
42253+ &lt;/child&gt;
42254+ &lt;/object&gt;
42255+ &lt;/property&gt;
42256+&lt;/object&gt;
42257+```
42258+
42259+It's recommended to set [property@ViewSwitcher:policy] to
42260+`ADW_VIEW_SWITCHER_POLICY_WIDE` in this case.
42261+
42262+You may have to adjust the breakpoint condition for your specific pages.
2774942263
2775042264 ## CSS nodes
2775142265
@@ -27763,34 +42277,33 @@ the style classes `.wide` and `.narrow`, matching its policy.
2776342277 <constructor name="new" c:identifier="adw_view_switcher_new">
2776442278 <doc xml:space="preserve"
2776542279 filename="src/adw-view-switcher.c"
27766- line="389">Creates a new `AdwViewSwitcher`.</doc>
42280+ line="430">Creates a new `AdwViewSwitcher`.</doc>
2776742281 <source-position filename="src/adw-view-switcher.h" line="33"/>
2776842282 <return-value transfer-ownership="none">
2776942283 <doc xml:space="preserve"
2777042284 filename="src/adw-view-switcher.c"
27771- line="394">the newly created `AdwViewSwitcher`</doc>
42285+ line="435">the newly created `AdwViewSwitcher`</doc>
2777242286 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2777342287 </return-value>
2777442288 </constructor>
2777542289 <method name="get_policy"
2777642290 c:identifier="adw_view_switcher_get_policy"
2777742291 glib:get-property="policy">
27778- <attribute name="org.gtk.Method.get_property" value="policy"/>
2777942292 <doc xml:space="preserve"
2778042293 filename="src/adw-view-switcher.c"
27781- line="402">Gets the policy of @self.</doc>
42294+ line="443">Gets the policy of @self.</doc>
2778242295 <source-position filename="src/adw-view-switcher.h" line="36"/>
2778342296 <return-value transfer-ownership="none">
2778442297 <doc xml:space="preserve"
2778542298 filename="src/adw-view-switcher.c"
27786- line="408">the policy of @self</doc>
42299+ line="449">the policy of @self</doc>
2778742300 <type name="ViewSwitcherPolicy" c:type="AdwViewSwitcherPolicy"/>
2778842301 </return-value>
2778942302 <parameters>
2779042303 <instance-parameter name="self" transfer-ownership="none">
2779142304 <doc xml:space="preserve"
2779242305 filename="src/adw-view-switcher.c"
27793- line="404">a view switcher</doc>
42306+ line="445">a view switcher</doc>
2779442307 <type name="ViewSwitcher" c:type="AdwViewSwitcher*"/>
2779542308 </instance-parameter>
2779642309 </parameters>
@@ -27798,22 +42311,21 @@ the style classes `.wide` and `.narrow`, matching its policy.
2779842311 <method name="get_stack"
2779942312 c:identifier="adw_view_switcher_get_stack"
2780042313 glib:get-property="stack">
27801- <attribute name="org.gtk.Method.get_property" value="stack"/>
2780242314 <doc xml:space="preserve"
2780342315 filename="src/adw-view-switcher.c"
27804- line="457">Gets the stack controlled by @self.</doc>
42316+ line="498">Gets the stack controlled by @self.</doc>
2780542317 <source-position filename="src/adw-view-switcher.h" line="42"/>
2780642318 <return-value transfer-ownership="none" nullable="1">
2780742319 <doc xml:space="preserve"
2780842320 filename="src/adw-view-switcher.c"
27809- line="463">the stack</doc>
42321+ line="504">the stack</doc>
2781042322 <type name="ViewStack" c:type="AdwViewStack*"/>
2781142323 </return-value>
2781242324 <parameters>
2781342325 <instance-parameter name="self" transfer-ownership="none">
2781442326 <doc xml:space="preserve"
2781542327 filename="src/adw-view-switcher.c"
27816- line="459">a view switcher</doc>
42328+ line="500">a view switcher</doc>
2781742329 <type name="ViewSwitcher" c:type="AdwViewSwitcher*"/>
2781842330 </instance-parameter>
2781942331 </parameters>
@@ -27821,10 +42333,9 @@ the style classes `.wide` and `.narrow`, matching its policy.
2782142333 <method name="set_policy"
2782242334 c:identifier="adw_view_switcher_set_policy"
2782342335 glib:set-property="policy">
27824- <attribute name="org.gtk.Method.set_property" value="policy"/>
2782542336 <doc xml:space="preserve"
2782642337 filename="src/adw-view-switcher.c"
27827- line="418">Sets the policy of @self.</doc>
42338+ line="459">Sets the policy of @self.</doc>
2782842339 <source-position filename="src/adw-view-switcher.h" line="38"/>
2782942340 <return-value transfer-ownership="none">
2783042341 <type name="none" c:type="void"/>
@@ -27833,13 +42344,13 @@ the style classes `.wide` and `.narrow`, matching its policy.
2783342344 <instance-parameter name="self" transfer-ownership="none">
2783442345 <doc xml:space="preserve"
2783542346 filename="src/adw-view-switcher.c"
27836- line="420">a view switcher</doc>
42347+ line="461">a view switcher</doc>
2783742348 <type name="ViewSwitcher" c:type="AdwViewSwitcher*"/>
2783842349 </instance-parameter>
2783942350 <parameter name="policy" transfer-ownership="none">
2784042351 <doc xml:space="preserve"
2784142352 filename="src/adw-view-switcher.c"
27842- line="421">the new policy</doc>
42353+ line="462">the new policy</doc>
2784342354 <type name="ViewSwitcherPolicy" c:type="AdwViewSwitcherPolicy"/>
2784442355 </parameter>
2784542356 </parameters>
@@ -27847,10 +42358,9 @@ the style classes `.wide` and `.narrow`, matching its policy.
2784742358 <method name="set_stack"
2784842359 c:identifier="adw_view_switcher_set_stack"
2784942360 glib:set-property="stack">
27850- <attribute name="org.gtk.Method.set_property" value="stack"/>
2785142361 <doc xml:space="preserve"
2785242362 filename="src/adw-view-switcher.c"
27853- line="473">Sets the stack controlled by @self.</doc>
42363+ line="514">Sets the stack controlled by @self.</doc>
2785442364 <source-position filename="src/adw-view-switcher.h" line="44"/>
2785542365 <return-value transfer-ownership="none">
2785642366 <type name="none" c:type="void"/>
@@ -27859,7 +42369,7 @@ the style classes `.wide` and `.narrow`, matching its policy.
2785942369 <instance-parameter name="self" transfer-ownership="none">
2786042370 <doc xml:space="preserve"
2786142371 filename="src/adw-view-switcher.c"
27862- line="475">a view switcher</doc>
42372+ line="516">a view switcher</doc>
2786342373 <type name="ViewSwitcher" c:type="AdwViewSwitcher*"/>
2786442374 </instance-parameter>
2786542375 <parameter name="stack"
@@ -27868,7 +42378,7 @@ the style classes `.wide` and `.narrow`, matching its policy.
2786842378 allow-none="1">
2786942379 <doc xml:space="preserve"
2787042380 filename="src/adw-view-switcher.c"
27871- line="476">a stack</doc>
42381+ line="517">a stack</doc>
2787242382 <type name="ViewStack" c:type="AdwViewStack*"/>
2787342383 </parameter>
2787442384 </parameters>
@@ -27879,13 +42389,9 @@ the style classes `.wide` and `.narrow`, matching its policy.
2787942389 setter="set_policy"
2788042390 getter="get_policy"
2788142391 default-value="ADW_VIEW_SWITCHER_POLICY_NARROW">
27882- <attribute name="org.gtk.Property.get"
27883- value="adw_view_switcher_get_policy"/>
27884- <attribute name="org.gtk.Property.set"
27885- value="adw_view_switcher_set_policy"/>
2788642392 <doc xml:space="preserve"
2788742393 filename="src/adw-view-switcher.c"
27888- line="349">The policy to determine which mode to use.</doc>
42394+ line="390">The policy to determine which mode to use.</doc>
2788942395 <type name="ViewSwitcherPolicy"/>
2789042396 </property>
2789142397 <property name="stack"
@@ -27893,13 +42399,9 @@ the style classes `.wide` and `.narrow`, matching its policy.
2789342399 transfer-ownership="none"
2789442400 setter="set_stack"
2789542401 getter="get_stack">
27896- <attribute name="org.gtk.Property.get"
27897- value="adw_view_switcher_get_stack"/>
27898- <attribute name="org.gtk.Property.set"
27899- value="adw_view_switcher_set_stack"/>
2790042402 <doc xml:space="preserve"
2790142403 filename="src/adw-view-switcher.c"
27902- line="360">The stack the view switcher controls.</doc>
42404+ line="401">The stack the view switcher controls.</doc>
2790342405 <type name="ViewStack"/>
2790442406 </property>
2790542407 </class>
@@ -27913,7 +42415,7 @@ the style classes `.wide` and `.narrow`, matching its policy.
2791342415 glib:type-struct="ViewSwitcherBarClass">
2791442416 <doc xml:space="preserve"
2791542417 filename="src/adw-view-switcher-bar.c"
27916- line="13">A view switcher action bar.
42418+ line="14">A view switcher action bar.
2791742419
2791842420 &lt;picture&gt;
2791942421 &lt;source srcset="view-switcher-bar-dark.png" media="(prefers-color-scheme: dark)"&gt;
@@ -27926,37 +42428,37 @@ the bottom of a window and to be revealed only on really narrow windows, e.g.
2792642428 on mobile phones. It can't be revealed if there are less than two pages.
2792742429
2792842430 `AdwViewSwitcherBar` is intended to be used together with
27929-[class@ViewSwitcherTitle].
27930-
27931-A common use case is to bind the [property@ViewSwitcherBar:reveal] property
27932-to [property@ViewSwitcherTitle:title-visible] to automatically reveal the
27933-view switcher bar when the title label is displayed in place of the view
27934-switcher, as follows:
42431+`AdwViewSwitcher` in a header bar, and a [class@Breakpoint] showing the view
42432+switcher bar on narrow sizes, while removing the view switcher from the
42433+header bar, as follows:
2793542434
2793642435 ```xml
27937-&lt;object class="GtkWindow"&gt;
27938- &lt;property name="titlebar"&gt;
27939- &lt;object class="AdwHeaderBar"&gt;
27940- &lt;property name="centering-policy"&gt;strict&lt;/property&gt;
27941- &lt;property name="title-widget"&gt;
27942- &lt;object class="AdwViewSwitcherTitle" id="title"&gt;
27943- &lt;property name="stack"&gt;stack&lt;/property&gt;
27944- &lt;/object&gt;
27945- &lt;/property&gt;
42436+&lt;object class="AdwWindow"&gt;
42437+ &lt;child&gt;
42438+ &lt;object class="AdwBreakpoint"&gt;
42439+ &lt;condition&gt;max-width: 550sp&lt;/condition&gt;
42440+ &lt;setter object="switcher_bar" property="reveal"&gt;True&lt;/setter&gt;
42441+ &lt;setter object="header_bar" property="title-widget"/&gt;
2794642442 &lt;/object&gt;
27947- &lt;/property&gt;
27948- &lt;property name="child"&gt;
27949- &lt;object class="GtkBox"&gt;
27950- &lt;property name="orientation"&gt;vertical&lt;/property&gt;
27951- &lt;child&gt;
27952- &lt;object class="AdwViewStack" id="stack"/&gt;
42443+ &lt;/child&gt;
42444+ &lt;property name="content"&gt;
42445+ &lt;object class="AdwToolbarView"&gt;
42446+ &lt;child type="top"&gt;
42447+ &lt;object class="AdwHeaderBar" id="header_bar"&gt;
42448+ &lt;property name="title-widget"&gt;
42449+ &lt;object class="AdwViewSwitcher"&gt;
42450+ &lt;property name="stack"&gt;stack&lt;/property&gt;
42451+ &lt;property name="policy"&gt;wide&lt;/property&gt;
42452+ &lt;/object&gt;
42453+ &lt;/property&gt;
42454+ &lt;/object&gt;
2795342455 &lt;/child&gt;
27954- &lt;child&gt;
27955- &lt;object class="AdwViewSwitcherBar"&gt;
42456+ &lt;property name="content"&gt;
42457+ &lt;object class="AdwViewStack" id="stack"/&gt;
42458+ &lt;/property&gt;
42459+ &lt;child type="bottom"&gt;
42460+ &lt;object class="AdwViewSwitcherBar" id="switcher_bar"&gt;
2795642461 &lt;property name="stack"&gt;stack&lt;/property&gt;
27957- &lt;binding name="reveal"&gt;
27958- &lt;lookup name="title-visible"&gt;title&lt;/lookup&gt;
27959- &lt;/binding&gt;
2796042462 &lt;/object&gt;
2796142463 &lt;/child&gt;
2796242464 &lt;/object&gt;
@@ -27964,6 +42466,11 @@ switcher, as follows:
2796442466 &lt;/object&gt;
2796542467 ```
2796642468
42469+It's recommended to set [property@ViewSwitcher:policy] to
42470+`ADW_VIEW_SWITCHER_POLICY_WIDE` in this case.
42471+
42472+You may have to adjust the breakpoint condition for your specific pages.
42473+
2796742474 ## CSS nodes
2796842475
2796942476 `AdwViewSwitcherBar` has a single CSS node with name` viewswitcherbar`.</doc>
@@ -27974,34 +42481,33 @@ switcher, as follows:
2797442481 <constructor name="new" c:identifier="adw_view_switcher_bar_new">
2797542482 <doc xml:space="preserve"
2797642483 filename="src/adw-view-switcher-bar.c"
27977- line="225">Creates a new `AdwViewSwitcherBar`.</doc>
42484+ line="277">Creates a new `AdwViewSwitcherBar`.</doc>
2797842485 <source-position filename="src/adw-view-switcher-bar.h" line="28"/>
2797942486 <return-value transfer-ownership="none">
2798042487 <doc xml:space="preserve"
2798142488 filename="src/adw-view-switcher-bar.c"
27982- line="230">the newly created `AdwViewSwitcherBar`</doc>
42489+ line="282">the newly created `AdwViewSwitcherBar`</doc>
2798342490 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2798442491 </return-value>
2798542492 </constructor>
2798642493 <method name="get_reveal"
2798742494 c:identifier="adw_view_switcher_bar_get_reveal"
2798842495 glib:get-property="reveal">
27989- <attribute name="org.gtk.Method.get_property" value="reveal"/>
2799042496 <doc xml:space="preserve"
2799142497 filename="src/adw-view-switcher-bar.c"
27992- line="293">Gets whether @self should be revealed or hidden.</doc>
42498+ line="345">Gets whether @self should be revealed or hidden.</doc>
2799342499 <source-position filename="src/adw-view-switcher-bar.h" line="37"/>
2799442500 <return-value transfer-ownership="none">
2799542501 <doc xml:space="preserve"
2799642502 filename="src/adw-view-switcher-bar.c"
27997- line="299">whether @self is revealed</doc>
42503+ line="351">whether @self is revealed</doc>
2799842504 <type name="gboolean" c:type="gboolean"/>
2799942505 </return-value>
2800042506 <parameters>
2800142507 <instance-parameter name="self" transfer-ownership="none">
2800242508 <doc xml:space="preserve"
2800342509 filename="src/adw-view-switcher-bar.c"
28004- line="295">a view switcher bar</doc>
42510+ line="347">a view switcher bar</doc>
2800542511 <type name="ViewSwitcherBar" c:type="AdwViewSwitcherBar*"/>
2800642512 </instance-parameter>
2800742513 </parameters>
@@ -28009,22 +42515,21 @@ switcher, as follows:
2800942515 <method name="get_stack"
2801042516 c:identifier="adw_view_switcher_bar_get_stack"
2801142517 glib:get-property="stack">
28012- <attribute name="org.gtk.Method.get_property" value="stack"/>
2801342518 <doc xml:space="preserve"
2801442519 filename="src/adw-view-switcher-bar.c"
28015- line="238">Gets the stack controlled by @self.</doc>
42520+ line="290">Gets the stack controlled by @self.</doc>
2801642521 <source-position filename="src/adw-view-switcher-bar.h" line="31"/>
2801742522 <return-value transfer-ownership="none" nullable="1">
2801842523 <doc xml:space="preserve"
2801942524 filename="src/adw-view-switcher-bar.c"
28020- line="244">the stack</doc>
42525+ line="296">the stack</doc>
2802142526 <type name="ViewStack" c:type="AdwViewStack*"/>
2802242527 </return-value>
2802342528 <parameters>
2802442529 <instance-parameter name="self" transfer-ownership="none">
2802542530 <doc xml:space="preserve"
2802642531 filename="src/adw-view-switcher-bar.c"
28027- line="240">a view switcher bar</doc>
42532+ line="292">a view switcher bar</doc>
2802842533 <type name="ViewSwitcherBar" c:type="AdwViewSwitcherBar*"/>
2802942534 </instance-parameter>
2803042535 </parameters>
@@ -28032,10 +42537,9 @@ switcher, as follows:
2803242537 <method name="set_reveal"
2803342538 c:identifier="adw_view_switcher_bar_set_reveal"
2803442539 glib:set-property="reveal">
28035- <attribute name="org.gtk.Method.set_property" value="reveal"/>
2803642540 <doc xml:space="preserve"
2803742541 filename="src/adw-view-switcher-bar.c"
28038- line="309">Sets whether @self should be revealed or hidden.</doc>
42542+ line="361">Sets whether @self should be revealed or hidden.</doc>
2803942543 <source-position filename="src/adw-view-switcher-bar.h" line="39"/>
2804042544 <return-value transfer-ownership="none">
2804142545 <type name="none" c:type="void"/>
@@ -28044,13 +42548,13 @@ switcher, as follows:
2804442548 <instance-parameter name="self" transfer-ownership="none">
2804542549 <doc xml:space="preserve"
2804642550 filename="src/adw-view-switcher-bar.c"
28047- line="311">a view switcher bar</doc>
42551+ line="363">a view switcher bar</doc>
2804842552 <type name="ViewSwitcherBar" c:type="AdwViewSwitcherBar*"/>
2804942553 </instance-parameter>
2805042554 <parameter name="reveal" transfer-ownership="none">
2805142555 <doc xml:space="preserve"
2805242556 filename="src/adw-view-switcher-bar.c"
28053- line="312">whether to reveal @self</doc>
42557+ line="364">whether to reveal @self</doc>
2805442558 <type name="gboolean" c:type="gboolean"/>
2805542559 </parameter>
2805642560 </parameters>
@@ -28058,10 +42562,9 @@ switcher, as follows:
2805842562 <method name="set_stack"
2805942563 c:identifier="adw_view_switcher_bar_set_stack"
2806042564 glib:set-property="stack">
28061- <attribute name="org.gtk.Method.set_property" value="stack"/>
2806242565 <doc xml:space="preserve"
2806342566 filename="src/adw-view-switcher-bar.c"
28064- line="254">Sets the stack controlled by @self.</doc>
42567+ line="306">Sets the stack controlled by @self.</doc>
2806542568 <source-position filename="src/adw-view-switcher-bar.h" line="33"/>
2806642569 <return-value transfer-ownership="none">
2806742570 <type name="none" c:type="void"/>
@@ -28070,7 +42573,7 @@ switcher, as follows:
2807042573 <instance-parameter name="self" transfer-ownership="none">
2807142574 <doc xml:space="preserve"
2807242575 filename="src/adw-view-switcher-bar.c"
28073- line="256">a view switcher bar</doc>
42576+ line="308">a view switcher bar</doc>
2807442577 <type name="ViewSwitcherBar" c:type="AdwViewSwitcherBar*"/>
2807542578 </instance-parameter>
2807642579 <parameter name="stack"
@@ -28079,7 +42582,7 @@ switcher, as follows:
2807942582 allow-none="1">
2808042583 <doc xml:space="preserve"
2808142584 filename="src/adw-view-switcher-bar.c"
28082- line="257">a stack</doc>
42585+ line="309">a stack</doc>
2808342586 <type name="ViewStack" c:type="AdwViewStack*"/>
2808442587 </parameter>
2808542588 </parameters>
@@ -28090,13 +42593,9 @@ switcher, as follows:
2809042593 setter="set_reveal"
2809142594 getter="get_reveal"
2809242595 default-value="FALSE">
28093- <attribute name="org.gtk.Property.get"
28094- value="adw_view_switcher_bar_get_reveal"/>
28095- <attribute name="org.gtk.Property.set"
28096- value="adw_view_switcher_bar_set_reveal"/>
2809742596 <doc xml:space="preserve"
2809842597 filename="src/adw-view-switcher-bar.c"
28099- line="196">Whether the bar should be revealed or hidden.</doc>
42598+ line="248">Whether the bar should be revealed or hidden.</doc>
2810042599 <type name="gboolean" c:type="gboolean"/>
2810142600 </property>
2810242601 <property name="stack"
@@ -28104,13 +42603,9 @@ switcher, as follows:
2810442603 transfer-ownership="none"
2810542604 setter="set_stack"
2810642605 getter="get_stack">
28107- <attribute name="org.gtk.Property.get"
28108- value="adw_view_switcher_bar_get_stack"/>
28109- <attribute name="org.gtk.Property.set"
28110- value="adw_view_switcher_bar_set_stack"/>
2811142606 <doc xml:space="preserve"
2811242607 filename="src/adw-view-switcher-bar.c"
28113- line="186">The stack the view switcher controls.</doc>
42608+ line="238">The stack the view switcher controls.</doc>
2811442609 <type name="ViewStack"/>
2811542610 </property>
2811642611 </class>
@@ -28136,7 +42631,7 @@ switcher, as follows:
2813642631 c:type="AdwViewSwitcherPolicy">
2813742632 <doc xml:space="preserve"
2813842633 filename="src/adw-view-switcher.c"
28139- line="49">Describes the adaptive modes of [class@ViewSwitcher].</doc>
42634+ line="90">Describes the adaptive modes of [class@ViewSwitcher].</doc>
2814042635 <member name="narrow"
2814142636 value="0"
2814242637 c:identifier="ADW_VIEW_SWITCHER_POLICY_NARROW"
@@ -28144,7 +42639,7 @@ switcher, as follows:
2814442639 glib:name="ADW_VIEW_SWITCHER_POLICY_NARROW">
2814542640 <doc xml:space="preserve"
2814642641 filename="src/adw-view-switcher.c"
28147- line="51">Force the narrow mode</doc>
42642+ line="92">Force the narrow mode</doc>
2814842643 </member>
2814942644 <member name="wide"
2815042645 value="1"
@@ -28153,12 +42648,14 @@ switcher, as follows:
2815342648 glib:name="ADW_VIEW_SWITCHER_POLICY_WIDE">
2815442649 <doc xml:space="preserve"
2815542650 filename="src/adw-view-switcher.c"
28156- line="52">Force the wide mode</doc>
42651+ line="93">Force the wide mode</doc>
2815742652 </member>
2815842653 </enumeration>
2815942654 <class name="ViewSwitcherTitle"
2816042655 c:symbol-prefix="view_switcher_title"
2816142656 c:type="AdwViewSwitcherTitle"
42657+ deprecated="1"
42658+ deprecated-version="1.4"
2816242659 parent="Gtk.Widget"
2816342660 final="1"
2816442661 glib:type-name="AdwViewSwitcherTitle"
@@ -28193,24 +42690,23 @@ view switcher bar when the title label is displayed in place of the view
2819342690 switcher, as follows:
2819442691
2819542692 ```xml
28196-&lt;object class="GtkWindow"&gt;
28197- &lt;property name="titlebar"&gt;
28198- &lt;object class="AdwHeaderBar"&gt;
28199- &lt;property name="centering-policy"&gt;strict&lt;/property&gt;
28200- &lt;property name="title-widget"&gt;
28201- &lt;object class="AdwViewSwitcherTitle" id="title"&gt;
28202- &lt;property name="stack"&gt;stack&lt;/property&gt;
42693+&lt;object class="AdwWindow"&gt;
42694+ &lt;property name="content"&gt;
42695+ &lt;object class="AdwToolbarView"&gt;
42696+ &lt;child type="top"&gt;
42697+ &lt;object class="AdwHeaderBar"&gt;
42698+ &lt;property name="centering-policy"&gt;strict&lt;/property&gt;
42699+ &lt;property name="title-widget"&gt;
42700+ &lt;object class="AdwViewSwitcherTitle" id="title"&gt;
42701+ &lt;property name="stack"&gt;stack&lt;/property&gt;
42702+ &lt;/object&gt;
42703+ &lt;/property&gt;
2820342704 &lt;/object&gt;
28204- &lt;/property&gt;
28205- &lt;/object&gt;
28206- &lt;/property&gt;
28207- &lt;property name="child"&gt;
28208- &lt;object class="GtkBox"&gt;
28209- &lt;property name="orientation"&gt;vertical&lt;/property&gt;
28210- &lt;child&gt;
28211- &lt;object class="AdwViewStack" id="stack"/&gt;
2821242705 &lt;/child&gt;
28213- &lt;child&gt;
42706+ &lt;property name="content"&gt;
42707+ &lt;object class="AdwViewStack" id="stack"/&gt;
42708+ &lt;/property&gt;
42709+ &lt;child type="bottom"&gt;
2821442710 &lt;object class="AdwViewSwitcherBar"&gt;
2821542711 &lt;property name="stack"&gt;stack&lt;/property&gt;
2821642712 &lt;binding name="reveal"&gt;
@@ -28226,148 +42722,164 @@ switcher, as follows:
2822642722 ## CSS nodes
2822742723
2822842724 `AdwViewSwitcherTitle` has a single CSS node with name `viewswitchertitle`.</doc>
42725+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwviewswitchertitle)</doc-deprecated>
2822942726 <source-position filename="src/adw-view-switcher-title.h" line="25"/>
2823042727 <implements name="Gtk.Accessible"/>
2823142728 <implements name="Gtk.Buildable"/>
2823242729 <implements name="Gtk.ConstraintTarget"/>
28233- <constructor name="new" c:identifier="adw_view_switcher_title_new">
42730+ <constructor name="new"
42731+ c:identifier="adw_view_switcher_title_new"
42732+ deprecated="1"
42733+ deprecated-version="1.4">
2823442734 <doc xml:space="preserve"
2823542735 filename="src/adw-view-switcher-title.c"
28236- line="374">Creates a new `AdwViewSwitcherTitle`.</doc>
42736+ line="387">Creates a new `AdwViewSwitcherTitle`.</doc>
42737+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwviewswitchertitle)</doc-deprecated>
2823742738 <source-position filename="src/adw-view-switcher-title.h" line="28"/>
2823842739 <return-value transfer-ownership="none">
2823942740 <doc xml:space="preserve"
2824042741 filename="src/adw-view-switcher-title.c"
28241- line="379">the newly created `AdwViewSwitcherTitle`</doc>
42742+ line="392">the newly created `AdwViewSwitcherTitle`</doc>
2824242743 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2824342744 </return-value>
2824442745 </constructor>
2824542746 <method name="get_stack"
2824642747 c:identifier="adw_view_switcher_title_get_stack"
28247- glib:get-property="stack">
28248- <attribute name="org.gtk.Method.get_property" value="stack"/>
42748+ glib:get-property="stack"
42749+ deprecated="1"
42750+ deprecated-version="1.4">
2824942751 <doc xml:space="preserve"
2825042752 filename="src/adw-view-switcher-title.c"
28251- line="387">Gets the stack controlled by @self.</doc>
42753+ line="402">Gets the stack controlled by @self.</doc>
42754+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwviewswitchertitle)</doc-deprecated>
2825242755 <source-position filename="src/adw-view-switcher-title.h" line="31"/>
2825342756 <return-value transfer-ownership="none" nullable="1">
2825442757 <doc xml:space="preserve"
2825542758 filename="src/adw-view-switcher-title.c"
28256- line="393">the stack</doc>
42759+ line="408">the stack</doc>
2825742760 <type name="ViewStack" c:type="AdwViewStack*"/>
2825842761 </return-value>
2825942762 <parameters>
2826042763 <instance-parameter name="self" transfer-ownership="none">
2826142764 <doc xml:space="preserve"
2826242765 filename="src/adw-view-switcher-title.c"
28263- line="389">a view switcher title</doc>
42766+ line="404">a view switcher title</doc>
2826442767 <type name="ViewSwitcherTitle" c:type="AdwViewSwitcherTitle*"/>
2826542768 </instance-parameter>
2826642769 </parameters>
2826742770 </method>
2826842771 <method name="get_subtitle"
2826942772 c:identifier="adw_view_switcher_title_get_subtitle"
28270- glib:get-property="subtitle">
28271- <attribute name="org.gtk.Method.get_property" value="subtitle"/>
42773+ glib:get-property="subtitle"
42774+ deprecated="1"
42775+ deprecated-version="1.4">
2827242776 <doc xml:space="preserve"
2827342777 filename="src/adw-view-switcher-title.c"
28274- line="483">Gets the subtitle of @self.</doc>
42778+ line="506">Gets the subtitle of @self.</doc>
42779+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwviewswitchertitle)</doc-deprecated>
2827542780 <source-position filename="src/adw-view-switcher-title.h" line="43"/>
2827642781 <return-value transfer-ownership="none">
2827742782 <doc xml:space="preserve"
2827842783 filename="src/adw-view-switcher-title.c"
28279- line="489">the subtitle</doc>
42784+ line="512">the subtitle</doc>
2828042785 <type name="utf8" c:type="const char*"/>
2828142786 </return-value>
2828242787 <parameters>
2828342788 <instance-parameter name="self" transfer-ownership="none">
2828442789 <doc xml:space="preserve"
2828542790 filename="src/adw-view-switcher-title.c"
28286- line="485">a view switcher title</doc>
42791+ line="508">a view switcher title</doc>
2828742792 <type name="ViewSwitcherTitle" c:type="AdwViewSwitcherTitle*"/>
2828842793 </instance-parameter>
2828942794 </parameters>
2829042795 </method>
2829142796 <method name="get_title"
2829242797 c:identifier="adw_view_switcher_title_get_title"
28293- glib:get-property="title">
28294- <attribute name="org.gtk.Method.get_property" value="title"/>
42798+ glib:get-property="title"
42799+ deprecated="1"
42800+ deprecated-version="1.4">
2829542801 <doc xml:space="preserve"
2829642802 filename="src/adw-view-switcher-title.c"
28297- line="443">Gets the title of @self.</doc>
42803+ line="462">Gets the title of @self.</doc>
42804+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwviewswitchertitle)</doc-deprecated>
2829842805 <source-position filename="src/adw-view-switcher-title.h" line="37"/>
2829942806 <return-value transfer-ownership="none">
2830042807 <doc xml:space="preserve"
2830142808 filename="src/adw-view-switcher-title.c"
28302- line="449">the title</doc>
42809+ line="468">the title</doc>
2830342810 <type name="utf8" c:type="const char*"/>
2830442811 </return-value>
2830542812 <parameters>
2830642813 <instance-parameter name="self" transfer-ownership="none">
2830742814 <doc xml:space="preserve"
2830842815 filename="src/adw-view-switcher-title.c"
28309- line="445">a view switcher title</doc>
42816+ line="464">a view switcher title</doc>
2831042817 <type name="ViewSwitcherTitle" c:type="AdwViewSwitcherTitle*"/>
2831142818 </instance-parameter>
2831242819 </parameters>
2831342820 </method>
2831442821 <method name="get_title_visible"
2831542822 c:identifier="adw_view_switcher_title_get_title_visible"
28316- glib:get-property="title-visible">
28317- <attribute name="org.gtk.Method.get_property" value="title-visible"/>
42823+ glib:get-property="title-visible"
42824+ deprecated="1"
42825+ deprecated-version="1.4">
2831842826 <doc xml:space="preserve"
2831942827 filename="src/adw-view-switcher-title.c"
28320- line="569">Gets whether the title of @self is currently visible.
42828+ line="600">Gets whether the title of @self is currently visible.
2832142829
2832242830 If the title is visible, it means the view switcher is hidden an it may be
2832342831 wanted to show an alternative switcher, e.g. a [class@ViewSwitcherBar].</doc>
42832+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwviewswitchertitle)</doc-deprecated>
2832442833 <source-position filename="src/adw-view-switcher-title.h" line="55"/>
2832542834 <return-value transfer-ownership="none">
2832642835 <doc xml:space="preserve"
2832742836 filename="src/adw-view-switcher-title.c"
28328- line="578">whether the title of @self is currently visible</doc>
42837+ line="609">whether the title of @self is currently visible</doc>
2832942838 <type name="gboolean" c:type="gboolean"/>
2833042839 </return-value>
2833142840 <parameters>
2833242841 <instance-parameter name="self" transfer-ownership="none">
2833342842 <doc xml:space="preserve"
2833442843 filename="src/adw-view-switcher-title.c"
28335- line="571">a view switcher title</doc>
42844+ line="602">a view switcher title</doc>
2833642845 <type name="ViewSwitcherTitle" c:type="AdwViewSwitcherTitle*"/>
2833742846 </instance-parameter>
2833842847 </parameters>
2833942848 </method>
2834042849 <method name="get_view_switcher_enabled"
2834142850 c:identifier="adw_view_switcher_title_get_view_switcher_enabled"
28342- glib:get-property="view-switcher-enabled">
28343- <attribute name="org.gtk.Method.get_property"
28344- value="view-switcher-enabled"/>
42851+ glib:get-property="view-switcher-enabled"
42852+ deprecated="1"
42853+ deprecated-version="1.4">
2834542854 <doc xml:space="preserve"
2834642855 filename="src/adw-view-switcher-title.c"
28347- line="522">Gets whether @self's view switcher is enabled.</doc>
42856+ line="549">Gets whether @self's view switcher is enabled.</doc>
42857+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwviewswitchertitle)</doc-deprecated>
2834842858 <source-position filename="src/adw-view-switcher-title.h" line="49"/>
2834942859 <return-value transfer-ownership="none">
2835042860 <doc xml:space="preserve"
2835142861 filename="src/adw-view-switcher-title.c"
28352- line="528">whether the view switcher is enabled</doc>
42862+ line="555">whether the view switcher is enabled</doc>
2835342863 <type name="gboolean" c:type="gboolean"/>
2835442864 </return-value>
2835542865 <parameters>
2835642866 <instance-parameter name="self" transfer-ownership="none">
2835742867 <doc xml:space="preserve"
2835842868 filename="src/adw-view-switcher-title.c"
28359- line="524">a view switcher title</doc>
42869+ line="551">a view switcher title</doc>
2836042870 <type name="ViewSwitcherTitle" c:type="AdwViewSwitcherTitle*"/>
2836142871 </instance-parameter>
2836242872 </parameters>
2836342873 </method>
2836442874 <method name="set_stack"
2836542875 c:identifier="adw_view_switcher_title_set_stack"
28366- glib:set-property="stack">
28367- <attribute name="org.gtk.Method.set_property" value="stack"/>
42876+ glib:set-property="stack"
42877+ deprecated="1"
42878+ deprecated-version="1.4">
2836842879 <doc xml:space="preserve"
2836942880 filename="src/adw-view-switcher-title.c"
28370- line="403">Sets the stack controlled by @self.</doc>
42881+ line="420">Sets the stack controlled by @self.</doc>
42882+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwviewswitchertitle)</doc-deprecated>
2837142883 <source-position filename="src/adw-view-switcher-title.h" line="33"/>
2837242884 <return-value transfer-ownership="none">
2837342885 <type name="none" c:type="void"/>
@@ -28376,7 +42888,7 @@ wanted to show an alternative switcher, e.g. a [class@ViewSwitcherBar].</doc>
2837642888 <instance-parameter name="self" transfer-ownership="none">
2837742889 <doc xml:space="preserve"
2837842890 filename="src/adw-view-switcher-title.c"
28379- line="405">a view switcher title</doc>
42891+ line="422">a view switcher title</doc>
2838042892 <type name="ViewSwitcherTitle" c:type="AdwViewSwitcherTitle*"/>
2838142893 </instance-parameter>
2838242894 <parameter name="stack"
@@ -28385,20 +42897,22 @@ wanted to show an alternative switcher, e.g. a [class@ViewSwitcherBar].</doc>
2838542897 allow-none="1">
2838642898 <doc xml:space="preserve"
2838742899 filename="src/adw-view-switcher-title.c"
28388- line="406">a stack</doc>
42900+ line="423">a stack</doc>
2838942901 <type name="ViewStack" c:type="AdwViewStack*"/>
2839042902 </parameter>
2839142903 </parameters>
2839242904 </method>
2839342905 <method name="set_subtitle"
2839442906 c:identifier="adw_view_switcher_title_set_subtitle"
28395- glib:set-property="subtitle">
28396- <attribute name="org.gtk.Method.set_property" value="subtitle"/>
42907+ glib:set-property="subtitle"
42908+ deprecated="1"
42909+ deprecated-version="1.4">
2839742910 <doc xml:space="preserve"
2839842911 filename="src/adw-view-switcher-title.c"
28399- line="499">Sets the subtitle of @self.
42912+ line="524">Sets the subtitle of @self.
2840042913
2840142914 The subtitle should give the user additional details.</doc>
42915+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwviewswitchertitle)</doc-deprecated>
2840242916 <source-position filename="src/adw-view-switcher-title.h" line="45"/>
2840342917 <return-value transfer-ownership="none">
2840442918 <type name="none" c:type="void"/>
@@ -28407,27 +42921,29 @@ The subtitle should give the user additional details.</doc>
2840742921 <instance-parameter name="self" transfer-ownership="none">
2840842922 <doc xml:space="preserve"
2840942923 filename="src/adw-view-switcher-title.c"
28410- line="501">a view switcher title</doc>
42924+ line="526">a view switcher title</doc>
2841142925 <type name="ViewSwitcherTitle" c:type="AdwViewSwitcherTitle*"/>
2841242926 </instance-parameter>
2841342927 <parameter name="subtitle" transfer-ownership="none">
2841442928 <doc xml:space="preserve"
2841542929 filename="src/adw-view-switcher-title.c"
28416- line="502">a subtitle</doc>
42930+ line="527">a subtitle</doc>
2841742931 <type name="utf8" c:type="const char*"/>
2841842932 </parameter>
2841942933 </parameters>
2842042934 </method>
2842142935 <method name="set_title"
2842242936 c:identifier="adw_view_switcher_title_set_title"
28423- glib:set-property="title">
28424- <attribute name="org.gtk.Method.set_property" value="title"/>
42937+ glib:set-property="title"
42938+ deprecated="1"
42939+ deprecated-version="1.4">
2842542940 <doc xml:space="preserve"
2842642941 filename="src/adw-view-switcher-title.c"
28427- line="459">Sets the title of @self.
42942+ line="480">Sets the title of @self.
2842842943
2842942944 The title typically identifies the current view or content item, and
2843042945 generally does not use the application name.</doc>
42946+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwviewswitchertitle)</doc-deprecated>
2843142947 <source-position filename="src/adw-view-switcher-title.h" line="39"/>
2843242948 <return-value transfer-ownership="none">
2843342949 <type name="none" c:type="void"/>
@@ -28436,25 +42952,25 @@ generally does not use the application name.</doc>
2843642952 <instance-parameter name="self" transfer-ownership="none">
2843742953 <doc xml:space="preserve"
2843842954 filename="src/adw-view-switcher-title.c"
28439- line="461">a view switcher title</doc>
42955+ line="482">a view switcher title</doc>
2844042956 <type name="ViewSwitcherTitle" c:type="AdwViewSwitcherTitle*"/>
2844142957 </instance-parameter>
2844242958 <parameter name="title" transfer-ownership="none">
2844342959 <doc xml:space="preserve"
2844442960 filename="src/adw-view-switcher-title.c"
28445- line="462">a title</doc>
42961+ line="483">a title</doc>
2844642962 <type name="utf8" c:type="const char*"/>
2844742963 </parameter>
2844842964 </parameters>
2844942965 </method>
2845042966 <method name="set_view_switcher_enabled"
2845142967 c:identifier="adw_view_switcher_title_set_view_switcher_enabled"
28452- glib:set-property="view-switcher-enabled">
28453- <attribute name="org.gtk.Method.set_property"
28454- value="view-switcher-enabled"/>
42968+ glib:set-property="view-switcher-enabled"
42969+ deprecated="1"
42970+ deprecated-version="1.4">
2845542971 <doc xml:space="preserve"
2845642972 filename="src/adw-view-switcher-title.c"
28457- line="538">Sets whether @self's view switcher is enabled.
42973+ line="567">Sets whether @self's view switcher is enabled.
2845842974
2845942975 If it is disabled, the title will be displayed instead. This allows to
2846042976 programmatically hide the view switcher even if it fits in the available
@@ -28462,6 +42978,7 @@ space.
2846242978
2846342979 This can be used e.g. to ensure the view switcher is hidden below a certain
2846442980 window width, or any other constraint you find suitable.</doc>
42981+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwviewswitchertitle)</doc-deprecated>
2846542982 <source-position filename="src/adw-view-switcher-title.h" line="51"/>
2846642983 <return-value transfer-ownership="none">
2846742984 <type name="none" c:type="void"/>
@@ -28470,91 +42987,87 @@ window width, or any other constraint you find suitable.</doc>
2847042987 <instance-parameter name="self" transfer-ownership="none">
2847142988 <doc xml:space="preserve"
2847242989 filename="src/adw-view-switcher-title.c"
28473- line="540">a view switcher title</doc>
42990+ line="569">a view switcher title</doc>
2847442991 <type name="ViewSwitcherTitle" c:type="AdwViewSwitcherTitle*"/>
2847542992 </instance-parameter>
2847642993 <parameter name="enabled" transfer-ownership="none">
2847742994 <doc xml:space="preserve"
2847842995 filename="src/adw-view-switcher-title.c"
28479- line="541">whether the view switcher is enabled</doc>
42996+ line="570">whether the view switcher is enabled</doc>
2848042997 <type name="gboolean" c:type="gboolean"/>
2848142998 </parameter>
2848242999 </parameters>
2848343000 </method>
2848443001 <property name="stack"
43002+ deprecated="1"
43003+ deprecated-version="1.4"
2848543004 writable="1"
2848643005 transfer-ownership="none"
2848743006 setter="set_stack"
2848843007 getter="get_stack">
28489- <attribute name="org.gtk.Property.get"
28490- value="adw_view_switcher_title_get_stack"/>
28491- <attribute name="org.gtk.Property.set"
28492- value="adw_view_switcher_title_set_stack"/>
2849343008 <doc xml:space="preserve"
2849443009 filename="src/adw-view-switcher-title.c"
28495- line="282">The stack the view switcher controls.</doc>
43010+ line="285">The stack the view switcher controls.</doc>
43011+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwviewswitchertitle)</doc-deprecated>
2849643012 <type name="ViewStack"/>
2849743013 </property>
2849843014 <property name="subtitle"
43015+ deprecated="1"
43016+ deprecated-version="1.4"
2849943017 writable="1"
2850043018 transfer-ownership="none"
2850143019 setter="set_subtitle"
2850243020 getter="get_subtitle">
28503- <attribute name="org.gtk.Property.get"
28504- value="adw_view_switcher_title_get_subtitle"/>
28505- <attribute name="org.gtk.Property.set"
28506- value="adw_view_switcher_title_set_subtitle"/>
2850743021 <doc xml:space="preserve"
2850843022 filename="src/adw-view-switcher-title.c"
28509- line="305">The subtitle to display.
43023+ line="312">The subtitle to display.
2851043024
2851143025 The subtitle should give the user additional details.</doc>
43026+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwviewswitchertitle)</doc-deprecated>
2851243027 <type name="utf8" c:type="gchar*"/>
2851343028 </property>
2851443029 <property name="title"
43030+ deprecated="1"
43031+ deprecated-version="1.4"
2851543032 writable="1"
2851643033 transfer-ownership="none"
2851743034 setter="set_title"
2851843035 getter="get_title">
28519- <attribute name="org.gtk.Property.get"
28520- value="adw_view_switcher_title_get_title"/>
28521- <attribute name="org.gtk.Property.set"
28522- value="adw_view_switcher_title_set_title"/>
2852343036 <doc xml:space="preserve"
2852443037 filename="src/adw-view-switcher-title.c"
28525- line="292">The title to display.
43038+ line="297">The title to display.
2852643039
2852743040 The title typically identifies the current view or content item, and
2852843041 generally does not use the application name.</doc>
43042+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwviewswitchertitle)</doc-deprecated>
2852943043 <type name="utf8" c:type="gchar*"/>
2853043044 </property>
2853143045 <property name="title-visible"
43046+ deprecated="1"
43047+ deprecated-version="1.4"
2853243048 transfer-ownership="none"
2853343049 getter="get_title_visible"
2853443050 default-value="TRUE">
28535- <attribute name="org.gtk.Property.get"
28536- value="adw_view_switcher_title_get_title_visible"/>
2853743051 <doc xml:space="preserve"
2853843052 filename="src/adw-view-switcher-title.c"
28539- line="334">Whether the title is currently visible.
43053+ line="345">Whether the title is currently visible.
2854043054
2854143055 If the title is visible, it means the view switcher is hidden an it may be
2854243056 wanted to show an alternative switcher, e.g. a [class@ViewSwitcherBar].</doc>
43057+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwviewswitchertitle)</doc-deprecated>
2854343058 <type name="gboolean" c:type="gboolean"/>
2854443059 </property>
2854543060 <property name="view-switcher-enabled"
43061+ deprecated="1"
43062+ deprecated-version="1.4"
2854643063 writable="1"
2854743064 transfer-ownership="none"
2854843065 setter="set_view_switcher_enabled"
2854943066 getter="get_view_switcher_enabled"
2855043067 default-value="TRUE">
28551- <attribute name="org.gtk.Property.get"
28552- value="adw_view_switcher_title_get_view_switcher_enabled"/>
28553- <attribute name="org.gtk.Property.set"
28554- value="adw_view_switcher_title_set_view_switcher_enabled"/>
2855543068 <doc xml:space="preserve"
2855643069 filename="src/adw-view-switcher-title.c"
28557- line="317">Whether the view switcher is enabled.
43070+ line="326">Whether the view switcher is enabled.
2855843071
2855943072 If it is disabled, the title will be displayed instead. This allows to
2856043073 programmatically hide the view switcher even if it fits in the available
@@ -28562,6 +43075,7 @@ space.
2856243075
2856343076 This can be used e.g. to ensure the view switcher is hidden below a certain
2856443077 window width, or any other constraint you find suitable.</doc>
43078+ <doc-deprecated xml:space="preserve">See [the migration guide](migrating-to-breakpoints.html#replace-adwviewswitchertitle)</doc-deprecated>
2856543079 <type name="gboolean" c:type="gboolean"/>
2856643080 </property>
2856743081 </class>
@@ -28582,7 +43096,7 @@ window width, or any other constraint you find suitable.</doc>
2858243096 glib:type-struct="WindowClass">
2858343097 <doc xml:space="preserve"
2858443098 filename="src/adw-window.c"
28585- line="12">A freeform window.
43099+ line="17">A freeform window.
2858643100
2858743101 &lt;picture&gt;
2858843102 &lt;source srcset="window-dark.png" media="(prefers-color-scheme: dark)"&gt;
@@ -28590,19 +43104,19 @@ window width, or any other constraint you find suitable.</doc>
2859043104 &lt;/picture&gt;
2859143105
2859243106 The `AdwWindow` widget is a subclass of [class@Gtk.Window] which has no
28593-titlebar area. It means [class@Gtk.HeaderBar] can be used as follows:
43107+titlebar area. Instead, [class@ToolbarView] can be used together with
43108+[class@HeaderBar] or [class@Gtk.HeaderBar] as follows:
2859443109
2859543110 ```xml
2859643111 &lt;object class="AdwWindow"&gt;
2859743112 &lt;property name="content"&gt;
28598- &lt;object class="GtkBox"&gt;
28599- &lt;property name="orientation"&gt;vertical&lt;/property&gt;
28600- &lt;child&gt;
28601- &lt;object class="GtkHeaderBar"/&gt;
43113+ &lt;object class="AdwToolbarView"&gt;
43114+ &lt;child type="top"&gt;
43115+ &lt;object class="AdwHeaderBar"/&gt;
2860243116 &lt;/child&gt;
28603- &lt;child&gt;
43117+ &lt;property name="content"&gt;
2860443118 &lt;!-- ... --&gt;
28605- &lt;/child&gt;
43119+ &lt;/property&gt;
2860643120 &lt;/object&gt;
2860743121 &lt;/property&gt;
2860843122 &lt;/object&gt;
@@ -28610,8 +43124,52 @@ titlebar area. It means [class@Gtk.HeaderBar] can be used as follows:
2861043124
2861143125 Using [property@Gtk.Window:titlebar] or [property@Gtk.Window:child]
2861243126 is not supported and will result in a crash. Use [property@Window:content]
28613-instead.</doc>
28614- <source-position filename="src/adw-window.h" line="30"/>
43127+instead.
43128+
43129+## Dialogs
43130+
43131+`AdwWindow` can contain [class@Dialog]. Use [method@Dialog.present] with the
43132+window or a widget within a window to show a dialog.
43133+
43134+## Breakpoints
43135+
43136+`AdwWindow` can be used with [class@Breakpoint] the same way as
43137+[class@BreakpointBin]. Refer to that widget's documentation for details.
43138+
43139+Example:
43140+
43141+```xml
43142+&lt;object class="AdwWindow"&gt;
43143+ &lt;property name="content"&gt;
43144+ &lt;object class="AdwToolbarView"&gt;
43145+ &lt;child type="top"&gt;
43146+ &lt;object class="AdwHeaderBar"/&gt;
43147+ &lt;/child&gt;
43148+ &lt;property name="content"&gt;
43149+ &lt;!-- ... --&gt;
43150+ &lt;/property&gt;
43151+ &lt;child type="bottom"&gt;
43152+ &lt;object class="GtkActionBar" id="bottom_bar"&gt;
43153+ &lt;property name="revealed"&gt;True&lt;/property&gt;
43154+ &lt;property name="visible"&gt;False&lt;/property&gt;
43155+ &lt;/object&gt;
43156+ &lt;/child&gt;
43157+ &lt;/object&gt;
43158+ &lt;/property&gt;
43159+ &lt;child&gt;
43160+ &lt;object class="AdwBreakpoint"&gt;
43161+ &lt;condition&gt;max-width: 500px&lt;/condition&gt;
43162+ &lt;setter object="bottom_bar" property="visible"&gt;True&lt;/setter&gt;
43163+ &lt;/object&gt;
43164+ &lt;/child&gt;
43165+&lt;/object&gt;
43166+```
43167+
43168+When breakpoints are used, the minimum size must be larger than the smallest
43169+UI state. `AdwWindow` defaults to the minimum size of 360×200 px. If that's
43170+too small, set the [property@Gtk.Widget:width-request] and
43171+[property@Gtk.Widget:height-request] properties manually.</doc>
43172+ <source-position filename="src/adw-window.h" line="33"/>
2861543173 <implements name="Gtk.Accessible"/>
2861643174 <implements name="Gtk.Buildable"/>
2861743175 <implements name="Gtk.ConstraintTarget"/>
@@ -28621,36 +43179,131 @@ instead.</doc>
2862143179 <constructor name="new" c:identifier="adw_window_new">
2862243180 <doc xml:space="preserve"
2862343181 filename="src/adw-window.c"
28624- line="183">Creates a new `AdwWindow`.</doc>
28625- <source-position filename="src/adw-window.h" line="33"/>
28626- <return-value transfer-ownership="none">
43182+ line="312">Creates a new `AdwWindow`.</doc>
43183+ <source-position filename="src/adw-window.h" line="36"/>
43184+ <return-value transfer-ownership="none">
43185+ <doc xml:space="preserve"
43186+ filename="src/adw-window.c"
43187+ line="317">the newly created `AdwWindow`</doc>
43188+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
43189+ </return-value>
43190+ </constructor>
43191+ <method name="add_breakpoint"
43192+ c:identifier="adw_window_add_breakpoint"
43193+ version="1.4">
43194+ <doc xml:space="preserve"
43195+ filename="src/adw-window.c"
43196+ line="378">Adds @breakpoint to @self.</doc>
43197+ <source-position filename="src/adw-window.h" line="45"/>
43198+ <return-value transfer-ownership="none">
43199+ <type name="none" c:type="void"/>
43200+ </return-value>
43201+ <parameters>
43202+ <instance-parameter name="self" transfer-ownership="none">
43203+ <doc xml:space="preserve"
43204+ filename="src/adw-window.c"
43205+ line="380">a window</doc>
43206+ <type name="Window" c:type="AdwWindow*"/>
43207+ </instance-parameter>
43208+ <parameter name="breakpoint" transfer-ownership="full">
43209+ <doc xml:space="preserve"
43210+ filename="src/adw-window.c"
43211+ line="381">the breakpoint to add</doc>
43212+ <type name="Breakpoint" c:type="AdwBreakpoint*"/>
43213+ </parameter>
43214+ </parameters>
43215+ </method>
43216+ <method name="get_content"
43217+ c:identifier="adw_window_get_content"
43218+ glib:get-property="content">
43219+ <doc xml:space="preserve"
43220+ filename="src/adw-window.c"
43221+ line="356">Gets the content widget of @self.
43222+
43223+This method should always be used instead of [method@Gtk.Window.get_child].</doc>
43224+ <source-position filename="src/adw-window.h" line="39"/>
43225+ <return-value transfer-ownership="none" nullable="1">
43226+ <doc xml:space="preserve"
43227+ filename="src/adw-window.c"
43228+ line="364">the content widget of @self</doc>
43229+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
43230+ </return-value>
43231+ <parameters>
43232+ <instance-parameter name="self" transfer-ownership="none">
43233+ <doc xml:space="preserve"
43234+ filename="src/adw-window.c"
43235+ line="358">a window</doc>
43236+ <type name="Window" c:type="AdwWindow*"/>
43237+ </instance-parameter>
43238+ </parameters>
43239+ </method>
43240+ <method name="get_current_breakpoint"
43241+ c:identifier="adw_window_get_current_breakpoint"
43242+ glib:get-property="current-breakpoint"
43243+ version="1.4">
43244+ <doc xml:space="preserve"
43245+ filename="src/adw-window.c"
43246+ line="401">Gets the current breakpoint.</doc>
43247+ <source-position filename="src/adw-window.h" line="49"/>
43248+ <return-value transfer-ownership="none" nullable="1">
2862743249 <doc xml:space="preserve"
2862843250 filename="src/adw-window.c"
28629- line="188">the newly created `AdwWindow`</doc>
28630- <type name="Gtk.Widget" c:type="GtkWidget*"/>
43251+ line="407">the current breakpoint</doc>
43252+ <type name="Breakpoint" c:type="AdwBreakpoint*"/>
2863143253 </return-value>
28632- </constructor>
28633- <method name="get_content"
28634- c:identifier="adw_window_get_content"
28635- glib:get-property="content">
28636- <attribute name="org.gtk.Method.get_property" value="content"/>
43254+ <parameters>
43255+ <instance-parameter name="self" transfer-ownership="none">
43256+ <doc xml:space="preserve"
43257+ filename="src/adw-window.c"
43258+ line="403">a window</doc>
43259+ <type name="Window" c:type="AdwWindow*"/>
43260+ </instance-parameter>
43261+ </parameters>
43262+ </method>
43263+ <method name="get_dialogs"
43264+ c:identifier="adw_window_get_dialogs"
43265+ glib:get-property="dialogs"
43266+ version="1.5">
2863743267 <doc xml:space="preserve"
2863843268 filename="src/adw-window.c"
28639- line="220">Gets the content widget of @self.
43269+ line="423">Returns a [iface@Gio.ListModel] that contains the open dialogs of @self.
2864043270
28641-This method should always be used instead of [method@Gtk.Window.get_child].</doc>
28642- <source-position filename="src/adw-window.h" line="36"/>
43271+This can be used to keep an up-to-date view.</doc>
43272+ <source-position filename="src/adw-window.h" line="52"/>
43273+ <return-value transfer-ownership="full">
43274+ <doc xml:space="preserve"
43275+ filename="src/adw-window.c"
43276+ line="431">a list model for the dialogs of @self</doc>
43277+ <type name="Gio.ListModel" c:type="GListModel*"/>
43278+ </return-value>
43279+ <parameters>
43280+ <instance-parameter name="self" transfer-ownership="none">
43281+ <doc xml:space="preserve"
43282+ filename="src/adw-window.c"
43283+ line="425">a window</doc>
43284+ <type name="Window" c:type="AdwWindow*"/>
43285+ </instance-parameter>
43286+ </parameters>
43287+ </method>
43288+ <method name="get_visible_dialog"
43289+ c:identifier="adw_window_get_visible_dialog"
43290+ glib:get-property="visible-dialog"
43291+ version="1.5">
43292+ <doc xml:space="preserve"
43293+ filename="src/adw-window.c"
43294+ line="447">Returns the currently visible dialog in @self, if there's one.</doc>
43295+ <source-position filename="src/adw-window.h" line="55"/>
2864343296 <return-value transfer-ownership="none" nullable="1">
2864443297 <doc xml:space="preserve"
2864543298 filename="src/adw-window.c"
28646- line="228">the content widget of @self</doc>
28647- <type name="Gtk.Widget" c:type="GtkWidget*"/>
43299+ line="453">the visible dialog</doc>
43300+ <type name="Dialog" c:type="AdwDialog*"/>
2864843301 </return-value>
2864943302 <parameters>
2865043303 <instance-parameter name="self" transfer-ownership="none">
2865143304 <doc xml:space="preserve"
2865243305 filename="src/adw-window.c"
28653- line="222">a window</doc>
43306+ line="449">a window</doc>
2865443307 <type name="Window" c:type="AdwWindow*"/>
2865543308 </instance-parameter>
2865643309 </parameters>
@@ -28658,13 +43311,12 @@ This method should always be used instead of [method@Gtk.Window.get_child].</doc
2865843311 <method name="set_content"
2865943312 c:identifier="adw_window_set_content"
2866043313 glib:set-property="content">
28661- <attribute name="org.gtk.Method.set_property" value="content"/>
2866243314 <doc xml:space="preserve"
2866343315 filename="src/adw-window.c"
28664- line="196">Sets the content widget of @self.
43316+ line="325">Sets the content widget of @self.
2866543317
2866643318 This method should always be used instead of [method@Gtk.Window.set_child].</doc>
28667- <source-position filename="src/adw-window.h" line="38"/>
43319+ <source-position filename="src/adw-window.h" line="41"/>
2866843320 <return-value transfer-ownership="none">
2866943321 <type name="none" c:type="void"/>
2867043322 </return-value>
@@ -28672,7 +43324,7 @@ This method should always be used instead of [method@Gtk.Window.set_child].</doc
2867243324 <instance-parameter name="self" transfer-ownership="none">
2867343325 <doc xml:space="preserve"
2867443326 filename="src/adw-window.c"
28675- line="198">a window</doc>
43327+ line="327">a window</doc>
2867643328 <type name="Window" c:type="AdwWindow*"/>
2867743329 </instance-parameter>
2867843330 <parameter name="content"
@@ -28681,7 +43333,7 @@ This method should always be used instead of [method@Gtk.Window.set_child].</doc
2868143333 allow-none="1">
2868243334 <doc xml:space="preserve"
2868343335 filename="src/adw-window.c"
28684- line="199">the content widget</doc>
43336+ line="328">the content widget</doc>
2868543337 <type name="Gtk.Widget" c:type="GtkWidget*"/>
2868643338 </parameter>
2868743339 </parameters>
@@ -28691,15 +43343,40 @@ This method should always be used instead of [method@Gtk.Window.set_child].</doc
2869143343 transfer-ownership="none"
2869243344 setter="set_content"
2869343345 getter="get_content">
28694- <attribute name="org.gtk.Property.get" value="adw_window_get_content"/>
28695- <attribute name="org.gtk.Property.set" value="adw_window_set_content"/>
2869643346 <doc xml:space="preserve"
2869743347 filename="src/adw-window.c"
28698- line="137">The content widget.
43348+ line="209">The content widget.
2869943349
2870043350 This property should always be used instead of [property@Gtk.Window:child].</doc>
2870143351 <type name="Gtk.Widget"/>
2870243352 </property>
43353+ <property name="current-breakpoint"
43354+ version="1.4"
43355+ transfer-ownership="none"
43356+ getter="get_current_breakpoint">
43357+ <doc xml:space="preserve"
43358+ filename="src/adw-window.c"
43359+ line="221">The current breakpoint.</doc>
43360+ <type name="Breakpoint"/>
43361+ </property>
43362+ <property name="dialogs"
43363+ version="1.5"
43364+ transfer-ownership="none"
43365+ getter="get_dialogs">
43366+ <doc xml:space="preserve"
43367+ filename="src/adw-window.c"
43368+ line="233">The open dialogs.</doc>
43369+ <type name="Gio.ListModel"/>
43370+ </property>
43371+ <property name="visible-dialog"
43372+ version="1.5"
43373+ transfer-ownership="none"
43374+ getter="get_visible_dialog">
43375+ <doc xml:space="preserve"
43376+ filename="src/adw-window.c"
43377+ line="245">The currently visible dialog</doc>
43378+ <type name="Dialog"/>
43379+ </property>
2870343380 <field name="parent_instance">
2870443381 <type name="Gtk.Window" c:type="GtkWindow"/>
2870543382 </field>
@@ -28707,7 +43384,7 @@ This property should always be used instead of [property@Gtk.Window:child].</doc
2870743384 <record name="WindowClass"
2870843385 c:type="AdwWindowClass"
2870943386 glib:is-gtype-struct-for="Window">
28710- <source-position filename="src/adw-window.h" line="30"/>
43387+ <source-position filename="src/adw-window.h" line="33"/>
2871143388 <field name="parent_class">
2871243389 <type name="Gtk.WindowClass" c:type="GtkWindowClass"/>
2871343390 </field>
@@ -28773,7 +43450,6 @@ title child of [class@Gtk.HeaderBar] or [class@HeaderBar].
2877343450 <method name="get_subtitle"
2877443451 c:identifier="adw_window_title_get_subtitle"
2877543452 glib:get-property="subtitle">
28776- <attribute name="org.gtk.Method.get_property" value="subtitle"/>
2877743453 <doc xml:space="preserve"
2877843454 filename="src/adw-window-title.c"
2877943455 line="213">Gets the subtitle of @self.</doc>
@@ -28796,7 +43472,6 @@ title child of [class@Gtk.HeaderBar] or [class@HeaderBar].
2879643472 <method name="get_title"
2879743473 c:identifier="adw_window_title_get_title"
2879843474 glib:get-property="title">
28799- <attribute name="org.gtk.Method.get_property" value="title"/>
2880043475 <doc xml:space="preserve"
2880143476 filename="src/adw-window-title.c"
2880243477 line="171">Gets the title of @self.</doc>
@@ -28819,7 +43494,6 @@ title child of [class@Gtk.HeaderBar] or [class@HeaderBar].
2881943494 <method name="set_subtitle"
2882043495 c:identifier="adw_window_title_set_subtitle"
2882143496 glib:set-property="subtitle">
28822- <attribute name="org.gtk.Method.set_property" value="subtitle"/>
2882343497 <doc xml:space="preserve"
2882443498 filename="src/adw-window-title.c"
2882543499 line="229">Sets the subtitle of @self.
@@ -28847,7 +43521,6 @@ The subtitle should give the user additional details.</doc>
2884743521 <method name="set_title"
2884843522 c:identifier="adw_window_title_set_title"
2884943523 glib:set-property="title">
28850- <attribute name="org.gtk.Method.set_property" value="title"/>
2885143524 <doc xml:space="preserve"
2885243525 filename="src/adw-window-title.c"
2885343526 line="187">Sets the title of @self.
@@ -28878,10 +43551,6 @@ generally does not use the application name.</doc>
2887843551 transfer-ownership="none"
2887943552 setter="set_subtitle"
2888043553 getter="get_subtitle">
28881- <attribute name="org.gtk.Property.get"
28882- value="adw_window_title_get_subtitle"/>
28883- <attribute name="org.gtk.Property.set"
28884- value="adw_window_title_set_subtitle"/>
2888543554 <doc xml:space="preserve"
2888643555 filename="src/adw-window-title.c"
2888743556 line="128">The subtitle to display.
@@ -28894,10 +43563,6 @@ The subtitle should give the user additional details.</doc>
2889443563 transfer-ownership="none"
2889543564 setter="set_title"
2889643565 getter="get_title">
28897- <attribute name="org.gtk.Property.get"
28898- value="adw_window_title_get_title"/>
28899- <attribute name="org.gtk.Property.set"
28900- value="adw_window_title_set_title"/>
2890143566 <doc xml:space="preserve"
2890243567 filename="src/adw-window-title.c"
2890343568 line="115">The title to display.
@@ -28915,6 +43580,152 @@ generally does not use the application name.</doc>
2891543580 <type name="Gtk.WidgetClass" c:type="GtkWidgetClass"/>
2891643581 </field>
2891743582 </record>
43583+ <function name="accent_color_to_rgba"
43584+ c:identifier="adw_accent_color_to_rgba"
43585+ moved-to="AccentColor.to_rgba"
43586+ version="1.6">
43587+ <doc xml:space="preserve"
43588+ filename="src/adw-accent-color.c"
43589+ line="31">Converts @self to a `GdkRGBA` representing its background color.
43590+
43591+The matching foreground color is white.</doc>
43592+ <source-position filename="src/adw-accent-color.h" line="32"/>
43593+ <return-value transfer-ownership="none">
43594+ <type name="none" c:type="void"/>
43595+ </return-value>
43596+ <parameters>
43597+ <parameter name="self" transfer-ownership="none">
43598+ <doc xml:space="preserve"
43599+ filename="src/adw-accent-color.c"
43600+ line="33">an accent color</doc>
43601+ <type name="AccentColor" c:type="AdwAccentColor"/>
43602+ </parameter>
43603+ <parameter name="rgba"
43604+ direction="out"
43605+ caller-allocates="1"
43606+ transfer-ownership="none">
43607+ <doc xml:space="preserve"
43608+ filename="src/adw-accent-color.c"
43609+ line="34">return location for the color</doc>
43610+ <type name="Gdk.RGBA" c:type="GdkRGBA*"/>
43611+ </parameter>
43612+ </parameters>
43613+ </function>
43614+ <function name="accent_color_to_standalone_rgba"
43615+ c:identifier="adw_accent_color_to_standalone_rgba"
43616+ moved-to="AccentColor.to_standalone_rgba"
43617+ version="1.6">
43618+ <doc xml:space="preserve"
43619+ filename="src/adw-accent-color.c"
43620+ line="88">Converts @self to a `GdkRGBA` representing its standalone color.
43621+
43622+It will typically be darker for light background, and lighter for dark
43623+background, ensuring contrast.</doc>
43624+ <source-position filename="src/adw-accent-color.h" line="36"/>
43625+ <return-value transfer-ownership="none">
43626+ <type name="none" c:type="void"/>
43627+ </return-value>
43628+ <parameters>
43629+ <parameter name="self" transfer-ownership="none">
43630+ <doc xml:space="preserve"
43631+ filename="src/adw-accent-color.c"
43632+ line="90">an accent color</doc>
43633+ <type name="AccentColor" c:type="AdwAccentColor"/>
43634+ </parameter>
43635+ <parameter name="dark" transfer-ownership="none">
43636+ <doc xml:space="preserve"
43637+ filename="src/adw-accent-color.c"
43638+ line="91">Whether to calculate standalone color for light or dark background</doc>
43639+ <type name="gboolean" c:type="gboolean"/>
43640+ </parameter>
43641+ <parameter name="rgba"
43642+ direction="out"
43643+ caller-allocates="1"
43644+ transfer-ownership="none">
43645+ <doc xml:space="preserve"
43646+ filename="src/adw-accent-color.c"
43647+ line="92">return location for the color</doc>
43648+ <type name="Gdk.RGBA" c:type="GdkRGBA*"/>
43649+ </parameter>
43650+ </parameters>
43651+ </function>
43652+ <function name="breakpoint_condition_parse"
43653+ c:identifier="adw_breakpoint_condition_parse"
43654+ moved-to="BreakpointCondition.parse"
43655+ version="1.4">
43656+ <doc xml:space="preserve"
43657+ filename="src/adw-breakpoint.c"
43658+ line="709">Parses a condition from a string.
43659+
43660+Length conditions are specified as `&lt;type&gt;: &lt;value&gt;[&lt;unit&gt;]`, where:
43661+
43662+- `&lt;type&gt;` can be `min-width`, `max-width`, `min-height` or `max-height`
43663+- `&lt;value&gt;` is a fractional number
43664+- `&lt;unit&gt;` can be `px`, `pt` or `sp`
43665+
43666+If the unit is omitted, `px` is assumed.
43667+
43668+See [ctor@BreakpointCondition.new_length].
43669+
43670+Examples:
43671+
43672+- `min-width: 500px`
43673+- `min-height: 400pt`
43674+- `max-width: 100sp`
43675+- `max-height: 500`
43676+
43677+Ratio conditions are specified as `&lt;type&gt;: &lt;width&gt;[/&lt;height&gt;]`, where:
43678+
43679+- `&lt;type&gt;` can be `min-aspect-ratio` or `max-aspect-ratio`
43680+- `&lt;width&gt;` and `&lt;height&gt;` are integer numbers
43681+
43682+See [ctor@BreakpointCondition.new_ratio].
43683+
43684+The ratio is represented as `&lt;width&gt;` divided by `&lt;height&gt;`.
43685+
43686+If `&lt;height&gt;` is omitted, it's assumed to be 1.
43687+
43688+Examples:
43689+
43690+- `min-aspect-ratio: 4/3`
43691+- `max-aspect-ratio: 1`
43692+
43693+The logical operators `and`, `or` can be used to compose a complex condition
43694+as follows:
43695+
43696+- `&lt;condition&gt; and &lt;condition&gt;`: the condition is true when both
43697+ `&lt;condition&gt;`s are true, same as when using
43698+ [ctor@BreakpointCondition.new_and]
43699+- `&lt;condition&gt; or &lt;condition&gt;`: the condition is true when either of the
43700+ `&lt;condition&gt;`s is true, same as when using
43701+ [ctor@BreakpointCondition.new_or]
43702+
43703+Examples:
43704+
43705+- `min-width: 400px and max-aspect-ratio: 4/3`
43706+- `max-width: 360sp or max-width: 360px`
43707+
43708+Conditions can be further nested using parentheses, for example:
43709+
43710+- `min-width: 400px and (max-aspect-ratio: 4/3 or max-height: 400px)`
43711+
43712+If parentheses are omitted, the first operator takes priority.</doc>
43713+ <source-position filename="src/adw-breakpoint.h" line="66"/>
43714+ <return-value transfer-ownership="full">
43715+ <doc xml:space="preserve"
43716+ filename="src/adw-breakpoint.c"
43717+ line="769">the parsed condition</doc>
43718+ <type name="BreakpointCondition" c:type="AdwBreakpointCondition*"/>
43719+ </return-value>
43720+ <parameters>
43721+ <parameter name="str" transfer-ownership="none">
43722+ <doc xml:space="preserve"
43723+ filename="src/adw-breakpoint.c"
43724+ line="711">the string specifying the condition</doc>
43725+ <type name="utf8" c:type="const char*"/>
43726+ </parameter>
43727+ </parameters>
43728+ </function>
2891843729 <function name="easing_ease"
2891943730 c:identifier="adw_easing_ease"
2892043731 moved-to="Easing.ease">
@@ -28980,7 +43791,7 @@ This function is in the library, so it represents the libadwaita library your
2898043791 code is running against. Contrast with the [const@MAJOR_VERSION] constant,
2898143792 which represents the major version of the libadwaita headers you have
2898243793 included when compiling your code.</doc>
28983- <source-position filename="src/adw-version.h" line="193"/>
43794+ <source-position filename="src/adw-version.h" line="277"/>
2898443795 <return-value transfer-ownership="none">
2898543796 <doc xml:space="preserve"
2898643797 filename="src/adw-version.c"
@@ -28999,7 +43810,7 @@ This function is in the library, so it represents the libadwaita library your
2899943810 code is running against. Contrast with the [const@MAJOR_VERSION] constant,
2900043811 which represents the micro version of the libadwaita headers you have
2900143812 included when compiling your code.</doc>
29002- <source-position filename="src/adw-version.h" line="197"/>
43813+ <source-position filename="src/adw-version.h" line="281"/>
2900343814 <return-value transfer-ownership="none">
2900443815 <doc xml:space="preserve"
2900543816 filename="src/adw-version.c"
@@ -29018,7 +43829,7 @@ This function is in the library, so it represents the libadwaita library your
2901843829 code is running against. Contrast with the [const@MAJOR_VERSION] constant,
2901943830 which represents the minor version of the libadwaita headers you have
2902043831 included when compiling your code.</doc>
29021- <source-position filename="src/adw-version.h" line="195"/>
43832+ <source-position filename="src/adw-version.h" line="279"/>
2902243833 <return-value transfer-ownership="none">
2902343834 <doc xml:space="preserve"
2902443835 filename="src/adw-version.c"
@@ -29058,6 +43869,82 @@ library are set up properly.</doc>
2905843869 <type name="gboolean" c:type="gboolean"/>
2905943870 </return-value>
2906043871 </function>
43872+ <function name="length_unit_from_px"
43873+ c:identifier="adw_length_unit_from_px"
43874+ moved-to="LengthUnit.from_px"
43875+ version="1.4">
43876+ <doc xml:space="preserve"
43877+ filename="src/adw-length-unit.c"
43878+ line="84">Converts @value from pixels to @unit.</doc>
43879+ <source-position filename="src/adw-length-unit.h" line="33"/>
43880+ <return-value transfer-ownership="none">
43881+ <doc xml:space="preserve"
43882+ filename="src/adw-length-unit.c"
43883+ line="92">the length in @unit</doc>
43884+ <type name="gdouble" c:type="double"/>
43885+ </return-value>
43886+ <parameters>
43887+ <parameter name="unit" transfer-ownership="none">
43888+ <doc xml:space="preserve"
43889+ filename="src/adw-length-unit.c"
43890+ line="86">a length unit</doc>
43891+ <type name="LengthUnit" c:type="AdwLengthUnit"/>
43892+ </parameter>
43893+ <parameter name="value" transfer-ownership="none">
43894+ <doc xml:space="preserve"
43895+ filename="src/adw-length-unit.c"
43896+ line="87">a value in pixels</doc>
43897+ <type name="gdouble" c:type="double"/>
43898+ </parameter>
43899+ <parameter name="settings"
43900+ transfer-ownership="none"
43901+ nullable="1"
43902+ allow-none="1">
43903+ <doc xml:space="preserve"
43904+ filename="src/adw-length-unit.c"
43905+ line="88">settings to use, or `NULL` for default settings</doc>
43906+ <type name="Gtk.Settings" c:type="GtkSettings*"/>
43907+ </parameter>
43908+ </parameters>
43909+ </function>
43910+ <function name="length_unit_to_px"
43911+ c:identifier="adw_length_unit_to_px"
43912+ moved-to="LengthUnit.to_px"
43913+ version="1.4">
43914+ <doc xml:space="preserve"
43915+ filename="src/adw-length-unit.c"
43916+ line="45">Converts @value from @unit to pixels.</doc>
43917+ <source-position filename="src/adw-length-unit.h" line="28"/>
43918+ <return-value transfer-ownership="none">
43919+ <doc xml:space="preserve"
43920+ filename="src/adw-length-unit.c"
43921+ line="53">the length in pixels</doc>
43922+ <type name="gdouble" c:type="double"/>
43923+ </return-value>
43924+ <parameters>
43925+ <parameter name="unit" transfer-ownership="none">
43926+ <doc xml:space="preserve"
43927+ filename="src/adw-length-unit.c"
43928+ line="47">a length unit</doc>
43929+ <type name="LengthUnit" c:type="AdwLengthUnit"/>
43930+ </parameter>
43931+ <parameter name="value" transfer-ownership="none">
43932+ <doc xml:space="preserve"
43933+ filename="src/adw-length-unit.c"
43934+ line="48">a value in @unit</doc>
43935+ <type name="gdouble" c:type="double"/>
43936+ </parameter>
43937+ <parameter name="settings"
43938+ transfer-ownership="none"
43939+ nullable="1"
43940+ allow-none="1">
43941+ <doc xml:space="preserve"
43942+ filename="src/adw-length-unit.c"
43943+ line="49">settings to use, or `NULL` for default settings</doc>
43944+ <type name="Gtk.Settings" c:type="GtkSettings*"/>
43945+ </parameter>
43946+ </parameters>
43947+ </function>
2906143948 <function name="lerp" c:identifier="adw_lerp">
2906243949 <doc xml:space="preserve"
2906343950 filename="src/adw-animation-util.c"
@@ -29090,14 +43977,180 @@ library are set up properly.</doc>
2909043977 </parameter>
2909143978 </parameters>
2909243979 </function>
43980+ <function name="rgba_to_standalone"
43981+ c:identifier="adw_rgba_to_standalone"
43982+ version="1.6">
43983+ <doc xml:space="preserve"
43984+ filename="src/adw-accent-color.c"
43985+ line="116">Adjusts @rgba to be suitable as a standalone color.
43986+
43987+It will typically be darker for light background, and lighter for dark
43988+background, ensuring contrast.</doc>
43989+ <source-position filename="src/adw-accent-color.h" line="41"/>
43990+ <return-value transfer-ownership="none">
43991+ <type name="none" c:type="void"/>
43992+ </return-value>
43993+ <parameters>
43994+ <parameter name="rgba" transfer-ownership="none">
43995+ <doc xml:space="preserve"
43996+ filename="src/adw-accent-color.c"
43997+ line="118">a background color</doc>
43998+ <type name="Gdk.RGBA" c:type="const GdkRGBA*"/>
43999+ </parameter>
44000+ <parameter name="dark" transfer-ownership="none">
44001+ <doc xml:space="preserve"
44002+ filename="src/adw-accent-color.c"
44003+ line="119">Whether to calculate standalone color for light or dark background</doc>
44004+ <type name="gboolean" c:type="gboolean"/>
44005+ </parameter>
44006+ <parameter name="standalone_rgba"
44007+ direction="out"
44008+ caller-allocates="1"
44009+ transfer-ownership="none">
44010+ <doc xml:space="preserve"
44011+ filename="src/adw-accent-color.c"
44012+ line="120">return location for the standalone color</doc>
44013+ <type name="Gdk.RGBA" c:type="GdkRGBA*"/>
44014+ </parameter>
44015+ </parameters>
44016+ </function>
44017+ <function name="show_about_dialog"
44018+ c:identifier="adw_show_about_dialog"
44019+ version="1.5"
44020+ introspectable="0">
44021+ <doc xml:space="preserve"
44022+ filename="src/adw-about-dialog.c"
44023+ line="3416">A convenience function for showing an application’s about dialog.</doc>
44024+ <source-position filename="src/adw-about-dialog.h" line="177"/>
44025+ <return-value transfer-ownership="none">
44026+ <type name="none" c:type="void"/>
44027+ </return-value>
44028+ <parameters>
44029+ <parameter name="parent" transfer-ownership="none">
44030+ <doc xml:space="preserve"
44031+ filename="src/adw-about-dialog.c"
44032+ line="3418">the parent widget</doc>
44033+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
44034+ </parameter>
44035+ <parameter name="first_property_name" transfer-ownership="none">
44036+ <doc xml:space="preserve"
44037+ filename="src/adw-about-dialog.c"
44038+ line="3419">the name of the first property</doc>
44039+ <type name="utf8" c:type="const char*"/>
44040+ </parameter>
44041+ <parameter name="..." transfer-ownership="none">
44042+ <doc xml:space="preserve"
44043+ filename="src/adw-about-dialog.c"
44044+ line="3420">value of first property, followed by more pairs of property name and
44045+ value, `NULL`-terminated</doc>
44046+ <varargs/>
44047+ </parameter>
44048+ </parameters>
44049+ </function>
44050+ <function name="show_about_dialog_from_appdata"
44051+ c:identifier="adw_show_about_dialog_from_appdata"
44052+ version="1.5"
44053+ introspectable="0">
44054+ <doc xml:space="preserve"
44055+ filename="src/adw-about-dialog.c"
44056+ line="3446">A convenience function for showing an application’s about dialog from
44057+AppStream metadata.
44058+
44059+See [ctor@AboutDialog.new_from_appdata] for details.</doc>
44060+ <source-position filename="src/adw-about-dialog.h" line="182"/>
44061+ <return-value transfer-ownership="none">
44062+ <type name="none" c:type="void"/>
44063+ </return-value>
44064+ <parameters>
44065+ <parameter name="parent" transfer-ownership="none">
44066+ <doc xml:space="preserve"
44067+ filename="src/adw-about-dialog.c"
44068+ line="3448">the parent widget</doc>
44069+ <type name="Gtk.Widget" c:type="GtkWidget*"/>
44070+ </parameter>
44071+ <parameter name="resource_path" transfer-ownership="none">
44072+ <doc xml:space="preserve"
44073+ filename="src/adw-about-dialog.c"
44074+ line="3449">The resource to use</doc>
44075+ <type name="utf8" c:type="const char*"/>
44076+ </parameter>
44077+ <parameter name="release_notes_version"
44078+ transfer-ownership="none"
44079+ nullable="1"
44080+ allow-none="1">
44081+ <doc xml:space="preserve"
44082+ filename="src/adw-about-dialog.c"
44083+ line="3450">The version to retrieve release notes for</doc>
44084+ <type name="utf8" c:type="const char*"/>
44085+ </parameter>
44086+ <parameter name="first_property_name" transfer-ownership="none">
44087+ <doc xml:space="preserve"
44088+ filename="src/adw-about-dialog.c"
44089+ line="3451">the name of the first property</doc>
44090+ <type name="utf8" c:type="const char*"/>
44091+ </parameter>
44092+ <parameter name="..." transfer-ownership="none">
44093+ <doc xml:space="preserve"
44094+ filename="src/adw-about-dialog.c"
44095+ line="3452">value of first property, followed by more pairs of property name and
44096+ value, `NULL`-terminated</doc>
44097+ <varargs/>
44098+ </parameter>
44099+ </parameters>
44100+ </function>
2909344101 <function name="show_about_window"
2909444102 c:identifier="adw_show_about_window"
2909544103 version="1.2"
29096- introspectable="0">
44104+ introspectable="0"
44105+ deprecated="1"
44106+ deprecated-version="1.6">
44107+ <doc xml:space="preserve"
44108+ filename="src/adw-about-window.c"
44109+ line="3483">A convenience function for showing an application’s about window.</doc>
44110+ <doc-deprecated xml:space="preserve">Use [func@show_about_dialog].</doc-deprecated>
44111+ <source-position filename="src/adw-about-window.h" line="175"/>
44112+ <return-value transfer-ownership="none">
44113+ <type name="none" c:type="void"/>
44114+ </return-value>
44115+ <parameters>
44116+ <parameter name="parent"
44117+ transfer-ownership="none"
44118+ nullable="1"
44119+ allow-none="1">
44120+ <doc xml:space="preserve"
44121+ filename="src/adw-about-window.c"
44122+ line="3485">the parent top-level window</doc>
44123+ <type name="Gtk.Window" c:type="GtkWindow*"/>
44124+ </parameter>
44125+ <parameter name="first_property_name" transfer-ownership="none">
44126+ <doc xml:space="preserve"
44127+ filename="src/adw-about-window.c"
44128+ line="3486">the name of the first property</doc>
44129+ <type name="utf8" c:type="const char*"/>
44130+ </parameter>
44131+ <parameter name="..." transfer-ownership="none">
44132+ <doc xml:space="preserve"
44133+ filename="src/adw-about-window.c"
44134+ line="3487">value of first property, followed by more pairs of property name and
44135+ value, `NULL`-terminated</doc>
44136+ <varargs/>
44137+ </parameter>
44138+ </parameters>
44139+ </function>
44140+ <function name="show_about_window_from_appdata"
44141+ c:identifier="adw_show_about_window_from_appdata"
44142+ version="1.4"
44143+ introspectable="0"
44144+ deprecated="1"
44145+ deprecated-version="1.6">
2909744146 <doc xml:space="preserve"
2909844147 filename="src/adw-about-window.c"
29099- line="3264">A convenience function for showing an application’s about window.</doc>
29100- <source-position filename="src/adw-about-window.h" line="171"/>
44148+ line="3515">A convenience function for showing an application’s about window from
44149+AppStream metadata.
44150+
44151+See [ctor@AboutWindow.new_from_appdata] for details.</doc>
44152+ <doc-deprecated xml:space="preserve">Use [func@show_about_dialog_from_appdata].</doc-deprecated>
44153+ <source-position filename="src/adw-about-window.h" line="180"/>
2910144154 <return-value transfer-ownership="none">
2910244155 <type name="none" c:type="void"/>
2910344156 </return-value>
@@ -29108,19 +44161,34 @@ library are set up properly.</doc>
2910844161 allow-none="1">
2910944162 <doc xml:space="preserve"
2911044163 filename="src/adw-about-window.c"
29111- line="3266">the parent top-level window</doc>
44164+ line="3517">the parent top-level window</doc>
2911244165 <type name="Gtk.Window" c:type="GtkWindow*"/>
2911344166 </parameter>
44167+ <parameter name="resource_path" transfer-ownership="none">
44168+ <doc xml:space="preserve"
44169+ filename="src/adw-about-window.c"
44170+ line="3518">The resource to use</doc>
44171+ <type name="utf8" c:type="const char*"/>
44172+ </parameter>
44173+ <parameter name="release_notes_version"
44174+ transfer-ownership="none"
44175+ nullable="1"
44176+ allow-none="1">
44177+ <doc xml:space="preserve"
44178+ filename="src/adw-about-window.c"
44179+ line="3519">The version to retrieve release notes for</doc>
44180+ <type name="utf8" c:type="const char*"/>
44181+ </parameter>
2911444182 <parameter name="first_property_name" transfer-ownership="none">
2911544183 <doc xml:space="preserve"
2911644184 filename="src/adw-about-window.c"
29117- line="3267">the name of the first property</doc>
44185+ line="3520">the name of the first property</doc>
2911844186 <type name="utf8" c:type="const char*"/>
2911944187 </parameter>
2912044188 <parameter name="..." transfer-ownership="none">
2912144189 <doc xml:space="preserve"
2912244190 filename="src/adw-about-window.c"
29123- line="3268">value of first property, followed by more pairs of property name and
44191+ line="3521">value of first property, followed by more pairs of property name and
2912444192 value, `NULL`-terminated</doc>
2912544193 <varargs/>
2912644194 </parameter>

Keyboard shortcuts

Single-key shortcuts are on. ctrl k and esc work whatever this says.

ctrl k :
go to a section, branch, tag, file or repository
?
this list
j k
move the row cursor down / up
enter
open the row under the cursor; on Files, a directory opens or closes in place
↑ ↓ ← → home end
in the file tree (focus on a row): previous / next row, close / open a directory or go to its parent / first entry, first / last row. They never open a file
l h
on Files: open a directory or a file / close a directory or go up to its parent, then to the parent page. Elsewhere: into the side panel (on a merge request, its files) / back to the content; there j k move between its controls
g g G
first / last row
/
filter the list; on Files, find a file anywhere in the repository (esc clears, enter opens the best match)
b
switch branch or tag
g s g f g c g b g m g i g r g a
tabs: summary, files, commits, branches & tags, merge requests, issues, releases, actions (when available)
g h
home
w
wide mode: use the whole width of the screen, or not (remembered)
y
copy a permalink pinned to the commit
d u x
diff: split / unified / collapse or expand all
e E
diff: the whole file in view / every file, with the lines the hunks hide
n
merge request: next note in the diff
esc
close a dialog, leave a field

Branches 1

Tags 102

↑↓ moveenter openesc close