Output

Defines
#define	pvSetColumnWith   pvSetColumnWidth
Functions
int	pvSetCaption (PARAM *p, const char *text)
int	pvPlaySound (PARAM *p, const char *filename)
int	pvBeep (PARAM *p)
int	pvStatusMessage (PARAM *p, int r, int g, int b, const char *format,...)
int	pvToolTip (PARAM *p, int id, const char *text)
int	pvSetText (PARAM *p, int id, const char *text)
int	pvPrintf (PARAM *p, int id, const char *format,...)
int	pvSetValue (PARAM *p, int id, int value)
int	pvClear (PARAM *p, int id)
int	pvChangeItem (PARAM *p, int id, int index, const char *bmp_file, const char *text, int download_icon=1)
int	pvInsertItem (PARAM *p, int id, int index, const char *bmp_file, const char *text, int download_icon=1)
int	pvRemoveItem (PARAM *p, int id, int index)
int	pvRemoveItemByName (PARAM *p, int id, const char *name)
int	pvAddColumn (PARAM *p, int id, const char *text, int size)
int	pvRemoveAllColumns (PARAM *p, int id)
int	pvSetTableText (PARAM *p, int id, int x, int y, const char *text)
int	pvSetTableButton (PARAM *p, int id, int x, int y, const char *text)
int	pvSetTableCheckBox (PARAM *p, int id, int x, int y, int state, const char *text)
int	pvSetTableComboBox (PARAM *p, int id, int x, int y, int editable, const char *textlist)
int	pvSetTableLabel (PARAM *p, int id, int x, int y, const char *text)
int	pvTablePrintf (PARAM *p, int id, int x, int y, const char *format,...)
int	pvSetTableTextAlignment (PARAM *p, int id, int x, int y, int alignment)
int	pvMysqldump (PARAM *p, int id, const char *command)
int	pvCSVdump (PARAM *p, int id, const char *filename, char delimitor='\t')
int	pvCSVcreate (PARAM *p, const char *command, const char *filename)
int	pvCSV (PARAM *p, int id, const char *command, char delimitor='\t')
int	pvSetListViewText (PARAM *p, int id, const char *path, int column, const char *text)
int	pvListViewPrintf (PARAM *p, int id, const char *path, int column, const char *format,...)
int	pvListViewSetSelected (PARAM *p, int id, const char *path, int column, int selected)
int	pvListBoxSetSelected (PARAM *p, int id, int index, int selected)
int	pvSetColumnWidth (PARAM *p, int id, int column, int width)
int	pvSetRowHeight (PARAM *p, int id, int row, int height)
int	pvSetWordWrap (PARAM *p, int id, int wrap)
int	pvSetPixmap (PARAM *p, int id, const char *bmp_file, int download_icon=1)
int	pvSetTablePixmap (PARAM *p, int id, int x, int y, const char *bmp_file, int download_icon=1)
int	pvSetSource (PARAM *p, int id, const char *html_file)
int	pvSetImage (PARAM *p, int id, const char *filename)
int	pvSetBackgroundColor (PARAM *p, int id, int r, int g, int b)
int	pvSetPaletteBackgroundColor (PARAM *p, int id, int r, int g, int b)
int	pvSetPaletteForegroundColor (PARAM *p, int id, int r, int g, int b)
int	pvSetFontColor (PARAM *p, int id, int r, int g, int b)
int	pvSetFont (PARAM *p, int id, const char *family, int pointsize, int bold, int italic, int underline, int strikeout)
int	pvDisplayNum (PARAM *p, int id, int num)
int	pvDisplayFloat (PARAM *p, int id, float val)
int	pvDisplayStr (PARAM *p, int id, const char *str)
int	pvAddTab (PARAM *p, int id, int id_child, const char *str)
int	pvSetListViewPixmap (PARAM *p, int id, const char *path, const char *bmp_file, int column, int download_icon=1)
int	pvRemoveListViewItem (PARAM *p, int id, const char *path)
int	pvRemoveIconViewItem (PARAM *p, int id, const char *text)
int	pvSetIconViewItem (PARAM *p, int id, const char *bmp_file, const char *text, int download_icon=1)
int	pvSetDateOrder (PARAM *p, int id, int order)
int	pvSetDate (PARAM *p, int id, int year, int month, int day)
int	pvSetMinDate (PARAM *p, int id, int year, int month, int day)
int	pvSetMaxDate (PARAM *p, int id, int year, int month, int day)
int	pvSetTime (PARAM *p, int id, int hour, int minute, int second=0, int msec=0)
int	pvSetMinTime (PARAM *p, int id, int hour, int minute, int second=0, int msec=0)
int	pvSetMaxTime (PARAM *p, int id, int hour, int minute, int second=0, int msec=0)
int	pvEnsureCellVisible (PARAM *p, int id, int row, int col=1)
int	pvMoveCursor (PARAM *p, int id, int cursor)
int	pvScrollToAnchor (PARAM *p, int id, const char *anchor)
int	pvSetZoomFactor (PARAM *p, int id, float factor)
int	pvPrintHtmlOnPrinter (PARAM *p, int id)

