| 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.