DtvLong dal_wdg_set_buf (iwd, buf)

Fills the widget buffer.

Input Parameters Significance
DtvLong iwd widget Id
char *buf buffer string

Output Parameters Significance
no -

Return Code Significance
0 no error
1 zero pointer input

The widget buffer is a user-configurable storage space of the widget and is used to support programming. The widget buffer can be used to pass for instance status- or other object-specific information, which are required as long as the widget exists.

This function creates a copy of the passed string in the widget buffer. The buffer can have any size and is empty after the button area has been created.