mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2024-11-13 04:46:15 +01:00
37e4b8c87e
Wed Mar 7 09:36:33 2001 Tim Janik <timj@gtk.org> * gboxed.[hc]: changed prototype of g_boxed_type_register_static() to contain an optional init function and a hint at whether the boxed structure uses ref counting internally. added g_value_set_boxed_take_ownership(). made G_TYPE_BOXED an abstract value type. * genums.[hc]: made G_TYPE_ENUM and G_TYPE_FLAGS abstract value types. * glib-genmarshal.c: argument type changes, preparation for third-party arg specification. * gobject.[hc]: cleaned up get/set property code. added g_strdup_value_contents() to improve warnings. * gparam.[hc]: added g_param_value_convert(), taking over responsibility of the old g_value_convert(). added G_PARAM_LAX_VALIDATION flag so validation alterations may be valid a part of the property setting process. * gparamspecs.[hc]: made value comparisons stable (for sort applications). added GParamSpecValueArray, a param spec for value arrays and GParamSpecClosure. nuked the value exchange functions and GParamSpecCCallback. * gtype.[hc]: catch unintialized usages of the type system with g_return_val_if_uninitialized(). introduced G_TYPE_FLAG_VALUE_ABSTRACT to flag types that introduce a value table, but can't be used for g_value_init(). cleaned up reserved type ids. * gvalue.[hc]: code cleanups and saner checking. nuked the value exchange API. implemented value transformations, we can't really "convert" values, rather transforms are an anylogy to C casts, real conversions need a param spec for validation, which is why g_param_value_convert() does real conversions now. * gvaluearray.[hc]: new files that implement a GValueArray, a struct that can hold inhomogeneous arrays of value (to that extend that it also allowes undefined values, i.e. G_VALUE_TYPE(value)==0). this is exposed to the type system as a boxed type. * gvaluetransform.c: new file implementing most of the former value exchange functions as single-sided transformations. * gvaluetypes.[hc]: nuked G_TYPE_CCALLBACK, added g_value_set_string_take_ownership(). * *.h: s/G_IS_VALUE_/G_VALUE_HOLDS_/. * *.[hc]: many fixes and cleanups. * many warning improvements. Tue Feb 27 18:35:15 2001 Tim Janik <timj@gtk.org> * gobject.c (g_object_get_valist): urg, pass G_VALUE_NOCOPY_CONTENTS into G_VALUE_LCOPY(), this needs proper documenting. * gparam.c: fixed G_PARAM_USER_MASK. * gtype.c (type_data_make_W): (type_data_last_unref_Wm): fixed invalid memory freeing. * gobject.c (g_object_last_unref): destroy signal handlers associated with object, right before finalization. * gsignal.c (g_signal_parse_name): catch destroyed nodes or signals that don't actually support details. * gobject.[hc]: got rid of property trailers. nuked GObject properties "data" and the "signal" variants. (g_object_connect): new convenience function to do multiple signal connections at once. (g_object_disconnect): likewise, for disconnections. * gparam.[hc] (g_param_spec_pool_lookup): took out trailer support. * gvalue.[hc]: marked g_value_fits_pointer() and g_value_peek_pointer() as private (the latter got renamed from g_value_get_as_pointer()). Wed Mar 7 09:32:06 2001 Tim Janik <timj@gtk.org> * glib-object.h: add gvaluearray.h. * gstring.[hc]: fixup naming of g_string_sprint*. * gtypes.h: fixed GCompareDataFunc naming. Wed Mar 7 09:33:27 2001 Tim Janik <timj@gtk.org> * gobject/Makefile.am: shuffled rules to avoid excessive rebuilds. * gobject/gobject-sections.txt: updates. * gobject/tmpl/*: bunch of updates, added another patch from Eric Lemings <eric.b.lemings@lmco.com>.
660 lines
6.7 KiB
Plaintext
660 lines
6.7 KiB
Plaintext
<!-- ##### SECTION Title ##### -->
|
|
Standard Parameter Types
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### MACRO G_IS_PARAM_SPEC_CHAR ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### MACRO G_PARAM_SPEC_CHAR ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### MACRO G_IS_PARAM_SPEC_UCHAR ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### MACRO G_PARAM_SPEC_UCHAR ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### MACRO G_IS_PARAM_SPEC_BOOLEAN ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### MACRO G_PARAM_SPEC_BOOLEAN ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### MACRO G_IS_PARAM_SPEC_INT ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### MACRO G_PARAM_SPEC_INT ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### MACRO G_IS_PARAM_SPEC_UINT ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### MACRO G_PARAM_SPEC_UINT ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### MACRO G_IS_PARAM_SPEC_LONG ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### MACRO G_PARAM_SPEC_LONG ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### MACRO G_IS_PARAM_SPEC_ULONG ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### MACRO G_PARAM_SPEC_ULONG ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### MACRO G_IS_PARAM_SPEC_ENUM ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### MACRO G_PARAM_SPEC_ENUM ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### MACRO G_IS_PARAM_SPEC_FLAGS ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### MACRO G_PARAM_SPEC_FLAGS ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### MACRO G_IS_PARAM_SPEC_FLOAT ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### MACRO G_PARAM_SPEC_FLOAT ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### MACRO G_IS_PARAM_SPEC_DOUBLE ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### MACRO G_PARAM_SPEC_DOUBLE ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### MACRO G_IS_PARAM_SPEC_STRING ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### MACRO G_PARAM_SPEC_STRING ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### MACRO G_IS_PARAM_SPEC_POINTER ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### MACRO G_PARAM_SPEC_POINTER ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### MACRO G_IS_PARAM_SPEC_BOXED ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### MACRO G_PARAM_SPEC_BOXED ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### MACRO G_IS_PARAM_SPEC_PARAM ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### MACRO G_PARAM_SPEC_PARAM ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### MACRO G_IS_PARAM_SPEC_OBJECT ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### MACRO G_PARAM_SPEC_OBJECT ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pspec:
|
|
|
|
|
|
<!-- ##### STRUCT GParamSpecChar ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@parent_instance:
|
|
@minimum:
|
|
@maximum:
|
|
@default_value:
|
|
|
|
<!-- ##### STRUCT GParamSpecUChar ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@parent_instance:
|
|
@minimum:
|
|
@maximum:
|
|
@default_value:
|
|
|
|
<!-- ##### STRUCT GParamSpecBoolean ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@parent_instance:
|
|
@default_value:
|
|
|
|
<!-- ##### STRUCT GParamSpecInt ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@parent_instance:
|
|
@minimum:
|
|
@maximum:
|
|
@default_value:
|
|
|
|
<!-- ##### STRUCT GParamSpecUInt ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@parent_instance:
|
|
@minimum:
|
|
@maximum:
|
|
@default_value:
|
|
|
|
<!-- ##### STRUCT GParamSpecLong ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@parent_instance:
|
|
@minimum:
|
|
@maximum:
|
|
@default_value:
|
|
|
|
<!-- ##### STRUCT GParamSpecULong ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@parent_instance:
|
|
@minimum:
|
|
@maximum:
|
|
@default_value:
|
|
|
|
<!-- ##### STRUCT GParamSpecEnum ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@parent_instance:
|
|
@enum_class:
|
|
@default_value:
|
|
|
|
<!-- ##### STRUCT GParamSpecFlags ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@parent_instance:
|
|
@flags_class:
|
|
@default_value:
|
|
|
|
<!-- ##### STRUCT GParamSpecFloat ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@parent_instance:
|
|
@minimum:
|
|
@maximum:
|
|
@default_value:
|
|
@epsilon:
|
|
|
|
<!-- ##### STRUCT GParamSpecDouble ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@parent_instance:
|
|
@minimum:
|
|
@maximum:
|
|
@default_value:
|
|
@epsilon:
|
|
|
|
<!-- ##### STRUCT GParamSpecString ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@parent_instance:
|
|
@default_value:
|
|
@cset_first:
|
|
@cset_nth:
|
|
@substitutor:
|
|
@null_fold_if_empty:
|
|
@ensure_non_null:
|
|
|
|
<!-- ##### STRUCT GParamSpecBoxed ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@parent_instance:
|
|
|
|
<!-- ##### STRUCT GParamSpecParam ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@parent_instance:
|
|
|
|
<!-- ##### STRUCT GParamSpecPointer ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@parent_instance:
|
|
|
|
<!-- ##### STRUCT GParamSpecObject ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@parent_instance:
|
|
|
|
<!-- ##### FUNCTION g_param_spec_char ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@name:
|
|
@nick:
|
|
@blurb:
|
|
@minimum:
|
|
@maximum:
|
|
@default_value:
|
|
@flags:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION g_param_spec_uchar ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@name:
|
|
@nick:
|
|
@blurb:
|
|
@minimum:
|
|
@maximum:
|
|
@default_value:
|
|
@flags:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION g_param_spec_boolean ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@name:
|
|
@nick:
|
|
@blurb:
|
|
@default_value:
|
|
@flags:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION g_param_spec_int ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@name:
|
|
@nick:
|
|
@blurb:
|
|
@minimum:
|
|
@maximum:
|
|
@default_value:
|
|
@flags:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION g_param_spec_uint ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@name:
|
|
@nick:
|
|
@blurb:
|
|
@minimum:
|
|
@maximum:
|
|
@default_value:
|
|
@flags:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION g_param_spec_long ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@name:
|
|
@nick:
|
|
@blurb:
|
|
@minimum:
|
|
@maximum:
|
|
@default_value:
|
|
@flags:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION g_param_spec_ulong ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@name:
|
|
@nick:
|
|
@blurb:
|
|
@minimum:
|
|
@maximum:
|
|
@default_value:
|
|
@flags:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION g_param_spec_enum ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@name:
|
|
@nick:
|
|
@blurb:
|
|
@enum_type:
|
|
@default_value:
|
|
@flags:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION g_param_spec_flags ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@name:
|
|
@nick:
|
|
@blurb:
|
|
@flags_type:
|
|
@default_value:
|
|
@flags:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION g_param_spec_float ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@name:
|
|
@nick:
|
|
@blurb:
|
|
@minimum:
|
|
@maximum:
|
|
@default_value:
|
|
@flags:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION g_param_spec_double ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@name:
|
|
@nick:
|
|
@blurb:
|
|
@minimum:
|
|
@maximum:
|
|
@default_value:
|
|
@flags:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION g_param_spec_string ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@name:
|
|
@nick:
|
|
@blurb:
|
|
@default_value:
|
|
@flags:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION g_param_spec_string_c ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@name:
|
|
@nick:
|
|
@blurb:
|
|
@default_value:
|
|
@flags:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION g_param_spec_boxed ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@name:
|
|
@nick:
|
|
@blurb:
|
|
@boxed_type:
|
|
@flags:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION g_param_spec_param ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@name:
|
|
@nick:
|
|
@blurb:
|
|
@param_type:
|
|
@flags:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION g_param_spec_pointer ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@name:
|
|
@nick:
|
|
@blurb:
|
|
@flags:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION g_param_spec_object ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@name:
|
|
@nick:
|
|
@blurb:
|
|
@object_type:
|
|
@flags:
|
|
@Returns:
|
|
|
|
|