Gecko [ v99win.today ]

Name	Size	Permission
calendar.page	2.21 KB	-rw-r--r--
color-selection.page	1.38 KB	-rw-r--r--
entry.page	1.59 KB	-rw-r--r--
error.page	861 B	-rw-r--r--
file-selection.page	2.1 KB	-rw-r--r--
forms.page	2.21 KB	-rw-r--r--
index.page	821 B	-rw-r--r--
info.page	889 B	-rw-r--r--
intro.page	1.07 KB	-rw-r--r--
legal.xml	3.05 KB	-rw-r--r--
list.page	2.7 KB	-rw-r--r--
message.page	668 B	-rw-r--r--
notification.page	2.08 KB	-rw-r--r--
password.page	1.27 KB	-rw-r--r--
progress.page	2.19 KB	-rw-r--r--
question.page	882 B	-rw-r--r--
scale.page	2.02 KB	-rw-r--r--
text.page	2.19 KB	-rw-r--r--
usage.page	8.09 KB	-rw-r--r--
warning.page	891 B	-rw-r--r--

Code Editor : list.page

<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="list" xml:lang="zenity-en-GB">
 <info>
 <link type="guide" xref="index#dialogs"/>
 <desc>Use the <cmd>--list</cmd> option.</desc>
 <include xmlns="http://www.w3.org/2001/XInclude" href="legal.xml"/>
 </info>
 <title>List Dialogue</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 dialogue must specified column by column, row by row. Data can be provided to the dialogue 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 dialogue 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 dialogue contains check boxes.
 </item>

<item>
 <title><cmd>--radiolist</cmd></title>
	 Specifies that the first column in the list dialogue 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 dialogue 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 Dialogue 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