---

Detailed Description

These are the output routines

---

Define Documentation

#define pvSetColumnWith   pvSetColumnWidth

---

Function Documentation

int pvAddColumn	(	PARAM *	p,
		int	id,
		const char *	text,
		int	size
	)

Add a Column in a QListView.
Allowed widgets: QListView

int pvAddTab	(	PARAM *	p,
		int	id,
		int	id_child,
		const char *	str
	)

Add a Tab to an QTabDialog
id       := id of TabWidget
id_child := id of the QWidget for this tab
str      := text on the tab

int pvBeep

(

PARAM *

p

)

Output a beep.

int pvChangeItem	(	PARAM *	p,
		int	id,
		int	index,
		const char *	bmp_file,
		const char *	text,
		int	download_icon = 1
	)

Set the content of a widget.
if bmp_file == NULL no pixmap is drawn
else bmp_file = name of PNG file or an 8bpp bitmap file
Allowed widgets: QListBox

int pvClear	(	PARAM *	p,
		int	id
	)

Clear the content of a widget.
Allowed widgets: QListBox, QComboBox, QMultiLineEdit, QListView, QIconView

int pvCSV	(	PARAM *	p,
		int	id,
		const char *	command,
		char	delimitor = '\t'
	)

dump CSV file to table=id by calling "command".

int pvCSVcreate	(	PARAM *	p,
		const char *	command,
		const char *	filename
	)

create CSV file by calling "command > filename".

int pvCSVdump	(	PARAM *	p,
		int	id,
		const char *	filename,
		char	delimitor = '\t'
	)

dump CSV file and populate table.

Allowed widgets: QTable

int pvDisplayFloat	(	PARAM *	p,
		int	id,
		float	val
	)

Display float on a QLCDNumber

int pvDisplayNum	(	PARAM *	p,
		int	id,
		int	num
	)

Display num on a QLCDNumber

int pvDisplayStr	(	PARAM *	p,
		int	id,
		const char *	str
	)

Display string on a QLCDNumber

int pvEnsureCellVisible	(	PARAM *	p,
		int	id,
		int	row,
		int	col = 1
	)

Ensure that the table cell is visible, scroll if necessary
allowed widgets: QTable

int pvInsertItem	(	PARAM *	p,
		int	id,
		int	index,
		const char *	bmp_file,
		const char *	text,
		int	download_icon = 1
	)

Insert an item.
if bmp_file == NULL no pixmap is drawn
else bmp_file = name of PNG file or an 8bpp bitmap file
if index == -1 append text at the end of the list
Allowed widgets: QListBox, QComboBox

int pvListBoxSetSelected	(	PARAM *	p,
		int	id,
		int	index,
		int	selected
	)

