@girs/gtksource-3.0 4.3.0 → 4.4.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.
@@ -959,6 +959,7 @@ export namespace GtkSource {
959
959
  * @param iter an iterator.
960
960
  * @param category category to search for, or `null`
961
961
  * @returns whether `iter` was moved.
962
+ * @since 2.2
962
963
  */
963
964
  backward_iter_to_source_mark(iter: Gtk.TextIter, category: string | null): boolean;
964
965
 
@@ -978,6 +979,7 @@ export namespace GtkSource {
978
979
  * @param case_type how to change the case.
979
980
  * @param start a {@link Gtk.TextIter}.
980
981
  * @param end a {@link Gtk.TextIter}.
982
+ * @since 3.12
981
983
  */
982
984
  change_case(case_type: ChangeCaseType, start: Gtk.TextIter, end: Gtk.TextIter): void;
983
985
 
@@ -999,6 +1001,7 @@ export namespace GtkSource {
999
1001
  * @param category a string defining the mark category.
1000
1002
  * @param where location to place the mark.
1001
1003
  * @returns a new {@link GtkSource.Mark}, owned by the buffer.
1004
+ * @since 2.2
1002
1005
  */
1003
1006
  create_source_mark(name: string | null, category: string, where: Gtk.TextIter): Mark;
1004
1007
 
@@ -1032,6 +1035,7 @@ export namespace GtkSource {
1032
1035
  * @param iter an iterator.
1033
1036
  * @param category category to search for, or `null`
1034
1037
  * @returns whether `iter` was moved.
1038
+ * @since 2.2
1035
1039
  */
1036
1040
  forward_iter_to_source_mark(iter: Gtk.TextIter, category: string | null): boolean;
1037
1041
 
@@ -1041,6 +1045,7 @@ export namespace GtkSource {
1041
1045
  * See the {@link GtkSource.Buffer} description for the list of default context classes.
1042
1046
  * @param iter a {@link Gtk.TextIter}.
1043
1047
  * @returns a new `null` terminated array of context class names. Use `g_strfreev()` to free the array if it is no longer needed.
1048
+ * @since 2.10
1044
1049
  */
1045
1050
  get_context_classes_at_iter(iter: Gtk.TextIter): string[];
1046
1051
 
@@ -1060,6 +1065,7 @@ export namespace GtkSource {
1060
1065
 
1061
1066
  /**
1062
1067
  * @returns whether the `buffer` has an implicit trailing newline.
1068
+ * @since 3.14
1063
1069
  */
1064
1070
  get_implicit_trailing_newline(): boolean;
1065
1071
 
@@ -1083,6 +1089,7 @@ export namespace GtkSource {
1083
1089
  * @param iter an iterator.
1084
1090
  * @param category category to search for, or `null`
1085
1091
  * @returns a newly allocated {@link GLib.SList}.
1092
+ * @since 2.2
1086
1093
  */
1087
1094
  get_source_marks_at_iter(iter: Gtk.TextIter, category: string | null): Mark[];
1088
1095
 
@@ -1092,6 +1099,7 @@ export namespace GtkSource {
1092
1099
  * @param line a line number.
1093
1100
  * @param category category to search for, or `null`
1094
1101
  * @returns a newly allocated {@link GLib.SList}.
1102
+ * @since 2.2
1095
1103
  */
1096
1104
  get_source_marks_at_line(line: number, category: string | null): Mark[];
1097
1105
 
@@ -1122,6 +1130,7 @@ export namespace GtkSource {
1122
1130
  * @param iter a {@link Gtk.TextIter}.
1123
1131
  * @param context_class the context class.
1124
1132
  * @returns whether we found a context class toggle before `iter`
1133
+ * @since 2.10
1125
1134
  */
1126
1135
  iter_backward_to_context_class_toggle(iter: Gtk.TextIter, context_class: string): boolean;
1127
1136
 
@@ -1136,6 +1145,7 @@ export namespace GtkSource {
1136
1145
  * @param iter a {@link Gtk.TextIter}.
1137
1146
  * @param context_class the context class.
1138
1147
  * @returns whether we found a context class toggle after `iter`
1148
+ * @since 2.10
1139
1149
  */
1140
1150
  iter_forward_to_context_class_toggle(iter: Gtk.TextIter, context_class: string): boolean;
1141
1151
 
@@ -1146,6 +1156,7 @@ export namespace GtkSource {
1146
1156
  * @param iter a {@link Gtk.TextIter}.
1147
1157
  * @param context_class class to search for.
1148
1158
  * @returns whether `iter` has the context class.
1159
+ * @since 2.10
1149
1160
  */
1150
1161
  iter_has_context_class(iter: Gtk.TextIter, context_class: string): boolean;
1151
1162
 
@@ -1153,6 +1164,7 @@ export namespace GtkSource {
1153
1164
  * Joins the lines of text between the specified iterators.
1154
1165
  * @param start a {@link Gtk.TextIter}.
1155
1166
  * @param end a {@link Gtk.TextIter}.
1167
+ * @since 3.16
1156
1168
  */
1157
1169
  join_lines(start: Gtk.TextIter, end: Gtk.TextIter): void;
1158
1170
 
@@ -1170,6 +1182,7 @@ export namespace GtkSource {
1170
1182
  * @param start a {@link Gtk.TextIter}.
1171
1183
  * @param end a {@link Gtk.TextIter}.
1172
1184
  * @param category category to search for, or `null`.
1185
+ * @since 2.2
1173
1186
  */
1174
1187
  remove_source_marks(start: Gtk.TextIter, end: Gtk.TextIter, category: string | null): void;
1175
1188
 
@@ -1213,6 +1226,7 @@ export namespace GtkSource {
1213
1226
  * content is not modified when loaded into the `buffer`, and the `buffer`'s
1214
1227
  * content is not modified when saved into a file.
1215
1228
  * @param implicit_trailing_newline the new value.
1229
+ * @since 3.14
1216
1230
  */
1217
1231
  set_implicit_trailing_newline(implicit_trailing_newline: boolean): void;
1218
1232
 
@@ -1271,6 +1285,7 @@ export namespace GtkSource {
1271
1285
  * @param end a {@link Gtk.TextIter}.
1272
1286
  * @param flags {@link GtkSource.SortFlags} specifying how the sort should behave
1273
1287
  * @param column sort considering the text starting at the given column
1288
+ * @since 3.18
1274
1289
  */
1275
1290
  sort_lines(start: Gtk.TextIter, end: Gtk.TextIter, flags: SortFlags, column: number): void;
1276
1291
 
@@ -1683,6 +1698,7 @@ export namespace GtkSource {
1683
1698
  /**
1684
1699
  * Move the completion window to a specific iter.
1685
1700
  * @param iter a {@link Gtk.TextIter}.
1701
+ * @deprecated since 3.8: Use `gtk_source_completion_provider_get_start_iter()` instead.
1686
1702
  */
1687
1703
  move_window(iter: Gtk.TextIter): void;
1688
1704
 
@@ -1722,6 +1738,7 @@ export namespace GtkSource {
1722
1738
  * @param builder a {@link Gtk.Builder}
1723
1739
  * @param child child to add
1724
1740
  * @param type kind of child or `null`
1741
+ * @since 2.12
1725
1742
  */
1726
1743
  add_child(builder: Gtk.Builder, child: GObject.Object, type: string | null): void;
1727
1744
 
@@ -1733,6 +1750,7 @@ export namespace GtkSource {
1733
1750
  * @param builder {@link Gtk.Builder} used to construct this object
1734
1751
  * @param name name of child to construct
1735
1752
  * @returns the constructed child
1753
+ * @since 2.12
1736
1754
  */
1737
1755
  construct_child<T = GObject.Object>(builder: Gtk.Builder, name: string): T;
1738
1756
 
@@ -1743,6 +1761,7 @@ export namespace GtkSource {
1743
1761
  * @param child child object or `null` for non-child tags
1744
1762
  * @param tagname the name of the tag
1745
1763
  * @param data user data created in custom_tag_start
1764
+ * @since 2.12
1746
1765
  */
1747
1766
  custom_finished(builder: Gtk.Builder, child: GObject.Object | null, tagname: string, data: null): void;
1748
1767
 
@@ -1753,6 +1772,7 @@ export namespace GtkSource {
1753
1772
  * @param child child object or `null` for non-child tags
1754
1773
  * @param tagname name of tag
1755
1774
  * @param data user data that will be passed in to parser functions
1775
+ * @since 2.12
1756
1776
  */
1757
1777
  custom_tag_end(builder: Gtk.Builder, child: GObject.Object | null, tagname: string, data: null): void;
1758
1778
 
@@ -1762,6 +1782,7 @@ export namespace GtkSource {
1762
1782
  * @param child child object or `null` for non-child tags
1763
1783
  * @param tagname name of tag
1764
1784
  * @returns `true` if a object has a custom implementation, `false` if it doesn't.
1785
+ * @since 2.12
1765
1786
  */
1766
1787
  custom_tag_start(builder: Gtk.Builder, child: GObject.Object | null, tagname: string): [boolean, GLib.MarkupParser, null];
1767
1788
 
@@ -1770,6 +1791,7 @@ export namespace GtkSource {
1770
1791
  * @param builder a {@link Gtk.Builder}
1771
1792
  * @param childname name of child
1772
1793
  * @returns the internal child of the buildable object
1794
+ * @since 2.12
1773
1795
  */
1774
1796
  get_internal_child<T = GObject.Object>(builder: Gtk.Builder, childname: string): T;
1775
1797
 
@@ -1780,6 +1802,7 @@ export namespace GtkSource {
1780
1802
  * [GtkBuilder UI definition][BUILDER-UI]
1781
1803
  * used to construct the `buildable`.
1782
1804
  * @returns the name set with `gtk_buildable_set_name()`
1805
+ * @since 2.12
1783
1806
  */
1784
1807
  get_name(): string;
1785
1808
 
@@ -1790,6 +1813,7 @@ export namespace GtkSource {
1790
1813
  * `gtk_builder_add_from_file()` or `gtk_builder_add_from_string()`
1791
1814
  * is called on a builder.
1792
1815
  * @param builder a {@link Gtk.Builder}
1816
+ * @since 2.12
1793
1817
  */
1794
1818
  parser_finished(builder: Gtk.Builder): void;
1795
1819
 
@@ -1798,12 +1822,14 @@ export namespace GtkSource {
1798
1822
  * @param builder a {@link Gtk.Builder}
1799
1823
  * @param name name of property
1800
1824
  * @param value value of property
1825
+ * @since 2.12
1801
1826
  */
1802
1827
  set_buildable_property(builder: Gtk.Builder, name: string, value: GObject.Value | any): void;
1803
1828
 
1804
1829
  /**
1805
1830
  * Sets the name of the `buildable` object.
1806
1831
  * @param name name to set
1832
+ * @since 2.12
1807
1833
  */
1808
1834
  set_name(name: string): void;
1809
1835
 
@@ -1813,6 +1839,7 @@ export namespace GtkSource {
1813
1839
  * @param builder a {@link Gtk.Builder}
1814
1840
  * @param child child to add
1815
1841
  * @param type kind of child or `null`
1842
+ * @since 2.12
1816
1843
  * @virtual
1817
1844
  */
1818
1845
  vfunc_add_child(builder: Gtk.Builder, child: GObject.Object, type: string | null): void;
@@ -1824,6 +1851,7 @@ export namespace GtkSource {
1824
1851
  * specified in the UI definition.
1825
1852
  * @param builder {@link Gtk.Builder} used to construct this object
1826
1853
  * @param name name of child to construct
1854
+ * @since 2.12
1827
1855
  * @virtual
1828
1856
  */
1829
1857
  vfunc_construct_child<T = GObject.Object>(builder: Gtk.Builder, name: string): T;
@@ -1835,6 +1863,7 @@ export namespace GtkSource {
1835
1863
  * @param child child object or `null` for non-child tags
1836
1864
  * @param tagname the name of the tag
1837
1865
  * @param data user data created in custom_tag_start
1866
+ * @since 2.12
1838
1867
  * @virtual
1839
1868
  */
1840
1869
  vfunc_custom_finished(builder: Gtk.Builder, child: GObject.Object | null, tagname: string, data: null): void;
@@ -1846,6 +1875,7 @@ export namespace GtkSource {
1846
1875
  * @param child child object or `null` for non-child tags
1847
1876
  * @param tagname name of tag
1848
1877
  * @param data user data that will be passed in to parser functions
1878
+ * @since 2.12
1849
1879
  * @virtual
1850
1880
  */
1851
1881
  vfunc_custom_tag_end(builder: Gtk.Builder, child: GObject.Object | null, tagname: string, data: null): void;
@@ -1855,6 +1885,7 @@ export namespace GtkSource {
1855
1885
  * @param builder a {@link Gtk.Builder} used to construct this object
1856
1886
  * @param child child object or `null` for non-child tags
1857
1887
  * @param tagname name of tag
1888
+ * @since 2.12
1858
1889
  * @virtual
1859
1890
  */
1860
1891
  vfunc_custom_tag_start(builder: Gtk.Builder, child: GObject.Object | null, tagname: string): [boolean, GLib.MarkupParser, never];
@@ -1863,6 +1894,7 @@ export namespace GtkSource {
1863
1894
  * Get the internal child called `childname` of the `buildable` object.
1864
1895
  * @param builder a {@link Gtk.Builder}
1865
1896
  * @param childname name of child
1897
+ * @since 2.12
1866
1898
  * @virtual
1867
1899
  */
1868
1900
  vfunc_get_internal_child<T = GObject.Object>(builder: Gtk.Builder, childname: string): T;
@@ -1873,6 +1905,7 @@ export namespace GtkSource {
1873
1905
  * {@link Gtk.Builder} sets the name based on the
1874
1906
  * [GtkBuilder UI definition][BUILDER-UI]
1875
1907
  * used to construct the `buildable`.
1908
+ * @since 2.12
1876
1909
  * @virtual
1877
1910
  */
1878
1911
  vfunc_get_name(): string;
@@ -1884,6 +1917,7 @@ export namespace GtkSource {
1884
1917
  * `gtk_builder_add_from_file()` or `gtk_builder_add_from_string()`
1885
1918
  * is called on a builder.
1886
1919
  * @param builder a {@link Gtk.Builder}
1920
+ * @since 2.12
1887
1921
  * @virtual
1888
1922
  */
1889
1923
  vfunc_parser_finished(builder: Gtk.Builder): void;
@@ -1893,6 +1927,7 @@ export namespace GtkSource {
1893
1927
  * @param builder a {@link Gtk.Builder}
1894
1928
  * @param name name of property
1895
1929
  * @param value value of property
1930
+ * @since 2.12
1896
1931
  * @virtual
1897
1932
  */
1898
1933
  vfunc_set_buildable_property(builder: Gtk.Builder, name: string, value: unknown): void;
@@ -1900,6 +1935,7 @@ export namespace GtkSource {
1900
1935
  /**
1901
1936
  * Sets the name of the `buildable` object.
1902
1937
  * @param name name to set
1938
+ * @since 2.12
1903
1939
  * @virtual
1904
1940
  */
1905
1941
  vfunc_set_name(name: string): void;
@@ -2158,6 +2194,7 @@ export namespace GtkSource {
2158
2194
  /**
2159
2195
  * Get the current content widget.
2160
2196
  * @returns The current content widget.
2197
+ * @deprecated since 3.8: Use `gtk_bin_get_child()` instead.
2161
2198
  */
2162
2199
  get_widget(): Gtk.Widget;
2163
2200
 
@@ -2176,6 +2213,7 @@ export namespace GtkSource {
2176
2213
  * lose a reference and it can be destroyed, so if you do not want this to
2177
2214
  * happen you must use `g_object_ref()` before calling this method.
2178
2215
  * @param widget a {@link Gtk.Widget}.
2216
+ * @deprecated since 3.8: Use `gtk_container_add()` instead. If there is already a child widget, remove it with `gtk_container_remove()`.
2179
2217
  */
2180
2218
  set_widget(widget: Gtk.Widget | null): void;
2181
2219
  }
@@ -2307,42 +2345,50 @@ export namespace GtkSource {
2307
2345
  /**
2308
2346
  * Creates a new {@link GtkSource.CompletionItem}. The desired properties need to be set
2309
2347
  * afterwards.
2348
+ * @since 3.24
2310
2349
  */
2311
2350
  static new2(): CompletionItem;
2312
2351
 
2313
2352
  // Methods
2314
2353
  /**
2315
2354
  * @param gicon the {@link Gio.Icon}, or `null`.
2355
+ * @since 3.24
2316
2356
  */
2317
2357
  set_gicon(gicon: Gio.Icon | null): void;
2318
2358
 
2319
2359
  /**
2320
2360
  * @param icon the {@link GdkPixbuf.Pixbuf}, or `null`.
2361
+ * @since 3.24
2321
2362
  */
2322
2363
  set_icon(icon: GdkPixbuf.Pixbuf | null): void;
2323
2364
 
2324
2365
  /**
2325
2366
  * @param icon_name the icon name, or `null`.
2367
+ * @since 3.24
2326
2368
  */
2327
2369
  set_icon_name(icon_name: string | null): void;
2328
2370
 
2329
2371
  /**
2330
2372
  * @param info the info, or `null`.
2373
+ * @since 3.24
2331
2374
  */
2332
2375
  set_info(info: string | null): void;
2333
2376
 
2334
2377
  /**
2335
2378
  * @param label the label, or `null`.
2379
+ * @since 3.24
2336
2380
  */
2337
2381
  set_label(label: string | null): void;
2338
2382
 
2339
2383
  /**
2340
2384
  * @param markup the markup, or `null`.
2385
+ * @since 3.24
2341
2386
  */
2342
2387
  set_markup(markup: string | null): void;
2343
2388
 
2344
2389
  /**
2345
2390
  * @param text the text, or `null`.
2391
+ * @since 3.24
2346
2392
  */
2347
2393
  set_text(text: string | null): void;
2348
2394
 
@@ -2365,6 +2411,7 @@ export namespace GtkSource {
2365
2411
  /**
2366
2412
  * Gets the {@link Gio.Icon} for the icon of `proposal`.
2367
2413
  * @returns A {@link Gio.Icon} with the icon of `proposal`.
2414
+ * @since 3.18
2368
2415
  */
2369
2416
  get_gicon(): Gio.Icon | null;
2370
2417
 
@@ -2377,6 +2424,7 @@ export namespace GtkSource {
2377
2424
  /**
2378
2425
  * Gets the icon name of `proposal`.
2379
2426
  * @returns The icon name of `proposal`.
2427
+ * @since 3.18
2380
2428
  */
2381
2429
  get_icon_name(): string | null;
2382
2430
 
@@ -2444,6 +2492,7 @@ export namespace GtkSource {
2444
2492
 
2445
2493
  /**
2446
2494
  * Gets the {@link Gio.Icon} for the icon of `proposal`.
2495
+ * @since 3.18
2447
2496
  * @virtual
2448
2497
  */
2449
2498
  vfunc_get_gicon(): Gio.Icon | null;
@@ -2456,6 +2505,7 @@ export namespace GtkSource {
2456
2505
 
2457
2506
  /**
2458
2507
  * Gets the icon name of `proposal`.
2508
+ * @since 3.18
2459
2509
  * @virtual
2460
2510
  */
2461
2511
  vfunc_get_icon_name(): string | null;
@@ -2683,6 +2733,7 @@ export namespace GtkSource {
2683
2733
  /**
2684
2734
  * Gets the {@link Gio.Icon} for the icon of `provider`.
2685
2735
  * @returns The icon to be used for the provider, or `null` if the provider does not have a special icon.
2736
+ * @since 3.18
2686
2737
  */
2687
2738
  get_gicon(): Gio.Icon | null;
2688
2739
 
@@ -2695,6 +2746,7 @@ export namespace GtkSource {
2695
2746
  /**
2696
2747
  * Gets the icon name of `provider`.
2697
2748
  * @returns The icon name to be used for the provider, or `null` if the provider does not have a special icon.
2749
+ * @since 3.18
2698
2750
  */
2699
2751
  get_icon_name(): string | null;
2700
2752
 
@@ -2816,6 +2868,7 @@ export namespace GtkSource {
2816
2868
 
2817
2869
  /**
2818
2870
  * Gets the {@link Gio.Icon} for the icon of `provider`.
2871
+ * @since 3.18
2819
2872
  * @virtual
2820
2873
  */
2821
2874
  vfunc_get_gicon(): Gio.Icon | null;
@@ -2828,6 +2881,7 @@ export namespace GtkSource {
2828
2881
 
2829
2882
  /**
2830
2883
  * Gets the icon name of `provider`.
2884
+ * @since 3.18
2831
2885
  * @virtual
2832
2886
  */
2833
2887
  vfunc_get_icon_name(): string | null;
@@ -3064,11 +3118,13 @@ export namespace GtkSource {
3064
3118
  *
3065
3119
  * Since this function is synchronous, it is advised to call it only on local
3066
3120
  * files. See `gtk_source_file_is_local()`.
3121
+ * @since 3.18
3067
3122
  */
3068
3123
  check_file_on_disk(): void;
3069
3124
 
3070
3125
  /**
3071
3126
  * @returns the compression type.
3127
+ * @since 3.14
3072
3128
  */
3073
3129
  get_compression_type(): CompressionType;
3074
3130
 
@@ -3076,16 +3132,19 @@ export namespace GtkSource {
3076
3132
  * The encoding is initially `null`. After a successful file loading or saving
3077
3133
  * operation, the encoding is non-`null`.
3078
3134
  * @returns the character encoding.
3135
+ * @since 3.14
3079
3136
  */
3080
3137
  get_encoding(): Encoding;
3081
3138
 
3082
3139
  /**
3083
3140
  * @returns the {@link Gio.File}.
3141
+ * @since 3.14
3084
3142
  */
3085
3143
  get_location(): Gio.File;
3086
3144
 
3087
3145
  /**
3088
3146
  * @returns the newline type.
3147
+ * @since 3.14
3089
3148
  */
3090
3149
  get_newline_type(): NewlineType;
3091
3150
 
@@ -3096,6 +3155,7 @@ export namespace GtkSource {
3096
3155
  * To have an up-to-date value, you must first call
3097
3156
  * `gtk_source_file_check_file_on_disk()`.
3098
3157
  * @returns whether the file has been deleted.
3158
+ * @since 3.18
3099
3159
  */
3100
3160
  is_deleted(): boolean;
3101
3161
 
@@ -3106,6 +3166,7 @@ export namespace GtkSource {
3106
3166
  * To have an up-to-date value, you must first call
3107
3167
  * `gtk_source_file_check_file_on_disk()`.
3108
3168
  * @returns whether the file is externally modified.
3169
+ * @since 3.18
3109
3170
  */
3110
3171
  is_externally_modified(): boolean;
3111
3172
 
@@ -3113,6 +3174,7 @@ export namespace GtkSource {
3113
3174
  * Returns whether the file is local. If the {@link GtkSource.File.location} is `null`,
3114
3175
  * returns `false`.
3115
3176
  * @returns whether the file is local.
3177
+ * @since 3.18
3116
3178
  */
3117
3179
  is_local(): boolean;
3118
3180
 
@@ -3123,12 +3185,14 @@ export namespace GtkSource {
3123
3185
  * To have an up-to-date value, you must first call
3124
3186
  * `gtk_source_file_check_file_on_disk()`.
3125
3187
  * @returns whether the file is read-only.
3188
+ * @since 3.18
3126
3189
  */
3127
3190
  is_readonly(): boolean;
3128
3191
 
3129
3192
  /**
3130
3193
  * Sets the location.
3131
3194
  * @param location the new {@link Gio.File}, or `null`.
3195
+ * @since 3.14
3132
3196
  */
3133
3197
  set_location(location: Gio.File | null): void;
3134
3198
  }
@@ -3235,36 +3299,43 @@ export namespace GtkSource {
3235
3299
  // Methods
3236
3300
  /**
3237
3301
  * @returns the {@link GtkSource.Buffer} to load the contents into.
3302
+ * @since 3.14
3238
3303
  */
3239
3304
  get_buffer(): Buffer;
3240
3305
 
3241
3306
  /**
3242
3307
  * @returns the detected compression type.
3308
+ * @since 3.14
3243
3309
  */
3244
3310
  get_compression_type(): CompressionType;
3245
3311
 
3246
3312
  /**
3247
3313
  * @returns the detected file encoding.
3314
+ * @since 3.14
3248
3315
  */
3249
3316
  get_encoding(): Encoding;
3250
3317
 
3251
3318
  /**
3252
3319
  * @returns the {@link GtkSource.File}.
3320
+ * @since 3.14
3253
3321
  */
3254
3322
  get_file(): File;
3255
3323
 
3256
3324
  /**
3257
3325
  * @returns the {@link Gio.InputStream} to load, or `null` if a {@link Gio.File} is used.
3326
+ * @since 3.14
3258
3327
  */
3259
3328
  get_input_stream(): Gio.InputStream | null;
3260
3329
 
3261
3330
  /**
3262
3331
  * @returns the {@link Gio.File} to load, or `null` if an input stream is used.
3332
+ * @since 3.14
3263
3333
  */
3264
3334
  get_location(): Gio.File | null;
3265
3335
 
3266
3336
  /**
3267
3337
  * @returns the detected newline type.
3338
+ * @since 3.14
3268
3339
  */
3269
3340
  get_newline_type(): NewlineType;
3270
3341
 
@@ -3275,6 +3346,7 @@ export namespace GtkSource {
3275
3346
  * @param io_priority the I/O priority of the request. E.g. `G_PRIORITY_LOW`, `G_PRIORITY_DEFAULT` or `G_PRIORITY_HIGH`.
3276
3347
  * @param cancellable optional {@link Gio.Cancellable} object, `null` to ignore.
3277
3348
  * @param progress_callback function to call back with progress information, or `null` if progress information is not needed.
3349
+ * @since 3.14
3278
3350
  */
3279
3351
  load_async(io_priority: number, cancellable: Gio.Cancellable | null, progress_callback: Gio.FileProgressCallback | null): globalThis.Promise<boolean>;
3280
3352
 
@@ -3286,6 +3358,7 @@ export namespace GtkSource {
3286
3358
  * @param cancellable optional {@link Gio.Cancellable} object, `null` to ignore.
3287
3359
  * @param progress_callback function to call back with progress information, or `null` if progress information is not needed.
3288
3360
  * @param callback a {@link Gio.AsyncReadyCallback} to call when the request is satisfied.
3361
+ * @since 3.14
3289
3362
  */
3290
3363
  load_async(io_priority: number, cancellable: Gio.Cancellable | null, progress_callback: Gio.FileProgressCallback | null, callback: Gio.AsyncReadyCallback<this> | null): void;
3291
3364
 
@@ -3297,6 +3370,7 @@ export namespace GtkSource {
3297
3370
  * @param cancellable optional {@link Gio.Cancellable} object, `null` to ignore.
3298
3371
  * @param progress_callback function to call back with progress information, or `null` if progress information is not needed.
3299
3372
  * @param callback a {@link Gio.AsyncReadyCallback} to call when the request is satisfied.
3373
+ * @since 3.14
3300
3374
  */
3301
3375
  load_async(io_priority: number, cancellable: Gio.Cancellable | null, progress_callback: Gio.FileProgressCallback | null, callback?: Gio.AsyncReadyCallback<this> | null): globalThis.Promise<boolean> | void;
3302
3376
 
@@ -3308,6 +3382,7 @@ export namespace GtkSource {
3308
3382
  * type.
3309
3383
  * @param result a {@link Gio.AsyncResult}.
3310
3384
  * @returns whether the contents has been loaded successfully.
3385
+ * @since 3.14
3311
3386
  */
3312
3387
  load_finish(result: Gio.AsyncResult): boolean;
3313
3388
 
@@ -3324,6 +3399,7 @@ export namespace GtkSource {
3324
3399
  * 2. The default candidates as returned by
3325
3400
  * `gtk_source_encoding_get_default_candidates()`.
3326
3401
  * @param candidate_encodings a list of {@link GtkSource.Encoding}<!-- -->s.
3402
+ * @since 3.14
3327
3403
  */
3328
3404
  set_candidate_encodings(candidate_encodings: Encoding[]): void;
3329
3405
  }
@@ -3470,36 +3546,43 @@ export namespace GtkSource {
3470
3546
  // Methods
3471
3547
  /**
3472
3548
  * @returns the {@link GtkSource.Buffer} to save.
3549
+ * @since 3.14
3473
3550
  */
3474
3551
  get_buffer(): Buffer;
3475
3552
 
3476
3553
  /**
3477
3554
  * @returns the compression type.
3555
+ * @since 3.14
3478
3556
  */
3479
3557
  get_compression_type(): CompressionType;
3480
3558
 
3481
3559
  /**
3482
3560
  * @returns the encoding.
3561
+ * @since 3.14
3483
3562
  */
3484
3563
  get_encoding(): Encoding;
3485
3564
 
3486
3565
  /**
3487
3566
  * @returns the {@link GtkSource.File}.
3567
+ * @since 3.14
3488
3568
  */
3489
3569
  get_file(): File;
3490
3570
 
3491
3571
  /**
3492
3572
  * @returns the flags.
3573
+ * @since 3.14
3493
3574
  */
3494
3575
  get_flags(): FileSaverFlags;
3495
3576
 
3496
3577
  /**
3497
3578
  * @returns the {@link Gio.File} where to save the buffer to.
3579
+ * @since 3.14
3498
3580
  */
3499
3581
  get_location(): Gio.File;
3500
3582
 
3501
3583
  /**
3502
3584
  * @returns the newline type.
3585
+ * @since 3.14
3503
3586
  */
3504
3587
  get_newline_type(): NewlineType;
3505
3588
 
@@ -3509,6 +3592,7 @@ export namespace GtkSource {
3509
3592
  * @param io_priority the I/O priority of the request. E.g. `G_PRIORITY_LOW`, `G_PRIORITY_DEFAULT` or `G_PRIORITY_HIGH`.
3510
3593
  * @param cancellable optional {@link Gio.Cancellable} object, `null` to ignore.
3511
3594
  * @param progress_callback function to call back with progress information, or `null` if progress information is not needed.
3595
+ * @since 3.14
3512
3596
  */
3513
3597
  save_async(io_priority: number, cancellable: Gio.Cancellable | null, progress_callback: Gio.FileProgressCallback | null): globalThis.Promise<boolean>;
3514
3598
 
@@ -3519,6 +3603,7 @@ export namespace GtkSource {
3519
3603
  * @param cancellable optional {@link Gio.Cancellable} object, `null` to ignore.
3520
3604
  * @param progress_callback function to call back with progress information, or `null` if progress information is not needed.
3521
3605
  * @param callback a {@link Gio.AsyncReadyCallback} to call when the request is satisfied.
3606
+ * @since 3.14
3522
3607
  */
3523
3608
  save_async(io_priority: number, cancellable: Gio.Cancellable | null, progress_callback: Gio.FileProgressCallback | null, callback: Gio.AsyncReadyCallback<this> | null): void;
3524
3609
 
@@ -3529,6 +3614,7 @@ export namespace GtkSource {
3529
3614
  * @param cancellable optional {@link Gio.Cancellable} object, `null` to ignore.
3530
3615
  * @param progress_callback function to call back with progress information, or `null` if progress information is not needed.
3531
3616
  * @param callback a {@link Gio.AsyncReadyCallback} to call when the request is satisfied.
3617
+ * @since 3.14
3532
3618
  */
3533
3619
  save_async(io_priority: number, cancellable: Gio.Cancellable | null, progress_callback: Gio.FileProgressCallback | null, callback?: Gio.AsyncReadyCallback<this> | null): globalThis.Promise<boolean> | void;
3534
3620
 
@@ -3543,6 +3629,7 @@ export namespace GtkSource {
3543
3629
  * if the file has been saved successfully.
3544
3630
  * @param result a {@link Gio.AsyncResult}.
3545
3631
  * @returns whether the file was saved successfully.
3632
+ * @since 3.14
3546
3633
  */
3547
3634
  save_finish(result: Gio.AsyncResult): boolean;
3548
3635
 
@@ -3550,6 +3637,7 @@ export namespace GtkSource {
3550
3637
  * Sets the compression type. By default the compression type is taken from the
3551
3638
  * {@link GtkSource.File}.
3552
3639
  * @param compression_type the new compression type.
3640
+ * @since 3.14
3553
3641
  */
3554
3642
  set_compression_type(compression_type: CompressionType): void;
3555
3643
 
@@ -3557,11 +3645,13 @@ export namespace GtkSource {
3557
3645
  * Sets the encoding. If `encoding` is `null`, the UTF-8 encoding will be set.
3558
3646
  * By default the encoding is taken from the {@link GtkSource.File}.
3559
3647
  * @param encoding the new encoding, or `null` for UTF-8.
3648
+ * @since 3.14
3560
3649
  */
3561
3650
  set_encoding(encoding: Encoding | null): void;
3562
3651
 
3563
3652
  /**
3564
3653
  * @param flags the new flags.
3654
+ * @since 3.14
3565
3655
  */
3566
3656
  set_flags(flags: FileSaverFlags): void;
3567
3657
 
@@ -3569,6 +3659,7 @@ export namespace GtkSource {
3569
3659
  * Sets the newline type. By default the newline type is taken from the
3570
3660
  * {@link GtkSource.File}.
3571
3661
  * @param newline_type the new newline type.
3662
+ * @since 3.14
3572
3663
  */
3573
3664
  set_newline_type(newline_type: NewlineType): void;
3574
3665
  }
@@ -3667,6 +3758,7 @@ export namespace GtkSource {
3667
3758
  /**
3668
3759
  * @param xpad
3669
3760
  * @param ypad
3761
+ * @deprecated since 3.12: Use `gtk_source_gutter_renderer_get_padding()` instead.
3670
3762
  */
3671
3763
  get_padding(xpad: number, ypad: number): void;
3672
3764
 
@@ -3680,6 +3772,7 @@ export namespace GtkSource {
3680
3772
 
3681
3773
  /**
3682
3774
  * @returns the associated {@link GtkSource.View}.
3775
+ * @since 3.24
3683
3776
  */
3684
3777
  get_view(): View;
3685
3778
 
@@ -3687,11 +3780,14 @@ export namespace GtkSource {
3687
3780
  * Get the {@link Gdk.Window} of the gutter. The window will only be available when the
3688
3781
  * gutter has at least one, non-zero width, cell renderer packed.
3689
3782
  * @returns the {@link Gdk.Window} of the gutter, or `null` if the gutter has no window.
3783
+ * @since 2.8
3784
+ * @deprecated since 3.12: Use `gtk_text_view_get_window()` instead.
3690
3785
  */
3691
3786
  get_window(): Gdk.Window;
3692
3787
 
3693
3788
  /**
3694
3789
  * @returns the {@link Gtk.TextWindowType} of `gutter`.
3790
+ * @since 3.24
3695
3791
  */
3696
3792
  get_window_type(): Gtk.TextWindowType;
3697
3793
 
@@ -3702,18 +3798,21 @@ export namespace GtkSource {
3702
3798
  * @param renderer a gutter renderer (must inherit from {@link GtkSource.GutterRenderer}).
3703
3799
  * @param position the renderer position.
3704
3800
  * @returns `true` if operation succeeded. Otherwise `false`.
3801
+ * @since 3.0
3705
3802
  */
3706
3803
  insert(renderer: GutterRenderer, position: number): boolean;
3707
3804
 
3708
3805
  /**
3709
3806
  * Invalidates the drawable area of the gutter. You can use this to force a
3710
3807
  * redraw of the gutter if something has changed and needs to be redrawn.
3808
+ * @since 2.8
3711
3809
  */
3712
3810
  queue_draw(): void;
3713
3811
 
3714
3812
  /**
3715
3813
  * Removes `renderer` from `gutter`.
3716
3814
  * @param renderer a {@link GtkSource.GutterRenderer}.
3815
+ * @since 2.8
3717
3816
  */
3718
3817
  remove(renderer: GutterRenderer): void;
3719
3818
 
@@ -3721,12 +3820,14 @@ export namespace GtkSource {
3721
3820
  * Reorders `renderer` in `gutter` to new `position`.
3722
3821
  * @param renderer a {@link Gtk.CellRenderer}.
3723
3822
  * @param position the new renderer position.
3823
+ * @since 2.8
3724
3824
  */
3725
3825
  reorder(renderer: GutterRenderer, position: number): void;
3726
3826
 
3727
3827
  /**
3728
3828
  * @param xpad
3729
3829
  * @param ypad
3830
+ * @deprecated since 3.12: Use `gtk_source_gutter_renderer_set_padding()` instead.
3730
3831
  */
3731
3832
  set_padding(xpad: number, ypad: number): void;
3732
3833
  }
@@ -4370,6 +4471,7 @@ export namespace GtkSource {
4370
4471
 
4371
4472
  /**
4372
4473
  * @returns the stock id.
4474
+ * @deprecated since 3.10: Don't use this function.
4373
4475
  */
4374
4476
  get_stock_id(): string;
4375
4477
 
@@ -4390,6 +4492,7 @@ export namespace GtkSource {
4390
4492
 
4391
4493
  /**
4392
4494
  * @param stock_id the stock id
4495
+ * @deprecated since 3.10: Don't use this function.
4393
4496
  */
4394
4497
  set_stock_id(stock_id: string | null): void;
4395
4498
  }
@@ -4634,6 +4737,7 @@ export namespace GtkSource {
4634
4737
  * is not present in the current style scheme.
4635
4738
  * @param style_id a style ID.
4636
4739
  * @returns the ID of the style to use if the specified `style_id` is not present in the current style scheme or `null` if the style has no fallback defined. The returned string is owned by the `language` and must not be modified.
4740
+ * @since 3.4
4637
4741
  */
4638
4742
  get_style_fallback(style_id: string): string | null;
4639
4743
 
@@ -4783,6 +4887,7 @@ export namespace GtkSource {
4783
4887
  * @param filename a filename in Glib filename encoding, or `null`.
4784
4888
  * @param content_type a content type (as in GIO API), or `null`.
4785
4889
  * @returns a {@link GtkSource.Language}, or `null` if there is no suitable language for given `filename` and/or `content_type`. Return value is owned by `lm` and should not be freed.
4890
+ * @since 2.4
4786
4891
  */
4787
4892
  guess_language(filename: string | null, content_type: string | null): Language | null;
4788
4893
 
@@ -4948,12 +5053,14 @@ export namespace GtkSource {
4948
5053
  /**
4949
5054
  * Gets the {@link GtkSource.Map.view} property, which is the view this widget is mapping.
4950
5055
  * @returns a {@link GtkSource.View} or `null`.
5056
+ * @since 3.18
4951
5057
  */
4952
5058
  get_view(): View | null;
4953
5059
 
4954
5060
  /**
4955
5061
  * Sets the view that `map` will be doing the mapping to.
4956
5062
  * @param view a {@link GtkSource.View}
5063
+ * @since 3.18
4957
5064
  */
4958
5065
  set_view(view: View): void;
4959
5066
  }
@@ -5024,6 +5131,7 @@ export namespace GtkSource {
5024
5131
  /**
5025
5132
  * Returns the mark category.
5026
5133
  * @returns the category of the {@link GtkSource.Mark}.
5134
+ * @since 2.2
5027
5135
  */
5028
5136
  get_category(): string;
5029
5137
 
@@ -5034,6 +5142,7 @@ export namespace GtkSource {
5034
5142
  * If `category` is `null`, looks for marks of any category.
5035
5143
  * @param category a string specifying the mark category, or `null`.
5036
5144
  * @returns the next {@link GtkSource.Mark}, or `null`.
5145
+ * @since 2.2
5037
5146
  */
5038
5147
  next(category: string | null): Mark | null;
5039
5148
 
@@ -5044,6 +5153,7 @@ export namespace GtkSource {
5044
5153
  * If `category` is `null`, looks for marks of any category
5045
5154
  * @param category a string specifying the mark category, or `null`.
5046
5155
  * @returns the previous {@link GtkSource.Mark}, or `null`.
5156
+ * @since 2.2
5047
5157
  */
5048
5158
  prev(category: string): Mark | null;
5049
5159
  }
@@ -5201,6 +5311,7 @@ export namespace GtkSource {
5201
5311
  * Gets a stock id of an icon used by this attributes. Note that the stock id can
5202
5312
  * be `null` if it wasn't set earlier.
5203
5313
  * @returns Stock id. Returned string is owned by `attributes` and shouldn't be freed.
5314
+ * @deprecated since 3.10: Don't use this function.
5204
5315
  */
5205
5316
  get_stock_id(): string;
5206
5317
 
@@ -5261,6 +5372,7 @@ export namespace GtkSource {
5261
5372
  /**
5262
5373
  * Sets stock id to be used as a base for rendered icon.
5263
5374
  * @param stock_id a stock id.
5375
+ * @deprecated since 3.10: Don't use this function.
5264
5376
  */
5265
5377
  set_stock_id(stock_id: string): void;
5266
5378
  }
@@ -5686,6 +5798,7 @@ export namespace GtkSource {
5686
5798
  * Returns the name of the font used to print the text body. The returned string
5687
5799
  * must be freed with `g_free()`.
5688
5800
  * @returns a new string containing the name of the font used to print the text body.
5801
+ * @since 2.2
5689
5802
  */
5690
5803
  get_body_font_name(): string;
5691
5804
 
@@ -5693,6 +5806,7 @@ export namespace GtkSource {
5693
5806
  * Gets the bottom margin in units of `unit`.
5694
5807
  * @param unit the unit for the return value.
5695
5808
  * @returns the bottom margin.
5809
+ * @since 2.2
5696
5810
  */
5697
5811
  get_bottom_margin(unit: Gtk.Unit): number;
5698
5812
 
@@ -5701,6 +5815,7 @@ export namespace GtkSource {
5701
5815
  * object reference is owned by the compositor object and
5702
5816
  * should not be unreferenced.
5703
5817
  * @returns the {@link GtkSource.Buffer} associated with the compositor.
5818
+ * @since 2.2
5704
5819
  */
5705
5820
  get_buffer(): Buffer;
5706
5821
 
@@ -5708,6 +5823,7 @@ export namespace GtkSource {
5708
5823
  * Returns the name of the font used to print the page footer.
5709
5824
  * The returned string must be freed with `g_free()`.
5710
5825
  * @returns a new string containing the name of the font used to print the page footer.
5826
+ * @since 2.2
5711
5827
  */
5712
5828
  get_footer_font_name(): string;
5713
5829
 
@@ -5715,6 +5831,7 @@ export namespace GtkSource {
5715
5831
  * Returns the name of the font used to print the page header.
5716
5832
  * The returned string must be freed with `g_free()`.
5717
5833
  * @returns a new string containing the name of the font used to print the page header.
5834
+ * @since 2.2
5718
5835
  */
5719
5836
  get_header_font_name(): string;
5720
5837
 
@@ -5723,6 +5840,7 @@ export namespace GtkSource {
5723
5840
  * buffer rules. Note that highlighting will happen
5724
5841
  * only if the buffer to print has highlighting activated.
5725
5842
  * @returns `true` if the printed output will be highlighted.
5843
+ * @since 2.2
5726
5844
  */
5727
5845
  get_highlight_syntax(): boolean;
5728
5846
 
@@ -5730,6 +5848,7 @@ export namespace GtkSource {
5730
5848
  * Gets the left margin in units of `unit`.
5731
5849
  * @param unit the unit for the return value.
5732
5850
  * @returns the left margin
5851
+ * @since 2.2
5733
5852
  */
5734
5853
  get_left_margin(unit: Gtk.Unit): number;
5735
5854
 
@@ -5737,6 +5856,7 @@ export namespace GtkSource {
5737
5856
  * Returns the name of the font used to print line numbers on the left margin.
5738
5857
  * The returned string must be freed with `g_free()`.
5739
5858
  * @returns a new string containing the name of the font used to print line numbers on the left margin.
5859
+ * @since 2.2
5740
5860
  */
5741
5861
  get_line_numbers_font_name(): string;
5742
5862
 
@@ -5744,12 +5864,14 @@ export namespace GtkSource {
5744
5864
  * Returns the number of pages in the document or <code>-1</code> if the
5745
5865
  * document has not been completely paginated.
5746
5866
  * @returns the number of pages in the document or <code>-1</code> if the document has not been completely paginated.
5867
+ * @since 2.2
5747
5868
  */
5748
5869
  get_n_pages(): number;
5749
5870
 
5750
5871
  /**
5751
5872
  * Returns the current fraction of the document pagination that has been completed.
5752
5873
  * @returns a fraction from 0.0 to 1.0 inclusive.
5874
+ * @since 2.2
5753
5875
  */
5754
5876
  get_pagination_progress(): number;
5755
5877
 
@@ -5759,6 +5881,7 @@ export namespace GtkSource {
5759
5881
  * <emphasis>and</emphasis> some format strings have been specified
5760
5882
  * with `gtk_source_print_compositor_set_footer_format()`.
5761
5883
  * @returns `true` if the footer is set to be printed.
5884
+ * @since 2.2
5762
5885
  */
5763
5886
  get_print_footer(): boolean;
5764
5887
 
@@ -5768,6 +5891,7 @@ export namespace GtkSource {
5768
5891
  * <emphasis>and</emphasis> some format strings have been specified
5769
5892
  * with `gtk_source_print_compositor_set_header_format()`.
5770
5893
  * @returns `true` if the header is set to be printed.
5894
+ * @since 2.2
5771
5895
  */
5772
5896
  get_print_header(): boolean;
5773
5897
 
@@ -5776,6 +5900,7 @@ export namespace GtkSource {
5776
5900
  * value is 0, no line numbers will be printed. The default value is
5777
5901
  * 1 (i.e. numbers printed in all lines).
5778
5902
  * @returns the interval of printed line numbers.
5903
+ * @since 2.2
5779
5904
  */
5780
5905
  get_print_line_numbers(): number;
5781
5906
 
@@ -5783,12 +5908,14 @@ export namespace GtkSource {
5783
5908
  * Gets the right margin in units of `unit`.
5784
5909
  * @param unit the unit for the return value.
5785
5910
  * @returns the right margin.
5911
+ * @since 2.2
5786
5912
  */
5787
5913
  get_right_margin(unit: Gtk.Unit): number;
5788
5914
 
5789
5915
  /**
5790
5916
  * Returns the width of tabulation in characters for printed text.
5791
5917
  * @returns width of tab.
5918
+ * @since 2.2
5792
5919
  */
5793
5920
  get_tab_width(): number;
5794
5921
 
@@ -5796,12 +5923,14 @@ export namespace GtkSource {
5796
5923
  * Gets the top margin in units of `unit`.
5797
5924
  * @param unit the unit for the return value.
5798
5925
  * @returns the top margin.
5926
+ * @since 2.2
5799
5927
  */
5800
5928
  get_top_margin(unit: Gtk.Unit): number;
5801
5929
 
5802
5930
  /**
5803
5931
  * Gets the line wrapping mode for the printed text.
5804
5932
  * @returns the line wrap mode.
5933
+ * @since 2.2
5805
5934
  */
5806
5935
  get_wrap_mode(): Gtk.WrapMode;
5807
5936
 
@@ -5868,6 +5997,7 @@ export namespace GtkSource {
5868
5997
  * </programlisting></informalexample>
5869
5998
  * @param context the {@link Gtk.PrintContext} whose parameters (e.g. paper size, print margins, etc.) are used by the the `compositor` to paginate the document.
5870
5999
  * @returns `true` if the document has been completely paginated, `false` otherwise.
6000
+ * @since 2.2
5871
6001
  */
5872
6002
  paginate(context: Gtk.PrintContext): boolean;
5873
6003
 
@@ -5882,6 +6012,7 @@ export namespace GtkSource {
5882
6012
  * This function cannot be called anymore after the first call to the
5883
6013
  * `gtk_source_print_compositor_paginate()` function.
5884
6014
  * @param font_name the name of the default font for the body text.
6015
+ * @since 2.2
5885
6016
  */
5886
6017
  set_body_font_name(font_name: string): void;
5887
6018
 
@@ -5889,6 +6020,7 @@ export namespace GtkSource {
5889
6020
  * Sets the bottom margin used by `compositor`.
5890
6021
  * @param margin the new bottom margin in units of `unit`.
5891
6022
  * @param unit the units for `margin`.
6023
+ * @since 2.2
5892
6024
  */
5893
6025
  set_bottom_margin(margin: number, unit: Gtk.Unit): void;
5894
6026
 
@@ -5905,6 +6037,7 @@ export namespace GtkSource {
5905
6037
  * This function cannot be called anymore after the first call to the
5906
6038
  * `gtk_source_print_compositor_paginate()` function.
5907
6039
  * @param font_name the name of the font for the footer text, or `null`.
6040
+ * @since 2.2
5908
6041
  */
5909
6042
  set_footer_font_name(font_name: string | null): void;
5910
6043
 
@@ -5915,6 +6048,7 @@ export namespace GtkSource {
5915
6048
  * @param left a format string to print on the left of the footer.
5916
6049
  * @param center a format string to print on the center of the footer.
5917
6050
  * @param right a format string to print on the right of the footer.
6051
+ * @since 2.2
5918
6052
  */
5919
6053
  set_footer_format(separator: boolean, left: string | null, center: string | null, right: string | null): void;
5920
6054
 
@@ -5931,6 +6065,7 @@ export namespace GtkSource {
5931
6065
  * This function cannot be called anymore after the first call to the
5932
6066
  * `gtk_source_print_compositor_paginate()` function.
5933
6067
  * @param font_name the name of the font for header text, or `null`.
6068
+ * @since 2.2
5934
6069
  */
5935
6070
  set_header_font_name(font_name: string | null): void;
5936
6071
 
@@ -5960,6 +6095,7 @@ export namespace GtkSource {
5960
6095
  * @param left a format string to print on the left of the header.
5961
6096
  * @param center a format string to print on the center of the header.
5962
6097
  * @param right a format string to print on the right of the header.
6098
+ * @since 2.2
5963
6099
  */
5964
6100
  set_header_format(separator: boolean, left: string | null, center: string | null, right: string | null): void;
5965
6101
 
@@ -5970,6 +6106,7 @@ export namespace GtkSource {
5970
6106
  * This function cannot be called anymore after the first call to the
5971
6107
  * `gtk_source_print_compositor_paginate()` function.
5972
6108
  * @param highlight whether syntax should be highlighted.
6109
+ * @since 2.2
5973
6110
  */
5974
6111
  set_highlight_syntax(highlight: boolean): void;
5975
6112
 
@@ -5977,6 +6114,7 @@ export namespace GtkSource {
5977
6114
  * Sets the left margin used by `compositor`.
5978
6115
  * @param margin the new left margin in units of `unit`.
5979
6116
  * @param unit the units for `margin`.
6117
+ * @since 2.2
5980
6118
  */
5981
6119
  set_left_margin(margin: number, unit: Gtk.Unit): void;
5982
6120
 
@@ -5993,6 +6131,7 @@ export namespace GtkSource {
5993
6131
  * This function cannot be called anymore after the first call to the
5994
6132
  * `gtk_source_print_compositor_paginate()` function.
5995
6133
  * @param font_name the name of the font for line numbers, or `null`.
6134
+ * @since 2.2
5996
6135
  */
5997
6136
  set_line_numbers_font_name(font_name: string | null): void;
5998
6137
 
@@ -6008,6 +6147,7 @@ export namespace GtkSource {
6008
6147
  * This function cannot be called anymore after the first call to the
6009
6148
  * `gtk_source_print_compositor_paginate()` function.
6010
6149
  * @param print `true` if you want the footer to be printed.
6150
+ * @since 2.2
6011
6151
  */
6012
6152
  set_print_footer(print: boolean): void;
6013
6153
 
@@ -6023,6 +6163,7 @@ export namespace GtkSource {
6023
6163
  * This function cannot be called anymore after the first call to the
6024
6164
  * `gtk_source_print_compositor_paginate()` function.
6025
6165
  * @param print `true` if you want the header to be printed.
6166
+ * @since 2.2
6026
6167
  */
6027
6168
  set_print_header(print: boolean): void;
6028
6169
 
@@ -6036,6 +6177,7 @@ export namespace GtkSource {
6036
6177
  * This function cannot be called anymore after the first call to the
6037
6178
  * `gtk_source_print_compositor_paginate()` function.
6038
6179
  * @param interval interval for printed line numbers.
6180
+ * @since 2.2
6039
6181
  */
6040
6182
  set_print_line_numbers(interval: number): void;
6041
6183
 
@@ -6043,6 +6185,7 @@ export namespace GtkSource {
6043
6185
  * Sets the right margin used by `compositor`.
6044
6186
  * @param margin the new right margin in units of `unit`.
6045
6187
  * @param unit the units for `margin`.
6188
+ * @since 2.2
6046
6189
  */
6047
6190
  set_right_margin(margin: number, unit: Gtk.Unit): void;
6048
6191
 
@@ -6052,6 +6195,7 @@ export namespace GtkSource {
6052
6195
  * This function cannot be called anymore after the first call to the
6053
6196
  * `gtk_source_print_compositor_paginate()` function.
6054
6197
  * @param width width of tab in characters.
6198
+ * @since 2.2
6055
6199
  */
6056
6200
  set_tab_width(width: number): void;
6057
6201
 
@@ -6059,6 +6203,7 @@ export namespace GtkSource {
6059
6203
  * Sets the top margin used by `compositor`.
6060
6204
  * @param margin the new top margin in units of `unit`
6061
6205
  * @param unit the units for `margin`
6206
+ * @since 2.2
6062
6207
  */
6063
6208
  set_top_margin(margin: number, unit: Gtk.Unit): void;
6064
6209
 
@@ -6068,6 +6213,7 @@ export namespace GtkSource {
6068
6213
  * This function cannot be called anymore after the first call to the
6069
6214
  * `gtk_source_print_compositor_paginate()` function.
6070
6215
  * @param wrap_mode a {@link Gtk.WrapMode}.
6216
+ * @since 2.2
6071
6217
  */
6072
6218
  set_wrap_mode(wrap_mode: Gtk.WrapMode): void;
6073
6219
  }
@@ -6133,6 +6279,7 @@ export namespace GtkSource {
6133
6279
  /**
6134
6280
  * Adds `region_to_add` to `region`. `region_to_add` is not modified.
6135
6281
  * @param region_to_add the {@link GtkSource.Region} to add to `region`, or `null`.
6282
+ * @since 3.22
6136
6283
  */
6137
6284
  add_region(region_to_add: Region | null): void;
6138
6285
 
@@ -6140,23 +6287,27 @@ export namespace GtkSource {
6140
6287
  * Adds the subregion delimited by `_start` and `_end` to `region`.
6141
6288
  * @param _start the start of the subregion.
6142
6289
  * @param _end the end of the subregion.
6290
+ * @since 3.22
6143
6291
  */
6144
6292
  add_subregion(_start: Gtk.TextIter, _end: Gtk.TextIter): void;
6145
6293
 
6146
6294
  /**
6147
6295
  * Gets the `start` and `end` bounds of the `region`.
6148
6296
  * @returns `true` if `start` and `end` have been set successfully (if non-`null`), or `false` if the `region` is empty.
6297
+ * @since 3.22
6149
6298
  */
6150
6299
  get_bounds(): [boolean, Gtk.TextIter | null, Gtk.TextIter | null];
6151
6300
 
6152
6301
  /**
6153
6302
  * @returns the {@link Gtk.TextBuffer}.
6303
+ * @since 3.22
6154
6304
  */
6155
6305
  get_buffer(): Gtk.TextBuffer | null;
6156
6306
 
6157
6307
  /**
6158
6308
  * Initializes a {@link GtkSource.RegionIter} to the first subregion of `region`. If
6159
6309
  * `region` is empty, `iter` will be initialized to the end iterator.
6310
+ * @since 3.22
6160
6311
  */
6161
6312
  get_start_region_iter(): RegionIter;
6162
6313
 
@@ -6165,6 +6316,7 @@ export namespace GtkSource {
6165
6316
  * `region2` are not modified.
6166
6317
  * @param region2 a {@link GtkSource.Region}, or `null`.
6167
6318
  * @returns the intersection as a {@link GtkSource.Region} object.
6319
+ * @since 3.22
6168
6320
  */
6169
6321
  intersect_region(region2: Region | null): Region | null;
6170
6322
 
@@ -6174,12 +6326,14 @@ export namespace GtkSource {
6174
6326
  * @param _start the start of the subregion.
6175
6327
  * @param _end the end of the subregion.
6176
6328
  * @returns the intersection as a new {@link GtkSource.Region}.
6329
+ * @since 3.22
6177
6330
  */
6178
6331
  intersect_subregion(_start: Gtk.TextIter, _end: Gtk.TextIter): Region | null;
6179
6332
 
6180
6333
  /**
6181
6334
  * Returns whether the `region` is empty. A `null` `region` is considered empty.
6182
6335
  * @returns whether the `region` is empty.
6336
+ * @since 3.22
6183
6337
  */
6184
6338
  is_empty(): boolean;
6185
6339
 
@@ -6187,6 +6341,7 @@ export namespace GtkSource {
6187
6341
  * Subtracts `region_to_subtract` from `region`. `region_to_subtract` is not
6188
6342
  * modified.
6189
6343
  * @param region_to_subtract the {@link GtkSource.Region} to subtract from `region`, or `null`.
6344
+ * @since 3.22
6190
6345
  */
6191
6346
  subtract_region(region_to_subtract: Region | null): void;
6192
6347
 
@@ -6194,6 +6349,7 @@ export namespace GtkSource {
6194
6349
  * Subtracts the subregion delimited by `_start` and `_end` from `region`.
6195
6350
  * @param _start the start of the subregion.
6196
6351
  * @param _end the end of the subregion.
6352
+ * @since 3.22
6197
6353
  */
6198
6354
  subtract_subregion(_start: Gtk.TextIter, _end: Gtk.TextIter): void;
6199
6355
 
@@ -6203,6 +6359,7 @@ export namespace GtkSource {
6203
6359
  * The returned string contains the character offsets of the subregions. It
6204
6360
  * doesn't include a newline character at the end of the string.
6205
6361
  * @returns a string represention of `region`. Free with `g_free()` when no longer needed.
6362
+ * @since 3.22
6206
6363
  */
6207
6364
  to_string(): string | null;
6208
6365
  }
@@ -6352,6 +6509,8 @@ export namespace GtkSource {
6352
6509
  * that the `buffer` is small, this function is more convenient to use.
6353
6510
  * @param iter start of search.
6354
6511
  * @returns whether a match was found.
6512
+ * @since 3.10
6513
+ * @deprecated since 3.22: Use `gtk_source_search_context_backward2()` instead.
6355
6514
  */
6356
6515
  backward(iter: Gtk.TextIter): [boolean, Gtk.TextIter | null, Gtk.TextIter | null];
6357
6516
 
@@ -6371,6 +6530,7 @@ export namespace GtkSource {
6371
6530
  * the same value as the {@link GtkSource.SearchSettings.wrap_around} property.
6372
6531
  * @param iter start of search.
6373
6532
  * @returns whether a match was found.
6533
+ * @since 3.22
6374
6534
  */
6375
6535
  backward2(iter: Gtk.TextIter): [boolean, Gtk.TextIter | null, Gtk.TextIter | null, boolean];
6376
6536
 
@@ -6387,6 +6547,7 @@ export namespace GtkSource {
6387
6547
  * ownership of `cancellable`, so you can unref it after calling this function.
6388
6548
  * @param iter start of search.
6389
6549
  * @param cancellable a {@link Gio.Cancellable}, or `null`.
6550
+ * @since 3.10
6390
6551
  */
6391
6552
  backward_async(iter: Gtk.TextIter, cancellable: Gio.Cancellable | null): globalThis.Promise<[Gtk.TextIter | null, Gtk.TextIter | null]>;
6392
6553
 
@@ -6404,6 +6565,7 @@ export namespace GtkSource {
6404
6565
  * @param iter start of search.
6405
6566
  * @param cancellable a {@link Gio.Cancellable}, or `null`.
6406
6567
  * @param callback a {@link Gio.AsyncReadyCallback} to call when the operation is finished.
6568
+ * @since 3.10
6407
6569
  */
6408
6570
  backward_async(iter: Gtk.TextIter, cancellable: Gio.Cancellable | null, callback: Gio.AsyncReadyCallback<this> | null): void;
6409
6571
 
@@ -6421,6 +6583,7 @@ export namespace GtkSource {
6421
6583
  * @param iter start of search.
6422
6584
  * @param cancellable a {@link Gio.Cancellable}, or `null`.
6423
6585
  * @param callback a {@link Gio.AsyncReadyCallback} to call when the operation is finished.
6586
+ * @since 3.10
6424
6587
  */
6425
6588
  backward_async(iter: Gtk.TextIter, cancellable: Gio.Cancellable | null, callback?: Gio.AsyncReadyCallback<this> | null): globalThis.Promise<[Gtk.TextIter | null, Gtk.TextIter | null]> | void;
6426
6589
 
@@ -6429,6 +6592,8 @@ export namespace GtkSource {
6429
6592
  * `gtk_source_search_context_backward_async()`.
6430
6593
  * @param result a {@link Gio.AsyncResult}.
6431
6594
  * @returns whether a match was found.
6595
+ * @since 3.10
6596
+ * @deprecated since 3.22: Use `gtk_source_search_context_backward_finish2()` instead.
6432
6597
  */
6433
6598
  backward_finish(result: Gio.AsyncResult): [boolean, Gtk.TextIter | null, Gtk.TextIter | null];
6434
6599
 
@@ -6440,6 +6605,7 @@ export namespace GtkSource {
6440
6605
  * details.
6441
6606
  * @param result a {@link Gio.AsyncResult}.
6442
6607
  * @returns whether a match was found.
6608
+ * @since 3.22
6443
6609
  */
6444
6610
  backward_finish2(result: Gio.AsyncResult): [boolean, Gtk.TextIter | null, Gtk.TextIter | null, boolean];
6445
6611
 
@@ -6449,6 +6615,8 @@ export namespace GtkSource {
6449
6615
  * that the `buffer` is small, this function is more convenient to use.
6450
6616
  * @param iter start of search.
6451
6617
  * @returns whether a match was found.
6618
+ * @since 3.10
6619
+ * @deprecated since 3.22: Use `gtk_source_search_context_forward2()` instead.
6452
6620
  */
6453
6621
  forward(iter: Gtk.TextIter): [boolean, Gtk.TextIter | null, Gtk.TextIter | null];
6454
6622
 
@@ -6468,6 +6636,7 @@ export namespace GtkSource {
6468
6636
  * the same value as the {@link GtkSource.SearchSettings.wrap_around} property.
6469
6637
  * @param iter start of search.
6470
6638
  * @returns whether a match was found.
6639
+ * @since 3.22
6471
6640
  */
6472
6641
  forward2(iter: Gtk.TextIter): [boolean, Gtk.TextIter | null, Gtk.TextIter | null, boolean];
6473
6642
 
@@ -6484,6 +6653,7 @@ export namespace GtkSource {
6484
6653
  * ownership of `cancellable`, so you can unref it after calling this function.
6485
6654
  * @param iter start of search.
6486
6655
  * @param cancellable a {@link Gio.Cancellable}, or `null`.
6656
+ * @since 3.10
6487
6657
  */
6488
6658
  forward_async(iter: Gtk.TextIter, cancellable: Gio.Cancellable | null): globalThis.Promise<[Gtk.TextIter | null, Gtk.TextIter | null]>;
6489
6659
 
@@ -6501,6 +6671,7 @@ export namespace GtkSource {
6501
6671
  * @param iter start of search.
6502
6672
  * @param cancellable a {@link Gio.Cancellable}, or `null`.
6503
6673
  * @param callback a {@link Gio.AsyncReadyCallback} to call when the operation is finished.
6674
+ * @since 3.10
6504
6675
  */
6505
6676
  forward_async(iter: Gtk.TextIter, cancellable: Gio.Cancellable | null, callback: Gio.AsyncReadyCallback<this> | null): void;
6506
6677
 
@@ -6518,6 +6689,7 @@ export namespace GtkSource {
6518
6689
  * @param iter start of search.
6519
6690
  * @param cancellable a {@link Gio.Cancellable}, or `null`.
6520
6691
  * @param callback a {@link Gio.AsyncReadyCallback} to call when the operation is finished.
6692
+ * @since 3.10
6521
6693
  */
6522
6694
  forward_async(iter: Gtk.TextIter, cancellable: Gio.Cancellable | null, callback?: Gio.AsyncReadyCallback<this> | null): globalThis.Promise<[Gtk.TextIter | null, Gtk.TextIter | null]> | void;
6523
6695
 
@@ -6526,6 +6698,8 @@ export namespace GtkSource {
6526
6698
  * `gtk_source_search_context_forward_async()`.
6527
6699
  * @param result a {@link Gio.AsyncResult}.
6528
6700
  * @returns whether a match was found.
6701
+ * @since 3.10
6702
+ * @deprecated since 3.22: Use `gtk_source_search_context_forward_finish2()` instead.
6529
6703
  */
6530
6704
  forward_finish(result: Gio.AsyncResult): [boolean, Gtk.TextIter | null, Gtk.TextIter | null];
6531
6705
 
@@ -6537,21 +6711,25 @@ export namespace GtkSource {
6537
6711
  * details.
6538
6712
  * @param result a {@link Gio.AsyncResult}.
6539
6713
  * @returns whether a match was found.
6714
+ * @since 3.22
6540
6715
  */
6541
6716
  forward_finish2(result: Gio.AsyncResult): [boolean, Gtk.TextIter | null, Gtk.TextIter | null, boolean];
6542
6717
 
6543
6718
  /**
6544
6719
  * @returns the associated buffer.
6720
+ * @since 3.10
6545
6721
  */
6546
6722
  get_buffer(): Buffer;
6547
6723
 
6548
6724
  /**
6549
6725
  * @returns whether to highlight the search occurrences.
6726
+ * @since 3.10
6550
6727
  */
6551
6728
  get_highlight(): boolean;
6552
6729
 
6553
6730
  /**
6554
6731
  * @returns the {@link GtkSource.Style} to apply on search matches.
6732
+ * @since 3.16
6555
6733
  */
6556
6734
  get_match_style(): Style;
6557
6735
 
@@ -6563,6 +6741,7 @@ export namespace GtkSource {
6563
6741
  * @param match_start the start of the occurrence.
6564
6742
  * @param match_end the end of the occurrence.
6565
6743
  * @returns the position of the search occurrence. The first occurrence has the position 1 (not 0). Returns 0 if `match_start` and `match_end` don't delimit an occurrence. Returns -1 if the position is not yet known.
6744
+ * @since 3.10
6566
6745
  */
6567
6746
  get_occurrence_position(match_start: Gtk.TextIter, match_end: Gtk.TextIter): number;
6568
6747
 
@@ -6571,6 +6750,7 @@ export namespace GtkSource {
6571
6750
  * fully scanned, the total number of occurrences is unknown, and -1 is
6572
6751
  * returned.
6573
6752
  * @returns the total number of search occurrences, or -1 if unknown.
6753
+ * @since 3.10
6574
6754
  */
6575
6755
  get_occurrences_count(): number;
6576
6756
 
@@ -6581,11 +6761,13 @@ export namespace GtkSource {
6581
6761
  *
6582
6762
  * Free the return value with `g_error_free()`.
6583
6763
  * @returns the {@link GLib.Error}, or `null` if the pattern is valid.
6764
+ * @since 3.10
6584
6765
  */
6585
6766
  get_regex_error(): GLib.Error | null;
6586
6767
 
6587
6768
  /**
6588
6769
  * @returns the search settings.
6770
+ * @since 3.10
6589
6771
  */
6590
6772
  get_settings(): SearchSettings;
6591
6773
 
@@ -6601,6 +6783,8 @@ export namespace GtkSource {
6601
6783
  * @param replace the replacement text.
6602
6784
  * @param replace_length the length of `replace` in bytes, or -1.
6603
6785
  * @returns whether the match has been replaced.
6786
+ * @since 3.10
6787
+ * @deprecated since 3.22: Use `gtk_source_search_context_replace2()` instead.
6604
6788
  */
6605
6789
  replace(match_start: Gtk.TextIter, match_end: Gtk.TextIter, replace: string, replace_length: number): boolean;
6606
6790
 
@@ -6619,6 +6803,7 @@ export namespace GtkSource {
6619
6803
  * @param replace the replacement text.
6620
6804
  * @param replace_length the length of `replace` in bytes, or -1.
6621
6805
  * @returns whether the match has been replaced.
6806
+ * @since 3.22
6622
6807
  */
6623
6808
  replace2(match_start: Gtk.TextIter, match_end: Gtk.TextIter, replace: string, replace_length: number): boolean;
6624
6809
 
@@ -6632,12 +6817,14 @@ export namespace GtkSource {
6632
6817
  * @param replace the replacement text.
6633
6818
  * @param replace_length the length of `replace` in bytes, or -1.
6634
6819
  * @returns the number of replaced matches.
6820
+ * @since 3.10
6635
6821
  */
6636
6822
  replace_all(replace: string, replace_length: number): number;
6637
6823
 
6638
6824
  /**
6639
6825
  * Enables or disables the search occurrences highlighting.
6640
6826
  * @param highlight the setting.
6827
+ * @since 3.10
6641
6828
  */
6642
6829
  set_highlight(highlight: boolean): void;
6643
6830
 
@@ -6647,6 +6834,7 @@ export namespace GtkSource {
6647
6834
  * To enable or disable the search highlighting, use
6648
6835
  * `gtk_source_search_context_set_highlight()`.
6649
6836
  * @param match_style a {@link GtkSource.Style}, or `null`.
6837
+ * @since 3.16
6650
6838
  */
6651
6839
  set_match_style(match_style: Style | null): void;
6652
6840
 
@@ -6656,6 +6844,8 @@ export namespace GtkSource {
6656
6844
  *
6657
6845
  * The search context holds a reference to `settings`.
6658
6846
  * @param settings the new {@link GtkSource.SearchSettings}, or `null`.
6847
+ * @since 3.10
6848
+ * @deprecated since 3.24: The {@link GtkSource.SearchContext.settings} property will become a construct-only property in a future version. Create a new {@link GtkSource.SearchContext} instead, or change the {@link GtkSource.SearchSettings} properties. When the {@link GtkSource.SearchContext.settings} property will become construct-only, it will be possible to simplify some code that needed to listen to the notify::settings signal.
6659
6849
  */
6660
6850
  set_settings(settings: SearchSettings | null): void;
6661
6851
  }
@@ -6817,16 +7007,19 @@ export namespace GtkSource {
6817
7007
  // Methods
6818
7008
  /**
6819
7009
  * @returns whether to search at word boundaries.
7010
+ * @since 3.10
6820
7011
  */
6821
7012
  get_at_word_boundaries(): boolean;
6822
7013
 
6823
7014
  /**
6824
7015
  * @returns whether the search is case sensitive.
7016
+ * @since 3.10
6825
7017
  */
6826
7018
  get_case_sensitive(): boolean;
6827
7019
 
6828
7020
  /**
6829
7021
  * @returns whether to search by regular expressions.
7022
+ * @since 3.10
6830
7023
  */
6831
7024
  get_regex_enabled(): boolean;
6832
7025
 
@@ -6836,11 +7029,13 @@ export namespace GtkSource {
6836
7029
  * You may be interested to call `gtk_source_utils_escape_search_text()` after
6837
7030
  * this function.
6838
7031
  * @returns the text to search, or `null` if the search is disabled.
7032
+ * @since 3.10
6839
7033
  */
6840
7034
  get_search_text(): string | null;
6841
7035
 
6842
7036
  /**
6843
7037
  * @returns whether to wrap around the search.
7038
+ * @since 3.10
6844
7039
  */
6845
7040
  get_wrap_around(): boolean;
6846
7041
 
@@ -6850,12 +7045,14 @@ export namespace GtkSource {
6850
7045
  * multiple words. See also `gtk_text_iter_starts_word()` and
6851
7046
  * `gtk_text_iter_ends_word()`.
6852
7047
  * @param at_word_boundaries the setting.
7048
+ * @since 3.10
6853
7049
  */
6854
7050
  set_at_word_boundaries(at_word_boundaries: boolean): void;
6855
7051
 
6856
7052
  /**
6857
7053
  * Enables or disables the case sensitivity for the search.
6858
7054
  * @param case_sensitive the setting.
7055
+ * @since 3.10
6859
7056
  */
6860
7057
  set_case_sensitive(case_sensitive: boolean): void;
6861
7058
 
@@ -6868,6 +7065,7 @@ export namespace GtkSource {
6868
7065
  * [Regular expression syntax](https://developer.gnome.org/glib/stable/glib-regex-syntax.html)
6869
7066
  * page in the GLib reference manual.
6870
7067
  * @param regex_enabled the setting.
7068
+ * @since 3.10
6871
7069
  */
6872
7070
  set_regex_enabled(regex_enabled: boolean): void;
6873
7071
 
@@ -6879,6 +7077,7 @@ export namespace GtkSource {
6879
7077
  * You may be interested to call `gtk_source_utils_unescape_search_text()` before
6880
7078
  * this function.
6881
7079
  * @param search_text the nul-terminated text to search, or `null` to disable the search.
7080
+ * @since 3.10
6882
7081
  */
6883
7082
  set_search_text(search_text: string | null): void;
6884
7083
 
@@ -6888,6 +7087,7 @@ export namespace GtkSource {
6888
7087
  * occurrences are found. Similarly, the backward search continues to search at
6889
7088
  * the end of the buffer.
6890
7089
  * @param wrap_around the setting.
7090
+ * @since 3.10
6891
7091
  */
6892
7092
  set_wrap_around(wrap_around: boolean): void;
6893
7093
  }
@@ -6993,11 +7193,13 @@ export namespace GtkSource {
6993
7193
  * @param settings a {@link Gio.Settings} object.
6994
7194
  * @param key the `settings` key to bind.
6995
7195
  * @param flags flags for the binding.
7196
+ * @since 3.24
6996
7197
  */
6997
7198
  bind_matrix_setting(settings: Gio.Settings, key: string, flags: Gio.SettingsBindFlags): void;
6998
7199
 
6999
7200
  /**
7000
7201
  * @returns whether the {@link GtkSource.SpaceDrawer.matrix} property is enabled.
7202
+ * @since 3.24
7001
7203
  */
7002
7204
  get_enable_matrix(): boolean;
7003
7205
 
@@ -7008,6 +7210,7 @@ export namespace GtkSource {
7008
7210
  * The `gtk_source_space_drawer_get_types_for_locations()` function may be more
7009
7211
  * convenient to use.
7010
7212
  * @returns the {@link GtkSource.SpaceDrawer.matrix} value as a new floating {@link GLib.Variant} instance.
7213
+ * @since 3.24
7011
7214
  */
7012
7215
  get_matrix(): GLib.Variant;
7013
7216
 
@@ -7022,12 +7225,14 @@ export namespace GtkSource {
7022
7225
  * specified `locations`.
7023
7226
  * @param locations one or several {@link GtkSource.SpaceLocationFlags}.
7024
7227
  * @returns a combination of {@link GtkSource.SpaceTypeFlags}.
7228
+ * @since 3.24
7025
7229
  */
7026
7230
  get_types_for_locations(locations: SpaceLocationFlags): SpaceTypeFlags;
7027
7231
 
7028
7232
  /**
7029
7233
  * Sets whether the {@link GtkSource.SpaceDrawer.matrix} property is enabled.
7030
7234
  * @param enable_matrix the new value.
7235
+ * @since 3.24
7031
7236
  */
7032
7237
  set_enable_matrix(enable_matrix: boolean): void;
7033
7238
 
@@ -7040,6 +7245,7 @@ export namespace GtkSource {
7040
7245
  * The `gtk_source_space_drawer_set_types_for_locations()` function may be more
7041
7246
  * convenient to use.
7042
7247
  * @param matrix the new matrix value, or `null`.
7248
+ * @since 3.24
7043
7249
  */
7044
7250
  set_matrix(matrix: GLib.Variant | null): void;
7045
7251
 
@@ -7048,6 +7254,7 @@ export namespace GtkSource {
7048
7254
  * `locations`.
7049
7255
  * @param locations one or several {@link GtkSource.SpaceLocationFlags}.
7050
7256
  * @param types a combination of {@link GtkSource.SpaceTypeFlags}.
7257
+ * @since 3.24
7051
7258
  */
7052
7259
  set_types_for_locations(locations: SpaceLocationFlags, types: SpaceTypeFlags): void;
7053
7260
  }
@@ -7344,6 +7551,7 @@ export namespace GtkSource {
7344
7551
  * If `style` is `null`, the related *-set properties of {@link Gtk.TextTag} are set to
7345
7552
  * `false`.
7346
7553
  * @param tag a {@link Gtk.TextTag} to apply styles to.
7554
+ * @since 3.22
7347
7555
  */
7348
7556
  apply(tag: Gtk.TextTag): void;
7349
7557
 
@@ -7351,6 +7559,7 @@ export namespace GtkSource {
7351
7559
  * Creates a copy of `style`, that is a new {@link GtkSource.Style} instance which
7352
7560
  * has the same attributes set.
7353
7561
  * @returns copy of `style`, call `g_object_unref()` when you are done with it.
7562
+ * @since 2.0
7354
7563
  */
7355
7564
  copy(): Style;
7356
7565
  }
@@ -7443,32 +7652,38 @@ export namespace GtkSource {
7443
7652
  // Methods
7444
7653
  /**
7445
7654
  * @returns a `null`-terminated array containing the `scheme` authors or `null` if no author is specified by the style scheme.
7655
+ * @since 2.0
7446
7656
  */
7447
7657
  get_authors(): string[] | null;
7448
7658
 
7449
7659
  /**
7450
7660
  * @returns `scheme` description (if defined), or `null`.
7661
+ * @since 2.0
7451
7662
  */
7452
7663
  get_description(): string | null;
7453
7664
 
7454
7665
  /**
7455
7666
  * @returns `scheme` file name if the scheme was created parsing a style scheme file or `null` in the other cases.
7667
+ * @since 2.0
7456
7668
  */
7457
7669
  get_filename(): string | null;
7458
7670
 
7459
7671
  /**
7460
7672
  * @returns `scheme` id.
7673
+ * @since 2.0
7461
7674
  */
7462
7675
  get_id(): string;
7463
7676
 
7464
7677
  /**
7465
7678
  * @returns `scheme` name.
7679
+ * @since 2.0
7466
7680
  */
7467
7681
  get_name(): string;
7468
7682
 
7469
7683
  /**
7470
7684
  * @param style_id id of the style to retrieve.
7471
7685
  * @returns style which corresponds to `style_id` in the `scheme`, or `null` when no style with this name found. It is owned by `scheme` and may not be unref'ed.
7686
+ * @since 2.0
7472
7687
  */
7473
7688
  get_style(style_id: string): Style | null;
7474
7689
  }
@@ -7685,6 +7900,7 @@ export namespace GtkSource {
7685
7900
  *
7686
7901
  * See `gtk_actionable_set_action_name()` for more information.
7687
7902
  * @returns the action name, or `null` if none is set
7903
+ * @since 3.4
7688
7904
  */
7689
7905
  get_action_name(): string | null;
7690
7906
 
@@ -7693,6 +7909,7 @@ export namespace GtkSource {
7693
7909
  *
7694
7910
  * See `gtk_actionable_set_action_target_value()` for more information.
7695
7911
  * @returns the current target value
7912
+ * @since 3.4
7696
7913
  */
7697
7914
  get_action_target_value(): GLib.Variant;
7698
7915
 
@@ -7709,6 +7926,7 @@ export namespace GtkSource {
7709
7926
  * respectively. This is the same form used for actions in the {@link Gio.Menu}
7710
7927
  * associated with the window.
7711
7928
  * @param action_name an action name, or `null`
7929
+ * @since 3.4
7712
7930
  */
7713
7931
  set_action_name(action_name: string | null): void;
7714
7932
 
@@ -7733,6 +7951,7 @@ export namespace GtkSource {
7733
7951
  * be rendered as active (and the other buttons, with different targets,
7734
7952
  * rendered inactive).
7735
7953
  * @param target_value a {@link GLib.Variant} to set as the target value, or `null`
7954
+ * @since 3.4
7736
7955
  */
7737
7956
  set_action_target_value(target_value: GLib.Variant | null): void;
7738
7957
 
@@ -7749,6 +7968,7 @@ export namespace GtkSource {
7749
7968
  * `action` is the action name and `target` is the string to use
7750
7969
  * as the target.)
7751
7970
  * @param detailed_action_name the detailed action name
7971
+ * @since 3.4
7752
7972
  */
7753
7973
  set_detailed_action_name(detailed_action_name: string): void;
7754
7974
 
@@ -7756,6 +7976,7 @@ export namespace GtkSource {
7756
7976
  * Gets the action name for `actionable`.
7757
7977
  *
7758
7978
  * See `gtk_actionable_set_action_name()` for more information.
7979
+ * @since 3.4
7759
7980
  * @virtual
7760
7981
  */
7761
7982
  vfunc_get_action_name(): string | null;
@@ -7764,6 +7985,7 @@ export namespace GtkSource {
7764
7985
  * Gets the current target value of `actionable`.
7765
7986
  *
7766
7987
  * See `gtk_actionable_set_action_target_value()` for more information.
7988
+ * @since 3.4
7767
7989
  * @virtual
7768
7990
  */
7769
7991
  vfunc_get_action_target_value(): GLib.Variant;
@@ -7781,6 +8003,7 @@ export namespace GtkSource {
7781
8003
  * respectively. This is the same form used for actions in the {@link Gio.Menu}
7782
8004
  * associated with the window.
7783
8005
  * @param action_name an action name, or `null`
8006
+ * @since 3.4
7784
8007
  * @virtual
7785
8008
  */
7786
8009
  vfunc_set_action_name(action_name: string | null): void;
@@ -7806,6 +8029,7 @@ export namespace GtkSource {
7806
8029
  * be rendered as active (and the other buttons, with different targets,
7807
8030
  * rendered inactive).
7808
8031
  * @param target_value a {@link GLib.Variant} to set as the target value, or `null`
8032
+ * @since 3.4
7809
8033
  * @virtual
7810
8034
  */
7811
8035
  vfunc_set_action_target_value(target_value: GLib.Variant | null): void;
@@ -7827,12 +8051,16 @@ export namespace GtkSource {
7827
8051
  * > `gtk_activatable_get_related_action()` to retrieve the
7828
8052
  * > previous action.
7829
8053
  * @param action the {@link Gtk.Action} to set
8054
+ * @since 2.16
8055
+ * @deprecated since 3.10
7830
8056
  */
7831
8057
  do_set_related_action(action: Gtk.Action): void;
7832
8058
 
7833
8059
  /**
7834
8060
  * Gets the related {@link Gtk.Action} for `activatable`.
7835
8061
  * @returns the related {@link Gtk.Action} if one is set.
8062
+ * @since 2.16
8063
+ * @deprecated since 3.10
7836
8064
  */
7837
8065
  get_related_action(): Gtk.Action;
7838
8066
 
@@ -7841,6 +8069,8 @@ export namespace GtkSource {
7841
8069
  * and appearance when setting the related action or when
7842
8070
  * the action changes appearance.
7843
8071
  * @returns whether `activatable` uses its actions appearance.
8072
+ * @since 2.16
8073
+ * @deprecated since 3.10
7844
8074
  */
7845
8075
  get_use_action_appearance(): boolean;
7846
8076
 
@@ -7850,6 +8080,8 @@ export namespace GtkSource {
7850
8080
  * > {@link Gtk.Activatable} implementors need to handle the {@link Gtk.Activatable.related_action}
7851
8081
  * > property and call `gtk_activatable_do_set_related_action()` when it changes.
7852
8082
  * @param action the {@link Gtk.Action} to set
8083
+ * @since 2.16
8084
+ * @deprecated since 3.10
7853
8085
  */
7854
8086
  set_related_action(action: Gtk.Action): void;
7855
8087
 
@@ -7862,6 +8094,8 @@ export namespace GtkSource {
7862
8094
  * > `gtk_activatable_sync_action_properties()` to update `activatable`
7863
8095
  * > if needed.
7864
8096
  * @param use_appearance whether to use the actions appearance
8097
+ * @since 2.16
8098
+ * @deprecated since 3.10
7865
8099
  */
7866
8100
  set_use_action_appearance(use_appearance: boolean): void;
7867
8101
 
@@ -7871,6 +8105,8 @@ export namespace GtkSource {
7871
8105
  * or unset and by the implementing class when
7872
8106
  * {@link Gtk.Activatable.use_action_appearance} changes.
7873
8107
  * @param action the related {@link Gtk.Action} or `null`
8108
+ * @since 2.16
8109
+ * @deprecated since 3.10
7874
8110
  */
7875
8111
  sync_action_properties(action: Gtk.Action | null): void;
7876
8112
 
@@ -7880,6 +8116,8 @@ export namespace GtkSource {
7880
8116
  * or unset and by the implementing class when
7881
8117
  * {@link Gtk.Activatable.use_action_appearance} changes.
7882
8118
  * @param action the related {@link Gtk.Action} or `null`
8119
+ * @since 2.16
8120
+ * @deprecated since 3.10
7883
8121
  * @virtual
7884
8122
  */
7885
8123
  vfunc_sync_action_properties(action: Gtk.Action | null): void;
@@ -7897,17 +8135,20 @@ export namespace GtkSource {
7897
8135
  /**
7898
8136
  * Gets the currently-selected scheme.
7899
8137
  * @returns the currently-selected scheme.
8138
+ * @since 3.16
7900
8139
  */
7901
8140
  get_style_scheme(): StyleScheme;
7902
8141
 
7903
8142
  /**
7904
8143
  * Sets the scheme.
7905
8144
  * @param scheme a {@link GtkSource.StyleScheme}
8145
+ * @since 3.16
7906
8146
  */
7907
8147
  set_style_scheme(scheme: StyleScheme): void;
7908
8148
 
7909
8149
  /**
7910
8150
  * Gets the currently-selected scheme.
8151
+ * @since 3.16
7911
8152
  * @virtual
7912
8153
  */
7913
8154
  vfunc_get_style_scheme(): StyleScheme;
@@ -7915,6 +8156,7 @@ export namespace GtkSource {
7915
8156
  /**
7916
8157
  * Sets the scheme.
7917
8158
  * @param scheme a {@link GtkSource.StyleScheme}
8159
+ * @since 3.16
7918
8160
  * @virtual
7919
8161
  */
7920
8162
  vfunc_set_style_scheme(scheme: StyleScheme): void;
@@ -7941,6 +8183,7 @@ export namespace GtkSource {
7941
8183
  * Returns whether the widget should grab focus when it is clicked with the mouse.
7942
8184
  * See `gtk_widget_set_focus_on_click()`.
7943
8185
  * @returns `true` if the widget should grab focus when it is clicked with the mouse.
8186
+ * @since 3.20
7944
8187
  */
7945
8188
  get_focus_on_click(): boolean;
7946
8189
 
@@ -7950,6 +8193,7 @@ export namespace GtkSource {
7950
8193
  * you don’t want the keyboard focus removed from the main area of the
7951
8194
  * application.
7952
8195
  * @param focus_on_click whether the widget should grab focus when clicked with the mouse
8196
+ * @since 3.20
7953
8197
  */
7954
8198
  set_focus_on_click(focus_on_click: boolean): void;
7955
8199
  }
@@ -8065,17 +8309,20 @@ export namespace GtkSource {
8065
8309
  /**
8066
8310
  * Gets the currently-selected scheme.
8067
8311
  * @returns the currently-selected scheme.
8312
+ * @since 3.16
8068
8313
  */
8069
8314
  get_style_scheme(): StyleScheme;
8070
8315
 
8071
8316
  /**
8072
8317
  * Sets the scheme.
8073
8318
  * @param scheme a {@link GtkSource.StyleScheme}
8319
+ * @since 3.16
8074
8320
  */
8075
8321
  set_style_scheme(scheme: StyleScheme): void;
8076
8322
 
8077
8323
  /**
8078
8324
  * Gets the currently-selected scheme.
8325
+ * @since 3.16
8079
8326
  * @virtual
8080
8327
  */
8081
8328
  vfunc_get_style_scheme(): StyleScheme;
@@ -8083,6 +8330,7 @@ export namespace GtkSource {
8083
8330
  /**
8084
8331
  * Sets the scheme.
8085
8332
  * @param scheme a {@link GtkSource.StyleScheme}
8333
+ * @since 3.16
8086
8334
  * @virtual
8087
8335
  */
8088
8336
  vfunc_set_style_scheme(scheme: StyleScheme): void;
@@ -8927,6 +9175,7 @@ export namespace GtkSource {
8927
9175
  * Returns the {@link GtkSource.BackgroundPatternType} specifying if and how
8928
9176
  * the background pattern should be displayed for this `view`.
8929
9177
  * @returns the {@link GtkSource.BackgroundPatternType}.
9178
+ * @since 3.16
8930
9179
  */
8931
9180
  get_background_pattern(): BackgroundPatternType;
8932
9181
 
@@ -8942,6 +9191,7 @@ export namespace GtkSource {
8942
9191
  * Returns the {@link GtkSource.DrawSpacesFlags} specifying if and how spaces
8943
9192
  * should be displayed for this `view`.
8944
9193
  * @returns the {@link GtkSource.DrawSpacesFlags}, 0 if no spaces should be drawn.
9194
+ * @deprecated since 3.24: Use `gtk_source_space_drawer_get_types_for_locations()` instead.
8945
9195
  */
8946
9196
  get_draw_spaces(): DrawSpacesFlags;
8947
9197
 
@@ -8952,6 +9202,7 @@ export namespace GtkSource {
8952
9202
  * and mark category icons are rendered in the left gutter.
8953
9203
  * @param window_type the gutter window type.
8954
9204
  * @returns the {@link GtkSource.Gutter}.
9205
+ * @since 2.8
8955
9206
  */
8956
9207
  get_gutter(window_type: Gtk.TextWindowType): Gutter;
8957
9208
 
@@ -8999,6 +9250,7 @@ export namespace GtkSource {
8999
9250
  /**
9000
9251
  * Returns whether line marks are displayed beside the text.
9001
9252
  * @returns `true` if the line marks are displayed.
9253
+ * @since 2.2
9002
9254
  */
9003
9255
  get_show_line_marks(): boolean;
9004
9256
 
@@ -9018,6 +9270,7 @@ export namespace GtkSource {
9018
9270
  * Returns `true` if pressing the Backspace key will try to delete spaces
9019
9271
  * up to the previous tab stop.
9020
9272
  * @returns `true` if smart Backspace handling is enabled.
9273
+ * @since 3.18
9021
9274
  */
9022
9275
  get_smart_backspace(): boolean;
9023
9276
 
@@ -9033,6 +9286,7 @@ export namespace GtkSource {
9033
9286
  * guaranteed to be the same for the lifetime of `view`. Each {@link GtkSource.View}
9034
9287
  * object has a different {@link GtkSource.SpaceDrawer}.
9035
9288
  * @returns the {@link GtkSource.SpaceDrawer} associated with `view`.
9289
+ * @since 3.24
9036
9290
  */
9037
9291
  get_space_drawer(): SpaceDrawer;
9038
9292
 
@@ -9055,6 +9309,7 @@ export namespace GtkSource {
9055
9309
  * empty lines are not indented.
9056
9310
  * @param start {@link Gtk.TextIter} of the first line to indent
9057
9311
  * @param end {@link Gtk.TextIter} of the last line to indent
9312
+ * @since 3.16
9058
9313
  */
9059
9314
  indent_lines(start: Gtk.TextIter, end: Gtk.TextIter): void;
9060
9315
 
@@ -9072,6 +9327,7 @@ export namespace GtkSource {
9072
9327
  /**
9073
9328
  * Set if and how the background pattern should be displayed.
9074
9329
  * @param background_pattern the {@link GtkSource.BackgroundPatternType}.
9330
+ * @since 3.16
9075
9331
  */
9076
9332
  set_background_pattern(background_pattern: BackgroundPatternType): void;
9077
9333
 
@@ -9082,6 +9338,7 @@ export namespace GtkSource {
9082
9338
  * For a finer-grained method, there is also the GtkSourceTag's
9083
9339
  * {@link GtkSource.Tag.draw_spaces} property.
9084
9340
  * @param flags {@link GtkSource.DrawSpacesFlags} specifing how white spaces should be displayed
9341
+ * @deprecated since 3.24: Use `gtk_source_space_drawer_set_types_for_locations()` instead.
9085
9342
  */
9086
9343
  set_draw_spaces(flags: DrawSpacesFlags): void;
9087
9344
 
@@ -9155,6 +9412,7 @@ export namespace GtkSource {
9155
9412
  /**
9156
9413
  * If `true` line marks will be displayed beside the text.
9157
9414
  * @param show whether line marks should be displayed.
9415
+ * @since 2.2
9158
9416
  */
9159
9417
  set_show_line_marks(show: boolean): void;
9160
9418
 
@@ -9174,6 +9432,7 @@ export namespace GtkSource {
9174
9432
  * When set to `true`, pressing the Backspace key will try to delete spaces
9175
9433
  * up to the previous tab stop.
9176
9434
  * @param smart_backspace whether to enable smart Backspace handling.
9435
+ * @since 3.18
9177
9436
  */
9178
9437
  set_smart_backspace(smart_backspace: boolean): void;
9179
9438
 
@@ -9197,6 +9456,7 @@ export namespace GtkSource {
9197
9456
  * specified lines.
9198
9457
  * @param start {@link Gtk.TextIter} of the first line to indent
9199
9458
  * @param end {@link Gtk.TextIter} of the last line to indent
9459
+ * @since 3.16
9200
9460
  */
9201
9461
  unindent_lines(start: Gtk.TextIter, end: Gtk.TextIter): void;
9202
9462
 
@@ -9265,36 +9525,42 @@ export namespace GtkSource {
9265
9525
  * display overlayed graphics, like the overshoot indication,
9266
9526
  * at the right position.
9267
9527
  * @returns `true` if `border` has been set
9528
+ * @since 3.16
9268
9529
  */
9269
9530
  get_border(): [boolean, Gtk.Border];
9270
9531
 
9271
9532
  /**
9272
9533
  * Retrieves the {@link Gtk.Adjustment} used for horizontal scrolling.
9273
9534
  * @returns horizontal {@link Gtk.Adjustment}.
9535
+ * @since 3.0
9274
9536
  */
9275
9537
  get_hadjustment(): Gtk.Adjustment;
9276
9538
 
9277
9539
  /**
9278
9540
  * Gets the horizontal {@link Gtk.ScrollablePolicy}.
9279
9541
  * @returns The horizontal {@link Gtk.ScrollablePolicy}.
9542
+ * @since 3.0
9280
9543
  */
9281
9544
  get_hscroll_policy(): Gtk.ScrollablePolicy;
9282
9545
 
9283
9546
  /**
9284
9547
  * Retrieves the {@link Gtk.Adjustment} used for vertical scrolling.
9285
9548
  * @returns vertical {@link Gtk.Adjustment}.
9549
+ * @since 3.0
9286
9550
  */
9287
9551
  get_vadjustment(): Gtk.Adjustment;
9288
9552
 
9289
9553
  /**
9290
9554
  * Gets the vertical {@link Gtk.ScrollablePolicy}.
9291
9555
  * @returns The vertical {@link Gtk.ScrollablePolicy}.
9556
+ * @since 3.0
9292
9557
  */
9293
9558
  get_vscroll_policy(): Gtk.ScrollablePolicy;
9294
9559
 
9295
9560
  /**
9296
9561
  * Sets the horizontal adjustment of the {@link Gtk.Scrollable}.
9297
9562
  * @param hadjustment a {@link Gtk.Adjustment}
9563
+ * @since 3.0
9298
9564
  */
9299
9565
  set_hadjustment(hadjustment: Gtk.Adjustment | null): void;
9300
9566
 
@@ -9303,12 +9569,14 @@ export namespace GtkSource {
9303
9569
  * horizontal scrolling should start below the minimum width or
9304
9570
  * below the natural width.
9305
9571
  * @param policy the horizontal {@link Gtk.ScrollablePolicy}
9572
+ * @since 3.0
9306
9573
  */
9307
9574
  set_hscroll_policy(policy: Gtk.ScrollablePolicy): void;
9308
9575
 
9309
9576
  /**
9310
9577
  * Sets the vertical adjustment of the {@link Gtk.Scrollable}.
9311
9578
  * @param vadjustment a {@link Gtk.Adjustment}
9579
+ * @since 3.0
9312
9580
  */
9313
9581
  set_vadjustment(vadjustment: Gtk.Adjustment | null): void;
9314
9582
 
@@ -9317,6 +9585,7 @@ export namespace GtkSource {
9317
9585
  * vertical scrolling should start below the minimum height or
9318
9586
  * below the natural height.
9319
9587
  * @param policy the vertical {@link Gtk.ScrollablePolicy}
9588
+ * @since 3.0
9320
9589
  */
9321
9590
  set_vscroll_policy(policy: Gtk.ScrollablePolicy): void;
9322
9591
 
@@ -9326,6 +9595,7 @@ export namespace GtkSource {
9326
9595
  * be treeview headers. GTK+ can use this information to
9327
9596
  * display overlayed graphics, like the overshoot indication,
9328
9597
  * at the right position.
9598
+ * @since 3.16
9329
9599
  * @virtual
9330
9600
  */
9331
9601
  vfunc_get_border(): [boolean, Gtk.Border];
@@ -9429,11 +9699,13 @@ export namespace GtkSource {
9429
9699
  // Static methods
9430
9700
  /**
9431
9701
  * Gets all encodings.
9702
+ * @since 3.14
9432
9703
  */
9433
9704
  static get_all(): Encoding[];
9434
9705
 
9435
9706
  /**
9436
9707
  * Gets the {@link GtkSource.Encoding} for the current locale. See also `g_get_charset()`.
9708
+ * @since 3.14
9437
9709
  */
9438
9710
  static get_current(): Encoding;
9439
9711
 
@@ -9444,6 +9716,7 @@ export namespace GtkSource {
9444
9716
  * This function returns a different list depending on the current locale (i.e.
9445
9717
  * language, country and default encoding). The UTF-8 encoding and the current
9446
9718
  * locale encoding are guaranteed to be present in the returned list.
9719
+ * @since 3.18
9447
9720
  */
9448
9721
  static get_default_candidates(): Encoding[];
9449
9722
 
@@ -9451,20 +9724,26 @@ export namespace GtkSource {
9451
9724
  * Gets a {@link GtkSource.Encoding} from a character set such as "UTF-8" or
9452
9725
  * "ISO-8859-1".
9453
9726
  * @param charset a character set.
9727
+ * @since 3.14
9454
9728
  */
9455
9729
  static get_from_charset(charset: string): Encoding | null;
9456
9730
 
9731
+ /**
9732
+ * @since 3.14
9733
+ */
9457
9734
  static get_utf8(): Encoding;
9458
9735
 
9459
9736
  // Methods
9460
9737
  /**
9461
9738
  * Used by language bindings.
9462
9739
  * @returns a copy of `enc`.
9740
+ * @since 3.14
9463
9741
  */
9464
9742
  copy(): Encoding;
9465
9743
 
9466
9744
  /**
9467
9745
  * Used by language bindings.
9746
+ * @since 3.14
9468
9747
  */
9469
9748
  free(): void;
9470
9749
 
@@ -9472,17 +9751,20 @@ export namespace GtkSource {
9472
9751
  * Gets the character set of the {@link GtkSource.Encoding}, such as "UTF-8" or
9473
9752
  * "ISO-8859-1".
9474
9753
  * @returns the character set of the {@link GtkSource.Encoding}.
9754
+ * @since 3.14
9475
9755
  */
9476
9756
  get_charset(): string;
9477
9757
 
9478
9758
  /**
9479
9759
  * Gets the name of the {@link GtkSource.Encoding} such as "Unicode" or "Western".
9480
9760
  * @returns the name of the {@link GtkSource.Encoding}.
9761
+ * @since 3.14
9481
9762
  */
9482
9763
  get_name(): string;
9483
9764
 
9484
9765
  /**
9485
9766
  * @returns a string representation. Free with `g_free()` when no longer needed.
9767
+ * @since 3.14
9486
9768
  */
9487
9769
  to_string(): string;
9488
9770
  }
@@ -9670,17 +9952,20 @@ export namespace GtkSource {
9670
9952
  /**
9671
9953
  * Gets the subregion at this iterator.
9672
9954
  * @returns `true` if `start` and `end` have been set successfully (if non-`null`), or `false` if `iter` is the end iterator or if the region is empty.
9955
+ * @since 3.22
9673
9956
  */
9674
9957
  get_subregion(): [boolean, Gtk.TextIter | null, Gtk.TextIter | null];
9675
9958
 
9676
9959
  /**
9677
9960
  * @returns whether `iter` is the end iterator.
9961
+ * @since 3.22
9678
9962
  */
9679
9963
  is_end(): boolean;
9680
9964
 
9681
9965
  /**
9682
9966
  * Moves `iter` to the next subregion.
9683
9967
  * @returns `true` if `iter` moved and is dereferenceable, or `false` if `iter` has been set to the end iterator.
9968
+ * @since 3.22
9684
9969
  */
9685
9970
  next(): boolean;
9686
9971
  }
@@ -9821,6 +10106,7 @@ export namespace GtkSource {
9821
10106
 
9822
10107
  /**
9823
10108
  * Gets the {@link Gio.Icon} for the icon of `proposal`.
10109
+ * @since 3.18
9824
10110
  * @virtual
9825
10111
  */
9826
10112
  vfunc_get_gicon(): Gio.Icon | null;
@@ -9833,6 +10119,7 @@ export namespace GtkSource {
9833
10119
 
9834
10120
  /**
9835
10121
  * Gets the icon name of `proposal`.
10122
+ * @since 3.18
9836
10123
  * @virtual
9837
10124
  */
9838
10125
  vfunc_get_icon_name(): string | null;
@@ -9917,6 +10204,7 @@ export namespace GtkSource {
9917
10204
  /**
9918
10205
  * Gets the {@link Gio.Icon} for the icon of `proposal`.
9919
10206
  * @returns A {@link Gio.Icon} with the icon of `proposal`.
10207
+ * @since 3.18
9920
10208
  */
9921
10209
  get_gicon(): Gio.Icon | null;
9922
10210
 
@@ -9929,6 +10217,7 @@ export namespace GtkSource {
9929
10217
  /**
9930
10218
  * Gets the icon name of `proposal`.
9931
10219
  * @returns The icon name of `proposal`.
10220
+ * @since 3.18
9932
10221
  */
9933
10222
  get_icon_name(): string | null;
9934
10223
 
@@ -10016,6 +10305,7 @@ export namespace GtkSource {
10016
10305
 
10017
10306
  /**
10018
10307
  * Gets the {@link Gio.Icon} for the icon of `provider`.
10308
+ * @since 3.18
10019
10309
  * @virtual
10020
10310
  */
10021
10311
  vfunc_get_gicon(): Gio.Icon | null;
@@ -10028,6 +10318,7 @@ export namespace GtkSource {
10028
10318
 
10029
10319
  /**
10030
10320
  * Gets the icon name of `provider`.
10321
+ * @since 3.18
10031
10322
  * @virtual
10032
10323
  */
10033
10324
  vfunc_get_icon_name(): string | null;
@@ -10169,6 +10460,7 @@ export namespace GtkSource {
10169
10460
  /**
10170
10461
  * Gets the {@link Gio.Icon} for the icon of `provider`.
10171
10462
  * @returns The icon to be used for the provider, or `null` if the provider does not have a special icon.
10463
+ * @since 3.18
10172
10464
  */
10173
10465
  get_gicon(): Gio.Icon | null;
10174
10466
 
@@ -10181,6 +10473,7 @@ export namespace GtkSource {
10181
10473
  /**
10182
10474
  * Gets the icon name of `provider`.
10183
10475
  * @returns The icon name to be used for the provider, or `null` if the provider does not have a special icon.
10476
+ * @since 3.18
10184
10477
  */
10185
10478
  get_icon_name(): string | null;
10186
10479
 
@@ -10293,6 +10586,7 @@ export namespace GtkSource {
10293
10586
  // Virtual methods
10294
10587
  /**
10295
10588
  * Gets the currently-selected scheme.
10589
+ * @since 3.16
10296
10590
  * @virtual
10297
10591
  */
10298
10592
  vfunc_get_style_scheme(): StyleScheme;
@@ -10300,6 +10594,7 @@ export namespace GtkSource {
10300
10594
  /**
10301
10595
  * Sets the scheme.
10302
10596
  * @param scheme a {@link GtkSource.StyleScheme}
10597
+ * @since 3.16
10303
10598
  * @virtual
10304
10599
  */
10305
10600
  vfunc_set_style_scheme(scheme: StyleScheme): void;
@@ -10345,12 +10640,14 @@ export namespace GtkSource {
10345
10640
  /**
10346
10641
  * Gets the currently-selected scheme.
10347
10642
  * @returns the currently-selected scheme.
10643
+ * @since 3.16
10348
10644
  */
10349
10645
  get_style_scheme(): StyleScheme;
10350
10646
 
10351
10647
  /**
10352
10648
  * Sets the scheme.
10353
10649
  * @param scheme a {@link GtkSource.StyleScheme}
10650
+ * @since 3.16
10354
10651
  */
10355
10652
  set_style_scheme(scheme: StyleScheme): void;
10356
10653
  }
@@ -10372,36 +10669,42 @@ export namespace GtkSource {
10372
10669
  * Begin a not undoable action on the buffer. All changes between this call
10373
10670
  * and the call to `gtk_source_undo_manager_end_not_undoable_action()` cannot
10374
10671
  * be undone. This function should be re-entrant.
10672
+ * @since 2.10
10375
10673
  * @virtual
10376
10674
  */
10377
10675
  vfunc_begin_not_undoable_action(): void;
10378
10676
 
10379
10677
  /**
10380
10678
  * Get whether there are redo operations available.
10679
+ * @since 2.10
10381
10680
  * @virtual
10382
10681
  */
10383
10682
  vfunc_can_redo(): boolean;
10384
10683
 
10385
10684
  /**
10386
10685
  * Emits the {@link GtkSource.UndoManager.SignalSignatures.can_redo_changed | GtkSource.UndoManager::can-redo-changed} signal.
10686
+ * @since 2.10
10387
10687
  * @virtual
10388
10688
  */
10389
10689
  vfunc_can_redo_changed(): void;
10390
10690
 
10391
10691
  /**
10392
10692
  * Get whether there are undo operations available.
10693
+ * @since 2.10
10393
10694
  * @virtual
10394
10695
  */
10395
10696
  vfunc_can_undo(): boolean;
10396
10697
 
10397
10698
  /**
10398
10699
  * Emits the {@link GtkSource.UndoManager.SignalSignatures.can_undo_changed | GtkSource.UndoManager::can-undo-changed} signal.
10700
+ * @since 2.10
10399
10701
  * @virtual
10400
10702
  */
10401
10703
  vfunc_can_undo_changed(): void;
10402
10704
 
10403
10705
  /**
10404
10706
  * Ends a not undoable action on the buffer.
10707
+ * @since 2.10
10405
10708
  * @virtual
10406
10709
  */
10407
10710
  vfunc_end_not_undoable_action(): void;
@@ -10410,6 +10713,7 @@ export namespace GtkSource {
10410
10713
  * Perform a single redo. Calling this function when there are no redo operations
10411
10714
  * available is an error. Use `gtk_source_undo_manager_can_redo()` to find out
10412
10715
  * if there are redo operations available.
10716
+ * @since 2.10
10413
10717
  * @virtual
10414
10718
  */
10415
10719
  vfunc_redo(): void;
@@ -10418,6 +10722,7 @@ export namespace GtkSource {
10418
10722
  * Perform a single undo. Calling this function when there are no undo operations
10419
10723
  * available is an error. Use `gtk_source_undo_manager_can_undo()` to find out
10420
10724
  * if there are undo operations available.
10725
+ * @since 2.10
10421
10726
  * @virtual
10422
10727
  */
10423
10728
  vfunc_undo(): void;
@@ -10442,33 +10747,39 @@ export namespace GtkSource {
10442
10747
  * Begin a not undoable action on the buffer. All changes between this call
10443
10748
  * and the call to `gtk_source_undo_manager_end_not_undoable_action()` cannot
10444
10749
  * be undone. This function should be re-entrant.
10750
+ * @since 2.10
10445
10751
  */
10446
10752
  begin_not_undoable_action(): void;
10447
10753
 
10448
10754
  /**
10449
10755
  * Get whether there are redo operations available.
10450
10756
  * @returns `true` if there are redo operations available, `false` otherwise
10757
+ * @since 2.10
10451
10758
  */
10452
10759
  can_redo(): boolean;
10453
10760
 
10454
10761
  /**
10455
10762
  * Emits the {@link GtkSource.UndoManager.SignalSignatures.can_redo_changed | GtkSource.UndoManager::can-redo-changed} signal.
10763
+ * @since 2.10
10456
10764
  */
10457
10765
  can_redo_changed(): void;
10458
10766
 
10459
10767
  /**
10460
10768
  * Get whether there are undo operations available.
10461
10769
  * @returns `true` if there are undo operations available, `false` otherwise
10770
+ * @since 2.10
10462
10771
  */
10463
10772
  can_undo(): boolean;
10464
10773
 
10465
10774
  /**
10466
10775
  * Emits the {@link GtkSource.UndoManager.SignalSignatures.can_undo_changed | GtkSource.UndoManager::can-undo-changed} signal.
10776
+ * @since 2.10
10467
10777
  */
10468
10778
  can_undo_changed(): void;
10469
10779
 
10470
10780
  /**
10471
10781
  * Ends a not undoable action on the buffer.
10782
+ * @since 2.10
10472
10783
  */
10473
10784
  end_not_undoable_action(): void;
10474
10785
 
@@ -10476,6 +10787,7 @@ export namespace GtkSource {
10476
10787
  * Perform a single redo. Calling this function when there are no redo operations
10477
10788
  * available is an error. Use `gtk_source_undo_manager_can_redo()` to find out
10478
10789
  * if there are redo operations available.
10790
+ * @since 2.10
10479
10791
  */
10480
10792
  redo(): void;
10481
10793
 
@@ -10483,6 +10795,7 @@ export namespace GtkSource {
10483
10795
  * Perform a single undo. Calling this function when there are no undo operations
10484
10796
  * available is an error. Use `gtk_source_undo_manager_can_undo()` to find out
10485
10797
  * if there are undo operations available.
10798
+ * @since 2.10
10486
10799
  */
10487
10800
  undo(): void;
10488
10801
  }