@girs/handy-1 4.3.0 → 4.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/handy-1.d.ts CHANGED
@@ -48,11 +48,11 @@ export namespace Handy {
48
48
  /**
49
49
  * Keep the title centered when possible
50
50
  */
51
- LOOSE,
51
+ LOOSE = 0,
52
52
  /**
53
53
  * Keep the title centered at all cost
54
54
  */
55
- STRICT,
55
+ STRICT = 1,
56
56
  }
57
57
 
58
58
 
@@ -74,25 +74,25 @@ export namespace Handy {
74
74
  * {@link StyleManager} returned by {@link StyleManager.get_default}, it's
75
75
  * equivalent to `HDY_COLOR_SCHEME_FORCE_LIGHT`.
76
76
  */
77
- DEFAULT,
77
+ DEFAULT = 0,
78
78
  /**
79
79
  * Always use light appearance.
80
80
  */
81
- FORCE_LIGHT,
81
+ FORCE_LIGHT = 1,
82
82
  /**
83
83
  * Use light appearance unless the system
84
84
  * prefers dark colors.
85
85
  */
86
- PREFER_LIGHT,
86
+ PREFER_LIGHT = 2,
87
87
  /**
88
88
  * Use dark appearance unless the system prefers
89
89
  * light colors.
90
90
  */
91
- PREFER_DARK,
91
+ PREFER_DARK = 3,
92
92
  /**
93
93
  * Always use dark appearance.
94
94
  */
95
- FORCE_DARK,
95
+ FORCE_DARK = 4,
96
96
  }
97
97
 
98
98
 
@@ -116,18 +116,18 @@ export namespace Handy {
116
116
  * sliding from or towards the end according to orientation, text direction
117
117
  * and children order
118
118
  */
119
- OVER,
119
+ OVER = 0,
120
120
  /**
121
121
  * Uncover the new page or cover the old page,
122
122
  * sliding from or towards the start according to orientation, text direction
123
123
  * and children order
124
124
  */
125
- UNDER,
125
+ UNDER = 1,
126
126
  /**
127
127
  * Slide from left, right, up or down according
128
128
  * to the orientation, text direction and the children order
129
129
  */
130
- SLIDE,
130
+ SLIDE = 2,
131
131
  }
132
132
 
133
133
 
@@ -148,16 +148,16 @@ export namespace Handy {
148
148
  * Disable folding, the flap cannot reach narrow
149
149
  * sizes.
150
150
  */
151
- NEVER,
151
+ NEVER = 0,
152
152
  /**
153
153
  * Keep the flap always folded.
154
154
  */
155
- ALWAYS,
155
+ ALWAYS = 1,
156
156
  /**
157
157
  * Fold and unfold the flap based on available
158
158
  * space.
159
159
  */
160
- AUTO,
160
+ AUTO = 2,
161
161
  }
162
162
 
163
163
 
@@ -184,18 +184,18 @@ export namespace Handy {
184
184
  * The flap slides over the content, which is
185
185
  * dimmed. When folded, only the flap can be swiped.
186
186
  */
187
- OVER,
187
+ OVER = 0,
188
188
  /**
189
189
  * The content slides over the flap. Only the
190
190
  * content can be swiped.
191
191
  */
192
- UNDER,
192
+ UNDER = 1,
193
193
  /**
194
194
  * The flap slides offscreen when hidden,
195
195
  * neither the flap nor content overlap each other. Both widgets can be
196
196
  * swiped.
197
197
  */
198
- SLIDE,
198
+ SLIDE = 2,
199
199
  }
200
200
 
201
201
 
@@ -217,17 +217,17 @@ export namespace Handy {
217
217
  /**
218
218
  * The child is a {@link HeaderBar}
219
219
  */
220
- HEADER_BAR,
220
+ HEADER_BAR = 0,
221
221
  /**
222
222
  * The child is a
223
223
  * {@link Gtk.HeaderBar}
224
224
  */
225
- GTK_HEADER_BAR,
225
+ GTK_HEADER_BAR = 1,
226
226
  /**
227
227
  * The child is a
228
228
  * {@link HeaderGroup}
229
229
  */
230
- HEADER_GROUP,
230
+ HEADER_GROUP = 2,
231
231
  }
232
232
 
233
233
 
@@ -251,18 +251,18 @@ export namespace Handy {
251
251
  * page, sliding from or towards the end according to orientation, text
252
252
  * direction and children order
253
253
  */
254
- OVER,
254
+ OVER = 0,
255
255
  /**
256
256
  * Uncover the new page or cover the old
257
257
  * page, sliding from or towards the start according to orientation, text
258
258
  * direction and children order
259
259
  */
260
- UNDER,
260
+ UNDER = 1,
261
261
  /**
262
262
  * Slide from left, right, up or down
263
263
  * according to the orientation, text direction and the children order
264
264
  */
265
- SLIDE,
265
+ SLIDE = 2,
266
266
  }
267
267
 
268
268
 
@@ -283,12 +283,12 @@ export namespace Handy {
283
283
  * Corresponds to start or top, depending on
284
284
  * orientation and text direction
285
285
  */
286
- BACK,
286
+ BACK = 0,
287
287
  /**
288
288
  * Corresponds to end or bottom, depending on
289
289
  * orientation and text direction
290
290
  */
291
- FORWARD,
291
+ FORWARD = 1,
292
292
  }
293
293
 
294
294
 
@@ -308,11 +308,11 @@ export namespace Handy {
308
308
  /**
309
309
  * No transition
310
310
  */
311
- NONE,
311
+ NONE = 0,
312
312
  /**
313
313
  * A cross-fade
314
314
  */
315
- CROSSFADE,
315
+ CROSSFADE = 1,
316
316
  }
317
317
 
318
318
 
@@ -332,15 +332,15 @@ export namespace Handy {
332
332
  /**
333
333
  * Automatically adapt to the best fitting mode
334
334
  */
335
- AUTO,
335
+ AUTO = 0,
336
336
  /**
337
337
  * Force the narrow mode
338
338
  */
339
- NARROW,
339
+ NARROW = 1,
340
340
  /**
341
341
  * Force the wide mode
342
342
  */
343
- WIDE,
343
+ WIDE = 2,
344
344
  }
345
345
 
346
346
 