selected = 0 | 1 | 2
if selected == 0 item is unselected
if selected == 1 item is selected

int pvListViewPrintf	(	PARAM *	p,
		int	id,
		const char *	path,
		int	column,
		const char *	format,
			...
	)

Set the text of a ListViewItem.
Works as printf(format,...);
example:
path = "/dir/subdir/subsubdir"
path := similar to a unix directory path

Example for colored cells:
pvListViewPrintf(p,myListView,"/path/to",0,"color(255,0,0)this is the colored text");
prepend: color(r,g,b)

Allowed widgets: QListView

int pvListViewSetSelected	(	PARAM *	p,
		int	id,
		const char *	path,
		int	column,
		int	selected
	)

selected = 0 | 1 | 2
if selected == 0 item is unselected
if selected == 1 item is selected
if selected == 2 item is selected and all other tree branches are closed

int pvMoveCursor	(	PARAM *	p,
		int	id,
		int	cursor
	)

Move the cursor
allowed widgets: QTextBrowser, QMultiLineEdit
cursor := TextCursor

int pvMysqldump	(	PARAM *	p,
		int	id,
		const char *	command
	)

Run mysqldump and populate table.
See: mysqldump --help
Runs: mysqldump -X command

Allowed widgets: QTable

int pvPlaySound	(	PARAM *	p,
		const char *	filename
	)

Play Sound. filename should point to a *.wav audio file. First pvDownloadFile(PARAM *p, const char *filename);

int pvPrintf	(	PARAM *	p,
		int	id,
		const char *	format,
			...
	)

Set the text of a widget.
The functions works like printf()
Allowed widgets: QLabel, QPushButton, QLineEdit, QMultiLineEdit, QComboBox, QRadioButton, QCheckBox, QTextBrowser, QGroupBox

int pvPrintHtmlOnPrinter	(	PARAM *	p,
		int	id
	)

Print the HTML page on a printer
allowed widgets: QTextBrowser

int pvRemoveAllColumns	(	PARAM *	p,
		int	id
	)

Remove all Columns in a QListView.
Allowed widgets: QListView

int pvRemoveIconViewItem	(	PARAM *	p,
		int	id,
		const char *	text
	)

Remove a QIconView item

int pvRemoveItem	(	PARAM *	p,
		int	id,
		int	index
	)

Remove an item.
Allowed widgets: QListBox, QComboBox

int pvRemoveItemByName	(	PARAM *	p,
		int	id,
		const char *	name
	)

Remove an item by it's name.
Allowed widgets: QListBox, QComboBox

int pvRemoveListViewItem	(	PARAM *	p,
		int	id,
		const char *	path
	)

example:
path = "/dir/subdir/subsubdir"
path := similar to a unix directory path
Remove a QListView item

int pvScrollToAnchor	(	PARAM *	p,
		int	id,
		const char *	anchor
	)

Scroll to anchor
allowed widgets: QTextBrowser

int pvSetBackgroundColor	(	PARAM *	p,
		int	id,
		int	r,
		int	g,
		int	b
	)

Set the background color of the widget.
Allowed widgets: QLabel, QDraw

int pvSetCaption	(	PARAM *	p,
		const char *	text
	)

Set program Title.

int pvSetColumnWidth	(	PARAM *	p,
		int	id,
		int	column,
		int	width
	)

Set the width of a table column.
if column == -1 then 
  set border width
  if width >  0  -> set width
  if width == 0  -> hide
  if width == -1 -> resize to contents
Allowed widgets: QTable

int pvSetDate	(	PARAM *	p,
		int	id,
		int	year,
		int	month,
		int	day
	)

Set date
allowed widgets: QDateEdit, QDateTimeEdit

int pvSetDateOrder	(	PARAM *	p,
		int	id,
		int	order
	)

Set date order, enum Order { DMY, MDY, YMD, YDM }
allowed widgets: QDateEdit, QDateTimeEdit

