List Dialogue

Use the --list option. List Dialogue

Use the --list option to create a list dialog. Zenity 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 --checklist or --radiolist options, each row must start with either 'TRUE' or 'FALSE'.

The list dialogue supports the following options:

<cmd>--column</cmd>=<var>column</var>

Specifies the column headers that are displayed in the list dialog. You must specify a --column option for each column that you want to display in the dialog.

<cmd>--checklist</cmd>

Specifies that the first column in the list dialogue contains check boxes.

<cmd>--radiolist</cmd>

Specifies that the first column in the list dialogue contains radio boxes.

<cmd>--editable</cmd>

Allows the displayed items to be edited.

<cmd>--separator</cmd>=<var>separator</var>

Specifies what string is used when the list dialogue returns the selected entries.

<cmd>--print-column</cmd>=<var>column</var>

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.

The following example script shows how to create a list dialog:


#!/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"

List Dialogue Example Zenity list dialog example