diff options
Diffstat (limited to 'ncurses-5.2/doc/html/man/curs_outopts.3x.html')
-rw-r--r-- | ncurses-5.2/doc/html/man/curs_outopts.3x.html | 188 |
1 files changed, 188 insertions, 0 deletions
diff --git a/ncurses-5.2/doc/html/man/curs_outopts.3x.html b/ncurses-5.2/doc/html/man/curs_outopts.3x.html new file mode 100644 index 0000000..a7a0a45 --- /dev/null +++ b/ncurses-5.2/doc/html/man/curs_outopts.3x.html @@ -0,0 +1,188 @@ +<HTML> +<BODY> +<PRE> +<!-- Manpage converted by man2html 3.0.1 --> + +</PRE> +<H2>NAME</H2><PRE> + <B>clearok</B>, <B>idlok</B>, <B>idcok</B> <B>immedok</B>, <B>leaveok</B>, <B>setscrreg</B>, + <B>wsetscrreg</B>, <B>scrollok</B>, <B>nl</B>, <B>nonl</B> - <B>curses</B> output options + + +</PRE> +<H2>SYNOPSIS</H2><PRE> + <B>#include</B> <B><curses.h></B> + + <B>int</B> <B>clearok(WINDOW</B> <B>*win,</B> <B>bool</B> <B>bf);</B> + <B>int</B> <B>idlok(WINDOW</B> <B>*win,</B> <B>bool</B> <B>bf);</B> + <B>void</B> <B>idcok(WINDOW</B> <B>*win,</B> <B>bool</B> <B>bf);</B> + <B>void</B> <B>immedok(WINDOW</B> <B>*win,</B> <B>bool</B> <B>bf);</B> + <B>int</B> <B>leaveok(WINDOW</B> <B>*win,</B> <B>bool</B> <B>bf);</B> + <B>int</B> <B>setscrreg(int</B> <B>top,</B> <B>int</B> <B>bot);</B> + <B>int</B> <B>wsetscrreg(WINDOW</B> <B>*win,</B> <B>int</B> <B>top,</B> <B>int</B> <B>bot);</B> + <B>int</B> <B>scrollok(WINDOW</B> <B>*win,</B> <B>bool</B> <B>bf);</B> + <B>int</B> <B>nl(void);</B> + <B>int</B> <B>nonl(void);</B> + + +</PRE> +<H2>DESCRIPTION</H2><PRE> + These routines set options that change the style of output + within <B>curses</B>. All options are initially <B>FALSE</B>, unless + otherwise stated. It is not necessary to turn these + options off before calling <B>endwin</B>. + + If <B>clearok</B> is called with <B>TRUE</B> as argument, the next call + to <B>wrefresh</B> with this window will clear the screen com- + pletely and redraw the entire screen from scratch. This + is useful when the contents of the screen are uncertain, + or in some cases for a more pleasing visual effect. If + the <I>win</I> argument to <B>clearok</B> is the global variable <B>curscr</B>, + the next call to <B>wrefresh</B> with any window causes the + screen to be cleared and repainted from scratch. + + If <B>idlok</B> is called with <B>TRUE</B> as second argument, <B>curses</B> + considers using the hardware insert/delete line feature of + terminals so equipped. Calling <B>idlok</B> with <B>FALSE</B> as second + argument disables use of line insertion and deletion. + This option should be enabled only if the application + needs insert/delete line, for example, for a screen edi- + tor. It is disabled by default because insert/delete line + tends to be visually annoying when used in applications + where it isn't really needed. If insert/delete line can- + not be used, <B>curses</B> redraws the changed portions of all + lines. + + If <B>idcok</B> is called with <B>FALSE</B> as second argument, <B>curses</B> + no longer considers using the hardware insert/delete char- + acter feature of terminals so equipped. Use of character + insert/delete is enabled by default. Calling <B>idcok</B> with + <B>TRUE</B> as second argument re-enables use of character inser- + tion and deletion. + + If <B>immedok</B> is called with <B>TRUE</B> <B>as</B> <B>argument</B>, any change in + the window image, such as the ones caused by <B>waddch,</B> + <B>wclrtobot,</B> <B>wscrl</B>, <I>etc</I>., automatically cause a call to <B>wre-</B> + <B>fresh</B>. However, it may degrade performance considerably, + due to repeated calls to <B>wrefresh</B>. It is disabled by + default. + + Normally, the hardware cursor is left at the location of + the window cursor being refreshed. The <B>leaveok</B> option + allows the cursor to be left wherever the update happens + to leave it. It is useful for applications where the cur- + sor is not used, since it reduces the need for cursor + motions. If possible, the cursor is made invisible when + this option is enabled. + + The <B>setscrreg</B> and <B>wsetscrreg</B> routines allow the applica- + tion programmer to set a software scrolling region in a + window. <I>top</I> and <I>bot</I> are the line numbers of the top and + bottom margin of the scrolling region. (Line 0 is the top + line of the window.) If this option and <B>scrollok</B> are + enabled, an attempt to move off the bottom margin line + causes all lines in the scrolling region to scroll one + line in the direction of the first line. Only the text of + the window is scrolled. (Note that this has nothing to do + with the use of a physical scrolling region capability in + the terminal, like that in the VT100. If <B>idlok</B> is enabled + and the terminal has either a scrolling region or + insert/delete line capability, they will probably be used + by the output routines.) + + The <B>scrollok</B> option controls what happens when the cursor + of a window is moved off the edge of the window or + scrolling region, either as a result of a newline action + on the bottom line, or typing the last character of the + last line. If disabled, (<I>bf</I> is <B>FALSE</B>), the cursor is left + on the bottom line. If enabled, (<I>bf</I> is <B>TRUE</B>), the window + is scrolled up one line (Note that in order to get the + physical scrolling effect on the terminal, it is also nec- + essary to call <B>idlok</B>). + + The <B>nl</B> and <B>nonl</B> routines control whether the underlying + display device translates the return key into newline on + input, and whether it translates newline into return and + line-feed on output (in either case, the call <B>addch('\n')</B> + does the equivalent of return and line feed on the virtual + screen). Initially, these translations do occur. If you + disable them using <B>nonl</B>, <B>curses</B> will be able to make bet- + ter use of the line-feed capability, resulting in faster + cursor motion. Also, <B>curses</B> will then be able to detect + the return key. + + +</PRE> +<H2>RETURN VALUE</H2><PRE> + The functions <B>setscrreg</B> and <B>wsetscrreg</B> return <B>OK</B> upon suc- + cess and <B>ERR</B> upon failure. All other routines that return + an integer always return <B>OK</B>. + + +</PRE> +<H2>PORTABILITY</H2><PRE> + These functions are described in the XSI Curses standard, + Issue 4. + + The XSI Curses standard is ambiguous on the question of + whether <B>raw</B>() should disable the CRLF translations con- + trolled by <B>nl</B>() and <B>nonl</B>(). BSD curses did turn off these + translations; AT&T curses (at least as late as SVr1) did + not. We choose to do so, on the theory that a programmer + requesting raw input wants a clean (ideally 8-bit clean) + connection that the operating system does not mess with. + + Some historic curses implementations had, as an undocu- + mented feature, the ability to do the equivalent of + <B>clearok(...,</B> <B>1)</B> by saying <B>touchwin(stdscr)</B> or <B>clear(std-</B> + <B>scr)</B>. This will not work under ncurses. + + Earlier System V curses implementations specified that + with <B>scrollok</B> enabled, any window modification triggering + a scroll also forced a physical refresh. XSI Curses does + not require this, and <B>ncurses</B> avoids doing it in order to + perform better vertical-motion optimization at <B>wrefresh</B> + time. + + The XSI Curses standard does not mention that the cursor + should be made invisible as a side-effect of <B>leaveok</B>. + SVr4 curses documentation does this, but the code does + not. Use <B>curs_set</B> to make the cursor invisible. + + +</PRE> +<H2>NOTES</H2><PRE> + Note that <B>clearok</B>, <B>leaveok</B>, <B>scrollok</B>, <B>idcok</B>, <B>nl</B>, <B>nonl</B> and + <B>setscrreg</B> may be macros. + + The <B>immedok</B> routine is useful for windows that are used as + terminal emulators. + + +</PRE> +<H2>SEE ALSO</H2><PRE> + <B><A HREF="ncurses.3x.html">curses(3x)</A></B>, <B><A HREF="curs_addch.3x.html">curs_addch(3x)</A></B>, <B><A HREF="curs_clear.3x.html">curs_clear(3x)</A></B>, + <B><A HREF="curs_initscr.3x.html">curs_initscr(3x)</A></B>, <B><A HREF="curs_scroll.3x.html">curs_scroll(3x)</A></B>, <B><A HREF="curs_refresh.3x.html">curs_refresh(3x)</A></B> + + + + + + + + + + + + + + + +</PRE> +<HR> +<ADDRESS> +Man(1) output converted with +<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a> +</ADDRESS> +</BODY> +</HTML> |