param_value_types.sgml

GLib是GTK+和GNOME工程的基础底层核心程序库

<refentry id="gobject-Standard-Parameter-and-Value-Types">
<refmeta>
<refentrytitle>Parameters and Values</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GOBJECT Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>Parameters and Values</refname><refpurpose>Standard Parameter and Value Types.</refpurpose>
</refnamediv>

<refsynopsisdiv><title>Synopsis</title>
<synopsis>

#include &lt;gobject.h&gt;



#define     <link linkend="G-IS-PARAM-SPEC-BOOLEAN-CAPS">G_IS_PARAM_SPEC_BOOLEAN</link>         (pspec)
#define     <link linkend="G-PARAM-SPEC-BOOLEAN-CAPS">G_PARAM_SPEC_BOOLEAN</link>            (pspec)
#define     <link linkend="G-VALUE-HOLDS-BOOLEAN-CAPS">G_VALUE_HOLDS_BOOLEAN</link>           (value)
#define     <link linkend="G-TYPE-PARAM-BOOLEAN-CAPS">G_TYPE_PARAM_BOOLEAN</link>
struct      <link linkend="GParamSpecBoolean">GParamSpecBoolean</link>;
<link linkend="GParamSpec">GParamSpec</link>* <link linkend="g-param-spec-boolean">g_param_spec_boolean</link>            (const <link linkend="gchar">gchar</link> *name,
                                             const <link linkend="gchar">gchar</link> *nick,
                                             const <link linkend="gchar">gchar</link> *blurb,
                                             <link linkend="gboolean">gboolean</link> default_value,
                                             <link linkend="GParamFlags">GParamFlags</link> flags);
void        <link linkend="g-value-set-boolean">g_value_set_boolean</link>             (<link linkend="GValue">GValue</link> *value,
                                             <link linkend="gboolean">gboolean</link> v_boolean);
<link linkend="gboolean">gboolean</link>    <link linkend="g-value-get-boolean">g_value_get_boolean</link>             (const <link linkend="GValue">GValue</link> *value);

#define     <link linkend="G-IS-PARAM-SPEC-CHAR-CAPS">G_IS_PARAM_SPEC_CHAR</link>            (pspec)
#define     <link linkend="G-PARAM-SPEC-CHAR-CAPS">G_PARAM_SPEC_CHAR</link>               (pspec)
#define     <link linkend="G-VALUE-HOLDS-CHAR-CAPS">G_VALUE_HOLDS_CHAR</link>              (value)
#define     <link linkend="G-TYPE-PARAM-CHAR-CAPS">G_TYPE_PARAM_CHAR</link>
struct      <link linkend="GParamSpecChar">GParamSpecChar</link>;
<link linkend="GParamSpec">GParamSpec</link>* <link linkend="g-param-spec-char">g_param_spec_char</link>               (const <link linkend="gchar">gchar</link> *name,
                                             const <link linkend="gchar">gchar</link> *nick,
                                             const <link linkend="gchar">gchar</link> *blurb,
                                             <link linkend="gint8">gint8</link> minimum,
                                             <link linkend="gint8">gint8</link> maximum,
                                             <link linkend="gint8">gint8</link> default_value,
                                             <link linkend="GParamFlags">GParamFlags</link> flags);
void        <link linkend="g-value-set-char">g_value_set_char</link>                (<link linkend="GValue">GValue</link> *value,
                                             <link linkend="gchar">gchar</link> v_char);
<link linkend="gchar">gchar</link>       <link linkend="g-value-get-char">g_value_get_char</link>                (const <link linkend="GValue">GValue</link> *value);

#define     <link linkend="G-IS-PARAM-SPEC-UCHAR-CAPS">G_IS_PARAM_SPEC_UCHAR</link>           (pspec)
#define     <link linkend="G-PARAM-SPEC-UCHAR-CAPS">G_PARAM_SPEC_UCHAR</link>              (pspec)
#define     <link linkend="G-VALUE-HOLDS-UCHAR-CAPS">G_VALUE_HOLDS_UCHAR</link>             (value)
#define     <link linkend="G-TYPE-PARAM-UCHAR-CAPS">G_TYPE_PARAM_UCHAR</link>
struct      <link linkend="GParamSpecUChar">GParamSpecUChar</link>;
<link linkend="GParamSpec">GParamSpec</link>* <link linkend="g-param-spec-uchar">g_param_spec_uchar</link>              (const <link linkend="gchar">gchar</link> *name,
                                             const <link linkend="gchar">gchar</link> *nick,
                                             const <link linkend="gchar">gchar</link> *blurb,
                                             <link linkend="guint8">guint8</link> minimum,
                                             <link linkend="guint8">guint8</link> maximum,
                                             <link linkend="guint8">guint8</link> default_value,
                                             <link linkend="GParamFlags">GParamFlags</link> flags);
