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


NAME
    GT_GetIMsg -- Get an intuimessage, with gadtools processing. (v36)

SYNOPSIS
    imsg = GT_GetIMsg(intuiport)
    D0                A0

    struct intuimessage *gt_getimsg(struct msgport *);

FUNCTION
    Use GT_GetIMsg() in place of the usual exec.library/getmsg() when
    reading IntuiMessages from your window's UserPort.  If needed,
    the GadTools dispatcher will be invoked, and suitable processing
    will be done for gadget actions.  This function returns a pointer
    to a modified intuimessage (which is a copy of the original,
    possibly with some supplementary information from GadTools).
    If there are no messages (or if the only messages are meaningful
    only to GadTools, NULL will be returned.

INPUTS
    intuiport - The Window->UserPort of a window that is using the
        gadget toolkit.

RESULT
    imsg - Pointer to modified intuimessage, or null if there are
        no applicable messages.

EXAMPLE

NOTES
    Be sure to use gt_replyimsg() and not exec.library/replymsg() on
    messages obtained with GT_GetIMsg().
    If you intend to do more with the resulting message than read
    its fields, act on it, and reply it, you may find gt_filterimsg()
    more appropriate.

BUGS

SEE ALSO
    gt_replyimsg(), gt_filterimsg()