Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- FreshWin (c) Fresh Technologies - <b>wsetattr() window function</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
  WSETATTR()                                                 Window Function
 Purpose..: Change a window's color attribute w/o disturbing text
-------------------------------------------------------------------------------
 Syntax...: wSetAttr( [<uWin>], [<nT>], [<nL>],
                         [<nB>], [<nR>], [<uClr>] ) --> 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.

            [<nT>]   = Relative top row.
            [<nL>]   = Relative right column.
            [<nB>]   = Relative bottom row.
            [<nR>]   = Relative left column.

            [<uClr>] = The color attribute value or color string to set.

 Returns..: NIL

 Remark...: It is a window function to change the colors
            of a specified window rectangle without disturbing
            any text on the screen. If no co-ordinates are passed,
            the function defaults to the entire text area.

            The function works whether the window is open or not.

 Source...: WSETATTR.PRG
-------------------------------------------------------------------------------
 Example..:.The examples will set the color attribute of
            a portion of the window. If you use the function without
            co-ordinates but with commas, the whole window will
            be changed to the colors passed.

        wSetAttr( , 1, 3, 11, 5, "G+/N" )

        wSetAttr( , 21, 13, 22, 15, 64 )

 Note.....: The formula is ...nFore + ( nBack * 16 ).

            As with all FreshWin window functions that alter the display,
            this function hides and redisplays automatically the mouse
            cursor if it is active.

See Also: wSetColor() RevAttr() ClrTable() SetAttr()

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson