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.