int pvSetFont	(	PARAM *	p,
		int	id,
		const char *	family,
		int	pointsize,
		int	bold,
		int	italic,
		int	underline,
		int	strikeout
	)

Set the font of the widget. The font will be propagated to all children.
pointsize (in pitch)
bold      = 0|1
italic    = 0|1
underline = 0|1
strikeout = 0|1
Allowed widgets: all widgets

int pvSetFontColor	(	PARAM *	p,
		int	id,
		int	r,
		int	g,
		int	b
	)

Set the font color of the widget.
r=-1,g=-1,b=-1 := unsetPalette()
Allowed widgets: QMultiLineEdit

int pvSetIconViewItem	(	PARAM *	p,
		int	id,
		const char *	bmp_file,
		const char *	text,
		int	download_icon = 1
	)

Insert a QIconViewItem pixmap and text

int pvSetImage	(	PARAM *	p,
		int	id,
		const char *	filename
	)

Set a new image in an existing image.
Allowed widgets: QImage

int pvSetListViewPixmap	(	PARAM *	p,
		int	id,
		const char *	path,
		const char *	bmp_file,
		int	column,
		int	download_icon = 1
	)

example:
path = "/dir/subdir/subsubdir"
path := similar to a unix directory path
Set a QListView pixmap
Use PNG file.

int pvSetListViewText	(	PARAM *	p,
		int	id,
		const char *	path,
		int	column,
		const char *	text
	)

Set the text of a ListViewItem.
example:
path = "/dir/subdir/subsubdir"
path := similar to a unix directory path

Example for colored cells:
pvSetListViewText(p,myListView,"/path/to",0,"color(255,0,0)this is the colored text");
prepend: color(r,g,b)

Allowed widgets: QListView

int pvSetMaxDate	(	PARAM *	p,
		int	id,
		int	year,
		int	month,
		int	day
	)

Set max date
allowed widgets: QDateEdit, QDateTimeEdit

int pvSetMaxTime	(	PARAM *	p,
		int	id,
		int	hour,
		int	minute,
		int	second = 0,
		int	msec = 0
	)

Set time
allowed widgets: QTimeEdit, QDateTimeEdit

int pvSetMinDate	(	PARAM *	p,
		int	id,
		int	year,
		int	month,
		int	day
	)

Set min date
allowed widgets: QDateEdit, QDateTimeEdit

int pvSetMinTime	(	PARAM *	p,
		int	id,
		int	hour,
		int	minute,
		int	second = 0,
		int	msec = 0
	)

Set time
allowed widgets: QTimeEdit, QDateTimeEdit

int pvSetPaletteBackgroundColor	(	PARAM *	p,
		int	id,
		int	r,
		int	g,
		int	b
	)

Set the background color of the widget.
r=-1,g=-1,b=-1 := unsetPalette()
Allowed widgets: all widgets

int pvSetPaletteForegroundColor	(	PARAM *	p,
		int	id,
		int	r,
		int	g,
		int	b
	)

Set the foreground color of the widget.
r=-1,g=-1,b=-1 := unsetPalette()
Allowed widgets: all widgets

int pvSetPixmap	(	PARAM *	p,
		int	id,
		const char *	bmp_file,
		int	download_icon = 1
	)

Set the pixmap.
Use PNG file.

also:
bmp_file = name of an 8bpp bitmap file
if bmp_file == NULL reset pixmap
Allowed widgets: QPushButton

int pvSetRowHeight	(	PARAM *	p,
		int	id,
		int	row,
		int	height
	)

Set the height of a table row.
if row == -1 then set border height
if row >= 0 && height == -1 then set autoresizeRowToContents=1
if row >= 0 && height == -2 then set autoresizeRowToContents=0
default autoresizeRowToContents=0
Allowed widgets: QTable

int pvSetSource	(	PARAM *	p,
		int	id,
		const char *	html_file
	)

Set the file to show in QTextBrowser.
html_file = file to start with
or
http://webpage.url
Allowed widgets: QTextBrowser

