FrameSet()

NAME

FrameSet() - Frame settings.

PROTOTYPAGE

void FrameSet( WINDOW *win, int mode, ...);

PARAMETERS

win:

window descriptor (of a root frame window of a framed window),

mode:

parameter to set,

...:

new values depending on mode.

DESCRIPTION

This function sets the special features of frame windows. The table below lists and comments the different modes of the function.

FrameSet() mode

Mode	Type window	Parameters	Remarks
FRAME_BORDER	root window	set the border size of frames	pixel unit
		FrameSet(..,border);
FRAME_COLOR	root window	set the border frame color	VDI color index
		FrameSet(..,color);
FRAME_KEYBD	root window	define the frame catching an
		keyboard event.
		The frame pointed by mouse:
		FrameSet(.., MOUSE_WINDOW);
		The active frame:
		FrameSet(.., FRONT_WINDOW);
FRAME_ACTIVE	root window	Makes a frame active :	frame is a WINDOW
		FrameSet(..,frame);	pointer.
FRAME_TOPP-	root window	A topped frame becomes active	A TRUE or FALSE
ED_ACTIV		FrameSet(..,TRUE);	value.
FRAME_SIZE	framed window	set the framed window size	w and h units depends
		FrameSet(..,w,h);	on FRAME_FLAGS values.
FRAME_FLAGS	framed window	set a flag:	flag values are
		FrameSet(..,flag,TRUE)	listed in the next
		unset a flag:	table.
		FrameSet(..,flag,TRUE)

Frame flags (related to FRAME_FLAGS mode)

FLAGS	Descriptions
FRAME_HSCALE	The framed window height is defined
	proportionaly to the window root
	work area height (0..100).
FRAME_WSCALE	The framed window width is defined
	proportionaly to the window root
	work area width (0..100).
FRAME_HFIX	The framed window height is an absolute
	value (in pixel).
FRAME_WFIX	The framed window width is an absolute
	value (in pixel).
FRAME_NOBORDER	The framed window has no borders.
FRAME_SELECT	The framed windows is activable.