void        <link linkend="g-value-set-uchar">g_value_set_uchar</link>               (<link linkend="GValue">GValue</link> *value,
                                             <link linkend="guchar">guchar</link> v_uchar);
<link linkend="guchar">guchar</link>      <link linkend="g-value-get-uchar">g_value_get_uchar</link>               (const <link linkend="GValue">GValue</link> *value);

#define     <link linkend="G-IS-PARAM-SPEC-INT-CAPS">G_IS_PARAM_SPEC_INT</link>             (pspec)
#define     <link linkend="G-PARAM-SPEC-INT-CAPS">G_PARAM_SPEC_INT</link>                (pspec)
#define     <link linkend="G-VALUE-HOLDS-INT-CAPS">G_VALUE_HOLDS_INT</link>               (value)
#define     <link linkend="G-TYPE-PARAM-INT-CAPS">G_TYPE_PARAM_INT</link>
struct      <link linkend="GParamSpecInt">GParamSpecInt</link>;
<link linkend="GParamSpec">GParamSpec</link>* <link linkend="g-param-spec-int">g_param_spec_int</link>                (const <link linkend="gchar">gchar</link> *name,
                                             const <link linkend="gchar">gchar</link> *nick,
                                             const <link linkend="gchar">gchar</link> *blurb,
                                             <link linkend="gint">gint</link> minimum,
                                             <link linkend="gint">gint</link> maximum,
                                             <link linkend="gint">gint</link> default_value,
                                             <link linkend="GParamFlags">GParamFlags</link> flags);
void        <link linkend="g-value-set-int">g_value_set_int</link>                 (<link linkend="GValue">GValue</link> *value,
                                             <link linkend="gint">gint</link> v_int);
<link linkend="gint">gint</link>        <link linkend="g-value-get-int">g_value_get_int</link>                 (const <link linkend="GValue">GValue</link> *value);

#define     <link linkend="G-IS-PARAM-SPEC-UINT-CAPS">G_IS_PARAM_SPEC_UINT</link>            (pspec)
#define     <link linkend="G-PARAM-SPEC-UINT-CAPS">G_PARAM_SPEC_UINT</link>               (pspec)
#define     <link linkend="G-VALUE-HOLDS-UINT-CAPS">G_VALUE_HOLDS_UINT</link>              (value)
#define     <link linkend="G-TYPE-PARAM-UINT-CAPS">G_TYPE_PARAM_UINT</link>
struct      <link linkend="GParamSpecUInt">GParamSpecUInt</link>;
<link linkend="GParamSpec">GParamSpec</link>* <link linkend="g-param-spec-uint">g_param_spec_uint</link>               (const <link linkend="gchar">gchar</link> *name,
                                             const <link linkend="gchar">gchar</link> *nick,
                                             const <link linkend="gchar">gchar</link> *blurb,
                                             <link linkend="guint">guint</link> minimum,
                                             <link linkend="guint">guint</link> maximum,
                                             <link linkend="guint">guint</link> default_value,
                                             <link linkend="GParamFlags">GParamFlags</link> flags);
void        <link linkend="g-value-set-uint">g_value_set_uint</link>                (<link linkend="GValue">GValue</link> *value,
                                             <link linkend="guint">guint</link> v_uint);
<link linkend="guint">guint</link>       <link linkend="g-value-get-uint">g_value_get_uint</link>                (const <link linkend="GValue">GValue</link> *value);

