@girs/gobject-2.0 2.76.1-3.2.3 → 2.77.0-3.2.8

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/gobject-2.0.d.cts CHANGED
@@ -238,7 +238,7 @@ export enum SignalMatchType {
238
238
  * These flags used to be passed to g_type_init_with_debug_flags() which
239
239
  * is now deprecated.
240
240
  *
241
- * If you need to enable debugging features, use the GOBJECT_DEBUG
241
+ * If you need to enable debugging features, use the `GOBJECT_DEBUG`
242
242
  * environment variable.
243
243
  * @bitfield
244
244
  */
@@ -721,14 +721,14 @@ export function enum_get_value(enum_class: EnumClass, value: number): EnumValue
721
721
  * @param name the name to look up
722
722
  * @returns the #GEnumValue with name @name, or %NULL if the enumeration doesn't have a member with that name
723
723
  */
724
- export function enum_get_value_by_name(enum_class: EnumClass, name: string | null): EnumValue | null
724
+ export function enum_get_value_by_name(enum_class: EnumClass, name: string): EnumValue | null
725
725
  /**
726
726
  * Looks up a #GEnumValue by nickname.
727
727
  * @param enum_class a #GEnumClass
728
728
  * @param nick the nickname to look up
729
729
  * @returns the #GEnumValue with nickname @nick, or %NULL if the enumeration doesn't have a member with that nickname
730
730
  */
731
- export function enum_get_value_by_nick(enum_class: EnumClass, nick: string | null): EnumValue | null
731
+ export function enum_get_value_by_nick(enum_class: EnumClass, nick: string): EnumValue | null
732
732
  /**
733
733
  * Registers a new static enumeration type with the name `name`.
734
734
  *
@@ -739,7 +739,7 @@ export function enum_get_value_by_nick(enum_class: EnumClass, nick: string | nul
739
739
  * @param const_static_values An array of #GEnumValue structs for the possible enumeration values. The array is terminated by a struct with all members being 0. GObject keeps a reference to the data, so it cannot be stack-allocated.
740
740
  * @returns The new type identifier.
741
741
  */
742
- export function enum_register_static(name: string | null, const_static_values: EnumValue): GType
742
+ export function enum_register_static(name: string, const_static_values: EnumValue): GType
743
743
  /**
744
744
  * Pretty-prints `value` in the form of the enum’s name.
745
745
  *
@@ -771,14 +771,14 @@ export function flags_get_first_value(flags_class: FlagsClass, value: number): F
771
771
  * @param name the name to look up
772
772
  * @returns the #GFlagsValue with name @name, or %NULL if there is no flag with that name
773
773
  */
774
- export function flags_get_value_by_name(flags_class: FlagsClass, name: string | null): FlagsValue | null
774
+ export function flags_get_value_by_name(flags_class: FlagsClass, name: string): FlagsValue | null
775
775
  /**
776
776
  * Looks up a #GFlagsValue by nickname.
777
777
  * @param flags_class a #GFlagsClass
778
778
  * @param nick the nickname to look up
779
779
  * @returns the #GFlagsValue with nickname @nick, or %NULL if there is no flag with that nickname
780
780
  */
781
- export function flags_get_value_by_nick(flags_class: FlagsClass, nick: string | null): FlagsValue | null
781
+ export function flags_get_value_by_nick(flags_class: FlagsClass, nick: string): FlagsValue | null
782
782
  /**
783
783
  * Registers a new static flags type with the name `name`.
784
784
  *
@@ -789,7 +789,7 @@ export function flags_get_value_by_nick(flags_class: FlagsClass, nick: string |
789
789
  * @param const_static_values An array of #GFlagsValue structs for the possible flags values. The array is terminated by a struct with all members being 0. GObject keeps a reference to the data, so it cannot be stack-allocated.
790
790
  * @returns The new type identifier.
791
791
  */
792
- export function flags_register_static(name: string | null, const_static_values: FlagsValue): GType
792
+ export function flags_register_static(name: string, const_static_values: FlagsValue): GType
793
793
  /**
794
794
  * Pretty-prints `value` in the form of the flag names separated by ` | ` and
795
795
  * sorted. Any extra bits will be shown at the end as a hexadecimal number.
@@ -817,7 +817,7 @@ export function gtype_get_type(): GType
817
817
  * @param flags flags for the property specified
818
818
  * @returns a newly created parameter specification
819
819
  */
820
- export function param_spec_boolean(name: string | null, nick: string | null, blurb: string | null, default_value: boolean, flags: ParamFlags): ParamSpec
820
+ export function param_spec_boolean(name: string, nick: string | null, blurb: string | null, default_value: boolean, flags: ParamFlags): ParamSpec
821
821
  /**
822
822
  * Creates a new #GParamSpecBoxed instance specifying a %G_TYPE_BOXED
823
823
  * derived property.
@@ -830,7 +830,7 @@ export function param_spec_boolean(name: string | null, nick: string | null, blu
830
830
  * @param flags flags for the property specified
831
831
  * @returns a newly created parameter specification
832
832
  */
833
- export function param_spec_boxed(name: string | null, nick: string | null, blurb: string | null, boxed_type: GType, flags: ParamFlags): ParamSpec
833
+ export function param_spec_boxed(name: string, nick: string | null, blurb: string | null, boxed_type: GType, flags: ParamFlags): ParamSpec
834
834
  /**
835
835
  * Creates a new #GParamSpecChar instance specifying a %G_TYPE_CHAR property.
836
836
  * @param name canonical name of the property specified
@@ -842,7 +842,7 @@ export function param_spec_boxed(name: string | null, nick: string | null, blurb
842
842
  * @param flags flags for the property specified
843
843
  * @returns a newly created parameter specification
844
844
  */
845
- export function param_spec_char(name: string | null, nick: string | null, blurb: string | null, minimum: number, maximum: number, default_value: number, flags: ParamFlags): ParamSpec
845
+ export function param_spec_char(name: string, nick: string | null, blurb: string | null, minimum: number, maximum: number, default_value: number, flags: ParamFlags): ParamSpec
846
846
  /**
847
847
  * Creates a new #GParamSpecDouble instance specifying a %G_TYPE_DOUBLE
848
848
  * property.
@@ -857,7 +857,7 @@ export function param_spec_char(name: string | null, nick: string | null, blurb:
857
857
  * @param flags flags for the property specified
858
858
  * @returns a newly created parameter specification
859
859
  */
860
- export function param_spec_double(name: string | null, nick: string | null, blurb: string | null, minimum: number, maximum: number, default_value: number, flags: ParamFlags): ParamSpec
860
+ export function param_spec_double(name: string, nick: string | null, blurb: string | null, minimum: number, maximum: number, default_value: number, flags: ParamFlags): ParamSpec
861
861
  /**
862
862
  * Creates a new #GParamSpecEnum instance specifying a %G_TYPE_ENUM
863
863
  * property.
@@ -871,7 +871,7 @@ export function param_spec_double(name: string | null, nick: string | null, blur
871
871
  * @param flags flags for the property specified
872
872
  * @returns a newly created parameter specification
873
873
  */
874
- export function param_spec_enum(name: string | null, nick: string | null, blurb: string | null, enum_type: GType, default_value: number, flags: ParamFlags): ParamSpec
874
+ export function param_spec_enum(name: string, nick: string | null, blurb: string | null, enum_type: GType, default_value: number, flags: ParamFlags): ParamSpec
875
875
  /**
876
876
  * Creates a new #GParamSpecFlags instance specifying a %G_TYPE_FLAGS
877
877
  * property.
@@ -885,7 +885,7 @@ export function param_spec_enum(name: string | null, nick: string | null, blurb:
885
885
  * @param flags flags for the property specified
886
886
  * @returns a newly created parameter specification
887
887
  */
888
- export function param_spec_flags(name: string | null, nick: string | null, blurb: string | null, flags_type: GType, default_value: number, flags: ParamFlags): ParamSpec
888
+ export function param_spec_flags(name: string, nick: string | null, blurb: string | null, flags_type: GType, default_value: number, flags: ParamFlags): ParamSpec
889
889
  /**
890
890
  * Creates a new #GParamSpecFloat instance specifying a %G_TYPE_FLOAT property.
891
891
  *
@@ -899,7 +899,7 @@ export function param_spec_flags(name: string | null, nick: string | null, blurb
899
899
  * @param flags flags for the property specified
900
900
  * @returns a newly created parameter specification
901
901
  */
902
- export function param_spec_float(name: string | null, nick: string | null, blurb: string | null, minimum: number, maximum: number, default_value: number, flags: ParamFlags): ParamSpec
902
+ export function param_spec_float(name: string, nick: string | null, blurb: string | null, minimum: number, maximum: number, default_value: number, flags: ParamFlags): ParamSpec
903
903
  /**
904
904
  * Creates a new #GParamSpecGType instance specifying a
905
905
  * %G_TYPE_GTYPE property.
@@ -912,7 +912,7 @@ export function param_spec_float(name: string | null, nick: string | null, blurb
912
912
  * @param flags flags for the property specified
913
913
  * @returns a newly created parameter specification
914
914
  */
915
- export function param_spec_gtype(name: string | null, nick: string | null, blurb: string | null, is_a_type: GType, flags: ParamFlags): ParamSpec
915
+ export function param_spec_gtype(name: string, nick: string | null, blurb: string | null, is_a_type: GType, flags: ParamFlags): ParamSpec
916
916
  /**
917
917
  * Creates a new #GParamSpecInt instance specifying a %G_TYPE_INT property.
918
918
  *
@@ -926,7 +926,7 @@ export function param_spec_gtype(name: string | null, nick: string | null, blurb
926
926
  * @param flags flags for the property specified
927
927
  * @returns a newly created parameter specification
928
928
  */
929
- export function param_spec_int(name: string | null, nick: string | null, blurb: string | null, minimum: number, maximum: number, default_value: number, flags: ParamFlags): ParamSpec
929
+ export function param_spec_int(name: string, nick: string | null, blurb: string | null, minimum: number, maximum: number, default_value: number, flags: ParamFlags): ParamSpec
930
930
  /**
931
931
  * Creates a new #GParamSpecInt64 instance specifying a %G_TYPE_INT64 property.
932
932
  *
@@ -940,7 +940,7 @@ export function param_spec_int(name: string | null, nick: string | null, blurb:
940
940
  * @param flags flags for the property specified
941
941
  * @returns a newly created parameter specification
942
942
  */
943
- export function param_spec_int64(name: string | null, nick: string | null, blurb: string | null, minimum: number, maximum: number, default_value: number, flags: ParamFlags): ParamSpec
943
+ export function param_spec_int64(name: string, nick: string | null, blurb: string | null, minimum: number, maximum: number, default_value: number, flags: ParamFlags): ParamSpec
944
944
  /**
945
945
  * Creates a new #GParamSpecLong instance specifying a %G_TYPE_LONG property.
946
946
  *
@@ -954,7 +954,7 @@ export function param_spec_int64(name: string | null, nick: string | null, blurb
954
954
  * @param flags flags for the property specified
955
955
  * @returns a newly created parameter specification
956
956
  */
957
- export function param_spec_long(name: string | null, nick: string | null, blurb: string | null, minimum: number, maximum: number, default_value: number, flags: ParamFlags): ParamSpec
957
+ export function param_spec_long(name: string, nick: string | null, blurb: string | null, minimum: number, maximum: number, default_value: number, flags: ParamFlags): ParamSpec
958
958
  /**
959
959
  * Creates a new #GParamSpecBoxed instance specifying a %G_TYPE_OBJECT
960
960
  * derived property.
@@ -967,7 +967,7 @@ export function param_spec_long(name: string | null, nick: string | null, blurb:
967
967
  * @param flags flags for the property specified
968
968
  * @returns a newly created parameter specification
969
969
  */
970
- export function param_spec_object(name: string | null, nick: string | null, blurb: string | null, object_type: GType, flags: ParamFlags): ParamSpec
970
+ export function param_spec_object(name: string, nick: string | null, blurb: string | null, object_type: GType, flags: ParamFlags): ParamSpec
971
971
  /**
972
972
  * Creates a new #GParamSpecParam instance specifying a %G_TYPE_PARAM
973
973
  * property.
@@ -980,7 +980,7 @@ export function param_spec_object(name: string | null, nick: string | null, blur
980
980
  * @param flags flags for the property specified
981
981
  * @returns a newly created parameter specification
982
982
  */
983
- export function param_spec_param(name: string | null, nick: string | null, blurb: string | null, param_type: GType, flags: ParamFlags): ParamSpec
983
+ export function param_spec_param(name: string, nick: string | null, blurb: string | null, param_type: GType, flags: ParamFlags): ParamSpec
984
984
  /**
985
985
  * Creates a new #GParamSpecPointer instance specifying a pointer property.
986
986
  * Where possible, it is better to use g_param_spec_object() or
@@ -993,7 +993,7 @@ export function param_spec_param(name: string | null, nick: string | null, blurb
993
993
  * @param flags flags for the property specified
994
994
  * @returns a newly created parameter specification
995
995
  */
996
- export function param_spec_pointer(name: string | null, nick: string | null, blurb: string | null, flags: ParamFlags): ParamSpec
996
+ export function param_spec_pointer(name: string, nick: string | null, blurb: string | null, flags: ParamFlags): ParamSpec
997
997
  /**
998
998
  * Creates a new #GParamSpecString instance.
999
999
  *
@@ -1005,7 +1005,7 @@ export function param_spec_pointer(name: string | null, nick: string | null, blu
1005
1005
  * @param flags flags for the property specified
1006
1006
  * @returns a newly created parameter specification
1007
1007
  */
1008
- export function param_spec_string(name: string | null, nick: string | null, blurb: string | null, default_value: string | null, flags: ParamFlags): ParamSpec
1008
+ export function param_spec_string(name: string, nick: string | null, blurb: string | null, default_value: string | null, flags: ParamFlags): ParamSpec
1009
1009
  /**
1010
1010
  * Creates a new #GParamSpecUChar instance specifying a %G_TYPE_UCHAR property.
1011
1011
  * @param name canonical name of the property specified
@@ -1017,7 +1017,7 @@ export function param_spec_string(name: string | null, nick: string | null, blur
1017
1017
  * @param flags flags for the property specified
1018
1018
  * @returns a newly created parameter specification
1019
1019
  */
1020
- export function param_spec_uchar(name: string | null, nick: string | null, blurb: string | null, minimum: number, maximum: number, default_value: number, flags: ParamFlags): ParamSpec
1020
+ export function param_spec_uchar(name: string, nick: string | null, blurb: string | null, minimum: number, maximum: number, default_value: number, flags: ParamFlags): ParamSpec
1021
1021
  /**
1022
1022
  * Creates a new #GParamSpecUInt instance specifying a %G_TYPE_UINT property.
1023
1023
  *
@@ -1031,7 +1031,7 @@ export function param_spec_uchar(name: string | null, nick: string | null, blurb
1031
1031
  * @param flags flags for the property specified
1032
1032
  * @returns a newly created parameter specification
1033
1033
  */
1034
- export function param_spec_uint(name: string | null, nick: string | null, blurb: string | null, minimum: number, maximum: number, default_value: number, flags: ParamFlags): ParamSpec
1034
+ export function param_spec_uint(name: string, nick: string | null, blurb: string | null, minimum: number, maximum: number, default_value: number, flags: ParamFlags): ParamSpec
1035
1035
  /**
1036
1036
  * Creates a new #GParamSpecUInt64 instance specifying a %G_TYPE_UINT64
1037
1037
  * property.
@@ -1046,7 +1046,7 @@ export function param_spec_uint(name: string | null, nick: string | null, blurb:
1046
1046
  * @param flags flags for the property specified
1047
1047
  * @returns a newly created parameter specification
1048
1048
  */
1049
- export function param_spec_uint64(name: string | null, nick: string | null, blurb: string | null, minimum: number, maximum: number, default_value: number, flags: ParamFlags): ParamSpec
1049
+ export function param_spec_uint64(name: string, nick: string | null, blurb: string | null, minimum: number, maximum: number, default_value: number, flags: ParamFlags): ParamSpec
1050
1050
  /**
1051
1051
  * Creates a new #GParamSpecULong instance specifying a %G_TYPE_ULONG
1052
1052
  * property.
@@ -1061,7 +1061,7 @@ export function param_spec_uint64(name: string | null, nick: string | null, blur
1061
1061
  * @param flags flags for the property specified
1062
1062
  * @returns a newly created parameter specification
1063
1063
  */
1064
- export function param_spec_ulong(name: string | null, nick: string | null, blurb: string | null, minimum: number, maximum: number, default_value: number, flags: ParamFlags): ParamSpec
1064
+ export function param_spec_ulong(name: string, nick: string | null, blurb: string | null, minimum: number, maximum: number, default_value: number, flags: ParamFlags): ParamSpec
1065
1065
  /**
1066
1066
  * Creates a new #GParamSpecUnichar instance specifying a %G_TYPE_UINT
1067
1067
  * property. #GValue structures for this property can be accessed with
@@ -1075,7 +1075,7 @@ export function param_spec_ulong(name: string | null, nick: string | null, blurb
1075
1075
  * @param flags flags for the property specified
1076
1076
  * @returns a newly created parameter specification
1077
1077
  */
1078
- export function param_spec_unichar(name: string | null, nick: string | null, blurb: string | null, default_value: string, flags: ParamFlags): ParamSpec
1078
+ export function param_spec_unichar(name: string, nick: string | null, blurb: string | null, default_value: string, flags: ParamFlags): ParamSpec
1079
1079
  /**
1080
1080
  * Creates a new #GParamSpecVariant instance specifying a #GVariant
1081
1081
  * property.
@@ -1091,7 +1091,7 @@ export function param_spec_unichar(name: string | null, nick: string | null, blu
1091
1091
  * @param flags flags for the property specified
1092
1092
  * @returns the newly created #GParamSpec
1093
1093
  */
1094
- export function param_spec_variant(name: string | null, nick: string | null, blurb: string | null, type: GLib.VariantType, default_value: GLib.Variant | null, flags: ParamFlags): ParamSpec
1094
+ export function param_spec_variant(name: string, nick: string | null, blurb: string | null, type: GLib.VariantType, default_value: GLib.Variant | null, flags: ParamFlags): ParamSpec
1095
1095
  /**
1096
1096
  * Registers `name` as the name of a new static type derived
1097
1097
  * from %G_TYPE_PARAM.
@@ -1103,7 +1103,7 @@ export function param_spec_variant(name: string | null, nick: string | null, blu
1103
1103
  * @param pspec_info The #GParamSpecTypeInfo for this #GParamSpec type.
1104
1104
  * @returns The new type identifier.
1105
1105
  */
1106
- export function param_type_register_static(name: string | null, pspec_info: ParamSpecTypeInfo): GType
1106
+ export function param_type_register_static(name: string, pspec_info: ParamSpecTypeInfo): GType
1107
1107
  /**
1108
1108
  * Transforms `src_value` into `dest_value` if possible, and then
1109
1109
  * validates `dest_value,` in order for it to conform to `pspec`. If
@@ -1168,7 +1168,7 @@ export function param_values_cmp(pspec: ParamSpec, value1: any, value2: any): nu
1168
1168
  * @param name the name of the new pointer type.
1169
1169
  * @returns a new %G_TYPE_POINTER derived type id for @name.
1170
1170
  */
1171
- export function pointer_type_register_static(name: string | null): GType
1171
+ export function pointer_type_register_static(name: string): GType
1172
1172
  /**
1173
1173
  * A predefined #GSignalAccumulator for signals intended to be used as a
1174
1174
  * hook for application code to provide a particular value. Usually
@@ -1231,7 +1231,7 @@ export function signal_chain_from_overridden(instance_and_params: any[], return_
1231
1231
  * @param after whether the handler should be called before or after the default handler of the signal.
1232
1232
  * @returns the handler ID (always greater than 0 for successful connections)
1233
1233
  */
1234
- export function signal_connect_closure(instance: Object, detailed_signal: string | null, closure: TClosure, after: boolean): number
1234
+ export function signal_connect_closure(instance: Object, detailed_signal: string, closure: TClosure, after: boolean): number
1235
1235
  /**
1236
1236
  * Connects a closure to a signal for a particular object.
1237
1237
  *
@@ -1329,12 +1329,18 @@ export function signal_handler_is_connected(instance: Object, handler_id: number
1329
1329
  export function signal_handler_unblock(instance: Object, handler_id: number): void
1330
1330
  /**
1331
1331
  * Blocks all handlers on an instance that match a certain selection criteria.
1332
- * The criteria mask is passed as an OR-ed combination of #GSignalMatchType
1333
- * flags, and the criteria values are passed as arguments.
1334
- * Passing at least one of the %G_SIGNAL_MATCH_CLOSURE, %G_SIGNAL_MATCH_FUNC
1332
+ *
1333
+ * The criteria mask is passed as a combination of #GSignalMatchType flags, and
1334
+ * the criteria values are passed as arguments. A handler must match on all
1335
+ * flags set in `mask` to be blocked (i.e. the match is conjunctive).
1336
+ *
1337
+ * Passing at least one of the %G_SIGNAL_MATCH_ID, %G_SIGNAL_MATCH_CLOSURE,
1338
+ * %G_SIGNAL_MATCH_FUNC
1335
1339
  * or %G_SIGNAL_MATCH_DATA match flags is required for successful matches.
1336
1340
  * If no handlers were found, 0 is returned, the number of blocked handlers
1337
1341
  * otherwise.
1342
+ *
1343
+ * Support for %G_SIGNAL_MATCH_ID was added in GLib 2.78.
1338
1344
  * @param instance The instance to block handlers from.
1339
1345
  * @param mask Mask indicating which of `signal_id,` `detail,` `closure,` `func` and/or `data` the handlers have to match.
1340
1346
  * @param signal_id Signal the handlers have to be connected to.
@@ -1353,13 +1359,19 @@ export function signal_handlers_block_matched(instance: Object, mask: SignalMatc
1353
1359
  export function signal_handlers_destroy(instance: Object): void
1354
1360
  /**
1355
1361
  * Disconnects all handlers on an instance that match a certain
1356
- * selection criteria. The criteria mask is passed as an OR-ed
1357
- * combination of #GSignalMatchType flags, and the criteria values are
1358
- * passed as arguments. Passing at least one of the
1359
- * %G_SIGNAL_MATCH_CLOSURE, %G_SIGNAL_MATCH_FUNC or
1362
+ * selection criteria.
1363
+ *
1364
+ * The criteria mask is passed as a combination of #GSignalMatchType flags, and
1365
+ * the criteria values are passed as arguments. A handler must match on all
1366
+ * flags set in `mask` to be disconnected (i.e. the match is conjunctive).
1367
+ *
1368
+ * Passing at least one of the %G_SIGNAL_MATCH_ID, %G_SIGNAL_MATCH_CLOSURE,
1369
+ * %G_SIGNAL_MATCH_FUNC or
1360
1370
  * %G_SIGNAL_MATCH_DATA match flags is required for successful
1361
1371
  * matches. If no handlers were found, 0 is returned, the number of
1362
1372
  * disconnected handlers otherwise.
1373
+ *
1374
+ * Support for %G_SIGNAL_MATCH_ID was added in GLib 2.78.
1363
1375
  * @param instance The instance to remove handlers from.
1364
1376
  * @param mask Mask indicating which of `signal_id,` `detail,` `closure,` `func` and/or `data` the handlers have to match.
1365
1377
  * @param signal_id Signal the handlers have to be connected to.
@@ -1371,13 +1383,20 @@ export function signal_handlers_destroy(instance: Object): void
1371
1383
  export function signal_handlers_disconnect_matched(instance: Object, mask: SignalMatchType, signal_id: number, detail: GLib.Quark, func: any | null, data: any | null): number
1372
1384
  /**
1373
1385
  * Unblocks all handlers on an instance that match a certain selection
1374
- * criteria. The criteria mask is passed as an OR-ed combination of
1375
- * #GSignalMatchType flags, and the criteria values are passed as arguments.
1376
- * Passing at least one of the %G_SIGNAL_MATCH_CLOSURE, %G_SIGNAL_MATCH_FUNC
1386
+ * criteria.
1387
+ *
1388
+ * The criteria mask is passed as a combination of #GSignalMatchType flags, and
1389
+ * the criteria values are passed as arguments. A handler must match on all
1390
+ * flags set in `mask` to be unblocked (i.e. the match is conjunctive).
1391
+ *
1392
+ * Passing at least one of the %G_SIGNAL_MATCH_ID, %G_SIGNAL_MATCH_CLOSURE,
1393
+ * %G_SIGNAL_MATCH_FUNC
1377
1394
  * or %G_SIGNAL_MATCH_DATA match flags is required for successful matches.
1378
1395
  * If no handlers were found, 0 is returned, the number of unblocked handlers
1379
1396
  * otherwise. The match criteria should not apply to any handlers that are
1380
1397
  * not currently blocked.
1398
+ *
1399
+ * Support for %G_SIGNAL_MATCH_ID was added in GLib 2.78.
1381
1400
  * @param instance The instance to unblock handlers from.
1382
1401
  * @param mask Mask indicating which of `signal_id,` `detail,` `closure,` `func` and/or `data` the handlers have to match.
1383
1402
  * @param signal_id Signal the handlers have to be connected to.
@@ -1421,7 +1440,7 @@ export function signal_has_handler_pending(instance: Object, signal_id: number,
1421
1440
  * @param name the canonical name of the signal
1422
1441
  * @returns %TRUE if @name is a valid signal name, %FALSE otherwise.
1423
1442
  */
1424
- export function signal_is_valid_name(name: string | null): boolean
1443
+ export function signal_is_valid_name(name: string): boolean
1425
1444
  /**
1426
1445
  * Lists the signals by id that a certain instance or interface type
1427
1446
  * created. Further information about the signals can be acquired through
@@ -1446,7 +1465,7 @@ export function signal_list_ids(itype: GType): number[]
1446
1465
  * @param itype the type that the signal operates on.
1447
1466
  * @returns the signal's identifying number, or 0 if no signal was found.
1448
1467
  */
1449
- export function signal_lookup(name: string | null, itype: GType): number
1468
+ export function signal_lookup(name: string, itype: GType): number
1450
1469
  /**
1451
1470
  * Given the signal's identifier, finds its name.
1452
1471
  *
@@ -1476,7 +1495,7 @@ export function signal_override_class_closure(signal_id: number, instance_type:
1476
1495
  * @param force_detail_quark %TRUE forces creation of a #GQuark for the detail.
1477
1496
  * @returns Whether the signal name could successfully be parsed and @signal_id_p and @detail_p contain valid return values.
1478
1497
  */
1479
- export function signal_parse_name(detailed_signal: string | null, itype: GType, force_detail_quark: boolean): [ /* returnType */ boolean, /* signal_id_p */ number, /* detail_p */ GLib.Quark ]
1498
+ export function signal_parse_name(detailed_signal: string, itype: GType, force_detail_quark: boolean): [ /* returnType */ boolean, /* signal_id_p */ number, /* detail_p */ GLib.Quark ]
1480
1499
  /**
1481
1500
  * Queries the signal system for in-depth information about a
1482
1501
  * specific signal. This function will fill in a user-provided
@@ -1524,7 +1543,7 @@ export function signal_stop_emission(instance: Object, signal_id: number, detail
1524
1543
  * @param instance the object whose signal handlers you wish to stop.
1525
1544
  * @param detailed_signal a string of the form "signal-name::detail".
1526
1545
  */
1527
- export function signal_stop_emission_by_name(instance: Object, detailed_signal: string | null): void
1546
+ export function signal_stop_emission_by_name(instance: Object, detailed_signal: string): void
1528
1547
  /**
1529
1548
  * Creates a new closure which invokes the function found at the offset
1530
1549
  * `struct_offset` in the class structure of the interface or classed type
@@ -1718,7 +1737,7 @@ export function type_free_instance(instance: TypeInstance): void
1718
1737
  * @param name type name to look up
1719
1738
  * @returns corresponding type ID or 0
1720
1739
  */
1721
- export function type_from_name(name: string | null): GType
1740
+ export function type_from_name(name: string): GType
1722
1741
  /**
1723
1742
  * Internal function, used to extract the fundamental type ID portion.
1724
1743
  * Use G_TYPE_FUNDAMENTAL() instead.
@@ -1737,8 +1756,8 @@ export function type_fundamental_next(): GType
1737
1756
  /**
1738
1757
  * Returns the number of instances allocated of the particular type;
1739
1758
  * this is only available if GLib is built with debugging support and
1740
- * the instance_count debug flag is set (by setting the GOBJECT_DEBUG
1741
- * variable to include instance-count).
1759
+ * the `instance-count` debug flag is set (by setting the `GOBJECT_DEBUG`
1760
+ * variable to include `instance-count`).
1742
1761
  * @param type a #GType
1743
1762
  * @returns the number of instances allocated of the given type; if instance counts are not available, returns 0.
1744
1763
  */
@@ -1781,7 +1800,7 @@ export function type_init(): void
1781
1800
  * flags. Since GLib 2.36, the type system is initialised automatically
1782
1801
  * and this function does nothing.
1783
1802
  *
1784
- * If you need to enable debugging features, use the GOBJECT_DEBUG
1803
+ * If you need to enable debugging features, use the `GOBJECT_DEBUG`
1785
1804
  * environment variable.
1786
1805
  * @param debug_flags bitwise combination of #GTypeDebugFlags values for debugging purposes
1787
1806
  */
@@ -1857,8 +1876,8 @@ export function type_is_a(type: GType, is_a_type: GType): boolean
1857
1876
  * @returns static type name or %NULL
1858
1877
  */
1859
1878
  export function type_name(type: GType): string | null
1860
- export function type_name_from_class(g_class: TypeClass): string | null
1861
- export function type_name_from_instance(instance: TypeInstance): string | null
1879
+ export function type_name_from_class(g_class: TypeClass): string
1880
+ export function type_name_from_instance(instance: TypeInstance): string
1862
1881
  /**
1863
1882
  * Given a `leaf_type` and a `root_type` which is contained in its
1864
1883
  * ancestry, return the type that `root_type` is the immediate parent
@@ -1907,7 +1926,7 @@ export function type_query(type: GType): /* query */ TypeQuery
1907
1926
  * @param flags bitwise combination of #GTypeFlags values
1908
1927
  * @returns the new type identifier or %G_TYPE_INVALID if registration failed
1909
1928
  */
1910
- export function type_register_dynamic(parent_type: GType, type_name: string | null, plugin: TypePlugin, flags: TypeFlags): GType
1929
+ export function type_register_dynamic(parent_type: GType, type_name: string, plugin: TypePlugin, flags: TypeFlags): GType
1911
1930
  /**
1912
1931
  * Registers `type_id` as the predefined identifier and `type_name` as the
1913
1932
  * name of a fundamental type. If `type_id` is already registered, or a
@@ -1923,7 +1942,7 @@ export function type_register_dynamic(parent_type: GType, type_name: string | nu
1923
1942
  * @param flags bitwise combination of #GTypeFlags values
1924
1943
  * @returns the predefined type identifier
1925
1944
  */
1926
- export function type_register_fundamental(type_id: GType, type_name: string | null, info: TypeInfo, finfo: TypeFundamentalInfo, flags: TypeFlags): GType
1945
+ export function type_register_fundamental(type_id: GType, type_name: string, info: TypeInfo, finfo: TypeFundamentalInfo, flags: TypeFlags): GType
1927
1946
  /**
1928
1947
  * Registers `type_name` as the name of a new static type derived from
1929
1948
  * `parent_type`. The type system uses the information contained in the
@@ -1936,7 +1955,7 @@ export function type_register_fundamental(type_id: GType, type_name: string | nu
1936
1955
  * @param flags bitwise combination of #GTypeFlags values
1937
1956
  * @returns the new type identifier
1938
1957
  */
1939
- export function type_register_static(parent_type: GType, type_name: string | null, info: TypeInfo, flags: TypeFlags): GType
1958
+ export function type_register_static(parent_type: GType, type_name: string, info: TypeInfo, flags: TypeFlags): GType
1940
1959
  /**
1941
1960
  * Attaches arbitrary data to a type.
1942
1961
  * @param type a #GType
@@ -2388,6 +2407,226 @@ export interface TypePluginUnuse {
2388
2407
  export interface TypePluginUse {
2389
2408
  (plugin: TypePlugin): void
2390
2409
  }
2410
+ /**
2411
+ * This function is responsible for converting the values collected from
2412
+ * a variadic argument list into contents suitable for storage in a #GValue.
2413
+ *
2414
+ * This function should setup `value` similar to #GTypeValueInitFunc; e.g.
2415
+ * for a string value that does not allow `NULL` pointers, it needs to either
2416
+ * emit an error, or do an implicit conversion by storing an empty string.
2417
+ *
2418
+ * The `value` passed in to this function has a zero-filled data array, so
2419
+ * just like for #GTypeValueInitFunc it is guaranteed to not contain any old
2420
+ * contents that might need freeing.
2421
+ *
2422
+ * The `n_collect_values` argument is the string length of the `collect_format`
2423
+ * field of #GTypeValueTable, and `collect_values` is an array of #GTypeCValue
2424
+ * with length of `n_collect_values,` containing the collected values according
2425
+ * to `collect_format`.
2426
+ *
2427
+ * The `collect_flags` argument provided as a hint by the caller. It may
2428
+ * contain the flag %G_VALUE_NOCOPY_CONTENTS indicating that the collected
2429
+ * value contents may be considered ‘static’ for the duration of the `value`
2430
+ * lifetime. Thus an extra copy of the contents stored in `collect_values` is
2431
+ * not required for assignment to `value`.
2432
+ *
2433
+ * For our above string example, we continue with:
2434
+ *
2435
+ *
2436
+ * ```c
2437
+ * if (!collect_values[0].v_pointer)
2438
+ * value->data[0].v_pointer = g_strdup ("");
2439
+ * else if (collect_flags & G_VALUE_NOCOPY_CONTENTS)
2440
+ * {
2441
+ * value->data[0].v_pointer = collect_values[0].v_pointer;
2442
+ * // keep a flag for the value_free() implementation to not free this string
2443
+ * value->data[1].v_uint = G_VALUE_NOCOPY_CONTENTS;
2444
+ * }
2445
+ * else
2446
+ * value->data[0].v_pointer = g_strdup (collect_values[0].v_pointer);
2447
+ * return NULL;
2448
+ * ```
2449
+ *
2450
+ *
2451
+ * It should be noted, that it is generally a bad idea to follow the
2452
+ * %G_VALUE_NOCOPY_CONTENTS hint for reference counted types. Due to
2453
+ * reentrancy requirements and reference count assertions performed
2454
+ * by the signal emission code, reference counts should always be
2455
+ * incremented for reference counted contents stored in the `value->data`
2456
+ * array. To deviate from our string example for a moment, and taking
2457
+ * a look at an exemplary implementation for `GTypeValueTable.collect_value()`
2458
+ * of `GObject`:
2459
+ *
2460
+ *
2461
+ * ```c
2462
+ * GObject *object = G_OBJECT (collect_values[0].v_pointer);
2463
+ * g_return_val_if_fail (object != NULL,
2464
+ * g_strdup_printf ("Object %p passed as invalid NULL pointer", object));
2465
+ * // never honour G_VALUE_NOCOPY_CONTENTS for ref-counted types
2466
+ * value->data[0].v_pointer = g_object_ref (object);
2467
+ * return NULL;
2468
+ * ```
2469
+ *
2470
+ *
2471
+ * The reference count for valid objects is always incremented, regardless
2472
+ * of `collect_flags`. For invalid objects, the example returns a newly
2473
+ * allocated string without altering `value`.
2474
+ *
2475
+ * Upon success, `collect_value()` needs to return `NULL`. If, however,
2476
+ * an error condition occurred, `collect_value()` should return a newly
2477
+ * allocated string containing an error diagnostic.
2478
+ *
2479
+ * The calling code makes no assumptions about the `value` contents being
2480
+ * valid upon error returns, `value` is simply thrown away without further
2481
+ * freeing. As such, it is a good idea to not allocate `GValue` contents
2482
+ * prior to returning an error; however, `collect_values()` is not obliged
2483
+ * to return a correctly setup `value` for error returns, simply because
2484
+ * any non-`NULL` return is considered a fatal programming error, and
2485
+ * further program behaviour is undefined.
2486
+ * @callback
2487
+ * @param value the value to initialize
2488
+ * @param collect_values the collected values
2489
+ * @param collect_flags optional flags
2490
+ * @returns `NULL` on success, otherwise a newly allocated error string on failure
2491
+ */
2492
+ export interface TypeValueCollectFunc {
2493
+ (value: any, collect_values: TypeCValue[], collect_flags: number): string | null
2494
+ }
2495
+ /**
2496
+ * Copies the content of a #GValue into another.
2497
+ *
2498
+ * The `dest_value` is a #GValue with zero-filled data section and `src_value`
2499
+ * is a properly initialized #GValue of same type, or derived type.
2500
+ *
2501
+ * The purpose of this function is to copy the contents of `src_value`
2502
+ * into `dest_value` in a way, that even after `src_value` has been freed, the
2503
+ * contents of `dest_value` remain valid. String type example:
2504
+ *
2505
+ *
2506
+ * ```c
2507
+ * dest_value->data[0].v_pointer = g_strdup (src_value->data[0].v_pointer);
2508
+ * ```
2509
+ *
2510
+ * @callback
2511
+ * @param src_value the value to copy
2512
+ */
2513
+ export interface TypeValueCopyFunc {
2514
+ (src_value: any): void
2515
+ }
2516
+ /**
2517
+ * Frees any old contents that might be left in the `value->data` array of
2518
+ * the given value.
2519
+ *
2520
+ * No resources may remain allocated through the #GValue contents after this
2521
+ * function returns. E.g. for our above string type:
2522
+ *
2523
+ *
2524
+ * ```c
2525
+ * // only free strings without a specific flag for static storage
2526
+ * if (!(value->data[1].v_uint & G_VALUE_NOCOPY_CONTENTS))
2527
+ * g_free (value->data[0].v_pointer);
2528
+ * ```
2529
+ *
2530
+ * @callback
2531
+ * @param value the value to free
2532
+ */
2533
+ export interface TypeValueFreeFunc {
2534
+ (value: any): void
2535
+ }
2536
+ /**
2537
+ * Initializes the value contents by setting the fields of the `value->data`
2538
+ * array.
2539
+ *
2540
+ * The data array of the #GValue passed into this function was zero-filled
2541
+ * with `memset()`, so no care has to be taken to free any old contents.
2542
+ * For example, in the case of a string value that may never be %NULL, the
2543
+ * implementation might look like:
2544
+ *
2545
+ *
2546
+ * ```c
2547
+ * value->data[0].v_pointer = g_strdup ("");
2548
+ * ```
2549
+ *
2550
+ * @callback
2551
+ * @param value the value to initialize
2552
+ */
2553
+ export interface TypeValueInitFunc {
2554
+ (value: any): void
2555
+ }
2556
+ /**
2557
+ * This function is responsible for storing the `value`
2558
+ * contents into arguments passed through a variadic argument list which
2559
+ * got collected into `collect_values` according to `lcopy_format`.
2560
+ *
2561
+ * The `n_collect_values` argument equals the string length of
2562
+ * `lcopy_format`, and `collect_flags` may contain %G_VALUE_NOCOPY_CONTENTS.
2563
+ *
2564
+ * In contrast to #GTypeValueCollectFunc, this function is obliged to always
2565
+ * properly support %G_VALUE_NOCOPY_CONTENTS.
2566
+ *
2567
+ * Similar to #GTypeValueCollectFunc the function may prematurely abort by
2568
+ * returning a newly allocated string describing an error condition. To
2569
+ * complete the string example:
2570
+ *
2571
+ *
2572
+ * ```c
2573
+ * gchar **string_p = collect_values[0].v_pointer;
2574
+ * g_return_val_if_fail (string_p != NULL,
2575
+ * g_strdup ("string location passed as NULL"));
2576
+ *
2577
+ * if (collect_flags & G_VALUE_NOCOPY_CONTENTS)
2578
+ * *string_p = value->data[0].v_pointer;
2579
+ * else
2580
+ * *string_p = g_strdup (value->data[0].v_pointer);
2581
+ * ```
2582
+ *
2583
+ *
2584
+ * And an illustrative version of this function for reference-counted
2585
+ * types:
2586
+ *
2587
+ *
2588
+ * ```c
2589
+ * GObject **object_p = collect_values[0].v_pointer;
2590
+ * g_return_val_if_fail (object_p != NULL,
2591
+ * g_strdup ("object location passed as NULL"));
2592
+ *
2593
+ * if (value->data[0].v_pointer == NULL)
2594
+ * *object_p = NULL;
2595
+ * else if (collect_flags & G_VALUE_NOCOPY_CONTENTS) // always honour
2596
+ * *object_p = value->data[0].v_pointer;
2597
+ * else
2598
+ * *object_p = g_object_ref (value->data[0].v_pointer);
2599
+ *
2600
+ * return NULL;
2601
+ * ```
2602
+ *
2603
+ * @callback
2604
+ * @param value the value to lcopy
2605
+ * @param collect_values the collected locations for storage
2606
+ * @param collect_flags optional flags
2607
+ * @returns `NULL` on success, otherwise a newly allocated error string on failure
2608
+ */
2609
+ export interface TypeValueLCopyFunc {
2610
+ (value: any, collect_values: TypeCValue[], collect_flags: number): string | null
2611
+ }
2612
+ /**
2613
+ * If the value contents fit into a pointer, such as objects or strings,
2614
+ * return this pointer, so the caller can peek at the current contents.
2615
+ *
2616
+ * To extend on our above string example:
2617
+ *
2618
+ *
2619
+ * ```c
2620
+ * return value->data[0].v_pointer;
2621
+ * ```
2622
+ *
2623
+ * @callback
2624
+ * @param value the value to peek
2625
+ * @returns a pointer to the value contents
2626
+ */
2627
+ export interface TypeValuePeekPointerFunc {
2628
+ (value: any): any | null
2629
+ }
2391
2630
  /**
2392
2631
  * The type of value transformation functions which can be registered with
2393
2632
  * g_value_register_transform_func().
@@ -2799,7 +3038,7 @@ export module Binding {
2799
3038
  * This should be in [canonical form][canonical-parameter-names] to get the
2800
3039
  * best performance.
2801
3040
  */
2802
- source_property?: string | null
3041
+ sourceProperty?: string | null
2803
3042
  /**
2804
3043
  * The #GObject that should be used as the target of the binding
2805
3044
  */
@@ -2811,7 +3050,7 @@ export module Binding {
2811
3050
  * This should be in [canonical form][canonical-parameter-names] to get the
2812
3051
  * best performance.
2813
3052
  */
2814
- target_property?: string | null
3053
+ targetProperty?: string | null
2815
3054
  }
2816
3055
 
2817
3056
  }
