@girs/foundrygtk-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/foundrygtk-1.d.ts CHANGED
@@ -369,12 +369,14 @@ export namespace FoundryGtk {
369
369
  /**
370
370
  * Gets the graph entry displayed by `self`.
371
371
  * @returns a {@link Foundry.VcsGraphEntry}
372
+ * @since 1.2
372
373
  */
373
374
  dup_entry(): Foundry.VcsGraphEntry | null;
374
375
 
375
376
  /**
376
377
  * Sets the graph entry displayed by `self`.
377
378
  * @param entry a {@link Foundry.VcsGraphEntry}
379
+ * @since 1.2
378
380
  */
379
381
  set_entry(entry: Foundry.VcsGraphEntry | null): void;
380
382
 
@@ -384,6 +386,7 @@ export namespace FoundryGtk {
384
386
  * If `colors` is `null`, the default lane colors are used. When `colors` is not
385
387
  * `null`, the colors are copied and `n_colors` must be greater than zero.
386
388
  * @param colors the lane colors
389
+ * @since 1.2
387
390
  */
388
391
  set_lane_colors(colors: Gdk.RGBA[] | null): void;
389
392
 
@@ -419,6 +422,7 @@ export namespace FoundryGtk {
419
422
  * does not interrupts the user's current screen reader output.
420
423
  * @param message the string to announce
421
424
  * @param priority the priority of the announcement
425
+ * @since 4.14
422
426
  */
423
427
  announce(message: string, priority: Gtk.AccessibleAnnouncementPriority): void;
424
428
 
@@ -431,6 +435,7 @@ export namespace FoundryGtk {
431
435
  * It is left to the accessible implementation to define the scope
432
436
  * and uniqueness of the identifier.
433
437
  * @returns the accessible identifier
438
+ * @since 4.22
434
439
  */
435
440
  get_accessible_id(): string | null;
436
441
 
@@ -439,6 +444,7 @@ export namespace FoundryGtk {
439
444
  *
440
445
  * This function returns `NULL` for top level widgets.
441
446
  * @returns the accessible parent
447
+ * @since 4.10
442
448
  */
443
449
  get_accessible_parent(): Gtk.Accessible | null;
444
450
 
@@ -451,6 +457,7 @@ export namespace FoundryGtk {
451
457
  /**
452
458
  * Retrieves the implementation for the given accessible object.
453
459
  * @returns the accessible implementation object
460
+ * @since 4.10
454
461
  */
455
462
  get_at_context(): Gtk.ATContext;
456
463
 
@@ -461,18 +468,21 @@ export namespace FoundryGtk {
461
468
  * implementations, e.g. to get the bounds from an ignored
462
469
  * child widget.
463
470
  * @returns true if the bounds are valid, and false otherwise
471
+ * @since 4.10
464
472
  */
465
473
  get_bounds(): [boolean, number, number, number, number];
466
474
 
467
475
  /**
468
476
  * Retrieves the first accessible child of an accessible object.
469
477
  * @returns the first accessible child
478
+ * @since 4.10
470
479
  */
471
480
  get_first_accessible_child(): Gtk.Accessible | null;
472
481
 
473
482
  /**
474
483
  * Retrieves the next accessible sibling of an accessible object
475
484
  * @returns the next accessible sibling
485
+ * @since 4.10
476
486
  */
477
487
  get_next_accessible_sibling(): Gtk.Accessible | null;
478
488
 
@@ -484,6 +494,7 @@ export namespace FoundryGtk {
484
494
  * child widget, as is the case for {@link Gtk.Text} wrappers.
485
495
  * @param state platform state to query
486
496
  * @returns the value of state for the accessible
497
+ * @since 4.10
487
498
  */
488
499
  get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
489
500
 
@@ -517,6 +528,7 @@ export namespace FoundryGtk {
517
528
  * object is the container widget.
518
529
  * @param parent the parent accessible object
519
530
  * @param next_sibling the sibling accessible object
531
+ * @since 4.10
520
532
  */
521
533
  set_accessible_parent(parent: Gtk.Accessible | null, next_sibling: Gtk.Accessible | null): void;
522
534
 
@@ -526,6 +538,7 @@ export namespace FoundryGtk {
526
538
  * That might be useful when a new child of a custom accessible
527
539
  * is created, and it needs to be linked to a previous child.
528
540
  * @param new_sibling the new next accessible sibling to set
541
+ * @since 4.10
529
542
  */
530
543
  update_next_accessible_sibling(new_sibling: Gtk.Accessible | null): void;
531
544
 
@@ -536,6 +549,7 @@ export namespace FoundryGtk {
536
549
  * have a platform state but are not widgets. Widgets handle platform
537
550
  * states automatically.
538
551
  * @param state the platform state to update
552
+ * @since 4.18
539
553
  */
540
554
  update_platform_state(state: Gtk.AccessiblePlatformState): void;
541
555
 
@@ -583,6 +597,7 @@ export namespace FoundryGtk {
583
597
  *
584
598
  * It is left to the accessible implementation to define the scope
585
599
  * and uniqueness of the identifier.
600
+ * @since 4.22
586
601
  * @virtual
587
602
  */
588
603
  vfunc_get_accessible_id(): string | null;
@@ -591,12 +606,14 @@ export namespace FoundryGtk {
591
606
  * Retrieves the accessible parent for an accessible object.
592
607
  *
593
608
  * This function returns `NULL` for top level widgets.
609
+ * @since 4.10
594
610
  * @virtual
595
611
  */
596
612
  vfunc_get_accessible_parent(): Gtk.Accessible | null;
597
613
 
598
614
  /**
599
615
  * Retrieves the implementation for the given accessible object.
616
+ * @since 4.10
600
617
  * @virtual
601
618
  */
602
619
  vfunc_get_at_context(): Gtk.ATContext | null;
@@ -607,18 +624,21 @@ export namespace FoundryGtk {
607
624
  * This functionality can be overridden by {@link Gtk.Accessible}
608
625
  * implementations, e.g. to get the bounds from an ignored
609
626
  * child widget.
627
+ * @since 4.10
610
628
  * @virtual
611
629
  */
612
630
  vfunc_get_bounds(): [boolean, number, number, number, number];
613
631
 
614
632
  /**
615
633
  * Retrieves the first accessible child of an accessible object.
634
+ * @since 4.10
616
635
  * @virtual
617
636
  */
618
637
  vfunc_get_first_accessible_child(): Gtk.Accessible | null;
619
638
 
620
639
  /**
621
640
  * Retrieves the next accessible sibling of an accessible object
641
+ * @since 4.10
622
642
  * @virtual
623
643
  */
624
644
  vfunc_get_next_accessible_sibling(): Gtk.Accessible | null;
@@ -630,6 +650,7 @@ export namespace FoundryGtk {
630
650
  * implementations, e.g. to get platform state from an ignored
631
651
  * child widget, as is the case for {@link Gtk.Text} wrappers.
632
652
  * @param state platform state to query
653
+ * @since 4.10
633
654
  * @virtual
634
655
  */
635
656
  vfunc_get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
@@ -852,6 +873,7 @@ export namespace FoundryGtk {
852
873
  * does not interrupts the user's current screen reader output.
853
874
  * @param message the string to announce
854
875
  * @param priority the priority of the announcement
876
+ * @since 4.14
855
877
  */
856
878
  announce(message: string, priority: Gtk.AccessibleAnnouncementPriority): void;
857
879
 
@@ -864,6 +886,7 @@ export namespace FoundryGtk {
864
886
  * It is left to the accessible implementation to define the scope
865
887
  * and uniqueness of the identifier.
866
888
  * @returns the accessible identifier
889
+ * @since 4.22
867
890
  */
868
891
  get_accessible_id(): string | null;
869
892
 
@@ -872,6 +895,7 @@ export namespace FoundryGtk {
872
895
  *
873
896
  * This function returns `NULL` for top level widgets.
874
897
  * @returns the accessible parent
898
+ * @since 4.10
875
899
  */
876
900
  get_accessible_parent(): Gtk.Accessible | null;
877
901
 
@@ -884,6 +908,7 @@ export namespace FoundryGtk {
884
908
  /**
885
909
  * Retrieves the implementation for the given accessible object.
886
910
  * @returns the accessible implementation object
911
+ * @since 4.10
887
912
  */
888
913
  get_at_context(): Gtk.ATContext;
889
914
 
@@ -894,18 +919,21 @@ export namespace FoundryGtk {
894
919
  * implementations, e.g. to get the bounds from an ignored
895
920
  * child widget.
896
921
  * @returns true if the bounds are valid, and false otherwise
922
+ * @since 4.10
897
923
  */
898
924
  get_bounds(): [boolean, number, number, number, number];
899
925
 
900
926
  /**
901
927
  * Retrieves the first accessible child of an accessible object.
902
928
  * @returns the first accessible child
929
+ * @since 4.10
903
930
  */
904
931
  get_first_accessible_child(): Gtk.Accessible | null;
905
932
 
906
933
  /**
907
934
  * Retrieves the next accessible sibling of an accessible object
908
935
  * @returns the next accessible sibling
936
+ * @since 4.10
909
937
  */
910
938
  get_next_accessible_sibling(): Gtk.Accessible | null;
911
939
 
@@ -917,6 +945,7 @@ export namespace FoundryGtk {
917
945
  * child widget, as is the case for {@link Gtk.Text} wrappers.
918
946
  * @param state platform state to query
919
947
  * @returns the value of state for the accessible
948
+ * @since 4.10
920
949
  */
921
950
  get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
922
951
 
@@ -950,6 +979,7 @@ export namespace FoundryGtk {
950
979
  * object is the container widget.
951
980
  * @param parent the parent accessible object
952
981
  * @param next_sibling the sibling accessible object
982
+ * @since 4.10
953
983
  */
954
984
  set_accessible_parent(parent: Gtk.Accessible | null, next_sibling: Gtk.Accessible | null): void;
955
985
 
@@ -959,6 +989,7 @@ export namespace FoundryGtk {
959
989
  * That might be useful when a new child of a custom accessible
960
990
  * is created, and it needs to be linked to a previous child.
961
991
  * @param new_sibling the new next accessible sibling to set
992
+ * @since 4.10
962
993
  */
963
994
  update_next_accessible_sibling(new_sibling: Gtk.Accessible | null): void;
964
995
 
@@ -969,6 +1000,7 @@ export namespace FoundryGtk {
969
1000
  * have a platform state but are not widgets. Widgets handle platform
970
1001
  * states automatically.
971
1002
  * @param state the platform state to update
1003
+ * @since 4.18
972
1004
  */
973
1005
  update_platform_state(state: Gtk.AccessiblePlatformState): void;
974
1006
 
@@ -1016,6 +1048,7 @@ export namespace FoundryGtk {
1016
1048
  *
1017
1049
  * It is left to the accessible implementation to define the scope
1018
1050
  * and uniqueness of the identifier.
1051
+ * @since 4.22
1019
1052
  * @virtual
1020
1053
  */
1021
1054
  vfunc_get_accessible_id(): string | null;
@@ -1024,12 +1057,14 @@ export namespace FoundryGtk {
1024
1057
  * Retrieves the accessible parent for an accessible object.
1025
1058
  *
1026
1059
  * This function returns `NULL` for top level widgets.
1060
+ * @since 4.10
1027
1061
  * @virtual
1028
1062
  */
1029
1063
  vfunc_get_accessible_parent(): Gtk.Accessible | null;
1030
1064
 
1031
1065
  /**
1032
1066
  * Retrieves the implementation for the given accessible object.
1067
+ * @since 4.10
1033
1068
  * @virtual
1034
1069
  */
1035
1070
  vfunc_get_at_context(): Gtk.ATContext | null;
@@ -1040,18 +1075,21 @@ export namespace FoundryGtk {
1040
1075
  * This functionality can be overridden by {@link Gtk.Accessible}
1041
1076
  * implementations, e.g. to get the bounds from an ignored
1042
1077
  * child widget.
1078
+ * @since 4.10
1043
1079
  * @virtual
1044
1080
  */
1045
1081
  vfunc_get_bounds(): [boolean, number, number, number, number];
1046
1082
 
1047
1083
  /**
1048
1084
  * Retrieves the first accessible child of an accessible object.
1085
+ * @since 4.10
1049
1086
  * @virtual
1050
1087
  */
1051
1088
  vfunc_get_first_accessible_child(): Gtk.Accessible | null;
1052
1089
 
1053
1090
  /**
1054
1091
  * Retrieves the next accessible sibling of an accessible object
1092
+ * @since 4.10
1055
1093
  * @virtual
1056
1094
  */
1057
1095
  vfunc_get_next_accessible_sibling(): Gtk.Accessible | null;
@@ -1063,6 +1101,7 @@ export namespace FoundryGtk {
1063
1101
  * implementations, e.g. to get platform state from an ignored
1064
1102
  * child widget, as is the case for {@link Gtk.Text} wrappers.
1065
1103
  * @param state platform state to query
1104
+ * @since 4.10
1066
1105
  * @virtual
1067
1106
  */
1068
1107
  vfunc_get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
@@ -1234,12 +1273,15 @@ export namespace FoundryGtk {
1234
1273
  // Methods
1235
1274
  /**
1236
1275
  * @param filename
1276
+ * @throws GLib.Error
1237
1277
  */
1238
1278
  add_filename(filename: string): number;
1239
1279
 
1240
1280
  /**
1241
1281
  * @param resource
1242
1282
  * @returns the merge id
1283
+ * @since 1.4
1284
+ * @throws GLib.Error
1243
1285
  */
1244
1286
  add_resource(resource: string): number;
1245
1287
 
@@ -1250,17 +1292,20 @@ export namespace FoundryGtk {
1250
1292
  * If no match is found, `null` is returned.
1251
1293
  * @param id the identifier of the menu item
1252
1294
  * @returns a {@link Gio.Menu} if successful; otherwise `null` and `position` is unset.
1295
+ * @since 1.4
1253
1296
  */
1254
1297
  find_item_by_id(id: string): [Gio.Menu | null, number];
1255
1298
 
1256
1299
  /**
1257
1300
  * @param menu_id
1258
1301
  * @returns A {@link Gio.Menu}.
1302
+ * @since 1.4
1259
1303
  */
1260
1304
  get_menu_by_id(menu_id: string): Gio.Menu;
1261
1305
 
1262
1306
  /**
1263
1307
  * Gets the known menu ids as a string array.
1308
+ * @since 1.4
1264
1309
  */
1265
1310
  get_menu_ids(): string[];
1266
1311
 
@@ -1269,6 +1314,7 @@ export namespace FoundryGtk {
1269
1314
  * @param menu_id the identifier of the menu
1270
1315
  * @param menu_model the menu model to merge
1271
1316
  * @returns the merge-id which can be used with `foundry_menu_manager_remove()`
1317
+ * @since 1.4
1272
1318
  */
1273
1319
  merge(menu_id: string, menu_model: Gio.MenuModel): number;
1274
1320
 
@@ -1277,6 +1323,7 @@ export namespace FoundryGtk {
1277
1323
  * menu merge. Use the value returned from `foundry_menu_manager_merge()` as
1278
1324
  * the `merge_id`.
1279
1325
  * @param merge_id A previously registered merge id
1326
+ * @since 1.4
1280
1327
  */
1281
1328
  remove(merge_id: number): void;
1282
1329
 
@@ -1290,6 +1337,7 @@ export namespace FoundryGtk {
1290
1337
  * @param position the index of the item in the menu
1291
1338
  * @param attribute the attribute to change
1292
1339
  * @param value the new value for the attribute
1340
+ * @since 1.4
1293
1341
  */
1294
1342
  set_attribute_string(menu: Gio.Menu, position: number, attribute: string, value: string): void;
1295
1343
  }
@@ -1417,6 +1465,7 @@ export namespace FoundryGtk {
1417
1465
  /**
1418
1466
  * @param shortcut_id
1419
1467
  * @param accelerator
1468
+ * @throws GLib.Error
1420
1469
  */
1421
1470
  override(shortcut_id: string, accelerator: string): boolean;
1422
1471
 
@@ -1427,6 +1476,7 @@ export namespace FoundryGtk {
1427
1476
 
1428
1477
  /**
1429
1478
  * @param file
1479
+ * @throws GLib.Error
1430
1480
  */
1431
1481
  parse(file: Gio.File): boolean;
1432
1482
 
@@ -1440,6 +1490,7 @@ export namespace FoundryGtk {
1440
1490
  * The item type of a {@link Gio.ListModel} can not change during the life of the
1441
1491
  * model.
1442
1492
  * @returns the {@link GObject.GType} of the items contained in `list`.
1493
+ * @since 2.44
1443
1494
  */
1444
1495
  get_item_type(): GObject.GType;
1445
1496
 
@@ -1450,6 +1501,7 @@ export namespace FoundryGtk {
1450
1501
  * less efficient than iterating the list with increasing values for
1451
1502
  * `position` until `g_list_model_get_item()` returns `null`.
1452
1503
  * @returns the number of items in `list`.
1504
+ * @since 2.44
1453
1505
  */
1454
1506
  get_n_items(): number;
1455
1507
 
@@ -1468,6 +1520,7 @@ export namespace FoundryGtk {
1468
1520
  * See also: `g_list_model_get_n_items()`
1469
1521
  * @param position the position of the item to fetch
1470
1522
  * @returns the object at `position`.
1523
+ * @since 2.44
1471
1524
  */
1472
1525
  get_item(position: number): A | null;
1473
1526
 
@@ -1495,6 +1548,7 @@ export namespace FoundryGtk {
1495
1548
  * @param position the position at which `list` changed
1496
1549
  * @param removed the number of items removed
1497
1550
  * @param added the number of items added
1551
+ * @since 2.44
1498
1552
  */
1499
1553
  items_changed(position: number, removed: number, added: number): void;
1500
1554
 
@@ -1507,6 +1561,7 @@ export namespace FoundryGtk {
1507
1561
  *
1508
1562
  * The same {@link GObject.Object} instance may not appear more than once in a {@link Gio.ListModel}.
1509
1563
  * @param position the position of the item to fetch
1564
+ * @since 2.44
1510
1565
  * @virtual
1511
1566
  */
1512
1567
  vfunc_get_item(position: number): A | null;
@@ -1520,6 +1575,7 @@ export namespace FoundryGtk {
1520
1575
  *
1521
1576
  * The item type of a {@link Gio.ListModel} can not change during the life of the
1522
1577
  * model.
1578
+ * @since 2.44
1523
1579
  * @virtual
1524
1580
  */
1525
1581
  vfunc_get_item_type(): GObject.GType;
@@ -1530,6 +1586,7 @@ export namespace FoundryGtk {
1530
1586
  * Depending on the model implementation, calling this function may be
1531
1587
  * less efficient than iterating the list with increasing values for
1532
1588
  * `position` until `g_list_model_get_item()` returns `null`.
1589
+ * @since 2.44
1533
1590
  * @virtual
1534
1591
  */
1535
1592
  vfunc_get_n_items(): number;
@@ -1616,6 +1673,7 @@ export namespace FoundryGtk {
1616
1673
  * The item type of a {@link Gio.ListModel} can not change during the life of the
1617
1674
  * model.
1618
1675
  * @returns the {@link GObject.GType} of the items contained in `list`.
1676
+ * @since 2.44
1619
1677
  */
1620
1678
  get_item_type(): GObject.GType;
1621
1679
 
@@ -1626,6 +1684,7 @@ export namespace FoundryGtk {
1626
1684
  * less efficient than iterating the list with increasing values for
1627
1685
  * `position` until `g_list_model_get_item()` returns `null`.
1628
1686
  * @returns the number of items in `list`.
1687
+ * @since 2.44
1629
1688
  */
1630
1689
  get_n_items(): number;
1631
1690
 
@@ -1644,6 +1703,7 @@ export namespace FoundryGtk {
1644
1703
  * See also: `g_list_model_get_n_items()`
1645
1704
  * @param position the position of the item to fetch
1646
1705
  * @returns the object at `position`.
1706
+ * @since 2.44
1647
1707
  */
1648
1708
  get_item(position: number): A | null;
1649
1709
 
@@ -1671,6 +1731,7 @@ export namespace FoundryGtk {
1671
1731
  * @param position the position at which `list` changed
1672
1732
  * @param removed the number of items removed
1673
1733
  * @param added the number of items added
1734
+ * @since 2.44
1674
1735
  */
1675
1736
  items_changed(position: number, removed: number, added: number): void;
1676
1737
 
@@ -1683,6 +1744,7 @@ export namespace FoundryGtk {
1683
1744
  *
1684
1745
  * The same {@link GObject.Object} instance may not appear more than once in a {@link Gio.ListModel}.
1685
1746
  * @param position the position of the item to fetch
1747
+ * @since 2.44
1686
1748
  * @virtual
1687
1749
  */
1688
1750
  vfunc_get_item(position: number): A | null;
@@ -1696,6 +1758,7 @@ export namespace FoundryGtk {
1696
1758
  *
1697
1759
  * The item type of a {@link Gio.ListModel} can not change during the life of the
1698
1760
  * model.
1761
+ * @since 2.44
1699
1762
  * @virtual
1700
1763
  */
1701
1764
  vfunc_get_item_type(): GObject.GType;
@@ -1706,6 +1769,7 @@ export namespace FoundryGtk {
1706
1769
  * Depending on the model implementation, calling this function may be
1707
1770
  * less efficient than iterating the list with increasing values for
1708
1771
  * `position` until `g_list_model_get_item()` returns `null`.
1772
+ * @since 2.44
1709
1773
  * @virtual
1710
1774
  */
1711
1775
  vfunc_get_n_items(): number;
@@ -1722,7 +1786,7 @@ export namespace FoundryGtk {
1722
1786
  * @detailed
1723
1787
  * @run-last
1724
1788
  */
1725
- "accel-changed": (arg0: string, arg1: string | null) => void;
1789
+ "accel-changed": (action: string, accel: string | null) => void;
1726
1790
  "notify::model": (pspec: GObject.ParamSpec) => void;
1727
1791
  /**
1728
1792
  * This signal is emitted when an action is determined to have been changed
@@ -1731,8 +1795,8 @@ export namespace FoundryGtk {
1731
1795
  * @detailed
1732
1796
  * @run-last
1733
1797
  */
1734
- "accel-changed::model": (arg0: string, arg1: string | null) => void;
1735
- [key: `accel-changed::${string}`]: (arg0: string, arg1: string | null) => void;
1798
+ "accel-changed::model": (action: string, accel: string | null) => void;
1799
+ [key: `accel-changed::${string}`]: (action: string, accel: string | null) => void;
1736
1800
  }
1737
1801
 
1738
1802
  // Constructor properties interface
@@ -1894,6 +1958,7 @@ export namespace FoundryGtk {
1894
1958
  * for the current language.
1895
1959
  * @param begin start of the text range to comment
1896
1960
  * @param end end of the text range to comment
1961
+ * @since 1.1
1897
1962
  */
1898
1963
  comment(begin: Gtk.TextIter, end: Gtk.TextIter): void;
1899
1964
 
@@ -1932,6 +1997,7 @@ export namespace FoundryGtk {
1932
1997
  * Removes comment markers from the specified text range.
1933
1998
  * @param begin start of the text range to uncomment
1934
1999
  * @param end end of the text range to uncomment
2000
+ * @since 1.1
1935
2001
  */
1936
2002
  uncomment(begin: Gtk.TextIter, end: Gtk.TextIter): void;
1937
2003
 
@@ -1942,6 +2008,7 @@ export namespace FoundryGtk {
1942
2008
  * @param flags non-zero flags to dispatch
1943
2009
  * @param commit_notify
1944
2010
  * @returns a non-zero commit handler id if supported; otherwise zero.
2011
+ * @since 1.1
1945
2012
  */
1946
2013
  add_commit_notify(flags: Foundry.TextBufferNotifyFlags, commit_notify: Foundry.TextBufferCommitNotify): number;
1947
2014
 
@@ -2003,6 +2070,7 @@ export namespace FoundryGtk {
2003
2070
  /**
2004
2071
  * Remove a commit notify handler.
2005
2072
  * @param commit_notify_handler the previously registered non-zero commit handler
2073
+ * @since 1.1
2006
2074
  */
2007
2075
  remove_commit_notify(commit_notify_handler: number): void;
2008
2076
 
@@ -2019,6 +2087,7 @@ export namespace FoundryGtk {
2019
2087
  * If the implementation does not support this, zero is returned.
2020
2088
  * @param flags non-zero flags to dispatch
2021
2089
  * @param commit_notify
2090
+ * @since 1.1
2022
2091
  * @virtual
2023
2092
  */
2024
2093
  vfunc_add_commit_notify(flags: Foundry.TextBufferNotifyFlags, commit_notify: Foundry.TextBufferCommitNotify): number;
@@ -2059,6 +2128,7 @@ export namespace FoundryGtk {
2059
2128
  /**
2060
2129
  * Remove a commit notify handler.
2061
2130
  * @param commit_notify_handler the previously registered non-zero commit handler
2131
+ * @since 1.1
2062
2132
  * @virtual
2063
2133
  */
2064
2134
  vfunc_remove_commit_notify(commit_notify_handler: number): void;
@@ -2388,6 +2458,7 @@ export namespace FoundryGtk {
2388
2458
  * @param use_align
2389
2459
  * @param xalign
2390
2460
  * @param yalign
2461
+ * @since 1.1
2391
2462
  */
2392
2463
  jump_to_iter(iter: Gtk.TextIter, within_margin: number, use_align: boolean, xalign: number, yalign: number): void;
2393
2464
 
@@ -2697,6 +2768,7 @@ export namespace FoundryGtk {
2697
2768
  * does not interrupts the user's current screen reader output.
2698
2769
  * @param message the string to announce
2699
2770
  * @param priority the priority of the announcement
2771
+ * @since 4.14
2700
2772
  */
2701
2773
  announce(message: string, priority: Gtk.AccessibleAnnouncementPriority): void;
2702
2774
 
@@ -2709,6 +2781,7 @@ export namespace FoundryGtk {
2709
2781
  * It is left to the accessible implementation to define the scope
2710
2782
  * and uniqueness of the identifier.
2711
2783
  * @returns the accessible identifier
2784
+ * @since 4.22
2712
2785
  */
2713
2786
  get_accessible_id(): string | null;
2714
2787
 
@@ -2717,6 +2790,7 @@ export namespace FoundryGtk {
2717
2790
  *
2718
2791
  * This function returns `NULL` for top level widgets.
2719
2792
  * @returns the accessible parent
2793
+ * @since 4.10
2720
2794
  */
2721
2795
  get_accessible_parent(): Gtk.Accessible | null;
2722
2796
 
@@ -2729,6 +2803,7 @@ export namespace FoundryGtk {
2729
2803
  /**
2730
2804
  * Retrieves the implementation for the given accessible object.
2731
2805
  * @returns the accessible implementation object
2806
+ * @since 4.10
2732
2807
  */
2733
2808
  get_at_context(): Gtk.ATContext;
2734
2809
 
@@ -2739,18 +2814,21 @@ export namespace FoundryGtk {
2739
2814
  * implementations, e.g. to get the bounds from an ignored
2740
2815
  * child widget.
2741
2816
  * @returns true if the bounds are valid, and false otherwise
2817
+ * @since 4.10
2742
2818
  */
2743
2819
  get_bounds(): [boolean, number, number, number, number];
2744
2820
 
2745
2821
  /**
2746
2822
  * Retrieves the first accessible child of an accessible object.
2747
2823
  * @returns the first accessible child
2824
+ * @since 4.10
2748
2825
  */
2749
2826
  get_first_accessible_child(): Gtk.Accessible | null;
2750
2827
 
2751
2828
  /**
2752
2829
  * Retrieves the next accessible sibling of an accessible object
2753
2830
  * @returns the next accessible sibling
2831
+ * @since 4.10
2754
2832
  */
2755
2833
  get_next_accessible_sibling(): Gtk.Accessible | null;
2756
2834
 
@@ -2762,6 +2840,7 @@ export namespace FoundryGtk {
2762
2840
  * child widget, as is the case for {@link Gtk.Text} wrappers.
2763
2841
  * @param state platform state to query
2764
2842
  * @returns the value of state for the accessible
2843
+ * @since 4.10
2765
2844
  */
2766
2845
  get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
2767
2846
 
@@ -2795,6 +2874,7 @@ export namespace FoundryGtk {
2795
2874
  * object is the container widget.
2796
2875
  * @param parent the parent accessible object
2797
2876
  * @param next_sibling the sibling accessible object
2877
+ * @since 4.10
2798
2878
  */
2799
2879
  set_accessible_parent(parent: Gtk.Accessible | null, next_sibling: Gtk.Accessible | null): void;
2800
2880
 
@@ -2804,6 +2884,7 @@ export namespace FoundryGtk {
2804
2884
  * That might be useful when a new child of a custom accessible
2805
2885
  * is created, and it needs to be linked to a previous child.
2806
2886
  * @param new_sibling the new next accessible sibling to set
2887
+ * @since 4.10
2807
2888
  */
2808
2889
  update_next_accessible_sibling(new_sibling: Gtk.Accessible | null): void;
2809
2890
 
@@ -2814,6 +2895,7 @@ export namespace FoundryGtk {
2814
2895
  * have a platform state but are not widgets. Widgets handle platform
2815
2896
  * states automatically.
2816
2897
  * @param state the platform state to update
2898
+ * @since 4.18
2817
2899
  */
2818
2900
  update_platform_state(state: Gtk.AccessiblePlatformState): void;
2819
2901
 
@@ -2861,6 +2943,7 @@ export namespace FoundryGtk {
2861
2943
  *
2862
2944
  * It is left to the accessible implementation to define the scope
2863
2945
  * and uniqueness of the identifier.
2946
+ * @since 4.22
2864
2947
  * @virtual
2865
2948
  */
2866
2949
  vfunc_get_accessible_id(): string | null;
@@ -2869,12 +2952,14 @@ export namespace FoundryGtk {
2869
2952
  * Retrieves the accessible parent for an accessible object.
2870
2953
  *
2871
2954
  * This function returns `NULL` for top level widgets.
2955
+ * @since 4.10
2872
2956
  * @virtual
2873
2957
  */
2874
2958
  vfunc_get_accessible_parent(): Gtk.Accessible | null;
2875
2959
 
2876
2960
  /**
2877
2961
  * Retrieves the implementation for the given accessible object.
2962
+ * @since 4.10
2878
2963
  * @virtual
2879
2964
  */
2880
2965
  vfunc_get_at_context(): Gtk.ATContext | null;
@@ -2885,18 +2970,21 @@ export namespace FoundryGtk {
2885
2970
  * This functionality can be overridden by {@link Gtk.Accessible}
2886
2971
  * implementations, e.g. to get the bounds from an ignored
2887
2972
  * child widget.
2973
+ * @since 4.10
2888
2974
  * @virtual
2889
2975
  */
2890
2976
  vfunc_get_bounds(): [boolean, number, number, number, number];
2891
2977
 
2892
2978
  /**
2893
2979
  * Retrieves the first accessible child of an accessible object.
2980
+ * @since 4.10
2894
2981
  * @virtual
2895
2982
  */
2896
2983
  vfunc_get_first_accessible_child(): Gtk.Accessible | null;
2897
2984
 
2898
2985
  /**
2899
2986
  * Retrieves the next accessible sibling of an accessible object
2987
+ * @since 4.10
2900
2988
  * @virtual
2901
2989
  */
2902
2990
  vfunc_get_next_accessible_sibling(): Gtk.Accessible | null;
@@ -2908,6 +2996,7 @@ export namespace FoundryGtk {
2908
2996
  * implementations, e.g. to get platform state from an ignored
2909
2997
  * child widget, as is the case for {@link Gtk.Text} wrappers.
2910
2998
  * @param state platform state to query
2999
+ * @since 4.10
2911
3000
  * @virtual
2912
3001
  */
2913
3002
  vfunc_get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
@@ -2918,6 +3007,7 @@ export namespace FoundryGtk {
2918
3007
  * Implementations of the {@link Gtk.AccessibleText} interface should call this
2919
3008
  * function every time the caret has moved, in order to notify assistive
2920
3009
  * technologies.
3010
+ * @since 4.14
2921
3011
  */
2922
3012
  update_caret_position(): void;
2923
3013
 
@@ -2934,6 +3024,7 @@ export namespace FoundryGtk {
2934
3024
  * @param change the type of change in the contents
2935
3025
  * @param start the starting offset of the change, in characters
2936
3026
  * @param end the end offset of the change, in characters
3027
+ * @since 4.14
2937
3028
  */
2938
3029
  update_contents(change: Gtk.AccessibleTextContentChange, start: number, end: number): void;
2939
3030
 
@@ -2943,6 +3034,7 @@ export namespace FoundryGtk {
2943
3034
  * Implementations of the {@link Gtk.AccessibleText} interface should call this
2944
3035
  * function every time the selection has moved, in order to notify assistive
2945
3036
  * technologies.
3037
+ * @since 4.14
2946
3038
  */
2947
3039
  update_selection_bound(): void;
2948
3040
 
@@ -2965,12 +3057,14 @@ export namespace FoundryGtk {
2965
3057
  * greater than or equal to one, `ranges` will be set to a newly
2966
3058
  * allocated array of [struct#Gtk.AccessibleTextRange].
2967
3059
  * @param offset the offset, in characters
3060
+ * @since 4.14
2968
3061
  * @virtual
2969
3062
  */
2970
3063
  vfunc_get_attributes(offset: number): [boolean, Gtk.AccessibleTextRange[] | null, string[] | null, string[] | null];
2971
3064
 
2972
3065
  /**
2973
3066
  * Retrieves the position of the caret inside the accessible object.
3067
+ * @since 4.14
2974
3068
  * @virtual
2975
3069
  */
2976
3070
  vfunc_get_caret_position(): number;
@@ -2983,6 +3077,7 @@ export namespace FoundryGtk {
2983
3077
  * of the accessible object.
2984
3078
  * @param start the beginning of the range, in characters
2985
3079
  * @param end the end of the range, in characters
3080
+ * @since 4.14
2986
3081
  * @virtual
2987
3082
  */
2988
3083
  vfunc_get_contents(start: number, end: number): GLib.Bytes | Uint8Array;
@@ -2994,6 +3089,7 @@ export namespace FoundryGtk {
2994
3089
  * The `start` and `end` values contain the boundaries of the text.
2995
3090
  * @param offset the offset, in characters
2996
3091
  * @param granularity the granularity of the query
3092
+ * @since 4.14
2997
3093
  * @virtual
2998
3094
  */
2999
3095
  vfunc_get_contents_at(offset: number, granularity: Gtk.AccessibleTextGranularity): [GLib.Bytes | Uint8Array, number, number];
@@ -3011,6 +3107,7 @@ export namespace FoundryGtk {
3011
3107
  *
3012
3108
  * GTK provides support for various text attribute names and values, but
3013
3109
  * implementations of this interface are free to add their own attributes.
3110
+ * @since 4.14
3014
3111
  * @virtual
3015
3112
  */
3016
3113
  vfunc_get_default_attributes(): [string[] | null, string[] | null];
@@ -3020,6 +3117,7 @@ export namespace FoundryGtk {
3020
3117
  * @param start the start offset, in characters
3021
3118
  * @param end the end offset, in characters, `extents` (out caller-allocates): return location for the extents
3022
3119
  * @param extents
3120
+ * @since 4.16
3023
3121
  * @virtual
3024
3122
  */
3025
3123
  vfunc_get_extents(start: number, end: number, extents: Graphene.Rect): boolean;
@@ -3027,6 +3125,7 @@ export namespace FoundryGtk {
3027
3125
  /**
3028
3126
  * Gets the text offset at a given point.
3029
3127
  * @param point a point in widget coordinates of `self`
3128
+ * @since 4.16
3030
3129
  * @virtual
3031
3130
  */
3032
3131
  vfunc_get_offset(point: Graphene.Point): [boolean, number];
@@ -3037,6 +3136,7 @@ export namespace FoundryGtk {
3037
3136
  * If this function returns true, `n_ranges` will be set to a value
3038
3137
  * greater than or equal to one, and `ranges` will be set to a newly
3039
3138
  * allocated array of [struct#Gtk.AccessibleTextRange].
3139
+ * @since 4.14
3040
3140
  * @virtual
3041
3141
  */
3042
3142
  vfunc_get_selection(): [boolean, Gtk.AccessibleTextRange[] | null];
@@ -3044,6 +3144,7 @@ export namespace FoundryGtk {
3044
3144
  /**
3045
3145
  * Sets the caret position.
3046
3146
  * @param offset the text offset in characters
3147
+ * @since 4.22
3047
3148
  * @virtual
3048
3149
  */
3049
3150
  vfunc_set_caret_position(offset: number): boolean;
@@ -3052,6 +3153,7 @@ export namespace FoundryGtk {
3052
3153
  * Sets the caret position.
3053
3154
  * @param i the selection to set
3054
3155
  * @param range the range to set the selection to
3156
+ * @since 4.22
3055
3157
  * @virtual
3056
3158
  */
3057
3159
  vfunc_set_selection(i: number, range: Gtk.AccessibleTextRange): boolean;