![]() |
![]() |
![]() |
Libmatecomponent Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
matecomponent-property-bag-clientmatecomponent-property-bag-client — simplified property bag client wrapper code |
gchar * matecomponent_pbclient_get_string (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
); gchar * matecomponent_pbclient_get_default_string (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
); gchar * matecomponent_pbclient_get_string_with_default (MateComponent_PropertyBag bag
,const char *key
,gchar *defval
,gboolean *def
); gint16 matecomponent_pbclient_get_short (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
); gint16 matecomponent_pbclient_get_default_short (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
); gint16 matecomponent_pbclient_get_short_with_default (MateComponent_PropertyBag bag
,const char *key
,gint16 defval
,gboolean *def
); guint16 matecomponent_pbclient_get_ushort (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
); guint16 matecomponent_pbclient_get_default_ushort (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
); guint16 matecomponent_pbclient_get_ushort_with_default (MateComponent_PropertyBag bag
,const char *key
,guint16 defval
,gboolean *def
); gint32 matecomponent_pbclient_get_long (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
); gint32 matecomponent_pbclient_get_default_long (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
); gint32 matecomponent_pbclient_get_long_with_default (MateComponent_PropertyBag bag
,const char *key
,gint32 defval
,gboolean *def
); guint32 matecomponent_pbclient_get_ulong (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
); guint32 matecomponent_pbclient_get_default_ulong (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
); guint32 matecomponent_pbclient_get_ulong_with_default (MateComponent_PropertyBag bag
,const char *key
,guint32 defval
,gboolean *def
); gfloat matecomponent_pbclient_get_float (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
); gfloat matecomponent_pbclient_get_default_float (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
); gfloat matecomponent_pbclient_get_float_with_default (MateComponent_PropertyBag bag
,const char *key
,gfloat defval
,gboolean *def
); gdouble matecomponent_pbclient_get_double (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
); gdouble matecomponent_pbclient_get_default_double (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
); gdouble matecomponent_pbclient_get_double_with_default (MateComponent_PropertyBag bag
,const char *key
,gdouble defval
,gboolean *def
); gboolean matecomponent_pbclient_get_boolean (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
); gboolean matecomponent_pbclient_get_default_boolean (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
); gboolean matecomponent_pbclient_get_boolean_with_default (MateComponent_PropertyBag bag
,const char *key
,gboolean defval
,gboolean *def
); gchar matecomponent_pbclient_get_char (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
); gchar matecomponent_pbclient_get_default_char (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
); gchar matecomponent_pbclient_get_char_with_default (MateComponent_PropertyBag bag
,const char *key
,gchar defval
,gboolean *def
); CORBA_any * matecomponent_pbclient_get_value (MateComponent_PropertyBag bag
,const char *key
,CORBA_TypeCode opt_tc
,CORBA_Environment *opt_ev
); CORBA_any * matecomponent_pbclient_get_default_value (MateComponent_PropertyBag bag
,const char *key
,CORBA_TypeCode opt_tc
,CORBA_Environment *opt_ev
); void matecomponent_pbclient_set_string (MateComponent_PropertyBag bag
,const char *key
,const char *value
,CORBA_Environment *opt_ev
); void matecomponent_pbclient_set_short (MateComponent_PropertyBag bag
,const char *key
,gint16 value
,CORBA_Environment *opt_ev
); void matecomponent_pbclient_set_ushort (MateComponent_PropertyBag bag
,const char *key
,guint16 value
,CORBA_Environment *opt_ev
); void matecomponent_pbclient_set_long (MateComponent_PropertyBag bag
,const char *key
,gint32 value
,CORBA_Environment *opt_ev
); void matecomponent_pbclient_set_ulong (MateComponent_PropertyBag bag
,const char *key
,guint32 value
,CORBA_Environment *opt_ev
); void matecomponent_pbclient_set_float (MateComponent_PropertyBag bag
,const char *key
,gfloat value
,CORBA_Environment *opt_ev
); void matecomponent_pbclient_set_double (MateComponent_PropertyBag bag
,const char *key
,gdouble value
,CORBA_Environment *opt_ev
); void matecomponent_pbclient_set_boolean (MateComponent_PropertyBag bag
,const char *key
,gboolean value
,CORBA_Environment *opt_ev
); void matecomponent_pbclient_set_char (MateComponent_PropertyBag bag
,const char *key
,gchar value
,CORBA_Environment *opt_ev
); void matecomponent_pbclient_set_value (MateComponent_PropertyBag bag
,const char *key
,CORBA_any *value
,CORBA_Environment *opt_ev
); void matecomponent_pbclient_set_value_async (MateComponent_PropertyBag bag
,const char *key
,CORBA_any *value
,CORBA_Environment *opt_ev
); char * matecomponent_pbclient_get_doc_title (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
); char * matecomponent_pbclient_get_doc (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
); GList * matecomponent_pbclient_get_keys (MateComponent_PropertyBag bag
,CORBA_Environment *opt_ev
); void matecomponent_pbclient_free_keys (GList *key_list
); MateComponent_PropertyFlags matecomponent_pbclient_get_flags (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
); void matecomponent_pbclient_set (MateComponent_PropertyBag bag
,CORBA_Environment *opt_ev
,const char *first_prop
,...
); void matecomponent_pbclient_get (MateComponent_PropertyBag bag
,CORBA_Environment *opt_ev
,const char *first_prop
,...
); char * matecomponent_pbclient_setv (MateComponent_PropertyBag bag
,CORBA_Environment *ev
,const char *first_arg
,va_list var_args
); char * matecomponent_pbclient_getv (MateComponent_PropertyBag bag
,CORBA_Environment *ev
,const char *first_arg
,va_list var_args
); #define matecomponent_property_bag_client_setv #define matecomponent_property_bag_client_getv #define matecomponent_property_bag_client_get_property_type #define matecomponent_property_bag_client_get_value_gboolean #define matecomponent_property_bag_client_get_value_gint #define matecomponent_property_bag_client_get_value_glong #define matecomponent_property_bag_client_get_value_gfloat #define matecomponent_property_bag_client_get_value_gdouble #define matecomponent_property_bag_client_get_value_string #define matecomponent_property_bag_client_get_value_any(pb, name, ev) #define matecomponent_property_bag_client_get_default_gboolean #define matecomponent_property_bag_client_get_default_gint #define matecomponent_property_bag_client_get_default_glong #define matecomponent_property_bag_client_get_default_gfloat #define matecomponent_property_bag_client_get_default_gdouble #define matecomponent_property_bag_client_get_default_string #define matecomponent_property_bag_client_get_default_any(pb, name, ev) #define matecomponent_property_bag_client_set_value_gboolean #define matecomponent_property_bag_client_set_value_gint #define matecomponent_property_bag_client_set_value_glong #define matecomponent_property_bag_client_set_value_gfloat #define matecomponent_property_bag_client_set_value_gdouble #define matecomponent_property_bag_client_set_value_string #define matecomponent_property_bag_client_set_value_any #define matecomponent_property_bag_client_get_docstring #define matecomponent_property_bag_client_get_flags
This code is designed to make the property bag interface slightly easier to use, by allowing optional CORBA environments, sensible return values on exceptions, and accessors for specific types of CORBA_Any. eg. matecomponent_property_bag_client_get_value_glong.
With the property bag interface, as in all current remote MateComponent method invocations, translation issues are very dodgy. Assuming that the server process was activated in the correct locale, all should be well, however there is no guarantee that ( in a rapidly changing locale environment ) the string will be correctly translated. It is difficult to know how to solve this problem.
gchar * matecomponent_pbclient_get_string (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
);
Get a string from the PropertyBag
|
a reference to the PropertyBag |
|
key of the value to get |
|
an optional CORBA_Environment to return failure codes |
Returns : |
the value contained in the database, or zero on error. |
gchar * matecomponent_pbclient_get_default_string (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
);
gchar * matecomponent_pbclient_get_string_with_default (MateComponent_PropertyBag bag
,const char *key
,gchar *defval
,gboolean *def
);
gint16 matecomponent_pbclient_get_short (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
);
Get a 16 bit integer from the PropertyBag
|
a reference to the PropertyBag |
|
key of the value to get |
|
an optional CORBA_Environment to return failure codes |
Returns : |
the value contained in the database. |
gint16 matecomponent_pbclient_get_default_short (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
);
gint16 matecomponent_pbclient_get_short_with_default (MateComponent_PropertyBag bag
,const char *key
,gint16 defval
,gboolean *def
);
guint16 matecomponent_pbclient_get_ushort (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
);
Get a 16 bit unsigned integer from the PropertyBag
|
a reference to the PropertyBag |
|
key of the value to get |
|
an optional CORBA_Environment to return failure codes |
Returns : |
the value contained in the database. |
guint16 matecomponent_pbclient_get_default_ushort (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
);
guint16 matecomponent_pbclient_get_ushort_with_default (MateComponent_PropertyBag bag
,const char *key
,guint16 defval
,gboolean *def
);
gint32 matecomponent_pbclient_get_long (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
);
Get a 32 bit integer from the PropertyBag
|
a reference to the PropertyBag |
|
key of the value to get |
|
an optional CORBA_Environment to return failure codes |
Returns : |
the value contained in the database. |
gint32 matecomponent_pbclient_get_default_long (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
);
gint32 matecomponent_pbclient_get_long_with_default (MateComponent_PropertyBag bag
,const char *key
,gint32 defval
,gboolean *def
);
guint32 matecomponent_pbclient_get_ulong (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
);
Get a 32 bit unsigned integer from the PropertyBag
|
a reference to the PropertyBag |
|
key of the value to get |
|
an optional CORBA_Environment to return failure codes |
Returns : |
the value contained in the database. |
guint32 matecomponent_pbclient_get_default_ulong (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
);
guint32 matecomponent_pbclient_get_ulong_with_default (MateComponent_PropertyBag bag
,const char *key
,guint32 defval
,gboolean *def
);
gfloat matecomponent_pbclient_get_float (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
);
Get a single precision floating point value from the PropertyBag
|
a reference to the PropertyBag |
|
key of the value to get |
|
an optional CORBA_Environment to return failure codes |
Returns : |
the value contained in the database. |
gfloat matecomponent_pbclient_get_default_float (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
);
gfloat matecomponent_pbclient_get_float_with_default (MateComponent_PropertyBag bag
,const char *key
,gfloat defval
,gboolean *def
);
gdouble matecomponent_pbclient_get_double (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
);
Get a double precision floating point value from the PropertyBag
|
a reference to the PropertyBag |
|
key of the value to get |
|
an optional CORBA_Environment to return failure codes |
Returns : |
the value contained in the database. |
gdouble matecomponent_pbclient_get_default_double (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
);
gdouble matecomponent_pbclient_get_double_with_default (MateComponent_PropertyBag bag
,const char *key
,gdouble defval
,gboolean *def
);
gboolean matecomponent_pbclient_get_boolean (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
);
Get a boolean value from the PropertyBag
|
a reference to the PropertyBag |
|
key of the value to get |
|
an optional CORBA_Environment to return failure codes |
Returns : |
the value contained in the database. |
gboolean matecomponent_pbclient_get_default_boolean (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
);
gboolean matecomponent_pbclient_get_boolean_with_default (MateComponent_PropertyBag bag
,const char *key
,gboolean defval
,gboolean *def
);
gchar matecomponent_pbclient_get_char (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
);
Get a 8 bit character value from the PropertyBag
|
a reference to the PropertyBag |
|
key of the value to get |
|
an optional CORBA_Environment to return failure codes |
Returns : |
the value contained in the database. |
gchar matecomponent_pbclient_get_default_char (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
);
gchar matecomponent_pbclient_get_char_with_default (MateComponent_PropertyBag bag
,const char *key
,gchar defval
,gboolean *def
);
CORBA_any * matecomponent_pbclient_get_value (MateComponent_PropertyBag bag
,const char *key
,CORBA_TypeCode opt_tc
,CORBA_Environment *opt_ev
);
Get a value from the PropertyBag
|
a reference to the PropertyBag object |
|
key of the value to get |
|
the type of the value, optional |
|
an optional CORBA_Environment to return failure codes |
Returns : |
the value contained in the PropertyBag, or zero on error. |
CORBA_any * matecomponent_pbclient_get_default_value (MateComponent_PropertyBag bag
,const char *key
,CORBA_TypeCode opt_tc
,CORBA_Environment *opt_ev
);
Get the default value from the PropertyBag
|
a reference to the PropertyBag object |
|
key of the value to get |
|
the type of the value, optional |
|
an optional CORBA_Environment to return failure codes |
Returns : |
the default value contained in the PropertyBag, or zero on error. |
void matecomponent_pbclient_set_string (MateComponent_PropertyBag bag
,const char *key
,const char *value
,CORBA_Environment *opt_ev
);
Set a string value in the PropertyBag.
|
a reference to the PropertyBag |
|
key of the value to set |
|
the new value |
|
an optional CORBA_Environment to return failure codes |
void matecomponent_pbclient_set_short (MateComponent_PropertyBag bag
,const char *key
,gint16 value
,CORBA_Environment *opt_ev
);
Set a 16 bit integer value in the PropertyBag.
|
a reference to the PropertyBag |
|
key of the value to set |
|
the new value |
|
an optional CORBA_Environment to return failure codes |
void matecomponent_pbclient_set_ushort (MateComponent_PropertyBag bag
,const char *key
,guint16 value
,CORBA_Environment *opt_ev
);
Set a 16 bit unsigned integer value in the PropertyBag.
|
a reference to the PropertyBag |
|
key of the value to set |
|
the new value |
|
an optional CORBA_Environment to return failure codes |
void matecomponent_pbclient_set_long (MateComponent_PropertyBag bag
,const char *key
,gint32 value
,CORBA_Environment *opt_ev
);
Set a 32 bit integer value in the PropertyBag.
|
a reference to the PropertyBag |
|
key of the value to set |
|
the new value |
|
an optional CORBA_Environment to return failure codes |
void matecomponent_pbclient_set_ulong (MateComponent_PropertyBag bag
,const char *key
,guint32 value
,CORBA_Environment *opt_ev
);
Set a 32 bit unsigned integer value in the PropertyBag.
|
a reference to the PropertyBag |
|
key of the value to set |
|
the new value |
|
an optional CORBA_Environment to return failure codes |
void matecomponent_pbclient_set_float (MateComponent_PropertyBag bag
,const char *key
,gfloat value
,CORBA_Environment *opt_ev
);
Set a single precision floating point value in the PropertyBag.
|
a reference to the PropertyBag |
|
key of the value to set |
|
the new value |
|
an optional CORBA_Environment to return failure codes |
void matecomponent_pbclient_set_double (MateComponent_PropertyBag bag
,const char *key
,gdouble value
,CORBA_Environment *opt_ev
);
Set a double precision floating point value in the PropertyBag.
|
a reference to the PropertyBag |
|
key of the value to set |
|
the new value |
|
an optional CORBA_Environment to return failure codes |
void matecomponent_pbclient_set_boolean (MateComponent_PropertyBag bag
,const char *key
,gboolean value
,CORBA_Environment *opt_ev
);
Set a boolean value in the PropertyBag.
|
a reference to the PropertyBag |
|
key of the value to set |
|
the new value |
|
an optional CORBA_Environment to return failure codes |
void matecomponent_pbclient_set_char (MateComponent_PropertyBag bag
,const char *key
,gchar value
,CORBA_Environment *opt_ev
);
Set a 8 bit characte value in the PropertyBag.
|
a reference to the PropertyBag |
|
key of the value to set |
|
the new value |
|
an optional CORBA_Environment to return failure codes |
void matecomponent_pbclient_set_value (MateComponent_PropertyBag bag
,const char *key
,CORBA_any *value
,CORBA_Environment *opt_ev
);
Set a value in the PropertyBag.
|
a reference to the PropertyBag |
|
key of the value to set |
|
the new value |
|
an optional CORBA_Environment to return failure codes |
void matecomponent_pbclient_set_value_async (MateComponent_PropertyBag bag
,const char *key
,CORBA_any *value
,CORBA_Environment *opt_ev
);
Set a value on the PropertyBag asynchronously, discarding any possible roundtrip exceptions.
|
a reference to the PropertyBag |
|
key of the value to set |
|
the new value |
|
an optional CORBA_Environment to return failure codes |
char * matecomponent_pbclient_get_doc_title (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
);
char * matecomponent_pbclient_get_doc (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
);
GList * matecomponent_pbclient_get_keys (MateComponent_PropertyBag bag
,CORBA_Environment *opt_ev
);
MateComponent_PropertyFlags matecomponent_pbclient_get_flags (MateComponent_PropertyBag bag
,const char *key
,CORBA_Environment *opt_ev
);
void matecomponent_pbclient_set (MateComponent_PropertyBag bag
,CORBA_Environment *opt_ev
,const char *first_prop
,...
);
void matecomponent_pbclient_get (MateComponent_PropertyBag bag
,CORBA_Environment *opt_ev
,const char *first_prop
,...
);
char * matecomponent_pbclient_setv (MateComponent_PropertyBag bag
,CORBA_Environment *ev
,const char *first_arg
,va_list var_args
);
This function provides the grunt implementation for other var-arg functions like matecomponent_widget_set_property
|
the property bag |
|
optional CORBA exception environment or NULL |
|
first argument name |
|
list of subsequent name / type / value triplets |
Returns : |
an error string on error or NULL on success. |
char * matecomponent_pbclient_getv (MateComponent_PropertyBag bag
,CORBA_Environment *ev
,const char *first_arg
,va_list var_args
);
This function provides the grunt implementation for other var-arg functions like matecomponent_widget_get_property.
|
the property bag |
|
optional CORBA exception environment or NULL |
|
first argument name |
|
list of subsequent name / type / value triplets |
Returns : |
an error string on error or NULL on success. |
#define matecomponent_property_bag_client_get_property_type
#define matecomponent_property_bag_client_get_value_gboolean
#define matecomponent_property_bag_client_get_value_gint
#define matecomponent_property_bag_client_get_value_glong
#define matecomponent_property_bag_client_get_value_gfloat
#define matecomponent_property_bag_client_get_value_gdouble
#define matecomponent_property_bag_client_get_value_string
#define matecomponent_property_bag_client_get_value_any(pb, name, ev)
#define matecomponent_property_bag_client_get_default_gboolean
#define matecomponent_property_bag_client_get_default_gint
#define matecomponent_property_bag_client_get_default_glong
#define matecomponent_property_bag_client_get_default_gfloat
#define matecomponent_property_bag_client_get_default_gdouble
#define matecomponent_property_bag_client_get_default_string
#define matecomponent_property_bag_client_get_default_any(pb, name, ev)
#define matecomponent_property_bag_client_set_value_gboolean
#define matecomponent_property_bag_client_set_value_gint
#define matecomponent_property_bag_client_set_value_glong
#define matecomponent_property_bag_client_set_value_gfloat
#define matecomponent_property_bag_client_set_value_gdouble
#define matecomponent_property_bag_client_set_value_string
#define matecomponent_property_bag_client_set_value_any
#define matecomponent_property_bag_client_get_docstring