W_CREATE(3)			WLIB-CALLS			W_CREATE(3)

NAME

	w_create()

SYPNOSIS

	#include <Wlib.h>

	short w_create(short width, short height, short flags);

DESCRIPTION

	 w_create() creates a new window of the given size if possible (say
	the screen is big enough), but doesn't yet open it. `flags' may be
	any combination of:

	W_MOVE:		will allow the window to be moveable

	W_TOP:		will keep this window on top of all other windows

	W_TITLE:	will give the window a title bar

	W_NOBORDER:	won't give the window a border at all

	EV_KEYS:	client wants key events

	EV_MOUSE:	client wants mouse events

	 note that W_NOBORDER will have the side effect of not being able to
	give the window a title bar and that the window will not be moveable
	by the user, as will any which misses W_MOVE. W_NOBORDER should only
	be used by screen savers or windows which feel a specific need to be
	placed somewhere exactly.

	 windows created with W_TOP will always stay on top of the screen
	regardless if you manually top another one above it. this of course
	only works if all other windows are not W_TOP, so watch out you don't
	create too many windows with this flag. Amoung those with W_TOP no
	special order will be perserved.

	 W_TITLE will only reserve space for a title bar, but not print any
	default text. use w_settitle() for this purpose.

	 the EV_* flags are there to preselect events the client will take
	care of. this prevents the server from sending events a client will
	not wait for and thus jam the socket or things like these.

RETURNS

	- a positive handle if everything went ok

	- a negative error code otherwise

SEE ALSO

	wopen(3), wclose(3), wdelete(3) and wqueryevent(3)

LAST CHANGED

	12/94 by TeSche, itschere@techfak.uni-bielefeld.de
