PyQt5 QCalendarWidget – 当前页面改变的信号

PyQt5是Python语言的GUI编程框架，提供了丰富的UI组件和常用的功能模块。QCalendarWidget是PyQt5中用于显示日历的组件。

当QCalendarWidget显示月历或年历时，用户可以通过翻页的方式来浏览其他月份或年份的日历。QCalendarWidget提供了currentPageChanged()信号，该信号会在当前页面改变时自动触发。本文将详细讲解如何使用“PyQt5 QCalendarWidget-当前页面改变的信号”。

1. 槽函数

在讲解信号的使用之前，我们需要先了解槽函数。在PyQt5中，槽函数是一种接受信号的Python函数。当信号被触发时，绑定的槽函数会自动被调用。

下面是槽函数的定义方式：

@pyqtSlot()
def slot_function(self):
    # 槽函数的具体实现

在定义槽函数时，要用@pyqtSlot()装饰器来标记函数是一个槽函数。这样做是为了告诉PyQt5，该函数需要在信号被触发时被调用。

2. 信号与槽函数的连接

在PyQt5中，信号与槽函数是通过connect()函数进行连接的。connect()函数的调用需要两个参数：一个是信号的发射者，另一个是槽函数。

下面是connect()函数的定义方式：

sender.sig_name.connect(receiver.slot_function_name)

在这个例子中，sender是信号的发射者，sig_name是信号的名称，receiver是槽函数的接收者，slot_function_name是槽函数的名称。

3. currentChanged()信号示例

现在我们来看看如何使用QCalendarWidget的currentChanged()信号。该信号在用户点击日历的某一天时触发。下面是一个示例：

from PyQt5.QtWidgets import QApplication, QMainWindow, QCalendarWidget
from PyQt5.QtCore import pyqtSlot

class MyWidget(QMainWindow):
    def __init__(self):
        super().__init__()
        self.calendar = QCalendarWidget(self)
        self.calendar.currentChanged.connect(self.show_date)
        self.setCentralWidget(self.calendar)

    @pyqtSlot()
    def show_date(self):
        selected_date = self.calendar.selectedDate()
        print(selected_date.toString('yyyy-MM-dd'))

if __name__ == '__main__':
    app = QApplication([])
    widget = MyWidget()
    widget.show()
    app.exec_()

在这个示例中，我们创建了一个QCalendarWidget，并将其设置为主窗口的中心部件。我们还定义了一个show_date()槽函数，用来在控制台上输出用户选中的日期。通过使用connect()函数，我们将calendar的currentChanged()信号连接到show_date()槽函数上。这样，在用户选择某一天时，show_date()槽函数就会被自动调用。

4. currentPageChanged()信号示例

在QCalendarWidget中，除了currentChanged()信号以外，还有一个与页面改变有关的信号，那就是currentPageChanged()信号。该信号在页面改变时自动触发。下面是一个使用currentPageChanged()信号的示例：

from PyQt5.QtWidgets import QApplication, QMainWindow, QCalendarWidget
from PyQt5.QtCore import pyqtSlot

class MyWidget(QMainWindow):
    def __init__(self):
        super().__init__()
        self.calendar = QCalendarWidget(self)
        self.calendar.currentPageChanged.connect(self.show_page)
        self.setCentralWidget(self.calendar)

    @pyqtSlot(int,int)
    def show_page(self, year, month):
        print(f'显示 {year} 年 {month} 月的日历')

if __name__ == '__main__':
    app = QApplication([])
    widget = MyWidget()
    widget.show()
    app.exec_()

在这个示例中，我们创建了一个QCalendarWidget，并将其设置为主窗口的中心部件。我们还定义了一个show_page()槽函数，用来在控制台上输出当前显示的年份和月份。通过使用connect()函数，我们将calendar的currentPageChanged()信号连接到show_page()槽函数上。这样，在用户翻页时，show_page()槽函数就会被自动调用。