Inheritance diagram for Digikam::DDateTable:

Classes
class	Private

Public Types
enum	BackgroundMode { NoBgMode = 0 , RectangleMode , CircleMode }

Signals
void	aboutToShowContextMenu (QMenu *menu, const QDate &dt)

void	dateChanged (const QDate &cur, const QDate &old)

void	dateChanged (const QDate &date)

void	tableClicked ()

Public Member Functions
const QDate &	date () const

	DDateTable (const QDate &dt, QWidget *const parent=nullptr)

	DDateTable (QWidget *const parent=nullptr)

bool	popupMenuEnabled () const

void	setCustomDatePainting (const QDate &date, const QColor &fgColor, BackgroundMode bgMode=NoBgMode, const QColor &bgColor=QColor())

bool	setDate (const QDate &date)

void	setFontSize (int size)

void	setPopupMenuEnabled (bool enable)

QSize	sizeHint () const override

void	unsetCustomDatePainting (const QDate &dt)

	~DDateTable () override

Protected Member Functions
virtual QDate	dateFromPos (int pos)

bool	event (QEvent *e) override

void	focusInEvent (QFocusEvent *e) override

void	focusOutEvent (QFocusEvent *e) override

void	keyPressEvent (QKeyEvent *e) override

void	mousePressEvent (QMouseEvent *e) override

void	paintEvent (QPaintEvent *e) override

virtual int	posFromDate (const QDate &dt)

void	wheelEvent (QWheelEvent *e) override

Properties
QDate	date

bool	popupMenu

Friends
class	Private

Detailed Description

This is a support class for the DDatePicker class. It just draws the calendar table without titles, but could theoretically be used as a standalone.

When a date is selected by the user, it emits a signal: dateSelected(QDate)

Member Enumeration Documentation

◆ BackgroundMode

enum Digikam::DDateTable::BackgroundMode

Enumerator
NoBgMode
RectangleMode
CircleMode

Constructor & Destructor Documentation

◆ DDateTable() [1/2]

Digikam::DDateTable::DDateTable ( QWidget *const parent = nullptr )

explicit

◆ DDateTable() [2/2]

Digikam::DDateTable::DDateTable	(	const QDate &	dt,
		QWidget *const	parent = `nullptr`
	)

explicit

References date.

◆ ~DDateTable()

Digikam::DDateTable::~DDateTable ( )

override

Member Function Documentation

◆ aboutToShowContextMenu

void Digikam::DDateTable::aboutToShowContextMenu	(	QMenu *	menu,
		const QDate &	dt
	)

signal

A popup menu for a given date is about to be shown (as when the user right clicks on that date and the popup menu is enabled). Connect the slot where you fill the menu to this signal.

Referenced by mousePressEvent().

◆ date()

const QDate & Digikam::DDateTable::date ( ) const

Returns: the selected date.

References Digikam::DDateTable::Private::date.

◆ dateChanged [1/2]

void Digikam::DDateTable::dateChanged	(	const QDate &	cur,
		const QDate &	old
	)

signal

This function behaves essentially like the one above. The selected date changed.

Parameters

cur	The current date
old	The date before the date was changed

◆ dateChanged [2/2]

void Digikam::DDateTable::dateChanged ( const QDate & date )

signal

The selected date changed.

Referenced by setDate().

◆ dateFromPos()

QDate Digikam::DDateTable::dateFromPos ( int pos )

protectedvirtual

calculate the date that is displayed at a given cell in the matrix. pos is the 0-based index in the matrix. Inverse function to posForDate().

References Digikam::DDateTable::Private::date, DigikamGenericINatPlugin::locale, Digikam::DDateTable::Private::numDayColumns, and Digikam::DDateTable::Private::weekDayFirstOfMonth.

Referenced by mousePressEvent().

◆ event()

bool Digikam::DDateTable::event ( QEvent * e )

overrideprotected

Cell highlight on mouse hovering

References Digikam::DDateTable::Private::hoveredPos, Digikam::DDateTable::Private::numDayColumns, and Digikam::DDateTable::Private::numWeekRows.

◆ focusInEvent()

void Digikam::DDateTable::focusInEvent ( QFocusEvent * e )

overrideprotected

◆ focusOutEvent()

void Digikam::DDateTable::focusOutEvent ( QFocusEvent * e )

overrideprotected

◆ keyPressEvent()

void Digikam::DDateTable::keyPressEvent ( QKeyEvent * e )

overrideprotected

References Digikam::DDateTable::Private::date, Digikam::DDateTable::Private::numDayColumns, setDate(), and tableClicked().

◆ mousePressEvent()

void Digikam::DDateTable::mousePressEvent ( QMouseEvent * e )

overrideprotected

React on mouse clicks that select a date.

References aboutToShowContextMenu(), Digikam::DDateTable::Private::date, dateFromPos(), DigikamGenericINatPlugin::locale, Digikam::DDateTable::Private::numDayColumns, Digikam::DDateTable::Private::numWeekRows, Digikam::DDateTable::Private::popupMenuEnabled, setDate(), and tableClicked().

◆ paintEvent()

void Digikam::DDateTable::paintEvent ( QPaintEvent * e )

overrideprotected

References Digikam::DDateTable::Private::numDayColumns, and Digikam::DDateTable::Private::numWeekRows.

◆ popupMenuEnabled()

bool Digikam::DDateTable::popupMenuEnabled ( ) const

