FrameAttach()

NAME

FrameAttach() - attach a framed window in a window.

PROTOTYPAGE

void FrameAttach( WINDOW *win, WINDOW *frame, int line, int col, int w, int h, int flags);

PARAMETERS

win:

window descriptor of the root window,

frame:

window descriptor of the window to attach,

line, col:

cell which will contain the frame,

w, h:

size of the frame,

flags:

bit field of special frame features (see FramSet()).

DESCRIPTION

This function attaches a window in a root window. The attached window becomes a framed window. The framed window is created like a standard window. It can be a formular or any custom user window. The window descriptor of the framed window is removed from the list of window and the WS_FRAME bit of the window descriptor status field is set to 1.

Frames inside a window are organized by line of cells. Each line can contain variable cells. The line and col parameters defines the order of the frame in the window. The real coordinates of a frame inside the work area of the root window depend on the frame sizes. And these sizes can be eventually changed by the user. The w and h parameters define the initial size of the frame.

The flags parameter defines special feature of the frame. See FrameSet() for a complet description of this parameter.

The frame uses the GEM widget of the window. Possible attributs for a frame are INFO, SIZER, HSLIDE, VSLIDE, UPARROW, DNARROW, LFARROW and RTARROW. Other widgets are ignored.

SEE ALSO

FrameCreate(), FrameSet(), FrameRemove().