QCalendarWidget Class Reference · PyQt4 中文文檔

# QCalendarWidget Class Reference ## [[QtGui](index.htm) module] 該QCalendarWidget類提供了一個每月按日歷組件，允許用戶選擇一個日期。[More...](#details) 繼承[QWidget](qwidget.html)。 ### Types * `enum HorizontalHeaderFormat { NoHorizontalHeader, SingleLetterDayNames, ShortDayNames, LongDayNames }` * `enum SelectionMode { NoSelection, SingleSelection }` * `enum VerticalHeaderFormat { NoVerticalHeader, ISOWeekNumbers }` ### Methods * `__init__ (self, QWidget?parent?=?None)` * `int dateEditAcceptDelay (self)` * `dict-of-QDate-QTextCharFormat dateTextFormat (self)` * `QTextCharFormat dateTextFormat (self, QDate?date)` * `bool event (self, QEvent?event)` * `bool eventFilter (self, QObject?watched, QEvent?event)` * `Qt.DayOfWeek firstDayOfWeek (self)` * `QTextCharFormat headerTextFormat (self)` * `HorizontalHeaderFormat horizontalHeaderFormat (self)` * `bool isDateEditEnabled (self)` * `bool isGridVisible (self)` * `bool isHeaderVisible (self)` * `bool isNavigationBarVisible (self)` * `keyPressEvent (self, QKeyEvent?event)` * `QDate maximumDate (self)` * `QDate minimumDate (self)` * `QSize minimumSizeHint (self)` * `int monthShown (self)` * `mousePressEvent (self, QMouseEvent?event)` * `paintCell (self, QPainter?painter, QRect?rect, QDate?date)` * `resizeEvent (self, QResizeEvent?event)` * `QDate selectedDate (self)` * `SelectionMode selectionMode (self)` * `setCurrentPage (self, int?year, int?month)` * `setDateEditAcceptDelay (self, int?delay)` * `setDateEditEnabled (self, bool?enable)` * `setDateRange (self, QDate?min, QDate?max)` * `setDateTextFormat (self, QDate?date, QTextCharFormat?color)` * `setFirstDayOfWeek (self, Qt.DayOfWeek?dayOfWeek)` * `setGridVisible (self, bool?show)` * `setHeaderTextFormat (self, QTextCharFormat?format)` * `setHeaderVisible (self, bool?show)` * `setHorizontalHeaderFormat (self, HorizontalHeaderFormat?format)` * `setMaximumDate (self, QDate?date)` * `setMinimumDate (self, QDate?date)` * `setNavigationBarVisible (self, bool?visible)` * `setSelectedDate (self, QDate?date)` * `setSelectionMode (self, SelectionMode?mode)` * `setVerticalHeaderFormat (self, VerticalHeaderFormat?format)` * `setWeekdayTextFormat (self, Qt.DayOfWeek?dayOfWeek, QTextCharFormat?format)` * `showNextMonth (self)` * `showNextYear (self)` * `showPreviousMonth (self)` * `showPreviousYear (self)` * `showSelectedDate (self)` * `showToday (self)` * `QSize sizeHint (self)` * `updateCell (self, QDate?date)` * `updateCells (self)` * `VerticalHeaderFormat verticalHeaderFormat (self)` * `QTextCharFormat weekdayTextFormat (self, Qt.DayOfWeek?dayOfWeek)` * `int yearShown (self)` ### Qt Signals * `void activated (const QDate&)` * `void clicked (const QDate&)` * `void currentPageChanged (int,int)` * `void selectionChanged ()` * * * ## Detailed Description 該QCalendarWidget類提供了一個每月按日歷組件，允許用戶選擇一個日期。 ![](https://img.kancloud.cn/dd/de/ddde69e90164640b04fef5c55d19ab38_340x201.png) 小部件是與當前的月份和年份初始化，但QCalendarWidget提供了一些公用插槽的年份和月份所顯示改變。默認情況下，今天的日期被選中，用戶可以同時使用鼠標和鍵盤選擇一個日期。當前選定的日期可以通過檢索的[selectedDate](qcalendarwidget.html#selectedDate-prop)（）函數。它可以通過設置來限制用戶選擇一個給定的時間范圍的[minimumDate](qcalendarwidget.html#minimumDate-prop)和[maximumDate](qcalendarwidget.html#maximumDate-prop)屬性。另外，這兩個屬性可以一次過使用設置[setDateRange](qcalendarwidget.html#setDateRange)（）方便的插槽。設置[selectionMode](qcalendarwidget.html#selectionMode-prop)屬性為[NoSelection](qcalendarwidget.html#SelectionMode-enum)從在選擇禁止所有用戶。請注意，日期也可以以編程方式使用被選擇的[setSelectedDate](qcalendarwidget.html#selectedDate-prop)（）槽。當前顯示的月份和年份可使用檢索[monthShown](qcalendarwidget.html#monthShown)（）和[yearShown](qcalendarwidget.html#yearShown)（）函數，分別為。新創建的日歷小部件使用縮寫的日期名，以及星期六和星期日被標記為紅色。日歷網格是不可見的。一周數字顯示，第一列日是星期天。在天的符號可以通過設置進行修改，以一個單一的字母縮寫（ “M”為“星期一” ）的[horizontalHeaderFormat](qcalendarwidget.html#horizontalHeaderFormat-prop)屬性為[QCalendarWidget.SingleLetterDayNames](qcalendarwidget.html#HorizontalHeaderFormat-enum)。同樣的屬性設置為[QCalendarWidget.LongDayNames](qcalendarwidget.html#HorizontalHeaderFormat-enum)使頭顯示完整的日期名。該周數可以通過設置去除[verticalHeaderFormat](qcalendarwidget.html#verticalHeaderFormat-prop)屬性為[QCalendarWidget.NoVerticalHeader](qcalendarwidget.html#VerticalHeaderFormat-enum)。日歷網格可以通過設置打開了[gridVisible](qcalendarwidget.html#gridVisible-prop)使用屬性為True[setGridVisible](qcalendarwidget.html#gridVisible-prop)（）函數： | ![](https://img.kancloud.cn/a5/d2/a5d2db7b24559308f725a8bd69ee7bb0_337x198.png) | | ``` QCalendarWidget *calendar; calendar->setGridVisible(true); ``` | 最后，一天中的第一列可以使用被改變的[setFirstDayOfWeek](qcalendarwidget.html#firstDayOfWeek-prop)（）函數。該QCalendarWidget類還提供了三個信號，[selectionChanged](qcalendarwidget.html#selectionChanged)（）[activated](qcalendarwidget.html#activated)（）和[currentPageChanged](qcalendarwidget.html#currentPageChanged)（）使得能夠響應用戶交互。頭，平日或單天的渲染可以在很大程度上通過自定義設置[QTextCharFormat](qtextcharformat.html)的一些特殊的工作日，特殊日期或標題的呈現。在屬性的一個子集[QTextCharFormat](qtextcharformat.html)所使用的日歷組件。目前，前景，背景和字體屬性可用于確定單個細胞在插件的渲染。 * * * ## Type Documentation ``` QCalendarWidget.HorizontalHeaderFormat ``` 這個枚舉類型定義了各種格式的水平標題可以顯示。 | Constant | Value | Description | | --- | --- | --- | | `QCalendarWidget.SingleLetterDayNames` | `1` | 標題會顯示一個字母縮寫日期名（例如M星期一）。 | | `QCalendarWidget.ShortDayNames` | `2` | 標題會顯示一個簡短的縮寫一天的名稱（例如，星期一星期一）。 | | `QCalendarWidget.LongDayNames` | `3` | 頭顯示完整的日期名（如星期一）。 | | `QCalendarWidget.NoHorizontalHeader` | `0` | 頭是隱藏的。 | **See also** [horizontalHeaderFormat](qcalendarwidget.html#horizontalHeaderFormat-prop)（）和[VerticalHeaderFormat](qcalendarwidget.html#VerticalHeaderFormat-enum)。 ``` QCalendarWidget.SelectionMode ``` 這個枚舉描述提供給用于選擇日期的日歷用戶選擇的類型。 | Constant | Value | Description | | --- | --- | --- | | `QCalendarWidget.NoSelection` | `0` | 日期無法選擇。 | | `QCalendarWidget.SingleSelection` | `1` | 單日期可以選擇。 | **See also** [selectionMode](qcalendarwidget.html#selectionMode-prop)。 ``` QCalendarWidget.VerticalHeaderFormat ``` 這個枚舉類型定義了各種格式的垂直頭可以顯示。 | Constant | Value | Description | | --- | --- | --- | | `QCalendarWidget.ISOWeekNumbers` | `1` | 所描述的標題顯示的ISO周數[QDate.weekNumber](qdate.html#weekNumber)（）。 | | `QCalendarWidget.NoVerticalHeader` | `0` | 頭是隱藏的。 | **See also** [verticalHeaderFormat](qcalendarwidget.html#verticalHeaderFormat-prop)（）和[HorizontalHeaderFormat](qcalendarwidget.html#HorizontalHeaderFormat-enum)。 * * * ## Method Documentation ``` QCalendarWidget.__init__ (self, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個日歷控件與給定_parent_。小部件是與當前的月份和年份初始化，當前選定的日期為今日。 **See also** [setCurrentPage](qcalendarwidget.html#setCurrentPage)（）。 ``` int QCalendarWidget.dateEditAcceptDelay (self) ``` ``` dict-of-QDate-QTextCharFormat QCalendarWidget.dateTextFormat (self) ``` 返回[QMap](index.htm)從[QDate](qdate.html)至[QTextCharFormat](qtextcharformat.html)顯示所有使用該改變其呈現的特殊格式的日期。 **See also** [setDateTextFormat](qcalendarwidget.html#setDateTextFormat)（）。 ``` QTextCharFormat QCalendarWidget.dateTextFormat (self, QDate?date) ``` [](qtextcharformat.html) [返回](qtextcharformat.html)[QTextCharFormat](qtextcharformat.html)為_date_。該字符格式可以為空，如果日期不renderd特別。 ``` bool QCalendarWidget.event (self, QEvent?event) ``` 從重新實現[QObject.event](qobject.html#event)（）。 ``` bool QCalendarWidget.eventFilter (self, QObject?watched, QEvent?event) ``` 從重新實現[QObject.eventFilter](qobject.html#eventFilter)（）。 ``` Qt.DayOfWeek QCalendarWidget.firstDayOfWeek (self) ``` [](qt.html#DayOfWeek-enum) ``` QTextCharFormat QCalendarWidget.headerTextFormat (self) ``` [ 返回渲染的標題文本字符格式。 ](qtextcharformat.html) [**See also**](qtextcharformat.html) [setHeaderTextFormat](qcalendarwidget.html#setHeaderTextFormat)（）。 ``` HorizontalHeaderFormat QCalendarWidget.horizontalHeaderFormat (self) ``` [ ``` bool QCalendarWidget.isDateEditEnabled (self) ``` ``` bool QCalendarWidget.isGridVisible (self) ``` ``` bool QCalendarWidget.isHeaderVisible (self) ``` ``` bool QCalendarWidget.isNavigationBarVisible (self) ``` ``` QCalendarWidget.keyPressEvent (self, QKeyEvent?event) ``` ](qcalendarwidget.html#HorizontalHeaderFormat-enum) [從重新實現](qcalendarwidget.html#HorizontalHeaderFormat-enum)[QWidget.keyPressEvent](qwidget.html#keyPressEvent)（）。 ``` QDate QCalendarWidget.maximumDate (self) ``` [](qdate.html) ``` QDate QCalendarWidget.minimumDate (self) ``` [](qdate.html) ``` QSize QCalendarWidget.minimumSizeHint (self) ``` [](qsize.html) [從重新實現](qsize.html)[QWidget.minimumSizeHint](qwidget.html#minimumSizeHint-prop)（）。 ``` int QCalendarWidget.monthShown (self) ``` 返回當前顯示的月份。個編號從1到12 。 **See also** [yearShown](qcalendarwidget.html#yearShown)（）和[setCurrentPage](qcalendarwidget.html#setCurrentPage)（）。 ``` QCalendarWidget.mousePressEvent (self, QMouseEvent?event) ``` 從重新實現[QWidget.mousePressEvent](qwidget.html#mousePressEvent)（）。 ``` QCalendarWidget.paintCell (self, QPainter?painter, QRect?rect, QDate?date) ``` 繪制由給定指定的單元格_date_，使用給定的_painter_和_rect_。 ``` QCalendarWidget.resizeEvent (self, QResizeEvent?event) ``` 從重新實現[QWidget.resizeEvent](qwidget.html#resizeEvent)（）。 ``` QDate QCalendarWidget.selectedDate (self) ``` [](qdate.html) ``` SelectionMode QCalendarWidget.selectionMode (self) ``` [ ``` QCalendarWidget.setCurrentPage (self, int?year, int?month) ``` 這種方法也是一個Qt槽與C + +的簽名`void setCurrentPage(int,int)`。 ](qcalendarwidget.html#SelectionMode-enum) [顯示給定的_month_的給定_year_在不改變選定的日期。使用](qcalendarwidget.html#SelectionMode-enum)[setSelectedDate](qcalendarwidget.html#selectedDate-prop)（）函數來改變所選的日期。當前顯示的月份和年份可使用檢索[monthShown](qcalendarwidget.html#monthShown)（）和[yearShown](qcalendarwidget.html#yearShown)（）分別為功能。 **See also** [yearShown](qcalendarwidget.html#yearShown)（）[monthShown](qcalendarwidget.html#monthShown)（）[showPreviousMonth](qcalendarwidget.html#showPreviousMonth)（）[showNextMonth](qcalendarwidget.html#showNextMonth)（）[showPreviousYear](qcalendarwidget.html#showPreviousYear)（）和[showNextYear](qcalendarwidget.html#showNextYear)（）。 ``` QCalendarWidget.setDateEditAcceptDelay (self, int?delay) ``` ``` QCalendarWidget.setDateEditEnabled (self, bool?enable) ``` ``` QCalendarWidget.setDateRange (self, QDate?min, QDate?max) ``` 這種方法也是一個Qt槽與C + +的簽名`void setDateRange(const QDate&,const QDate&)`。通過設置定義一個日期范圍[minimumDate](qcalendarwidget.html#minimumDate-prop)和[maximumDate](qcalendarwidget.html#maximumDate-prop)屬性。日期范圍限制了用戶的選擇，即用戶只能選擇指定日期范圍內的日期。需要注意的是 ``` [QCalendarWidget](qcalendarwidget.html) *calendar; calendar->setDateRange(min, max); ``` 類似于 ``` [QCalendarWidget](qcalendarwidget.html) *calendar; calendar->setMinimumDate(min); calendar->setMaximumDate(max); ``` 如果任何一個_min_ or _max_參數無效[QDate](qdate.html)對象，這個函數不執行任何操作。 **See also** [setMinimumDate](qcalendarwidget.html#minimumDate-prop)（）和[setMaximumDate](qcalendarwidget.html#maximumDate-prop)（）。 ``` QCalendarWidget.setDateTextFormat (self, QDate?date, QTextCharFormat?color) ``` 設置用于呈現給定的格式_date_到由指定的_format_。 If _date_為空，所有的日期格式將被清除。 **See also** [dateTextFormat](qcalendarwidget.html#dateTextFormat)（）。 ``` QCalendarWidget.setFirstDayOfWeek (self, Qt.DayOfWeek?dayOfWeek) ``` ``` QCalendarWidget.setGridVisible (self, bool?show) ``` ``` QCalendarWidget.setHeaderTextFormat (self, QTextCharFormat?format) ``` 設置用于呈現頭文字字符格式_format_。如果還設置了平日的文本格式，這種格式的前景色和背景色將優先于頭的格式。其他格式的信息將仍然由標題的格式來決定。 **See also** [headerTextFormat](qcalendarwidget.html#headerTextFormat)（）。 ``` QCalendarWidget.setHeaderVisible (self, bool?show) ``` ``` QCalendarWidget.setHorizontalHeaderFormat (self, HorizontalHeaderFormat?format) ``` ``` QCalendarWidget.setMaximumDate (self, QDate?date) ``` ``` QCalendarWidget.setMinimumDate (self, QDate?date) ``` ``` QCalendarWidget.setNavigationBarVisible (self, bool?visible) ``` 這種方法也是一個Qt槽與C + +的簽名`void setNavigationBarVisible(bool)`。 ``` QCalendarWidget.setSelectedDate (self, QDate?date) ``` 這種方法也是一個Qt槽與C + +的簽名`void setSelectedDate(const QDate&)`。 ``` QCalendarWidget.setSelectionMode (self, SelectionMode?mode) ``` ``` QCalendarWidget.setVerticalHeaderFormat (self, VerticalHeaderFormat?format) ``` ``` QCalendarWidget.setWeekdayTextFormat (self, Qt.DayOfWeek?dayOfWeek, QTextCharFormat?format) ``` 設置為一天的渲染文本字符格式的一周_dayOfWeek_至_format_。該格式將優先于案件前景色和背景色的報頭格式。其他文本格式的信息是從標題的格式。 **See also** [weekdayTextFormat](qcalendarwidget.html#weekdayTextFormat)（）和[setHeaderTextFormat](qcalendarwidget.html#setHeaderTextFormat)（）。 ``` QCalendarWidget.showNextMonth (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void showNextMonth()`。表明相對于當前顯示的月份的下一個月份。注意，所選擇的日期沒有改變。 **See also** [showPreviousMonth](qcalendarwidget.html#showPreviousMonth)（）[setCurrentPage](qcalendarwidget.html#setCurrentPage)（）和[setSelectedDate](qcalendarwidget.html#selectedDate-prop)（）。 ``` QCalendarWidget.showNextYear (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void showNextYear()`。顯示當前顯示的月份_next_相對于當前顯示的一年年。注意，所選擇的日期沒有改變。 **See also** [showPreviousYear](qcalendarwidget.html#showPreviousYear)（）[setCurrentPage](qcalendarwidget.html#setCurrentPage)（）和[setSelectedDate](qcalendarwidget.html#selectedDate-prop)（）。 ``` QCalendarWidget.showPreviousMonth (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void showPreviousMonth()`。顯示上月相對于當前顯示的月份。注意，所選擇的日期沒有改變。 **See also** [showNextMonth](qcalendarwidget.html#showNextMonth)（）[setCurrentPage](qcalendarwidget.html#setCurrentPage)（）和[setSelectedDate](qcalendarwidget.html#selectedDate-prop)（）。 ``` QCalendarWidget.showPreviousYear (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void showPreviousYear()`。顯示當前顯示的月份_previous_相對于當前顯示的一年年。注意，所選擇的日期沒有改變。 **See also** [showNextYear](qcalendarwidget.html#showNextYear)（）[setCurrentPage](qcalendarwidget.html#setCurrentPage)（）和[setSelectedDate](qcalendarwidget.html#selectedDate-prop)（）。 ``` QCalendarWidget.showSelectedDate (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void showSelectedDate()`。顯示所選日期的月份。 **See also** [selectedDate](qcalendarwidget.html#selectedDate-prop)（）和[setCurrentPage](qcalendarwidget.html#setCurrentPage)（）。 ``` QCalendarWidget.showToday (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void showToday()`。顯示今天的日期的月份。 **See also** [selectedDate](qcalendarwidget.html#selectedDate-prop)（）和[setCurrentPage](qcalendarwidget.html#setCurrentPage)（）。 ``` QSize QCalendarWidget.sizeHint (self) ``` [](qsize.html) [從重新實現](qsize.html)[QWidget.sizeHint](qwidget.html#sizeHint-prop)（）。 ``` QCalendarWidget.updateCell (self, QDate?date) ``` 更新由給定的指定的單元_date_除非更新被禁用或細胞是隱藏的。此功能被引入Qt的4.4 。 **See also** [updateCells](qcalendarwidget.html#updateCells)（）[yearShown](qcalendarwidget.html#yearShown)（）和[monthShown](qcalendarwidget.html#monthShown)（）。 ``` QCalendarWidget.updateCells (self) ``` 更新所有可見的單元格，除非更新被禁用。此功能被引入Qt的4.4 。 **See also** [updateCell](qcalendarwidget.html#updateCell)（）。 ``` VerticalHeaderFormat QCalendarWidget.verticalHeaderFormat (self) ``` [](qcalendarwidget.html#VerticalHeaderFormat-enum) ``` QTextCharFormat QCalendarWidget.weekdayTextFormat (self, Qt.DayOfWeek?dayOfWeek) ``` [ 返回天的渲染文本字符格式的一周_dayOfWeek_。 ](qtextcharformat.html) [**See also**](qtextcharformat.html) [setWeekdayTextFormat](qcalendarwidget.html#setWeekdayTextFormat)（）和[headerTextFormat](qcalendarwidget.html#headerTextFormat)（）。 ``` int QCalendarWidget.yearShown (self) ``` 返回當前顯示的月份的一年。個編號從1到12 。 **See also** [monthShown](qcalendarwidget.html#monthShown)（）和[setCurrentPage](qcalendarwidget.html#setCurrentPage)（）。 * * * ## Qt Signal Documentation ``` void activated (const QDate&) ``` 這是該信號的默認超載。當用戶按下回車鍵或雙擊這個信號被發射一個_date_在日歷窗口小部件。 ``` void clicked (const QDate&) ``` 這是該信號的默認超載。單擊鼠標按鈕時，這個信號被發射。鼠標點擊的日期是由指定的_date_。在有效日期點擊時，信號才發出，例如，日期是不是在外面[minimumDate](qcalendarwidget.html#minimumDate-prop)（）和[maximumDate](qcalendarwidget.html#maximumDate-prop)（）。如果選擇模式是[NoSelection](qcalendarwidget.html#SelectionMode-enum)時，該信號將不會被發射。 ``` void currentPageChanged (int,int) ``` 這是該信號的默認超載。當前顯示的月份被改變時，這個信號被發射。新_year_和_month_作為參數傳遞。 **See also** [setCurrentPage](qcalendarwidget.html#setCurrentPage)（）。 ``` void selectionChanged () ``` 這是該信號的默認超載。當目前選擇的日期將被改變，這個信號被發射。當前選擇的日期可以由用戶使用鼠標或鍵盤來改變，或通過使用編程[setSelectedDate](qcalendarwidget.html#selectedDate-prop)（）。 **See also** [selectedDate](qcalendarwidget.html#selectedDate-prop)（）。