[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


    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()