| Input Parameters | Significance |
| DtvLong idb | button area Id |
| DtvLong pos | (logical) position of the button |
| char *nam | button name |
| Output Parameters | Significance |
| none | - |
| Return Code | Significance |
| 0 | all ok |
| 1 | wrong (logical) position |
| -1 | zero pointer |
The button buffer of a button area can hold all the button names defined in the system entity T_SELECTION, whose button entries are assigned to the button area.
The function automatically invoke any set Button listener function.