@girs/gtksource-5 4.2.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.
package/gtksource-5.d.ts CHANGED
@@ -909,6 +909,7 @@ export namespace GtkSource {
909
909
  * @param display a {@link GtkSource.HoverDisplay} to populate
910
910
  * @param cancellable
911
911
  * @param callback
912
+ * @since 5.18
912
913
  * @virtual
913
914
  */
914
915
  vfunc_populate_hover_async(annotation: Annotation, display: HoverDisplay, cancellable: Gio.Cancellable | null, callback: Gio.AsyncReadyCallback<this> | null): void;
@@ -916,6 +917,7 @@ export namespace GtkSource {
916
917
  /**
917
918
  * Finishes populating the {@link HoverDisplay} asynchronously.
918
919
  * @param result
920
+ * @since 5.18
919
921
  * @virtual
920
922
  */
921
923
  vfunc_populate_hover_finish(result: Gio.AsyncResult): boolean;
@@ -924,6 +926,7 @@ export namespace GtkSource {
924
926
  /**
925
927
  * Add an annotation to the provider.
926
928
  * @param annotation
929
+ * @since 5.18
927
930
  */
928
931
  add_annotation(annotation: Annotation): void;
929
932
 
@@ -933,6 +936,7 @@ export namespace GtkSource {
933
936
  * @param annotation a {@link GtkSource.Annotation}
934
937
  * @param display a {@link GtkSource.HoverDisplay} to populate
935
938
  * @param cancellable
939
+ * @since 5.18
936
940
  */
937
941
  populate_hover_async(annotation: Annotation, display: HoverDisplay, cancellable: Gio.Cancellable | null): globalThis.Promise<boolean>;
938
942
 
@@ -943,6 +947,7 @@ export namespace GtkSource {
943
947
  * @param display a {@link GtkSource.HoverDisplay} to populate
944
948
  * @param cancellable
945
949
  * @param callback
950
+ * @since 5.18
946
951
  */
947
952
  populate_hover_async(annotation: Annotation, display: HoverDisplay, cancellable: Gio.Cancellable | null, callback: Gio.AsyncReadyCallback<this> | null): void;
948
953
 
@@ -953,6 +958,7 @@ export namespace GtkSource {
953
958
  * @param display a {@link GtkSource.HoverDisplay} to populate
954
959
  * @param cancellable
955
960
  * @param callback
961
+ * @since 5.18
956
962
  */
957
963
  populate_hover_async(annotation: Annotation, display: HoverDisplay, cancellable: Gio.Cancellable | null, callback?: Gio.AsyncReadyCallback<this> | null): globalThis.Promise<boolean> | void;
958
964
 
@@ -960,11 +966,13 @@ export namespace GtkSource {
960
966
  * Finishes populating the {@link HoverDisplay} asynchronously.
961
967
  * @param result
962
968
  * @returns `true` if successful; otherwise `false` and `error` is set.
969
+ * @since 5.18
963
970
  */
964
971
  populate_hover_finish(result: Gio.AsyncResult): boolean;
965
972
 
966
973
  /**
967
974
  * Removes all annotations from the provider.
975
+ * @since 5.18
968
976
  */
969
977
  remove_all(): void;
970
978
 
@@ -972,6 +980,7 @@ export namespace GtkSource {
972
980
  * Remove an annotation from the provider.
973
981
  * @param annotation
974
982
  * @returns `true` if the annotation was found and removed
983
+ * @since 5.18
975
984
  */
976
985
  remove_annotation(annotation: Annotation): boolean;
977
986
  }
@@ -1426,6 +1435,7 @@ export namespace GtkSource {
1426
1435
  * @param start start of range as a {@link Gtk.TextIter}
1427
1436
  * @param end end of range as a {@link Gtk.TextIter}
1428
1437
  * @returns a newly-allocated string containing the text with Pango markup, or `null` if `start` and `end` are invalid.
1438
+ * @since 5.18
1429
1439
  */
1430
1440
  get_markup(start: Gtk.TextIter, end: Gtk.TextIter): string;
1431
1441
 
@@ -2080,6 +2090,7 @@ export namespace GtkSource {
2080
2090
  * does not interrupts the user's current screen reader output.
2081
2091
  * @param message the string to announce
2082
2092
  * @param priority the priority of the announcement
2093
+ * @since 4.14
2083
2094
  */
2084
2095
  announce(message: string, priority: Gtk.AccessibleAnnouncementPriority): void;
2085
2096
 
@@ -2092,6 +2103,7 @@ export namespace GtkSource {
2092
2103
  * It is left to the accessible implementation to define the scope
2093
2104
  * and uniqueness of the identifier.
2094
2105
  * @returns the accessible identifier
2106
+ * @since 4.22
2095
2107
  */
2096
2108
  get_accessible_id(): string | null;
2097
2109
 
@@ -2100,6 +2112,7 @@ export namespace GtkSource {
2100
2112
  *
2101
2113
  * This function returns `NULL` for top level widgets.
2102
2114
  * @returns the accessible parent
2115
+ * @since 4.10
2103
2116
  */
2104
2117
  get_accessible_parent(): Gtk.Accessible | null;
2105
2118
 
@@ -2112,6 +2125,7 @@ export namespace GtkSource {
2112
2125
  /**
2113
2126
  * Retrieves the implementation for the given accessible object.
2114
2127
  * @returns the accessible implementation object
2128
+ * @since 4.10
2115
2129
  */
2116
2130
  get_at_context(): Gtk.ATContext;
2117
2131
 
@@ -2122,18 +2136,21 @@ export namespace GtkSource {
2122
2136
  * implementations, e.g. to get the bounds from an ignored
2123
2137
  * child widget.
2124
2138
  * @returns true if the bounds are valid, and false otherwise
2139
+ * @since 4.10
2125
2140
  */
2126
2141
  get_bounds(): [boolean, number, number, number, number];
2127
2142
 
2128
2143
  /**
2129
2144
  * Retrieves the first accessible child of an accessible object.
2130
2145
  * @returns the first accessible child
2146
+ * @since 4.10
2131
2147
  */
2132
2148
  get_first_accessible_child(): Gtk.Accessible | null;
2133
2149
 
2134
2150
  /**
2135
2151
  * Retrieves the next accessible sibling of an accessible object
2136
2152
  * @returns the next accessible sibling
2153
+ * @since 4.10
2137
2154
  */
2138
2155
  get_next_accessible_sibling(): Gtk.Accessible | null;
2139
2156
 
@@ -2145,6 +2162,7 @@ export namespace GtkSource {
2145
2162
  * child widget, as is the case for {@link Gtk.Text} wrappers.
2146
2163
  * @param state platform state to query
2147
2164
  * @returns the value of state for the accessible
2165
+ * @since 4.10
2148
2166
  */
2149
2167
  get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
2150
2168
 
@@ -2178,6 +2196,7 @@ export namespace GtkSource {
2178
2196
  * object is the container widget.
2179
2197
  * @param parent the parent accessible object
2180
2198
  * @param next_sibling the sibling accessible object
2199
+ * @since 4.10
2181
2200
  */
2182
2201
  set_accessible_parent(parent: Gtk.Accessible | null, next_sibling: Gtk.Accessible | null): void;
2183
2202
 
@@ -2187,6 +2206,7 @@ export namespace GtkSource {
2187
2206
  * That might be useful when a new child of a custom accessible
2188
2207
  * is created, and it needs to be linked to a previous child.
2189
2208
  * @param new_sibling the new next accessible sibling to set
2209
+ * @since 4.10
2190
2210
  */
2191
2211
  update_next_accessible_sibling(new_sibling: Gtk.Accessible | null): void;
2192
2212
 
@@ -2197,6 +2217,7 @@ export namespace GtkSource {
2197
2217
  * have a platform state but are not widgets. Widgets handle platform
2198
2218
  * states automatically.
2199
2219
  * @param state the platform state to update
2220
+ * @since 4.18
2200
2221
  */
2201
2222
  update_platform_state(state: Gtk.AccessiblePlatformState): void;
2202
2223
 
@@ -2244,6 +2265,7 @@ export namespace GtkSource {
2244
2265
  *
2245
2266
  * It is left to the accessible implementation to define the scope
2246
2267
  * and uniqueness of the identifier.
2268
+ * @since 4.22
2247
2269
  * @virtual
2248
2270
  */
2249
2271
  vfunc_get_accessible_id(): string | null;
@@ -2252,12 +2274,14 @@ export namespace GtkSource {
2252
2274
  * Retrieves the accessible parent for an accessible object.
2253
2275
  *
2254
2276
  * This function returns `NULL` for top level widgets.
2277
+ * @since 4.10
2255
2278
  * @virtual
2256
2279
  */
2257
2280
  vfunc_get_accessible_parent(): Gtk.Accessible | null;
2258
2281
 
2259
2282
  /**
2260
2283
  * Retrieves the implementation for the given accessible object.
2284
+ * @since 4.10
2261
2285
  * @virtual
2262
2286
  */
2263
2287
  vfunc_get_at_context(): Gtk.ATContext | null;
@@ -2268,18 +2292,21 @@ export namespace GtkSource {
2268
2292
  * This functionality can be overridden by {@link Gtk.Accessible}
2269
2293
  * implementations, e.g. to get the bounds from an ignored
2270
2294
  * child widget.
2295
+ * @since 4.10
2271
2296
  * @virtual
2272
2297
  */
2273
2298
  vfunc_get_bounds(): [boolean, number, number, number, number];
2274
2299
 
2275
2300
  /**
2276
2301
  * Retrieves the first accessible child of an accessible object.
2302
+ * @since 4.10
2277
2303
  * @virtual
2278
2304
  */
2279
2305
  vfunc_get_first_accessible_child(): Gtk.Accessible | null;
2280
2306
 
2281
2307
  /**
2282
2308
  * Retrieves the next accessible sibling of an accessible object
2309
+ * @since 4.10
2283
2310
  * @virtual
2284
2311
  */
2285
2312
  vfunc_get_next_accessible_sibling(): Gtk.Accessible | null;
@@ -2291,6 +2318,7 @@ export namespace GtkSource {
2291
2318
  * implementations, e.g. to get platform state from an ignored
2292
2319
  * child widget, as is the case for {@link Gtk.Text} wrappers.
2293
2320
  * @param state platform state to query
2321
+ * @since 4.10
2294
2322
  * @virtual
2295
2323
  */
2296
2324
  vfunc_get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
@@ -2386,7 +2414,7 @@ export namespace GtkSource {
2386
2414
  /**
2387
2415
  * Stores the id attribute given in the {@link Gtk.Builder} UI definition.
2388
2416
  * {@link Gtk.Widget} stores the name as object data. Implement this method if your
2389
- * object has some notion of &#x201C;ID&#x201D; and it makes sense to map the XML id
2417
+ * object has some notion of ID and it makes sense to map the XML id
2390
2418
  * attribute to it.
2391
2419
  * @param id
2392
2420
  * @virtual
@@ -2560,6 +2588,7 @@ export namespace GtkSource {
2560
2588
  * notifications about when the model has been replaced by a new model.
2561
2589
  * @param provider a {@link GtkSource.CompletionProvider}
2562
2590
  * @returns a {@link Gio.ListModel} or `null`
2591
+ * @since 5.6
2563
2592
  */
2564
2593
  get_proposals_for_provider(provider: CompletionProvider): Gio.ListModel | null;
2565
2594
 
@@ -2578,6 +2607,7 @@ export namespace GtkSource {
2578
2607
  /**
2579
2608
  * Gets the providers that are associated with the context.
2580
2609
  * @returns a {@link Gio.ListModel} of {@link GtkSource.CompletionProvider}
2610
+ * @since 5.6
2581
2611
  */
2582
2612
  list_providers(): Gio.ListModel;
2583
2613
 
@@ -2603,6 +2633,7 @@ export namespace GtkSource {
2603
2633
  * The item type of a {@link Gio.ListModel} can not change during the life of the
2604
2634
  * model.
2605
2635
  * @returns the {@link GObject.GType} of the items contained in `list`.
2636
+ * @since 2.44
2606
2637
  */
2607
2638
  get_item_type(): GObject.GType;
2608
2639
 
@@ -2613,6 +2644,7 @@ export namespace GtkSource {
2613
2644
  * less efficient than iterating the list with increasing values for
2614
2645
  * `position` until `g_list_model_get_item()` returns `null`.
2615
2646
  * @returns the number of items in `list`.
2647
+ * @since 2.44
2616
2648
  */
2617
2649
  get_n_items(): number;
2618
2650
 
@@ -2631,6 +2663,7 @@ export namespace GtkSource {
2631
2663
  * See also: `g_list_model_get_n_items()`
2632
2664
  * @param position the position of the item to fetch
2633
2665
  * @returns the object at `position`.
2666
+ * @since 2.44
2634
2667
  */
2635
2668
  get_item(position: number): A | null;
2636
2669
 
@@ -2658,6 +2691,7 @@ export namespace GtkSource {
2658
2691
  * @param position the position at which `list` changed
2659
2692
  * @param removed the number of items removed
2660
2693
  * @param added the number of items added
2694
+ * @since 2.44
2661
2695
  */
2662
2696
  items_changed(position: number, removed: number, added: number): void;
2663
2697
 
@@ -2670,6 +2704,7 @@ export namespace GtkSource {
2670
2704
  *
2671
2705
  * The same {@link GObject.Object} instance may not appear more than once in a {@link Gio.ListModel}.
2672
2706
  * @param position the position of the item to fetch
2707
+ * @since 2.44
2673
2708
  * @virtual
2674
2709
  */
2675
2710
  vfunc_get_item(position: number): A | null;
@@ -2683,6 +2718,7 @@ export namespace GtkSource {
2683
2718
  *
2684
2719
  * The item type of a {@link Gio.ListModel} can not change during the life of the
2685
2720
  * model.
2721
+ * @since 2.44
2686
2722
  * @virtual
2687
2723
  */
2688
2724
  vfunc_get_item_type(): GObject.GType;
@@ -2693,6 +2729,7 @@ export namespace GtkSource {
2693
2729
  * Depending on the model implementation, calling this function may be
2694
2730
  * less efficient than iterating the list with increasing values for
2695
2731
  * `position` until `g_list_model_get_item()` returns `null`.
2732
+ * @since 2.44
2696
2733
  * @virtual
2697
2734
  */
2698
2735
  vfunc_get_n_items(): number;
@@ -3672,6 +3709,7 @@ export namespace GtkSource {
3672
3709
  "notify::file": (pspec: GObject.ParamSpec) => void;
3673
3710
  "notify::input-stream": (pspec: GObject.ParamSpec) => void;
3674
3711
  "notify::location": (pspec: GObject.ParamSpec) => void;
3712
+ "notify::max-size": (pspec: GObject.ParamSpec) => void;
3675
3713
  }
3676
3714
 
3677
3715
  // Constructor properties interface
@@ -3681,6 +3719,8 @@ export namespace GtkSource {
3681
3719
  input_stream: Gio.InputStream | null;
3682
3720
  inputStream: Gio.InputStream | null;
3683
3721
  location: Gio.File | null;
3722
+ max_size: bigint | number;
3723
+ maxSize: bigint | number;
3684
3724
  }
3685
3725
  }
3686
3726
 
@@ -3745,6 +3785,24 @@ export namespace GtkSource {
3745
3785
  */
3746
3786
  get location(): Gio.File | null;
3747
3787
 
3788
+ /**
3789
+ * The maximum expanded size, in bytes, that the loader will insert into
3790
+ * the buffer. A value of 0 disables the limit.
3791
+ * @since 5.22
3792
+ * @default 1073741824
3793
+ */
3794
+ get max_size(): number;
3795
+ set max_size(val: bigint | number);
3796
+
3797
+ /**
3798
+ * The maximum expanded size, in bytes, that the loader will insert into
3799
+ * the buffer. A value of 0 disables the limit.
3800
+ * @since 5.22
3801
+ * @default 1073741824
3802
+ */
3803
+ get maxSize(): number;
3804
+ set maxSize(val: bigint | number);
3805
+
3748
3806
  /**
3749
3807
  * Compile-time signal type information.
3750
3808
  *
@@ -3807,6 +3865,13 @@ export namespace GtkSource {
3807
3865
  */
3808
3866
  get_location(): Gio.File | null;
3809
3867
 
3868
+ /**
3869
+ * Gets the maximum expanded size that `loader` will insert into the buffer.
3870
+ * @returns the maximum expanded size in bytes, or 0 if the limit is disabled.
3871
+ * @since 5.22
3872
+ */
3873
+ get_max_size(): number;
3874
+
3810
3875
  /**
3811
3876
  * @returns the detected newline type.
3812
3877
  */
@@ -3873,6 +3938,16 @@ export namespace GtkSource {
3873
3938
  * @param candidate_encodings a list of {@link GtkSource.Encoding}<!-- -->s.
3874
3939
  */
3875
3940
  set_candidate_encodings(candidate_encodings: Encoding[]): void;
3941
+
3942
+ /**
3943
+ * Sets the maximum expanded size that `loader` will insert into the buffer.
3944
+ *
3945
+ * The limit is checked after decompression, so compressed files are limited by
3946
+ * the size of their uncompressed contents rather than their on-disk size.
3947
+ * @param max_size maximum expanded size in bytes, or 0 to disable the limit.
3948
+ * @since 5.22
3949
+ */
3950
+ set_max_size(max_size: bigint | number): void;
3876
3951
  }
3877
3952
 
3878
3953
 
@@ -4303,6 +4378,7 @@ export namespace GtkSource {
4303
4378
  * does not interrupts the user's current screen reader output.
4304
4379
  * @param message the string to announce
4305
4380
  * @param priority the priority of the announcement
4381
+ * @since 4.14
4306
4382
  */
4307
4383
  announce(message: string, priority: Gtk.AccessibleAnnouncementPriority): void;
4308
4384
 
@@ -4315,6 +4391,7 @@ export namespace GtkSource {
4315
4391
  * It is left to the accessible implementation to define the scope
4316
4392
  * and uniqueness of the identifier.
4317
4393
  * @returns the accessible identifier
4394
+ * @since 4.22
4318
4395
  */
4319
4396
  get_accessible_id(): string | null;
4320
4397
 
@@ -4323,6 +4400,7 @@ export namespace GtkSource {
4323
4400
  *
4324
4401
  * This function returns `NULL` for top level widgets.
4325
4402
  * @returns the accessible parent
4403
+ * @since 4.10
4326
4404
  */
4327
4405
  get_accessible_parent(): Gtk.Accessible | null;
4328
4406
 
@@ -4335,6 +4413,7 @@ export namespace GtkSource {
4335
4413
  /**
4336
4414
  * Retrieves the implementation for the given accessible object.
4337
4415
  * @returns the accessible implementation object
4416
+ * @since 4.10
4338
4417
  */
4339
4418
  get_at_context(): Gtk.ATContext;
4340
4419
 
@@ -4345,18 +4424,21 @@ export namespace GtkSource {
4345
4424
  * implementations, e.g. to get the bounds from an ignored
4346
4425
  * child widget.
4347
4426
  * @returns true if the bounds are valid, and false otherwise
4427
+ * @since 4.10
4348
4428
  */
4349
4429
  get_bounds(): [boolean, number, number, number, number];
4350
4430
 
4351
4431
  /**
4352
4432
  * Retrieves the first accessible child of an accessible object.
4353
4433
  * @returns the first accessible child
4434
+ * @since 4.10
4354
4435
  */
4355
4436
  get_first_accessible_child(): Gtk.Accessible | null;
4356
4437
 
4357
4438
  /**
4358
4439
  * Retrieves the next accessible sibling of an accessible object
4359
4440
  * @returns the next accessible sibling
4441
+ * @since 4.10
4360
4442
  */
4361
4443
  get_next_accessible_sibling(): Gtk.Accessible | null;
4362
4444
 
@@ -4368,6 +4450,7 @@ export namespace GtkSource {
4368
4450
  * child widget, as is the case for {@link Gtk.Text} wrappers.
4369
4451
  * @param state platform state to query
4370
4452
  * @returns the value of state for the accessible
4453
+ * @since 4.10
4371
4454
  */
4372
4455
  get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
4373
4456
 
@@ -4401,6 +4484,7 @@ export namespace GtkSource {
4401
4484
  * object is the container widget.
4402
4485
  * @param parent the parent accessible object
4403
4486
  * @param next_sibling the sibling accessible object
4487
+ * @since 4.10
4404
4488
  */
4405
4489
  set_accessible_parent(parent: Gtk.Accessible | null, next_sibling: Gtk.Accessible | null): void;
4406
4490
 
@@ -4410,6 +4494,7 @@ export namespace GtkSource {
4410
4494
  * That might be useful when a new child of a custom accessible
4411
4495
  * is created, and it needs to be linked to a previous child.
4412
4496
  * @param new_sibling the new next accessible sibling to set
4497
+ * @since 4.10
4413
4498
  */
4414
4499
  update_next_accessible_sibling(new_sibling: Gtk.Accessible | null): void;
4415
4500
 
@@ -4420,6 +4505,7 @@ export namespace GtkSource {
4420
4505
  * have a platform state but are not widgets. Widgets handle platform
4421
4506
  * states automatically.
4422
4507
  * @param state the platform state to update
4508
+ * @since 4.18
4423
4509
  */
4424
4510
  update_platform_state(state: Gtk.AccessiblePlatformState): void;
4425
4511
 
@@ -4467,6 +4553,7 @@ export namespace GtkSource {
4467
4553
  *
4468
4554
  * It is left to the accessible implementation to define the scope
4469
4555
  * and uniqueness of the identifier.
4556
+ * @since 4.22
4470
4557
  * @virtual
4471
4558
  */
4472
4559
  vfunc_get_accessible_id(): string | null;
@@ -4475,12 +4562,14 @@ export namespace GtkSource {
4475
4562
  * Retrieves the accessible parent for an accessible object.
4476
4563
  *
4477
4564
  * This function returns `NULL` for top level widgets.
4565
+ * @since 4.10
4478
4566
  * @virtual
4479
4567
  */
4480
4568
  vfunc_get_accessible_parent(): Gtk.Accessible | null;
4481
4569
 
4482
4570
  /**
4483
4571
  * Retrieves the implementation for the given accessible object.
4572
+ * @since 4.10
4484
4573
  * @virtual
4485
4574
  */
4486
4575
  vfunc_get_at_context(): Gtk.ATContext | null;
@@ -4491,18 +4580,21 @@ export namespace GtkSource {
4491
4580
  * This functionality can be overridden by {@link Gtk.Accessible}
4492
4581
  * implementations, e.g. to get the bounds from an ignored
4493
4582
  * child widget.
4583
+ * @since 4.10
4494
4584
  * @virtual
4495
4585
  */
4496
4586
  vfunc_get_bounds(): [boolean, number, number, number, number];
4497
4587
 
4498
4588
  /**
4499
4589
  * Retrieves the first accessible child of an accessible object.
4590
+ * @since 4.10
4500
4591
  * @virtual
4501
4592
  */
4502
4593
  vfunc_get_first_accessible_child(): Gtk.Accessible | null;
4503
4594
 
4504
4595
  /**
4505
4596
  * Retrieves the next accessible sibling of an accessible object
4597
+ * @since 4.10
4506
4598
  * @virtual
4507
4599
  */
4508
4600
  vfunc_get_next_accessible_sibling(): Gtk.Accessible | null;
@@ -4514,6 +4606,7 @@ export namespace GtkSource {
4514
4606
  * implementations, e.g. to get platform state from an ignored
4515
4607
  * child widget, as is the case for {@link Gtk.Text} wrappers.
4516
4608
  * @param state platform state to query
4609
+ * @since 4.10
4517
4610
  * @virtual
4518
4611
  */
4519
4612
  vfunc_get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
@@ -4609,7 +4702,7 @@ export namespace GtkSource {
4609
4702
  /**
4610
4703
  * Stores the id attribute given in the {@link Gtk.Builder} UI definition.
4611
4704
  * {@link Gtk.Widget} stores the name as object data. Implement this method if your
4612
- * object has some notion of &#x201C;ID&#x201D; and it makes sense to map the XML id
4705
+ * object has some notion of ID and it makes sense to map the XML id
4613
4706
  * attribute to it.
4614
4707
  * @param id
4615
4708
  * @virtual
@@ -4726,6 +4819,7 @@ export namespace GtkSource {
4726
4819
  * The value for `y` is relative to the renderers widget coordinates.
4727
4820
  * @param line a line number starting from zero
4728
4821
  * @param mode a {@link GtkSource.GutterRendererAlignmentMode}
4822
+ * @since 5.18
4729
4823
  */
4730
4824
  get_line_extent(line: number, mode: GutterRendererAlignmentMode): [number, number];
4731
4825
 
@@ -4750,6 +4844,7 @@ export namespace GtkSource {
4750
4844
  * been set on the class.
4751
4845
  * @param line a line contained within `lines`
4752
4846
  * @returns `true` if any quark was set for the line
4847
+ * @since 5.6
4753
4848
  */
4754
4849
  has_any_class(line: number): boolean;
4755
4850
 
@@ -5259,6 +5354,7 @@ export namespace GtkSource {
5259
5354
  * does not interrupts the user's current screen reader output.
5260
5355
  * @param message the string to announce
5261
5356
  * @param priority the priority of the announcement
5357
+ * @since 4.14
5262
5358
  */
5263
5359
  announce(message: string, priority: Gtk.AccessibleAnnouncementPriority): void;
5264
5360
 
@@ -5271,6 +5367,7 @@ export namespace GtkSource {
5271
5367
  * It is left to the accessible implementation to define the scope
5272
5368
  * and uniqueness of the identifier.
5273
5369
  * @returns the accessible identifier
5370
+ * @since 4.22
5274
5371
  */
5275
5372
  get_accessible_id(): string | null;
5276
5373
 
@@ -5279,6 +5376,7 @@ export namespace GtkSource {
5279
5376
  *
5280
5377
  * This function returns `NULL` for top level widgets.
5281
5378
  * @returns the accessible parent
5379
+ * @since 4.10
5282
5380
  */
5283
5381
  get_accessible_parent(): Gtk.Accessible | null;
5284
5382
 
@@ -5291,6 +5389,7 @@ export namespace GtkSource {
5291
5389
  /**
5292
5390
  * Retrieves the implementation for the given accessible object.
5293
5391
  * @returns the accessible implementation object
5392
+ * @since 4.10
5294
5393
  */
5295
5394
  get_at_context(): Gtk.ATContext;
5296
5395
 
@@ -5301,18 +5400,21 @@ export namespace GtkSource {
5301
5400
  * implementations, e.g. to get the bounds from an ignored
5302
5401
  * child widget.
5303
5402
  * @returns true if the bounds are valid, and false otherwise
5403
+ * @since 4.10
5304
5404
  */
5305
5405
  get_bounds(): [boolean, number, number, number, number];
5306
5406
 
5307
5407
  /**
5308
5408
  * Retrieves the first accessible child of an accessible object.
5309
5409
  * @returns the first accessible child
5410
+ * @since 4.10
5310
5411
  */
5311
5412
  get_first_accessible_child(): Gtk.Accessible | null;
5312
5413
 
5313
5414
  /**
5314
5415
  * Retrieves the next accessible sibling of an accessible object
5315
5416
  * @returns the next accessible sibling
5417
+ * @since 4.10
5316
5418
  */
5317
5419
  get_next_accessible_sibling(): Gtk.Accessible | null;
5318
5420
 
@@ -5324,6 +5426,7 @@ export namespace GtkSource {
5324
5426
  * child widget, as is the case for {@link Gtk.Text} wrappers.
5325
5427
  * @param state platform state to query
5326
5428
  * @returns the value of state for the accessible
5429
+ * @since 4.10
5327
5430
  */
5328
5431
  get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
5329
5432
 
@@ -5357,6 +5460,7 @@ export namespace GtkSource {
5357
5460
  * object is the container widget.
5358
5461
  * @param parent the parent accessible object
5359
5462
  * @param next_sibling the sibling accessible object
5463
+ * @since 4.10
5360
5464
  */
5361
5465
  set_accessible_parent(parent: Gtk.Accessible | null, next_sibling: Gtk.Accessible | null): void;
5362
5466
 
@@ -5366,6 +5470,7 @@ export namespace GtkSource {
5366
5470
  * That might be useful when a new child of a custom accessible
5367
5471
  * is created, and it needs to be linked to a previous child.
5368
5472
  * @param new_sibling the new next accessible sibling to set
5473
+ * @since 4.10
5369
5474
  */
5370
5475
  update_next_accessible_sibling(new_sibling: Gtk.Accessible | null): void;
5371
5476
 
@@ -5376,6 +5481,7 @@ export namespace GtkSource {
5376
5481
  * have a platform state but are not widgets. Widgets handle platform
5377
5482
  * states automatically.
5378
5483
  * @param state the platform state to update
5484
+ * @since 4.18
5379
5485
  */
5380
5486
  update_platform_state(state: Gtk.AccessiblePlatformState): void;
5381
5487
 
@@ -5423,6 +5529,7 @@ export namespace GtkSource {
5423
5529
  *
5424
5530
  * It is left to the accessible implementation to define the scope
5425
5531
  * and uniqueness of the identifier.
5532
+ * @since 4.22
5426
5533
  * @virtual
5427
5534
  */
5428
5535
  vfunc_get_accessible_id(): string | null;
@@ -5431,12 +5538,14 @@ export namespace GtkSource {
5431
5538
  * Retrieves the accessible parent for an accessible object.
5432
5539
  *
5433
5540
  * This function returns `NULL` for top level widgets.
5541
+ * @since 4.10
5434
5542
  * @virtual
5435
5543
  */
5436
5544
  vfunc_get_accessible_parent(): Gtk.Accessible | null;
5437
5545
 
5438
5546
  /**
5439
5547
  * Retrieves the implementation for the given accessible object.
5548
+ * @since 4.10
5440
5549
  * @virtual
5441
5550
  */
5442
5551
  vfunc_get_at_context(): Gtk.ATContext | null;
@@ -5447,18 +5556,21 @@ export namespace GtkSource {
5447
5556
  * This functionality can be overridden by {@link Gtk.Accessible}
5448
5557
  * implementations, e.g. to get the bounds from an ignored
5449
5558
  * child widget.
5559
+ * @since 4.10
5450
5560
  * @virtual
5451
5561
  */
5452
5562
  vfunc_get_bounds(): [boolean, number, number, number, number];
5453
5563
 
5454
5564
  /**
5455
5565
  * Retrieves the first accessible child of an accessible object.
5566
+ * @since 4.10
5456
5567
  * @virtual
5457
5568
  */
5458
5569
  vfunc_get_first_accessible_child(): Gtk.Accessible | null;
5459
5570
 
5460
5571
  /**
5461
5572
  * Retrieves the next accessible sibling of an accessible object
5573
+ * @since 4.10
5462
5574
  * @virtual
5463
5575
  */
5464
5576
  vfunc_get_next_accessible_sibling(): Gtk.Accessible | null;
@@ -5470,6 +5582,7 @@ export namespace GtkSource {
5470
5582
  * implementations, e.g. to get platform state from an ignored
5471
5583
  * child widget, as is the case for {@link Gtk.Text} wrappers.
5472
5584
  * @param state platform state to query
5585
+ * @since 4.10
5473
5586
  * @virtual
5474
5587
  */
5475
5588
  vfunc_get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
@@ -5565,7 +5678,7 @@ export namespace GtkSource {
5565
5678
  /**
5566
5679
  * Stores the id attribute given in the {@link Gtk.Builder} UI definition.
5567
5680
  * {@link Gtk.Widget} stores the name as object data. Implement this method if your
5568
- * object has some notion of &#x201C;ID&#x201D; and it makes sense to map the XML id
5681
+ * object has some notion of ID and it makes sense to map the XML id
5569
5682
  * attribute to it.
5570
5683
  * @param id
5571
5684
  * @virtual
@@ -6208,6 +6321,7 @@ export namespace GtkSource {
6208
6321
  * does not interrupts the user's current screen reader output.
6209
6322
  * @param message the string to announce
6210
6323
  * @param priority the priority of the announcement
6324
+ * @since 4.14
6211
6325
  */
6212
6326
  announce(message: string, priority: Gtk.AccessibleAnnouncementPriority): void;
6213
6327
 
@@ -6220,6 +6334,7 @@ export namespace GtkSource {
6220
6334
  * It is left to the accessible implementation to define the scope
6221
6335
  * and uniqueness of the identifier.
6222
6336
  * @returns the accessible identifier
6337
+ * @since 4.22
6223
6338
  */
6224
6339
  get_accessible_id(): string | null;
6225
6340
 
@@ -6228,6 +6343,7 @@ export namespace GtkSource {
6228
6343
  *
6229
6344
  * This function returns `NULL` for top level widgets.
6230
6345
  * @returns the accessible parent
6346
+ * @since 4.10
6231
6347
  */
6232
6348
  get_accessible_parent(): Gtk.Accessible | null;
6233
6349
 
@@ -6240,6 +6356,7 @@ export namespace GtkSource {
6240
6356
  /**
6241
6357
  * Retrieves the implementation for the given accessible object.
6242
6358
  * @returns the accessible implementation object
6359
+ * @since 4.10
6243
6360
  */
6244
6361
  get_at_context(): Gtk.ATContext;
6245
6362
 
@@ -6250,18 +6367,21 @@ export namespace GtkSource {
6250
6367
  * implementations, e.g. to get the bounds from an ignored
6251
6368
  * child widget.
6252
6369
  * @returns true if the bounds are valid, and false otherwise
6370
+ * @since 4.10
6253
6371
  */
6254
6372
  get_bounds(): [boolean, number, number, number, number];
6255
6373
 
6256
6374
  /**
6257
6375
  * Retrieves the first accessible child of an accessible object.
6258
6376
  * @returns the first accessible child
6377
+ * @since 4.10
6259
6378
  */
6260
6379
  get_first_accessible_child(): Gtk.Accessible | null;
6261
6380
 
6262
6381
  /**
6263
6382
  * Retrieves the next accessible sibling of an accessible object
6264
6383
  * @returns the next accessible sibling
6384
+ * @since 4.10
6265
6385
  */
6266
6386
  get_next_accessible_sibling(): Gtk.Accessible | null;
6267
6387
 
@@ -6273,6 +6393,7 @@ export namespace GtkSource {
6273
6393
  * child widget, as is the case for {@link Gtk.Text} wrappers.
6274
6394
  * @param state platform state to query
6275
6395
  * @returns the value of state for the accessible
6396
+ * @since 4.10
6276
6397
  */
6277
6398
  get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
6278
6399
 
@@ -6306,6 +6427,7 @@ export namespace GtkSource {
6306
6427
  * object is the container widget.
6307
6428
  * @param parent the parent accessible object
6308
6429
  * @param next_sibling the sibling accessible object
6430
+ * @since 4.10
6309
6431
  */
6310
6432
  set_accessible_parent(parent: Gtk.Accessible | null, next_sibling: Gtk.Accessible | null): void;
6311
6433
 
@@ -6315,6 +6437,7 @@ export namespace GtkSource {
6315
6437
  * That might be useful when a new child of a custom accessible
6316
6438
  * is created, and it needs to be linked to a previous child.
6317
6439
  * @param new_sibling the new next accessible sibling to set
6440
+ * @since 4.10
6318
6441
  */
6319
6442
  update_next_accessible_sibling(new_sibling: Gtk.Accessible | null): void;
6320
6443
 
@@ -6325,6 +6448,7 @@ export namespace GtkSource {
6325
6448
  * have a platform state but are not widgets. Widgets handle platform
6326
6449
  * states automatically.
6327
6450
  * @param state the platform state to update
6451
+ * @since 4.18
6328
6452
  */
6329
6453
  update_platform_state(state: Gtk.AccessiblePlatformState): void;
6330
6454
 
@@ -6372,6 +6496,7 @@ export namespace GtkSource {
6372
6496
  *
6373
6497
  * It is left to the accessible implementation to define the scope
6374
6498
  * and uniqueness of the identifier.
6499
+ * @since 4.22
6375
6500
  * @virtual
6376
6501
  */
6377
6502
  vfunc_get_accessible_id(): string | null;
@@ -6380,12 +6505,14 @@ export namespace GtkSource {
6380
6505
  * Retrieves the accessible parent for an accessible object.
6381
6506
  *
6382
6507
  * This function returns `NULL` for top level widgets.
6508
+ * @since 4.10
6383
6509
  * @virtual
6384
6510
  */
6385
6511
  vfunc_get_accessible_parent(): Gtk.Accessible | null;
6386
6512
 
6387
6513
  /**
6388
6514
  * Retrieves the implementation for the given accessible object.
6515
+ * @since 4.10
6389
6516
  * @virtual
6390
6517
  */
6391
6518
  vfunc_get_at_context(): Gtk.ATContext | null;
@@ -6396,18 +6523,21 @@ export namespace GtkSource {
6396
6523
  * This functionality can be overridden by {@link Gtk.Accessible}
6397
6524
  * implementations, e.g. to get the bounds from an ignored
6398
6525
  * child widget.
6526
+ * @since 4.10
6399
6527
  * @virtual
6400
6528
  */
6401
6529
  vfunc_get_bounds(): [boolean, number, number, number, number];
6402
6530
 
6403
6531
  /**
6404
6532
  * Retrieves the first accessible child of an accessible object.
6533
+ * @since 4.10
6405
6534
  * @virtual
6406
6535
  */
6407
6536
  vfunc_get_first_accessible_child(): Gtk.Accessible | null;
6408
6537
 
6409
6538
  /**
6410
6539
  * Retrieves the next accessible sibling of an accessible object
6540
+ * @since 4.10
6411
6541
  * @virtual
6412
6542
  */
6413
6543
  vfunc_get_next_accessible_sibling(): Gtk.Accessible | null;
@@ -6419,6 +6549,7 @@ export namespace GtkSource {
6419
6549
  * implementations, e.g. to get platform state from an ignored
6420
6550
  * child widget, as is the case for {@link Gtk.Text} wrappers.
6421
6551
  * @param state platform state to query
6552
+ * @since 4.10
6422
6553
  * @virtual
6423
6554
  */
6424
6555
  vfunc_get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
@@ -6514,7 +6645,7 @@ export namespace GtkSource {
6514
6645
  /**
6515
6646
  * Stores the id attribute given in the {@link Gtk.Builder} UI definition.
6516
6647
  * {@link Gtk.Widget} stores the name as object data. Implement this method if your
6517
- * object has some notion of &#x201C;ID&#x201D; and it makes sense to map the XML id
6648
+ * object has some notion of ID and it makes sense to map the XML id
6518
6649
  * attribute to it.
6519
6650
  * @param id
6520
6651
  * @virtual
@@ -6781,6 +6912,7 @@ export namespace GtkSource {
6781
6912
  *
6782
6913
  * See {@link LanguageManager.set_search_path} for details.
6783
6914
  * @param path a directory or a filename.
6915
+ * @since 5.4
6784
6916
  */
6785
6917
  append_search_path(path: string): void;
6786
6918
 
@@ -6868,6 +7000,7 @@ export namespace GtkSource {
6868
7000
  *
6869
7001
  * See {@link LanguageManager.set_search_path} for details.
6870
7002
  * @param path a directory or a filename.
7003
+ * @since 5.4
6871
7004
  */
6872
7005
  prepend_search_path(path: string): void;
6873
7006
 
@@ -7950,6 +8083,7 @@ export namespace GtkSource {
7950
8083
  * Specifies a tag whose style should be ignored when compositing the
7951
8084
  * document to the printable page.
7952
8085
  * @param tag a {@link Gtk.TextTag}
8086
+ * @since 5.2
7953
8087
  */
7954
8088
  ignore_tag(tag: Gtk.TextTag): void;
7955
8089
 
@@ -9077,6 +9211,7 @@ export namespace GtkSource {
9077
9211
 
9078
9212
  /**
9079
9213
  * @returns whether to exclude invisible text from the search.
9214
+ * @since 5.12
9080
9215
  */
9081
9216
  get_visible_only(): boolean;
9082
9217
 
@@ -9132,6 +9267,7 @@ export namespace GtkSource {
9132
9267
  * If enabled, only visible text will be searched.
9133
9268
  * A search match may have invisible text interspersed.
9134
9269
  * @param visible_only the setting.
9270
+ * @since 5.12
9135
9271
  */
9136
9272
  set_visible_only(visible_only: boolean): void;
9137
9273
 
@@ -9818,6 +9954,7 @@ export namespace GtkSource {
9818
9954
  * This can be used to get an unfiltered list of all of the snippets
9819
9955
  * known to the snippet manager.
9820
9956
  * @returns a {@link Gio.ListModel} of {@link GtkSource.Snippet}
9957
+ * @since 5.6
9821
9958
  */
9822
9959
  list_all(): Gio.ListModel;
9823
9960
 
@@ -10524,6 +10661,7 @@ export namespace GtkSource {
10524
10661
  * Gets a metadata property from the style scheme.
10525
10662
  * @param name metadata property name.
10526
10663
  * @returns value of property `name` stored in the metadata of `scheme` or `null` if `scheme` does not contain the specified metadata property.
10664
+ * @since 5.4
10527
10665
  */
10528
10666
  get_metadata(name: string): string | null;
10529
10667
 
@@ -10707,7 +10845,7 @@ export namespace GtkSource {
10707
10845
  * Usually this function is used when the widget is located (or will be
10708
10846
  * located) within the hierarchy of a {@link Gtk.ApplicationWindow}.
10709
10847
  *
10710
- * Names are of the form &#x201C;win.save&#x201D; or &#x201C;app.quit&#x201D; for actions on the
10848
+ * Names are of the form win.save or app.quit for actions on the
10711
10849
  * containing {@link ApplicationWindow} or its associated {@link Application},
10712
10850
  * respectively. This is the same form used for actions in the {@link Gio.Menu}
10713
10851
  * associated with the window.
@@ -10723,14 +10861,14 @@ export namespace GtkSource {
10723
10861
  * The target value has two purposes. First, it is used as the parameter
10724
10862
  * to activation of the action associated with the {@link Gtk.Actionable} widget.
10725
10863
  * Second, it is used to determine if the widget should be rendered as
10726
- * &#x201C;active&#x201D; &#x2014; the widget is active if the state is equal to the given target.
10864
+ * active the widget is active if the state is equal to the given target.
10727
10865
  *
10728
10866
  * Consider the example of associating a set of buttons with a {@link Gio.Action}
10729
- * with string state in a typical &#x201C;radio button&#x201D; situation. Each button
10867
+ * with string state in a typical radio button situation. Each button
10730
10868
  * will be associated with the same action, but with a different target
10731
10869
  * value for that action. Clicking on a particular button will activate
10732
10870
  * the action with the target of that button, which will typically cause
10733
- * the action&#x2019;s state to change to that value. Since the action&#x2019;s state
10871
+ * the actions state to change to that value. Since the actions state
10734
10872
  * is now equal to the target value of the button, the button will now
10735
10873
  * be rendered as active (and the other buttons, with different targets,
10736
10874
  * rendered inactive).
@@ -10770,7 +10908,7 @@ export namespace GtkSource {
10770
10908
  * Usually this function is used when the widget is located (or will be
10771
10909
  * located) within the hierarchy of a {@link Gtk.ApplicationWindow}.
10772
10910
  *
10773
- * Names are of the form &#x201C;win.save&#x201D; or &#x201C;app.quit&#x201D; for actions on the
10911
+ * Names are of the form win.save or app.quit for actions on the
10774
10912
  * containing {@link ApplicationWindow} or its associated {@link Application},
10775
10913
  * respectively. This is the same form used for actions in the {@link Gio.Menu}
10776
10914
  * associated with the window.
@@ -10787,14 +10925,14 @@ export namespace GtkSource {
10787
10925
  * The target value has two purposes. First, it is used as the parameter
10788
10926
  * to activation of the action associated with the {@link Gtk.Actionable} widget.
10789
10927
  * Second, it is used to determine if the widget should be rendered as
10790
- * &#x201C;active&#x201D; &#x2014; the widget is active if the state is equal to the given target.
10928
+ * active the widget is active if the state is equal to the given target.
10791
10929
  *
10792
10930
  * Consider the example of associating a set of buttons with a {@link Gio.Action}
10793
- * with string state in a typical &#x201C;radio button&#x201D; situation. Each button
10931
+ * with string state in a typical radio button situation. Each button
10794
10932
  * will be associated with the same action, but with a different target
10795
10933
  * value for that action. Clicking on a particular button will activate
10796
10934
  * the action with the target of that button, which will typically cause
10797
- * the action&#x2019;s state to change to that value. Since the action&#x2019;s state
10935
+ * the actions state to change to that value. Since the actions state
10798
10936
  * is now equal to the target value of the button, the button will now
10799
10937
  * be rendered as active (and the other buttons, with different targets,
10800
10938
  * rendered inactive).
@@ -10971,6 +11109,7 @@ export namespace GtkSource {
10971
11109
  * does not interrupts the user's current screen reader output.
10972
11110
  * @param message the string to announce
10973
11111
  * @param priority the priority of the announcement
11112
+ * @since 4.14
10974
11113
  */
10975
11114
  announce(message: string, priority: Gtk.AccessibleAnnouncementPriority): void;
10976
11115
 
@@ -10983,6 +11122,7 @@ export namespace GtkSource {
10983
11122
  * It is left to the accessible implementation to define the scope
10984
11123
  * and uniqueness of the identifier.
10985
11124
  * @returns the accessible identifier
11125
+ * @since 4.22
10986
11126
  */
10987
11127
  get_accessible_id(): string | null;
10988
11128
 
@@ -10991,6 +11131,7 @@ export namespace GtkSource {
10991
11131
  *
10992
11132
  * This function returns `NULL` for top level widgets.
10993
11133
  * @returns the accessible parent
11134
+ * @since 4.10
10994
11135
  */
10995
11136
  get_accessible_parent(): Gtk.Accessible | null;
10996
11137
 
@@ -11003,6 +11144,7 @@ export namespace GtkSource {
11003
11144
  /**
11004
11145
  * Retrieves the implementation for the given accessible object.
11005
11146
  * @returns the accessible implementation object
11147
+ * @since 4.10
11006
11148
  */
11007
11149
  get_at_context(): Gtk.ATContext;
11008
11150
 
@@ -11013,18 +11155,21 @@ export namespace GtkSource {
11013
11155
  * implementations, e.g. to get the bounds from an ignored
11014
11156
  * child widget.
11015
11157
  * @returns true if the bounds are valid, and false otherwise
11158
+ * @since 4.10
11016
11159
  */
11017
11160
  get_bounds(): [boolean, number, number, number, number];
11018
11161
 
11019
11162
  /**
11020
11163
  * Retrieves the first accessible child of an accessible object.
11021
11164
  * @returns the first accessible child
11165
+ * @since 4.10
11022
11166
  */
11023
11167
  get_first_accessible_child(): Gtk.Accessible | null;
11024
11168
 
11025
11169
  /**
11026
11170
  * Retrieves the next accessible sibling of an accessible object
11027
11171
  * @returns the next accessible sibling
11172
+ * @since 4.10
11028
11173
  */
11029
11174
  get_next_accessible_sibling(): Gtk.Accessible | null;
11030
11175
 
@@ -11036,6 +11181,7 @@ export namespace GtkSource {
11036
11181
  * child widget, as is the case for {@link Gtk.Text} wrappers.
11037
11182
  * @param state platform state to query
11038
11183
  * @returns the value of state for the accessible
11184
+ * @since 4.10
11039
11185
  */
11040
11186
  get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
11041
11187
 
@@ -11069,6 +11215,7 @@ export namespace GtkSource {
11069
11215
  * object is the container widget.
11070
11216
  * @param parent the parent accessible object
11071
11217
  * @param next_sibling the sibling accessible object
11218
+ * @since 4.10
11072
11219
  */
11073
11220
  set_accessible_parent(parent: Gtk.Accessible | null, next_sibling: Gtk.Accessible | null): void;
11074
11221
 
@@ -11078,6 +11225,7 @@ export namespace GtkSource {
11078
11225
  * That might be useful when a new child of a custom accessible
11079
11226
  * is created, and it needs to be linked to a previous child.
11080
11227
  * @param new_sibling the new next accessible sibling to set
11228
+ * @since 4.10
11081
11229
  */
11082
11230
  update_next_accessible_sibling(new_sibling: Gtk.Accessible | null): void;
11083
11231
 
@@ -11088,6 +11236,7 @@ export namespace GtkSource {
11088
11236
  * have a platform state but are not widgets. Widgets handle platform
11089
11237
  * states automatically.
11090
11238
  * @param state the platform state to update
11239
+ * @since 4.18
11091
11240
  */
11092
11241
  update_platform_state(state: Gtk.AccessiblePlatformState): void;
11093
11242
 
@@ -11135,6 +11284,7 @@ export namespace GtkSource {
11135
11284
  *
11136
11285
  * It is left to the accessible implementation to define the scope
11137
11286
  * and uniqueness of the identifier.
11287
+ * @since 4.22
11138
11288
  * @virtual
11139
11289
  */
11140
11290
  vfunc_get_accessible_id(): string | null;
@@ -11143,12 +11293,14 @@ export namespace GtkSource {
11143
11293
  * Retrieves the accessible parent for an accessible object.
11144
11294
  *
11145
11295
  * This function returns `NULL` for top level widgets.
11296
+ * @since 4.10
11146
11297
  * @virtual
11147
11298
  */
11148
11299
  vfunc_get_accessible_parent(): Gtk.Accessible | null;
11149
11300
 
11150
11301
  /**
11151
11302
  * Retrieves the implementation for the given accessible object.
11303
+ * @since 4.10
11152
11304
  * @virtual
11153
11305
  */
11154
11306
  vfunc_get_at_context(): Gtk.ATContext | null;
@@ -11159,18 +11311,21 @@ export namespace GtkSource {
11159
11311
  * This functionality can be overridden by {@link Gtk.Accessible}
11160
11312
  * implementations, e.g. to get the bounds from an ignored
11161
11313
  * child widget.
11314
+ * @since 4.10
11162
11315
  * @virtual
11163
11316
  */
11164
11317
  vfunc_get_bounds(): [boolean, number, number, number, number];
11165
11318
 
11166
11319
  /**
11167
11320
  * Retrieves the first accessible child of an accessible object.
11321
+ * @since 4.10
11168
11322
  * @virtual
11169
11323
  */
11170
11324
  vfunc_get_first_accessible_child(): Gtk.Accessible | null;
11171
11325
 
11172
11326
  /**
11173
11327
  * Retrieves the next accessible sibling of an accessible object
11328
+ * @since 4.10
11174
11329
  * @virtual
11175
11330
  */
11176
11331
  vfunc_get_next_accessible_sibling(): Gtk.Accessible | null;
@@ -11182,6 +11337,7 @@ export namespace GtkSource {
11182
11337
  * implementations, e.g. to get platform state from an ignored
11183
11338
  * child widget, as is the case for {@link Gtk.Text} wrappers.
11184
11339
  * @param state platform state to query
11340
+ * @since 4.10
11185
11341
  * @virtual
11186
11342
  */
11187
11343
  vfunc_get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
@@ -11277,7 +11433,7 @@ export namespace GtkSource {
11277
11433
  /**
11278
11434
  * Stores the id attribute given in the {@link Gtk.Builder} UI definition.
11279
11435
  * {@link Gtk.Widget} stores the name as object data. Implement this method if your
11280
- * object has some notion of &#x201C;ID&#x201D; and it makes sense to map the XML id
11436
+ * object has some notion of ID and it makes sense to map the XML id
11281
11437
  * attribute to it.
11282
11438
  * @param id
11283
11439
  * @virtual
@@ -11564,6 +11720,7 @@ export namespace GtkSource {
11564
11720
  /**
11565
11721
  * Gets the {@link GtkSource.StyleScheme} previewed by the widget.
11566
11722
  * @returns a {@link GtkSource.StyleScheme}
11723
+ * @since 5.4
11567
11724
  */
11568
11725
  get_scheme(): StyleScheme;
11569
11726
 
@@ -11636,6 +11793,7 @@ export namespace GtkSource {
11636
11793
  * does not interrupts the user's current screen reader output.
11637
11794
  * @param message the string to announce
11638
11795
  * @param priority the priority of the announcement
11796
+ * @since 4.14
11639
11797
  */
11640
11798
  announce(message: string, priority: Gtk.AccessibleAnnouncementPriority): void;
11641
11799
 
@@ -11648,6 +11806,7 @@ export namespace GtkSource {
11648
11806
  * It is left to the accessible implementation to define the scope
11649
11807
  * and uniqueness of the identifier.
11650
11808
  * @returns the accessible identifier
11809
+ * @since 4.22
11651
11810
  */
11652
11811
  get_accessible_id(): string | null;
11653
11812
 
@@ -11656,6 +11815,7 @@ export namespace GtkSource {
11656
11815
  *
11657
11816
  * This function returns `NULL` for top level widgets.
11658
11817
  * @returns the accessible parent
11818
+ * @since 4.10
11659
11819
  */
11660
11820
  get_accessible_parent(): Gtk.Accessible | null;
11661
11821
 
@@ -11668,6 +11828,7 @@ export namespace GtkSource {
11668
11828
  /**
11669
11829
  * Retrieves the implementation for the given accessible object.
11670
11830
  * @returns the accessible implementation object
11831
+ * @since 4.10
11671
11832
  */
11672
11833
  get_at_context(): Gtk.ATContext;
11673
11834
 
@@ -11678,18 +11839,21 @@ export namespace GtkSource {
11678
11839
  * implementations, e.g. to get the bounds from an ignored
11679
11840
  * child widget.
11680
11841
  * @returns true if the bounds are valid, and false otherwise
11842
+ * @since 4.10
11681
11843
  */
11682
11844
  get_bounds(): [boolean, number, number, number, number];
11683
11845
 
11684
11846
  /**
11685
11847
  * Retrieves the first accessible child of an accessible object.
11686
11848
  * @returns the first accessible child
11849
+ * @since 4.10
11687
11850
  */
11688
11851
  get_first_accessible_child(): Gtk.Accessible | null;
11689
11852
 
11690
11853
  /**
11691
11854
  * Retrieves the next accessible sibling of an accessible object
11692
11855
  * @returns the next accessible sibling
11856
+ * @since 4.10
11693
11857
  */
11694
11858
  get_next_accessible_sibling(): Gtk.Accessible | null;
11695
11859
 
@@ -11701,6 +11865,7 @@ export namespace GtkSource {
11701
11865
  * child widget, as is the case for {@link Gtk.Text} wrappers.
11702
11866
  * @param state platform state to query
11703
11867
  * @returns the value of state for the accessible
11868
+ * @since 4.10
11704
11869
  */
11705
11870
  get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
11706
11871
 
@@ -11734,6 +11899,7 @@ export namespace GtkSource {
11734
11899
  * object is the container widget.
11735
11900
  * @param parent the parent accessible object
11736
11901
  * @param next_sibling the sibling accessible object
11902
+ * @since 4.10
11737
11903
  */
11738
11904
  set_accessible_parent(parent: Gtk.Accessible | null, next_sibling: Gtk.Accessible | null): void;
11739
11905
 
@@ -11743,6 +11909,7 @@ export namespace GtkSource {
11743
11909
  * That might be useful when a new child of a custom accessible
11744
11910
  * is created, and it needs to be linked to a previous child.
11745
11911
  * @param new_sibling the new next accessible sibling to set
11912
+ * @since 4.10
11746
11913
  */
11747
11914
  update_next_accessible_sibling(new_sibling: Gtk.Accessible | null): void;
11748
11915
 
@@ -11753,6 +11920,7 @@ export namespace GtkSource {
11753
11920
  * have a platform state but are not widgets. Widgets handle platform
11754
11921
  * states automatically.
11755
11922
  * @param state the platform state to update
11923
+ * @since 4.18
11756
11924
  */
11757
11925
  update_platform_state(state: Gtk.AccessiblePlatformState): void;
11758
11926
 
@@ -11800,6 +11968,7 @@ export namespace GtkSource {
11800
11968
  *
11801
11969
  * It is left to the accessible implementation to define the scope
11802
11970
  * and uniqueness of the identifier.
11971
+ * @since 4.22
11803
11972
  * @virtual
11804
11973
  */
11805
11974
  vfunc_get_accessible_id(): string | null;
@@ -11808,12 +11977,14 @@ export namespace GtkSource {
11808
11977
  * Retrieves the accessible parent for an accessible object.
11809
11978
  *
11810
11979
  * This function returns `NULL` for top level widgets.
11980
+ * @since 4.10
11811
11981
  * @virtual
11812
11982
  */
11813
11983
  vfunc_get_accessible_parent(): Gtk.Accessible | null;
11814
11984
 
11815
11985
  /**
11816
11986
  * Retrieves the implementation for the given accessible object.
11987
+ * @since 4.10
11817
11988
  * @virtual
11818
11989
  */
11819
11990
  vfunc_get_at_context(): Gtk.ATContext | null;
@@ -11824,18 +11995,21 @@ export namespace GtkSource {
11824
11995
  * This functionality can be overridden by {@link Gtk.Accessible}
11825
11996
  * implementations, e.g. to get the bounds from an ignored
11826
11997
  * child widget.
11998
+ * @since 4.10
11827
11999
  * @virtual
11828
12000
  */
11829
12001
  vfunc_get_bounds(): [boolean, number, number, number, number];
11830
12002
 
11831
12003
  /**
11832
12004
  * Retrieves the first accessible child of an accessible object.
12005
+ * @since 4.10
11833
12006
  * @virtual
11834
12007
  */
11835
12008
  vfunc_get_first_accessible_child(): Gtk.Accessible | null;
11836
12009
 
11837
12010
  /**
11838
12011
  * Retrieves the next accessible sibling of an accessible object
12012
+ * @since 4.10
11839
12013
  * @virtual
11840
12014
  */
11841
12015
  vfunc_get_next_accessible_sibling(): Gtk.Accessible | null;
@@ -11847,6 +12021,7 @@ export namespace GtkSource {
11847
12021
  * implementations, e.g. to get platform state from an ignored
11848
12022
  * child widget, as is the case for {@link Gtk.Text} wrappers.
11849
12023
  * @param state platform state to query
12024
+ * @since 4.10
11850
12025
  * @virtual
11851
12026
  */
11852
12027
  vfunc_get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
@@ -11873,7 +12048,7 @@ export namespace GtkSource {
11873
12048
  * Usually this function is used when the widget is located (or will be
11874
12049
  * located) within the hierarchy of a {@link Gtk.ApplicationWindow}.
11875
12050
  *
11876
- * Names are of the form &#x201C;win.save&#x201D; or &#x201C;app.quit&#x201D; for actions on the
12051
+ * Names are of the form win.save or app.quit for actions on the
11877
12052
  * containing {@link ApplicationWindow} or its associated {@link Application},
11878
12053
  * respectively. This is the same form used for actions in the {@link Gio.Menu}
11879
12054
  * associated with the window.
@@ -11889,14 +12064,14 @@ export namespace GtkSource {
11889
12064
  * The target value has two purposes. First, it is used as the parameter
11890
12065
  * to activation of the action associated with the {@link Gtk.Actionable} widget.
11891
12066
  * Second, it is used to determine if the widget should be rendered as
11892
- * &#x201C;active&#x201D; &#x2014; the widget is active if the state is equal to the given target.
12067
+ * active the widget is active if the state is equal to the given target.
11893
12068
  *
11894
12069
  * Consider the example of associating a set of buttons with a {@link Gio.Action}
11895
- * with string state in a typical &#x201C;radio button&#x201D; situation. Each button
12070
+ * with string state in a typical radio button situation. Each button
11896
12071
  * will be associated with the same action, but with a different target
11897
12072
  * value for that action. Clicking on a particular button will activate
11898
12073
  * the action with the target of that button, which will typically cause
11899
- * the action&#x2019;s state to change to that value. Since the action&#x2019;s state
12074
+ * the actions state to change to that value. Since the actions state
11900
12075
  * is now equal to the target value of the button, the button will now
11901
12076
  * be rendered as active (and the other buttons, with different targets,
11902
12077
  * rendered inactive).
@@ -11936,7 +12111,7 @@ export namespace GtkSource {
11936
12111
  * Usually this function is used when the widget is located (or will be
11937
12112
  * located) within the hierarchy of a {@link Gtk.ApplicationWindow}.
11938
12113
  *
11939
- * Names are of the form &#x201C;win.save&#x201D; or &#x201C;app.quit&#x201D; for actions on the
12114
+ * Names are of the form win.save or app.quit for actions on the
11940
12115
  * containing {@link ApplicationWindow} or its associated {@link Application},
11941
12116
  * respectively. This is the same form used for actions in the {@link Gio.Menu}
11942
12117
  * associated with the window.
@@ -11953,14 +12128,14 @@ export namespace GtkSource {
11953
12128
  * The target value has two purposes. First, it is used as the parameter
11954
12129
  * to activation of the action associated with the {@link Gtk.Actionable} widget.
11955
12130
  * Second, it is used to determine if the widget should be rendered as
11956
- * &#x201C;active&#x201D; &#x2014; the widget is active if the state is equal to the given target.
12131
+ * active the widget is active if the state is equal to the given target.
11957
12132
  *
11958
12133
  * Consider the example of associating a set of buttons with a {@link Gio.Action}
11959
- * with string state in a typical &#x201C;radio button&#x201D; situation. Each button
12134
+ * with string state in a typical radio button situation. Each button
11960
12135
  * will be associated with the same action, but with a different target
11961
12136
  * value for that action. Clicking on a particular button will activate
11962
12137
  * the action with the target of that button, which will typically cause
11963
- * the action&#x2019;s state to change to that value. Since the action&#x2019;s state
12138
+ * the actions state to change to that value. Since the actions state
11964
12139
  * is now equal to the target value of the button, the button will now
11965
12140
  * be rendered as active (and the other buttons, with different targets,
11966
12141
  * rendered inactive).
@@ -12060,7 +12235,7 @@ export namespace GtkSource {
12060
12235
  /**
12061
12236
  * Stores the id attribute given in the {@link Gtk.Builder} UI definition.
12062
12237
  * {@link Gtk.Widget} stores the name as object data. Implement this method if your
12063
- * object has some notion of &#x201C;ID&#x201D; and it makes sense to map the XML id
12238
+ * object has some notion of ID and it makes sense to map the XML id
12064
12239
  * attribute to it.
12065
12240
  * @param id
12066
12241
  * @virtual
@@ -12854,6 +13029,7 @@ export namespace GtkSource {
12854
13029
  * The returned object is guaranteed to be the same for the lifetime of `view`.
12855
13030
  * Each {@link View} object has a different {@link Annotations}.
12856
13031
  * @returns the {@link GtkSource.Annotations} associated with `view`.
13032
+ * @since 5.18
12857
13033
  */
12858
13034
  get_annotations(): Annotations;
12859
13035
 
@@ -13241,6 +13417,7 @@ export namespace GtkSource {
13241
13417
  * Implementations of the {@link Gtk.AccessibleText} interface should call this
13242
13418
  * function every time the caret has moved, in order to notify assistive
13243
13419
  * technologies.
13420
+ * @since 4.14
13244
13421
  */
13245
13422
  update_caret_position(): void;
13246
13423
 
@@ -13257,6 +13434,7 @@ export namespace GtkSource {
13257
13434
  * @param change the type of change in the contents
13258
13435
  * @param start the starting offset of the change, in characters
13259
13436
  * @param end the end offset of the change, in characters
13437
+ * @since 4.14
13260
13438
  */
13261
13439
  update_contents(change: Gtk.AccessibleTextContentChange, start: number, end: number): void;
13262
13440
 
@@ -13266,6 +13444,7 @@ export namespace GtkSource {
13266
13444
  * Implementations of the {@link Gtk.AccessibleText} interface should call this
13267
13445
  * function every time the selection has moved, in order to notify assistive
13268
13446
  * technologies.
13447
+ * @since 4.14
13269
13448
  */
13270
13449
  update_selection_bound(): void;
13271
13450
 
@@ -13288,12 +13467,14 @@ export namespace GtkSource {
13288
13467
  * greater than or equal to one, `ranges` will be set to a newly
13289
13468
  * allocated array of [struct#Gtk.AccessibleTextRange].
13290
13469
  * @param offset the offset, in characters
13470
+ * @since 4.14
13291
13471
  * @virtual
13292
13472
  */
13293
13473
  vfunc_get_attributes(offset: number): [boolean, Gtk.AccessibleTextRange[] | null, string[] | null, string[] | null];
13294
13474
 
13295
13475
  /**
13296
13476
  * Retrieves the position of the caret inside the accessible object.
13477
+ * @since 4.14
13297
13478
  * @virtual
13298
13479
  */
13299
13480
  vfunc_get_caret_position(): number;
@@ -13306,6 +13487,7 @@ export namespace GtkSource {
13306
13487
  * of the accessible object.
13307
13488
  * @param start the beginning of the range, in characters
13308
13489
  * @param end the end of the range, in characters
13490
+ * @since 4.14
13309
13491
  * @virtual
13310
13492
  */
13311
13493
  vfunc_get_contents(start: number, end: number): GLib.Bytes | Uint8Array;
@@ -13317,6 +13499,7 @@ export namespace GtkSource {
13317
13499
  * The `start` and `end` values contain the boundaries of the text.
13318
13500
  * @param offset the offset, in characters
13319
13501
  * @param granularity the granularity of the query
13502
+ * @since 4.14
13320
13503
  * @virtual
13321
13504
  */
13322
13505
  vfunc_get_contents_at(offset: number, granularity: Gtk.AccessibleTextGranularity): [GLib.Bytes | Uint8Array, number, number];
@@ -13334,6 +13517,7 @@ export namespace GtkSource {
13334
13517
  *
13335
13518
  * GTK provides support for various text attribute names and values, but
13336
13519
  * implementations of this interface are free to add their own attributes.
13520
+ * @since 4.14
13337
13521
  * @virtual
13338
13522
  */
13339
13523
  vfunc_get_default_attributes(): [string[] | null, string[] | null];
@@ -13343,6 +13527,7 @@ export namespace GtkSource {
13343
13527
  * @param start the start offset, in characters
13344
13528
  * @param end the end offset, in characters, `extents` (out caller-allocates): return location for the extents
13345
13529
  * @param extents
13530
+ * @since 4.16
13346
13531
  * @virtual
13347
13532
  */
13348
13533
  vfunc_get_extents(start: number, end: number, extents: Graphene.Rect): boolean;
@@ -13350,6 +13535,7 @@ export namespace GtkSource {
13350
13535
  /**
13351
13536
  * Gets the text offset at a given point.
13352
13537
  * @param point a point in widget coordinates of `self`
13538
+ * @since 4.16
13353
13539
  * @virtual
13354
13540
  */
13355
13541
  vfunc_get_offset(point: Graphene.Point): [boolean, number];
@@ -13360,6 +13546,7 @@ export namespace GtkSource {
13360
13546
  * If this function returns true, `n_ranges` will be set to a value
13361
13547
  * greater than or equal to one, and `ranges` will be set to a newly
13362
13548
  * allocated array of [struct#Gtk.AccessibleTextRange].
13549
+ * @since 4.14
13363
13550
  * @virtual
13364
13551
  */
13365
13552
  vfunc_get_selection(): [boolean, Gtk.AccessibleTextRange[] | null];
@@ -13367,6 +13554,7 @@ export namespace GtkSource {
13367
13554
  /**
13368
13555
  * Sets the caret position.
13369
13556
  * @param offset the text offset in characters
13557
+ * @since 4.22
13370
13558
  * @virtual
13371
13559
  */
13372
13560
  vfunc_set_caret_position(offset: number): boolean;
@@ -13375,6 +13563,7 @@ export namespace GtkSource {
13375
13563
  * Sets the caret position.
13376
13564
  * @param i the selection to set
13377
13565
  * @param range the range to set the selection to
13566
+ * @since 4.22
13378
13567
  * @virtual
13379
13568
  */
13380
13569
  vfunc_set_selection(i: number, range: Gtk.AccessibleTextRange): boolean;
@@ -13654,18 +13843,21 @@ export namespace GtkSource {
13654
13843
  * user except that this does not emit the
13655
13844
  * `GtkSource.VimIMContext::execute-command` signal.
13656
13845
  * @param command the command text
13846
+ * @since 5.4
13657
13847
  */
13658
13848
  execute_command(command: string): void;
13659
13849
 
13660
13850
  /**
13661
13851
  * Gets the current command-bar text as it is entered by the user.
13662
13852
  * @returns A string containing the command-bar text
13853
+ * @since 5.4
13663
13854
  */
13664
13855
  get_command_bar_text(): string;
13665
13856
 
13666
13857
  /**
13667
13858
  * Gets the current command text as it is entered by the user.
13668
13859
  * @returns A string containing the command text
13860
+ * @since 5.4
13669
13861
  */
13670
13862
  get_command_text(): string;
13671
13863
  }
@@ -14032,6 +14224,7 @@ export namespace GtkSource {
14032
14224
  *
14033
14225
  * Implementing this virtual-function is optional, but can be useful to allow
14034
14226
  * external tooling to compare results.
14227
+ * @since 5.6
14035
14228
  * @virtual
14036
14229
  */
14037
14230
  vfunc_get_typed_text(): string | null;
@@ -14067,6 +14260,7 @@ export namespace GtkSource {
14067
14260
  * Implementing this virtual-function is optional, but can be useful to allow
14068
14261
  * external tooling to compare results.
14069
14262
  * @returns a newly allocated string, or `null`
14263
+ * @since 5.6
14070
14264
  */
14071
14265
  get_typed_text(): string | null;
14072
14266
  }