Contents page

Index

RTLockWindow


AFReqTools/RTLockWindow

  NAME RTLockWindow()

m_windowlock = RTLockWindow(struct Window *);

DESCRIPTION Lock a window so it will no longer accept any user input. The only functions left to the user are depth arrangement and window dragging. All gadgets will be un-selectable and the window can not be resized. It will also get the standard wait pointer set. The pointer at the time of locking will be restored when the window is unlocked (this will *not* happen on Kickstart V39 or higher!).

You may nest calls to RTLockWindow() and RTUnlockWindow(). Make sure you unlock the window in the correct (opposite) order.

NOTE The wait pointer will look exactly like the standard Workbench 2.0 wait pointer. In combination with PointerX, ClockTick or LacePointer the handle will turn.

INPUTS windowlock - a pointer to a (private) window lock. You must pass this to RTUnlockWindow() to unlock the window again. Never mind if this is NULL. This means there was not enough memory and the window will not be locked. There is no sense in reporting this, just carry on and pass the NULL window lock to RTUnlockWindow().

RESULT none

BUGS none known

SEE ALSO RTUnlockWindow m_windowlock