## 4.23 Status Meters

A status meter is like a progress bar. It has either a vertical or a horizontal orientation. A status meter is capable of displaying five distinct quantities simultaneously.

### Widget Info

Symbolic widget type | EZ_WIDGET_STATUS_METER
Default class name | "StatusMeter"
Default instance name | "statusMeter"

### Widget Interface Routines

`void EZ_SetStatusMeterRange(EZ_Widget *widget, float f, float t);`

set the range of a status meter.

`void EZ_SetStatusMeterValue(EZ_Widget *widget, float value);`

set the value of a status meter.

`float EZ_GetStatusMeterValue(EZ_Widget *widget);`

return the status value.

`void EZ_StopStatusMeter(EZ_Widget *widget);`

stop a status meter.

`void EZ_StartStatusMeter(EZ_Widget *widget);`

resume a status meter.

`void EZ_SetStatusMeterForeground(EZ_Widget *widget, char *clr);`

set the foreground color.

`void EZ_SetStatusMeterBackground(EZ_Widget *widget, char *clr);`

set the background color.

`void EZ_SetStatusMeterRangeN(EZ_Widget *widget, int idx, float f, float t);`

set the rang of the nth status variable.

`void EZ_SetStatusMeterForegroundN(EZ_Widget *widget, int idx, char *clr);`

set the foreground color to display the nth status variable.

`void EZ_SetStatusMeterValueN(EZ_Widget *widget, int idx, float value);`

set the value of th nth status variable.

`float EZ_GetStatusMeterValueN(EZ_Widget *widget, int idx);`

return the value of the nth status variable

### Screenshot

### Resources

Config_Option | ResourceName | DefaultValue
EZ_CLASS | class | `"StatusMeter"`
EZ_NAME | name | `"statusmeter"`

EZ_X | x |
EZ_Y | y |
EZ_WIDTH | width |
EZ_HEIGHT | height |

EZ_LOCATION | location |
EZ_SIZE | size |
EZ_GEOMETRY | geometry |

EZ_WIDTH_HINT | widthHint |
EZ_HEIGHT_HINT | heightHint |
EZ_SIZE_HINT | sizeHint |

EZ_BORDER_WIDTH | borderWidth | `0`
EZ_BORDER_TYPE | borderType | `none`
EZ_FOCUS_PAD | focusPad | `0`

EZ_PADX | padx | `0`
EZ_PADY | pady | `0`
EZ_IPADX | iPadx | `0`
EZ_IPADY | iPady | `0`

EZ_CURSOR | cursor | `"XC_left_ptr"`
EZ_BUBBLE_STRING | bubbleString | `null`

EZ_DESTROY_CALLBACK | N/A | `null null`
EZ_EVENT_HANDLER | N/A | `null null`

EZ_FOREGROUND | foreground | `"black"`
EZ_BACKGROUND | background | `"gray74`
EZ_BG_IMAGE_FILE | bgImageFile | `null`
EZ_BG_PIXMAP | N/A | `none`

EZ_CLIENT_PTR_DATA | N/A | `null`
EZ_CLIENT_INT_DATA | clientIntData | `0`

EZ_DND_DRAG_CURSOR | dndDragCursor | `none`
EZ_DND_BUBBLE_STRING | dndBubbleString | `null`

EZ_SMETER_VALUE | statusMeterValue | `0.0`
EZ_SMETER_RANGE | statusMeterRange | `0.0 0.0`
EZ_SMETER_STOPED | statusMeterStoped | `false`
EZ_SMETER_BACKGROUND | statusMeterBackground | `"gray74"`
EZ_SMETER_FOREGROUND | statusMeterForeground | `"blue"`
EZ_SMETER_FOREGROUND_N | statusMeterForegroundN |
EZ_SMETER_SHOW_VALUE | statusMeterShowValue | `false`
EZ_SMETER_VALUE_N | statusMeterValueN |
EZ_SMETER_RANGE_N | statusMeterRangeN |
EZ_SMETER_STYLE | statusMeterStyle | `0`
EZ_SMETER_ORIENTATION | statusMeterOrientation | `horizontal`

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