QCalendarWidget Class

멤버 함수 설명서

[explicit] QCalendarWidget::QCalendarWidget(QWidget *parent = nullptr)

지정된 캘린더 뷰( parent)를 사용하여 캘린더 위젯을 생성합니다.

위젯은 현재 월과 연도로 초기화되며, 현재 선택된 날짜는 오늘입니다.

setCurrentPage()도 참조하십시오 .

[virtual noexcept] QCalendarWidget::~QCalendarWidget()

달력 위젯을 삭제합니다.

[signal] void QCalendarWidget::activated(QDate date)

사용자가 리턴(Return) 키나 엔터(Enter) 키를 누르거나, 캘린더 위젯에서 캘린더 항목( date )을 더블 클릭할 때마다 이 신호가 발생합니다.

QCalendar QCalendarWidget::calendar() const

이 위젯에서 사용 중인 캘린더 시스템을 보고하십시오.

setCalendar()도 참조하십시오 .

[signal] void QCalendarWidget::clicked(QDate date)

이 신호는 마우스 버튼을 클릭했을 때 발생합니다. 마우스가 클릭된 날짜는 ` date`로 지정됩니다. 이 신호는 유효한 날짜를 클릭했을 때만 발생하며, 예를 들어 날짜가 ` minimumDate()` 및 ` maximumDate()` 범위를 벗어나지 않아야 합니다. 선택 모드가 ` NoSelection`인 경우, 이 신호는 발생하지 않습니다.

[signal] void QCalendarWidget::currentPageChanged(int year, int month)

현재 표시 중인 월이 변경되면 이 신호가 발생합니다. 새로운 year 및 month 가 매개변수로 전달됩니다.

setCurrentPage()도 참조하십시오 .

QMap<QDate, QTextCharFormat> QCalendarWidget::dateTextFormat() const

QDate 에서 QTextCharFormat 로 이동하는 ‘ QMap ’을 반환하며, 렌더링 방식이 변경되는 특수 형식을 사용하는 모든 날짜를 표시합니다.

setDateTextFormat()도 참조하십시오 .

QTextCharFormat QCalendarWidget::dateTextFormat(QDate date) const

date 에 대한 ` QTextCharFormat `을 반환합니다. 날짜가 특별한 방식으로 표시되지 않는 경우, `char` 형식은 비어 있을 수 있습니다.

[override virtual protected] bool QCalendarWidget::event(QEvent *event)

QWidget::event(QEvent *event)를 재구현합니다.

[override virtual protected] bool QCalendarWidget::eventFilter(QObject *watched, QEvent *event)

QObject::eventFilter(QObject *watched, QEvent *event)를 재구현합니다.

QTextCharFormat QCalendarWidget::headerTextFormat() const

헤더를 렌더링하기 위한 텍스트 문자 형식을 반환합니다.

setHeaderTextFormat()도 참조하십시오 .

[override virtual protected] void QCalendarWidget::keyPressEvent(QKeyEvent *event)

QWidget::keyPressEvent(QKeyEvent *event)를 재구현합니다.

[override virtual] QSize QCalendarWidget::minimumSizeHint() const

QWidget::minimumSizeHint 속성에 대한 액세스 함수를 재구현합니다.

int QCalendarWidget::monthShown() const

현재 표시된 월을 반환합니다. 월은 1부터 12까지 번호가 매겨집니다.

yearShown() 및 setCurrentPage()도 참조하십시오 .

[override virtual protected] void QCalendarWidget::mousePressEvent(QMouseEvent *event)

QWidget::mousePressEvent(QMouseEvent *event)를 재구현합니다.

[virtual protected] void QCalendarWidget::paintCell(QPainter *painter, const QRect &rect, QDate date) const

주어진 ` date`로 지정된 셀을, 주어진 ` painter ` 및 ` rect`를 사용하여 채색합니다.

[override virtual protected] void QCalendarWidget::resizeEvent(QResizeEvent *event)

QWidget::resizeEvent(QResizeEvent *event)을 재구현합니다.

[signal] void QCalendarWidget::selectionChanged()

이 신호는 현재 선택된 날짜가 변경될 때 발생합니다.

현재 선택된 날짜는 사용자가 마우스나 키보드를 사용하여 변경하거나, 프로그래머가 setSelectedDate()를 사용하여 변경할 수 있습니다.

selectedDate()도 참조하십시오 .

void QCalendarWidget::setCalendar(QCalendar c)

이 위젯에서 사용할 달력 시스템으로 ‘ c ’를 설정하십시오.

이 위젯은 지원되는 모든 달력 시스템을 사용할 수 있습니다. 기본적으로 그레고리력을 사용합니다.

calendar()도 참조하십시오 .

[slot] void QCalendarWidget::setCurrentPage(int year, int month)

선택된 날짜를 변경하지 않고, 지정된 year 의 month 을 표시합니다. 선택된 날짜를 변경하려면 setSelectedDate() 함수를 사용하십시오.

현재 표시된 월과 연도는 각각 monthShown() 및 yearShown() 함수를 사용하여 가져올 수 있습니다.

