📄 gtkcalendar.html
字号:
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head><meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"><title>GtkCalendar</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="GTK+ Reference Manual"><link rel="up" href="MiscObjects.html" title="Miscellaneous"><link rel="prev" href="GtkArrow.html" title="GtkArrow"><link rel="next" href="GtkDrawingArea.html" title="GtkDrawingArea"><meta name="generator" content="GTK-Doc V1.9 (XML mode)"><link rel="stylesheet" href="style.css" type="text/css"><link rel="part" href="gtk.html" title="Part I. GTK+ Overview"><link rel="part" href="gtkbase.html" title="Part II. GTK+ Core Reference"><link rel="part" href="gtkobjects.html" title="Part III. GTK+ Widgets and Objects"><link rel="chapter" href="ch01.html" title="Object Hierarchy"><link rel="chapter" href="ch02.html" title="Widget Gallery"><link rel="chapter" href="WindowWidgets.html" title="Windows"><link rel="chapter" href="DisplayWidgets.html" title="Display Widgets"><link rel="chapter" href="ButtonWidgets.html" title="Buttons and Toggles"><link rel="chapter" href="NumericEntry.html" title="Numeric/Text Data Entry"><link rel="chapter" href="TextWidgetObjects.html" title="Multiline Text Editor"><link rel="chapter" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets"><link rel="chapter" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar"><link rel="chapter" href="Actions.html" title="Action-based menus and toolbars"><link rel="chapter" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)"><link rel="chapter" href="LayoutContainers.html" title="Layout Containers"><link rel="chapter" href="Ornaments.html" title="Ornaments"><link rel="chapter" href="ScrollingWidgets.html" title="Scrolling"><link rel="chapter" href="Printing.html" title="Printing"><link rel="chapter" href="MiscObjects.html" title="Miscellaneous"><link rel="chapter" href="AbstractObjects.html" title="Abstract Base Classes"><link rel="chapter" href="PlugSocket.html" title="Cross-process Embedding"><link rel="chapter" href="SpecialObjects.html" title="Special-purpose features"><link rel="chapter" href="RecentDocuments.html" title="Recently Used Documents"><link rel="chapter" href="Builder.html" title="Interface builder"><link rel="chapter" href="DeprecatedObjects.html" title="Deprecated"><link rel="part" href="migrating.html" title="Part IV. Migrating from Previous Versions of GTK+"><link rel="chapter" href="gtk-migrating-checklist.html" title="Migration Checklist"><link rel="chapter" href="gtk-migrating-GtkFileChooser.html" title="Migrating from GtkFileSelection to GtkFileChooser"><link rel="chapter" href="gtk-migrating-GtkAction.html" title="Migrating from old menu and toolbar systems to GtkAction"><link rel="chapter" href="gtk-migrating-GtkComboBox.html" title="Migrating from GtkOptionMenu and GtkCombo to GtkComboBox and GtkComboBoxEntry"><link rel="chapter" href="gtk-migrating-GtkIconView.html" title="Migrating from GnomeIconList to GtkIconView"><link rel="chapter" href="gtk-migrating-GtkAboutDialog.html" title="Migrating from GnomeAbout to GtkAboutDialog"><link rel="chapter" href="gtk-migrating-GtkColorButton.html" title="Migrating from GnomeColorPicker to GtkColorButton"><link rel="chapter" href="gtk-migrating-GtkAssistant.html" title="Migrating from GnomeDruid to GtkAssistant"><link rel="chapter" href="gtk-migrating-GtkRecentChooser.html" title="Migrating from EggRecent to GtkRecentChooser"><link rel="chapter" href="gtk-migrating-GtkLinkButton.html" title="Migrating from GnomeHRef to GtkLinkButton"><link rel="chapter" href="gtk-migrating-GtkBuilder.html" title="Migrating from libglade to GtkBuilder"><link rel="chapter" href="gtk-migrating-tooltips.html" title="Migrating from GtkTooltips to GtkTooltip"><link rel="part" href="pt05.html" title="Part V. GTK+ Tools"><link rel="glossary" href="glossary.html" title="Glossary"><link rel="index" href="ix01.html" title="Index"><link rel="index" href="ix02.html" title="Index of deprecated symbols"><link rel="index" href="ix03.html" title="Index of new symbols in 2.2"><link rel="index" href="ix04.html" title="Index of new symbols in 2.4"><link rel="index" href="ix05.html" title="Index of new symbols in 2.6"><link rel="index" href="ix06.html" title="Index of new symbols in 2.8"><link rel="index" href="ix07.html" title="Index of new symbols in 2.10"><link rel="index" href="ix08.html" title="Index of new symbols in 2.12"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="GtkArrow.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="MiscObjects.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">GTK+ Reference Manual</th><td><a accesskey="n" href="GtkDrawingArea.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr><tr><td colspan="5" class="shortcuts"><nobr><a href="#id4211977" class="shortcut">Top</a>  |  <a href="#id4212666" class="shortcut">Description</a>  |  <a href="#id4212359" class="shortcut">Object Hierarchy</a>  |  <a href="#id4212406" class="shortcut">Implemented Interfaces</a>  |  <a href="#id4212436" class="shortcut">Properties</a>  |  <a href="#id4212573" class="shortcut">Signals</a></nobr></td></tr></table><div class="refentry" lang="en"><a name="GtkCalendar"></a><div class="titlepage"></div><div class="refnamediv"><table width="100%"><tr><td valign="top"><h2><a name="id4211977"></a><span class="refentrytitle">GtkCalendar</span></h2><p>GtkCalendar — Displays a calendar and allows the user to select a date</p></td><td valign="top" align="right"></td></tr></table></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">#include <gtk/gtk.h> <a class="link" href="GtkCalendar.html#GtkCalendar-struct">GtkCalendar</a>;enum <a class="link" href="GtkCalendar.html#GtkCalendarDisplayOptions">GtkCalendarDisplayOptions</a>;<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* <a class="link" href="GtkCalendar.html#gtk-calendar-new">gtk_calendar_new</a> (void);<ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="GtkCalendar.html#gtk-calendar-select-month">gtk_calendar_select_month</a> (<a class="link" href="GtkCalendar.html" title="GtkCalendar">GtkCalendar</a> *calendar, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint">guint</a> month, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint">guint</a> year);void <a class="link" href="GtkCalendar.html#gtk-calendar-select-day">gtk_calendar_select_day</a> (<a class="link" href="GtkCalendar.html" title="GtkCalendar">GtkCalendar</a> *calendar, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint">guint</a> day);<ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="GtkCalendar.html#gtk-calendar-mark-day">gtk_calendar_mark_day</a> (<a class="link" href="GtkCalendar.html" title="GtkCalendar">GtkCalendar</a> *calendar, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint">guint</a> day);<ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="GtkCalendar.html#gtk-calendar-unmark-day">gtk_calendar_unmark_day</a> (<a class="link" href="GtkCalendar.html" title="GtkCalendar">GtkCalendar</a> *calendar, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint">guint</a> day);void <a class="link" href="GtkCalendar.html#gtk-calendar-clear-marks">gtk_calendar_clear_marks</a> (<a class="link" href="GtkCalendar.html" title="GtkCalendar">GtkCalendar</a> *calendar);<a class="link" href="GtkCalendar.html#GtkCalendarDisplayOptions">GtkCalendarDisplayOptions</a> <a class="link" href="GtkCalendar.html#gtk-calendar-get-display-options">gtk_calendar_get_display_options</a> (<a class="link" href="GtkCalendar.html" title="GtkCalendar">GtkCalendar</a> *calendar);void <a class="link" href="GtkCalendar.html#gtk-calendar-set-display-options">gtk_calendar_set_display_options</a> (<a class="link" href="GtkCalendar.html" title="GtkCalendar">GtkCalendar</a> *calendar, <a class="link" href="GtkCalendar.html#GtkCalendarDisplayOptions">GtkCalendarDisplayOptions</a> flags);void <a class="link" href="GtkCalendar.html#gtk-calendar-display-options">gtk_calendar_display_options</a> (<a class="link" href="GtkCalendar.html" title="GtkCalendar">GtkCalendar</a> *calendar, <a class="link" href="GtkCalendar.html#GtkCalendarDisplayOptions">GtkCalendarDisplayOptions</a> flags);void <a class="link" href="GtkCalendar.html#gtk-calendar-get-date">gtk_calendar_get_date</a> (<a class="link" href="GtkCalendar.html" title="GtkCalendar">GtkCalendar</a> *calendar, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint">guint</a> *year, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint">guint</a> *month, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint">guint</a> *day);void <a class="link" href="GtkCalendar.html#gtk-calendar-freeze">gtk_calendar_freeze</a> (<a class="link" href="GtkCalendar.html" title="GtkCalendar">GtkCalendar</a> *calendar);void <a class="link" href="GtkCalendar.html#gtk-calendar-thaw">gtk_calendar_thaw</a> (<a class="link" href="GtkCalendar.html" title="GtkCalendar">GtkCalendar</a> *calendar);</pre></div><div class="refsect1" lang="en"><a name="id4212359"></a><h2>Object Hierarchy</h2><pre class="synopsis"> <ahref="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a> +----<ahref="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a> +----<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> +----GtkCalendar</pre></div><div class="refsect1" lang="en"><a name="id4212406"></a><h2>Implemented Interfaces</h2><p>GtkCalendar implements AtkImplementorIface and <a class="link" href="gtk-gtkbuildable.html#GtkBuildable">GtkBuildable</a>.</p></div><div class="refsect1" lang="en"><a name="id4212436"></a><h2>Properties</h2><pre class="synopsis"> "<a class="link" href="GtkCalendar.html#GtkCalendar--day">day</a>" <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> : Read / Write "<a class="link" href="GtkCalendar.html#GtkCalendar--month">month</a>" <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> : Read / Write "<a class="link" href="GtkCalendar.html#GtkCalendar--no-month-change">no-month-change</a>" <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> : Read / Write "<a class="link" href="GtkCalendar.html#GtkCalendar--show-day-names">show-day-names</a>" <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> : Read / Write "<a class="link" href="GtkCalendar.html#GtkCalendar--show-heading">show-heading</a>" <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> : Read / Write "<a class="link" href="GtkCalendar.html#GtkCalendar--show-week-numbers">show-week-numbers</a>" <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> : Read / Write "<a class="link" href="GtkCalendar.html#GtkCalendar--year">year</a>" <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> : Read / Write</pre></div><div class="refsect1" lang="en"><a name="id4212573"></a><h2>Signals</h2><pre class="synopsis"> "<a class="link" href="GtkCalendar.html#GtkCalendar-day-selected">day-selected</a>" : Run First "<a class="link" href="GtkCalendar.html#GtkCalendar-day-selected-double-click">day-selected-double-click</a>" : Run First "<a class="link" href="GtkCalendar.html#GtkCalendar-month-changed">month-changed</a>" : Run First "<a class="link" href="GtkCalendar.html#GtkCalendar-next-month">next-month</a>" : Run First "<a class="link" href="GtkCalendar.html#GtkCalendar-next-year">next-year</a>" : Run First "<a class="link" href="GtkCalendar.html#GtkCalendar-prev-month">prev-month</a>" : Run First "<a class="link" href="GtkCalendar.html#GtkCalendar-prev-year">prev-year</a>" : Run First</pre></div><div class="refsect1" lang="en"><a name="id4212666"></a><h2>Description</h2><p><a class="link" href="GtkCalendar.html" title="GtkCalendar"><span class="type">GtkCalendar</span></a> is a widget that displays a calendar, one month at a time. It can be created with <a class="link" href="GtkCalendar.html#gtk-calendar-new"><code class="function">gtk_calendar_new()</code></a>.</p><p>The month and year currently displayed can be altered with <a class="link" href="GtkCalendar.html#gtk-calendar-select-month"><code class="function">gtk_calendar_select_month()</code></a>. The exact day can be selected from the displayed month using <a class="link" href="GtkCalendar.html#gtk-calendar-select-day"><code class="function">gtk_calendar_select_day()</code></a>.</p><p>To place a visual marker on a particular day, use <a class="link" href="GtkCalendar.html#gtk-calendar-mark-day"><code class="function">gtk_calendar_mark_day()</code></a> and to remove the marker, <a class="link" href="GtkCalendar.html#gtk-calendar-unmark-day"><code class="function">gtk_calendar_unmark_day()</code></a>.Alternative, all marks can be cleared with <a class="link" href="GtkCalendar.html#gtk-calendar-clear-marks"><code class="function">gtk_calendar_clear_marks()</code></a>.</p><p>The way in which the calendar itself is displayed can be altered using<a class="link" href="GtkCalendar.html#gtk-calendar-set-display-options"><code class="function">gtk_calendar_set_display_options()</code></a>.</p><p>The selected date can be retrieved from a <a class="link" href="GtkCalendar.html" title="GtkCalendar"><span class="type">GtkCalendar</span></a> using<a class="link" href="GtkCalendar.html#gtk-calendar-get-date"><code class="function">gtk_calendar_get_date()</code></a>.</p></div><div class="refsect1" lang="en"><a name="id4212802"></a><h2>Details</h2><div class="refsect2" lang="en"><a name="id4212812"></a><h3><a name="GtkCalendar-struct"></a>GtkCalendar</h3><a class="indexterm" name="id4212826"></a><pre class="programlisting">typedef struct _GtkCalendar GtkCalendar;</pre><p><em class="structfield"><code>num_marked_dates</code></em> is an integer containing thenumber of days that have a mark over them.</p><p><em class="structfield"><code>marked_date</code></em> is an array containing the day numbersthat currently have a mark over them.</p><p><em class="structfield"><code>month</code></em>, <em class="structfield"><code>year</code></em>, and <em class="structfield"><code>selected_day</code></em> contain the currently visible month,year, and selected day respectively.</p><p>All of these fields should be considered read only, and everything in thisstruct should only be modified using the functions provided below.</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Note that <em class="structfield"><code>month</code></em> is zero-based (i.e it allowed valuesare 0-11) while <em class="structfield"><code>selected_day</code></em> is one-based(i.e. allowed values are 1-31). </p></div></div><hr><div class="refsect2" lang="en"><a name="id4212890"></a><h3><a name="GtkCalendarDisplayOptions"></a>enum GtkCalendarDisplayOptions</h3><a class="indexterm" name="id4212904"></a><pre class="programlisting">typedef enum{ GTK_CALENDAR_SHOW_HEADING = 1 << 0, GTK_CALENDAR_SHOW_DAY_NAMES = 1 << 1, GTK_CALENDAR_NO_MONTH_CHANGE = 1 << 2, GTK_CALENDAR_SHOW_WEEK_NUMBERS = 1 << 3, GTK_CALENDAR_WEEK_START_MONDAY = 1 << 4} GtkCalendarDisplayOptions;</pre><p>These options can be used to influence the display and behaviour of a <a class="link" href="GtkCalendar.html" title="GtkCalendar"><span class="type">GtkCalendar</span></a>.</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><a name="GTK-CALENDAR-SHOW-HEADING:CAPS"></a><code class="literal">GTK_CALENDAR_SHOW_HEADING</code></span></p></td><td>Specifies that the month and year should be displayed.</td></tr><tr><td><p><span class="term"><a name="GTK-CALENDAR-SHOW-DAY-NAMES:CAPS"></a><code class="literal">GTK_CALENDAR_SHOW_DAY_NAMES</code></span></p></td><td>Specifies that three letter day descriptions should be present.</td></tr><tr><td><p><span class="term"><a name="GTK-CALENDAR-NO-MONTH-CHANGE:CAPS"></a><code class="literal">GTK_CALENDAR_NO_MONTH_CHANGE</code></span></p></td><td>Prevents the user from switching months with the calendar.</td></tr><tr><td><p><span class="term"><a name="GTK-CALENDAR-SHOW-WEEK-NUMBERS:CAPS"></a><code class="literal">GTK_CALENDAR_SHOW_WEEK_NUMBERS</code></span></p></td><td>Displays each week numbers of the current year, down the left side of the calendar.</td></tr><tr><td><p><span class="term"><a name="GTK-CALENDAR-WEEK-START-MONDAY:CAPS"></a><code class="literal">GTK_CALENDAR_WEEK_START_MONDAY</code></span></p></td><td>Since GTK+ 2.4, this option is deprecated and ignored by GTK+. The information on which day the calendar week starts is derived from the locale.</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id4213058"></a><h3><a name="gtk-calendar-new"></a>gtk_calendar_new ()</h3><a class="indexterm" name="id4213070"></a><pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* gtk_calendar_new (void);</pre><p>Creates a new calendar, with the current date being selected.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top">⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -