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

FreeBSD Manual Pages

  
 
  

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

NAME
       EZ_ConfigureItem	- configure a display item

SYNOPSIS
       #include	<EZ.h>

       void EZ_ConfigureItem(EZ_Item *item, ...)

ARGUMENTS
       item Specifies a	display	item.

	... Specify configuration options and their values.

DESCRIPTION
       EZ_ConfigureItem	 sets  or  modifies item attributes, things like label
       string, color, border. This function takes a variable length arguments,
       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.

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_CreateItem(3), EZ_DestroyItem(3)

EZWGL							   EZ_ConfigureItem(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_ConfigureItem&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help