NAME
LendMenus -- Lend window's menu action to another window. (V39)
SYNOPSIS
LendMenus( fromWindow, toWindow )
A0 A1
VOID LendMenus( struct window *, struct window * );
FUNCTION
This function is used to "lend" the menus of one window to
another. This means that menu events (for example, the user
presses the mouse menu button) will take place in another
window's menu (using that other window's menu strip and screen).
The sole intended use of this function is to unify two
windows on different screens that are attached. (See
SA_Parent, SA_FrontChild, SA_BackChild). An example would
be a program with a full-sized parent screen which has a
short control panel screen attached in the front. Pressing the
menu button even when the control panel window of the canvas
screen is active can now cause the menus of the parent screen
to appear.
INPUTS
fromWindow = pointer to the window structure whose menu actions
are to go to another window.
toWindow = pointer to the window structure whose menus are to
be displayed in place of the fromWindow's. If NULL, turns
off menu-lending from the fromWindow.
RESULT
None.
BUGS
The current behavior is such that the toWindow is temporarily
activated. This may not continue to be the case. Be prepared
to handle this!
SEE ALSO
setmenustrip(), clearmenustrip()