cw_ffield

Source: utils/widgets/cw_ffield.pro

 CW_FFIELD
        A labeled text entry field

 Usage:
        id = cw_ffield(parent, ...)

 Return:
        id      long    The ID of the compound widget

 Argument:
        parent  long    input   The ID of the base in which the widget
                                will sit.

 Keywords:
        label   string  input   The label to be attached to the entry box
        value   ...     input   The initial value of the widget
        uvalue  ...     input   A user-value for the compound.
        floating        input   If set then the values are floating point
        double          input   If set, then the values are double
                                precision fp
        integer         input   If set then the values are short
                                integers
        long_int        input   If set then the values are long
                                integers
        text            input   If set, then the values are text
                                strings (default action)
        format  string  input   The format for displaying the value.
        xsize   int     input   The size of the text input box (chars)
        ysize   int     input   The number of rows in the box
        column          input   If set then put the label above the
                                text box (default is to the left)
        frame           input   If set, then put a box around the
                                whole compound
        box             input   If set, then put a box around the text
                                field.
        all_events      input   If set, then return all events except
                                selection events
        no_event        input   If set, then don't return events at
                                all.
        select_events   input   If set and all_events is set, then
                                even return selection events
        tracking_events input   If set, then enable cursor tracking
                                events in the text window.
        capture_focus   input   If set, then putting the cursor into
                                the text-box gives the focus to the widget.
        array_valued    input   If set, then the widget can accept &
                                return an array of values (normally
                                only scalar values are accepted)
        scroll          input   If set then make the text widget a
                                scrolling widget.
        graphics        input   If set and this is a text input box,
                                don't return strings ending in a
                                single pling "!" (To avoid hershey
                                character errors).
        font    string  input   The font to use for the label.
        fieldfont string input  The font to use for the entry box.

 Restrictions:
        If the text window does not contain a valid value for the
        given type, then the null string is returned by a get_value
        call.

 History:
        Original: 25/8/95; SJT
        use decoders rather than internal reads: 29/8/95; SJT
        Add tracking_events key: 4/12/95; SJT
        Add array_valued and scroll keys: 9/12/96; SJT
        Modify handler so tracking events can be returned by
        "non-editable" or "non-event" widgets: 14/1/97; SJT
        Add CAPTURE_FOCUS key: 6/2/97; SJT
        Add GRAPHICS key: 12/2/97; SJT
        Put in "event backlog" trapping to prevent the multiple
        updating of the plot when a title is typed rapidly: 3/7/97; SJT
        Renamed as cw_ffield, added font keys and included keyboard
        focus events (to get right feel for IDL_HS): 7/12/99; SJT