LWL v0.8 - Reference Manual


extern int lwl_set_attributes

(lwlh_t HANDLE, lwl_tag_t TAGS,
  ... )

Modify the attributes of a LWL handle.

Documentation

Modify the attributes of a LWL handle. To use this function, you must use the LWL_TAGS to specify each tag you want to set. The list of tags is fully determinated by the lwl_tag_t type. Each tag must be followed by its new value, and the tag list must be terminated by LWL_TAG_DONE. If the tag list is not terminated by LWL_TAG_DONE the result of this function is not determined. Returns 0 in case of success. Returns -1 in case of failure.

Example:

lwl_set_attributes (my_handle, LWL_TAG_PREFIX, "my example app", LWL_TAG_FILE, stderr, LWL_TAG_OPTIONS, LWL_OPT_PRIORITY | LWL_OPT_DATE, LWL_TAG_DONE);

Requires: HANDLE must be a LWL handle successfully allocated by lwl_alloc().

docppcomment:

Parameters:
HANDLE - The LWL handle to use.
TAGS - , ... A coma separated list of (LWL_TAG_xxx, value) couples, terminated by the special LWL_TAG_DONE lwl_tag_t.
Returns:
0 in case of success, -1 in case of failure.
See Also:
lwl_tag_t

Alphabetic index


LWL Reference Manual
Last modified: Wed Jun 26 15:51:54 CEST 2002