@@ -2835,7 +3074,7 @@ export interface Binding {
2835
3074
  * This should be in [canonical form][canonical-parameter-names] to get the
2836
3075
  * best performance.
2837
3076
  */
2838
- readonly source_property: string | null
3077
+ readonly sourceProperty: string | null
2839
3078
  /**
2840
3079
  * The #GObject that should be used as the target of the binding
2841
3080
  */
@@ -2847,7 +3086,7 @@ export interface Binding {
2847
3086
  * This should be in [canonical form][canonical-parameter-names] to get the
2848
3087
  * best performance.
2849
3088
  */
2850
- readonly target_property: string | null
3089
+ readonly targetProperty: string | null
2851
3090
 
2852
3091
  // Owm methods of GObject-2.0.GObject.Binding
2853
3092
 
@@ -2892,7 +3131,7 @@ export interface Binding {
2892
3131
  * of the binding.
2893
3132
  * @returns the name of the source property
2894
3133
  */
2895
- get_source_property(): string | null
3134
+ get_source_property(): string
2896
3135
  /**
2897
3136
  * Retrieves the #GObject instance used as the target of the binding.
2898
3137
  *
@@ -2911,7 +3150,7 @@ export interface Binding {
2911
3150
  * of the binding.
2912
3151
  * @returns the name of the target property
2913
3152
  */
2914
- get_target_property(): string | null
3153
+ get_target_property(): string
2915
3154
  /**
2916
3155
  * Explicitly releases the binding between the source and the target
2917
3156
  * property expressed by `binding`.
@@ -3091,7 +3330,7 @@ export interface BindingGroup {
3091
3330
  * @param target_property the property on `target` to bind
3092
3331
  * @param flags the flags used to create the #GBinding
3093
3332
  */
3094
- bind(source_property: string | null, target: Object, target_property: string | null, flags: BindingFlags): void
3333
+ bind(source_property: string, target: Object, target_property: string, flags: BindingFlags): void
3095
3334
  /**
3096
3335
  * Creates a binding between `source_property` on the source object and
3097
3336
  * `target_property` on `target,` allowing you to set the transformation
@@ -3110,7 +3349,7 @@ export interface BindingGroup {
3110
3349
  * @param transform_to a #GClosure wrapping the transformation function from the source object to the `target,` or %NULL to use the default
3111
3350
  * @param transform_from a #GClosure wrapping the transformation function from the `target` to the source object, or %NULL to use the default
3112
3351
  */
3113
- bind_full(source_property: string | null, target: Object, target_property: string | null, flags: BindingFlags, transform_to: TClosure | null, transform_from: TClosure | null): void
3352
+ bind_full(source_property: string, target: Object, target_property: string, flags: BindingFlags, transform_to: TClosure | null, transform_from: TClosure | null): void
3114
3353
  /**
3115
3354
  * Gets the source object used for binding properties.
3116
3355
  * @returns a #GObject or %NULL.
@@ -3282,7 +3521,7 @@ export interface Object {
3282
3521
  * @param flags flags to pass to #GBinding
3283
3522
  * @returns the #GBinding instance representing the binding between the two #GObject instances. The binding is released whenever the #GBinding reference count reaches zero.
3284
3523
  */
3285
- bind_property(source_property: string | null, target: Object, target_property: string | null, flags: BindingFlags): Binding
3524
+ bind_property(source_property: string, target: Object, target_property: string, flags: BindingFlags): Binding
3286
3525
  /**
3287
3526
  * Creates a binding between `source_property` on `source` and `target_property`
3288
3527
  * on `target,` allowing you to set the transformation functions to be used by
@@ -3299,7 +3538,7 @@ export interface Object {
3299
3538
  * @param transform_from a #GClosure wrapping the transformation function from the `target` to the `source,` or %NULL to use the default
3300
3539
  * @returns the #GBinding instance representing the binding between the two #GObject instances. The binding is released whenever the #GBinding reference count reaches zero.
3301
3540
  */
3302
- bind_property_full(source_property: string | null, target: Object, target_property: string | null, flags: BindingFlags, transform_to: TClosure, transform_from: TClosure): Binding
3541
+ bind_property_full(source_property: string, target: Object, target_property: string, flags: BindingFlags, transform_to: TClosure, transform_from: TClosure): Binding
3303
3542
  /**
3304
3543
  * This function is intended for #GObject implementations to re-enforce
3305
3544
  * a [floating][floating-ref] object reference. Doing this is seldom
@@ -3324,7 +3563,7 @@ export interface Object {
3324
3563
  * @param key name of the key for that association
3325
3564
  * @returns the data if found, or %NULL if no such data exists.
3326
3565
  */
3327
- get_data(key: string | null): any | null
3566
+ get_data(key: string): any | null
3328
3567
  /**
3329
3568
  * Gets a property of an object.
3330
3569
  *
@@ -3345,7 +3584,7 @@ export interface Object {
3345
3584
  * @param property_name the name of the property to get
3346
3585
  * @param value return location for the property value
3347
3586
  */
3348
- get_property(property_name: string | null, value: any): void
3587
+ get_property(property_name: string, value: any): void
3349
3588
  /**
3350
3589
  * This function gets back user data pointers stored via
3351
3590
  * g_object_set_qdata().
@@ -3380,7 +3619,7 @@ export interface Object {
3380
3619
  * called.
3381
3620
  * @param property_name the name of a property installed on the class of `object`.
3382
3621
  */
3383
- notify(property_name: string | null): void
3622
+ notify(property_name: string): void
3384
3623
  /**
3385
3624
  * Emits a "notify" signal for the property specified by `pspec` on `object`.
3386
3625
  *
@@ -3472,20 +3711,20 @@ export interface Object {
3472
3711
  * @param key name of the key
3473
3712
  * @param data data to associate with that key
3474
3713
  */
3475
- set_data(key: string | null, data: any | null): void
3714
+ set_data(key: string, data: any | null): void
3476
3715
  /**
3477
3716
  * Sets a property on an object.
3478
3717
  * @param property_name the name of the property to set
3479
3718
  * @param value the value
3480
3719
  */
3481
- set_property(property_name: string | null, value: any): void
3720
+ set_property(property_name: string, value: any): void
3482
3721
  /**
3483
3722
  * Remove a specified datum from the object's data associations,
3484
3723
  * without invoking the association's destroy handler.
3485
3724
  * @param key name of the key
3486
3725
  * @returns the data if found, or %NULL if no such data exists.
3487
3726
  */
3488
- steal_data(key: string | null): any | null
3727
+ steal_data(key: string): any | null
3489
3728
  /**
3490
3729
  * This function gets back user data pointers stored via
3491
3730
  * g_object_set_qdata() and removes the `data` from object
@@ -3650,7 +3889,7 @@ export class Object {
3650
3889
  * @param property_name name of a property to look up.
3651
3890
  * @returns the #GParamSpec for the property of the interface with the name @property_name, or %NULL if no such property exists.
3652
3891
  */
3653
- static interface_find_property(g_iface: TypeInterface, property_name: string | null): ParamSpec
3892
+ static interface_find_property(g_iface: TypeInterface, property_name: string): ParamSpec
3654
3893
  /**
3655
3894
  * Add a property to an interface; this is only useful for interfaces
3656
3895
  * that are added to GObject-derived types. Adding a property to an
@@ -3696,7 +3935,7 @@ export interface ParamSpec {
3696
3935
  * name of this parameter: always an interned string
3697
3936
  * @field
3698
3937
  */
3699
- name: string | null
3938
+ name: string
3700
3939
  /**
3701
3940
  * #GParamFlags flags for this parameter
3702
3941
  * @field
@@ -3734,7 +3973,7 @@ export interface ParamSpec {
3734
3973
  * This allows for pointer-value comparisons.
3735
3974
  * @returns the name of @pspec.
3736
3975
  */
3737
- get_name(): string | null
3976
+ get_name(): string
3738
3977
  /**
3739
3978
  * Gets the GQuark for the name.
3740
3979
  * @returns the GQuark for @pspec->name.
@@ -3744,7 +3983,7 @@ export interface ParamSpec {
3744
3983
  * Get the nickname of a #GParamSpec.
3745
3984
  * @returns the nickname of @pspec.
3746
3985
  */
3747
- get_nick(): string | null
3986
+ get_nick(): string
3748
3987
  /**
3749
3988
  * Gets back user data pointers stored via g_param_spec_set_qdata().
3750
3989
  * @param quark a #GQuark, naming the user data pointer
@@ -3836,7 +4075,7 @@ export class ParamSpec {
3836
4075
  * @param name the canonical name of the property
3837
4076
  * @returns %TRUE if @name is a valid property name, %FALSE otherwise.
3838
4077
  */
3839
- static is_valid_name(name: string | null): boolean
4078
+ static is_valid_name(name: string): boolean
3840
4079
  static char(name: string, nick: string, blurb: string, flags: ParamFlags, minimum: number, maximum: number, defaultValue: number): ParamSpecChar
3841
4080
  static uchar(name: string, nick: string, blurb: string, flags: ParamFlags, minimum: number, maximum: number, defaultValue: number): ParamSpecUChar
3842
4081
  static int(name: string, nick: string, blurb: string, flags: ParamFlags, minimum: number, maximum: number, defaultValue: number): ParamSpecInt
@@ -4655,7 +4894,7 @@ export module SignalGroup {
4655
4894
  /**
4656
4895
  * The #GType of the target property.
4657
4896
  */
4658
- target_type?: GType | null
4897
+ targetType?: GType | null
4659
4898
  }
4660
4899
 
4661
4900
  }
@@ -4671,7 +4910,7 @@ export interface SignalGroup {
4671
4910
  /**
4672
4911
  * The #GType of the target property.
4673
4912
  */
4674
- readonly target_type: GType
4913
+ readonly targetType: GType
4675
4914
 
4676
4915
  // Owm methods of GObject-2.0.GObject.SignalGroup
4677
4916
 
@@ -4691,7 +4930,7 @@ export interface SignalGroup {
4691
4930
  * @param closure the closure to connect.
4692
4931
  * @param after whether the handler should be called before or after the default handler of the signal.
4693
4932
  */
4694
- connect_closure(detailed_signal: string | null, closure: TClosure, after: boolean): void
4933
+ connect_closure(detailed_signal: string, closure: TClosure, after: boolean): void
4695
4934
  /**
4696
4935
  * Connects `c_handler` to the signal `detailed_signal`
4697
4936
  * on the target instance of `self`.
@@ -4701,7 +4940,7 @@ export interface SignalGroup {
4701
4940
  * @param c_handler the #GCallback to connect
4702
4941
  * @param flags the flags used to create the signal connection
4703
4942
  */
4704
- connect_data(detailed_signal: string | null, c_handler: Callback, flags: ConnectFlags): void
4943
+ connect_data(detailed_signal: string, c_handler: Callback, flags: ConnectFlags): void
4705
4944
  /**
4706
4945
  * Connects `c_handler` to the signal `detailed_signal`
4707
4946
  * on the target instance of `self`.
@@ -4713,7 +4952,7 @@ export interface SignalGroup {
4713
4952
  * @param detailed_signal a string of the form "signal-name::detail"
4714
4953
  * @param c_handler the #GCallback to connect
4715
4954
  */
4716
- connect_swapped(detailed_signal: string | null, c_handler: Callback): void
4955
+ connect_swapped(detailed_signal: string, c_handler: Callback): void
4717
4956
  /**
4718
4957
  * Gets the target instance used when connecting signals.
4719
4958
  * @returns The target instance
@@ -4863,7 +5102,7 @@ export interface TypeModule extends TypePlugin {
4863
5102
  * @param const_static_values an array of #GEnumValue structs for the possible enumeration values. The array is terminated by a struct with all members being 0.
4864
5103
  * @returns the new or existing type ID
4865
5104
  */
4866
- register_enum(name: string | null, const_static_values: EnumValue): GType
5105
+ register_enum(name: string, const_static_values: EnumValue): GType
4867
5106
  /**
4868
5107
  * Looks up or registers a flags type that is implemented with a particular
4869
5108
  * type plugin. If a type with name `type_name` was previously registered,
@@ -4879,7 +5118,7 @@ export interface TypeModule extends TypePlugin {
4879
5118
  * @param const_static_values an array of #GFlagsValue structs for the possible flags values. The array is terminated by a struct with all members being 0.
4880
5119
  * @returns the new or existing type ID
4881
5120
  */
4882
- register_flags(name: string | null, const_static_values: FlagsValue): GType
5121
+ register_flags(name: string, const_static_values: FlagsValue): GType
4883
5122
  /**
4884
5123
  * Looks up or registers a type that is implemented with a particular
4885
5124
  * type plugin. If a type with name `type_name` was previously registered,
@@ -4901,12 +5140,12 @@ export interface TypeModule extends TypePlugin {
4901
5140
  * @param flags flags field providing details about the type
4902
5141
  * @returns the new or existing type ID
4903
5142
  */
4904
- register_type(parent_type: GType, type_name: string | null, type_info: TypeInfo, flags: TypeFlags): GType
5143
+ register_type(parent_type: GType, type_name: string, type_info: TypeInfo, flags: TypeFlags): GType
4905
5144
  /**
4906
5145
  * Sets the name for a #GTypeModule
4907
5146
  * @param name a human-readable name to use in error messages.
4908
5147
  */
4909
- set_name(name: string | null): void
5148
+ set_name(name: string): void
4910
5149
  /**
4911
5150
  * Decreases the use count of a #GTypeModule by one. If the
4912
5151
  * result is zero, the module will be unloaded. (However, the
@@ -5583,12 +5822,12 @@ export interface EnumValue {
5583
5822
  * the name of the value
5584
5823
  * @field
5585
5824
  */
5586
- value_name: string | null
5825
+ value_name: string
5587
5826
  /**
5588
5827
  * the nickname of the value
5589
5828
  * @field
5590
5829
  */
5591
- value_nick: string | null
5830
+ value_nick: string
5592
5831
  }
5593
5832
 
5594
5833
  /**
@@ -5655,12 +5894,12 @@ export interface FlagsValue {
5655
5894
  * the name of the value
5656
5895
  * @field
5657
5896
  */
5658
- value_name: string | null
5897
+ value_name: string
5659
5898
  /**
5660
5899
  * the nickname of the value
5661
5900
  * @field
5662
5901
  */
5663
- value_nick: string | null
5902
+ value_nick: string
5664
5903
  }
5665
5904
 
5666
5905
  /**
@@ -5761,7 +6000,7 @@ export interface ObjectClass {
5761
6000
  * @param property_name the name of the property to look up
5762
6001
  * @returns the #GParamSpec for the property, or %NULL if the class doesn't have a property of that name
5763
6002
  */
5764
- find_property(oclass: Object | Function | GType, property_name: string | null): ParamSpec
6003
+ find_property(oclass: Object | Function | GType, property_name: string): ParamSpec
5765
6004
  /**
5766
6005
  * Installs new properties from an array of #GParamSpecs.
5767
6006
  *
@@ -5873,7 +6112,7 @@ export interface ObjectClass {
5873
6112
  * @param property_id the new property ID
5874
6113
  * @param name the name of a property registered in a parent class or in an interface of this class.
5875
6114
  */
5876
- override_property(oclass: Object | Function | GType, property_id: number, name: string | null): void
6115
+ override_property(oclass: Object | Function | GType, property_id: number, name: string): void
5877
6116
  }
5878
6117
 
5879
6118
  /**
@@ -6007,7 +6246,7 @@ export interface ParamSpecPool {
6007
6246
  * @param walk_ancestors If %TRUE, also try to find a #GParamSpec with `param_name` owned by an ancestor of `owner_type`.
6008
6247
  * @returns The found #GParamSpec, or %NULL if no matching #GParamSpec was found.
6009
6248
  */
6010
- lookup(param_name: string | null, owner_type: GType, walk_ancestors: boolean): ParamSpec | null
6249
+ lookup(param_name: string, owner_type: GType, walk_ancestors: boolean): ParamSpec | null
6011
6250
  /**
6012
6251
  * Removes a #GParamSpec from the pool.
6013
6252
  * @param pspec the #GParamSpec to remove
@@ -6082,7 +6321,7 @@ export interface Parameter {
6082
6321
  * the parameter name
6083
6322
  * @field
6084
6323
  */
6085
- name: string | null
6324
+ name: string
6086
6325
  /**
6087
6326
  * the parameter value
6088
6327
  * @field
@@ -6153,7 +6392,7 @@ export interface SignalQuery {
6153
6392
  * The signal name.
6154
6393
  * @field
6155
6394
  */
6156
- signal_name: string | null
6395
+ signal_name: string
6157
6396
  /**
6158
6397
  * The interface/instance type that this signal can be emitted for.
6159
6398
  * @field
@@ -6617,7 +6856,7 @@ export interface TypeQuery {
6617
6856
  * the name of the type
6618
6857
  * @field
6619
6858
  */
6620
- type_name: string | null
6859
+ type_name: string
6621
6860
  /**
6622
6861
  * the size of the class structure
6623
6862
  * @field
@@ -6647,35 +6886,62 @@ export interface TypeValueTable {
6647
6886
 
6648
6887
  // Own fields of GObject-2.0.GObject.TypeValueTable
6649
6888
 
6650
- value_init: (value: any) => void
6651
- value_free: (value: any) => void
6652
- value_copy: (src_value: any, dest_value: any) => void
6653
- value_peek_pointer: (value: any) => any
6889
+ /**
6890
+ * Function to initialize a GValue
6891
+ * @field
6892
+ */
6893
+ value_init: TypeValueInitFunc
6894
+ /**
6895
+ * Function to free a GValue
6896
+ * @field
6897
+ */
6898
+ value_free: TypeValueFreeFunc
6899
+ /**
6900
+ * Function to copy a GValue
6901
+ * @field
6902
+ */
6903
+ value_copy: TypeValueCopyFunc
6904
+ /**
6905
+ * Function to peek the contents of a GValue if they fit
6906
+ * into a pointer
6907
+ * @field
6908
+ */
6909
+ value_peek_pointer: TypeValuePeekPointerFunc
6654
6910
  /**
6655
6911
  * A string format describing how to collect the contents of
6656
- * this value bit-by-bit. Each character in the format represents
6657
- * an argument to be collected, and the characters themselves indicate
6658
- * the type of the argument. Currently supported arguments are:
6659
- * - 'i' - Integers. passed as collect_values[].v_int.
6660
- * - 'l' - Longs. passed as collect_values[].v_long.
6661
- * - 'd' - Doubles. passed as collect_values[].v_double.
6662
- * - 'p' - Pointers. passed as collect_values[].v_pointer.
6663
- * It should be noted that for variable argument list construction,
6664
- * ANSI C promotes every type smaller than an integer to an int, and
6665
- * floats to doubles. So for collection of short int or char, 'i'
6666
- * needs to be used, and for collection of floats 'd'.
6667
- * @field
6668
- */
6669
- collect_format: string | null
6670
- collect_value: (value: any, n_collect_values: number, collect_values: TypeCValue, collect_flags: number) => string | null
6912
+ * this value bit-by-bit. Each character in the format represents
6913
+ * an argument to be collected, and the characters themselves indicate
6914
+ * the type of the argument. Currently supported arguments are:
6915
+ * - `'i'`: Integers, passed as `collect_values[].v_int`
6916
+ * - `'l'`: Longs, passed as `collect_values[].v_long`
6917
+ * - `'d'`: Doubles, passed as `collect_values[].v_double`
6918
+ * - `'p'`: Pointers, passed as `collect_values[].v_pointer`
6919
+ * It should be noted that for variable argument list construction,
6920
+ * ANSI C promotes every type smaller than an integer to an int, and
6921
+ * floats to doubles. So for collection of short int or char, `'i'`
6922
+ * needs to be used, and for collection of floats `'d'`.
6923
+ * @field
6924
+ */
6925
+ collect_format: string
6926
+ /**
6927
+ * Function to initialize a GValue from the values
6928
+ * collected from variadic arguments
6929
+ * @field
6930
+ */
6931
+ collect_value: TypeValueCollectFunc
6671
6932
  /**
6672
6933
  * Format description of the arguments to collect for `lcopy_value,`
6673
- * analogous to `collect_format`. Usually, `lcopy_format` string consists
6674
- * only of 'p's to provide lcopy_value() with pointers to storage locations.
6934
+ * analogous to `collect_format`. Usually, `lcopy_format` string consists
6935
+ * only of `'p'`s to provide lcopy_value() with pointers to storage locations.
6936
+ * @field
6937
+ */
6938
+ lcopy_format: string
6939
+ /**
6940
+ * Function to store the contents of a value into the
6941
+ * locations collected from variadic arguments
6675
6942
  * @field
6676
6943
  */
6677
- lcopy_format: string | null
6678
- lcopy_value: (value: any, n_collect_values: number, collect_values: TypeCValue, collect_flags: number) => string | null
6944
+ lcopy_value: TypeValueLCopyFunc
6679
6945
  }
6680
6946
 
6681
6947
  /**