XProgress.c File Reference

#include "GUIslice.h"
#include "GUIslice_drv.h"
#include "elem/XProgress.h"
#include <stdio.h>

Include dependency graph for XProgress.c:

Functions
gslc_tsElemRef *	gslc_ElemXProgressCreate (gslc_tsGui *pGui, int16_t nElemId, int16_t nPage, gslc_tsXProgress *pXData, gslc_tsRect rElem, int16_t nMin, int16_t nMax, int16_t nVal, gslc_tsColor colGauge, bool bVert)
	Create a Progress Bar Element. More...
void	gslc_ElemXProgressSetVal (gslc_tsGui *pGui, gslc_tsElemRef *pElemRef, int16_t nVal)
	Update a Gauge element's current value. More...
void	gslc_ElemXProgressSetFlip (gslc_tsGui *pGui, gslc_tsElemRef *pElemRef, bool bFlip)
	Set a Gauge element's fill direction. More...
void	gslc_ElemXProgressSetGaugeCol (gslc_tsGui *pGui, gslc_tsElemRef *pElemRef, gslc_tsColor colGauge)
	Set the gauge color. More...
bool	gslc_ElemXProgressDraw (void *pvGui, void *pvElemRef, gslc_teRedrawType eRedraw)
	Draw a gauge element on the screen. More...
bool	gslc_ElemXProgressDrawHelp (gslc_tsGui *pGui, gslc_tsElemRef *pElemRef, gslc_teRedrawType eRedraw)
	Helper function to draw a gauge with style: progress bar. More...

Variables
const char GSLC_PMEM	ERRSTR_NULL []
const char GSLC_PMEM	ERRSTR_PXD_NULL []

Function Documentation

gslc_tsElemRef* gslc_ElemXProgressCreate	(	gslc_tsGui *	pGui,
		int16_t	nElemId,
		int16_t	nPage,
		gslc_tsXProgress *	pXData,
		gslc_tsRect	rElem,
		int16_t	nMin,
		int16_t	nMax,
		int16_t	nVal,
		gslc_tsColor	colGauge,
		bool	bVert
	)

Create a Progress Bar Element.

• Draws a gauge element that represents a proportion (nVal) between nMin and nMax.

Parameters

[in]	pGui	Pointer to GUI
[in]	nElemId	Element ID to assign (0..16383 or GSLC_ID_AUTO to autogen)
[in]	nPage	Page ID to attach element to
[in]	pXData	Ptr to extended element data structure
[in]	rElem	Rectangle coordinates defining gauge size
[in]	nMin	Minimum value of gauge for nVal comparison
[in]	nMax	Maximum value of gauge for nVal comparison
[in]	nVal	Starting value of gauge
[in]	colGauge	Color for the gauge indicator
[in]	bVert	Flag to indicate vertical vs horizontal action (true = vertical, false = horizontal)

Returns

Pointer to Element reference or NULL if failure

bool gslc_ElemXProgressDraw	(	void *	pvGui,
		void *	pvElemRef,
		gslc_teRedrawType	eRedraw
	)

Draw a gauge element on the screen.

• Called from gslc_ElemDraw()

Parameters

[in]	pvGui	Void ptr to GUI (typecast to gslc_tsGui*)
[in]	pvElemRef	Void ptr to Element reference (typecast to gslc_tsElemRef*)
[in]	eRedraw	Redraw mode

Returns

true if success, false otherwise

bool gslc_ElemXProgressDrawHelp	(	gslc_tsGui *	pGui,
		gslc_tsElemRef *	pElemRef,
		gslc_teRedrawType	eRedraw
	)

Helper function to draw a gauge with style: progress bar.

• Called from gslc_ElemXProgressDraw()

Parameters

[in]	pGui	Ptr to GUI
[in]	pElemRef	Ptr to Element reference
[in]	eRedraw	Redraw status

Returns

true if success, false otherwise

void gslc_ElemXProgressSetFlip	(	gslc_tsGui *	pGui,
		gslc_tsElemRef *	pElemRef,
		bool	bFlip
	)

Set a Gauge element's fill direction.

• Setting bFlip reverses the default fill direction
• Default fill direction for horizontal gauges: left-to-right
• Default fill direction for vertical gauges: bottom-to-top

Parameters

[in]	pGui	Pointer to GUI
[in]	pElemRef	Pointer to Element reference
[in]	bFlip	If set, reverse direction of fill from default

Returns

none

void gslc_ElemXProgressSetGaugeCol	(	gslc_tsGui *	pGui,
		gslc_tsElemRef *	pElemRef,
		gslc_tsColor	colGauge
	)

Set the gauge color.

Parameters

[in]	pGui	Pointer to GUI
[in]	pElemRef	Pointer to Element reference
[in]	colGauge	Color for the gauge's fill

Returns

none

void gslc_ElemXProgressSetVal	(	gslc_tsGui *	pGui,
		gslc_tsElemRef *	pElemRef,
		int16_t	nVal
	)

Update a Gauge element's current value.

• Note that min & max values are assigned in create()

Parameters

[in]	pGui	Pointer to GUI
[in]	pElemRef	Pointer to Element reference
[in]	nVal	New value to show in gauge

Returns

none

Variable Documentation

const char GSLC_PMEM ERRSTR_NULL[]

const char GSLC_PMEM ERRSTR_PXD_NULL[]