summaryrefslogtreecommitdiff
path: root/help/en_GB/file-selection.page
diff options
context:
space:
mode:
Diffstat (limited to 'help/en_GB/file-selection.page')
-rw-r--r--help/en_GB/file-selection.page67
1 files changed, 67 insertions, 0 deletions
diff --git a/help/en_GB/file-selection.page b/help/en_GB/file-selection.page
new file mode 100644
index 00000000..e9454ef7
--- /dev/null
+++ b/help/en_GB/file-selection.page
@@ -0,0 +1,67 @@
+<?xml version="1.0" encoding="utf-8"?>
+<page xmlns="http://projectmallard.org/1.0/" type="topic" id="file-selection" xml:lang="en-GB">
+ <info>
+ <link type="guide" xref="index#dialogs"/>
+ <desc>Use the <cmd>--file-selection</cmd> option.</desc>
+ </info>
+ <title>File Selection Dialogue</title>
+ <p>
+ Use the <cmd>--file-selection</cmd> option to create a file selection dialog. <app>Zenity</app> returns the selected files or directories to standard
+ output. The default mode of the file selection dialog is open.
+ </p>
+ <p>The file selection dialogue supports the following options:</p>
+
+ <terms>
+
+ <item>
+ <title><cmd>--filename</cmd>=<var>filename</var></title>
+ <p>Specifies the file or directory that is selected in the file selection dialogue when the dialogue is first shown.</p>
+ </item>
+
+ <item>
+ <title><cmd>--multiple</cmd></title>
+ <p>Allows the selection of multiple filenames in the file selection dialogue.</p>
+ </item>
+
+ <item>
+ <title><cmd>--directory</cmd></title>
+ <p>Allows only selection of directories in the file selection dialogue.</p>
+ </item>
+
+ <item>
+ <title><cmd>--save</cmd></title>
+ <p>Set the file selection dialogue into save mode.</p>
+ </item>
+
+ <item>
+ <title><cmd>--separator</cmd>=<var>separator</var></title>
+ <p>Specifies the string that is used to divide the returned list of filenames.</p>
+ </item>
+
+ </terms>
+
+ <p>
+ The following example script shows how to create a file selection dialog:
+ </p>
+
+<code>
+#!/bin/sh
+
+FILE=`zenity --file-selection --title="Select a File"`
+
+case $? in
+ 0)
+ echo "\"$FILE\" selected.";;
+ 1)
+ echo "No file selected.";;
+ -1)
+ echo "An unexpected error has occurred.";;
+esac
+</code>
+
+ <figure>
+ <title>File Selection Dialogue Example</title>
+ <desc><app>Zenity</app> file selection dialog example</desc>
+ <media type="image" mime="image/png" src="figures/zenity-fileselection-screenshot.png"/>
+ </figure>
+</page>
bgstack15