#define     <link linkend="G-IS-PARAM-SPEC-LONG-CAPS">G_IS_PARAM_SPEC_LONG</link>            (pspec)
#define     <link linkend="G-PARAM-SPEC-LONG-CAPS">G_PARAM_SPEC_LONG</link>               (pspec)
#define     <link linkend="G-VALUE-HOLDS-LONG-CAPS">G_VALUE_HOLDS_LONG</link>              (value)
#define     <link linkend="G-TYPE-PARAM-LONG-CAPS">G_TYPE_PARAM_LONG</link>
struct      <link linkend="GParamSpecLong">GParamSpecLong</link>;
<link linkend="GParamSpec">GParamSpec</link>* <link linkend="g-param-spec-long">g_param_spec_long</link>               (const <link linkend="gchar">gchar</link> *name,
                                             const <link linkend="gchar">gchar</link> *nick,
                                             const <link linkend="gchar">gchar</link> *blurb,
                                             <link linkend="glong">glong</link> minimum,
                                             <link linkend="glong">glong</link> maximum,
                                             <link linkend="glong">glong</link> default_value,
                                             <link linkend="GParamFlags">GParamFlags</link> flags);
void        <link linkend="g-value-set-long">g_value_set_long</link>                (<link linkend="GValue">GValue</link> *value,
                                             <link linkend="glong">glong</link> v_long);
<link linkend="glong">glong</link>       <link linkend="g-value-get-long">g_value_get_long</link>                (const <link linkend="GValue">GValue</link> *value);

#define     <link linkend="G-IS-PARAM-SPEC-ULONG-CAPS">G_IS_PARAM_SPEC_ULONG</link>           (pspec)
#define     <link linkend="G-PARAM-SPEC-ULONG-CAPS">G_PARAM_SPEC_ULONG</link>              (pspec)
#define     <link linkend="G-VALUE-HOLDS-ULONG-CAPS">G_VALUE_HOLDS_ULONG</link>             (value)
#define     <link linkend="G-TYPE-PARAM-ULONG-CAPS">G_TYPE_PARAM_ULONG</link>
struct      <link linkend="GParamSpecULong">GParamSpecULong</link>;
<link linkend="GParamSpec">GParamSpec</link>* <link linkend="g-param-spec-ulong">g_param_spec_ulong</link>              (const <link linkend="gchar">gchar</link> *name,
                                             const <link linkend="gchar">gchar</link> *nick,
                                             const <link linkend="gchar">gchar</link> *blurb,
                                             <link linkend="gulong">gulong</link> minimum,
                                             <link linkend="gulong">gulong</link> maximum,
                                             <link linkend="gulong">gulong</link> default_value,
                                             <link linkend="GParamFlags">GParamFlags</link> flags);
void        <link linkend="g-value-set-ulong">g_value_set_ulong</link>               (<link linkend="GValue">GValue</link> *value,
                                             <link linkend="gulong">gulong</link> v_ulong);
<link linkend="gulong">gulong</link>      <link linkend="g-value-get-ulong">g_value_get_ulong</link>               (const <link linkend="GValue">GValue</link> *value);

#define     <link linkend="G-IS-PARAM-SPEC-INT64-CAPS">G_IS_PARAM_SPEC_INT64</link>           (pspec)
#define     <link linkend="G-PARAM-SPEC-INT64-CAPS">G_PARAM_SPEC_INT64</link>              (pspec)
#define     <link linkend="G-VALUE-HOLDS-INT64-CAPS">G_VALUE_HOLDS_INT64</link>             (value)
#define     <link linkend="G-TYPE-PARAM-INT64-CAPS">G_TYPE_PARAM_INT64</link>
struct      <link linkend="GParamSpecInt64">GParamSpecInt64</link>;
<link linkend="GParamSpec">GParamSpec</link>* <link linkend="g-param-spec-int64">g_param_spec_int64</link>              (const <link linkend="gchar">gchar</link> *name,
                                             const <link linkend="gchar">gchar</link> *nick,
                                             const <link linkend="gchar">gchar</link> *blurb,
                                             <link linkend="gint64">gint64</link> minimum,
                                             <link linkend="gint64">gint64</link> maximum,
                                             <link linkend="gint64">gint64</link> default_value,
                                             <link linkend="GParamFlags">GParamFlags</link> flags);
void        <link linkend="g-value-set-int64">g_value_set_int64</link>               (<link linkend="GValue">GValue</link> *value,
                                             <link linkend="gint64">gint64</link> v_int64);
<link linkend="gint64">gint64</link>      <link linkend="g-value-get-int64">g_value_get_int64</link>               (const <link linkend="GValue">GValue</link> *value);

