Unit 'Intuition' Package
[Overview][Constants][Types][Procedures and functions][Variables][Index] [#aros]

SendIntuiMessage

Send an IntuiMessage to an Intuition Window

Declaration

Source position: intuition.pas line 3328

procedure SendIntuiMessage(

  Window: PWindow;

  IMsg: PIntuiMessage

);

Arguments

Window

  

The window to which the IntuiMessage shall be sent

IMsg

  

The IntuiMessage to send, which must have been allocated with AllocIntuiMessage().

Description

The caller of this function should first check himself whether Window^.UserPort is nil. And in this case do not call this function at all.

If inside this function the Window^.UserPort turns out to be nil, then what happens is, that the IntuiMessage is immediately ReplyMessageed in here, just like if this was done by the app whose window was supposed to get the IntuiMessage.

The protection with Forbid() is necessary, because of the way shared window userports are handled, when one of this windows is closed, where there is also just a protection with Forbid() when stripping those IntuiMessages from the port which belong to the window which is going to be closed.

This function does not check whether the window to which the IntuiMessage is supposed to be sent, really wants to get the IDCMP in question, that is, whether the corresponding flag in Window^.IDCMPFLags is set.


Documentation generated on: 2021-07-30