Returns if the popup menu is enabled or not

References Digikam::DDateTable::Private::popupMenuEnabled.

◆ posFromDate()

int Digikam::DDateTable::posFromDate ( const QDate & dt )

protectedvirtual

calculate the position of the cell in the matrix for the given date. The result is the 0-based index.

References date, DigikamGenericINatPlugin::locale, Digikam::DDateTable::Private::numDayColumns, and Digikam::DDateTable::Private::weekDayFirstOfMonth.

◆ setCustomDatePainting()

void Digikam::DDateTable::setCustomDatePainting	(	const QDate &	date,
		const QColor &	fgColor,
		BackgroundMode	bgMode = `NoBgMode`,
		const QColor &	bgColor = `QColor()`
	)

Makes a given date be painted with a given foregroundColor, and background (a rectangle, or a circle/ellipse) in a given color.

References Digikam::DDateTable::Private::DatePaintingMode::bgColor, Digikam::DDateTable::Private::DatePaintingMode::bgMode, Digikam::DDateTable::Private::customPaintingModes, date, Digikam::DDateTable::Private::DatePaintingMode::fgColor, unsetCustomDatePainting(), and Digikam::DDateTable::Private::useCustomColors.

◆ setDate()

bool Digikam::DDateTable::setDate ( const QDate & date )

Select and display this date.

References date, dateChanged(), and Digikam::DDateTable::Private::setDate().

Referenced by keyPressEvent(), mousePressEvent(), Digikam::DDatePicker::setDate(), and wheelEvent().

◆ setFontSize()

void Digikam::DDateTable::setFontSize ( int size )

Set the font size of the date table.

References Digikam::DDateTable::Private::fontsize, DigikamGenericINatPlugin::locale, and Digikam::DDateTable::Private::maxCell.

Referenced by Digikam::DDatePicker::setFontSize().

◆ setPopupMenuEnabled()

void Digikam::DDateTable::setPopupMenuEnabled ( bool enable )

Enables a popup menu when right clicking on a date.

When it's enabled, this object emits a aboutToShowContextMenu signal where you can fill in the menu items.

References Digikam::DDateTable::Private::popupMenuEnabled.

◆ sizeHint()

QSize Digikam::DDateTable::sizeHint ( ) const

override

Returns a recommended size for the widget. To save some time, the size of the largest used cell content is calculated in each paintCell() call, since all calculations have to be done there anyway. The size is stored in maxCell. The sizeHint() simply returns a multiple of maxCell.

References Digikam::DDateTable::Private::maxCell, Digikam::DDateTable::Private::numDayColumns, and Digikam::DDateTable::Private::numWeekRows.

◆ tableClicked

void Digikam::DDateTable::tableClicked ( )

signal

A date has been selected by clicking on the table.

Referenced by keyPressEvent(), and mousePressEvent().

◆ unsetCustomDatePainting()

void Digikam::DDateTable::unsetCustomDatePainting ( const QDate & dt )

Unsets the custom painting of a date so that the date is painted as usual.

References Digikam::DDateTable::Private::customPaintingModes, date, and Digikam::DDateTable::Private::useCustomColors.

Referenced by setCustomDatePainting().

◆ wheelEvent()

void Digikam::DDateTable::wheelEvent ( QWheelEvent * e )

overrideprotected

References Digikam::DDateTable::Private::date, and setDate().

Friends And Related Function Documentation

◆ Private

friend class Private

friend

Property Documentation

◆ date

QDate Digikam::DDateTable::date

readwrite

Referenced by Digikam::DDateTable::Private::beginningOfMonth(), Digikam::DDateTable::Private::beginningOfWeek(), Digikam::DDatePicker::date(), DDateTable(), Digikam::DDateTable::Private::endOfMonth(), Digikam::DDateTable::Private::endOfWeek(), Digikam::DDateTable::Private::nextMonth(), posFromDate(), Digikam::DDateTable::Private::previousMonth(), setCustomDatePainting(), Digikam::DDateTable::Private::setDate(), setDate(), unsetCustomDatePainting(), Digikam::DDatePicker::yearBackwardClicked(), and Digikam::DDatePicker::yearForwardClicked().

◆ popupMenu

bool Digikam::DDateTable::popupMenu

readwrite

The documentation for this class was generated from the following files:

core/app/date/ddatetable.h
core/app/date/ddatetable.cpp

Classes

Public Types

Signals

Public Member Functions

Protected Member Functions

Properties

Friends

Detailed Description

Member Enumeration Documentation

◆ BackgroundMode

Constructor & Destructor Documentation

◆ DDateTable() [1/2]

◆ DDateTable() [2/2]

◆ ~DDateTable()

Member Function Documentation

◆ aboutToShowContextMenu

◆ date()

◆ dateChanged [1/2]

◆ dateChanged [2/2]

◆ dateFromPos()

◆ event()

◆ focusInEvent()

◆ focusOutEvent()

◆ keyPressEvent()

◆ mousePressEvent()

◆ paintEvent()

◆ popupMenuEnabled()

◆ posFromDate()

◆ setCustomDatePainting()

◆ setDate()

◆ setFontSize()

◆ setPopupMenuEnabled()

◆ sizeHint()

◆ tableClicked

◆ unsetCustomDatePainting()

◆ wheelEvent()

Friends And Related Function Documentation

◆ Private

Property Documentation

◆ date

◆ popupMenu