#define     <link linkend="G-IS-PARAM-SPEC-UINT64-CAPS">G_IS_PARAM_SPEC_UINT64</link>          (pspec)
#define     <link linkend="G-PARAM-SPEC-UINT64-CAPS">G_PARAM_SPEC_UINT64</link>             (pspec)
#define     <link linkend="G-VALUE-HOLDS-UINT64-CAPS">G_VALUE_HOLDS_UINT64</link>            (value)
#define     <link linkend="G-TYPE-PARAM-UINT64-CAPS">G_TYPE_PARAM_UINT64</link>
struct      <link linkend="GParamSpecUInt64">GParamSpecUInt64</link>;
<link linkend="GParamSpec">GParamSpec</link>* <link linkend="g-param-spec-uint64">g_param_spec_uint64</link>             (const <link linkend="gchar">gchar</link> *name,
                                             const <link linkend="gchar">gchar</link> *nick,
                                             const <link linkend="gchar">gchar</link> *blurb,
                                             <link linkend="guint64">guint64</link> minimum,
                                             <link linkend="guint64">guint64</link> maximum,
                                             <link linkend="guint64">guint64</link> default_value,
                                             <link linkend="GParamFlags">GParamFlags</link> flags);
void        <link linkend="g-value-set-uint64">g_value_set_uint64</link>              (<link linkend="GValue">GValue</link> *value,
                                             <link linkend="guint64">guint64</link> v_uint64);
<link linkend="guint64">guint64</link>     <link linkend="g-value-get-uint64">g_value_get_uint64</link>              (const <link linkend="GValue">GValue</link> *value);

#define     <link linkend="G-IS-PARAM-SPEC-FLOAT-CAPS">G_IS_PARAM_SPEC_FLOAT</link>           (pspec)
#define     <link linkend="G-PARAM-SPEC-FLOAT-CAPS">G_PARAM_SPEC_FLOAT</link>              (pspec)
#define     <link linkend="G-VALUE-HOLDS-FLOAT-CAPS">G_VALUE_HOLDS_FLOAT</link>             (value)
#define     <link linkend="G-TYPE-PARAM-FLOAT-CAPS">G_TYPE_PARAM_FLOAT</link>
struct      <link linkend="GParamSpecFloat">GParamSpecFloat</link>;
<link linkend="GParamSpec">GParamSpec</link>* <link linkend="g-param-spec-float">g_param_spec_float</link>              (const <link linkend="gchar">gchar</link> *name,
                                             const <link linkend="gchar">gchar</link> *nick,
                                             const <link linkend="gchar">gchar</link> *blurb,
                                             <link linkend="gfloat">gfloat</link> minimum,
                                             <link linkend="gfloat">gfloat</link> maximum,
                                             <link linkend="gfloat">gfloat</link> default_value,
                                             <link linkend="GParamFlags">GParamFlags</link> flags);
void        <link linkend="g-value-set-float">g_value_set_float</link>               (<link linkend="GValue">GValue</link> *value,
                                             <link linkend="gfloat">gfloat</link> v_float);
<link linkend="gfloat">gfloat</link>      <link linkend="g-value-get-float">g_value_get_float</link>               (const <link linkend="GValue">GValue</link> *value);

#define     <link linkend="G-IS-PARAM-SPEC-DOUBLE-CAPS">G_IS_PARAM_SPEC_DOUBLE</link>          (pspec)
#define     <link linkend="G-PARAM-SPEC-DOUBLE-CAPS">G_PARAM_SPEC_DOUBLE</link>             (pspec)
#define     <link linkend="G-VALUE-HOLDS-DOUBLE-CAPS">G_VALUE_HOLDS_DOUBLE</link>            (value)
#define     <link linkend="G-TYPE-PARAM-DOUBLE-CAPS">G_TYPE_PARAM_DOUBLE</link>
struct      <link linkend="GParamSpecDouble">GParamSpecDouble</link>;
<link linkend="GParamSpec">GParamSpec</link>* <link linkend="g-param-spec-double">g_param_spec_double</link>             (const <link linkend="gchar">gchar</link> *name,
                                             const <link linkend="gchar">gchar</link> *nick,
                                             const <link linkend="gchar">gchar</link> *blurb,
                                             <link linkend="gdouble">gdouble</link> minimum,
                                             <link linkend="gdouble">gdouble</link> maximum,
                                             <link linkend="gdouble">gdouble</link> default_value,
                                             <link linkend="GParamFlags">GParamFlags</link> flags);
