[[HomePage]] > [[SoftwareIndex Software Index]] > [[SoftwareDevelopment Development]] > [[Xdialog]]

======Xdialog examples======
[[http://web.mit.edu/outland/share/doc/Xdialog-2.1.2/index.html  Xdialog is well documented ]], but examples are hard to find (except within Puppy scripts).  Here are a few, which can be copied & pasted into a terminal to try out.  Please add useful examples if you have them.

====How to obtain output from Xdialog====
1)  exit status $? 
	yes or ok -> 0,  no, cancel, ESC -> 1,  timeout or window closed -> 255
		with --wizard option, next button -> 0, previous button -> 3
2)  assign stderr to variable for choices in inputbox, radiolist, etc., 
	{{color text='b=$(Xdialog .... 2>&1)' c='green'}}  
	or {{color text='b=$(Xdialog --stdout .... )' c='green'}}
	
====Examples====
The series of 2 or 3 numbers after "text" is for sizing.  Zeros-> autosize, which may not work well.  

==yesno== 
**{{color text='Xdialog --timeout 2 --yesno "Choose" 0 0 ; a=$?' c='green'}}**
	sets $a=0, 1 or 255
**{{color text='Xdialog --ok-label Maybe --cancel-label "Maybe not" --yesno "Choose" 0 0 ; a=$?' c='green'}}**
	
==gauge==
**{{color text='for i in {0..100..10} ; do echo $i ; sleep 1 ; done | Xdialog --gauge "Ten second countdown" 0 0' c='green'}}** 
Progress of a more complex task involving a list of L files. (thanks to gnashley [[https://www.linuxquestions.org/questions/programming-9/need-help-with-dialog-xdialog-gauge-option-271705/ here]])
**{{color text='count=0 ; L=$(wc -l </tmp/list)'c='green'}}**
**{{color text='{ while read file ; do'c='green'}}**
	**{{color text='[do something with $file]'c='green'}}**
	**{{color text='let count++ 'c='green'}}**
	**{{color text='bc<<<"100*$count/$L"'c='green'}}**
**{{color text='done < /tmp/list } | Xdialog --gauge "Progress" 0 0'c='green'}}**

==inputbox==
**{{color text='b=$(Xdialog --inputbox "application to run" 0 0 2>&1)' c='green'}}**
	sets $b=typed text, or /path/file in case of drag & drop
**{{color text='b=$(Xdialog --password=2 --separator "|" --2inputsbox "Open encrypted file" 0 0 file "" password "" 2>&1)' c='green'}}**
	$b=/path/myfile.bfe|p4ssw0rd  

==radiolist==  
(single choice from list)
**{{color text='b=$(Xdialog --radiolist "Sound" 0 0 0 ' c='green'}}tag1 "PC" off tag2 "HDMI" on tag3 "BT" off{{color text=' 2>&1)' c='green'}}**
	on/off indicates initial status 
	sets $b=tag2 for example

==menubox== 
(single choice from list)
**{{color text='b=$(Xdialog --menubox "Choose wifi adapter to connect" 10 42 8 ' c='green'}}tag1 "card0" tag2 "card1" tag3 "wifi off" {{color text=' 2>&1)' c='green'}}** 
	sets $b=tag#

==checklist== 
(any number of selections from list)
**{{color text='b=$(Xdialog --checklist "$1" 12 32 12 ' c='green'}} tag1 "Save" on tag2 "Reboot" off tag3 "Shut down" on {{color text='  2>&1)' c='green'}}**
	sets $b=tag1/tag3   for example if 1 and 3 are checked

==infobox==
**{{color text='Xdialog --infobox "important message" 0 0 2000' c='green'}}**
	(2000 is timeout in ms; 0 = no timeout)
update text from std input:
**{{color text='while true ; do sleep 1 ; echo -e "XXX\n`date`\nXXX" ; done | Xdialog --infobox "Initial text" 8 60 0' c='green'}}**
	Initial text is overwritten. XXX = new text tag.  

===timeout and interval===
--interval # is the interval at which choices are registered, in ms.  If absent, no choice is registered ($b="") unless OK is clicked.
If an interval equal to the timeout is used, the latest choice is returned, even if OK is not clicked before timeout.
**{{color text='b=$(Xdialog --timeout 4 --interval 4000 --radiolist "asldkjf" 12 20 3 ' c='green'}}1 "first choice" off 2 "second choice" on 3 "third choice" off{{color text=' 2>&1)' c='green'}}**
	sets $b=latest choice on timeout or OK
If a shorter interval is used, a space-delimited history of choices is returned.
**{{color text='b=$(Xdialog --timeout 4 --interval 200 --menubox "text" 10 42 8' c='green'}} 1 "first choice" 2 "second choice" 3 "third choice"{{color text=' 2>&1)' c='green'}} **
	might return	$b=1 1 1 2 2 2 2 2  for example


----
==Categories==
CategoryDevelopment
CategorySoftware