PerceptualColor::AbstractDiagram
#include <abstractdiagram.h>
Public Member Functions | |
Q_INVOKABLE | AbstractDiagram (QWidget *parent=nullptr) |
virtual | ~AbstractDiagram () noexcept override |
Public Member Functions inherited from QWidget | |
QWidget (QWidget *parent, Qt::WindowFlags f) | |
bool | acceptDrops () const const |
QString | accessibleDescription () const const |
QString | accessibleName () const const |
QList< QAction * > | actions () const const |
void | activateWindow () |
QAction * | addAction (const QIcon &icon, const QString &text) |
QAction * | addAction (const QIcon &icon, const QString &text, Args &&... args) |
QAction * | addAction (const QIcon &icon, const QString &text, const QKeySequence &shortcut) |
QAction * | addAction (const QIcon &icon, const QString &text, const QKeySequence &shortcut, Args &&... args) |
QAction * | addAction (const QIcon &icon, const QString &text, const QKeySequence &shortcut, const QObject *receiver, const char *member, Qt::ConnectionType type) |
QAction * | addAction (const QIcon &icon, const QString &text, const QObject *receiver, const char *member, Qt::ConnectionType type) |
QAction * | addAction (const QString &text) |
QAction * | addAction (const QString &text, Args &&... args) |
QAction * | addAction (const QString &text, const QKeySequence &shortcut) |
QAction * | addAction (const QString &text, const QKeySequence &shortcut, Args &&... args) |
QAction * | addAction (const QString &text, const QKeySequence &shortcut, const QObject *receiver, const char *member, Qt::ConnectionType type) |
QAction * | addAction (const QString &text, const QObject *receiver, const char *member, Qt::ConnectionType type) |
void | addAction (QAction *action) |
void | addActions (const QList< QAction * > &actions) |
void | adjustSize () |
bool | autoFillBackground () const const |
QPalette::ColorRole | backgroundRole () const const |
QBackingStore * | backingStore () const const |
QSize | baseSize () const const |
QWidget * | childAt (const QPoint &p) const const |
QWidget * | childAt (int x, int y) const const |
QRect | childrenRect () const const |
QRegion | childrenRegion () const const |
void | clearFocus () |
void | clearMask () |
bool | close () |
QMargins | contentsMargins () const const |
QRect | contentsRect () const const |
Qt::ContextMenuPolicy | contextMenuPolicy () const const |
QCursor | cursor () const const |
void | customContextMenuRequested (const QPoint &pos) |
WId | effectiveWinId () const const |
void | ensurePolished () const const |
Qt::FocusPolicy | focusPolicy () const const |
QWidget * | focusProxy () const const |
QWidget * | focusWidget () const const |
const QFont & | font () const const |
QFontInfo | fontInfo () const const |
QFontMetrics | fontMetrics () const const |
QPalette::ColorRole | foregroundRole () const const |
QRect | frameGeometry () const const |
QSize | frameSize () const const |
const QRect & | geometry () const const |
QPixmap | grab (const QRect &rectangle) |
void | grabGesture (Qt::GestureType gesture, Qt::GestureFlags flags) |
void | grabKeyboard () |
void | grabMouse () |
void | grabMouse (const QCursor &cursor) |
int | grabShortcut (const QKeySequence &key, Qt::ShortcutContext context) |
QGraphicsEffect * | graphicsEffect () const const |
QGraphicsProxyWidget * | graphicsProxyWidget () const const |
bool | hasEditFocus () const const |
bool | hasFocus () const const |
virtual bool | hasHeightForWidth () const const |
bool | hasMouseTracking () const const |
bool | hasTabletTracking () const const |
int | height () const const |
virtual int | heightForWidth (int w) const const |
void | hide () |
Qt::InputMethodHints | inputMethodHints () const const |
virtual QVariant | inputMethodQuery (Qt::InputMethodQuery query) const const |
void | insertAction (QAction *before, QAction *action) |
void | insertActions (QAction *before, const QList< QAction * > &actions) |
bool | isActiveWindow () const const |
bool | isAncestorOf (const QWidget *child) const const |
bool | isEnabled () const const |
bool | isEnabledTo (const QWidget *ancestor) const const |
bool | isFullScreen () const const |
bool | isHidden () const const |
bool | isMaximized () const const |
bool | isMinimized () const const |
bool | isModal () const const |
bool | isTopLevel () const const |
bool | isVisible () const const |
bool | isVisibleTo (const QWidget *ancestor) const const |
bool | isWindow () const const |
bool | isWindowModified () const const |
QLayout * | layout () const const |
Qt::LayoutDirection | layoutDirection () const const |
QLocale | locale () const const |
void | lower () |
QPoint | mapFrom (const QWidget *parent, const QPoint &pos) const const |
QPointF | mapFrom (const QWidget *parent, const QPointF &pos) const const |
QPoint | mapFromGlobal (const QPoint &pos) const const |
QPointF | mapFromGlobal (const QPointF &pos) const const |
QPoint | mapFromParent (const QPoint &pos) const const |
QPointF | mapFromParent (const QPointF &pos) const const |
QPoint | mapTo (const QWidget *parent, const QPoint &pos) const const |
QPointF | mapTo (const QWidget *parent, const QPointF &pos) const const |
QPoint | mapToGlobal (const QPoint &pos) const const |
QPointF | mapToGlobal (const QPointF &pos) const const |
QPoint | mapToParent (const QPoint &pos) const const |
QPointF | mapToParent (const QPointF &pos) const const |
QRegion | mask () const const |
int | maximumHeight () const const |
QSize | maximumSize () const const |
int | maximumWidth () const const |
int | minimumHeight () const const |
QSize | minimumSize () const const |
virtual QSize | minimumSizeHint () const const |
int | minimumWidth () const const |
void | move (const QPoint &) |
void | move (int x, int y) |
QWidget * | nativeParentWidget () const const |
QWidget * | nextInFocusChain () const const |
QRect | normalGeometry () const const |
void | overrideWindowFlags (Qt::WindowFlags flags) |
virtual QPaintEngine * | paintEngine () const const override |
const QPalette & | palette () const const |
QWidget * | parentWidget () const const |
QPoint | pos () const const |
QWidget * | previousInFocusChain () const const |
QWIDGETSIZE_MAX QWIDGETSIZE_MAX | |
void | raise () |
QRect | rect () const const |
void | releaseKeyboard () |
void | releaseMouse () |
void | releaseShortcut (int id) |
void | removeAction (QAction *action) |
void | render (QPaintDevice *target, const QPoint &targetOffset, const QRegion &sourceRegion, RenderFlags renderFlags) |
void | render (QPainter *painter, const QPoint &targetOffset, const QRegion &sourceRegion, RenderFlags renderFlags) |
void | repaint () |
void | repaint (const QRect &rect) |
void | repaint (const QRegion &rgn) |
void | repaint (int x, int y, int w, int h) |
void | resize (const QSize &) |
void | resize (int w, int h) |
bool | restoreGeometry (const QByteArray &geometry) |
QByteArray | saveGeometry () const const |
QScreen * | screen () const const |
void | scroll (int dx, int dy) |
void | scroll (int dx, int dy, const QRect &r) |
void | setAcceptDrops (bool on) |
void | setAccessibleDescription (const QString &description) |
void | setAccessibleName (const QString &name) |
void | setAttribute (Qt::WidgetAttribute attribute, bool on) |
void | setAutoFillBackground (bool enabled) |
void | setBackgroundRole (QPalette::ColorRole role) |
void | setBaseSize (const QSize &) |
void | setBaseSize (int basew, int baseh) |
void | setContentsMargins (const QMargins &margins) |
void | setContentsMargins (int left, int top, int right, int bottom) |
void | setContextMenuPolicy (Qt::ContextMenuPolicy policy) |
void | setCursor (const QCursor &) |
void | setDisabled (bool disable) |
void | setEditFocus (bool enable) |
void | setEnabled (bool) |
void | setFixedHeight (int h) |
void | setFixedSize (const QSize &s) |
void | setFixedSize (int w, int h) |
void | setFixedWidth (int w) |
void | setFocus () |
void | setFocus (Qt::FocusReason reason) |
void | setFocusPolicy (Qt::FocusPolicy policy) |
void | setFocusProxy (QWidget *w) |
void | setFont (const QFont &) |
void | setForegroundRole (QPalette::ColorRole role) |
void | setGeometry (const QRect &) |
void | setGeometry (int x, int y, int w, int h) |
void | setGraphicsEffect (QGraphicsEffect *effect) |
void | setHidden (bool hidden) |
void | setInputMethodHints (Qt::InputMethodHints hints) |
void | setLayout (QLayout *layout) |
void | setLayoutDirection (Qt::LayoutDirection direction) |
void | setLocale (const QLocale &locale) |
void | setMask (const QBitmap &bitmap) |
void | setMask (const QRegion ®ion) |
void | setMaximumHeight (int maxh) |
void | setMaximumSize (const QSize &) |
void | setMaximumSize (int maxw, int maxh) |
void | setMaximumWidth (int maxw) |
void | setMinimumHeight (int minh) |
void | setMinimumSize (const QSize &) |
void | setMinimumSize (int minw, int minh) |
void | setMinimumWidth (int minw) |
void | setMouseTracking (bool enable) |
void | setPalette (const QPalette &) |
void | setParent (QWidget *parent) |
void | setParent (QWidget *parent, Qt::WindowFlags f) |
void | setScreen (QScreen *screen) |
void | setShortcutAutoRepeat (int id, bool enable) |
void | setShortcutEnabled (int id, bool enable) |
void | setSizeIncrement (const QSize &) |
void | setSizeIncrement (int w, int h) |
void | setSizePolicy (QSizePolicy) |
void | setSizePolicy (QSizePolicy::Policy horizontal, QSizePolicy::Policy vertical) |
void | setStatusTip (const QString &) |
void | setStyle (QStyle *style) |
void | setStyleSheet (const QString &styleSheet) |
void | setTabletTracking (bool enable) |
void | setToolTip (const QString &) |
void | setToolTipDuration (int msec) |
void | setUpdatesEnabled (bool enable) |
void | setupUi (QWidget *widget) |
virtual void | setVisible (bool visible) |
void | setWhatsThis (const QString &) |
void | setWindowFilePath (const QString &filePath) |
void | setWindowFlag (Qt::WindowType flag, bool on) |
void | setWindowFlags (Qt::WindowFlags type) |
void | setWindowIcon (const QIcon &icon) |
void | setWindowIconText (const QString &) |
void | setWindowModality (Qt::WindowModality windowModality) |
void | setWindowModified (bool) |
void | setWindowOpacity (qreal level) |
void | setWindowRole (const QString &role) |
void | setWindowState (Qt::WindowStates windowState) |
void | setWindowTitle (const QString &) |
void | show () |
void | showFullScreen () |
void | showMaximized () |
void | showMinimized () |
void | showNormal () |
QSize | size () const const |
virtual QSize | sizeHint () const const |
QSize | sizeIncrement () const const |
QSizePolicy | sizePolicy () const const |
void | stackUnder (QWidget *w) |
QString | statusTip () const const |
QStyle * | style () const const |
QString | styleSheet () const const |
bool | testAttribute (Qt::WidgetAttribute attribute) const const |
QString | toolTip () const const |
int | toolTipDuration () const const |
QWidget * | topLevelWidget () const const |
bool | underMouse () const const |
void | ungrabGesture (Qt::GestureType gesture) |
void | unsetCursor () |
void | unsetLayoutDirection () |
void | unsetLocale () |
void | update () |
void | update (const QRect &rect) |
void | update (const QRegion &rgn) |
void | update (int x, int y, int w, int h) |
void | updateGeometry () |
bool | updatesEnabled () const const |
QRegion | visibleRegion () const const |
QString | whatsThis () const const |
int | width () const const |
QWidget * | window () const const |
QString | windowFilePath () const const |
Qt::WindowFlags | windowFlags () const const |
QWindow * | windowHandle () const const |
QIcon | windowIcon () const const |
void | windowIconChanged (const QIcon &icon) |
QString | windowIconText () const const |
void | windowIconTextChanged (const QString &iconText) |
Qt::WindowModality | windowModality () const const |
qreal | windowOpacity () const const |
QString | windowRole () const const |
Qt::WindowStates | windowState () const const |
QString | windowTitle () const const |
void | windowTitleChanged (const QString &title) |
Qt::WindowType | windowType () const const |
WId | winId () const const |
int | x () const const |
int | y () const const |
Public Member Functions inherited from QObject | |
QObject (QObject *parent) | |
QBindable< QString > | bindableObjectName () |
bool | blockSignals (bool block) |
const QObjectList & | children () const const |
QMetaObject::Connection | connect (const QObject *sender, const char *signal, const char *method, Qt::ConnectionType type) const const |
void | deleteLater () |
void | destroyed (QObject *obj) |
bool | disconnect (const char *signal, const QObject *receiver, const char *method) const const |
bool | disconnect (const QObject *receiver, const char *method) const const |
void | dumpObjectInfo () const const |
void | dumpObjectTree () const const |
QList< QByteArray > | dynamicPropertyNames () const const |
virtual bool | eventFilter (QObject *watched, QEvent *event) |
T | findChild (const QString &name, Qt::FindChildOptions options) const const |
QList< T > | findChildren (const QRegularExpression &re, Qt::FindChildOptions options) const const |
QList< T > | findChildren (const QString &name, Qt::FindChildOptions options) const const |
QList< T > | findChildren (Qt::FindChildOptions options) const const |
bool | inherits (const char *className) const const |
void | installEventFilter (QObject *filterObj) |
bool | isQuickItemType () const const |
bool | isWidgetType () const const |
bool | isWindowType () const const |
void | killTimer (int id) |
virtual const QMetaObject * | metaObject () const const |
void | moveToThread (QThread *targetThread) |
QString | objectName () const const |
void | objectNameChanged (const QString &objectName) |
QObject * | parent () const const |
QVariant | property (const char *name) const const |
Q_CLASSINFO (Name, Value) | |
Q_EMIT Q_EMIT | |
Q_ENUM (...) | |
Q_ENUM_NS (...) | |
Q_ENUMS (...) | |
Q_FLAG (...) | |
Q_FLAG_NS (...) | |
Q_FLAGS (...) | |
Q_GADGET Q_GADGET | |
Q_GADGET_EXPORT (EXPORT_MACRO) | |
Q_INTERFACES (...) | |
Q_INVOKABLE Q_INVOKABLE | |
Q_MOC_INCLUDE Q_MOC_INCLUDE | |
Q_NAMESPACE Q_NAMESPACE | |
Q_NAMESPACE_EXPORT (EXPORT_MACRO) | |
Q_OBJECT Q_OBJECT | |
Q_PROPERTY (...) | |
Q_REVISION Q_REVISION | |
Q_SET_OBJECT_NAME (Object) | |
Q_SIGNAL Q_SIGNAL | |
Q_SIGNALS Q_SIGNALS | |
Q_SLOT Q_SLOT | |
Q_SLOTS Q_SLOTS | |
T | qobject_cast (const QObject *object) |
T | qobject_cast (QObject *object) |
QT_NO_NARROWING_CONVERSIONS_IN_CONNECT QT_NO_NARROWING_CONVERSIONS_IN_CONNECT | |
void | removeEventFilter (QObject *obj) |
void | setObjectName (const QString &name) |
void | setObjectName (QAnyStringView name) |
void | setParent (QObject *parent) |
bool | setProperty (const char *name, const QVariant &value) |
bool | setProperty (const char *name, QVariant &&value) |
bool | signalsBlocked () const const |
int | startTimer (int interval, Qt::TimerType timerType) |
int | startTimer (std::chrono::milliseconds interval, Qt::TimerType timerType) |
QThread * | thread () const const |
Public Member Functions inherited from QPaintDevice | |
int | colorCount () const const |
int | depth () const const |
qreal | devicePixelRatio () const const |
qreal | devicePixelRatioF () const const |
int | height () const const |
int | heightMM () const const |
int | logicalDpiX () const const |
int | logicalDpiY () const const |
bool | paintingActive () const const |
int | physicalDpiX () const const |
int | physicalDpiY () const const |
int | width () const const |
int | widthMM () const const |
Detailed Description
Base class for LCH diagrams.
Provides some elements that are common for all LCH diagrams in this library.
Definition at line 58 of file abstractdiagram.h.
Constructor & Destructor Documentation
◆ AbstractDiagram()
|
explicit |
The constructor.
- Parameters
-
parent The widget’s parent widget. This parameter will be passed to the base class’s constructor.
Definition at line 28 of file abstractdiagram.cpp.
◆ ~AbstractDiagram()
|
overridevirtualnoexcept |
Member Function Documentation
◆ actualVisibilityToggledEvent()
|
protectedvirtual |
Event occurring after isActuallyVisible has been toggled.
This function is called if and only if isActuallyVisible has actually been toggled.
Definition at line 275 of file abstractdiagram.cpp.
◆ callUpdate()
|
protected |
An alternative to QWidget::update().
It’s a workaround that avoids trouble with overload resolution.
Connecting a signal to the slot QWidget::update()
is surprisingly difficult, at least if you want to use the functor syntax (which provides compile-time checks) for the connection. A simple connection fails to compile because it fails to do a correct overload resolution, as there is more than one slot called update
. Now, qOverload<>()
can be used to choose the correct overload, but in this special case, qOverload<>()
generates compiler warnings.
Instead of connecting to QWidget::update()
directly, simply connect to this slot instead. It calls the actual QWidget::update()
, but avoids the annoyance with the overload resolution
Definition at line 335 of file abstractdiagram.cpp.
◆ focusIndicatorColor()
|
nodiscardprotected |
The color for painting focus indicators.
- Returns
- The color for painting focus indicators. This color is based on the current widget style at the moment this function is called. The value might therefore be different on the next function call, if the widget style has been switched by the user in the meantime.
- Note
- As there is no build-in support in Qt to get this information, we have to do some best guess, which might go wrong on some styles.
Definition at line 46 of file abstractdiagram.cpp.
◆ gradientMinimumLength()
|
nodiscardprotected |
The minimum length of a color gradient.
This is the minimum length of a one-dimensional gradient, for example in a slider or a color wheel. This is also the minimum width and minimum height of two-dimensional gradients.
- Returns
- The length of a gradient, measured in device-independent pixels.
- See also
- gradientThickness()
Definition at line 209 of file abstractdiagram.cpp.
◆ gradientThickness()
|
nodiscardprotected |
The thickness of a color gradient.
This is the thickness of a one-dimensional gradient, for example in a slider or a color wheel.
- Returns
- The thickness of a slider or a color wheel, measured in device-independent pixels.
- See also
- gradientMinimumLength()
Definition at line 184 of file abstractdiagram.cpp.
◆ handleColorFromBackgroundLightness()
|
nodiscardprotected |
An appropriate color for a handle, depending on the background lightness.
- Parameters
-
lightness The background lightness. Valid range: [0, 100]
.
- Returns
- An appropriate color for a handle. This color will provide contrast to the background.
Definition at line 244 of file abstractdiagram.cpp.
◆ handleOutlineThickness()
|
nodiscardprotected |
The outline thickness of a handle.
- Returns
- The outline thickness of a (either circular or linear) handle. Measured in device-independent pixels.
- Note
- The return value is constant. For a given object instance, this function returns the same value every time it is called. This constant value may be different for different instances of the object.
Definition at line 156 of file abstractdiagram.cpp.
◆ handleRadius()
|
nodiscardprotected |
The radius of a circular handle.
- Returns
- The radius of a circular handle, measured in device-independent pixels.
- Note
- The return value is constant. For a given object instance, this function returns the same value every time it is called. This constant value may be different for different instances of the object.
Definition at line 167 of file abstractdiagram.cpp.
◆ hideEvent()
|
overrideprotectedvirtual |
React on a hide event.
Reimplemented from base class.
- Parameters
-
event The hide event.
Reimplemented from QWidget.
Definition at line 306 of file abstractdiagram.cpp.
◆ isActuallyVisible()
|
nodiscardprotected |
If this widget is actually visible.
Unlike QWidget::isVisible
, minimized windows are not considered visible.
Changes can be observed with AbstractDiagram::actualVisibilityToggledEvent.
- Returns
- If this widget is actually visible.
Definition at line 266 of file abstractdiagram.cpp.
◆ maximumPhysicalSquareSize()
|
nodiscardprotected |
The maximum possible size of a square within the widget, measured in physical pixels.
This is the shorter value of width and height of the widget.
- Returns
- The maximum possible size of a square within the widget, measured in physical pixels. Both, width and height are guaranteed to be ≥ 0.
- See also
- maximumWidgetSquareSize
Definition at line 103 of file abstractdiagram.cpp.
◆ maximumWidgetSquareSize()
|
nodiscardprotected |
The maximum possible size of a square within the widget, measured in device-independent pixels.
This is the conversion of maximumPhysicalSquareSize to the unit device-independent pixels. It might be smaller than the shortest value of QWidget::width()
and QWidget::height()
because maximumPhysicalSquareSize might have rounded down.
- Returns
- The maximum possible size of a square within the widget, measured in device-independent pixels.
Definition at line 119 of file abstractdiagram.cpp.
◆ physicalPixelSize()
|
nodiscardprotected |
The rounded size of the widget measured in physical pixels.
- Returns
- The rounded size of this widget, measured in physical pixels, based on
QPaintDevice::devicePixelRatioF()
. This is the recommended image size for callingQPainter::drawImage()
during a paint event. Both, width and height are guaranteed to be ≥ 0.
Example: You want to prepare a QImage
of the hole widget to be used in QWidget::paintEvent()
. To make sure a crisp rendering, you have to
- Prepare an image with the size that this function returns.
- Set
QImage::setDevicePixelRatio()
of the image to the same value asQPaintDevice::devicePixelRatioF()
of the widget. - Actually paint the image on the widget at position
(0, 0)
without anti-aliasing.
- Note
- If
QPaintDevice::devicePixelRatioF()
is not an integer, the result of this function is rounded down. Qt’s widget geometry code has no documentation about how this is handled. However, Qt seems to round up starting with 0.5, at least on Linux/X11. But there are a few themes (for example the “Kvantum style engine” with the style “MildGradientKvantum”) that seem to round down: This becomes visible, as the corresponding last physical pixels are not automatically redrawn before executing thepaintEvent()
code. To avoid relying on undocumented behaviour and to avoid known problems with some styles, this function is conservative and always rounds down.
Definition at line 80 of file abstractdiagram.cpp.
◆ showEvent()
|
overrideprotectedvirtual |
React on a show event.
Reimplemented from base class.
- Parameters
-
event The show event.
Reimplemented from QWidget.
Definition at line 288 of file abstractdiagram.cpp.
◆ spaceForFocusIndicator()
|
nodiscardprotected |
The empty space around diagrams reserved for the focus indicator.
Measured in device-independent pixels.
- Returns
- The empty space around diagrams reserved for the focus indicator.
Definition at line 231 of file abstractdiagram.cpp.
◆ transparencyBackground()
|
nodiscardprotected |
Background for semi-transparent colors.
When showing a semi-transparent color, there has to be a background on which it is shown. This function provides a suitable background for showcasing a color.
Example code (to use within a class that inherits from PerceptualColor::AbstractDiagram):
- Returns
- An image of a mosaic of neutral gray rectangles of different lightness. You can use this as tiles to paint a background.
- Note
- The image is considering QWidget::devicePixelRatioF() to deliver crisp (correctly scaled) images also for high-DPI devices. The painting does not use floating point drawing, but rounds to full integers. Therefore, the result is always a sharp image. This function takes care that each square has the same physical pixel size, without scaling errors or anti-aliasing errors.
Definition at line 147 of file abstractdiagram.cpp.
The documentation for this class was generated from the following files:
Documentation copyright © 1996-2024 The KDE developers.
Generated on Fri Oct 11 2024 12:07:52 by doxygen 1.12.0 written by Dimitri van Heesch, © 1997-2006
KDE's Doxygen guidelines are available online.