a1200   NEWS   APPS   DOCS   ABOUT
a1200
----
a1200
----
Autodocs
 Libraries:
 gadtools.library
  CreateContext
  CreateGadgetA
  CreateMenusA
  DrawBevelBoxA
  FreeGadgets
  FreeMenus
  FreeVisualInfo
  GT_BeginRefresh
  GT_EndRefresh
  GT_FilterIMsg
  GT_GetGadgetAttrsA
  GT_GetIMsg
  GT_PostFilterIMsg
  GT_RefreshWindow
  GT_ReplyIMsg
  GT_SetGadgetAttrsA
  GetVisualInfoA
  LayoutMenuItemsA
  LayoutMenusA
Include
GuruMeditation
Docs » Autodocs » gadtools.library » GT_GetIMsg

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.

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.
Starting with V39, this function actually returns a pointer to an
ExtIntuiMessage structure, but the prototype was not changed for
source code compatibility with older software.

SEE ALSO

GT_ReplyIMsg(), GT_FilterIMsg()

Comments

Name:
E-mail: Use this if you want a message if you get a response, will not be shown.
Comment:
Select correct short for:

Sanity

TBL
SNT
RZR
RBS

Comments:

$VER: d0.se 1.14 Copyright © 2011-2021 Tobias Geijersson support at d0 dot se