FrameCreate()

NAME

FrameCreate() - Create a frame window.

PROTOTYPAGE

WINDOW *FrameCreate( int attrib);

PARAMETERS

item:

GEM widget of the window,

return:

window descriptor.

DESCRIPTION

FrameCreate() just creates a window descriptor whose will host framed windows. The window created is not opened at screen as for WindCreate(). Optional parameters can be set with WindSet() for general window options and FrameSet() for specific frame options.

The window created by FrameCreate() has the WS_FRAME_ROOT bit of the status window descriptor field set to 1. A structure FRAME structure is attached as data to the window with a WD_WFRA magic number.

The method used to handle frame window is very simple. A frame window is seen like a set of framed windows. A framed window is not a real GEM window but is identified by a window descriptor. The frame window, i.e. the root window holding the list of framed window, and the standard event functions of the frame window use the standard event function of the framed window. Some events are applied to the active frame, such as a button event. The active frame may be defined by FrameSet().

BUGS

• sliders of framed window are not correctly initialized,

• the vertical frame resizing widget are not supported.

SEE ALSO

FrameAttach(), FrameSet().