NoFiles: Difference between revisions

From BR Wiki
Jump to navigation Jump to search
(Created page with "The '''NoFiles''' parameter for Library statements was introduced in version 4.20 of Business Rules!. LIBRARY [RELEASE] [,NOFILES] [file-ref] : FNxxx, ... If GU...")
 
No edit summary
Line 3: Line 3:
  LIBRARY [RELEASE] [,NOFILES] [file-ref] : FNxxx, ...
  LIBRARY [RELEASE] [,NOFILES] [file-ref] : FNxxx, ...


If GUI mode is ON then [[Parent=None]] may be stated when [[Open Display|Opening]] a [[window]]. This will create an independent window using the specified channel. This new window inherits any unspecified attributes from the program's main console.
To handle situations where the program and the library function it calls use the same file handles for open files, windows etc.  


When a GUI mode switch is made, all windows are closed and the main console is reopened. Note that Parent=None windows are NOT main consoles. Attempts to output to a previously existing non-console window after a mode switch, without opening it fresh, will generate error [[0704]] (file not open).
When this optional parameter is used, it allows your program and the library function to use the same file handles without causing an error. You can call and use the function without passing the files back and forth.  
 
Any attempt to open a window with Parent=None while GUI mode is OFF produces error [[0877]].
 
OPEN ... "… ROW= ,COL= " specifies the preferred position of the new independent window relative to window zero (the main console). Use negative values to position the window to the left of or above the main console. BR will attempt to honor the request keeping the new window entirely viewable up to the maximum size of the screen. 'NAME=window-name' indicates that BR is to save the position of the window at the time it is closed and restore it when it is reopened, even across sessions. Replacement or overlaying windows can use the same window names to position themselves wherever and at whatever character size the user has changed it to. So once a window has been opened with a particular name subsequent opens ignore ROW= and COL= and instead use the stored values.


<noinclude>
<noinclude>
[[Category:All Parameters]]
[[Category:All Parameters]]
[[Category:Needs Help]]
[[Category:User Defined Function Statements]]
[[Category:User Defined Function Statements]]
</noinclude>
</noinclude>

Revision as of 18:29, 23 July 2013

The NoFiles parameter for Library statements was introduced in version 4.20 of Business Rules!.

LIBRARY [RELEASE] [,NOFILES] [file-ref] : FNxxx, ...

To handle situations where the program and the library function it calls use the same file handles for open files, windows etc.

When this optional parameter is used, it allows your program and the library function to use the same file handles without causing an error. You can call and use the function without passing the files back and forth.