int pvSetTableButton	(	PARAM *	p,
		int	id,
		int	x,
		int	y,
		const char *	text
	)

Set a table cell to Button.
Allowed widgets: QTable

int pvSetTableCheckBox	(	PARAM *	p,
		int	id,
		int	x,
		int	y,
		int	state,
		const char *	text
	)

Set a table cell to CheckBox.
Allowed widgets: QTable

int pvSetTableComboBox	(	PARAM *	p,
		int	id,
		int	x,
		int	y,
		int	editable,
		const char *	textlist
	)

Set a table cell to ComboBox.

example:
pvSetTableComboBox(p,Table1,2,1,1,"choice1,choice2,choice3");

Allowed widgets: QTable

int pvSetTableLabel	(	PARAM *	p,
		int	id,
		int	x,
		int	y,
		const char *	text
	)

Set a table cell to label
Allowed widgets: QTable

int pvSetTablePixmap	(	PARAM *	p,
		int	id,
		int	x,
		int	y,
		const char *	bmp_file,
		int	download_icon = 1
	)

Set the pixmap of a table cell.
Use PNG file.

also:
bmp_file = name of an 8bpp bitmap file
Allowed widgets: QTable

int pvSetTableText	(	PARAM *	p,
		int	id,
		int	x,
		int	y,
		const char *	text
	)

Set the text of a table cell.
if x == -1 then set row text
if y == -1 then set column text

Example for colored table cells:
pvTableText(p,Table1,0,0,"color(255,0,0)this is the cell text");
prepend: color(r,g,b)

Allowed widgets: QTable

int pvSetTableTextAlignment	(	PARAM *	p,
		int	id,
		int	x,
		int	y,
		int	alignment
	)

Set the text alignment of a table cell.

alignment :=
  AlignLeft     # Aligns with the left edge.
  AlignRight    # Aligns with the right edge.
  AlignHCenter  # Centers horizontally in the available space.
  AlignJustify  # Justifies the text in the available space.

Allowed widgets: QTable

int pvSetText	(	PARAM *	p,
		int	id,
		const char *	text
	)

Set the text of a widget.
Allowed widgets: QLabel, QPushButton, QLineEdit, QMultiLineEdit, QComboBox, QRadioButton, QCheckBox, QTextBrowser

int pvSetTime	(	PARAM *	p,
		int	id,
		int	hour,
		int	minute,
		int	second = 0,
		int	msec = 0
	)

Set time
allowed widgets: QTimeEdit, QDateTimeEdit

int pvSetValue	(	PARAM *	p,
		int	id,
		int	value
	)

Set the value of a widget.
Allowed widgets: QSlider, QSpinBox, QDial, QProgressBar, QTabWidget, QToolBox
For QMultiLineEdit set maxlines = value

int pvSetWordWrap	(	PARAM *	p,
		int	id,
		int	wrap
	)

Set word wrap for table.
wrap = 0 | 1
Allowed widgets: QTable

int pvSetZoomFactor	(	PARAM *	p,
		int	id,
		float	factor
	)

Set zoom factor of the HTML page
allowed widgets: QTextBrowser

int pvStatusMessage	(	PARAM *	p,
		int	r,
		int	g,
		int	b,
		const char *	format,
			...
	)

Output status message.
If r = g = b = -1 -> normal background color

int pvTablePrintf	(	PARAM *	p,
		int	id,
		int	x,
		int	y,
		const char *	format,
			...
	)

Set the text of a table cell.
Works as printf(format,...);
if x == -1 then set row text
if y == -1 then set column text

Example for colored table cells:
pvTablePrintf(p,Table1,0,0,"color(255,0,0)this is the cell text");
prepend: color(r,g,b)

Allowed widgets: QTable

int pvToolTip	(	PARAM *	p,
		int	id,
		const char *	text
	)

Set a QToolTip for the widget. It will be displayed near the widget when you move over.