Gecko [ www.utparral.edu.mx ]

Name	Size	Permission
figures	[ DIR ]	drwxr-xr-x
calendar.page	2.16 KB	-rw-r--r--
color-selection.page	1.33 KB	-rw-r--r--
entry.page	1.53 KB	-rw-r--r--
error.page	807 B	-rw-r--r--
file-selection.page	2.04 KB	-rw-r--r--
forms.page	2.16 KB	-rw-r--r--
index.page	778 B	-rw-r--r--
info.page	837 B	-rw-r--r--
intro.page	1.02 KB	-rw-r--r--
legal.xml	3.75 KB	-rw-r--r--
list.page	2.68 KB	-rw-r--r--
message.page	618 B	-rw-r--r--
notification.page	2.04 KB	-rw-r--r--
password.page	1.22 KB	-rw-r--r--
progress.page	2.14 KB	-rw-r--r--
question.page	828 B	-rw-r--r--
scale.page	1.98 KB	-rw-r--r--
text.page	2.14 KB	-rw-r--r--
usage.page	8.06 KB	-rw-r--r--
warning.page	837 B	-rw-r--r--

Code Editor : list.page

<page xmlns="http://projectmallard.org/1.0/"
 type="topic"
 id="list">
 <info>
 <link type="guide" xref="index#dialogs"/>
 <desc>Use the <cmd>--list</cmd> option.</desc>
 <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude" />
 </info>
 <title>List Dialog</title>
 
	Use the <cmd>--list</cmd> option to create a list dialog. <app>Zenity</app> returns the entries in the first column of text of selected rows to standard output.

Data for the dialog must specified column by column, row by row. Data can be provided to the dialog through standard input. Each entry must be separated by a newline character.

If you use the <cmd>--checklist</cmd> or <cmd>--radiolist</cmd> options, each row must start with either 'TRUE' or 'FALSE'.

The list dialog supports the following options:

<terms>

<item>
 <title><cmd>--column</cmd>=<var>column</var></title>
	 Specifies the column headers that are displayed in the list dialog. You must specify a <cmd>--column</cmd> option for each column that you want to display in the dialog.
	 
 </item>

<item>
 <title><cmd>--checklist</cmd></title>
	 Specifies that the first column in the list dialog contains check boxes.
	 
 </item>

<item>
 <title><cmd>--radiolist</cmd></title>
	 Specifies that the first column in the list dialog contains radio boxes.
	 
 </item>

<item>
 <title><cmd>--editable</cmd></title>
	 Allows the displayed items to be edited.
	 
 </item>

<item>
 <title><cmd>--separator</cmd>=<var>separator</var></title>
	 Specifies what string is used when the list dialog returns the selected entries.
	 
 </item>

<item>
 <title><cmd>--print-column</cmd>=<var>column</var></title>
	 Specifies what column should be printed out upon selection. The default column is
 '1'. 'ALL' can be used to print out all columns in the list.
	 
 </item>

</terms>

The following example script shows how to create a list dialog:
 
<code>
#!/bin/sh

zenity --list \
 --title="Choose the Bugs You Wish to View" \
 --column="Bug Number" --column="Severity" --column="Description" \
 992383 Normal "GtkTreeView crashes on multiple selections" \
 293823 High "GNOME Dictionary does not handle proxy" \
 393823 Critical "Menu editing does not work in GNOME 2.0"
</code>

<figure>
 <title>List Dialog Example</title>
 <desc><app>Zenity</app> list dialog example</desc>
 <media type="image" mime="image/png" src="figures/zenity-list-screenshot.png"/>
 </figure>
</page>

${this.title}

Code Editor : list.page