void        <link linkend="g-value-set-double">g_value_set_double</link>              (<link linkend="GValue">GValue</link> *value,
                                             <link linkend="gdouble">gdouble</link> v_double);
<link linkend="gdouble">gdouble</link>     <link linkend="g-value-get-double">g_value_get_double</link>              (const <link linkend="GValue">GValue</link> *value);

#define     <link linkend="G-IS-PARAM-SPEC-ENUM-CAPS">G_IS_PARAM_SPEC_ENUM</link>            (pspec)
#define     <link linkend="G-PARAM-SPEC-ENUM-CAPS">G_PARAM_SPEC_ENUM</link>               (pspec)
#define     <link linkend="G-VALUE-HOLDS-ENUM-CAPS">G_VALUE_HOLDS_ENUM</link>              (value)
#define     <link linkend="G-TYPE-PARAM-ENUM-CAPS">G_TYPE_PARAM_ENUM</link>
struct      <link linkend="GParamSpecEnum">GParamSpecEnum</link>;
<link linkend="GParamSpec">GParamSpec</link>* <link linkend="g-param-spec-enum">g_param_spec_enum</link>               (const <link linkend="gchar">gchar</link> *name,
                                             const <link linkend="gchar">gchar</link> *nick,
                                             const <link linkend="gchar">gchar</link> *blurb,
                                             <link linkend="GType">GType</link> enum_type,
                                             <link linkend="gint">gint</link> default_value,
                                             <link linkend="GParamFlags">GParamFlags</link> flags);
void        <link linkend="g-value-set-enum">g_value_set_enum</link>                (<link linkend="GValue">GValue</link> *value,
                                             <link linkend="gint">gint</link> v_enum);
<link linkend="gint">gint</link>        <link linkend="g-value-get-enum">g_value_get_enum</link>                (const <link linkend="GValue">GValue</link> *value);

#define     <link linkend="G-IS-PARAM-SPEC-FLAGS-CAPS">G_IS_PARAM_SPEC_FLAGS</link>           (pspec)
#define     <link linkend="G-PARAM-SPEC-FLAGS-CAPS">G_PARAM_SPEC_FLAGS</link>              (pspec)
#define     <link linkend="G-VALUE-HOLDS-FLAGS-CAPS">G_VALUE_HOLDS_FLAGS</link>             (value)
#define     <link linkend="G-TYPE-PARAM-FLAGS-CAPS">G_TYPE_PARAM_FLAGS</link>
struct      <link linkend="GParamSpecFlags">GParamSpecFlags</link>;
<link linkend="GParamSpec">GParamSpec</link>* <link linkend="g-param-spec-flags">g_param_spec_flags</link>              (const <link linkend="gchar">gchar</link> *name,
                                             const <link linkend="gchar">gchar</link> *nick,
                                             const <link linkend="gchar">gchar</link> *blurb,
                                             <link linkend="GType">GType</link> flags_type,
                                             <link linkend="guint">guint</link> default_value,
                                             <link linkend="GParamFlags">GParamFlags</link> flags);
void        <link linkend="g-value-set-flags">g_value_set_flags</link>               (<link linkend="GValue">GValue</link> *value,
                                             <link linkend="guint">guint</link> v_flags);
<link linkend="guint">guint</link>       <link linkend="g-value-get-flags">g_value_get_flags</link>               (const <link linkend="GValue">GValue</link> *value);

#define     <link linkend="G-IS-PARAM-SPEC-STRING-CAPS">G_IS_PARAM_SPEC_STRING</link>          (pspec)
#define     <link linkend="G-PARAM-SPEC-STRING-CAPS">G_PARAM_SPEC_STRING</link>             (pspec)
#define     <link linkend="G-VALUE-HOLDS-STRING-CAPS">G_VALUE_HOLDS_STRING</link>            (value)
#define     <link linkend="G-TYPE-PARAM-STRING-CAPS">G_TYPE_PARAM_STRING</link>
struct      <link linkend="GParamSpecString">GParamSpecString</link>;
typedef     <link linkend="gchararray">gchararray</link>;
<link linkend="GParamSpec">GParamSpec</link>* <link linkend="g-param-spec-string">g_param_spec_string</link>             (const <link linkend="gchar">gchar</link> *name,
                                             const <link linkend="gchar">gchar</link> *nick,
                                             const <link linkend="gchar">gchar</link> *blurb,