gobject/gparamspecs.h

   1 /* GObject - GLib Type, Object, Parameter and Signal Library
   2  * Copyright (C) 1997-1999, 2000-2001 Tim Janik and Red Hat, Inc.
   3  *
   4  * This library is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Lesser General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2 of the License, or (at your option) any later version.
   8  *
   9  * This library is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * Lesser General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Lesser General
  15  * Public License along with this library; if not, write to the
  16  * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
  17  * Boston, MA 02111-1307, USA.
  18  *
  19  * gparamspecs.h: GLib default param specs
  20  */
  21 #ifndef __G_PARAMSPECS_H__
  22 #define __G_PARAMSPECS_H__
  23
  24
  25 #include        <gobject/gvalue.h>
  26 #include        <gobject/genums.h>
  27 #include        <gobject/gboxed.h>
  28 #include        <gobject/gobject.h>
  29
  30 G_BEGIN_DECLS
  31
  32 /* --- type macros --- */
  33 #define G_IS_PARAM_SPEC_CHAR(pspec)        (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_CHAR))
  34 #define G_PARAM_SPEC_CHAR(pspec)           (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_CHAR, GParamSpecChar))
  35 #define G_IS_PARAM_SPEC_UCHAR(pspec)       (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_UCHAR))
  36 #define G_PARAM_SPEC_UCHAR(pspec)          (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_UCHAR, GParamSpecUChar))
  37 #define G_IS_PARAM_SPEC_BOOLEAN(pspec)     (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_BOOLEAN))
  38 #define G_PARAM_SPEC_BOOLEAN(pspec)        (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_BOOLEAN, GParamSpecBoolean))
  39 #define G_IS_PARAM_SPEC_INT(pspec)         (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_INT))
  40 #define G_PARAM_SPEC_INT(pspec)            (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_INT, GParamSpecInt))
  41 #define G_IS_PARAM_SPEC_UINT(pspec)        (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_UINT))
  42 #define G_PARAM_SPEC_UINT(pspec)           (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_UINT, GParamSpecUInt))
  43 #define G_IS_PARAM_SPEC_LONG(pspec)        (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_LONG))
  44 #define G_PARAM_SPEC_LONG(pspec)           (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_LONG, GParamSpecLong))
  45 #define G_IS_PARAM_SPEC_ULONG(pspec)       (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_ULONG))
  46 #define G_PARAM_SPEC_ULONG(pspec)          (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_ULONG, GParamSpecULong))
  47 #define G_IS_PARAM_SPEC_INT64(pspec)        (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_INT64))
  48 #define G_PARAM_SPEC_INT64(pspec)           (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_INT64, GParamSpecInt64))
  49 #define G_IS_PARAM_SPEC_UINT64(pspec)       (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_UINT64))
  50 #define G_PARAM_SPEC_UINT64(pspec)          (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_UINT64, GParamSpecUInt64))
  51 #define G_PARAM_SPEC_UNICHAR(pspec)        (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_UNICHAR, GParamSpecUnichar))
  52 #define G_IS_PARAM_SPEC_UNICHAR(pspec)     (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_UNICHAR))
  53 #define G_IS_PARAM_SPEC_ENUM(pspec)        (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_ENUM))
  54 #define G_PARAM_SPEC_ENUM(pspec)           (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_ENUM, GParamSpecEnum))
  55 #define G_IS_PARAM_SPEC_FLAGS(pspec)       (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_FLAGS))
  56 #define G_PARAM_SPEC_FLAGS(pspec)          (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_FLAGS, GParamSpecFlags))
  57 #define G_IS_PARAM_SPEC_FLOAT(pspec)       (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_FLOAT))
  58 #define G_PARAM_SPEC_FLOAT(pspec)          (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_FLOAT, GParamSpecFloat))
  59 #define G_IS_PARAM_SPEC_DOUBLE(pspec)      (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_DOUBLE))
  60 #define G_PARAM_SPEC_DOUBLE(pspec)         (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_DOUBLE, GParamSpecDouble))
  61 #define G_IS_PARAM_SPEC_STRING(pspec)      (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_STRING))
  62 #define G_PARAM_SPEC_STRING(pspec)         (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_STRING, GParamSpecString))
  63 #define G_IS_PARAM_SPEC_PARAM(pspec)       (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_PARAM))
  64 #define G_PARAM_SPEC_PARAM(pspec)          (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_PARAM, GParamSpecParam))
  65 #define G_IS_PARAM_SPEC_BOXED(pspec)       (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_BOXED))
  66 #define G_PARAM_SPEC_BOXED(pspec)          (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_BOXED, GParamSpecBoxed))
  67 #define G_IS_PARAM_SPEC_POINTER(pspec)     (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_POINTER))
  68 #define G_PARAM_SPEC_POINTER(pspec)        (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_POINTER, GParamSpecPointer))
  69 #define G_IS_PARAM_SPEC_VALUE_ARRAY(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_VALUE_ARRAY))
  70 #define G_PARAM_SPEC_VALUE_ARRAY(pspec)    (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_VALUE_ARRAY, GParamSpecValueArray))
  71 #define G_IS_PARAM_SPEC_CLOSURE(pspec)     (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_CLOSURE))
  72 #define G_PARAM_SPEC_CLOSURE(pspec)        (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_CLOSURE, GParamSpecClosure))
  73 #define G_IS_PARAM_SPEC_OBJECT(pspec)      (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_OBJECT))
  74 #define G_PARAM_SPEC_OBJECT(pspec)         (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_OBJECT, GParamSpecObject))
  75
  76
  77 /* --- typedefs & structures --- */
  78 typedef struct _GParamSpecChar       GParamSpecChar;
  79 typedef struct _GParamSpecUChar      GParamSpecUChar;
  80 typedef struct _GParamSpecBoolean    GParamSpecBoolean;
  81 typedef struct _GParamSpecInt        GParamSpecInt;
  82 typedef struct _GParamSpecUInt       GParamSpecUInt;
  83 typedef struct _GParamSpecLong       GParamSpecLong;
  84 typedef struct _GParamSpecULong      GParamSpecULong;
  85 typedef struct _GParamSpecInt64      GParamSpecInt64;
  86 typedef struct _GParamSpecUInt64     GParamSpecUInt64;
  87 typedef struct _GParamSpecUnichar    GParamSpecUnichar;
  88 typedef struct _GParamSpecEnum       GParamSpecEnum;
  89 typedef struct _GParamSpecFlags      GParamSpecFlags;
  90 typedef struct _GParamSpecFloat      GParamSpecFloat;
  91 typedef struct _GParamSpecDouble     GParamSpecDouble;
  92 typedef struct _GParamSpecString     GParamSpecString;
  93 typedef struct _GParamSpecParam      GParamSpecParam;
  94 typedef struct _GParamSpecBoxed      GParamSpecBoxed;
  95 typedef struct _GParamSpecPointer    GParamSpecPointer;
  96 typedef struct _GParamSpecValueArray GParamSpecValueArray;
  97 typedef struct _GParamSpecClosure    GParamSpecClosure;
  98 typedef struct _GParamSpecObject     GParamSpecObject;
  99
 100 struct _GParamSpecChar
 101 {
 102   GParamSpec    parent_instance;
 103
 104   gint8         minimum;
 105   gint8         maximum;
 106   gint8         default_value;
 107 };
 108 struct _GParamSpecUChar
 109 {
 110   GParamSpec    parent_instance;
 111
 112   guint8        minimum;
 113   guint8        maximum;
 114   guint8        default_value;
 115 };
 116 struct _GParamSpecBoolean
 117 {
 118   GParamSpec    parent_instance;
 119
 120   gboolean      default_value;
 121 };
 122 struct _GParamSpecInt
 123 {
 124   GParamSpec    parent_instance;
 125
 126   gint          minimum;
 127   gint          maximum;
 128   gint          default_value;
 129 };
 130 struct _GParamSpecUInt
 131 {
 132   GParamSpec    parent_instance;
 133
 134   guint         minimum;
 135   guint         maximum;
 136   guint         default_value;
 137 };
 138 struct _GParamSpecLong
 139 {
 140   GParamSpec    parent_instance;
 141
 142   glong         minimum;
 143   glong         maximum;
 144   glong         default_value;
 145 };
 146 struct _GParamSpecULong
 147 {
 148   GParamSpec    parent_instance;
 149
 150   gulong        minimum;
 151   gulong        maximum;
 152   gulong        default_value;
 153 };
 154 struct _GParamSpecInt64
 155 {
 156   GParamSpec    parent_instance;
 157
 158   gint64        minimum;
 159   gint64        maximum;
 160   gint64        default_value;
 161 };
 162 struct _GParamSpecUInt64
 163 {
 164   GParamSpec    parent_instance;
 165
 166   guint64       minimum;
 167   guint64       maximum;
 168   guint64       default_value;
 169 };
 170 struct _GParamSpecUnichar
 171 {
 172   GParamSpec    parent_instance;
 173
 174   gunichar      default_value;
 175 };
 176 struct _GParamSpecEnum
 177 {
 178   GParamSpec    parent_instance;
 179
 180   GEnumClass   *enum_class;
 181   gint          default_value;
 182 };
 183 struct _GParamSpecFlags
 184 {
 185   GParamSpec    parent_instance;
 186
 187   GFlagsClass  *flags_class;
 188   guint         default_value;
 189 };
 190 struct _GParamSpecFloat
 191 {
 192   GParamSpec    parent_instance;
 193
 194   gfloat        minimum;
 195   gfloat        maximum;
 196   gfloat        default_value;
 197   gfloat        epsilon;
 198 };
 199 struct _GParamSpecDouble
 200 {
 201   GParamSpec    parent_instance;
 202
 203   gdouble       minimum;
 204   gdouble       maximum;
 205   gdouble       default_value;
 206   gdouble       epsilon;
 207 };
 208 struct _GParamSpecString
 209 {
 210   GParamSpec    parent_instance;
 211
 212   gchar        *default_value;
 213   gchar        *cset_first;
 214   gchar        *cset_nth;
 215   gchar         substitutor;
 216   guint         null_fold_if_empty : 1;
 217   guint         ensure_non_null : 1;
 218 };
 219 struct _GParamSpecParam
 220 {
 221   GParamSpec    parent_instance;
 222 };
 223 struct _GParamSpecBoxed
 224 {
 225   GParamSpec    parent_instance;
 226 };
 227 struct _GParamSpecPointer
 228 {
 229   GParamSpec    parent_instance;
 230 };
 231 struct _GParamSpecValueArray
 232 {
 233   GParamSpec    parent_instance;
 234   GParamSpec   *element_spec;
 235   guint         fixed_n_elements;
 236 };
 237 struct _GParamSpecClosure
 238 {
 239   GParamSpec    parent_instance;
 240 };
 241 struct _GParamSpecObject
 242 {
 243   GParamSpec    parent_instance;
 244 };
 245
 246 /* --- GParamSpec prototypes --- */
 247 GParamSpec*     g_param_spec_char        (const gchar    *name,
 248                                           const gchar    *nick,
 249                                           const gchar    *blurb,
 250                                           gint8           minimum,
 251                                           gint8           maximum,
 252                                           gint8           default_value,
 253                                           GParamFlags     flags);
 254 GParamSpec*     g_param_spec_uchar       (const gchar    *name,
 255                                           const gchar    *nick,
 256                                           const gchar    *blurb,
 257                                           guint8          minimum,
 258                                           guint8          maximum,
 259                                           guint8          default_value,
 260                                           GParamFlags     flags);
 261 GParamSpec*     g_param_spec_boolean     (const gchar    *name,
 262                                           const gchar    *nick,
 263                                           const gchar    *blurb,
 264                                           gboolean        default_value,
 265                                           GParamFlags     flags);
 266 GParamSpec*     g_param_spec_int         (const gchar    *name,
 267                                           const gchar    *nick,
 268                                           const gchar    *blurb,
 269                                           gint            minimum,
 270                                           gint            maximum,
 271                                           gint            default_value,
 272                                           GParamFlags     flags);
 273 GParamSpec*     g_param_spec_uint        (const gchar    *name,
 274                                           const gchar    *nick,
 275                                           const gchar    *blurb,
 276                                           guint           minimum,
 277                                           guint           maximum,
 278                                           guint           default_value,
 279                                           GParamFlags     flags);
 280 GParamSpec*     g_param_spec_long        (const gchar    *name,
 281                                           const gchar    *nick,
 282                                           const gchar    *blurb,
 283                                           glong           minimum,
 284                                           glong           maximum,
 285                                           glong           default_value,
 286                                           GParamFlags     flags);
 287 GParamSpec*     g_param_spec_ulong       (const gchar    *name,
 288                                           const gchar    *nick,
 289                                           const gchar    *blurb,
 290                                           gulong          minimum,
 291                                           gulong          maximum,
 292                                           gulong          default_value,
 293                                           GParamFlags     flags);
 294 GParamSpec*     g_param_spec_int64       (const gchar    *name,
 295                                           const gchar    *nick,
 296                                           const gchar    *blurb,
 297                                           gint64          minimum,
 298                                           gint64          maximum,
 299                                           gint64          default_value,
 300                                           GParamFlags     flags);
 301 GParamSpec*     g_param_spec_uint64      (const gchar    *name,
 302                                           const gchar    *nick,
 303                                           const gchar    *blurb,
 304                                           guint64         minimum,
 305                                           guint64         maximum,
 306                                           guint64         default_value,
 307                                           GParamFlags     flags);
 308 GParamSpec*    g_param_spec_unichar      (const gchar    *name,
 309                                           const gchar    *nick,
 310                                           const gchar    *blurb,
 311                                           gunichar        default_value,
 312                                           GParamFlags     flags);
 313 GParamSpec*     g_param_spec_enum        (const gchar    *name,
 314                                           const gchar    *nick,
 315                                           const gchar    *blurb,
 316                                           GType           enum_type,
 317                                           gint            default_value,
 318                                           GParamFlags     flags);
 319 GParamSpec*     g_param_spec_flags       (const gchar    *name,
 320                                           const gchar    *nick,
 321                                           const gchar    *blurb,
 322                                           GType           flags_type,
 323                                           guint           default_value,
 324                                           GParamFlags     flags);
 325 GParamSpec*     g_param_spec_float       (const gchar    *name,
 326                                           const gchar    *nick,
 327                                           const gchar    *blurb,
 328                                           gfloat          minimum,
 329                                           gfloat          maximum,
 330                                           gfloat          default_value,
 331                                           GParamFlags     flags);
 332 GParamSpec*     g_param_spec_double      (const gchar    *name,
 333                                           const gchar    *nick,
 334                                           const gchar    *blurb,
 335                                           gdouble         minimum,
 336                                           gdouble         maximum,
 337                                           gdouble         default_value,
 338                                           GParamFlags     flags);
 339 GParamSpec*     g_param_spec_string      (const gchar    *name,
 340                                           const gchar    *nick,
 341                                           const gchar    *blurb,
 342                                           const gchar    *default_value,
 343                                           GParamFlags     flags);
 344 GParamSpec*     g_param_spec_param       (const gchar    *name,
 345                                           const gchar    *nick,
 346                                           const gchar    *blurb,
 347                                           GType           param_type,
 348                                           GParamFlags     flags);
 349 GParamSpec*     g_param_spec_boxed       (const gchar    *name,
 350                                           const gchar    *nick,
 351                                           const gchar    *blurb,
 352                                           GType           boxed_type,
 353                                           GParamFlags     flags);
 354 GParamSpec*     g_param_spec_pointer     (const gchar    *name,
 355                                           const gchar    *nick,
 356                                           const gchar    *blurb,
 357                                           GParamFlags     flags);
 358 GParamSpec*     g_param_spec_value_array (const gchar    *name,
 359                                           const gchar    *nick,
 360                                           const gchar    *blurb,
 361                                           GParamSpec     *element_spec,
 362                                           GParamFlags     flags);
 363 GParamSpec*     g_param_spec_closure     (const gchar    *name,
 364                                           const gchar    *nick,
 365                                           const gchar    *blurb,
 366                                           GParamFlags     flags);
 367 GParamSpec*     g_param_spec_object      (const gchar    *name,
 368                                           const gchar    *nick,
 369                                           const gchar    *blurb,
 370                                           GType           object_type,
 371                                           GParamFlags     flags);
 372
 373 G_END_DECLS
 374
 375 #endif /* __G_PARAMSPECS_H__ */