Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
EZ_CreateItem(3)		EZWGL Functions		      EZ_CreateItem(3)

NAME
       EZ_CreateItem - create a	display	item

SYNOPSIS
       #include	<EZ.h>

       EZ_Item *EZ_CreateItem(int type,	...)

ARGUMENTS
       type Specifies a	symbolic item type. It must be one of EZ_LABEL_ITEM or
       EZ_WIDGET_ITEM.

	... Specifies configuration options, a list of symbols	each  followed
       by  one	or  more values. The last symbol must be NULL, which is	itself
       not followed by any values.

DESCRIPTION
       EZ_CreateItem creates a display item and	initializes the	item using the
       specified configuration options.	For example

	  extern EZ_CallBack  openXterm(EZ_Item	*, void	*);
	  EZ_Item *item;

	  item = EZ_CreateItem(EZ_LABEL_ITEM,	   /* type */
			       /* option,	option value(s)	*/
			       EZ_LABEL_STRING,	"xterm",
			       EZ_ORIENTATION,	 EZ_VERTICAL,
			       EZ_PIXMAP_FILE,	"xterm.xpm",
			       EZ_CALLBACK,	 openXterm, NULL,
			       0);

       creates a label item, labled by the image "xterm.xpm" on	top of
       the string 'xterm'. It also associates a	callback 'openXterm'
       procedure to the	item.

       Currently, only two types of items are supported.

CONFIGURATION SYMBOLS AND THEIR	VALUES
       The  set	 of item configuration options and their values	are listed be-
       low. For	each option value, the string before the last _	is its type.

       EZ_BORDER_WIDTH,	int_bw
	    Specifies a	border width.

       EZ_BORDER_TYPE, int_bt
	    Specifies a	border type. int_bt must  be  one  of  EZ_BORDER_NONE,
	    EZ_BORDER_FLAT,    EZ_BORDER_RIDGE,	   EZ_BORDER_GROOVE,   EZ_BOR-
	    DER_RAISED or EZ_BORDER_SUNKEN.

       EZ_PADX,	int_px
	    Specifies the horizontal padding between the item border  and  its
	    contents.

       EZ_PADY,	int_py
	    Specifies  the  vertical  padding  between the item	border and its
	    contents.

       EZ_IPADX, int_ipx
	    Specifies the amount of spaces to be inserted horizontally between
	    textual label and image label. It is used only when	the item has a
	    horizontal orientation.

       EZ_IPADY, int_ipy
	    Specifies the amount of spaces to be inserted  vertically  between
	    textual label and image label. It is used only when	the item has a
	    vertical orientation.

       EZ_ORIENTATION, int_ori
	    Specifies the orientation of an item. ori must be EZ_HORIZONTAL or
	    EZ_VERTICAL.

       EZ_LABEL_POSITION, int_lp
	    Specifies  a  location  to	anchor	a label. int_lp	must be	one of
	    EZ_CENTER, EZ_LEFT,	 EZ_RIGHT,  EZ_TOP,  EZ_BOTTOM,	  EZ_TOP_LEFT,
	    EZ_TOP_RIGHT,  EZ_BOTTOM_LEFT  or EZ_BOTTOM_RIGHT.	This attribute
	    is used only when an item has been given a size  which  is	larger
	    than its minimal size.

       EZ_LABEL_JUSTIFICATION, int_jst
	    Specifies the justfication for textual labels. int_jst must	be one
	    of EZ_CENTER, EZ_LEFT or EZ_RIGHT.

       EZ_CALLBACK, EZ_CallBack_cbk, voidptr_cdata
	    Specifies a	callback procedure and a client	data to	be  passed  to
	    the	 callback.  Use	 this option only when an item is to have only
	    one	callback.

       EZ_FOREGROUND, str_fg
	    Specifies a	forground color.

       EZ_BACKGROUND, str_bg
	    Specifies a	background color.

       EZ_PIXMAP_FILE, str_filename
	    Specifies an X bitmap file or a X pixmap file (an xpm image).

       EZ_BITMAP_DATA, array_of_char,int_width,int_height
	    Specify an X bitmap.

       EZ_PIXMAP_DATA, array_of_str
	    Specifies an XPM image data.

       EZ_X_PIXMAP, Pixmap_p,int_x,int_y,int_width,int_height
	    Specify a rectangular region of a native X pixmap to be used as an
	    image label.

       EZ_LABEL_PIXMAP,	EZ_Pixmap_p
	    Specifies an internal pixmap.

       EZ_FONT_ID, int_id
	    Specifies a	fond id.

       EZ_FONT_NAME, str_filename
	    Spcifies an	X11 font name.

       EZ_TEXT_LINE_LENGTH, int_len
	    Specifies the wrap around length for textual labels.

       EZ_IMAGE_FILE, str_name
	    Specifies  an  image  file name. Supported image formats are: ppm,
	    xpm, bmp, gif and jpeg.

       EZ_LABEL_STRING,	str_label
	    Specifies a	textual	label.

       EZ_CLIENT_PTR_DATA, ptr_data
	    Specifies a	generic	pointer	to be stored in	a item.

       EZ_CLIENT_INT_DATA, int_data
	    Specifies an integer to be stored in a item.

       EZ_DESTROY_CALLBACK, EZ_CallBack_callback, ptr_data
	    Specify a destroy callback and a client data to be passed  to  the
	    callback.  Use  this  option only when an item is to have only one
	    destroy callback.

       EZ_DND_DRAG_CURSOR, Cursor_cur
	    Specifies an X cursor for drag and drop. The specified cursor will
	    replace the	default	cursor when the	item is	being draged.

       EZ_DND_BUBBLE_HELP, str_hlp
	    Specifies  a  DND bubble help string. DND bubble will be displayed
	    when a drag	is paused over an item and the item is a drop site.

       EZ_X, int_x
	    Specifies the x coordinate of the upper-left corner	of an item  in
	    its	hosting	window.

       EZ_Y, int_y
	    Specifies  the y coordinate	of the upper-left corner of an item in
	    its	hosting	window.

       EZ_WIDTH, int_w
	    Specifies the width	of an item.

       EZ_HEIGHT, int_h
	    Specifies the height of an item.

       EZ_LOCATION, int_x, int_y
	    Specify the	coordinates of the upper-left corner of	an item	in its
	    hosting window.

       EZ_SIZE,	int_w, int_h
	    Specify the	width and height of an item.

SEE ALSO
       EZ_ConfigureItem(3), EZ_DestroyItem(3)

EZWGL							      EZ_CreateItem(3)

NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | CONFIGURATION SYMBOLS AND THEIR VALUES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=EZ_CreateItem&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help