Name

pinq_string_st3 − Returns information about the string device state. 

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

Syntax

void pinq_string_st3 (
  Pint             wsid,        /∗ (I) Workstation identifier. ∗/
  Pint             dev_num,     /∗ (I) String device number. ∗/
  Pstore           store,       /∗ (I) Handle to store the object.  store
                                       manages the memory referenced by
                                       ∗init_string and
                                       ∗string_data. ∗/
  Pint            ∗error_ind,   /∗ (O) Error indicator. ∗/
  Pop_mode        ∗op_mode,     /∗ (O) Operating mode. ∗/
  Pecho_switch    ∗echo,        /∗ (O) Echo switch. ∗/
  char           ∗∗init_string, /∗ (O) Initial string. ∗/
  Pint            ∗pet,         /∗ (O) Prompt and echo type. ∗/
  Plimit3         ∗echo_vol,    /∗ (O) Echo volume, in device
                                       coordinates. ∗/
  Pstring_data3  ∗∗string_data  /∗ (O) Data record. ∗/
)

Data Structures

typedef void ∗Pstore;
typedef enum {
    POP_REQ,       /∗ request mode ∗/
    POP_SAMPLE,    /∗ sample mode ∗/
    POP_EVENT      /∗ event mode ∗/
} Pop_mode;
typedef enum {
    PSWITCH_NO_ECHO,    /∗ echo disabled ∗/
    PSWITCH_ECHO        /∗ echo enabled ∗/
} Pecho_switch;
typedef struct {
    Pfloat    x_min;    /∗ x minimum ∗/
    Pfloat    x_max;    /∗ x maximum ∗/
    Pfloat    y_min;    /∗ y minimum ∗/
    Pfloat    y_max;    /∗ y maximum ∗/
    Pfloat    z_min;    /∗ z minimum ∗/
    Pfloat    z_max;    /∗ z maximum ∗/
} Plimit3;
typedef struct { /∗ string data record ∗/
    Pint    in_buf_size;     /∗ input buffer size ∗/
    Pint    init_pos;        /∗ initial editing position ∗/
    union Pstring3_pets {
        struct Pstring3_pet_r1 {
            char    ∗title_string;    /∗ title string for the device ∗/
        } pet_r1;
    } pets;
} Pstring_data3;

Description

pinq_string_st3 queries the workstation state list and returns values for the following:

•Operating mode value

•Echo switch value

•Initial string

•Prompt and echo type

•Echo volume in device coordinates

•String data record

See Also

pcreate_store
pdel_store
pinit_string3
pinq_string_st
pset_string_mode