The OpenNET Project / Index page

[ новости /+++ | форум | теги | ]

Интерактивная система просмотра системных руководств (man-ов)

 ТемаНаборКатегория 
 
 [Cписок руководств | Печать]

derwin (3)
  • >> derwin (3) ( Solaris man: Библиотечные вызовы )
  • derwin (3) ( FreeBSD man: Библиотечные вызовы )
  •  

    NAME

    derwin, newwin, subwin - create a new window or subwindow
     
    

    SYNOPSIS

    cc [ flag... ] file... -I /usr/xpg4/include  -L  /usr/xpg4/lib \
     -R  /usr/xpg4/lib  -lcurses  [ library... ]
    
    c89 [ flag... ] file... -lcurses [ library... ]
    
    #include <curses.h>
    
    WINDOW *derwin(WINDOW *orig, int nlines, int ncols,
        int begin_y, int begin_x);
    

    WINDOW *newwin(int nlines, int ncols, int begin_y, int begin_x);
    

    WINDOW *subwin(WINDOW *orig, int nlines, int ncols, int begin_y,
        int begin_x);
    

     

    DESCRIPTION

    The derwin() function creates a subwindow within window orig, with the specified number of lines and columns, and upper left corner positioned at begin_x, begin_y relative to window orig. A pointer to the new window structure is returned.

    The newwin() function creates a new window with the specified number of lines and columns and upper left corner positioned at begin_x, begin_y. A pointer to the new window structure is returned. A full-screen window can be created by calling newwin(0,0,0,0).

    If the number of lines specified is zero, newwin() uses a default value of LINES minus begin_y; if the number of columns specified is zero, newwin() uses the default value of COLS minus begin_x.

    The subwin() function creates a subwindow within window orig, with the specified number of lines and columns, and upper left corner positioned at begin_x, begin_y (relative to the physical screen, not to window orig). A pointer to the new window structure is returned.

    The original window and subwindow share character storage of the overlapping area (each window maintains its own pointers, cursor location, and other items). This means that characters and attributes are identical in overlapping areas regardless of which window characters are written to.

    When using subwindows, it is often necessary to call touchwin(3XCURSES) before wrefresh(3XCURSES) to maintain proper screen contents.  

    PARAMETERS

    orig

    Is a pointer to the parent window for the newly created subwindow.

    nlines

    Is the number of lines in the subwindow.

    ncols

    Is the number of columns in the subwindow.

    begin_y

    Is the y (row) coordinate of the upper left corner of the subwindow, relative to the parent window.

    begin_x

    Is the x (column) coordinate of the upper left corner of the subwindow, relative to the parent window.

     

    RETURN VALUES

    On success, these functions return a pointer to the newly-created window. Otherwise, they return ERR.  

    ERRORS

    None.  

    ATTRIBUTES

    See attributes(5) for descriptions of the following attributes:

    ATTRIBUTE TYPEATTRIBUTE VALUE

    Interface StabilityStandard

    MT-Level

     

    SEE ALSO

    doupdate(3XCURSES), is_linetouched(3XCURSES), libcurses(3XCURSES), attributes(5), standards(5)


     

    Index

    NAME
    SYNOPSIS
    DESCRIPTION
    PARAMETERS
    RETURN VALUES
    ERRORS
    ATTRIBUTES
    SEE ALSO


    Поиск по тексту MAN-ов: 




    Партнёры:
    PostgresPro
    Inferno Solutions
    Hosting by Hoster.ru
    Хостинг:

    Закладки на сайте
    Проследить за страницей
    Created 1996-2024 by Maxim Chirkov
    Добавить, Поддержать, Вебмастеру