Name

pinq_def_choice_data − Returns choice information. 

Operating States: PHOP, ∗, ∗, ∗
PHIGS standard function

Syntax

void pinq_def_choice_data (
  Pint             wstype,        /∗ (I) Workstation type. ∗/
  Pint             dev_num,       /∗ (I) Logical input device number. ∗/
  Pstore           store,         /∗ (I) Handle to store the object.
                                         store manages the memory
                                         referenced by ∗pets and
                                         choice_data. ∗/
  Pint            ∗error_ind,     /∗ (O) Error indicator. ∗/
  Pint            ∗max_choices,   /∗ (O) Maximum number of choices. ∗/
  Pint_list      ∗∗pets,          /∗ (O) List of PETs. ∗/
  Plimit          ∗echo_area,     /∗ (O) Default echo area, in device
                                         coordinates. ∗/
  Pchoice_data   ∗∗choice_data    /∗ (O) Default choice data record. ∗/
)

Data Structures

typedef void ∗Pstore;
typedef struct {
    Pint      num_ints;   /∗ number of Pints in the list ∗/
    Pint     ∗ints;       /∗ list of integers ∗/
} Pint_list;
typedef struct {
    Pfloat    x_min;    /∗ x minimum ∗/
    Pfloat    x_max;    /∗ x maximum ∗/
    Pfloat    y_min;    /∗ y minimum ∗/
    Pfloat    y_max;    /∗ y maximum ∗/
} Plimit;
typedef struct { /∗ choice data record ∗/
    union Pchoice_pets {
        struct Pchoice_pet_r1 {
            Pint      num_strings;     /∗ number of choice strings ∗/
            char    ∗∗strings;         /∗ array of choice strings ∗/
            char     ∗title_string;    /∗ title string for the device ∗/
        } pet_r1;
 .
 .
 .
    } pets;
} Pchoice_data;

Because this function returns information on the default choice data (PET 1), the data structures for the other PETs have been omitted.

Description

pinq_def_choice_data queries the workstation description table and returns values for the following:

•Maximum number of choice alternatives

•List of available prompt and echo types

•Default echo area in device coordinates

•Default choice data record

See Also

pcreate_store
pdel_store
pinit_choice
pinq_def_choice_data3