VSelectPanelItem
Name
VSelectPanelItem - selects an item from the panel in the dialog window.
Synopsis
VSelectPanelItem(event, cmd_selected, switch_selected)
XEvent *event;
char cmd_selected[80]; /*RETURN*/
char switch_selected[80]; /*RETURN*/
Description
VSelectPanelItem selects an item from the panel in the dialog window.
VSelectPanelItem accepts LEFT or MIDDLE button press and returns the
command selected to cmd_selected. If the command type is a button (0),
VSelectPanelItem returns a NULL string to switch_selected; if the command
type is a switch (1), VSelectPanelItem returns the switch value to
switch_selected. If the command type is a switch, then on pressing the
LEFT button VSelectPanelItem switches to one higher value; when a MIDDLE
button is pressed, VSelectPanelItem switches to one lower value. If an
error occurs, VSelectPanelItem returns a NULL string to cmd_selected and
switch_selected. If the dialog window is not in front of the image window or
if the event type is not ButtonPress or the LEFT/MIDDLE button is not pressed
or if the event does not happen in the dialog window or if the LEFT/MIDDLE
button is pressed and the cursor is not within the panel, VSelectPanelItem
returns an error code.
Return Value
0 - work successfully.
204 - the type of event is invalid.
205 - the window in which the event happens is invalid.
206 - the cursor is not within the command.
214 - the dialog window is not displayed in front of the image window.
216 - the panel is not displayed in the dialog window.
Parameters
event - the event selected.
cmd_selected - returns a character string of the command selected.
switch_selected - returns a character string of the switch value selected.
Side Effects
None.
Entry Conditions
If VCreateColormap is not called earlier, VSelectPanelItem prints an
error message to the standard error stream, produces a core dump file and
exits from the current process.
Related Functions
VDisplayPanel,
VErasePanel,
VGetPanelInformation,
VChangePanelItem.