@@ -673,6 +673,7 @@ export namespace Handy {
673
673
  // Virtual methods
674
674
  /**
675
675
  * Activates `self`.
676
+ * @since 1.0
676
677
  * @virtual
677
678
  */
678
679
  vfunc_activate(): void;
@@ -680,6 +681,7 @@ export namespace Handy {
680
681
  // Methods
681
682
  /**
682
683
  * Activates `self`.
684
+ * @since 1.0
683
685
  */
684
686
  activate(): void;
685
687
 
@@ -692,24 +694,28 @@ export namespace Handy {
692
694
  /**
693
695
  * Adds a prefix widget to `self`.
694
696
  * @param widget the prefix widget
697
+ * @since 1.0
695
698
  */
696
699
  add_prefix(widget: Gtk.Widget): void;
697
700
 
698
701
  /**
699
702
  * Gets the widget activated when `self` is activated.
700
703
  * @returns the activatable widget for `self`
704
+ * @since 1.0
701
705
  */
702
706
  get_activatable_widget(): Gtk.Widget | null;
703
707
 
704
708
  /**
705
709
  * Gets the icon name for `self`.
706
710
  * @returns the icon name for `self`
711
+ * @since 1.0
707
712
  */
708
713
  get_icon_name(): string;
709
714
 
710
715
  /**
711
716
  * Gets the subtitle for `self`.
712
717
  * @returns the subtitle for `self`
718
+ * @since 1.0
713
719
  */
714
720
  get_subtitle(): string | null;
715
721
 
@@ -719,6 +725,7 @@ export namespace Handy {
719
725
  *
720
726
  * If the value is 0, the number of lines won't be limited.
721
727
  * @returns the number of lines at the end of which the subtitle label will be ellipsized
728
+ * @since 1.2
722
729
  */
723
730
  get_subtitle_lines(): number;
724
731
 
@@ -728,6 +735,7 @@ export namespace Handy {
728
735
  *
729
736
  * If the value is 0, the number of lines won't be limited.
730
737
  * @returns the number of lines at the end of which the title label will be ellipsized
738
+ * @since 1.2
731
739
  */
732
740
  get_title_lines(): number;
733
741
 
@@ -735,24 +743,28 @@ export namespace Handy {
735
743
  * Gets whether an embedded underline in the title or subtitle indicates a
736
744
  * mnemonic.
737
745
  * @returns whether an embedded underline in the title or subtitle indicates a mnemonic
746
+ * @since 1.0
738
747
  */
739
748
  get_use_underline(): boolean;
740
749
 
741
750
  /**
742
751
  * Sets the widget to activate when `self` is activated.
743
752
  * @param widget the target widget
753
+ * @since 1.0
744
754
  */
745
755
  set_activatable_widget(widget: Gtk.Widget | null): void;
746
756
 
747
757
  /**
748
758
  * Sets the icon name for `self`.
749
759
  * @param icon_name the icon name
760
+ * @since 1.0
750
761
  */
751
762
  set_icon_name(icon_name: string): void;
752
763
 
753
764
  /**
754
765
  * Sets the subtitle for `self`.
755
766
  * @param subtitle the subtitle
767
+ * @since 1.0
756
768
  */
757
769
  set_subtitle(subtitle: string | null): void;
758
770
 
@@ -762,6 +774,7 @@ export namespace Handy {
762
774
  *
763
775
  * If the value is 0, the number of lines won't be limited.
764
776
  * @param subtitle_lines the number of lines at the end of which the subtitle label will be ellipsized
777
+ * @since 1.2
765
778
  */
766
779
  set_subtitle_lines(subtitle_lines: number): void;
767
780
 
@@ -771,6 +784,7 @@ export namespace Handy {
771
784
  *
772
785
  * If the value is 0, the number of lines won't be limited.
773
786
  * @param title_lines the number of lines at the end of which the title label will be ellipsized
787
+ * @since 1.2
774
788
  */
775
789
  set_title_lines(title_lines: number): void;
776
790
 
@@ -778,6 +792,7 @@ export namespace Handy {
778
792
  * Sets whether an embedded underline in the title or subtitle indicates a
779
793
  * mnemonic.
780
794
  * @param use_underline `TRUE` if underlines in the text indicate mnemonics
795
+ * @since 1.0
781
796
  */
782
797
  set_use_underline(use_underline: boolean): void;
783
798
 
@@ -937,6 +952,7 @@ export namespace Handy {
937
952
  *
938
953
  * This function should only be called by {@link Gio.ActionGroup} implementations.
939
954
  * @param action_name the name of an action in the group
955
+ * @since 2.28
940
956
  */
941
957
  action_added(action_name: string): void;
942
958
 
@@ -946,6 +962,7 @@ export namespace Handy {
946
962
  * This function should only be called by {@link Gio.ActionGroup} implementations.
947
963
  * @param action_name the name of an action in the group
948
964
  * @param enabled whether the action is now enabled
965
+ * @since 2.28
949
966
  */
950
967
  action_enabled_changed(action_name: string, enabled: boolean): void;
951
968
 
@@ -954,6 +971,7 @@ export namespace Handy {
954
971
  *
955
972
  * This function should only be called by {@link Gio.ActionGroup} implementations.
956
973
  * @param action_name the name of an action in the group
974
+ * @since 2.28
957
975
  */
958
976
  action_removed(action_name: string): void;
959
977
 
@@ -963,6 +981,7 @@ export namespace Handy {
963
981
  * This function should only be called by {@link Gio.ActionGroup} implementations.
964
982
  * @param action_name the name of an action in the group
965
983
  * @param state the new state of the named action
984
+ * @since 2.28
966
985
  */
967
986
  action_state_changed(action_name: string, state: GLib.Variant): void;
968
987
 
@@ -1002,6 +1021,7 @@ export namespace Handy {
1002
1021
  * ```
1003
1022
  * @param action_name the name of the action to activate
1004
1023
  * @param parameter parameters to the activation
1024
+ * @since 2.28
1005
1025
  */
1006
1026
  activate_action(action_name: string, parameter: GLib.Variant | null): void;
1007
1027
 
@@ -1019,6 +1039,7 @@ export namespace Handy {
1019
1039
  * If the `value` GVariant is floating, it is consumed.
1020
1040
  * @param action_name the name of the action to request the change on
1021
1041
  * @param value the new state
1042
+ * @since 2.28
1022
1043
  */
1023
1044
  change_action_state(action_name: string, value: GLib.Variant): void;
1024
1045
 
@@ -1029,6 +1050,7 @@ export namespace Handy {
1029
1050
  * have its state changed from outside callers.
1030
1051
  * @param action_name the name of the action to query
1031
1052
  * @returns whether the action is currently enabled
1053
+ * @since 2.28
1032
1054
  */
1033
1055
  get_action_enabled(action_name: string): boolean;
1034
1056
 
@@ -1048,6 +1070,7 @@ export namespace Handy {
1048
1070
  * with the same name but a different parameter type.
1049
1071
  * @param action_name the name of the action to query
1050
1072
  * @returns the parameter type
1073
+ * @since 2.28
1051
1074
  */
1052
1075
  get_action_parameter_type(action_name: string): GLib.VariantType | null;
1053
1076
 
@@ -1062,6 +1085,7 @@ export namespace Handy {
1062
1085
  * {@link GLib.Variant.unref} when it is no longer required.
1063
1086
  * @param action_name the name of the action to query
1064
1087
  * @returns the current state of the action
1088
+ * @since 2.28
1065
1089
  */
1066
1090
  get_action_state(action_name: string): GLib.Variant | null;
1067
1091
 
@@ -1086,6 +1110,7 @@ export namespace Handy {
1086
1110
  * {@link GLib.Variant.unref} when it is no longer required.
1087
1111
  * @param action_name the name of the action to query
1088
1112
  * @returns the state range hint
1113
+ * @since 2.28
1089
1114
  */
1090
1115
  get_action_state_hint(action_name: string): GLib.Variant | null;
1091
1116
 
@@ -1108,6 +1133,7 @@ export namespace Handy {
1108
1133
  * with the same name but a different state type.
1109
1134
  * @param action_name the name of the action to query
1110
1135
  * @returns the state type, if the action is stateful
1136
+ * @since 2.28
1111
1137
  */
1112
1138
  get_action_state_type(action_name: string): GLib.VariantType | null;
1113
1139
 
@@ -1115,6 +1141,7 @@ export namespace Handy {
1115
1141
  * Checks if the named action exists within `action_group`.
1116
1142
  * @param action_name the name of the action to check for
1117
1143
  * @returns whether the named action exists
1144
+ * @since 2.28
1118
1145
  */
1119
1146
  has_action(action_name: string): boolean;
1120
1147
 
@@ -1124,6 +1151,7 @@ export namespace Handy {
1124
1151
  * The caller is responsible for freeing the list with {@link GLib.strfreev} when
1125
1152
  * it is no longer required.
1126
1153
  * @returns a `NULL`-terminated array of the names of the actions in the group
1154
+ * @since 2.28
1127
1155
  */
1128
1156
  list_actions(): string[];
1129
1157
 
@@ -1157,6 +1185,7 @@ export namespace Handy {
1157
1185
  * fields may or may not have been modified.
1158
1186
  * @param action_name the name of an action in the group
1159
1187
  * @returns `TRUE` if the action exists, else `FALSE`
1188
+ * @since 2.32
1160
1189
  */
1161
1190
  query_action(action_name: string): [boolean, boolean, GLib.VariantType | null, GLib.VariantType | null, GLib.Variant | null, GLib.Variant | null];
1162
1191
 
@@ -1165,6 +1194,7 @@ export namespace Handy {
1165
1194
  *
1166
1195
  * This function should only be called by {@link Gio.ActionGroup} implementations.
1167
1196
  * @param action_name the name of an action in the group
1197
+ * @since 2.28
1168
1198
  * @virtual
1169
1199
  */
1170
1200
  vfunc_action_added(action_name: string): void;
@@ -1175,6 +1205,7 @@ export namespace Handy {
1175
1205
  * This function should only be called by {@link Gio.ActionGroup} implementations.
1176
1206
  * @param action_name the name of an action in the group
1177
1207
  * @param enabled whether the action is now enabled
1208
+ * @since 2.28
1178
1209
  * @virtual
1179
1210
  */
1180
1211
  vfunc_action_enabled_changed(action_name: string, enabled: boolean): void;
@@ -1184,6 +1215,7 @@ export namespace Handy {
1184
1215
  *
1185
1216
  * This function should only be called by {@link Gio.ActionGroup} implementations.
1186
1217
  * @param action_name the name of an action in the group
1218
+ * @since 2.28
1187
1219
  * @virtual
1188
1220
  */
1189
1221
  vfunc_action_removed(action_name: string): void;
@@ -1194,6 +1226,7 @@ export namespace Handy {
1194
1226
  * This function should only be called by {@link Gio.ActionGroup} implementations.
1195
1227
  * @param action_name the name of an action in the group
1196
1228
  * @param state the new state of the named action
1229
+ * @since 2.28
1197
1230
  * @virtual
1198
1231
  */
1199
1232
  vfunc_action_state_changed(action_name: string, state: GLib.Variant): void;
@@ -1234,6 +1267,7 @@ export namespace Handy {
1234
1267
  * ```
1235
1268
  * @param action_name the name of the action to activate
1236
1269
  * @param parameter parameters to the activation
1270
+ * @since 2.28
1237
1271
  * @virtual
1238
1272
  */
1239
1273
  vfunc_activate_action(action_name: string, parameter: GLib.Variant | null): void;
@@ -1252,6 +1286,7 @@ export namespace Handy {
1252
1286
  * If the `value` GVariant is floating, it is consumed.
1253
1287
  * @param action_name the name of the action to request the change on
1254
1288
  * @param value the new state
1289
+ * @since 2.28
1255
1290
  * @virtual
1256
1291
  */
1257
1292
  vfunc_change_action_state(action_name: string, value: GLib.Variant): void;
@@ -1262,6 +1297,7 @@ export namespace Handy {
1262
1297
  * An action must be enabled in order to be activated or in order to
1263
1298
  * have its state changed from outside callers.
1264
1299
  * @param action_name the name of the action to query
1300
+ * @since 2.28
1265
1301
  * @virtual
1266
1302
  */
1267
1303
  vfunc_get_action_enabled(action_name: string): boolean;
@@ -1281,6 +1317,7 @@ export namespace Handy {
1281
1317
  * possible for an action to be removed and for a new action to be added
1282
1318
  * with the same name but a different parameter type.
1283
1319
  * @param action_name the name of the action to query
1320
+ * @since 2.28
1284
1321
  * @virtual
1285
1322
  */
1286
1323
  vfunc_get_action_parameter_type(action_name: string): GLib.VariantType | null;
@@ -1295,6 +1332,7 @@ export namespace Handy {
1295
1332
  * The return value (if non-`NULL`) should be freed with
1296
1333
  * {@link GLib.Variant.unref} when it is no longer required.
1297
1334
  * @param action_name the name of the action to query
1335
+ * @since 2.28
1298
1336
  * @virtual
1299
1337
  */
1300
1338
  vfunc_get_action_state(action_name: string): GLib.Variant | null;
@@ -1319,6 +1357,7 @@ export namespace Handy {
1319
1357
  * The return value (if non-`NULL`) should be freed with
1320
1358
  * {@link GLib.Variant.unref} when it is no longer required.
1321
1359
  * @param action_name the name of the action to query
1360
+ * @since 2.28
1322
1361
  * @virtual
1323
1362
  */
1324
1363
  vfunc_get_action_state_hint(action_name: string): GLib.Variant | null;
@@ -1341,6 +1380,7 @@ export namespace Handy {
1341
1380
  * possible for an action to be removed and for a new action to be added
1342
1381
  * with the same name but a different state type.
1343
1382
  * @param action_name the name of the action to query
1383
+ * @since 2.28
1344
1384
  * @virtual
1345
1385
  */
1346
1386
  vfunc_get_action_state_type(action_name: string): GLib.VariantType | null;
@@ -1348,6 +1388,7 @@ export namespace Handy {
1348
1388
  /**
1349
1389
  * Checks if the named action exists within `action_group`.
1350
1390
  * @param action_name the name of the action to check for
1391
+ * @since 2.28
1351
1392
  * @virtual
1352
1393
  */
1353
1394
  vfunc_has_action(action_name: string): boolean;
@@ -1357,6 +1398,7 @@ export namespace Handy {
1357
1398
  *
1358
1399
  * The caller is responsible for freeing the list with {@link GLib.strfreev} when
1359
1400
  * it is no longer required.
1401
+ * @since 2.28
1360
1402
  * @virtual
1361
1403
  */
1362
1404
  vfunc_list_actions(): string[];
@@ -1390,6 +1432,7 @@ export namespace Handy {
1390
1432
  * filled. If the action doesn’t exist, `FALSE` is returned and the
1391
1433
  * fields may or may not have been modified.
1392
1434
  * @param action_name the name of an action in the group
1435
+ * @since 2.32
1393
1436
  * @virtual
1394
1437
  */
1395
1438
  vfunc_query_action(action_name: string): [boolean, boolean, GLib.VariantType | null, GLib.VariantType | null, GLib.Variant | null, GLib.Variant | null];
@@ -1402,6 +1445,7 @@ export namespace Handy {
1402
1445
  *
1403
1446
  * The action map takes its own reference on `action`.
1404
1447
  * @param action a {@link Gio.Action}
1448
+ * @since 2.32
1405
1449
  */
1406
1450
  add_action(action: Gio.Action): void;
1407
1451
 
@@ -1418,6 +1462,7 @@ export namespace Handy {
1418
1462
  * If no such action exists, returns `NULL`.
1419
1463
  * @param action_name the name of an action
1420
1464
  * @returns a {@link Gio.Action}
1465
+ * @since 2.32
1421
1466
  */
1422
1467
  lookup_action(action_name: string): Gio.Action | null;
1423
1468
 
@@ -1426,6 +1471,7 @@ export namespace Handy {
1426
1471
  *
1427
1472
  * If no action of this name is in the map then nothing happens.
1428
1473
  * @param action_name the name of the action
1474
+ * @since 2.32
1429
1475
  */
1430
1476
  remove_action(action_name: string): void;
1431
1477
 
@@ -1453,6 +1499,7 @@ export namespace Handy {
1453
1499
  * }
1454
1500
  * ```
1455
1501
  * @param entries a pointer to the first item in an array of {@link Gio.ActionEntry} structs
1502
+ * @since 2.78
1456
1503
  */
1457
1504
  remove_action_entries(entries: Gio.ActionEntry[]): void;
1458
1505
 
@@ -1464,6 +1511,7 @@ export namespace Handy {
1464
1511
  *
1465
1512
  * The action map takes its own reference on `action`.
1466
1513
  * @param action a {@link Gio.Action}
1514
+ * @since 2.32
1467
1515
  * @virtual
1468
1516
  */
1469
1517
  vfunc_add_action(action: Gio.Action): void;
@@ -1473,6 +1521,7 @@ export namespace Handy {
1473
1521
  *
1474
1522
  * If no such action exists, returns `NULL`.
1475
1523
  * @param action_name the name of an action
1524
+ * @since 2.32
1476
1525
  * @virtual
1477
1526
  */
1478
1527
  vfunc_lookup_action(action_name: string): Gio.Action | null;
@@ -1482,6 +1531,7 @@ export namespace Handy {
1482
1531
  *
1483
1532
  * If no action of this name is in the map then nothing happens.
1484
1533
  * @param action_name the name of the action
1534
+ * @since 2.32
1485
1535
  * @virtual
1486
1536
  */
1487
1537
  vfunc_remove_action(action_name: string): void;
@@ -1692,6 +1742,7 @@ export namespace Handy {
1692
1742
  * @param size the size of the pixbuf
1693
1743
  * @param scale_factor the scale factor
1694
1744
  * @returns the pixbuf
1745
+ * @since 1.2
1695
1746
  */
1696
1747
  draw_to_pixbuf(size: number, scale_factor: number): GdkPixbuf.Pixbuf;
1697
1748
 
@@ -1702,6 +1753,7 @@ export namespace Handy {
1702
1753
  * @param size the size of the pixbuf
1703
1754
  * @param scale_factor the scale factor
1704
1755
  * @param cancellable a cancellable
1756
+ * @since 1.2
1705
1757
  */
1706
1758
  draw_to_pixbuf_async(size: number, scale_factor: number, cancellable: Gio.Cancellable | null): globalThis.Promise<GdkPixbuf.Pixbuf>;
1707
1759
 
@@ -1713,6 +1765,7 @@ export namespace Handy {
1713
1765
  * @param scale_factor the scale factor
1714
1766
  * @param cancellable a cancellable
1715
1767
  * @param callback a {@link Gio.AsyncReadyCallback} to call when the avatar is generated
1768
+ * @since 1.2
1716
1769
  */
1717
1770
  draw_to_pixbuf_async(size: number, scale_factor: number, cancellable: Gio.Cancellable | null, callback: Gio.AsyncReadyCallback<this> | null): void;
1718
1771
 
@@ -1724,6 +1777,7 @@ export namespace Handy {
1724
1777
  * @param scale_factor the scale factor
1725
1778
  * @param cancellable a cancellable
1726
1779
  * @param callback a {@link Gio.AsyncReadyCallback} to call when the avatar is generated
1780
+ * @since 1.2
1727
1781
  */
1728
1782
  draw_to_pixbuf_async(size: number, scale_factor: number, cancellable: Gio.Cancellable | null, callback?: Gio.AsyncReadyCallback<this> | null): globalThis.Promise<GdkPixbuf.Pixbuf> | void;
1729
1783
 
@@ -1731,36 +1785,42 @@ export namespace Handy {
1731
1785
  * Finishes an asynchronous draw of an avatar to a pixbuf.
1732
1786
  * @param async_result a {@link Gio.AsyncResult}
1733
1787
  * @returns the resulting pixbuf
1788
+ * @since 1.2
1734
1789
  */
1735
1790
  draw_to_pixbuf_finish(async_result: Gio.AsyncResult): GdkPixbuf.Pixbuf;
1736
1791
 
1737
1792
  /**
1738
1793
  * Gets the name of an icon to use as a fallback.
1739
1794
  * @returns the icon name
1795
+ * @since 1.0
1740
1796
  */
1741
1797
  get_icon_name(): string | null;
1742
1798
 
1743
1799
  /**
1744
1800
  * Gets the {@link Gio.LoadableIcon} set via {@link Avatar.set_loadable_icon}.
1745
1801
  * @returns the {@link Gio.LoadableIcon}
1802
+ * @since 1.2
1746
1803
  */
1747
1804
  get_loadable_icon(): Gio.LoadableIcon | null;
1748
1805
 
1749
1806
  /**
1750
1807
  * Gets whether initials are used instead of an icon on the fallback avatar.
1751
1808
  * @returns whether initials are used instead of an icon as fallback
1809
+ * @since 1.0
1752
1810
  */
1753
1811
  get_show_initials(): boolean;
1754
1812
 
1755
1813
  /**
1756
1814
  * Gets the size of the avatar.
1757
1815
  * @returns the size of the avatar
1816
+ * @since 1.0
1758
1817
  */
1759
1818
  get_size(): number;
1760
1819
 
1761
1820
  /**
1762
1821
  * Gets the text used to generate the fallback initials and color.
1763
1822
  * @returns the text used to generate the fallback initials and color
1823
+ * @since 1.0
1764
1824
  */
1765
1825
  get_text(): string | null;
1766
1826
 
@@ -1769,6 +1829,7 @@ export namespace Handy {
1769
1829
  *
1770
1830
  * If no name is set, `avatar-default-symbolic` will be used.
1771
1831
  * @param icon_name the name of the icon from the icon theme
1832
+ * @since 1.0
1772
1833
  */
1773
1834
  set_icon_name(icon_name: string | null): void;
1774
1835
 
@@ -1778,6 +1839,8 @@ export namespace Handy {
1778
1839
  * It will be called on {@link Avatar.size} or
1779
1840
  * {@link Gtk.Widget.scale_factor} changes.
1780
1841
  * @param load_image callback to set a custom image
1842
+ * @since 1.0
1843
+ * @deprecated since 1.2: use {@link Avatar.set_loadable_icon} instead.
1781
1844
  */
1782
1845
  set_image_load_func(load_image: AvatarImageLoadFunc | null): void;
1783
1846
 
@@ -1790,24 +1853,28 @@ export namespace Handy {
1790
1853
  * The {@link Gio.LoadableIcon} set via this function is preferred over a set
1791
1854
  * {@link AvatarImageLoadFunc}.
1792
1855
  * @param icon a {@link Gio.LoadableIcon}
1856
+ * @since 1.2
1793
1857
  */
1794
1858
  set_loadable_icon(icon: Gio.LoadableIcon | null): void;
1795
1859
 
1796
1860
  /**
1797
1861
  * Sets whether to use initials instead of an icon on the fallback avatar.
1798
1862
  * @param show_initials whether to use initials instead of an icon as fallback
1863
+ * @since 1.0
1799
1864
  */
1800
1865
  set_show_initials(show_initials: boolean): void;
1801
1866
 
1802
1867
  /**
1803
1868
  * Sets the size of the avatar.
1804
1869
  * @param size the size to be used for the avatar
1870
+ * @since 1.0
1805
1871
  */
1806
1872
  set_size(size: number): void;
1807
1873
 
1808
1874
  /**
1809
1875
  * Set the text used to generate the fallback initials color.
1810
1876
  * @param text the text used to get the initials and color
1877
+ * @since 1.0
1811
1878
  */
1812
1879
  set_text(text: string | null): void;
1813
1880
  }
@@ -1825,7 +1892,7 @@ export namespace Handy {
1825
1892
  * @since 1.0
1826
1893
  * @run-last
1827
1894
  */
1828
- "page-changed": (arg0: number) => void;
1895
+ "page-changed": (index: number) => void;
1829
1896
  "notify::allow-long-swipes": (pspec: GObject.ParamSpec) => void;
1830
1897
  "notify::allow-mouse-drag": (pspec: GObject.ParamSpec) => void;
1831
1898
  "notify::allow-scroll-wheel": (pspec: GObject.ParamSpec) => void;
@@ -2091,42 +2158,49 @@ export namespace Handy {
2091
2158
  /**
2092
2159
  * Gets whether to allow swiping for more than one page at a time.
2093
2160
  * @returns `TRUE` if long swipes are allowed
2161
+ * @since 1.2
2094
2162
  */
2095
2163
  get_allow_long_swipes(): boolean;
2096
2164
 
2097
2165
  /**
2098
2166
  * Sets whether `self` can be dragged with mouse pointer.
2099
2167
  * @returns `TRUE` if `self` can be dragged with mouse
2168
+ * @since 1.0
2100
2169
  */
2101
2170
  get_allow_mouse_drag(): boolean;
2102
2171
 
2103
2172
  /**
2104
2173
  * Gets whether `self` will respond to scroll wheel events.
2105
2174
  * @returns `TRUE` if `self` will respond to scroll wheel events
2175
+ * @since 1.4
2106
2176
  */
2107
2177
  get_allow_scroll_wheel(): boolean;
2108
2178
 
2109
2179
  /**
2110
2180
  * Gets animation duration used by {@link Carousel.scroll_to}.
2111
2181
  * @returns animation duration, in milliseconds
2182
+ * @since 1.0
2112
2183
  */
2113
2184
  get_animation_duration(): number;
2114
2185
 
2115
2186
  /**
2116
2187
  * Gets whether `self` can be navigated.
2117
2188
  * @returns `TRUE` if `self` can be swiped
2189
+ * @since 1.0
2118
2190
  */
2119
2191
  get_interactive(): boolean;
2120
2192
 
2121
2193
  /**
2122
2194
  * Gets the number of pages in `self`.
2123
2195
  * @returns the number of pages in `self`
2196
+ * @since 1.0
2124
2197
  */
2125
2198
  get_n_pages(): number;
2126
2199
 
2127
2200
  /**
2128
2201
  * Gets current scroll position in `self`. It's unitless, 1 matches 1 page.
2129
2202
  * @returns the scroll position
2203
+ * @since 1.0
2130
2204
  */
2131
2205
  get_position(): number;
2132
2206
 
@@ -2134,12 +2208,14 @@ export namespace Handy {
2134
2208
  * Gets duration of the animation used when adding or removing pages, in
2135
2209
  * milliseconds.
2136
2210
  * @returns the duration
2211
+ * @since 1.0
2137
2212
  */
2138
2213
  get_reveal_duration(): number;
2139
2214
 
2140
2215
  /**
2141
2216
  * Gets spacing between pages in pixels.
2142
2217
  * @returns spacing between pages
2218
+ * @since 1.0
2143
2219
  */
2144
2220
  get_spacing(): number;
2145
2221
 
@@ -2150,12 +2226,14 @@ export namespace Handy {
2150
2226
  * appended to the end.
2151
2227
  * @param child a widget to add
2152
2228
  * @param position the position to insert `child` in
2229
+ * @since 1.0
2153
2230
  */
2154
2231
  insert(child: Gtk.Widget, position: number): void;
2155
2232
 
2156
2233
  /**
2157
2234
  * Prepends `child` to `self`.
2158
2235
  * @param child a widget to add
2236
+ * @since 1.0
2159
2237
  */
2160
2238
  prepend(child: Gtk.Widget): void;
2161
2239
 
@@ -2166,6 +2244,7 @@ export namespace Handy {
2166
2244
  * to the end.
2167
2245
  * @param child a widget to add
2168
2246
  * @param position the position to move `child` to
2247
+ * @since 1.0
2169
2248
  */
2170
2249
  reorder(child: Gtk.Widget, position: number): void;
2171
2250
 
@@ -2175,6 +2254,7 @@ export namespace Handy {
2175
2254
  * {@link Carousel.animation_duration} property can be used for controlling
2176
2255
  * the duration.
2177
2256
  * @param widget a child of `self`
2257
+ * @since 1.0
2178
2258
  */
2179
2259
  scroll_to(widget: Gtk.Widget): void;
2180
2260
 
@@ -2182,12 +2262,14 @@ export namespace Handy {
2182
2262
  * Scrolls to `widget` position with an animation.
2183
2263
  * @param widget a child of `self`
2184
2264
  * @param duration animation duration, in milliseconds
2265
+ * @since 1.0
2185
2266
  */
2186
2267
  scroll_to_full(widget: Gtk.Widget, duration: bigint | number): void;
2187
2268
 
2188
2269
  /**
2189
2270
  * Sets whether to allow swiping for more than one page at a time.
2190
2271
  * @param allow_long_swipes whether to allow long swipes
2272
+ * @since 1.2
2191
2273
  */
2192
2274
  set_allow_long_swipes(allow_long_swipes: boolean): void;
2193
2275
 
@@ -2196,18 +2278,21 @@ export namespace Handy {
2196
2278
  *
2197
2279
  * If `allow_mouse_drag` is `FALSE`, dragging is only available on touch.
2198
2280
  * @param allow_mouse_drag whether `self` can be dragged with mouse pointer
2281
+ * @since 1.0
2199
2282
  */
2200
2283
  set_allow_mouse_drag(allow_mouse_drag: boolean): void;
2201
2284
 
2202
2285
  /**
2203
2286
  * Sets whether `self` will respond to scroll wheel events.
2204
2287
  * @param allow_scroll_wheel whether `self` will respond to scroll wheel events
2288
+ * @since 1.4
2205
2289
  */
2206
2290
  set_allow_scroll_wheel(allow_scroll_wheel: boolean): void;
2207
2291
 
2208
2292
  /**
2209
2293
  * Sets animation duration used by {@link Carousel.scroll_to}.
2210
2294
  * @param duration animation duration, in milliseconds
2295
+ * @since 1.0
2211
2296
  */
2212
2297
  set_animation_duration(duration: number): void;
2213
2298
 
@@ -2217,6 +2302,7 @@ export namespace Handy {
2217
2302
  * This can be used to temporarily disable a {@link Carousel} to only allow
2218
2303
  * swiping in a certain state.
2219
2304
  * @param interactive whether `self` can be swiped
2305
+ * @since 1.0
2220
2306
  */
2221
2307
  set_interactive(interactive: boolean): void;
2222
2308
 
@@ -2224,12 +2310,14 @@ export namespace Handy {
2224
2310
  * Sets duration of the animation used when adding or removing pages, in
2225
2311
  * milliseconds.
2226
2312
  * @param reveal_duration the new reveal duration value
2313
+ * @since 1.0
2227
2314
  */
2228
2315
  set_reveal_duration(reveal_duration: number): void;
2229
2316
 
2230
2317
  /**
2231
2318
  * Sets spacing between pages in pixels.
2232
2319
  * @param spacing the new spacing value
2320
+ * @since 1.0
2233
2321
  */
2234
2322
  set_spacing(spacing: number): void;
2235
2323
 
@@ -2245,12 +2333,14 @@ export namespace Handy {
2245
2333
  /**
2246
2334
  * Retrieves the orientation of the `orientable`.
2247
2335
  * @returns the orientation of the `orientable`.
2336
+ * @since 2.16
2248
2337
  */
2249
2338
  get_orientation(): Gtk.Orientation;
2250
2339
 
2251
2340
  /**
2252
2341
  * Sets the orientation of the `orientable`.
2253
2342
  * @param orientation the orientable’s new orientation.
2343
+ * @since 2.16
2254
2344
  */
2255
2345
  set_orientation(orientation: Gtk.Orientation): void;
2256
2346
 
@@ -2262,12 +2352,14 @@ export namespace Handy {
2262
2352
  * `duration` can be 0 if the child is switched without animation.
2263
2353
  * @param index the index of the child to switch to
2264
2354
  * @param duration animation duration, in milliseconds
2355
+ * @since 1.0
2265
2356
  */
2266
2357
  emit_child_switched(index: number, duration: bigint | number): void;
2267
2358
 
2268
2359
  /**
2269
2360
  * Gets the progress `self` will snap back to after the gesture is canceled.
2270
2361
  * @returns the cancel progress, unitless
2362
+ * @since 1.0
2271
2363
  */
2272
2364
  get_cancel_progress(): number;
2273
2365
 
@@ -2276,12 +2368,14 @@ export namespace Handy {
2276
2368
  *
2277
2369
  * This corresponds to how many pixels 1 unit represents.
2278
2370
  * @returns the swipe distance in pixels
2371
+ * @since 1.0
2279
2372
  */
2280
2373
  get_distance(): number;
2281
2374
 
2282
2375
  /**
2283
2376
  * Gets the current progress of `self`.
2284
2377
  * @returns the current progress, unitless
2378
+ * @since 1.0
2285
2379
  */
2286
2380
  get_progress(): number;
2287
2381
 
@@ -2291,6 +2385,7 @@ export namespace Handy {
2291
2385
  * Each snap point represents a progress value that is considered acceptable to
2292
2386
  * end the swipe on.
2293
2387
  * @returns the snap points
2388
+ * @since 1.0
2294
2389
  */
2295
2390
  get_snap_points(): number[];
2296
2391
 
@@ -2309,12 +2404,14 @@ export namespace Handy {
2309
2404
  * `self`, allowing swipes from anywhere.
2310
2405
  * @param navigation_direction the direction of the swipe
2311
2406
  * @param is_drag whether the swipe is caused by a dragging gesture
2407
+ * @since 1.0
2312
2408
  */
2313
2409
  get_swipe_area(navigation_direction: NavigationDirection, is_drag: boolean): Gdk.Rectangle;
2314
2410
 
2315
2411
  /**
2316
2412
  * Gets the {@link SwipeTracker} used by this swipeable widget.
2317
2413
  * @returns the swipe tracker
2414
+ * @since 1.0
2318
2415
  */
2319
2416
  get_swipe_tracker(): SwipeTracker;
2320
2417
 
@@ -2324,11 +2421,13 @@ export namespace Handy {
2324
2421
  * See `Handy.Swipeable::child-switched`.
2325
2422
  * @param index the index of the child to switch to
2326
2423
  * @param duration animation duration, in milliseconds
2424
+ * @since 1.0
2327
2425
  */
2328
2426
  switch_child(index: number, duration: bigint | number): void;
2329
2427
 
2330
2428
  /**
2331
2429
  * Gets the progress `self` will snap back to after the gesture is canceled.
2430
+ * @since 1.0
2332
2431
  * @virtual
2333
2432
  */
2334
2433
  vfunc_get_cancel_progress(): number;
@@ -2337,12 +2436,14 @@ export namespace Handy {
2337
2436
  * Gets the swipe distance of `self`.
2338
2437
  *
2339
2438
  * This corresponds to how many pixels 1 unit represents.
2439
+ * @since 1.0
2340
2440
  * @virtual
2341
2441
  */
2342
2442
  vfunc_get_distance(): number;
2343
2443
 
2344
2444
  /**
2345
2445
  * Gets the current progress of `self`.
2446
+ * @since 1.0
2346
2447
  * @virtual
2347
2448
  */
2348
2449
  vfunc_get_progress(): number;
@@ -2352,6 +2453,7 @@ export namespace Handy {
2352
2453
  *
2353
2454
  * Each snap point represents a progress value that is considered acceptable to
2354
2455
  * end the swipe on.
2456
+ * @since 1.0
2355
2457
  * @virtual
2356
2458
  */
2357
2459
  vfunc_get_snap_points(): number[];
@@ -2371,12 +2473,14 @@ export namespace Handy {
2371
2473
  * `self`, allowing swipes from anywhere.
2372
2474
  * @param navigation_direction the direction of the swipe
2373
2475
  * @param is_drag whether the swipe is caused by a dragging gesture
2476
+ * @since 1.0
2374
2477
  * @virtual
2375
2478
  */
2376
2479
  vfunc_get_swipe_area(navigation_direction: NavigationDirection, is_drag: boolean): Gdk.Rectangle;
2377
2480
 
2378
2481
  /**
2379
2482
  * Gets the {@link SwipeTracker} used by this swipeable widget.
2483
+ * @since 1.0
2380
2484
  * @virtual
2381
2485
  */
2382
2486
  vfunc_get_swipe_tracker(): SwipeTracker;
@@ -2387,6 +2491,7 @@ export namespace Handy {
2387
2491
  * See `Handy.Swipeable::child-switched`.
2388
2492
  * @param index the index of the child to switch to
2389
2493
  * @param duration animation duration, in milliseconds
2494
+ * @since 1.0
2390
2495
  * @virtual
2391
2496
  */
2392
2497
  vfunc_switch_child(index: number, duration: number): void;
@@ -2524,12 +2629,14 @@ export namespace Handy {
2524
2629
  /**
2525
2630
  * Get the {@link Carousel} the indicator uses.
2526
2631
  * @returns the {@link Carousel}
2632
+ * @since 1.0
2527
2633
  */
2528
2634
  get_carousel(): Carousel | null;
2529
2635
 
2530
2636
  /**
2531
2637
  * Sets the {@link Carousel} to use.
2532
2638
  * @param carousel a carousel
2639
+ * @since 1.0
2533
2640
  */
2534
2641
  set_carousel(carousel: Carousel | null): void;
2535
2642
 
@@ -2545,12 +2652,14 @@ export namespace Handy {
2545
2652
  /**
2546
2653
  * Retrieves the orientation of the `orientable`.
2547
2654
  * @returns the orientation of the `orientable`.
2655
+ * @since 2.16
2548
2656
  */
2549
2657
  get_orientation(): Gtk.Orientation;
2550
2658
 
2551
2659
  /**
2552
2660
  * Sets the orientation of the `orientable`.
2553
2661
  * @param orientation the orientable’s new orientation.
2662
+ * @since 2.16
2554
2663
  */
2555
2664
  set_orientation(orientation: Gtk.Orientation): void;
2556
2665
  }
@@ -2668,12 +2777,14 @@ export namespace Handy {
2668
2777
  /**
2669
2778
  * Gets the displayed carousel.
2670
2779
  * @returns the displayed carousel
2780
+ * @since 1.0
2671
2781
  */
2672
2782
  get_carousel(): Carousel | null;
2673
2783
 
2674
2784
  /**
2675
2785
  * Sets the {@link Carousel} to use.
2676
2786
  * @param carousel a carousel
2787
+ * @since 1.0
2677
2788
  */
2678
2789
  set_carousel(carousel: Carousel | null): void;
2679
2790
 
@@ -2689,12 +2800,14 @@ export namespace Handy {
2689
2800
  /**
2690
2801
  * Retrieves the orientation of the `orientable`.
2691
2802
  * @returns the orientation of the `orientable`.
2803
+ * @since 2.16
2692
2804
  */
2693
2805
  get_orientation(): Gtk.Orientation;
2694
2806
 
2695
2807
  /**
2696
2808
  * Sets the orientation of the `orientable`.
2697
2809
  * @param orientation the orientable’s new orientation.
2810
+ * @since 2.16
2698
2811
  */
2699
2812
  set_orientation(orientation: Gtk.Orientation): void;
2700
2813
  }
@@ -2881,24 +2994,28 @@ export namespace Handy {
2881
2994
  /**
2882
2995
  * Gets the maximum size allocated to the children.
2883
2996
  * @returns the maximum size to allocate to the children
2997
+ * @since 1.0
2884
2998
  */
2885
2999
  get_maximum_size(): number;
2886
3000
 
2887
3001
  /**
2888
3002
  * Gets the size above which the children are clamped.
2889
3003
  * @returns the size above which the children are clamped
3004
+ * @since 1.0
2890
3005
  */
2891
3006
  get_tightening_threshold(): number;
2892
3007
 
2893
3008
  /**
2894
3009
  * Sets the maximum size allocated to the children.
2895
3010
  * @param maximum_size the maximum size
3011
+ * @since 1.0
2896
3012
  */
2897
3013
  set_maximum_size(maximum_size: number): void;
2898
3014
 
2899
3015
  /**
2900
3016
  * Sets the size above which the children are clamped.
2901
3017
  * @param tightening_threshold the tightening threshold
3018
+ * @since 1.0
2902
3019
  */
2903
3020
  set_tightening_threshold(tightening_threshold: number): void;
2904
3021
 
@@ -2914,12 +3031,14 @@ export namespace Handy {
2914
3031
  /**
2915
3032
  * Retrieves the orientation of the `orientable`.
2916
3033
  * @returns the orientation of the `orientable`.
3034
+ * @since 2.16
2917
3035
  */
2918
3036
  get_orientation(): Gtk.Orientation;
2919
3037
 
2920
3038
  /**
2921
3039
  * Sets the orientation of the `orientable`.
2922
3040
  * @param orientation the orientable’s new orientation.
3041
+ * @since 2.16
2923
3042
  */
2924
3043
  set_orientation(orientation: Gtk.Orientation): void;
2925
3044
  }
@@ -3106,6 +3225,7 @@ export namespace Handy {
3106
3225
  * @param model the {@link Gio.ListModel} to be bound to `self`
3107
3226
  * @param create_list_widget_func a function that creates widgets for items to display in the list, or `NULL` in case you also passed `NULL` as `model`
3108
3227
  * @param create_current_widget_func a function that creates widgets for items to display as the selected item, or `NULL` in case you also passed `NULL` as `model`
3228
+ * @since 1.0
3109
3229
  */
3110
3230
  bind_model(model: Gio.ListModel | null, create_list_widget_func: Gtk.ListBoxCreateWidgetFunc | null, create_current_widget_func: Gtk.ListBoxCreateWidgetFunc | null): void;
3111
3231
 
@@ -3122,24 +3242,28 @@ export namespace Handy {
3122
3242
  * to represent items of the model with names.
3123
3243
  * @param model the {@link Gio.ListModel} to be bound to `self`
3124
3244
  * @param get_name_func a function that creates names for items, or `NULL` in case you also passed `NULL` as `model`
3245
+ * @since 1.0
3125
3246
  */
3126
3247
  bind_name_model(model: Gio.ListModel | null, get_name_func: ComboRowGetNameFunc | null): void;
3127
3248
 
3128
3249
  /**
3129
3250
  * Gets the model bound to `self`.
3130
3251
  * @returns the {@link Gio.ListModel} bound to `self`
3252
+ * @since 1.0
3131
3253
  */
3132
3254
  get_model(): Gio.ListModel | null;
3133
3255
 
3134
3256
  /**
3135
3257
  * Gets the index of the selected item in its {@link Gio.ListModel}.
3136
3258
  * @returns the index of the selected item, or -1 if no item is selected
3259
+ * @since 1.0
3137
3260
  */
3138
3261
  get_selected_index(): number;
3139
3262
 
3140
3263
  /**
3141
3264
  * Gets whether the current value of `self` should be displayed as its subtitle.
3142
3265
  * @returns whether the current value of `self` should be displayed as its subtitle
3266
+ * @since 1.0
3143
3267
  */
3144
3268
  get_use_subtitle(): boolean;
3145
3269
 
@@ -3160,6 +3284,7 @@ export namespace Handy {
3160
3284
  * See {@link enum_value_row_name}.
3161
3285
  * @param enum_type the enumeration {@link GLib.Type} to be bound to `self`
3162
3286
  * @param get_name_func a function that creates names for items, or `NULL` in case you also passed `NULL` as `model`
3287
+ * @since 1.0
3163
3288
  */
3164
3289
  set_for_enum(enum_type: GObject.GType, get_name_func: ComboRowGetEnumValueNameFunc | null): void;
3165
3290
 
@@ -3168,12 +3293,14 @@ export namespace Handy {
3168
3293
  *
3169
3294
  * See {@link ComboRow.use_subtitle}.
3170
3295
  * @param get_name_func a function that creates names for items, or `NULL` in case you also passed `NULL` as `model`
3296
+ * @since 1.0
3171
3297
  */
3172
3298
  set_get_name_func(get_name_func: ComboRowGetNameFunc | null): void;
3173
3299
 
3174
3300
  /**
3175
3301
  * Sets the index of the selected item in its {@link Gio.ListModel}.
3176
3302
  * @param selected_index the index of the selected item
3303
+ * @since 1.0
3177
3304
  */
3178
3305
  set_selected_index(selected_index: number): void;
3179
3306
 
@@ -3182,6 +3309,7 @@ export namespace Handy {
3182
3309
  *
3183
3310
  * If `TRUE`, you should not access {@link ActionRow.subtitle}.
3184
3311
  * @param use_subtitle `TRUE` to set the current value as the subtitle
3312
+ * @since 1.0
3185
3313
  */
3186
3314
  set_use_subtitle(use_subtitle: boolean): void;
3187
3315
 
@@ -3531,18 +3659,21 @@ export namespace Handy {
3531
3659
  * If there's no child to navigate to, `NULL` will be returned instead.
3532
3660
  * @param direction the direction
3533
3661
  * @returns the previous or next child
3662
+ * @since 1.0
3534
3663
  */
3535
3664
  get_adjacent_child(direction: NavigationDirection): Gtk.Widget | null;
3536
3665
 
3537
3666
  /**
3538
3667
  * Gets whether swipe gestures for navigating backward are enabled.
3539
3668
  * @returns Whether swipe gestures are enabled.
3669
+ * @since 1.0
3540
3670
  */
3541
3671
  get_can_swipe_back(): boolean;
3542
3672
 
3543
3673
  /**
3544
3674
  * Gets whether swipe gestures for navigating forward enabled.
3545
3675
  * @returns Whether swipe gestures are enabled.
3676
+ * @since 1.0
3546
3677
  */
3547
3678
  get_can_swipe_forward(): boolean;
3548
3679
 
@@ -3552,6 +3683,7 @@ export namespace Handy {
3552
3683
  * Returns `NULL` if there is no child with this name.
3553
3684
  * @param name the name of the child to find
3554
3685
  * @returns the requested child of `self`
3686
+ * @since 1.0
3555
3687
  */
3556
3688
  get_child_by_name(name: string): Gtk.Widget | null;
3557
3689
 
@@ -3559,42 +3691,49 @@ export namespace Handy {
3559
3691
  * Gets whether `self` is homogeneous for the given orientation.
3560
3692
  * @param orientation the orientation
3561
3693
  * @returns whether `self` is homogeneous for the given orientation
3694
+ * @since 1.0
3562
3695
  */
3563
3696
  get_homogeneous(orientation: Gtk.Orientation): boolean;
3564
3697
 
3565
3698
  /**
3566
3699
  * Gets whether `self` will interpolate its size when changing the visible child.
3567
3700
  * @returns whether child sizes are interpolated
3701
+ * @since 1.0
3568
3702
  */
3569
3703
  get_interpolate_size(): boolean;
3570
3704
 
3571
3705
  /**
3572
3706
  * Gets the mode transition animation duration for `self`.
3573
3707
  * @returns the mode transition duration, in milliseconds.
3708
+ * @since 1.0
3574
3709
  */
3575
3710
  get_transition_duration(): number;
3576
3711
 
3577
3712
  /**
3578
3713
  * Gets whether a transition is currently running for `self`.
3579
3714
  * @returns whether a transition is currently running
3715
+ * @since 1.0
3580
3716
  */
3581
3717
  get_transition_running(): boolean;
3582
3718
 
3583
3719
  /**
3584
3720
  * Gets the type of animation used for transitions between children.
3585
3721
  * @returns the current transition type of `self`
3722
+ * @since 1.0
3586
3723
  */
3587
3724
  get_transition_type(): DeckTransitionType;
3588
3725
 
3589
3726
  /**
3590
3727
  * Gets the visible child widget.
3591
3728
  * @returns the visible child widget
3729
+ * @since 1.0
3592
3730
  */
3593
3731
  get_visible_child(): Gtk.Widget;
3594
3732
 
3595
3733
  /**
3596
3734
  * Gets the name of the currently visible child widget.
3597
3735
  * @returns the name of the visible child
3736
+ * @since 1.0
3598
3737
  */
3599
3738
  get_visible_child_name(): string;
3600
3739
 
@@ -3604,6 +3743,7 @@ export namespace Handy {
3604
3743
  * If `sibling` is `NULL`, inserts `child` at the first position.
3605
3744
  * @param child the widget to insert
3606
3745
  * @param sibling the sibling after which to insert `child`
3746
+ * @since 1.2
3607
3747
  */
3608
3748
  insert_child_after(child: Gtk.Widget, sibling: Gtk.Widget | null): void;
3609
3749
 
@@ -3613,12 +3753,14 @@ export namespace Handy {
3613
3753
  * The switch is similar to performing a swipe gesture to go in `direction`.
3614
3754
  * @param direction the direction
3615
3755
  * @returns whether the visible child was changed
3756
+ * @since 1.0
3616
3757
  */
3617
3758
  navigate(direction: NavigationDirection): boolean;
3618
3759
 
3619
3760
  /**
3620
3761
  * Inserts `child` at the first position in `self`.
3621
3762
  * @param child the widget to prepend
3763
+ * @since 1.2
3622
3764
  */
3623
3765
  prepend(child: Gtk.Widget): void;
3624
3766
 
@@ -3628,18 +3770,21 @@ export namespace Handy {
3628
3770
  * If `sibling` is `NULL`, move `child` to the first position.
3629
3771
  * @param child the widget to move, must be a child of `self`
3630
3772
  * @param sibling the sibling to move `child` after
3773
+ * @since 1.2
3631
3774
  */
3632
3775
  reorder_child_after(child: Gtk.Widget, sibling: Gtk.Widget | null): void;
3633
3776
 
3634
3777
  /**
3635
3778
  * Sets whether swipe gestures for navigating backward are enabled.
3636
3779
  * @param can_swipe_back the new value
3780
+ * @since 1.0
3637
3781
  */
3638
3782
  set_can_swipe_back(can_swipe_back: boolean): void;
3639
3783
 
3640
3784
  /**
3641
3785
  * Sets whether swipe gestures for navigating forward are enabled.
3642
3786
  * @param can_swipe_forward the new value
3787
+ * @since 1.0
3643
3788
  */
3644
3789
  set_can_swipe_forward(can_swipe_forward: boolean): void;
3645
3790
 
@@ -3650,6 +3795,7 @@ export namespace Handy {
3650
3795
  * opposite orientation.
3651
3796
  * @param orientation the orientation
3652
3797
  * @param homogeneous `TRUE` to make `self` homogeneous
3798
+ * @since 1.0
3653
3799
  */
3654
3800
  set_homogeneous(orientation: Gtk.Orientation, homogeneous: boolean): void;
3655
3801
 
@@ -3660,12 +3806,14 @@ export namespace Handy {
3660
3806
  * take after changing the visible child, according to the set transition
3661
3807
  * duration.
3662
3808
  * @param interpolate_size the new value
3809
+ * @since 1.0
3663
3810
  */
3664
3811
  set_interpolate_size(interpolate_size: boolean): void;
3665
3812
 
3666
3813
  /**
3667
3814
  * Sets the mode transition animation duration for `self`.
3668
3815
  * @param duration the new duration, in milliseconds
3816
+ * @since 1.0
3669
3817
  */
3670
3818
  set_transition_duration(duration: number): void;
3671
3819
 
@@ -3676,12 +3824,14 @@ export namespace Handy {
3676
3824
  * possible to change the animation based on the child that is about to become
3677
3825
  * current.
3678
3826
  * @param transition the new transition type
3827
+ * @since 1.0
3679
3828
  */
3680
3829
  set_transition_type(transition: DeckTransitionType): void;
3681
3830
 
3682
3831
  /**
3683
3832
  * Sets the currently visible widget.
3684
3833
  * @param visible_child the new child
3834
+ * @since 1.0
3685
3835
  */
3686
3836
  set_visible_child(visible_child: Gtk.Widget): void;
3687
3837
 
@@ -3690,6 +3840,7 @@ export namespace Handy {
3690
3840
  *
3691
3841
  * See {@link Deck.set_visible_child} for more details.
3692
3842
  * @param name the name of a child
3843
+ * @since 1.0
3693
3844
  */
3694
3845
  set_visible_child_name(name: string): void;
3695
3846
 
@@ -3705,12 +3856,14 @@ export namespace Handy {
3705
3856
  /**
3706
3857
  * Retrieves the orientation of the `orientable`.
3707
3858
  * @returns the orientation of the `orientable`.
3859
+ * @since 2.16
3708
3860
  */
3709
3861
  get_orientation(): Gtk.Orientation;
3710
3862
 
3711
3863
  /**
3712
3864
  * Sets the orientation of the `orientable`.
3713
3865
  * @param orientation the orientable’s new orientation.
3866
+ * @since 2.16
3714
3867
  */
3715
3868
  set_orientation(orientation: Gtk.Orientation): void;
3716
3869
 
@@ -3722,12 +3875,14 @@ export namespace Handy {
3722
3875
  * `duration` can be 0 if the child is switched without animation.
3723
3876
  * @param index the index of the child to switch to
3724
3877
  * @param duration animation duration, in milliseconds
3878
+ * @since 1.0
3725
3879
  */
3726
3880
  emit_child_switched(index: number, duration: bigint | number): void;
3727
3881
 
3728
3882
  /**
3729
3883
  * Gets the progress `self` will snap back to after the gesture is canceled.
3730
3884
  * @returns the cancel progress, unitless
3885
+ * @since 1.0
3731
3886
  */
3732
3887
  get_cancel_progress(): number;
3733
3888
 
@@ -3736,12 +3891,14 @@ export namespace Handy {
3736
3891
  *
3737
3892
  * This corresponds to how many pixels 1 unit represents.
3738
3893
  * @returns the swipe distance in pixels
3894
+ * @since 1.0
3739
3895
  */
3740
3896
  get_distance(): number;
3741
3897
 
3742
3898
  /**
3743
3899
  * Gets the current progress of `self`.
3744
3900
  * @returns the current progress, unitless
3901
+ * @since 1.0
3745
3902
  */
3746
3903
  get_progress(): number;
3747
3904
 
@@ -3751,6 +3908,7 @@ export namespace Handy {
3751
3908
  * Each snap point represents a progress value that is considered acceptable to
3752
3909
  * end the swipe on.
3753
3910
  * @returns the snap points
3911
+ * @since 1.0
3754
3912
  */
3755
3913
  get_snap_points(): number[];
3756
3914
 
@@ -3769,12 +3927,14 @@ export namespace Handy {
3769
3927
  * `self`, allowing swipes from anywhere.
3770
3928
  * @param navigation_direction the direction of the swipe
3771
3929
  * @param is_drag whether the swipe is caused by a dragging gesture
3930
+ * @since 1.0
3772
3931
  */
3773
3932
  get_swipe_area(navigation_direction: NavigationDirection, is_drag: boolean): Gdk.Rectangle;
3774
3933
 
3775
3934
  /**
3776
3935
  * Gets the {@link SwipeTracker} used by this swipeable widget.
3777
3936
  * @returns the swipe tracker
3937
+ * @since 1.0
3778
3938
  */
3779
3939
  get_swipe_tracker(): SwipeTracker;
3780
3940
 
@@ -3784,11 +3944,13 @@ export namespace Handy {
3784
3944
  * See `Handy.Swipeable::child-switched`.
3785
3945
  * @param index the index of the child to switch to
3786
3946
  * @param duration animation duration, in milliseconds
3947
+ * @since 1.0
3787
3948
  */
3788
3949
  switch_child(index: number, duration: bigint | number): void;
3789
3950
 
3790
3951
  /**
3791
3952
  * Gets the progress `self` will snap back to after the gesture is canceled.
3953
+ * @since 1.0
3792
3954
  * @virtual
3793
3955
  */
3794
3956
  vfunc_get_cancel_progress(): number;
@@ -3797,12 +3959,14 @@ export namespace Handy {
3797
3959
  * Gets the swipe distance of `self`.
3798
3960
  *
3799
3961
  * This corresponds to how many pixels 1 unit represents.
3962
+ * @since 1.0
3800
3963
  * @virtual
3801
3964
  */
3802
3965
  vfunc_get_distance(): number;
3803
3966
 
3804
3967
  /**
3805
3968
  * Gets the current progress of `self`.
3969
+ * @since 1.0
3806
3970
  * @virtual
3807
3971
  */
3808
3972
  vfunc_get_progress(): number;
@@ -3812,6 +3976,7 @@ export namespace Handy {
3812
3976
  *
3813
3977
  * Each snap point represents a progress value that is considered acceptable to
3814
3978
  * end the swipe on.
3979
+ * @since 1.0
3815
3980
  * @virtual
3816
3981
  */
3817
3982
  vfunc_get_snap_points(): number[];
@@ -3831,12 +3996,14 @@ export namespace Handy {
3831
3996
  * `self`, allowing swipes from anywhere.
3832
3997
  * @param navigation_direction the direction of the swipe
3833
3998
  * @param is_drag whether the swipe is caused by a dragging gesture
3999
+ * @since 1.0
3834
4000
  * @virtual
3835
4001
  */
3836
4002
  vfunc_get_swipe_area(navigation_direction: NavigationDirection, is_drag: boolean): Gdk.Rectangle;
3837
4003
 
3838
4004
  /**
3839
4005
  * Gets the {@link SwipeTracker} used by this swipeable widget.
4006
+ * @since 1.0
3840
4007
  * @virtual
3841
4008
  */
3842
4009
  vfunc_get_swipe_tracker(): SwipeTracker;
@@ -3847,6 +4014,7 @@ export namespace Handy {
3847
4014
  * See `Handy.Swipeable::child-switched`.
3848
4015
  * @param index the index of the child to switch to
3849
4016
  * @param duration animation duration, in milliseconds
4017
+ * @since 1.0
3850
4018
  * @virtual
3851
4019
  */
3852
4020
  vfunc_switch_child(index: number, duration: number): void;
@@ -3923,18 +4091,21 @@ export namespace Handy {
3923
4091
  /**
3924
4092
  * Gets the name of `self`.
3925
4093
  * @returns the name of `self`
4094
+ * @since 1.0
3926
4095
  */
3927
4096
  get_name(): string;
3928
4097
 
3929
4098
  /**
3930
4099
  * Gets the nick of `self`.
3931
4100
  * @returns the nick of `self`
4101
+ * @since 1.0
3932
4102
  */
3933
4103
  get_nick(): string;
3934
4104
 
3935
4105
  /**
3936
4106
  * Gets the value of `self`.
3937
4107
  * @returns the value of `self`
4108
+ * @since 1.0
3938
4109
  */
3939
4110
  get_value(): number;
3940
4111
  }
@@ -4158,18 +4329,21 @@ export namespace Handy {
4158
4329
  /**
4159
4330
  * Adds an action widget to `self`.
4160
4331
  * @param widget the action widget
4332
+ * @since 1.0
4161
4333
  */
4162
4334
  add_action(widget: Gtk.Widget): void;
4163
4335
 
4164
4336
  /**
4165
4337
  * Adds a prefix widget to `self`.
4166
4338
  * @param widget the prefix widget
4339
+ * @since 1.0
4167
4340
  */
4168
4341
  add_prefix(widget: Gtk.Widget): void;
4169
4342
 
4170
4343
  /**
4171
4344
  * Gets whether the expansion of `self` is enabled.
4172
4345
  * @returns whether the expansion of `self` is enabled
4346
+ * @since 1.0
4173
4347
  */
4174
4348
  get_enable_expansion(): boolean;
4175
4349
 
@@ -4178,18 +4352,21 @@ export namespace Handy {
4178
4352
  /**
4179
4353
  * Gets the icon name for `self`.
4180
4354
  * @returns the icon name for `self`
4355
+ * @since 1.0
4181
4356
  */
4182
4357
  get_icon_name(): string;
4183
4358
 
4184
4359
  /**
4185
4360
  * Gets whether the switch enabling the expansion of `self` is visible.
4186
4361
  * @returns whether the switch enabling the expansion of `self` is visible
4362
+ * @since 1.0
4187
4363
  */
4188
4364
  get_show_enable_switch(): boolean;
4189
4365
 
4190
4366
  /**
4191
4367
  * Gets the subtitle for `self`.
4192
4368
  * @returns the subtitle for `self`
4369
+ * @since 1.0
4193
4370
  */
4194
4371
  get_subtitle(): string | null;
4195
4372
 
@@ -4197,12 +4374,14 @@ export namespace Handy {
4197
4374
  * Gets whether an embedded underline in the title or subtitle labels indicates
4198
4375
  * a mnemonic.
4199
4376
  * @returns whether an embedded underlines indicates a mnemonic
4377
+ * @since 1.0
4200
4378
  */
4201
4379
  get_use_underline(): boolean;
4202
4380
 
4203
4381
  /**
4204
4382
  * Sets whether the expansion of `self` is enabled.
4205
4383
  * @param enable_expansion `TRUE` to enable the expansion
4384
+ * @since 1.0
4206
4385
  */
4207
4386
  set_enable_expansion(enable_expansion: boolean): void;
4208
4387
 
@@ -4214,18 +4393,21 @@ export namespace Handy {
4214
4393
  /**
4215
4394
  * Sets the icon name for `self`.
4216
4395
  * @param icon_name the icon name
4396
+ * @since 1.0
4217
4397
  */
4218
4398
  set_icon_name(icon_name: string): void;
4219
4399
 
4220
4400
  /**
4221
4401
  * Sets whether the switch enabling the expansion of `self` is visible.
4222
4402
  * @param show_enable_switch `TRUE` to show the switch enabling the expansion
4403
+ * @since 1.0
4223
4404
  */
4224
4405
  set_show_enable_switch(show_enable_switch: boolean): void;
4225
4406
 
4226
4407
  /**
4227
4408
  * Sets the subtitle for `self`.
4228
4409
  * @param subtitle the subtitle
4410
+ * @since 1.0
4229
4411
  */
4230
4412
  set_subtitle(subtitle: string | null): void;
4231
4413
 
@@ -4233,6 +4415,7 @@ export namespace Handy {
4233
4415
  * Sets whether an embedded underline in the title or subtitle labels indicates
4234
4416
  * a mnemonic.
4235
4417
  * @param use_underline `TRUE` if underlines in the text indicate mnemonics
4418
+ * @since 1.0
4236
4419
  */
4237
4420
  set_use_underline(use_underline: boolean): void;
4238
4421
 
@@ -4680,90 +4863,105 @@ export namespace Handy {
4680
4863
  /**
4681
4864
  * Gets the content widget for `self`
4682
4865
  * @returns the content widget for `self`
4866
+ * @since 1.2
4683
4867
  */
4684
4868
  get_content(): Gtk.Widget | null;
4685
4869
 
4686
4870
  /**
4687
4871
  * Gets the flap widget for `self`
4688
4872
  * @returns the flap widget for `self`
4873
+ * @since 1.2
4689
4874
  */
4690
4875
  get_flap(): Gtk.Widget | null;
4691
4876
 
4692
4877
  /**
4693
4878
  * Gets the flap position for `self`.
4694
4879
  * @returns the flap position for `self`
4880
+ * @since 1.2
4695
4881
  */
4696
4882
  get_flap_position(): Gtk.PackType;
4697
4883
 
4698
4884
  /**
4699
4885
  * Gets the amount of time that fold transitions will take.
4700
4886
  * @returns the fold transition duration, in milliseconds
4887
+ * @since 1.2
4701
4888
  */
4702
4889
  get_fold_duration(): number;
4703
4890
 
4704
4891
  /**
4705
4892
  * Gets the current fold policy of `self`.
4706
4893
  * @returns the current fold policy of `self`
4894
+ * @since 1.2
4707
4895
  */
4708
4896
  get_fold_policy(): FlapFoldPolicy;
4709
4897
 
4710
4898
  /**
4711
4899
  * Gets whether `self` is currently folded.
4712
4900
  * @returns `TRUE` if `self` is currently folded
4901
+ * @since 1.2
4713
4902
  */
4714
4903
  get_folded(): boolean;
4715
4904
 
4716
4905
  /**
4717
4906
  * Gets whether `self` is locked.
4718
4907
  * @returns whether `self` is locked
4908
+ * @since 1.2
4719
4909
  */
4720
4910
  get_locked(): boolean;
4721
4911
 
4722
4912
  /**
4723
4913
  * Gets whether the `self` is modal.
4724
4914
  * @returns whether `self` is modal
4915
+ * @since 1.2
4725
4916
  */
4726
4917
  get_modal(): boolean;
4727
4918
 
4728
4919
  /**
4729
4920
  * Gets the amount of time that reveal transitions will take.
4730
4921
  * @returns the reveal transition duration, in milliseconds
4922
+ * @since 1.2
4731
4923
  */
4732
4924
  get_reveal_duration(): number;
4733
4925
 
4734
4926
  /**
4735
4927
  * Gets whether the flap widget is revealed for `self`.
4736
4928
  * @returns whether flap widget is revealed
4929
+ * @since 1.2
4737
4930
  */
4738
4931
  get_reveal_flap(): boolean;
4739
4932
 
4740
4933
  /**
4741
4934
  * Gets the current reveal transition progress for `self`.
4742
4935
  * @returns the current reveal progress for `self`
4936
+ * @since 1.2
4743
4937
  */
4744
4938
  get_reveal_progress(): number;
4745
4939
 
4746
4940
  /**
4747
4941
  * Gets the separator widget for `self`.
4748
4942
  * @returns the separator widget for `self`
4943
+ * @since 1.2
4749
4944
  */
4750
4945
  get_separator(): Gtk.Widget | null;
4751
4946
 
4752
4947
  /**
4753
4948
  * Gets whether `self` can be closed with a swipe gesture.
4754
4949
  * @returns `TRUE` if `self` can be closed with a swipe gesture
4950
+ * @since 1.2
4755
4951
  */
4756
4952
  get_swipe_to_close(): boolean;
4757
4953
 
4758
4954
  /**
4759
4955
  * Gets whether `self` can be opened with a swipe gesture.
4760
4956
  * @returns `TRUE` if `self` can be opened with a swipe gesture
4957
+ * @since 1.2
4761
4958
  */
4762
4959
  get_swipe_to_open(): boolean;
4763
4960
 
4764
4961
  /**
4765
4962
  * Gets the type of animation used for reveal and fold transitions in `self`.
4766
4963
  * @returns the current transition type of `self`
4964
+ * @since 1.2
4767
4965
  */
4768
4966
  get_transition_type(): FlapTransitionType;
4769
4967
 
@@ -4772,30 +4970,35 @@ export namespace Handy {
4772
4970
  *
4773
4971
  * It is always displayed when unfolded, and partially visible when folded.
4774
4972
  * @param content the content widget
4973
+ * @since 1.2
4775
4974
  */
4776
4975
  set_content(content: Gtk.Widget | null): void;
4777
4976
 
4778
4977
  /**
4779
4978
  * Sets the flap widget for `self`.
4780
4979
  * @param flap the flap widget
4980
+ * @since 1.2
4781
4981
  */
4782
4982
  set_flap(flap: Gtk.Widget | null): void;
4783
4983
 
4784
4984
  /**
4785
4985
  * Sets the flap position for `self`.
4786
4986
  * @param position the new value
4987
+ * @since 1.2
4787
4988
  */
4788
4989
  set_flap_position(position: Gtk.PackType): void;
4789
4990
 
4790
4991
  /**
4791
4992
  * Sets the duration that fold transitions will take.
4792
4993
  * @param duration the new duration, in milliseconds
4994
+ * @since 1.2
4793
4995
  */
4794
4996
  set_fold_duration(duration: number): void;
4795
4997
 
4796
4998
  /**
4797
4999
  * Sets the current fold policy for `self`.
4798
5000
  * @param policy a fold policy
5001
+ * @since 1.2
4799
5002
  */
4800
5003
  set_fold_policy(policy: FlapFoldPolicy): void;
4801
5004
 
@@ -4806,6 +5009,7 @@ export namespace Handy {
4806
5009
  * and unfolding it when the flap is not revealed opens it. If `TRUE`,
4807
5010
  * {@link Flap.reveal_flap} value never changes on its own.
4808
5011
  * @param locked the new value
5012
+ * @since 1.2
4809
5013
  */
4810
5014
  set_locked(locked: boolean): void;
4811
5015
 
@@ -4816,24 +5020,28 @@ export namespace Handy {
4816
5020
  * pressing the <kbd>Esc</kbd> key, will close the flap. If `FALSE`, clicks are
4817
5021
  * passed through to the content widget.
4818
5022
  * @param modal whether `self` can be closed with a click
5023
+ * @since 1.2
4819
5024
  */
4820
5025
  set_modal(modal: boolean): void;
4821
5026
 
4822
5027
  /**
4823
5028
  * Sets the duration that reveal transitions in `self` will take.
4824
5029
  * @param duration the new duration, in milliseconds
5030
+ * @since 1.2
4825
5031
  */
4826
5032
  set_reveal_duration(duration: number): void;
4827
5033
 
4828
5034
  /**
4829
5035
  * Sets whether the flap widget is revealed for `self`.
4830
5036
  * @param reveal_flap `TRUE` to reveal the flap widget, `FALSE` otherwise
5037
+ * @since 1.2
4831
5038
  */
4832
5039
  set_reveal_flap(reveal_flap: boolean): void;
4833
5040
 
4834
5041
  /**
4835
5042
  * Sets the separator widget for `self`.
4836
5043
  * @param separator the separator widget
5044
+ * @since 1.2
4837
5045
  */
4838
5046
  set_separator(separator: Gtk.Widget | null): void;
4839
5047
 
@@ -4842,6 +5050,7 @@ export namespace Handy {
4842
5050
  *
4843
5051
  * The area that can be swiped depends on the {@link Flap.transition_type} value.
4844
5052
  * @param swipe_to_close whether `self` can be closed with a swipe gesture
5053
+ * @since 1.2
4845
5054
  */
4846
5055
  set_swipe_to_close(swipe_to_close: boolean): void;
4847
5056
 
@@ -4851,12 +5060,14 @@ export namespace Handy {
4851
5060
  * The area that can be swiped depends on the {@link Flap.transition_type}
4852
5061
  * value.
4853
5062
  * @param swipe_to_open whether `self` can be opened with a swipe gesture
5063
+ * @since 1.2
4854
5064
  */
4855
5065
  set_swipe_to_open(swipe_to_open: boolean): void;
4856
5066
 
4857
5067
  /**
4858
5068
  * Sets the type of animation used for reveal and fold transitions in `self`.
4859
5069
  * @param transition_type the new transition type
5070
+ * @since 1.2
4860
5071
  */
4861
5072
  set_transition_type(transition_type: FlapTransitionType): void;
4862
5073
 
@@ -4872,12 +5083,14 @@ export namespace Handy {
4872
5083
  /**
4873
5084
  * Retrieves the orientation of the `orientable`.
4874
5085
  * @returns the orientation of the `orientable`.
5086
+ * @since 2.16
4875
5087
  */
4876
5088
  get_orientation(): Gtk.Orientation;
4877
5089
 
4878
5090
  /**
4879
5091
  * Sets the orientation of the `orientable`.
4880
5092
  * @param orientation the orientable’s new orientation.
5093
+ * @since 2.16
4881
5094
  */
4882
5095
  set_orientation(orientation: Gtk.Orientation): void;
4883
5096
 
@@ -4889,12 +5102,14 @@ export namespace Handy {
4889
5102
  * `duration` can be 0 if the child is switched without animation.
4890
5103
  * @param index the index of the child to switch to
4891
5104
  * @param duration animation duration, in milliseconds
5105
+ * @since 1.0
4892
5106
  */
4893
5107
  emit_child_switched(index: number, duration: bigint | number): void;
4894
5108
 
4895
5109
  /**
4896
5110
  * Gets the progress `self` will snap back to after the gesture is canceled.
4897
5111
  * @returns the cancel progress, unitless
5112
+ * @since 1.0
4898
5113
  */
4899
5114
  get_cancel_progress(): number;
4900
5115
 
@@ -4903,12 +5118,14 @@ export namespace Handy {
4903
5118
  *
4904
5119
  * This corresponds to how many pixels 1 unit represents.
4905
5120
  * @returns the swipe distance in pixels
5121
+ * @since 1.0
4906
5122
  */
4907
5123
  get_distance(): number;
4908
5124
 
4909
5125
  /**
4910
5126
  * Gets the current progress of `self`.
4911
5127
  * @returns the current progress, unitless
5128
+ * @since 1.0
4912
5129
  */
4913
5130
  get_progress(): number;
4914
5131
 
@@ -4918,6 +5135,7 @@ export namespace Handy {
4918
5135
  * Each snap point represents a progress value that is considered acceptable to
4919
5136
  * end the swipe on.
4920
5137
  * @returns the snap points
5138
+ * @since 1.0
4921
5139
  */
4922
5140
  get_snap_points(): number[];
4923
5141
 
@@ -4936,12 +5154,14 @@ export namespace Handy {
4936
5154
  * `self`, allowing swipes from anywhere.
4937
5155
  * @param navigation_direction the direction of the swipe
4938
5156
  * @param is_drag whether the swipe is caused by a dragging gesture
5157
+ * @since 1.0
4939
5158
  */
4940
5159
  get_swipe_area(navigation_direction: NavigationDirection, is_drag: boolean): Gdk.Rectangle;
4941
5160
 
4942
5161
  /**
4943
5162
  * Gets the {@link SwipeTracker} used by this swipeable widget.
4944
5163
  * @returns the swipe tracker
5164
+ * @since 1.0
4945
5165
  */
4946
5166
  get_swipe_tracker(): SwipeTracker;
4947
5167
 
@@ -4951,11 +5171,13 @@ export namespace Handy {
4951
5171
  * See `Handy.Swipeable::child-switched`.
4952
5172
  * @param index the index of the child to switch to
4953
5173
  * @param duration animation duration, in milliseconds
5174
+ * @since 1.0
4954
5175
  */
4955
5176
  switch_child(index: number, duration: bigint | number): void;
4956
5177
 
4957
5178
  /**
4958
5179
  * Gets the progress `self` will snap back to after the gesture is canceled.
5180
+ * @since 1.0
4959
5181
  * @virtual
4960
5182
  */
4961
5183
  vfunc_get_cancel_progress(): number;
@@ -4964,12 +5186,14 @@ export namespace Handy {
4964
5186
  * Gets the swipe distance of `self`.
4965
5187
  *
4966
5188
  * This corresponds to how many pixels 1 unit represents.
5189
+ * @since 1.0
4967
5190
  * @virtual
4968
5191
  */
4969
5192
  vfunc_get_distance(): number;
4970
5193
 
4971
5194
  /**
4972
5195
  * Gets the current progress of `self`.
5196
+ * @since 1.0
4973
5197
  * @virtual
4974
5198
  */
4975
5199
  vfunc_get_progress(): number;
@@ -4979,6 +5203,7 @@ export namespace Handy {
4979
5203
  *
4980
5204
  * Each snap point represents a progress value that is considered acceptable to
4981
5205
  * end the swipe on.
5206
+ * @since 1.0
4982
5207
  * @virtual
4983
5208
  */
4984
5209
  vfunc_get_snap_points(): number[];
@@ -4998,12 +5223,14 @@ export namespace Handy {
4998
5223
  * `self`, allowing swipes from anywhere.
4999
5224
  * @param navigation_direction the direction of the swipe
5000
5225
  * @param is_drag whether the swipe is caused by a dragging gesture
5226
+ * @since 1.0
5001
5227
  * @virtual
5002
5228
  */
5003
5229
  vfunc_get_swipe_area(navigation_direction: NavigationDirection, is_drag: boolean): Gdk.Rectangle;
5004
5230
 
5005
5231
  /**
5006
5232
  * Gets the {@link SwipeTracker} used by this swipeable widget.
5233
+ * @since 1.0
5007
5234
  * @virtual
5008
5235
  */
5009
5236
  vfunc_get_swipe_tracker(): SwipeTracker;
@@ -5014,6 +5241,7 @@ export namespace Handy {
5014
5241
  * See `Handy.Swipeable::child-switched`.
5015
5242
  * @param index the index of the child to switch to
5016
5243
  * @param duration animation duration, in milliseconds
5244
+ * @since 1.0
5017
5245
  * @virtual
5018
5246
  */
5019
5247
  vfunc_switch_child(index: number, duration: number): void;
@@ -5404,18 +5632,21 @@ export namespace Handy {
5404
5632
  /**
5405
5633
  * Gets the policy `self` follows to horizontally align its center widget.
5406
5634
  * @returns the centering policy
5635
+ * @since 1.0
5407
5636
  */
5408
5637
  get_centering_policy(): CenteringPolicy;
5409
5638
 
5410
5639
  /**
5411
5640
  * Retrieves the custom title widget of the header.
5412
5641
  * @returns the custom title widget of the header
5642
+ * @since 1.0
5413
5643
  */
5414
5644
  get_custom_title(): Gtk.Widget | null;
5415
5645
 
5416
5646
  /**
5417
5647
  * Gets the decoration layout.
5418
5648
  * @returns the decoration layout
5649
+ * @since 1.0
5419
5650
  */
5420
5651
  get_decoration_layout(): string;
5421
5652
 
@@ -5423,60 +5654,70 @@ export namespace Handy {
5423
5654
  * Gets whether space is reserved for a subtitle, regardless if one is currently
5424
5655
  * set or not.
5425
5656
  * @returns `TRUE` if the header bar reserves space for a subtitle
5657
+ * @since 1.0
5426
5658
  */
5427
5659
  get_has_subtitle(): boolean;
5428
5660
 
5429
5661
  /**
5430
5662
  * Gets whether `self` should interpolate its size on visible child change.
5431
5663
  * @returns whether `self` interpolates its size on visible child change
5664
+ * @since 1.0
5432
5665
  */
5433
5666
  get_interpolate_size(): boolean;
5434
5667
 
5435
5668
  /**
5436
5669
  * Gets whether this header bar shows the standard window decorations.
5437
5670
  * @returns whether decorations are shown
5671
+ * @since 1.0
5438
5672
  */
5439
5673
  get_show_close_button(): boolean;
5440
5674
 
5441
5675
  /**
5442
5676
  * Gets the subtitle of the header.
5443
5677
  * @returns the subtitle of the header
5678
+ * @since 1.0
5444
5679
  */
5445
5680
  get_subtitle(): string | null;
5446
5681
 
5447
5682
  /**
5448
5683
  * Retrieves the title of the header.
5449
5684
  * @returns the title of the header.
5685
+ * @since 1.0
5450
5686
  */
5451
5687
  get_title(): string | null;
5452
5688
 
5453
5689
  /**
5454
5690
  * Gets the amount of time that transitions between pages will take.
5455
5691
  * @returns the transition duration, in milliseconds
5692
+ * @since 1.0
5456
5693
  */
5457
5694
  get_transition_duration(): number;
5458
5695
 
5459
5696
  /**
5460
5697
  * Gets whether the `self` is currently in a transition from one page to another.
5461
5698
  * @returns whether the transition is currently running
5699
+ * @since 1.0
5462
5700
  */
5463
5701
  get_transition_running(): boolean;
5464
5702
 
5465
5703
  /**
5466
5704
  * Adds `child` to `self`, packed with reference to the end of the `self`.
5467
5705
  * @param child the widget to be added to `self`
5706
+ * @since 1.0
5468
5707
  */
5469
5708
  pack_end(child: Gtk.Widget): void;
5470
5709
 
5471
5710
  /**
5472
5711
  * Adds `child` to `self`, packed with reference to the start of the `self`.
5473
5712
  * @param child the widget to be added to `self`
5713
+ * @since 1.0
5474
5714
  */
5475
5715
  pack_start(child: Gtk.Widget): void;
5476
5716
 
5477
5717
  /**
5478
5718
  * Sets the policy `self` must follow to horizontally align its center widget.
5479
5719
  * @param centering_policy the centering policy
5720
+ * @since 1.0
5480
5721
  */
5481
5722
  set_centering_policy(centering_policy: CenteringPolicy): void;
5482
5723
 
@@ -5491,30 +5732,35 @@ export namespace Handy {
5491
5732
  * You should set the custom title to `NULL`, for the header title label to be
5492
5733
  * visible again.
5493
5734
  * @param title_widget a custom widget to use for a title
5735
+ * @since 1.0
5494
5736
  */
5495
5737
  set_custom_title(title_widget: Gtk.Widget | null): void;
5496
5738
 
5497
5739
  /**
5498
5740
  * Sets the decoration layout for this header bar.
5499
5741
  * @param layout a decoration layout
5742
+ * @since 1.0
5500
5743
  */
5501
5744
  set_decoration_layout(layout: string | null): void;
5502
5745
 
5503
5746
  /**
5504
5747
  * Sets whether space is reserved for a subtitle, even if none is currently set.
5505
5748
  * @param setting `TRUE` to reserve space for a subtitle
5749
+ * @since 1.0
5506
5750
  */
5507
5751
  set_has_subtitle(setting: boolean): void;
5508
5752
 
5509
5753
  /**
5510
5754
  * Sets whether `self` should interpolate its size on visible child change.
5511
5755
  * @param interpolate_size `TRUE` to interpolate the size
5756
+ * @since 1.0
5512
5757
  */
5513
5758
  set_interpolate_size(interpolate_size: boolean): void;
5514
5759
 
5515
5760
  /**
5516
5761
  * Sets whether this header bar shows the standard window decorations.
5517
5762
  * @param setting `TRUE` to show standard window decorations
5763
+ * @since 1.0
5518
5764
  */
5519
5765
  set_show_close_button(setting: boolean): void;
5520
5766
 
@@ -5528,6 +5774,7 @@ export namespace Handy {
5528
5774
  * if none is currently set. If this is not desired, set the
5529
5775
  * {@link HeaderBar.has_subtitle} property to `FALSE`.
5530
5776
  * @param subtitle a subtitle
5777
+ * @since 1.0
5531
5778
  */
5532
5779
  set_subtitle(subtitle: string | null): void;
5533
5780
 
@@ -5537,12 +5784,14 @@ export namespace Handy {
5537
5784
  * The title should help a user identify the current view. A good title should
5538
5785
  * not include the application name.
5539
5786
  * @param title a title
5787
+ * @since 1.0
5540
5788
  */
5541
5789
  set_title(title: string | null): void;
5542
5790
 
5543
5791
  /**
5544
5792
  * Sets the duration that transitions between pages will take.
5545
5793
  * @param duration the new duration, in milliseconds
5794
+ * @since 1.0
5546
5795
  */
5547
5796
  set_transition_duration(duration: number): void;
5548
5797
  }
@@ -5667,6 +5916,7 @@ export namespace Handy {
5667
5916
  * When the widget is destroyed or no longer referenced elsewhere, it will be
5668
5917
  * removed from the header group.
5669
5918
  * @param header_bar the header bar to add
5919
+ * @since 1.0
5670
5920
  */
5671
5921
  add_gtk_header_bar(header_bar: Gtk.HeaderBar): void;
5672
5922
 
@@ -5676,6 +5926,7 @@ export namespace Handy {
5676
5926
  * When the widget is destroyed or no longer referenced elsewhere, it will be
5677
5927
  * removed from the header group.
5678
5928
  * @param header_bar the header bar to add
5929
+ * @since 1.0
5679
5930
  */
5680
5931
  add_header_bar(header_bar: HeaderBar): void;
5681
5932
 
@@ -5685,12 +5936,14 @@ export namespace Handy {
5685
5936
  * When the nested group is no longer referenced elsewhere, it will be removed
5686
5937
  * from the header group.
5687
5938
  * @param header_group the header group to add
5939
+ * @since 1.0
5688
5940
  */
5689
5941
  add_header_group(header_group: HeaderGroup): void;
5690
5942
 
5691
5943
  /**
5692
5944
  * Returns the list of children associated with `self`.
5693
5945
  * @returns the list of children
5946
+ * @since 1.0
5694
5947
  */
5695
5948
  get_children(): HeaderGroupChild[];
5696
5949
 
@@ -5698,30 +5951,35 @@ export namespace Handy {
5698
5951
  * Gets whether the elements of the group should all receive the full
5699
5952
  * decoration.
5700
5953
  * @returns whether the elements of the group should all receive the full decoration
5954
+ * @since 1.0
5701
5955
  */
5702
5956
  get_decorate_all(): boolean;
5703
5957
 
5704
5958
  /**
5705
5959
  * Removes `child` from `self`.
5706
5960
  * @param child the header group child to remove
5961
+ * @since 1.0
5707
5962
  */
5708
5963
  remove_child(child: HeaderGroupChild): void;
5709
5964
 
5710
5965
  /**
5711
5966
  * Removes `header_bar` from `self`.
5712
5967
  * @param header_bar the header bar to remove
5968
+ * @since 1.0
5713
5969
  */
5714
5970
  remove_gtk_header_bar(header_bar: Gtk.HeaderBar): void;
5715
5971
 
5716
5972
  /**
5717
5973
  * Removes `header_bar` from `self`.
5718
5974
  * @param header_bar the header bar to remove
5975
+ * @since 1.0
5719
5976
  */
5720
5977
  remove_header_bar(header_bar: HeaderBar): void;
5721
5978
 
5722
5979
  /**
5723
5980
  * Removes a nested {@link Handy.HeaderGroup} from `self`.
5724
5981
  * @param header_group the header group to remove
5982
+ * @since 1.0
5725
5983
  */
5726
5984
  remove_header_group(header_group: HeaderGroup): void;
5727
5985
 
@@ -5729,6 +5987,7 @@ export namespace Handy {
5729
5987
  * Sets whether the elements of the group should all receive the full
5730
5988
  * decoration.
5731
5989
  * @param decorate_all whether the elements of the group should all receive the full decoration
5990
+ * @since 1.0
5732
5991
  */
5733
5992
  set_decorate_all(decorate_all: boolean): void;
5734
5993
 
@@ -5738,6 +5997,7 @@ export namespace Handy {
5738
5997
  * @param builder a {@link Gtk.Builder}
5739
5998
  * @param child child to add
5740
5999
  * @param type kind of child or `null`
6000
+ * @since 2.12
5741
6001
  */
5742
6002
  add_child(builder: Gtk.Builder, child: GObject.Object, type: string | null): void;
5743
6003
 
@@ -5749,6 +6009,7 @@ export namespace Handy {
5749
6009
  * @param builder {@link Gtk.Builder} used to construct this object
5750
6010
  * @param name name of child to construct
5751
6011
  * @returns the constructed child
6012
+ * @since 2.12
5752
6013
  */
5753
6014
  construct_child<T = GObject.Object>(builder: Gtk.Builder, name: string): T;
5754
6015
 
@@ -5759,6 +6020,7 @@ export namespace Handy {
5759
6020
  * @param child child object or `null` for non-child tags
5760
6021
  * @param tagname the name of the tag
5761
6022
  * @param data user data created in custom_tag_start
6023
+ * @since 2.12
5762
6024
  */
5763
6025
  custom_finished(builder: Gtk.Builder, child: GObject.Object | null, tagname: string, data: null): void;
5764
6026
 
@@ -5769,6 +6031,7 @@ export namespace Handy {
5769
6031
  * @param child child object or `null` for non-child tags
5770
6032
  * @param tagname name of tag
5771
6033
  * @param data user data that will be passed in to parser functions
6034
+ * @since 2.12
5772
6035
  */
5773
6036
  custom_tag_end(builder: Gtk.Builder, child: GObject.Object | null, tagname: string, data: null): void;
5774
6037
 
@@ -5778,6 +6041,7 @@ export namespace Handy {
5778
6041
  * @param child child object or `null` for non-child tags
5779
6042
  * @param tagname name of tag
5780
6043
  * @returns `true` if a object has a custom implementation, `false` if it doesn't.
6044
+ * @since 2.12
5781
6045
  */
5782
6046
  custom_tag_start(builder: Gtk.Builder, child: GObject.Object | null, tagname: string): [boolean, GLib.MarkupParser, null];
5783
6047
 
@@ -5786,6 +6050,7 @@ export namespace Handy {
5786
6050
  * @param builder a {@link Gtk.Builder}
5787
6051
  * @param childname name of child
5788
6052
  * @returns the internal child of the buildable object
6053
+ * @since 2.12
5789
6054
  */
5790
6055
  get_internal_child<T = GObject.Object>(builder: Gtk.Builder, childname: string): T;
5791
6056
 
@@ -5796,6 +6061,7 @@ export namespace Handy {
5796
6061
  * [GtkBuilder UI definition][BUILDER-UI]
5797
6062
  * used to construct the `buildable`.
5798
6063
  * @returns the name set with `gtk_buildable_set_name()`
6064
+ * @since 2.12
5799
6065
  */
5800
6066
  get_name(): string;
5801
6067
 
@@ -5806,6 +6072,7 @@ export namespace Handy {
5806
6072
  * `gtk_builder_add_from_file()` or `gtk_builder_add_from_string()`
5807
6073
  * is called on a builder.
5808
6074
  * @param builder a {@link Gtk.Builder}
6075
+ * @since 2.12
5809
6076
  */
5810
6077
  parser_finished(builder: Gtk.Builder): void;
5811
6078
 
@@ -5814,12 +6081,14 @@ export namespace Handy {
5814
6081
  * @param builder a {@link Gtk.Builder}
5815
6082
  * @param name name of property
5816
6083
  * @param value value of property
6084
+ * @since 2.12
5817
6085
  */
5818
6086
  set_buildable_property(builder: Gtk.Builder, name: string, value: GObject.Value | any): void;
5819
6087
 
5820
6088
  /**
5821
6089
  * Sets the name of the `buildable` object.
5822
6090
  * @param name name to set
6091
+ * @since 2.12
5823
6092
  */
5824
6093
  set_name(name: string): void;
5825
6094
 
@@ -5829,6 +6098,7 @@ export namespace Handy {
5829
6098
  * @param builder a {@link Gtk.Builder}
5830
6099
  * @param child child to add
5831
6100
  * @param type kind of child or `null`
6101
+ * @since 2.12
5832
6102
  * @virtual
5833
6103
  */
5834
6104
  vfunc_add_child(builder: Gtk.Builder, child: GObject.Object, type: string | null): void;
@@ -5840,6 +6110,7 @@ export namespace Handy {
5840
6110
  * specified in the UI definition.
5841
6111
  * @param builder {@link Gtk.Builder} used to construct this object
5842
6112
  * @param name name of child to construct
6113
+ * @since 2.12
5843
6114
  * @virtual
5844
6115
  */
5845
6116
  vfunc_construct_child<T = GObject.Object>(builder: Gtk.Builder, name: string): T;
@@ -5851,6 +6122,7 @@ export namespace Handy {
5851
6122
  * @param child child object or `null` for non-child tags
5852
6123
  * @param tagname the name of the tag
5853
6124
  * @param data user data created in custom_tag_start
6125
+ * @since 2.12
5854
6126
  * @virtual
5855
6127
  */
5856
6128
  vfunc_custom_finished(builder: Gtk.Builder, child: GObject.Object | null, tagname: string, data: null): void;
@@ -5862,6 +6134,7 @@ export namespace Handy {
5862
6134
  * @param child child object or `null` for non-child tags
5863
6135
  * @param tagname name of tag
5864
6136
  * @param data user data that will be passed in to parser functions
6137
+ * @since 2.12
5865
6138
  * @virtual
5866
6139
  */
5867
6140
  vfunc_custom_tag_end(builder: Gtk.Builder, child: GObject.Object | null, tagname: string, data: null): void;
@@ -5871,6 +6144,7 @@ export namespace Handy {
5871
6144
  * @param builder a {@link Gtk.Builder} used to construct this object
5872
6145
  * @param child child object or `null` for non-child tags
5873
6146
  * @param tagname name of tag
6147
+ * @since 2.12
5874
6148
  * @virtual
5875
6149
  */
5876
6150
  vfunc_custom_tag_start(builder: Gtk.Builder, child: GObject.Object | null, tagname: string): [boolean, GLib.MarkupParser, never];
@@ -5879,6 +6153,7 @@ export namespace Handy {
5879
6153
  * Get the internal child called `childname` of the `buildable` object.
5880
6154
  * @param builder a {@link Gtk.Builder}
5881
6155
  * @param childname name of child
6156
+ * @since 2.12
5882
6157
  * @virtual
5883
6158
  */
5884
6159
  vfunc_get_internal_child<T = GObject.Object>(builder: Gtk.Builder, childname: string): T;
@@ -5889,6 +6164,7 @@ export namespace Handy {
5889
6164
  * {@link Gtk.Builder} sets the name based on the
5890
6165
  * [GtkBuilder UI definition][BUILDER-UI]
5891
6166
  * used to construct the `buildable`.
6167
+ * @since 2.12
5892
6168
  * @virtual
5893
6169
  */
5894
6170
  vfunc_get_name(): string;
@@ -5900,6 +6176,7 @@ export namespace Handy {
5900
6176
  * `gtk_builder_add_from_file()` or `gtk_builder_add_from_string()`
5901
6177
  * is called on a builder.
5902
6178
  * @param builder a {@link Gtk.Builder}
6179
+ * @since 2.12
5903
6180
  * @virtual
5904
6181
  */
5905
6182
  vfunc_parser_finished(builder: Gtk.Builder): void;
@@ -5909,6 +6186,7 @@ export namespace Handy {
5909
6186
  * @param builder a {@link Gtk.Builder}
5910
6187
  * @param name name of property
5911
6188
  * @param value value of property
6189
+ * @since 2.12
5912
6190
  * @virtual
5913
6191
  */
5914
6192
  vfunc_set_buildable_property(builder: Gtk.Builder, name: string, value: unknown): void;
@@ -5916,6 +6194,7 @@ export namespace Handy {
5916
6194
  /**
5917
6195
  * Sets the name of the `buildable` object.
5918
6196
  * @param name name to set
6197
+ * @since 2.12
5919
6198
  * @virtual
5920
6199
  */
5921
6200
  vfunc_set_name(name: string): void;
@@ -5969,6 +6248,7 @@ export namespace Handy {
5969
6248
  /**
5970
6249
  * Gets the child type.
5971
6250
  * @returns the child type
6251
+ * @since 1.0
5972
6252
  */
5973
6253
  get_child_type(): HeaderGroupChildType;
5974
6254
 
@@ -5977,6 +6257,7 @@ export namespace Handy {
5977
6257
  *
5978
6258
  * Use {@link HeaderGroupChild.get_child_type} to check the child type.
5979
6259
  * @returns the child header bar
6260
+ * @since 1.0
5980
6261
  */
5981
6262
  get_gtk_header_bar(): Gtk.HeaderBar;
5982
6263
 
@@ -5985,6 +6266,7 @@ export namespace Handy {
5985
6266
  *
5986
6267
  * Use {@link HeaderGroupChild.get_child_type} to check the child type.
5987
6268
  * @returns the child headerbar
6269
+ * @since 1.0
5988
6270
  */
5989
6271
  get_header_bar(): HeaderBar;
5990
6272
 
@@ -5993,6 +6275,7 @@ export namespace Handy {
5993
6275
  *
5994
6276
  * Use {@link HeaderGroupChild.get_child_type} to check the child type.
5995
6277
  * @returns the child header bar
6278
+ * @since 1.0
5996
6279
  */
5997
6280
  get_header_group(): HeaderGroup;
5998
6281
  }
@@ -6228,84 +6511,98 @@ export namespace Handy {
6228
6511
  /**
6229
6512
  * Returns the amount of space between the columns of `self`.
6230
6513
  * @returns the column spacing of `self`
6514
+ * @since 1.0
6231
6515
  */
6232
6516
  get_column_spacing(): number;
6233
6517
 
6234
6518
  /**
6235
6519
  * Gets the widget for the lower right corner (or left, in RTL locales).
6236
6520
  * @returns the end action widget
6521
+ * @since 1.0
6237
6522
  */
6238
6523
  get_end_action(): Gtk.Widget | null;
6239
6524
 
6240
6525
  /**
6241
6526
  * Gets the connected entry.
6242
6527
  * @returns the entry set
6528
+ * @since 1.0
6243
6529
  */
6244
6530
  get_entry(): Gtk.Entry;
6245
6531
 
6246
6532
  /**
6247
6533
  * Gets whether standard letters are displayed below the digits on the buttons.
6248
6534
  * @returns whether the letters below the digits should be visible
6535
+ * @since 1.0
6249
6536
  */
6250
6537
  get_letters_visible(): boolean;
6251
6538
 
6252
6539
  /**
6253
6540
  * Returns the amount of space between the rows of `self`.
6254
6541
  * @returns the row spacing of `self`
6542
+ * @since 1.0
6255
6543
  */
6256
6544
  get_row_spacing(): number;
6257
6545
 
6258
6546
  /**
6259
6547
  * Gets the widget for the lower left corner (or right, in RTL locales).
6260
6548
  * @returns the start action widget
6549
+ * @since 1.0
6261
6550
  */
6262
6551
  get_start_action(): Gtk.Widget | null;
6263
6552
 
6264
6553
  /**
6265
6554
  * Gets whether symbols are displayed.
6266
6555
  * @returns whether symboles are visible
6556
+ * @since 1.0
6267
6557
  */
6268
6558
  get_symbols_visible(): boolean;
6269
6559
 
6270
6560
  /**
6271
6561
  * Sets the amount of space between columns of `self`.
6272
6562
  * @param spacing the amount of space to insert between columns
6563
+ * @since 1.0
6273
6564
  */
6274
6565
  set_column_spacing(spacing: number): void;
6275
6566
 
6276
6567
  /**
6277
6568
  * Sets the widget for the lower right corner (or left, in RTL locales).
6278
6569
  * @param end_action the end action widget
6570
+ * @since 1.0
6279
6571
  */
6280
6572
  set_end_action(end_action: Gtk.Widget | null): void;
6281
6573
 
6282
6574
  /**
6283
6575
  * Binds `entry` to `self`.
6284
6576
  * @param entry an entry
6577
+ * @since 1.0
6285
6578
  */
6286
6579
  set_entry(entry: Gtk.Entry | null): void;
6287
6580
 
6288
6581
  /**
6289
6582
  * Sets whether standard letters are displayed below the digits on the buttons.
6290
6583
  * @param letters_visible whether the letters below the digits should be visible
6584
+ * @since 1.0
6291
6585
  */
6292
6586
  set_letters_visible(letters_visible: boolean): void;
6293
6587
 
6294
6588
  /**
6295
6589
  * Sets the amount of space between rows of `self`.
6296
6590
  * @param spacing the amount of space to insert between rows
6591
+ * @since 1.0
6297
6592
  */
6298
6593
  set_row_spacing(spacing: number): void;
6299
6594
 
6300
6595
  /**
6301
6596
  * Sets the widget for the lower left corner (or right, in RTL locales).
6302
6597
  * @param start_action the start action widget
6598
+ * @since 1.0
6303
6599
  */
6304
6600
  set_start_action(start_action: Gtk.Widget | null): void;
6305
6601
 
6306
6602
  /**
6307
6603
  * Sets whether standard letters are displayed below the digits on the buttons.
6308
6604
  * @param symbols_visible whether the hash, plus, and asterisk symbols should be visible
6605
+ * @since 1.0
6309
6606
  */
6310
6607
  set_symbols_visible(symbols_visible: boolean): void;
6311
6608
  }
@@ -6724,18 +7021,21 @@ export namespace Handy {
6724
7021
  * If there's no child to navigate to, `NULL` will be returned instead.
6725
7022
  * @param direction the direction
6726
7023
  * @returns the previous or next child
7024
+ * @since 1.0
6727
7025
  */
6728
7026
  get_adjacent_child(direction: NavigationDirection): Gtk.Widget | null;
6729
7027
 
6730
7028
  /**
6731
7029
  * Gets whether swipe gestures switch to the previous navigatable child.
6732
7030
  * @returns `TRUE` if back swipe is enabled
7031
+ * @since 1.0
6733
7032
  */
6734
7033
  get_can_swipe_back(): boolean;
6735
7034
 
6736
7035
  /**
6737
7036
  * Gets whether swipe gestures switch to the next navigatable child.
6738
7037
  * @returns `TRUE` if forward swipe is enabled
7038
+ * @since 1.0
6739
7039
  */
6740
7040
  get_can_swipe_forward(): boolean;
6741
7041
 
@@ -6745,24 +7045,28 @@ export namespace Handy {
6745
7045
  * Returns `NULL` if there is no child with this name.
6746
7046
  * @param name the name of the child to find
6747
7047
  * @returns the requested child of `self`
7048
+ * @since 1.0
6748
7049
  */
6749
7050
  get_child_by_name(name: string): Gtk.Widget | null;
6750
7051
 
6751
7052
  /**
6752
7053
  * Gets the amount of time that transitions between children will take.
6753
7054
  * @returns the child transition duration, in milliseconds
7055
+ * @since 1.0
6754
7056
  */
6755
7057
  get_child_transition_duration(): number;
6756
7058
 
6757
7059
  /**
6758
7060
  * Returns whether `self` is currently in a transition from one page to another.
6759
7061
  * @returns whether a transition is currently running
7062
+ * @since 1.0
6760
7063
  */
6761
7064
  get_child_transition_running(): boolean;
6762
7065
 
6763
7066
  /**
6764
7067
  * Gets whether `self` is folded.
6765
7068
  * @returns whether `self` is folded
7069
+ * @since 1.0
6766
7070
  */
6767
7071
  get_folded(): boolean;
6768
7072
 
@@ -6771,18 +7075,21 @@ export namespace Handy {
6771
7075
  * @param folded the fold
6772
7076
  * @param orientation the orientation
6773
7077
  * @returns whether `self` is homogeneous for the given fold and orientation
7078
+ * @since 1.0
6774
7079
  */
6775
7080
  get_homogeneous(folded: boolean, orientation: Gtk.Orientation): boolean;
6776
7081
 
6777
7082
  /**
6778
7083
  * Gets whether to interpolate between the sizes of children on page switches.
6779
7084
  * @returns `TRUE` if child sizes are interpolated
7085
+ * @since 1.0
6780
7086
  */
6781
7087
  get_interpolate_size(): boolean;
6782
7088
 
6783
7089
  /**
6784
7090
  * Gets the amount of time that transitions between modes in `self` will take.
6785
7091
  * @returns the mode transition duration, in milliseconds
7092
+ * @since 1.0
6786
7093
  */
6787
7094
  get_mode_transition_duration(): number;
6788
7095
 
@@ -6790,18 +7097,21 @@ export namespace Handy {
6790
7097
  * Gets the animation type that will be used for transitions between modes and
6791
7098
  * children.
6792
7099
  * @returns the current transition type of `self`
7100
+ * @since 1.0
6793
7101
  */
6794
7102
  get_transition_type(): LeafletTransitionType;
6795
7103
 
6796
7104
  /**
6797
7105
  * Gets the visible child widget.
6798
7106
  * @returns the visible child widget
7107
+ * @since 1.0
6799
7108
  */
6800
7109
  get_visible_child(): Gtk.Widget;
6801
7110
 
6802
7111
  /**
6803
7112
  * Gets the name of the currently visible child widget.
6804
7113
  * @returns the name of the visible child
7114
+ * @since 1.0
6805
7115
  */
6806
7116
  get_visible_child_name(): string;
6807
7117
 
@@ -6811,6 +7121,7 @@ export namespace Handy {
6811
7121
  * If `sibling` is `NULL`, inserts `child` at the first position.
6812
7122
  * @param child the widget to insert
6813
7123
  * @param sibling the sibling after which to insert `child`
7124
+ * @since 1.2
6814
7125
  */
6815
7126
  insert_child_after(child: Gtk.Widget, sibling: Gtk.Widget | null): void;
6816
7127
 
@@ -6820,12 +7131,14 @@ export namespace Handy {
6820
7131
  * The switch is similar to performing a swipe gesture to go in `direction`.
6821
7132
  * @param direction the direction
6822
7133
  * @returns whether the visible child was changed
7134
+ * @since 1.0
6823
7135
  */
6824
7136
  navigate(direction: NavigationDirection): boolean;
6825
7137
 
6826
7138
  /**
6827
7139
  * Inserts `child` at the first position in `self`.
6828
7140
  * @param child the widget to prepend
7141
+ * @since 1.2
6829
7142
  */
6830
7143
  prepend(child: Gtk.Widget): void;
6831
7144
 
@@ -6835,24 +7148,28 @@ export namespace Handy {
6835
7148
  * If `sibling` is `NULL`, move `child` to the first position.
6836
7149
  * @param child the widget to move, must be a child of `self`
6837
7150
  * @param sibling the sibling to move `child` after
7151
+ * @since 1.2
6838
7152
  */
6839
7153
  reorder_child_after(child: Gtk.Widget, sibling: Gtk.Widget | null): void;
6840
7154
 
6841
7155
  /**
6842
7156
  * Sets whether swipe gestures switch to the previous navigatable child.
6843
7157
  * @param can_swipe_back the new value
7158
+ * @since 1.0
6844
7159
  */
6845
7160
  set_can_swipe_back(can_swipe_back: boolean): void;
6846
7161
 
6847
7162
  /**
6848
7163
  * Sets whether swipe gestures switch to the next navigatable child.
6849
7164
  * @param can_swipe_forward the new value
7165
+ * @since 1.0
6850
7166
  */
6851
7167
  set_can_swipe_forward(can_swipe_forward: boolean): void;
6852
7168
 
6853
7169
  /**
6854
7170
  * Sets the duration that transitions between children in `self` will take.
6855
7171
  * @param duration the new duration, in milliseconds
7172
+ * @since 1.0
6856
7173
  */
6857
7174
  set_child_transition_duration(duration: number): void;
6858
7175
 
@@ -6866,6 +7183,7 @@ export namespace Handy {
6866
7183
  * @param folded the fold
6867
7184
  * @param orientation the orientation
6868
7185
  * @param homogeneous `TRUE` to make `self` homogeneous
7186
+ * @since 1.0
6869
7187
  */
6870
7188
  set_homogeneous(folded: boolean, orientation: Gtk.Orientation, homogeneous: boolean): void;
6871
7189
 
@@ -6876,12 +7194,14 @@ export namespace Handy {
6876
7194
  * will interpolate its size between the current one and the one it'll take
6877
7195
  * after changing the visible child, according to the set transition duration.
6878
7196
  * @param interpolate_size the new value
7197
+ * @since 1.0
6879
7198
  */
6880
7199
  set_interpolate_size(interpolate_size: boolean): void;
6881
7200
 
6882
7201
  /**
6883
7202
  * Sets the duration that transitions between modes in `self` will take.
6884
7203
  * @param duration the new duration, in milliseconds
7204
+ * @since 1.0
6885
7205
  */
6886
7206
  set_mode_transition_duration(duration: number): void;
6887
7207
 
@@ -6893,12 +7213,14 @@ export namespace Handy {
6893
7213
  * possible to change the animation based on the mode or child that is about to
6894
7214
  * become current.
6895
7215
  * @param transition the new transition type
7216
+ * @since 1.0
6896
7217
  */
6897
7218
  set_transition_type(transition: LeafletTransitionType): void;
6898
7219
 
6899
7220
  /**
6900
7221
  * Sets the currently visible widget when the leaflet is folded.
6901
7222
  * @param visible_child the new child
7223
+ * @since 1.0
6902
7224
  */
6903
7225
  set_visible_child(visible_child: Gtk.Widget): void;
6904
7226
 
@@ -6907,6 +7229,7 @@ export namespace Handy {
6907
7229
  *
6908
7230
  * See {@link Leaflet.set_visible_child} for more details.
6909
7231
  * @param name the name of a child
7232
+ * @since 1.0
6910
7233
  */
6911
7234
  set_visible_child_name(name: string): void;
6912
7235
 
@@ -6922,12 +7245,14 @@ export namespace Handy {
6922
7245
  /**
6923
7246
  * Retrieves the orientation of the `orientable`.
6924
7247
  * @returns the orientation of the `orientable`.
7248
+ * @since 2.16
6925
7249
  */
6926
7250
  get_orientation(): Gtk.Orientation;
6927
7251
 
6928
7252
  /**
6929
7253
  * Sets the orientation of the `orientable`.
6930
7254
  * @param orientation the orientable’s new orientation.
7255
+ * @since 2.16
6931
7256
  */
6932
7257
  set_orientation(orientation: Gtk.Orientation): void;
6933
7258
 
@@ -6939,12 +7264,14 @@ export namespace Handy {
6939
7264
  * `duration` can be 0 if the child is switched without animation.
6940
7265
  * @param index the index of the child to switch to
6941
7266
  * @param duration animation duration, in milliseconds
7267
+ * @since 1.0
6942
7268
  */
6943
7269
  emit_child_switched(index: number, duration: bigint | number): void;
6944
7270
 
6945
7271
  /**
6946
7272
  * Gets the progress `self` will snap back to after the gesture is canceled.
6947
7273
  * @returns the cancel progress, unitless
7274
+ * @since 1.0
6948
7275
  */
6949
7276
  get_cancel_progress(): number;
6950
7277
 
@@ -6953,12 +7280,14 @@ export namespace Handy {
6953
7280
  *
6954
7281
  * This corresponds to how many pixels 1 unit represents.
6955
7282
  * @returns the swipe distance in pixels
7283
+ * @since 1.0
6956
7284
  */
6957
7285
  get_distance(): number;
6958
7286
 
6959
7287
  /**
6960
7288
  * Gets the current progress of `self`.
6961
7289
  * @returns the current progress, unitless
7290
+ * @since 1.0
6962
7291
  */
6963
7292
  get_progress(): number;
6964
7293
 
@@ -6968,6 +7297,7 @@ export namespace Handy {
6968
7297
  * Each snap point represents a progress value that is considered acceptable to
6969
7298
  * end the swipe on.
6970
7299
  * @returns the snap points
7300
+ * @since 1.0
6971
7301
  */
6972
7302
  get_snap_points(): number[];
6973
7303
 
@@ -6986,12 +7316,14 @@ export namespace Handy {
6986
7316
  * `self`, allowing swipes from anywhere.
6987
7317
  * @param navigation_direction the direction of the swipe
6988
7318
  * @param is_drag whether the swipe is caused by a dragging gesture
7319
+ * @since 1.0
6989
7320
  */
6990
7321
  get_swipe_area(navigation_direction: NavigationDirection, is_drag: boolean): Gdk.Rectangle;
6991
7322
 
6992
7323
  /**
6993
7324
  * Gets the {@link SwipeTracker} used by this swipeable widget.
6994
7325
  * @returns the swipe tracker
7326
+ * @since 1.0
6995
7327
  */
6996
7328
  get_swipe_tracker(): SwipeTracker;
6997
7329
 
@@ -7001,11 +7333,13 @@ export namespace Handy {
7001
7333
  * See `Handy.Swipeable::child-switched`.
7002
7334
  * @param index the index of the child to switch to
7003
7335
  * @param duration animation duration, in milliseconds
7336
+ * @since 1.0
7004
7337
  */
7005
7338
  switch_child(index: number, duration: bigint | number): void;
7006
7339
 
7007
7340
  /**
7008
7341
  * Gets the progress `self` will snap back to after the gesture is canceled.
7342
+ * @since 1.0
7009
7343
  * @virtual
7010
7344
  */
7011
7345
  vfunc_get_cancel_progress(): number;
@@ -7014,12 +7348,14 @@ export namespace Handy {
7014
7348
  * Gets the swipe distance of `self`.
7015
7349
  *
7016
7350
  * This corresponds to how many pixels 1 unit represents.
7351
+ * @since 1.0
7017
7352
  * @virtual
7018
7353
  */
7019
7354
  vfunc_get_distance(): number;
7020
7355
 
7021
7356
  /**
7022
7357
  * Gets the current progress of `self`.
7358
+ * @since 1.0
7023
7359
  * @virtual
7024
7360
  */
7025
7361
  vfunc_get_progress(): number;
@@ -7029,6 +7365,7 @@ export namespace Handy {
7029
7365
  *
7030
7366
  * Each snap point represents a progress value that is considered acceptable to
7031
7367
  * end the swipe on.
7368
+ * @since 1.0
7032
7369
  * @virtual
7033
7370
  */
7034
7371
  vfunc_get_snap_points(): number[];
@@ -7048,12 +7385,14 @@ export namespace Handy {
7048
7385
  * `self`, allowing swipes from anywhere.
7049
7386
  * @param navigation_direction the direction of the swipe
7050
7387
  * @param is_drag whether the swipe is caused by a dragging gesture
7388
+ * @since 1.0
7051
7389
  * @virtual
7052
7390
  */
7053
7391
  vfunc_get_swipe_area(navigation_direction: NavigationDirection, is_drag: boolean): Gdk.Rectangle;
7054
7392
 
7055
7393
  /**
7056
7394
  * Gets the {@link SwipeTracker} used by this swipeable widget.
7395
+ * @since 1.0
7057
7396
  * @virtual
7058
7397
  */
7059
7398
  vfunc_get_swipe_tracker(): SwipeTracker;
@@ -7064,6 +7403,7 @@ export namespace Handy {
7064
7403
  * See `Handy.Swipeable::child-switched`.
7065
7404
  * @param index the index of the child to switch to
7066
7405
  * @param duration animation duration, in milliseconds
7406
+ * @since 1.0
7067
7407
  * @virtual
7068
7408
  */
7069
7409
  vfunc_switch_child(index: number, duration: number): void;
@@ -7229,36 +7569,42 @@ export namespace Handy {
7229
7569
  // Methods
7230
7570
  /**
7231
7571
  * @returns the description of `self`
7572
+ * @since 1.0
7232
7573
  */
7233
7574
  get_description(): string;
7234
7575
 
7235
7576
  /**
7236
7577
  * Gets the title of `self`.
7237
7578
  * @returns the title of `self`
7579
+ * @since 1.0
7238
7580
  */
7239
7581
  get_title(): string;
7240
7582
 
7241
7583
  /**
7242
7584
  * Gets whether `self` uses markup for the title and description.
7243
7585
  * @returns whether `self` uses markup for its labels
7586
+ * @since 1.4
7244
7587
  */
7245
7588
  get_use_markup(): boolean;
7246
7589
 
7247
7590
  /**
7248
7591
  * Sets the description for `self`.
7249
7592
  * @param description the description
7593
+ * @since 1.0
7250
7594
  */
7251
7595
  set_description(description: string): void;
7252
7596
 
7253
7597
  /**
7254
7598
  * Sets the title for `self`.
7255
7599
  * @param title the title
7600
+ * @since 1.0
7256
7601
  */
7257
7602
  set_title(title: string): void;
7258
7603
 
7259
7604
  /**
7260
7605
  * Sets whether `self` uses markup for the title and description.
7261
7606
  * @param use_markup whether to use markup
7607
+ * @since 1.4
7262
7608
  */
7263
7609
  set_use_markup(use_markup: boolean): void;
7264
7610
  }
@@ -7391,24 +7737,28 @@ export namespace Handy {
7391
7737
  /**
7392
7738
  * Gets the icon name for `self`.
7393
7739
  * @returns the icon name for `self`
7740
+ * @since 1.0
7394
7741
  */
7395
7742
  get_icon_name(): string | null;
7396
7743
 
7397
7744
  /**
7398
7745
  * Gets the title of `self`.
7399
7746
  * @returns the title of the `self`
7747
+ * @since 1.0
7400
7748
  */
7401
7749
  get_title(): string | null;
7402
7750
 
7403
7751
  /**
7404
7752
  * Sets the icon name for `self`.
7405
7753
  * @param icon_name the icon name
7754
+ * @since 1.0
7406
7755
  */
7407
7756
  set_icon_name(icon_name: string | null): void;
7408
7757
 
7409
7758
  /**
7410
7759
  * Sets the title of `self`.
7411
7760
  * @param title the title of the page
7761
+ * @since 1.0
7412
7762
  */
7413
7763
  set_title(title: string | null): void;
7414
7764
  }
@@ -7548,24 +7898,28 @@ export namespace Handy {
7548
7898
  /**
7549
7899
  * Gets the title of the preference represented by `self`.
7550
7900
  * @returns the title of the preference represented by `self`
7901
+ * @since 1.0
7551
7902
  */
7552
7903
  get_title(): string | null;
7553
7904
 
7554
7905
  /**
7555
7906
  * Gets whether an embedded underline in the title indicates a mnemonic.
7556
7907
  * @returns whether an embedded underline in the title indicates a mnemonic
7908
+ * @since 1.0
7557
7909
  */
7558
7910
  get_use_underline(): boolean;
7559
7911
 
7560
7912
  /**
7561
7913
  * Sets the title of the preference represented by `self`.
7562
7914
  * @param title the title
7915
+ * @since 1.0
7563
7916
  */
7564
7917
  set_title(title: string | null): void;
7565
7918
 
7566
7919
  /**
7567
7920
  * Sets whether an embedded underline in the title indicates a mnemonic.
7568
7921
  * @param use_underline `TRUE` if underlines in the text indicate mnemonics
7922
+ * @since 1.0
7569
7923
  */
7570
7924
  set_use_underline(use_underline: boolean): void;
7571
7925
 
@@ -7596,6 +7950,7 @@ export namespace Handy {
7596
7950
  *
7597
7951
  * See `gtk_actionable_set_action_name()` for more information.
7598
7952
  * @returns the action name, or `null` if none is set
7953
+ * @since 3.4
7599
7954
  */
7600
7955
  get_action_name(): string | null;
7601
7956
 
@@ -7604,6 +7959,7 @@ export namespace Handy {
7604
7959
  *
7605
7960
  * See `gtk_actionable_set_action_target_value()` for more information.
7606
7961
  * @returns the current target value
7962
+ * @since 3.4
7607
7963
  */
7608
7964
  get_action_target_value(): GLib.Variant;
7609
7965
 
@@ -7620,6 +7976,7 @@ export namespace Handy {
7620
7976
  * respectively. This is the same form used for actions in the {@link Gio.Menu}
7621
7977
  * associated with the window.
7622
7978
  * @param action_name an action name, or `null`
7979
+ * @since 3.4
7623
7980
  */
7624
7981
  set_action_name(action_name: string | null): void;
7625
7982
 
@@ -7644,6 +8001,7 @@ export namespace Handy {
7644
8001
  * be rendered as active (and the other buttons, with different targets,
7645
8002
  * rendered inactive).
7646
8003
  * @param target_value a {@link GLib.Variant} to set as the target value, or `null`
8004
+ * @since 3.4
7647
8005
  */
7648
8006
  set_action_target_value(target_value: GLib.Variant | null): void;
7649
8007
 
@@ -7660,6 +8018,7 @@ export namespace Handy {
7660
8018
  * `action` is the action name and `target` is the string to use
7661
8019
  * as the target.)
7662
8020
  * @param detailed_action_name the detailed action name
8021
+ * @since 3.4
7663
8022
  */
7664
8023
  set_detailed_action_name(detailed_action_name: string): void;
7665
8024
 
@@ -7667,6 +8026,7 @@ export namespace Handy {
7667
8026
  * Gets the action name for `actionable`.
7668
8027
  *
7669
8028
  * See `gtk_actionable_set_action_name()` for more information.
8029
+ * @since 3.4
7670
8030
  * @virtual
7671
8031
  */
7672
8032
  vfunc_get_action_name(): string | null;
@@ -7675,6 +8035,7 @@ export namespace Handy {
7675
8035
  * Gets the current target value of `actionable`.
7676
8036
  *
7677
8037
  * See `gtk_actionable_set_action_target_value()` for more information.
8038
+ * @since 3.4
7678
8039
  * @virtual
7679
8040
  */
7680
8041
  vfunc_get_action_target_value(): GLib.Variant;
@@ -7692,6 +8053,7 @@ export namespace Handy {
7692
8053
  * respectively. This is the same form used for actions in the {@link Gio.Menu}
7693
8054
  * associated with the window.
7694
8055
  * @param action_name an action name, or `null`
8056
+ * @since 3.4
7695
8057
  * @virtual
7696
8058
  */
7697
8059
  vfunc_set_action_name(action_name: string | null): void;
@@ -7717,6 +8079,7 @@ export namespace Handy {
7717
8079
  * be rendered as active (and the other buttons, with different targets,
7718
8080
  * rendered inactive).
7719
8081
  * @param target_value a {@link GLib.Variant} to set as the target value, or `null`
8082
+ * @since 3.4
7720
8083
  * @virtual
7721
8084
  */
7722
8085
  vfunc_set_action_target_value(target_value: GLib.Variant | null): void;
@@ -7915,6 +8278,7 @@ export namespace Handy {
7915
8278
  * Closes the current subpage.
7916
8279
  *
7917
8280
  * If there is no presented subpage, this does nothing.
8281
+ * @since 1.0
7918
8282
  */
7919
8283
  close_subpage(): void;
7920
8284
 
@@ -7922,12 +8286,14 @@ export namespace Handy {
7922
8286
  * Gets whether swipe gestures allow switching from a subpage to the
7923
8287
  * preferences.
7924
8288
  * @returns `TRUE` if back swipe is enabled
8289
+ * @since 1.0
7925
8290
  */
7926
8291
  get_can_swipe_back(): boolean;
7927
8292
 
7928
8293
  /**
7929
8294
  * Gets whether search is enabled for `self`.
7930
8295
  * @returns whether search is enabled for `self`
8296
+ * @since 1.0
7931
8297
  */
7932
8298
  get_search_enabled(): boolean;
7933
8299
 
@@ -7937,6 +8303,7 @@ export namespace Handy {
7937
8303
  * The transition can be cancelled by the user, in which case visible child will
7938
8304
  * change back to the previously visible child.
7939
8305
  * @param subpage the subpage
8306
+ * @since 1.0
7940
8307
  */
7941
8308
  present_subpage(subpage: Gtk.Widget): void;
7942
8309
 
@@ -7944,12 +8311,14 @@ export namespace Handy {
7944
8311
  * Sets whether swipe gestures allow switching from a subpage to the
7945
8312
  * preferences.
7946
8313
  * @param can_swipe_back the new value
8314
+ * @since 1.0
7947
8315
  */
7948
8316
  set_can_swipe_back(can_swipe_back: boolean): void;
7949
8317
 
7950
8318
  /**
7951
8319
  * Sets whether search is enabled for `self`.
7952
8320
  * @param search_enabled `TRUE` to enable search, `FALSE` to disable it
8321
+ * @since 1.0
7953
8322
  */
7954
8323
  set_search_enabled(search_enabled: boolean): void;
7955
8324
  }
@@ -8113,18 +8482,21 @@ export namespace Handy {
8113
8482
  * The entry should be a descendant of the search bar. This is only required if
8114
8483
  * the entry isn’t the direct child of the search bar (as in our main example).
8115
8484
  * @param entry an entry
8485
+ * @since 1.0
8116
8486
  */
8117
8487
  connect_entry(entry: Gtk.Entry): void;
8118
8488
 
8119
8489
  /**
8120
8490
  * Gets whether the search mode is on.
8121
8491
  * @returns whether search mode is toggled on
8492
+ * @since 1.0
8122
8493
  */
8123
8494
  get_search_mode(): boolean;
8124
8495
 
8125
8496
  /**
8126
8497
  * Gets whether the close button is shown.
8127
8498
  * @returns whether the close button is shown
8499
+ * @since 1.0
8128
8500
  */
8129
8501
  get_show_close_button(): boolean;
8130
8502
 
@@ -8170,12 +8542,14 @@ export namespace Handy {
8170
8542
  * ```
8171
8543
  * @param event a {@link Gdk.Event} containing key press events
8172
8544
  * @returns `GDK_EVENT_STOP` if the key press event resulted in text being entered in the search entry (and revealing the search bar if necessary), `GDK_EVENT_PROPAGATE` otherwise.
8545
+ * @since 1.0
8173
8546
  */
8174
8547
  handle_event(event: Gdk.Event): boolean;
8175
8548
 
8176
8549
  /**
8177
8550
  * Switches the search mode on or off.
8178
8551
  * @param search_mode the new state of the search mode
8552
+ * @since 1.0
8179
8553
  */
8180
8554
  set_search_mode(search_mode: boolean): void;
8181
8555
 
@@ -8186,6 +8560,7 @@ export namespace Handy {
8186
8560
  * close button in their search bar, as it duplicates the role of the toggle
8187
8561
  * button.
8188
8562
  * @param visible whether the close button will be shown or not
8563
+ * @since 1.0
8189
8564
  */
8190
8565
  set_show_close_button(visible: boolean): void;
8191
8566
  }
@@ -8466,54 +8841,63 @@ export namespace Handy {
8466
8841
  * See {@link Squeezer.set_child_enabled}.
8467
8842
  * @param child a child of `self`
8468
8843
  * @returns whether `child` is enabled
8844
+ * @since 1.0
8469
8845
  */
8470
8846
  get_child_enabled(child: Gtk.Widget): boolean;
8471
8847
 
8472
8848
  /**
8473
8849
  * Gets whether `self` is homogeneous.
8474
8850
  * @returns whether `self` is homogeneous
8851
+ * @since 1.0
8475
8852
  */
8476
8853
  get_homogeneous(): boolean;
8477
8854
 
8478
8855
  /**
8479
8856
  * Gets whether `self` should interpolate its size on visible child change.
8480
8857
  * @returns whether `self` interpolates its size on visible child change
8858
+ * @since 1.0
8481
8859
  */
8482
8860
  get_interpolate_size(): boolean;
8483
8861
 
8484
8862
  /**
8485
8863
  * Gets the amount of time that transitions between children will take.
8486
8864
  * @returns the transition duration, in milliseconds
8865
+ * @since 1.0
8487
8866
  */
8488
8867
  get_transition_duration(): number;
8489
8868
 
8490
8869
  /**
8491
8870
  * Gets whether a transition is currently running for `self`.
8492
8871
  * @returns whether a transition is currently running
8872
+ * @since 1.0
8493
8873
  */
8494
8874
  get_transition_running(): boolean;
8495
8875
 
8496
8876
  /**
8497
8877
  * Gets the animation type that will be used for transitions between children.
8498
8878
  * @returns the current transition type of `self`
8879
+ * @since 1.0
8499
8880
  */
8500
8881
  get_transition_type(): SqueezerTransitionType;
8501
8882
 
8502
8883
  /**
8503
8884
  * Gets the currently visible child of `self`.
8504
8885
  * @returns the visible child
8886
+ * @since 1.0
8505
8887
  */
8506
8888
  get_visible_child(): Gtk.Widget | null;
8507
8889
 
8508
8890
  /**
8509
8891
  * Gets the horizontal alignment.
8510
8892
  * @returns the xalign property
8893
+ * @since 1.0
8511
8894
  */
8512
8895
  get_xalign(): number;
8513
8896
 
8514
8897
  /**
8515
8898
  * Gets the vertical alignment.
8516
8899
  * @returns the yalign property
8900
+ * @since 1.0
8517
8901
  */
8518
8902
  get_yalign(): number;
8519
8903
 
@@ -8528,42 +8912,49 @@ export namespace Handy {
8528
8912
  * window width, or any other constraint you find suitable.
8529
8913
  * @param child a child of `self`
8530
8914
  * @param enabled whether to enable the child
8915
+ * @since 1.0
8531
8916
  */
8532
8917
  set_child_enabled(child: Gtk.Widget, enabled: boolean): void;
8533
8918
 
8534
8919
  /**
8535
8920
  * Sets whether all children have the same size for the opposite orientation.
8536
8921
  * @param homogeneous `TRUE` to make `self` homogeneous
8922
+ * @since 1.0
8537
8923
  */
8538
8924
  set_homogeneous(homogeneous: boolean): void;
8539
8925
 
8540
8926
  /**
8541
8927
  * Sets whether `self` should interpolate its size on visible child change.
8542
8928
  * @param interpolate_size `TRUE` to interpolate the size
8929
+ * @since 1.0
8543
8930
  */
8544
8931
  set_interpolate_size(interpolate_size: boolean): void;
8545
8932
 
8546
8933
  /**
8547
8934
  * Sets the duration that transitions between children in `self` will take.
8548
8935
  * @param duration the new duration, in milliseconds
8936
+ * @since 1.0
8549
8937
  */
8550
8938
  set_transition_duration(duration: number): void;
8551
8939
 
8552
8940
  /**
8553
8941
  * Sets the animation type that will be used for transitions between children.
8554
8942
  * @param transition the new transition type
8943
+ * @since 1.0
8555
8944
  */
8556
8945
  set_transition_type(transition: SqueezerTransitionType): void;
8557
8946
 
8558
8947
  /**
8559
8948
  * Sets the horizontal alignment.
8560
8949
  * @param xalign the new xalign value, between 0 and 1
8950
+ * @since 1.0
8561
8951
  */
8562
8952
  set_xalign(xalign: number): void;
8563
8953
 
8564
8954
  /**
8565
8955
  * Sets the vertical alignment.
8566
8956
  * @param yalign the new yalign value, between 0 and 1
8957
+ * @since 1.0
8567
8958
  */
8568
8959
  set_yalign(yalign: number): void;
8569
8960
 
@@ -8579,12 +8970,14 @@ export namespace Handy {
8579
8970
  /**
8580
8971
  * Retrieves the orientation of the `orientable`.
8581
8972
  * @returns the orientation of the `orientable`.
8973
+ * @since 2.16
8582
8974
  */
8583
8975
  get_orientation(): Gtk.Orientation;
8584
8976
 
8585
8977
  /**
8586
8978
  * Sets the orientation of the `orientable`.
8587
8979
  * @param orientation the orientable’s new orientation.
8980
+ * @since 2.16
8588
8981
  */
8589
8982
  set_orientation(orientation: Gtk.Orientation): void;
8590
8983
  }
@@ -8728,36 +9121,42 @@ export namespace Handy {
8728
9121
  /**
8729
9122
  * Gets the description for `self`.
8730
9123
  * @returns the description for `self`
9124
+ * @since 1.2
8731
9125
  */
8732
9126
  get_description(): string | null;
8733
9127
 
8734
9128
  /**
8735
9129
  * Gets the icon name for `self`.
8736
9130
  * @returns the icon name for `self`
9131
+ * @since 1.2
8737
9132
  */
8738
9133
  get_icon_name(): string | null;
8739
9134
 
8740
9135
  /**
8741
9136
  * Gets the title for `self`.
8742
9137
  * @returns the title for `self`
9138
+ * @since 1.2
8743
9139
  */
8744
9140
  get_title(): string | null;
8745
9141
 
8746
9142
  /**
8747
9143
  * Sets the description for `self`.
8748
9144
  * @param description the description
9145
+ * @since 1.2
8749
9146
  */
8750
9147
  set_description(description: string | null): void;
8751
9148
 
8752
9149
  /**
8753
9150
  * Sets the icon name for `self`.
8754
9151
  * @param icon_name the icon name
9152
+ * @since 1.2
8755
9153
  */
8756
9154
  set_icon_name(icon_name: string | null): void;
8757
9155
 
8758
9156
  /**
8759
9157
  * Sets the title for `self`.
8760
9158
  * @param title the title
9159
+ * @since 1.2
8761
9160
  */
8762
9161
  set_title(title: string | null): void;
8763
9162
  }
@@ -8990,6 +9389,7 @@ export namespace Handy {
8990
9389
  * that display has an override.
8991
9390
  *
8992
9391
  * See {@link StyleManager.get_for_display}.
9392
+ * @since 1.6
8993
9393
  */
8994
9394
  static get_default(): StyleManager;
8995
9395
 
@@ -9001,6 +9401,7 @@ export namespace Handy {
9001
9401
  *
9002
9402
  * Most applications should use {@link StyleManager.get_default} instead.
9003
9403
  * @param display a display
9404
+ * @since 1.6
9004
9405
  */
9005
9406
  static get_for_display(display: Gdk.Display): StyleManager;
9006
9407
 
@@ -9008,12 +9409,14 @@ export namespace Handy {
9008
9409
  /**
9009
9410
  * Gets the requested application color scheme.
9010
9411
  * @returns the color scheme
9412
+ * @since 1.6
9011
9413
  */
9012
9414
  get_color_scheme(): ColorScheme;
9013
9415
 
9014
9416
  /**
9015
9417
  * Gets whether the application is using dark appearance.
9016
9418
  * @returns whether the application is using dark appearance
9419
+ * @since 1.6
9017
9420
  */
9018
9421
  get_dark(): boolean;
9019
9422
 
@@ -9023,18 +9426,21 @@ export namespace Handy {
9023
9426
  * The display will be `NULL` for the style manager returned by
9024
9427
  * {@link StyleManager.get_default}.
9025
9428
  * @returns (nullable): the display
9429
+ * @since 1.6
9026
9430
  */
9027
9431
  get_display(): Gdk.Display;
9028
9432
 
9029
9433
  /**
9030
9434
  * Gets whether the application is using high contrast appearance.
9031
9435
  * @returns whether the application is using high contrast appearance
9436
+ * @since 1.6
9032
9437
  */
9033
9438
  get_high_contrast(): boolean;
9034
9439
 
9035
9440
  /**
9036
9441
  * Gets whether the system supports color schemes.
9037
9442
  * @returns whether the system supports color schemes
9443
+ * @since 1.6
9038
9444
  */
9039
9445
  get_system_supports_color_schemes(): boolean;
9040
9446
 
@@ -9046,6 +9452,7 @@ export namespace Handy {
9046
9452
  * {@link StyleManager.dark} property can be used to query the current
9047
9453
  * effective appearance.
9048
9454
  * @param color_scheme the color scheme
9455
+ * @since 1.6
9049
9456
  */
9050
9457
  set_color_scheme(color_scheme: ColorScheme): void;
9051
9458
  }
@@ -9131,18 +9538,24 @@ export namespace Handy {
9131
9538
  * When the widget is destroyed or no longer referenced elsewhere, it will be
9132
9539
  * removed from the swipe group.
9133
9540
  * @param swipeable the {@link Swipeable} to add
9541
+ * @since 1.0
9542
+ * @deprecated since 1.4
9134
9543
  */
9135
9544
  add_swipeable(swipeable: Swipeable): void;
9136
9545
 
9137
9546
  /**
9138
9547
  * Gets the list of swipeables associated with `self`.
9139
9548
  * @returns a list of swipeables
9549
+ * @since 1.0
9550
+ * @deprecated since 1.4
9140
9551
  */
9141
9552
  get_swipeables(): Swipeable[];
9142
9553
 
9143
9554
  /**
9144
9555
  * Removes a widget from a {@link SwipeGroup}.
9145
9556
  * @param swipeable the {@link Swipeable} to remove
9557
+ * @since 1.0
9558
+ * @deprecated since 1.4
9146
9559
  */
9147
9560
  remove_swipeable(swipeable: Swipeable): void;
9148
9561
 
@@ -9152,6 +9565,7 @@ export namespace Handy {
9152
9565
  * @param builder a {@link Gtk.Builder}
9153
9566
  * @param child child to add
9154
9567
  * @param type kind of child or `null`
9568
+ * @since 2.12
9155
9569
  */
9156
9570
  add_child(builder: Gtk.Builder, child: GObject.Object, type: string | null): void;
9157
9571
 
@@ -9163,6 +9577,7 @@ export namespace Handy {
9163
9577
  * @param builder {@link Gtk.Builder} used to construct this object
9164
9578
  * @param name name of child to construct
9165
9579
  * @returns the constructed child
9580
+ * @since 2.12
9166
9581
  */
9167
9582
  construct_child<T = GObject.Object>(builder: Gtk.Builder, name: string): T;
9168
9583
 
@@ -9173,6 +9588,7 @@ export namespace Handy {
9173
9588
  * @param child child object or `null` for non-child tags
9174
9589
  * @param tagname the name of the tag
9175
9590
  * @param data user data created in custom_tag_start
9591
+ * @since 2.12
9176
9592
  */
9177
9593
  custom_finished(builder: Gtk.Builder, child: GObject.Object | null, tagname: string, data: null): void;
9178
9594
 
@@ -9183,6 +9599,7 @@ export namespace Handy {
9183
9599
  * @param child child object or `null` for non-child tags
9184
9600
  * @param tagname name of tag
9185
9601
  * @param data user data that will be passed in to parser functions
9602
+ * @since 2.12
9186
9603
  */
9187
9604
  custom_tag_end(builder: Gtk.Builder, child: GObject.Object | null, tagname: string, data: null): void;
9188
9605
 
@@ -9192,6 +9609,7 @@ export namespace Handy {
9192
9609
  * @param child child object or `null` for non-child tags
9193
9610
  * @param tagname name of tag
9194
9611
  * @returns `true` if a object has a custom implementation, `false` if it doesn't.
9612
+ * @since 2.12
9195
9613
  */
9196
9614
  custom_tag_start(builder: Gtk.Builder, child: GObject.Object | null, tagname: string): [boolean, GLib.MarkupParser, null];
9197
9615
 
@@ -9200,6 +9618,7 @@ export namespace Handy {
9200
9618
  * @param builder a {@link Gtk.Builder}
9201
9619
  * @param childname name of child
9202
9620
  * @returns the internal child of the buildable object
9621
+ * @since 2.12
9203
9622
  */
9204
9623
  get_internal_child<T = GObject.Object>(builder: Gtk.Builder, childname: string): T;
9205
9624
 
@@ -9210,6 +9629,7 @@ export namespace Handy {
9210
9629
  * [GtkBuilder UI definition][BUILDER-UI]
9211
9630
  * used to construct the `buildable`.
9212
9631
  * @returns the name set with `gtk_buildable_set_name()`
9632
+ * @since 2.12
9213
9633
  */
9214
9634
  get_name(): string;
9215
9635
 
@@ -9220,6 +9640,7 @@ export namespace Handy {
9220
9640
  * `gtk_builder_add_from_file()` or `gtk_builder_add_from_string()`
9221
9641
  * is called on a builder.
9222
9642
  * @param builder a {@link Gtk.Builder}
9643
+ * @since 2.12
9223
9644
  */
9224
9645
  parser_finished(builder: Gtk.Builder): void;
9225
9646
 
@@ -9228,12 +9649,14 @@ export namespace Handy {
9228
9649
  * @param builder a {@link Gtk.Builder}
9229
9650
  * @param name name of property
9230
9651
  * @param value value of property
9652
+ * @since 2.12
9231
9653
  */
9232
9654
  set_buildable_property(builder: Gtk.Builder, name: string, value: GObject.Value | any): void;
9233
9655
 
9234
9656
  /**
9235
9657
  * Sets the name of the `buildable` object.
9236
9658
  * @param name name to set
9659
+ * @since 2.12
9237
9660
  */
9238
9661
  set_name(name: string): void;
9239
9662
 
@@ -9243,6 +9666,7 @@ export namespace Handy {
9243
9666
  * @param builder a {@link Gtk.Builder}
9244
9667
  * @param child child to add
9245
9668
  * @param type kind of child or `null`
9669
+ * @since 2.12
9246
9670
  * @virtual
9247
9671
  */
9248
9672
  vfunc_add_child(builder: Gtk.Builder, child: GObject.Object, type: string | null): void;
@@ -9254,6 +9678,7 @@ export namespace Handy {
9254
9678
  * specified in the UI definition.
9255
9679
  * @param builder {@link Gtk.Builder} used to construct this object
9256
9680
  * @param name name of child to construct
9681
+ * @since 2.12
9257
9682
  * @virtual
9258
9683
  */
9259
9684
  vfunc_construct_child<T = GObject.Object>(builder: Gtk.Builder, name: string): T;
@@ -9265,6 +9690,7 @@ export namespace Handy {
9265
9690
  * @param child child object or `null` for non-child tags
9266
9691
  * @param tagname the name of the tag
9267
9692
  * @param data user data created in custom_tag_start
9693
+ * @since 2.12
9268
9694
  * @virtual
9269
9695
  */
9270
9696
  vfunc_custom_finished(builder: Gtk.Builder, child: GObject.Object | null, tagname: string, data: null): void;
@@ -9276,6 +9702,7 @@ export namespace Handy {
9276
9702
  * @param child child object or `null` for non-child tags
9277
9703
  * @param tagname name of tag
9278
9704
  * @param data user data that will be passed in to parser functions
9705
+ * @since 2.12
9279
9706
  * @virtual
9280
9707
  */
9281
9708
  vfunc_custom_tag_end(builder: Gtk.Builder, child: GObject.Object | null, tagname: string, data: null): void;
@@ -9285,6 +9712,7 @@ export namespace Handy {
9285
9712
  * @param builder a {@link Gtk.Builder} used to construct this object
9286
9713
  * @param child child object or `null` for non-child tags
9287
9714
  * @param tagname name of tag
9715
+ * @since 2.12
9288
9716
  * @virtual
9289
9717
  */
9290
9718
  vfunc_custom_tag_start(builder: Gtk.Builder, child: GObject.Object | null, tagname: string): [boolean, GLib.MarkupParser, never];
@@ -9293,6 +9721,7 @@ export namespace Handy {
9293
9721
  * Get the internal child called `childname` of the `buildable` object.
9294
9722
  * @param builder a {@link Gtk.Builder}
9295
9723
  * @param childname name of child
9724
+ * @since 2.12
9296
9725
  * @virtual
9297
9726
  */
9298
9727
  vfunc_get_internal_child<T = GObject.Object>(builder: Gtk.Builder, childname: string): T;
@@ -9303,6 +9732,7 @@ export namespace Handy {
9303
9732
  * {@link Gtk.Builder} sets the name based on the
9304
9733
  * [GtkBuilder UI definition][BUILDER-UI]
9305
9734
  * used to construct the `buildable`.
9735
+ * @since 2.12
9306
9736
  * @virtual
9307
9737
  */
9308
9738
  vfunc_get_name(): string;
@@ -9314,6 +9744,7 @@ export namespace Handy {
9314
9744
  * `gtk_builder_add_from_file()` or `gtk_builder_add_from_string()`
9315
9745
  * is called on a builder.
9316
9746
  * @param builder a {@link Gtk.Builder}
9747
+ * @since 2.12
9317
9748
  * @virtual
9318
9749
  */
9319
9750
  vfunc_parser_finished(builder: Gtk.Builder): void;
@@ -9323,6 +9754,7 @@ export namespace Handy {
9323
9754
  * @param builder a {@link Gtk.Builder}
9324
9755
  * @param name name of property
9325
9756
  * @param value value of property
9757
+ * @since 2.12
9326
9758
  * @virtual
9327
9759
  */
9328
9760
  vfunc_set_buildable_property(builder: Gtk.Builder, name: string, value: unknown): void;
@@ -9330,6 +9762,7 @@ export namespace Handy {
9330
9762
  /**
9331
9763
  * Sets the name of the `buildable` object.
9332
9764
  * @param name name to set
9765
+ * @since 2.12
9333
9766
  * @virtual
9334
9767
  */
9335
9768
  vfunc_set_name(name: string): void;
@@ -9348,21 +9781,21 @@ export namespace Handy {
9348
9781
  * @since 1.0
9349
9782
  * @run-first
9350
9783
  */
9351
- "begin-swipe": (arg0: NavigationDirection, arg1: boolean) => void;
9784
+ "begin-swipe": (direction: NavigationDirection, direct: boolean) => void;
9352
9785
  /**
9353
9786
  * This signal is emitted as soon as the gesture has stopped.
9354
9787
  * @signal
9355
9788
  * @since 1.0
9356
9789
  * @run-first
9357
9790
  */
9358
- "end-swipe": (arg0: number, arg1: number) => void;
9791
+ "end-swipe": (duration: number, to: number) => void;
9359
9792
  /**
9360
9793
  * This signal is emitted every time the progress value changes.
9361
9794
  * @signal
9362
9795
  * @since 1.0
9363
9796
  * @run-first
9364
9797
  */
9365
- "update-swipe": (arg0: number) => void;
9798
+ "update-swipe": (progress: number) => void;
9366
9799
  "notify::allow-long-swipes": (pspec: GObject.ParamSpec) => void;
9367
9800
  "notify::allow-mouse-drag": (pspec: GObject.ParamSpec) => void;
9368
9801
  "notify::enabled": (pspec: GObject.ParamSpec) => void;
@@ -9508,30 +9941,35 @@ export namespace Handy {
9508
9941
  * If the value is `FALSE`, each swipe can only move to the adjacent snap
9509
9942
  * points.
9510
9943
  * @returns whether long swipes are allowed
9944
+ * @since 1.2
9511
9945
  */
9512
9946
  get_allow_long_swipes(): boolean;
9513
9947
 
9514
9948
  /**
9515
9949
  * Get whether `self` can be dragged with mouse pointer.
9516
9950
  * @returns `TRUE` is mouse dragging is allowed
9951
+ * @since 1.0
9517
9952
  */
9518
9953
  get_allow_mouse_drag(): boolean;
9519
9954
 
9520
9955
  /**
9521
9956
  * Get whether `self` is enabled.
9522
9957
  * @returns `TRUE` if `self` is enabled
9958
+ * @since 1.0
9523
9959
  */
9524
9960
  get_enabled(): boolean;
9525
9961
 
9526
9962
  /**
9527
9963
  * Get whether `self` is reversing the swipe direction.
9528
9964
  * @returns `TRUE` is the direction is reversed
9965
+ * @since 1.0
9529
9966
  */
9530
9967
  get_reversed(): boolean;
9531
9968
 
9532
9969
  /**
9533
9970
  * Get `self`'s swipeable widget.
9534
9971
  * @returns the swipeable widget
9972
+ * @since 1.0
9535
9973
  */
9536
9974
  get_swipeable(): Swipeable;
9537
9975
 
@@ -9541,6 +9979,7 @@ export namespace Handy {
9541
9979
  * If the value is `FALSE`, each swipe can only move to the adjacent snap
9542
9980
  * points.
9543
9981
  * @param allow_long_swipes whether to allow long swipes
9982
+ * @since 1.2
9544
9983
  */
9545
9984
  set_allow_long_swipes(allow_long_swipes: boolean): void;
9546
9985
 
@@ -9549,12 +9988,14 @@ export namespace Handy {
9549
9988
  *
9550
9989
  * This should usually be `FALSE`.
9551
9990
  * @param allow_mouse_drag whether to allow mouse dragging
9991
+ * @since 1.0
9552
9992
  */
9553
9993
  set_allow_mouse_drag(allow_mouse_drag: boolean): void;
9554
9994
 
9555
9995
  /**
9556
9996
  * Set whether `self` is enabled.
9557
9997
  * @param enabled whether to enable to swipe tracker
9998
+ * @since 1.0
9558
9999
  */
9559
10000
  set_enabled(enabled: boolean): void;
9560
10001
 
@@ -9563,6 +10004,7 @@ export namespace Handy {
9563
10004
  *
9564
10005
  * If `self` is horizontal, can be used for supporting RTL text direction.
9565
10006
  * @param reversed whether to reverse the swipe direction
10007
+ * @since 1.0
9566
10008
  */
9567
10009
  set_reversed(reversed: boolean): void;
9568
10010
 
@@ -9572,6 +10014,7 @@ export namespace Handy {
9572
10014
  * This can be used to adjust the current position if snap points move during
9573
10015
  * the gesture.
9574
10016
  * @param delta the position delta
10017
+ * @since 1.0
9575
10018
  */
9576
10019
  shift_position(delta: number): void;
9577
10020
 
@@ -9587,12 +10030,14 @@ export namespace Handy {
9587
10030
  /**
9588
10031
  * Retrieves the orientation of the `orientable`.
9589
10032
  * @returns the orientation of the `orientable`.
10033
+ * @since 2.16
9590
10034
  */
9591
10035
  get_orientation(): Gtk.Orientation;
9592
10036
 
9593
10037
  /**
9594
10038
  * Sets the orientation of the `orientable`.
9595
10039
  * @param orientation the orientable’s new orientation.
10040
+ * @since 2.16
9596
10041
  */
9597
10042
  set_orientation(orientation: Gtk.Orientation): void;
9598
10043
  }
@@ -9610,7 +10055,7 @@ export namespace Handy {
9610
10055
  * @since 1.2
9611
10056
  * @run-last
9612
10057
  */
9613
- "extra-drag-data-received": (arg0: TabPage, arg1: Gdk.DragContext, arg2: Gtk.SelectionData, arg3: number, arg4: number) => void;
10058
+ "extra-drag-data-received": (page: TabPage, context: Gdk.DragContext, data: Gtk.SelectionData, info: number, time: number) => void;
9614
10059
  "notify::autohide": (pspec: GObject.ParamSpec) => void;
9615
10060
  "notify::end-action-widget": (pspec: GObject.ParamSpec) => void;
9616
10061
  "notify::expand-tabs": (pspec: GObject.ParamSpec) => void;
@@ -9896,54 +10341,63 @@ export namespace Handy {
9896
10341
  /**
9897
10342
  * Gets whether the tabs automatically hide.
9898
10343
  * @returns whether the tabs automatically hide
10344
+ * @since 1.2
9899
10345
  */
9900
10346
  get_autohide(): boolean;
9901
10347
 
9902
10348
  /**
9903
10349
  * Gets the widget shown after the tabs.
9904
10350
  * @returns the widget shown after the tabs
10351
+ * @since 1.2
9905
10352
  */
9906
10353
  get_end_action_widget(): Gtk.Widget | null;
9907
10354
 
9908
10355
  /**
9909
10356
  * Gets whether tabs should expand.
9910
10357
  * @returns whether tabs should expand
10358
+ * @since 1.2
9911
10359
  */
9912
10360
  get_expand_tabs(): boolean;
9913
10361
 
9914
10362
  /**
9915
10363
  * Gets extra drag destination targets.
9916
10364
  * @returns extra drag targets
10365
+ * @since 1.2
9917
10366
  */
9918
10367
  get_extra_drag_dest_targets(): Gtk.TargetList | null;
9919
10368
 
9920
10369
  /**
9921
10370
  * Gets whether tabs use inverted layout.
9922
10371
  * @returns whether tabs use inverted layout
10372
+ * @since 1.2
9923
10373
  */
9924
10374
  get_inverted(): boolean;
9925
10375
 
9926
10376
  /**
9927
10377
  * Gets whether `self` is overflowing.
9928
10378
  * @returns whether `self` is overflowing
10379
+ * @since 1.2
9929
10380
  */
9930
10381
  get_is_overflowing(): boolean;
9931
10382
 
9932
10383
  /**
9933
10384
  * Gets the widget shown before the tabs.
9934
10385
  * @returns the widget shown before the tabs
10386
+ * @since 1.2
9935
10387
  */
9936
10388
  get_start_action_widget(): Gtk.Widget | null;
9937
10389
 
9938
10390
  /**
9939
10391
  * Gets the value of the {@link TabBar.tabs_revealed} property.
9940
10392
  * @returns whether the tabs are current revealed
10393
+ * @since 1.2
9941
10394
  */
9942
10395
  get_tabs_revealed(): boolean;
9943
10396
 
9944
10397
  /**
9945
10398
  * Gets the {@link TabView} `self` controls.
9946
10399
  * @returns the {@link TabView} `self` controls
10400
+ * @since 1.2
9947
10401
  */
9948
10402
  get_view(): TabView | null;
9949
10403
 
@@ -9958,12 +10412,14 @@ export namespace Handy {
9958
10412
  *
9959
10413
  * See {@link TabBar.tabs_revealed}.
9960
10414
  * @param autohide whether the tabs automatically hide
10415
+ * @since 1.2
9961
10416
  */
9962
10417
  set_autohide(autohide: boolean): void;
9963
10418
 
9964
10419
  /**
9965
10420
  * Sets the widget to show after the tabs.
9966
10421
  * @param widget the widget to show after the tabs
10422
+ * @since 1.2
9967
10423
  */
9968
10424
  set_end_action_widget(widget: Gtk.Widget | null): void;
9969
10425
 
@@ -9976,6 +10432,7 @@ export namespace Handy {
9976
10432
  *
9977
10433
  * Expand is enabled by default.
9978
10434
  * @param expand_tabs whether to expand tabs
10435
+ * @since 1.2
9979
10436
  */
9980
10437
  set_expand_tabs(expand_tabs: boolean): void;
9981
10438
 
@@ -9991,6 +10448,7 @@ export namespace Handy {
9991
10448
  * After content is dropped, the `Handy.TabBar::extra-drag-data-received`
9992
10449
  * signal can be used to retrieve and process the drag data.
9993
10450
  * @param extra_drag_dest_targets extra drag targets
10451
+ * @since 1.2
9994
10452
  */
9995
10453
  set_extra_drag_dest_targets(extra_drag_dest_targets: Gtk.TargetList | null): void;
9996
10454
 
@@ -10000,18 +10458,21 @@ export namespace Handy {
10000
10458
  * If `inverted` is `TRUE`, non-pinned tabs will have the close button at the
10001
10459
  * beginning and the indicator at the end rather than the opposite.
10002
10460
  * @param inverted whether tabs use inverted layout
10461
+ * @since 1.2
10003
10462
  */
10004
10463
  set_inverted(inverted: boolean): void;
10005
10464
 
10006
10465
  /**
10007
10466
  * Sets the widget to show before the tabs.
10008
10467
  * @param widget the widget to show before the tabs
10468
+ * @since 1.2
10009
10469
  */
10010
10470
  set_start_action_widget(widget: Gtk.Widget | null): void;
10011
10471
 
10012
10472
  /**
10013
10473
  * Sets the {@link TabView} `self` controls.
10014
10474
  * @param view a tab view
10475
+ * @since 1.2
10015
10476
  */
10016
10477
  set_view(view: TabView | null): void;
10017
10478
  }
@@ -10261,108 +10722,126 @@ export namespace Handy {
10261
10722
  /**
10262
10723
  * Gets the child of `self`.
10263
10724
  * @returns the child of `self`
10725
+ * @since 1.2
10264
10726
  */
10265
10727
  get_child(): Gtk.Widget;
10266
10728
 
10267
10729
  /**
10268
10730
  * Gets the icon of `self`.
10269
10731
  * @returns the icon of `self`
10732
+ * @since 1.2
10270
10733
  */
10271
10734
  get_icon(): Gio.Icon | null;
10272
10735
 
10273
10736
  /**
10274
10737
  * Gets whether the indicator of `self` is activatable.
10275
10738
  * @returns whether the indicator is activatable
10739
+ * @since 1.2
10276
10740
  */
10277
10741
  get_indicator_activatable(): boolean;
10278
10742
 
10279
10743
  /**
10280
10744
  * Gets the indicator icon of `self`.
10281
10745
  * @returns the indicator icon of `self`
10746
+ * @since 1.2
10282
10747
  */
10283
10748
  get_indicator_icon(): Gio.Icon | null;
10284
10749
 
10285
10750
  /**
10286
10751
  * Gets whether `self` is loading.
10287
10752
  * @returns whether `self` is loading
10753
+ * @since 1.2
10288
10754
  */
10289
10755
  get_loading(): boolean;
10290
10756
 
10291
10757
  /**
10292
10758
  * Gets whether `self` needs attention.
10293
10759
  * @returns whether `self` needs attention
10760
+ * @since 1.2
10294
10761
  */
10295
10762
  get_needs_attention(): boolean;
10296
10763
 
10297
10764
  /**
10298
10765
  * Gets the parent page of `self`.
10299
10766
  * @returns the parent page of `self`
10767
+ * @since 1.2
10300
10768
  */
10301
10769
  get_parent(): TabPage | null;
10302
10770
 
10303
10771
  /**
10304
10772
  * Gets whether `self` is pinned.
10305
10773
  * @returns whether `self` is pinned
10774
+ * @since 1.2
10306
10775
  */
10307
10776
  get_pinned(): boolean;
10308
10777
 
10309
10778
  /**
10310
10779
  * Gets whether `self` is selected.
10311
10780
  * @returns whether `self` is selected
10781
+ * @since 1.2
10312
10782
  */
10313
10783
  get_selected(): boolean;
10314
10784
 
10315
10785
  /**
10316
10786
  * Gets the title of `self`.
10317
10787
  * @returns the title of `self`
10788
+ * @since 1.2
10318
10789
  */
10319
10790
  get_title(): string | null;
10320
10791
 
10321
10792
  /**
10322
10793
  * Gets the tooltip of `self`.
10323
10794
  * @returns the tooltip of `self`
10795
+ * @since 1.2
10324
10796
  */
10325
10797
  get_tooltip(): string | null;
10326
10798
 
10327
10799
  /**
10328
10800
  * Sets the icon of `self`.
10329
10801
  * @param icon the icon of `self`
10802
+ * @since 1.2
10330
10803
  */
10331
10804
  set_icon(icon: Gio.Icon | null): void;
10332
10805
 
10333
10806
  /**
10334
10807
  * Sets whether the indicator of `self` is activatable.
10335
10808
  * @param activatable whether the indicator is activatable
10809
+ * @since 1.2
10336
10810
  */
10337
10811
  set_indicator_activatable(activatable: boolean): void;
10338
10812
 
10339
10813
  /**
10340
10814
  * Sets the indicator icon of `self`.
10341
10815
  * @param indicator_icon the indicator icon of `self`
10816
+ * @since 1.2
10342
10817
  */
10343
10818
  set_indicator_icon(indicator_icon: Gio.Icon | null): void;
10344
10819
 
10345
10820
  /**
10346
10821
  * Sets whether `self` is loading.
10347
10822
  * @param loading whether `self` is loading
10823
+ * @since 1.2
10348
10824
  */
10349
10825
  set_loading(loading: boolean): void;
10350
10826
 
10351
10827
  /**
10352
10828
  * Sets whether `self` needs attention.
10353
10829
  * @param needs_attention whether `self` needs attention
10830
+ * @since 1.2
10354
10831
  */
10355
10832
  set_needs_attention(needs_attention: boolean): void;
10356
10833
 
10357
10834
  /**
10358
10835
  * Sets the title of `self`.
10359
10836
  * @param title the title of `self`
10837
+ * @since 1.2
10360
10838
  */
10361
10839
  set_title(title: string | null): void;
10362
10840
 
10363
10841
  /**
10364
10842
  * Sets the tooltip of `self`.
10365
10843
  * @param tooltip the tooltip of `self`
10844
+ * @since 1.2
10366
10845
  */
10367
10846
  set_tooltip(tooltip: string | null): void;
10368
10847
  }
@@ -10402,7 +10881,7 @@ export namespace Handy {
10402
10881
  * @since 1.2
10403
10882
  * @run-last
10404
10883
  */
10405
- "close-page": (arg0: TabPage) => boolean | void;
10884
+ "close-page": (page: TabPage) => boolean | void;
10406
10885
  /**
10407
10886
  * Emitted when a tab should be transferred into a new window.
10408
10887
  *
@@ -10424,7 +10903,7 @@ export namespace Handy {
10424
10903
  * @since 1.2
10425
10904
  * @run-last
10426
10905
  */
10427
- "indicator-activated": (arg0: TabPage) => void;
10906
+ "indicator-activated": (page: TabPage) => void;
10428
10907
  /**
10429
10908
  * Emitted when a page has been created or transferred to the view.
10430
10909
  *
@@ -10434,7 +10913,7 @@ export namespace Handy {
10434
10913
  * @since 1.2
10435
10914
  * @run-last
10436
10915
  */
10437
- "page-attached": (arg0: TabPage, arg1: number) => void;
10916
+ "page-attached": (page: TabPage, position: number) => void;
10438
10917
  /**
10439
10918
  * Emitted when a page has been removed or transferred to another view.
10440
10919
  *
@@ -10449,14 +10928,14 @@ export namespace Handy {
10449
10928
  * @since 1.2
10450
10929
  * @run-last
10451
10930
  */
10452
- "page-detached": (arg0: TabPage, arg1: number) => void;
10931
+ "page-detached": (page: TabPage, position: number) => void;
10453
10932
  /**
10454
10933
  * This signal is emitted after `page` has been reordered to `position`.
10455
10934
  * @signal
10456
10935
  * @since 1.2
10457
10936
  * @run-last
10458
10937
  */
10459
- "page-reordered": (arg0: TabPage, arg1: number) => void;
10938
+ "page-reordered": (page: TabPage, position: number) => void;
10460
10939
  /**
10461
10940
  * Emitted when a context menu is opened or closed for `page`.
10462
10941
  *
@@ -10468,7 +10947,7 @@ export namespace Handy {
10468
10947
  * @since 1.2
10469
10948
  * @run-last
10470
10949
  */
10471
- "setup-menu": (arg0: TabPage) => void;
10950
+ "setup-menu": (page: TabPage) => void;
10472
10951
  "notify::default-icon": (pspec: GObject.ParamSpec) => void;
10473
10952
  "notify::is-transferring-page": (pspec: GObject.ParamSpec) => void;
10474
10953
  "notify::menu-model": (pspec: GObject.ParamSpec) => void;
@@ -10810,6 +11289,7 @@ export namespace Handy {
10810
11289
  * @param child a widget to add
10811
11290
  * @param parent a parent page for `child`
10812
11291
  * @returns the page object representing `child`
11292
+ * @since 1.2
10813
11293
  */
10814
11294
  add_page(child: Gtk.Widget, parent: TabPage | null): TabPage;
10815
11295
 
@@ -10817,6 +11297,7 @@ export namespace Handy {
10817
11297
  * Inserts `child` as the last non-pinned page.
10818
11298
  * @param child a widget to add
10819
11299
  * @returns the page object representing `child`
11300
+ * @since 1.2
10820
11301
  */
10821
11302
  append(child: Gtk.Widget): TabPage;
10822
11303
 
@@ -10824,12 +11305,14 @@ export namespace Handy {
10824
11305
  * Inserts `child` as the last pinned page.
10825
11306
  * @param child a widget to add
10826
11307
  * @returns the page object representing `child`
11308
+ * @since 1.2
10827
11309
  */
10828
11310
  append_pinned(child: Gtk.Widget): TabPage;
10829
11311
 
10830
11312
  /**
10831
11313
  * Requests to close all pages other than `page`.
10832
11314
  * @param page a page of `self`
11315
+ * @since 1.2
10833
11316
  */
10834
11317
  close_other_pages(page: TabPage): void;
10835
11318
 
@@ -10857,6 +11340,7 @@ export namespace Handy {
10857
11340
  * (possibly indirect) of the parent. If both the previous page and the parent
10858
11341
  * are pinned, the parent will be selected instead.
10859
11342
  * @param page a page of `self`
11343
+ * @since 1.2
10860
11344
  */
10861
11345
  close_page(page: TabPage): void;
10862
11346
 
@@ -10871,24 +11355,28 @@ export namespace Handy {
10871
11355
  * `Handy.TabView::close-page` is used.
10872
11356
  * @param page a page of `self`
10873
11357
  * @param confirm whether to confirm or deny closing `page`
11358
+ * @since 1.2
10874
11359
  */
10875
11360
  close_page_finish(page: TabPage, confirm: boolean): void;
10876
11361
 
10877
11362
  /**
10878
11363
  * Requests to close all pages after `page`.
10879
11364
  * @param page a page of `self`
11365
+ * @since 1.2
10880
11366
  */
10881
11367
  close_pages_after(page: TabPage): void;
10882
11368
 
10883
11369
  /**
10884
11370
  * Requests to close all pages before `page`.
10885
11371
  * @param page a page of `self`
11372
+ * @since 1.2
10886
11373
  */
10887
11374
  close_pages_before(page: TabPage): void;
10888
11375
 
10889
11376
  /**
10890
11377
  * Gets default icon of `self`.
10891
11378
  * @returns the default icon of `self`
11379
+ * @since 1.2
10892
11380
  */
10893
11381
  get_default_icon(): Gio.Icon;
10894
11382
 
@@ -10897,18 +11385,21 @@ export namespace Handy {
10897
11385
  *
10898
11386
  * Gets the value of {@link TabView.is_transferring_page} property.
10899
11387
  * @returns whether a page is being transferred
11388
+ * @since 1.2
10900
11389
  */
10901
11390
  get_is_transferring_page(): boolean;
10902
11391
 
10903
11392
  /**
10904
11393
  * Gets the tab context menu model for `self`.
10905
11394
  * @returns the tab context menu model for `self`
11395
+ * @since 1.2
10906
11396
  */
10907
11397
  get_menu_model(): Gio.MenuModel | null;
10908
11398
 
10909
11399
  /**
10910
11400
  * Gets the number of pages in `self`.
10911
11401
  * @returns the number of pages in `self`
11402
+ * @since 1.2
10912
11403
  */
10913
11404
  get_n_pages(): number;
10914
11405
 
@@ -10917,6 +11408,7 @@ export namespace Handy {
10917
11408
  *
10918
11409
  * See {@link TabView.set_page_pinned}.
10919
11410
  * @returns the number of pinned pages in `self`
11411
+ * @since 1.2
10920
11412
  */
10921
11413
  get_n_pinned_pages(): number;
10922
11414
 
@@ -10924,6 +11416,7 @@ export namespace Handy {
10924
11416
  * Gets the {@link TabPage} representing the child at `position`.
10925
11417
  * @param position the index of the page in `self`, starting from 0
10926
11418
  * @returns the page object at `position`
11419
+ * @since 1.2
10927
11420
  */
10928
11421
  get_nth_page(position: number): TabPage;
10929
11422
 
@@ -10931,6 +11424,7 @@ export namespace Handy {
10931
11424
  * Gets the {@link TabPage} object representing `child`.
10932
11425
  * @param child a child in `self`
10933
11426
  * @returns the {@link TabPage} representing `child`
11427
+ * @since 1.2
10934
11428
  */
10935
11429
  get_page(child: Gtk.Widget): TabPage;
10936
11430
 
@@ -10938,6 +11432,7 @@ export namespace Handy {
10938
11432
  * Finds the position of `page` in `self`, starting from 0.
10939
11433
  * @param page a page of `self`
10940
11434
  * @returns the position of `page` in `self`
11435
+ * @since 1.2
10941
11436
  */
10942
11437
  get_page_position(page: TabPage): number;
10943
11438
 
@@ -10946,18 +11441,21 @@ export namespace Handy {
10946
11441
  *
10947
11442
  * This model can be used to keep an up to date view of the pages.
10948
11443
  * @returns the model containing pages of `self`
11444
+ * @since 1.2
10949
11445
  */
10950
11446
  get_pages(): Gio.ListModel;
10951
11447
 
10952
11448
  /**
10953
11449
  * Gets the currently selected page in `self`.
10954
11450
  * @returns the selected page in `self`
11451
+ * @since 1.2
10955
11452
  */
10956
11453
  get_selected_page(): TabPage | null;
10957
11454
 
10958
11455
  /**
10959
11456
  * Gets the shortcut widget for `self`.
10960
11457
  * @returns the shortcut widget for `self`
11458
+ * @since 1.2
10961
11459
  */
10962
11460
  get_shortcut_widget(): Gtk.Widget | null;
10963
11461
 
@@ -10969,6 +11467,7 @@ export namespace Handy {
10969
11467
  * @param child a widget to add
10970
11468
  * @param position the position to add `child` at, starting from 0
10971
11469
  * @returns the page object representing `child`
11470
+ * @since 1.2
10972
11471
  */
10973
11472
  insert(child: Gtk.Widget, position: number): TabPage;
10974
11473
 
@@ -10980,6 +11479,7 @@ export namespace Handy {
10980
11479
  * @param child a widget to add
10981
11480
  * @param position the position to add `child` at, starting from 0
10982
11481
  * @returns the page object representing `child`
11482
+ * @since 1.2
10983
11483
  */
10984
11484
  insert_pinned(child: Gtk.Widget, position: number): TabPage;
10985
11485
 
@@ -10987,6 +11487,7 @@ export namespace Handy {
10987
11487
  * Inserts `child` as the first non-pinned page.
10988
11488
  * @param child a widget to add
10989
11489
  * @returns the page object representing `child`
11490
+ * @since 1.2
10990
11491
  */
10991
11492
  prepend(child: Gtk.Widget): TabPage;
10992
11493
 
@@ -10994,6 +11495,7 @@ export namespace Handy {
10994
11495
  * Inserts `child` as the first pinned page.
10995
11496
  * @param child a widget to add
10996
11497
  * @returns the page object representing `child`
11498
+ * @since 1.2
10997
11499
  */
10998
11500
  prepend_pinned(child: Gtk.Widget): TabPage;
10999
11501
 
@@ -11001,6 +11503,7 @@ export namespace Handy {
11001
11503
  * Reorders `page` to before its previous page if possible.
11002
11504
  * @param page a page of `self`
11003
11505
  * @returns whether `page` was moved
11506
+ * @since 1.2
11004
11507
  */
11005
11508
  reorder_backward(page: TabPage): boolean;
11006
11509
 
@@ -11008,6 +11511,7 @@ export namespace Handy {
11008
11511
  * Reorders `page` to the first possible position.
11009
11512
  * @param page a page of `self`
11010
11513
  * @returns whether `page` was moved
11514
+ * @since 1.2
11011
11515
  */
11012
11516
  reorder_first(page: TabPage): boolean;
11013
11517
 
@@ -11015,6 +11519,7 @@ export namespace Handy {
11015
11519
  * Reorders `page` to after its next page if possible.
11016
11520
  * @param page a page of `self`
11017
11521
  * @returns whether `page` was moved
11522
+ * @since 1.2
11018
11523
  */
11019
11524
  reorder_forward(page: TabPage): boolean;
11020
11525
 
@@ -11022,6 +11527,7 @@ export namespace Handy {
11022
11527
  * Reorders `page` to the last possible position.
11023
11528
  * @param page a page of `self`
11024
11529
  * @returns whether `page` was moved
11530
+ * @since 1.2
11025
11531
  */
11026
11532
  reorder_last(page: TabPage): boolean;
11027
11533
 
@@ -11033,6 +11539,7 @@ export namespace Handy {
11033
11539
  * @param page a page of `self`
11034
11540
  * @param position the position to insert the page at, starting at 0
11035
11541
  * @returns whether `page` was moved
11542
+ * @since 1.2
11036
11543
  */
11037
11544
  reorder_page(page: TabPage, position: number): boolean;
11038
11545
 
@@ -11041,6 +11548,7 @@ export namespace Handy {
11041
11548
  *
11042
11549
  * If the last page was already selected, this function does nothing.
11043
11550
  * @returns whether the selected page was changed
11551
+ * @since 1.2
11044
11552
  */
11045
11553
  select_next_page(): boolean;
11046
11554
 
@@ -11049,6 +11557,7 @@ export namespace Handy {
11049
11557
  *
11050
11558
  * If the first page was already selected, this function does nothing.
11051
11559
  * @returns whether the selected page was changed
11560
+ * @since 1.2
11052
11561
  */
11053
11562
  select_previous_page(): boolean;
11054
11563
 
@@ -11064,6 +11573,7 @@ export namespace Handy {
11064
11573
  *
11065
11574
  * By default, `hdy-tab-icon-missing-symbolic` icon is used.
11066
11575
  * @param default_icon the default icon
11576
+ * @since 1.2
11067
11577
  */
11068
11578
  set_default_icon(default_icon: Gio.Icon): void;
11069
11579
 
@@ -11074,6 +11584,7 @@ export namespace Handy {
11074
11584
  * provided menu model. Use `Handy.TabView::setup-menu` signal to set up the
11075
11585
  * menu actions for the particular tab.
11076
11586
  * @param menu_model a menu model
11587
+ * @since 1.2
11077
11588
  */
11078
11589
  set_menu_model(menu_model: Gio.MenuModel | null): void;
11079
11590
 
@@ -11103,18 +11614,21 @@ export namespace Handy {
11103
11614
  * for how to override that behavior.
11104
11615
  * @param page a page of `self`
11105
11616
  * @param pinned whether `page` should be pinned
11617
+ * @since 1.2
11106
11618
  */
11107
11619
  set_page_pinned(page: TabPage, pinned: boolean): void;
11108
11620
 
11109
11621
  /**
11110
11622
  * Sets the currently selected page in `self`.
11111
11623
  * @param selected_page a page in `self`
11624
+ * @since 1.2
11112
11625
  */
11113
11626
  set_selected_page(selected_page: TabPage): void;
11114
11627
 
11115
11628
  /**
11116
11629
  * Sets the shortcut widget for `self`.
11117
11630
  * @param widget a shortcut widget
11631
+ * @since 1.2
11118
11632
  */
11119
11633
  set_shortcut_widget(widget: Gtk.Widget | null): void;
11120
11634
 
@@ -11128,6 +11642,7 @@ export namespace Handy {
11128
11642
  * @param page a page of `self`
11129
11643
  * @param other_view the tab view to transfer the page to
11130
11644
  * @param position the position to insert the page at, starting at 0
11645
+ * @since 1.2
11131
11646
  */
11132
11647
  transfer_page(page: TabPage, other_view: TabView, position: number): void;
11133
11648
  }
@@ -11264,12 +11779,16 @@ export namespace Handy {
11264
11779
  /**
11265
11780
  * Returns whether whether `self` is in selection mode.
11266
11781
  * @returns `TRUE` if the title bar is in selection mode
11782
+ * @since 1.0
11783
+ * @deprecated since 1.4
11267
11784
  */
11268
11785
  get_selection_mode(): boolean;
11269
11786
 
11270
11787
  /**
11271
11788
  * Sets whether `self` is in selection mode.
11272
11789
  * @param selection_mode `TRUE` to enable the selection mode
11790
+ * @since 1.0
11791
+ * @deprecated since 1.4
11273
11792
  */
11274
11793
  set_selection_mode(selection_mode: boolean): void;
11275
11794
  }
@@ -11339,24 +11858,28 @@ export namespace Handy {
11339
11858
  /**
11340
11859
  * Copy data from the contained {@link GObject.Value} into `dest`.
11341
11860
  * @param dest value with correct type to copy into
11861
+ * @since 1.0
11342
11862
  */
11343
11863
  copy_value(dest: GObject.Value | any): void;
11344
11864
 
11345
11865
  /**
11346
11866
  * Gets a copy of the contained string if the value is of type `G_TYPE_STRING`.
11347
11867
  * @returns a copy of the contained string
11868
+ * @since 1.0
11348
11869
  */
11349
11870
  dup_string(): string;
11350
11871
 
11351
11872
  /**
11352
11873
  * Returns the contained string if the value is of type `G_TYPE_STRING`.
11353
11874
  * @returns the contained string
11875
+ * @since 1.0
11354
11876
  */
11355
11877
  get_string(): string;
11356
11878
 
11357
11879
  /**
11358
11880
  * Return the contained value.
11359
11881
  * @returns the contained {@link GObject.Value}
11882
+ * @since 1.0
11360
11883
  */
11361
11884
  get_value(): unknown;
11362
11885
  }
@@ -11525,36 +12048,42 @@ export namespace Handy {
11525
12048
  /**
11526
12049
  * Get the ellipsizing position of the narrow mode label.
11527
12050
  * @returns a {@link Pango.EllipsizeMode}
12051
+ * @since 1.0
11528
12052
  */
11529
12053
  get_narrow_ellipsize(): Pango.EllipsizeMode;
11530
12054
 
11531
12055
  /**
11532
12056
  * Gets the policy of `self`.
11533
12057
  * @returns the policy of `self`
12058
+ * @since 1.0
11534
12059
  */
11535
12060
  get_policy(): ViewSwitcherPolicy;
11536
12061
 
11537
12062
  /**
11538
12063
  * Gets the stack controlled by `self`.
11539
12064
  * @returns the stack
12065
+ * @since 1.0
11540
12066
  */
11541
12067
  get_stack(): Gtk.Stack | null;
11542
12068
 
11543
12069
  /**
11544
12070
  * Sets the mode used to ellipsize the text in narrow mode.
11545
12071
  * @param mode a {@link Pango.EllipsizeMode}
12072
+ * @since 1.0
11546
12073
  */
11547
12074
  set_narrow_ellipsize(mode: Pango.EllipsizeMode): void;
11548
12075
 
11549
12076
  /**
11550
12077
  * Sets the policy of `self`.
11551
12078
  * @param policy the new policy
12079
+ * @since 1.0
11552
12080
  */
11553
12081
  set_policy(policy: ViewSwitcherPolicy): void;
11554
12082
 
11555
12083
  /**
11556
12084
  * Sets the {@link Gtk.Stack} to control.
11557
12085
  * @param stack a stack
12086
+ * @since 1.0
11558
12087
  */
11559
12088
  set_stack(stack: Gtk.Stack | null): void;
11560
12089
  }
@@ -11732,36 +12261,42 @@ export namespace Handy {
11732
12261
  /**
11733
12262
  * Gets the policy of `self`.
11734
12263
  * @returns the policy of `self`
12264
+ * @since 1.0
11735
12265
  */
11736
12266
  get_policy(): ViewSwitcherPolicy;
11737
12267
 
11738
12268
  /**
11739
12269
  * Gets whether `self` should be revealed or hidden.
11740
12270
  * @returns whether `self` is revealed
12271
+ * @since 1.0
11741
12272
  */
11742
12273
  get_reveal(): boolean;
11743
12274
 
11744
12275
  /**
11745
12276
  * Get the {@link Gtk.Stack} being controlled by the {@link ViewSwitcher}.
11746
12277
  * @returns the stack
12278
+ * @since 1.0
11747
12279
  */
11748
12280
  get_stack(): Gtk.Stack | null;
11749
12281
 
11750
12282
  /**
11751
12283
  * Sets the policy of `self`.
11752
12284
  * @param policy the new policy
12285
+ * @since 1.0
11753
12286
  */
11754
12287
  set_policy(policy: ViewSwitcherPolicy): void;
11755
12288
 
11756
12289
  /**
11757
12290
  * Sets whether `self` should be revealed or not.
11758
12291
  * @param reveal `TRUE` to reveal `self`
12292
+ * @since 1.0
11759
12293
  */
11760
12294
  set_reveal(reveal: boolean): void;
11761
12295
 
11762
12296
  /**
11763
12297
  * Sets the {@link Gtk.Stack} to control.
11764
12298
  * @param stack a stack
12299
+ * @since 1.0
11765
12300
  */
11766
12301
  set_stack(stack: Gtk.Stack | null): void;
11767
12302
  }
@@ -12008,66 +12543,77 @@ export namespace Handy {
12008
12543
  /**
12009
12544
  * Gets the policy of `self`.
12010
12545
  * @returns the policy of `self`
12546
+ * @since 1.0
12011
12547
  */
12012
12548
  get_policy(): ViewSwitcherPolicy;
12013
12549
 
12014
12550
  /**
12015
12551
  * Gets the stack controlled by `self`.
12016
12552
  * @returns the stack
12553
+ * @since 1.0
12017
12554
  */
12018
12555
  get_stack(): Gtk.Stack | null;
12019
12556
 
12020
12557
  /**
12021
12558
  * Gets the subtitle of `self`.
12022
12559
  * @returns the subtitle of `self`
12560
+ * @since 1.0
12023
12561
  */
12024
12562
  get_subtitle(): string | null;
12025
12563
 
12026
12564
  /**
12027
12565
  * Gets the title of `self`.
12028
12566
  * @returns the title of `self`
12567
+ * @since 1.0
12029
12568
  */
12030
12569
  get_title(): string | null;
12031
12570
 
12032
12571
  /**
12033
12572
  * Gets whether the title of `self` is currently visible.
12034
12573
  * @returns whether the title of `self` is currently visible
12574
+ * @since 1.0
12035
12575
  */
12036
12576
  get_title_visible(): boolean;
12037
12577
 
12038
12578
  /**
12039
12579
  * Gets whether `self`'s view switcher is enabled.
12040
12580
  * @returns whether the view switcher is enabled
12581
+ * @since 1.0
12041
12582
  */
12042
12583
  get_view_switcher_enabled(): boolean;
12043
12584
 
12044
12585
  /**
12045
12586
  * Sets the policy of `self`.
12046
12587
  * @param policy the new policy
12588
+ * @since 1.0
12047
12589
  */
12048
12590
  set_policy(policy: ViewSwitcherPolicy): void;
12049
12591
 
12050
12592
  /**
12051
12593
  * Sets the {@link Gtk.Stack} to control.
12052
12594
  * @param stack a stack
12595
+ * @since 1.0
12053
12596
  */
12054
12597
  set_stack(stack: Gtk.Stack | null): void;
12055
12598
 
12056
12599
  /**
12057
12600
  * Sets the subtitle of `self`.
12058
12601
  * @param subtitle a subtitle
12602
+ * @since 1.0
12059
12603
  */
12060
12604
  set_subtitle(subtitle: string | null): void;
12061
12605
 
12062
12606
  /**
12063
12607
  * Sets the title of `self`.
12064
12608
  * @param title a title
12609
+ * @since 1.0
12065
12610
  */
12066
12611
  set_title(title: string | null): void;
12067
12612
 
12068
12613
  /**
12069
12614
  * Sets whether `self`'s view switcher is enabled.
12070
12615
  * @param enabled `TRUE` to enable the view switcher, `FALSE` to disable it
12616
+ * @since 1.0
12071
12617
  */
12072
12618
  set_view_switcher_enabled(enabled: boolean): void;
12073
12619
  }
@@ -12555,6 +13101,7 @@ export namespace Handy {
12555
13101
  // Virtual methods
12556
13102
  /**
12557
13103
  * Gets the progress `self` will snap back to after the gesture is canceled.
13104
+ * @since 1.0
12558
13105
  * @virtual
12559
13106
  */
12560
13107
  vfunc_get_cancel_progress(): number;
@@ -12563,12 +13110,14 @@ export namespace Handy {
12563
13110
  * Gets the swipe distance of `self`.
12564
13111
  *
12565
13112
  * This corresponds to how many pixels 1 unit represents.
13113
+ * @since 1.0
12566
13114
  * @virtual
12567
13115
  */
12568
13116
  vfunc_get_distance(): number;
12569
13117
 
12570
13118
  /**
12571
13119
  * Gets the current progress of `self`.
13120
+ * @since 1.0
12572
13121
  * @virtual
12573
13122
  */
12574
13123
  vfunc_get_progress(): number;
@@ -12578,6 +13127,7 @@ export namespace Handy {
12578
13127
  *
12579
13128
  * Each snap point represents a progress value that is considered acceptable to
12580
13129
  * end the swipe on.
13130
+ * @since 1.0
12581
13131
  * @virtual
12582
13132
  */
12583
13133
  vfunc_get_snap_points(): number[];
@@ -12597,12 +13147,14 @@ export namespace Handy {
12597
13147
  * `self`, allowing swipes from anywhere.
12598
13148
  * @param navigation_direction the direction of the swipe
12599
13149
  * @param is_drag whether the swipe is caused by a dragging gesture
13150
+ * @since 1.0
12600
13151
  * @virtual
12601
13152
  */
12602
13153
  vfunc_get_swipe_area(navigation_direction: NavigationDirection, is_drag: boolean): Gdk.Rectangle;
12603
13154
 
12604
13155
  /**
12605
13156
  * Gets the {@link SwipeTracker} used by this swipeable widget.
13157
+ * @since 1.0
12606
13158
  * @virtual
12607
13159
  */
12608
13160
  vfunc_get_swipe_tracker(): SwipeTracker;
@@ -12613,6 +13165,7 @@ export namespace Handy {
12613
13165
  * See `Handy.Swipeable::child-switched`.
12614
13166
  * @param index the index of the child to switch to
12615
13167
  * @param duration animation duration, in milliseconds
13168
+ * @since 1.0
12616
13169
  * @virtual
12617
13170
  */
12618
13171
  vfunc_switch_child(index: number, duration: number): void;
@@ -12648,12 +13201,14 @@ export namespace Handy {
12648
13201
  * `duration` can be 0 if the child is switched without animation.
12649
13202
  * @param index the index of the child to switch to
12650
13203
  * @param duration animation duration, in milliseconds
13204
+ * @since 1.0
12651
13205
  */
12652
13206
  emit_child_switched(index: number, duration: bigint | number): void;
12653
13207
 
12654
13208
  /**
12655
13209
  * Gets the progress `self` will snap back to after the gesture is canceled.
12656
13210
  * @returns the cancel progress, unitless
13211
+ * @since 1.0
12657
13212
  */
12658
13213
  get_cancel_progress(): number;
12659
13214
 
@@ -12662,12 +13217,14 @@ export namespace Handy {
12662
13217
  *
12663
13218
  * This corresponds to how many pixels 1 unit represents.
12664
13219
  * @returns the swipe distance in pixels
13220
+ * @since 1.0
12665
13221
  */
12666
13222
  get_distance(): number;
12667
13223
 
12668
13224
  /**
12669
13225
  * Gets the current progress of `self`.
12670
13226
  * @returns the current progress, unitless
13227
+ * @since 1.0
12671
13228
  */
12672
13229
  get_progress(): number;
12673
13230
 
@@ -12677,6 +13234,7 @@ export namespace Handy {
12677
13234
  * Each snap point represents a progress value that is considered acceptable to
12678
13235
  * end the swipe on.
12679
13236
  * @returns the snap points
13237
+ * @since 1.0
12680
13238
  */
12681
13239
  get_snap_points(): number[];
12682
13240
 
@@ -12695,12 +13253,14 @@ export namespace Handy {
12695
13253
  * `self`, allowing swipes from anywhere.
12696
13254
  * @param navigation_direction the direction of the swipe
12697
13255
  * @param is_drag whether the swipe is caused by a dragging gesture
13256
+ * @since 1.0
12698
13257
  */
12699
13258
  get_swipe_area(navigation_direction: NavigationDirection, is_drag: boolean): Gdk.Rectangle;
12700
13259
 
12701
13260
  /**
12702
13261
  * Gets the {@link SwipeTracker} used by this swipeable widget.
12703
13262
  * @returns the swipe tracker
13263
+ * @since 1.0
12704
13264
  */
12705
13265
  get_swipe_tracker(): SwipeTracker;
12706
13266
 
@@ -12710,6 +13270,7 @@ export namespace Handy {
12710
13270
  * See `Handy.Swipeable::child-switched`.
12711
13271
  * @param index the index of the child to switch to
12712
13272
  * @param duration animation duration, in milliseconds
13273
+ * @since 1.0
12713
13274
  */
12714
13275
  switch_child(index: number, duration: bigint | number): void;
12715
13276
  }