## 10.2 Label Item

A label item displays a piece of textual string or a pixmap/image or both, in the later case, it may be orientated either horizontally or vertically.

### 10.2.1 Resources

Label item supports the following resources.

configOption | resourceName | valueType
`EZ_X` | `x` | `int`
`EZ_Y` | `y` | `int`
`EZ_LOCATION` | `location` | `int_x int_y`
`EZ_WIDTH` | `width` | `int`
`EZ_HEIGHT` | `height` | `int`
`EZ_SIZE` | `size` | `int_w int_h`
`EZ_GEOMETRY` | `geometry` | `int_x int_y int_w int_h`

configOption | resourceName | valueType
`EZ_PADX` | `padx` | `enum`
`EZ_PADY` | `pady` | `int`
`EZ_BORDER_TYPE` | `borderType` | `enum`
`EZ_BORDER_WIDTH` | `borderWidth` | `int`
`EZ_FOREGROUND` | `foreground` | `string`
`EZ_BACKGROUND` | `background` | `string`
`EZ_ORIENATTION` | `orientation` | `enum`

configOption | resourceName | valueType
`EZ_LABEL_STRING` | `labelString` | `string`
`EZ_FONT_NAME` | `fontName` | `string`
`EZ_FONT_ID` | `fontId` | `int`
`EZ_TEXT_LINE_LENGTH` | `textLineLength` | `int`
`EZ_JUSTIFICATION` | `justification` | `enum`
`EZ_LABEL_POSITION` | `labelPosition` | `enum`
`EZ_PIXMAP_FILE` | `pixmapFile` | `string`
`EZ_IMAGE_FILE` | `imageFile` | `string`
`EZ_BITMAP_DATA` | `N/A` | `string`
`EZ_PIXMAP_DATA` | `N/A` | `char **`
`EZ_X_PIXMAP` | `N/A` | `Pixmap`
`EZ_LABEL_PIXMAP` | `N/A` | `EZ_Bitmap *`

configOption | resourceName | valueType
`EZ_DND_BUBBLE_STRING` | `dndBubbleString` | `string`
`EZ_DND_DRAG_CURSOR` | `dndDragCursor` | `string`

configOption | resourceName | valueType
`EZ_CALLBACK` | `N/A` | `void* void*`
`EZ_DESTROY_CALLBACK` | `N/A` | `EZ_CallBack void*`

### 10.2.2 Interface Functions

`void EZ_GetLabelItemStringInfo (EZ_Item *item, char **str, int *len);`

return the label string of a label item.

`int EZ_GetLabelItemTextGeometry(EZ_Item *item, int *x, int *y, int *w, int *h);`

return position and text extent of the label string in a label item.

`EZ_Bitmap *EZ_GetLabelItemPixmap (EZ_Item *item);`

return the label pixmap of a label item.

`void EZ_LabelItemSetProperty(EZ_Item *item, EZ_TextProperty *prop);`

set or modify the visual info of a label item via text property.

HTML Documentation Maintainance:`Arturo Espinosa <arturo@nuclecu.unam.mx>`