Click above to get retro games delivered to your door ever month!

  WATTACH()                                                  Window Function
 Purpose..: Attach an item to a window
-------------------------------------------------------------------------------
 Syntax...: wAttach( [<uWin>], <nPos>, <uItem> ) --> NIL

 Arguments: [<uWin>] = the string identifier of the window
                       OR the reference to the window structure
                       returned as an array by wNew() or wArray().
                       If not passed, the function will operate on
                       the window in focus.

            <nPos>   = place to attach the item. There is
                       no default.

            Attachment Manifest Constants as found in FW_MAIN.CH
            --------------------------------------------------
            Value   FW_MAIN.CH   Description
            --------------------------------------------------
            1       WA_GETLIST   get object class.
            2       WA_TBROWSE   browse object class.
            3       WA_MENU      menu structure.
            --------------------------------------------------

            <uItem>   = item to attach. Thus far, this includes
                        get objects, tbrowse objects and menus.

 Returns..: NIL

 Remark...: READ MOUSE IN WINDOW attaches automatically the
            current GETs to the window on top. MENU TO <nCho> IN WINDOW
            attaches the active menu to a window. TBrowse
            objects must be attached manually with this function
            after creation. Once a structure is attached to a window,
            the structure works in concert with window Sizing, Moving,
            Closing and Zooming.

            The function works whether the window is open or not.

 Source...: WATTACH.PRG
-------------------------------------------------------------------------------
 Example..: . The example will attach a browse object to the window.
              WA_BROWSE is a manifest constant in FW_MAIN.CH.
              It stands for Window_Attach_browse_object.

            oBrowse := TBrowseNew( wTRow( "MyWin" ),;
                                   wLCol( "MyWin" ),;
                                   wBRow( "MyWin" ),;
                                   wRCol( "MyWin" ) )
            wAttach( "MyWin", WA_TBROWSE, oBrowse )
            wOpen  ( "MyWin" )

            //-- Add code here to manipulate your browse object.
            ...