[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]

Text-display (TEXT_KIND) and numeric-display (NUMBER_KIND) gadgets are
read-only displays of information.  They are useful for displaying
information that is not editable or selectable, while allowing the
application to use the GadTools formatting and visuals.  Conveniently, the
visuals are automatically refreshed through normal GadTools gadget
processing.  The values displayed may be modified by the program in the
same way other GadTools gadgets may be updated.

Text-display and number-display gadgets consist of a fixed label (the one
supplied as the NewGadget's ng_GadgetText), as well as a changeable string
or number (GTTX_Text or GTNM_Number respectively).  The fixed label is
placed according to the PLACETEXT_ flag chosen in the NewGadget ng_Flags
field.  The variable part is aligned to the left-edge of the gadget.

Text-display gadgets recognize the following tags:

GTTX_Text (STRPTR)
    Pointer to the string to be displayed or NULL for no string.  The
    default is NULL.  (Create and set.)

GTTX_Border (BOOL)
    Set to TRUE to place a recessed border around the displayed string.
    The default is FALSE.  (Create only.)

GTTX_CopyText (BOOL)
    This flag instructs the text-display gadget to copy the supplied
    GTTX_Text string instead of using only a pointer to the string.  This
    only works for the value of GTTX_Text set at CreateGadget() time.  If
    GTTX_Text is changed, the new text will be referenced by pointer, not
    copied.  Do not use this tag without a non-NULL GTTX_Text.  (Create
    only.)


Number-display gadgets have the following tags:

GTNM_Number (LONG)
    The number to be displayed.  The default is zero.  (Create or set.)

GTNM_Border (BOOL)
    Set to TRUE to place a recessed border around the displayed number.
    The default is FALSE.  (Create only.)

Since they are not selectable, text-display and numeric-display gadgets
never cause IntuiMessages to be sent to the application.