yearShown(), monthShown(), showPreviousMonth(), showNextMonth(), showPreviousYear() 및 showNextYear()도 참조하십시오 .

[slot] void QCalendarWidget::setDateRange(QDate min, QDate max)

minimumDate 및 maximumDate 속성을 설정하여 날짜 범위를 정의합니다.

이 날짜 범위는 사용자의 선택을 제한합니다. 즉, 사용자는 지정된 날짜 범위 내의 날짜만 선택할 수 있습니다. 참고로

QCalendarWidget *calendar;

calendar->setDateRange(min, max);

다음과 유사합니다.

QCalendarWidget *calendar;

calendar->setMinimumDate(min);
calendar->setMaximumDate(max);

min 또는 max 매개변수 중 하나라도 유효한 QDate 객체가 아닌 경우, 이 함수는 아무 작업도 수행하지 않습니다.

setMinimumDate() 및 setMaximumDate()도 참조하십시오 .

void QCalendarWidget::setDateTextFormat(QDate date, const QTextCharFormat &format)

지정된 ` date `을 렌더링하는 데 사용되는 형식을 ` format`에 지정된 형식으로 설정합니다.

date 가 null인 경우, 모든 날짜 형식이 초기화됩니다.

dateTextFormat()도 참조하십시오 .

void QCalendarWidget::setHeaderTextFormat(const QTextCharFormat &format)

헤더를 렌더링할 때 사용할 텍스트 문자 서식을 format 로 설정합니다. 요일 텍스트 서식도 함께 설정한 경우, 이 서식의 전경색과 배경색이 헤더 서식보다 우선 적용됩니다. 그 외의 서식 정보는 여전히 헤더 서식에 따라 결정됩니다.

headerTextFormat()도 참조하십시오 .

void QCalendarWidget::setWeekdayTextFormat(Qt::DayOfWeek dayOfWeek, const QTextCharFormat &format)

요일 dayOfWeek 을 format 로 표시할 때의 텍스트 문자 서식을 설정합니다. 전경색 및 배경색의 경우, 이 서식이 헤더 서식보다 우선 적용됩니다. 그 외의 텍스트 서식 정보는 헤더 서식에서 가져옵니다.

weekdayTextFormat() 및 setHeaderTextFormat()도 참조하십시오 .

[slot] void QCalendarWidget::showNextMonth()

현재 표시된 달을 기준으로 다음 달을 표시합니다. 선택된 날짜는 변경되지 않는다는 점에 유의하십시오.

showPreviousMonth(), setCurrentPage() 및 setSelectedDate()도 참조하십시오 .

[slot] void QCalendarWidget::showNextYear()

현재 표시된 연도를 기준으로, 다음 해에 해당하는 현재 표시된 월을 보여줍니다. 선택된 날짜는 변경되지 않는다는 점에 유의하십시오.

showPreviousYear(), setCurrentPage(), setSelectedDate()도 참조하십시오 .

[slot] void QCalendarWidget::showPreviousMonth()

현재 표시된 달을 기준으로 전월을 보여줍니다. 선택된 날짜는 변경되지 않는다는 점에 유의하십시오.

showNextMonth(), setCurrentPage() 및 setSelectedDate()도 참조하십시오 .

[slot] void QCalendarWidget::showPreviousYear()

현재 표시된 연도를 기준으로, 전년도에 해당하는 현재 표시된 월을 보여줍니다. 단, 선택된 날짜는 변경되지 않습니다.

showNextYear(), setCurrentPage() 및 setSelectedDate()도 참조하십시오 .

[slot] void QCalendarWidget::showSelectedDate()

선택한 날짜의 월을 표시합니다.

selectedDate() 및 setCurrentPage()도 참조하십시오 .

[slot] void QCalendarWidget::showToday()

오늘 날짜의 월을 표시합니다.

selectedDate() 및 setCurrentPage()도 참조하십시오 .

[override virtual] QSize QCalendarWidget::sizeHint() const

QWidget::sizeHint 속성에 대한 액세스 함수를 재구현합니다.

[protected] void QCalendarWidget::updateCell(QDate date)

업데이트가 비활성화되어 있거나 셀이 숨겨져 있지 않은 한, 지정된 date 에 따라 셀을 업데이트합니다.

updateCells(), yearShown(), monthShown()도 참조하십시오 .

[protected] void QCalendarWidget::updateCells()

업데이트가 비활성화되어 있지 않은 한, 표시된 모든 셀을 업데이트합니다.

updateCell()도 참조하십시오 .

QTextCharFormat QCalendarWidget::weekdayTextFormat(Qt::DayOfWeek dayOfWeek) const

요일의 날짜를 표시하기 위한 텍스트 문자 형식을 반환합니다. dayOfWeek.

setWeekdayTextFormat() 및 headerTextFormat()도 참조하십시오 .

int QCalendarWidget::yearShown() const

현재 표시된 달의 연도를 반환합니다. 달은 1부터 12까지 번호가 매겨집니다.

monthShown() 및 setCurrentPage()도 참조하십시오 .