//docs/MPGui.doc/SetMPGuiGadgetValue
NAME
SetMPGuiGadgetValue -- Sets the value of an MPGui gadget. (V3)
SYNOPSIS
succ = SetMPGuiGadgetValue( gh, Title, Value)
D0 A0 A1 A2
BOOL SetMPGuiGadgetValue( struct MPGuiHandle *, char *, char *);
FUNCTION
Sets the value of a gadget currently being displayed by
SyncMPGuiRequest().
INPUTS
gh - MPGuiHandle being displayed by SyncMPGuiRequest().
Title - Title of the gadget as in the input file.
Value - Value of the gadget.
Y/N for a CHECKs.
A String for Strings/Files/Modes.
A String (which is converted using strtol) for Numbers/Sliders.
A value or number in the list/cycle for lists/cycles.
Values strung together sperated by space for an MLIST gadget
RESULT
error - 1 for success, 0 for failure.
Error means gadget not found or Value not found.
EXAMPLE
NOTES
Title must be exact including "_" as required.
This should be called from a MPG_MENUHOOK supplied to AllocMPGuiHandle().
e.g. If a Reset To Defaults... menu item is called.
BUTTON gadgets can not have there attributes set.
BUGS
For an MLIST gadget if a value is a substring of another gadget then the
value can be incorrectly set.
MTEXT/TEXT gadgets can not be updated.
SEE ALSO
SyncMPGuiRequest().