summaryrefslogtreecommitdiff
path: root/help/C/calendar.page
diff options
context:
space:
mode:
authorYasumichi Akahoshi <yasumichi@vinelinux.org>2011-11-19 02:55:00 +0900
committerTiffany Antopolski <tiffany.antopolski@gmail.com>2011-12-17 13:23:47 -0500
commitf1bf713d0fcd86d38b119d95b276f67245123810 (patch)
tree0c6fe0869ff8d74b15850cdb15c4c0975c45f373 /help/C/calendar.page
parent43b79214894e293b08d4f8bdbe19243bf62d0559 (diff)
Add mallard pages and update screenshots.
Signed-off-by: Yasumichi Akahoshi <yasumichi@vinelinux.org>
Diffstat (limited to 'help/C/calendar.page')
-rw-r--r--help/C/calendar.page68
1 files changed, 68 insertions, 0 deletions
diff --git a/help/C/calendar.page b/help/C/calendar.page
new file mode 100644
index 0000000..cd2191c
--- /dev/null
+++ b/help/C/calendar.page
@@ -0,0 +1,68 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="topic"
+ id="calendar">
+ <info>
+ <link type="guide" xref="index#dialogs"/>
+ <desc>Use the <cmd>--calendar</cmd> option.</desc>
+ </info>
+ <title>Calendar Dialog</title>
+ <p>
+ Use the <cmd>--calendar</cmd> option to create a calendar dialog. Zenity returns the selected date to standard output. If no date is specified on the command line, the dialog uses the current date.
+ </p>
+ <p>
+ The calendar dialog supports the following options:
+ </p>
+
+ <terms>
+
+ <item>
+ <title><cmd>--text</cmd>=<var>text</var></title>
+ <p>Specifies the text that is displayed in the calendar dialog.</p>
+ </item>
+
+ <item>
+ <title><cmd>--day</cmd>=<var>day</var></title>
+ <p>Specifies the day that is selected in the calendar dialog. day must be a number between 1 and 31 inclusive.</p>
+ </item>
+
+ <item>
+ <title><cmd>--month</cmd>=<var>month</var></title>
+ <p>Specifies the month that is selected in the calendar dialog. month must be a number between 1 and 12 inclusive.</p>
+ </item>
+
+ <item>
+ <title><cmd>--year</cmd>=<var>year</var></title>
+ <p>Specifies the year that is selected in the calendar dialog.</p>
+ </item>
+
+ <item>
+ <title><cmd>--date-format</cmd>=<var>format</var></title>
+ <p>Specifies the format that is returned from the calendar dialog after date selection. The default format depends on your locale. Format must be a format that is acceptable to the <cmd>strftime</cmd> function, for example <var>%A %d/%m/%y</var>.</p>
+ </item>
+
+ </terms>
+
+ <p>
+ The following example script shows how to create a calendar dialog:
+ </p>
+
+<code>
+#!/bin/sh
+
+
+if zenity --calendar \
+--title="Select a Date" \
+--text="Click on a date to select that date." \
+--day=10 --month=8 --year=2004
+ then echo $?
+ else echo "No date selected"
+fi
+</code>
+
+
+ <figure id="zenity-calendar-screenshot">
+ <title>Calendar Dialog Example</title>
+ <desc>Zenity calendar dialog example</desc>
+ <media type="image" mime="image/png" src="figures/zenity-calendar-screenshot.png"/>
+ </figure>
+</page>