ModifyIDCMP

Modify the state of a window's IDCMPFlags.

Declaration

Source position: intuition.pas line 3475

Arguments

Function result

This function returns False if it was unable to create the necessary message ports.

Description

This routine modifies the state of your window's IDCMP (Intuition Direct Communication Message Port). The state is modified to reflect your desires as described by the flag bits in the value IDCMPFlags.

The four actions that might be taken are:

• if there is currently no IDCMP in the given window, and IDCMPFlags is zero, nothing happens
• if there is currently no IDCMP in the given window, and any of the IDCMPFlags is selected (set), then the IDCMP of the window is created, including allocating and initializing the message ports and allocating a signal bit for your port.
• if the IDCMP for the given window exists, and the IDCMPFlags argument is zero, this says that you want Intuition to close the ports, free the buffers and free your signal bit. You MUST be the same task that was active when this signal bit was allocated (either by ModifyIDCMP() or OpenWindow()).
• if the IDCMP for the given window is opened, and the IDCMPFlags argument is not zero, this means that you want to change the state of which events will be broadcast to you through the IDCMP

Note: You can set up the Window^.UserPort to any port of your own before you call ModifyIDCMP(). If IDCMPFlags is non-null but your UserPort is already initialized, Intuition will assume that it's a valid port with task and signal data preset and Intuition won't disturb your set-up at all, Intuition will just allocate the Intuition message port half of it. The converse is true as well: if UserPort is nil when you call here with IDCMPFlags = 0, Intuition will deallocate only the Intuition side of the port.

This allows you to use a port that you already have allocated:

• OpenWindow() with IDCMPFlags equal to 0 (open no ports)
• set the UserPort variable of your window to any valid port of your own choosing
• call ModifyIDCMP() with IDCMPFlags set to what you want
• then, to clean up later, set UserPort equal to nil before calling CloseWindow() (leave IDCMPFlags alone) But first: you must make sure that no messages sent your window are queued at the port, since they will be returned to the memory free pool.

For an example of how to close a window with a shared IDCMP, see the description for CloseWindow().

See also