<qdrawutil.h> - Drawing Utility Functions
| Header: | #include <qdrawutil.h> |
Funktionen
| void | qDrawBorderPixmap(QPainter *painter, const QRect &target, const QMargins &margins, const QPixmap &pixmap) |
| void | qDrawBorderPixmap(QPainter *painter, const QRect &targetRect, const QMargins &targetMargins, const QPixmap &pixmap, const QRect &sourceRect, const QMargins &sourceMargins, const QTileRules &rules = QTileRules()) |
| void | qDrawPlainRect(QPainter *painter, int x, int y, int width, int height, const QColor &lineColor, int lineWidth = 1, const QBrush *fill = nullptr) |
| void | qDrawPlainRect(QPainter *painter, const QRect &rect, const QColor &lineColor, int lineWidth = 1, const QBrush *fill = nullptr) |
(since 6.7) void | qDrawPlainRoundedRect(QPainter *painter, int x, int y, int width, int height, qreal rx, qreal ry, const QColor &lineColor, int lineWidth = 1, const QBrush *fill = nullptr) |
(since 6.7) void | qDrawPlainRoundedRect(QPainter *painter, const QRect &rect, qreal rx, qreal ry, const QColor &lineColor, int lineWidth = 1, const QBrush *fill = nullptr) |
| void | qDrawShadeLine(QPainter *painter, int x1, int y1, int x2, int y2, const QPalette &palette, bool sunken = true, int lineWidth = 1, int midLineWidth = 0) |
| void | qDrawShadeLine(QPainter *painter, const QPoint &p1, const QPoint &p2, const QPalette &palette, bool sunken = true, int lineWidth = 1, int midLineWidth = 0) |
| void | qDrawShadePanel(QPainter *painter, int x, int y, int width, int height, const QPalette &palette, bool sunken = false, int lineWidth = 1, const QBrush *fill = nullptr) |
| void | qDrawShadePanel(QPainter *painter, const QRect &rect, const QPalette &palette, bool sunken = false, int lineWidth = 1, const QBrush *fill = nullptr) |
| void | qDrawShadeRect(QPainter *painter, int x, int y, int width, int height, const QPalette &palette, bool sunken = false, int lineWidth = 1, int midLineWidth = 0, const QBrush *fill = nullptr) |
| void | qDrawShadeRect(QPainter *painter, const QRect &rect, const QPalette &palette, bool sunken = false, int lineWidth = 1, int midLineWidth = 0, const QBrush *fill = nullptr) |
| void | qDrawWinButton(QPainter *painter, int x, int y, int width, int height, const QPalette &palette, bool sunken = false, const QBrush *fill = nullptr) |
| void | qDrawWinButton(QPainter *painter, const QRect &rect, const QPalette &palette, bool sunken = false, const QBrush *fill = nullptr) |
| void | qDrawWinPanel(QPainter *painter, int x, int y, int width, int height, const QPalette &palette, bool sunken = false, const QBrush *fill = nullptr) |
| void | qDrawWinPanel(QPainter *painter, const QRect &rect, const QPalette &palette, bool sunken = false, const QBrush *fill = nullptr) |
Siehe auch QPainter.
Funktionsdokumentation
void qDrawBorderPixmap(QPainter *painter, const QRect &target, const QMargins &margins, const QPixmap &pixmap)
Die Funktion `qDrawBorderPixmap` dient dazu, eine Pixmap in die Ränder eines Rechtecks zu zeichnen.
Zeichnet die angegebene „ pixmap “ in das angegebene „ target “-Rechteck unter Verwendung der angegebenen „ painter “. Die Pixmap wird in neun Segmente aufgeteilt und gemäß der Struktur „ margins “ gezeichnet.
void qDrawBorderPixmap(QPainter *painter, const QRect &targetRect, const QMargins &targetMargins, const QPixmap &pixmap, const QRect &sourceRect, const QMargins &sourceMargins, const QTileRules &rules = QTileRules())
Zeichnet das angegebene Rechteck „ sourceRect “ aus dem angegebenen „ pixmap “ in das angegebene Rechteck „ targetRect “ unter Verwendung des angegebenen „ painter “. Die Pixmap wird entsprechend den angegebenen Strukturen „ targetMargins “ und „ sourceMargins “ in neun Segmente aufgeteilt. Schließlich wird die Pixmap gemäß dem angegebenen „ rules “ gezeichnet.
Diese Funktion dient zum Zeichnen einer skalierten Pixmap, ähnlich wie bei CSS3-Border-Images
Siehe auch Qt::TileRule, QTileRules und QMargins.
void qDrawPlainRect(QPainter *painter, int x, int y, int width, int height, const QColor &lineColor, int lineWidth = 1, const QBrush *fill = nullptr)
Zeichnet ein einfaches Rechteck, das bei den Koordinaten (x, y) beginnt, mit den angegebenen Werten für „ width “ und „ height “ unter Verwendung der festgelegten Werte für „ painter “, „ lineColor “ und „ lineWidth “. Der Innenbereich des Rechtecks wird mit dem Pinsel „ fill “ ausgefüllt, es sei denn, „ fill “ ist „ nullptr “.
Warnung: Diese Funktion berücksichtigt weder QWidget::style() noch QApplication::style(). Verwenden Sie die Zeichenfunktionen unter QStyle, um Widgets zu erstellen, die dem aktuellen GUI-Stil entsprechen.
Alternativ können Sie ein QFrame -Widget verwenden und die Funktion QFrame::setFrameStyle() anwenden, um ein einfaches Rechteck anzuzeigen:
Siehe auch qDrawShadeRect() und QStyle.
void qDrawPlainRect(QPainter *painter, const QRect &rect, const QColor &lineColor, int lineWidth = 1, const QBrush *fill = nullptr)
Zeichnet das durch ` rect ` angegebene einfache Rechteck unter Verwendung der angegebenen Werte für ` painter`, ` lineColor ` und ` lineWidth`. Der Innenbereich des Rechtecks wird mit dem Pinsel ` fill ` gefüllt, es sei denn, ` fill ` ist ` nullptr`.
Warnung: Diese Funktion berücksichtigt weder ` QWidget::style()` noch ` QApplication::style()`. Verwenden Sie die Zeichenfunktionen in ` QStyle `, um Widgets zu erstellen, die dem aktuellen GUI-Stil entsprechen.
Alternativ kannst du ein QFrame -Widget verwenden und die Funktion QFrame::setFrameStyle() anwenden, um ein einfaches Rechteck anzuzeigen:
Dies ist eine überladene Funktion.
Siehe auch qDrawShadeRect() und QStyle.
[since 6.7] void qDrawPlainRoundedRect(QPainter *painter, int x, int y, int width, int height, qreal rx, qreal ry, const QColor &lineColor, int lineWidth = 1, const QBrush *fill = nullptr)
Zeichnet ein einfaches, abgerundetes Rechteck, das bei (x, y) beginnt, mit den angegebenen Werten für „ width “ und „ height “, unter Verwendung des horizontalen Radius „ rx “ und des vertikalen Radius „ ry “, die über „ painter “, „ lineColor “ und „ lineWidth “ festgelegt werden. Der Innenbereich des Rechtecks wird mit dem Pinsel „ fill “ gefüllt, es sei denn, „ fill “ ist „ nullptr “.
Warnung: Diese Funktion berücksichtigt weder ` QWidget::style()` noch ` QApplication::style()`. Verwenden Sie die Zeichenfunktionen unter QStyle, um Widgets zu erstellen, die dem aktuellen GUI-Stil entsprechen.
Alternativ können Sie ein QFrame -Widget verwenden und die Funktion QFrame::setFrameStyle() anwenden, um ein einfaches Rechteck anzuzeigen:
Diese Funktion wurde in Qt 6.7 eingeführt.
Siehe auch „ qDrawShadeRect()“ und „ QStyle “.
[since 6.7] void qDrawPlainRoundedRect(QPainter *painter, const QRect &rect, qreal rx, qreal ry, const QColor &lineColor, int lineWidth = 1, const QBrush *fill = nullptr)
Zeichnet das durch ` rect ` angegebene einfache Rechteck unter Verwendung des horizontalen Radius ` rx ` und des vertikalen Radius ` ry` sowie der angegebenen Werte für ` painter`, ` lineColor ` und ` lineWidth`. Der Innenbereich des Rechtecks wird mit dem Pinsel ` fill ` gefüllt, es sei denn, ` fill ` ist ` nullptr`.
Warnung: Diese Funktion berücksichtigt weder ` QWidget::style()` noch ` QApplication::style()`. Verwenden Sie die Zeichenfunktionen unter QStyle, um Widgets zu erstellen, die dem aktuellen GUI-Stil entsprechen.
Alternativ kannst du ein QFrame -Widget verwenden und die Funktion QFrame::setFrameStyle() anwenden, um ein einfaches Rechteck anzuzeigen:
Dies ist eine überladene Funktion.
Diese Funktion wurde in Qt 6.7 eingeführt.
Siehe auch „ qDrawShadeRect()“ und „ QStyle “.
void qDrawShadeLine(QPainter *painter, int x1, int y1, int x2, int y2, const QPalette &palette, bool sunken = true, int lineWidth = 1, int midLineWidth = 0)
Zeichnet eine horizontale (y1 == y2) oder vertikale (x1 == x2) schattierte Linie unter Verwendung der angegebenen painter. Beachten Sie, dass nichts gezeichnet wird, wenn y1!= y2 und x1!= x2 (d. h., die Linie ist weder horizontal noch vertikal).
Das angegebene ` palette ` legt die Schattierungsfarben fest (Farben `light`, ` dark ` und ` middle `). Das angegebene ` lineWidth ` legt die Linienbreite für jede der Linien fest; es handelt sich nicht um die Gesamtlinienbreite. Das angegebene ` midLineWidth ` legt die Breite einer mittleren Linie fest, die in der Farbe ` QPalette::mid()` gezeichnet wird.
Die Linie erscheint vertieft, wenn sunken wahr ist, andernfalls erhaben.
Warnung: Diese Funktion berücksichtigt weder QWidget::style() noch QApplication::style(). Verwenden Sie die Zeichenfunktionen unter QStyle, um Widgets zu erstellen, die dem aktuellen GUI-Stil entsprechen.
Alternativ können Sie ein „ QFrame “-Widget verwenden und die Funktion „ QFrame::setFrameStyle()“ anwenden, um eine schattierte Linie anzuzeigen:
Siehe auch „ qDrawShadeRect()“, „ qDrawShadePanel()“ und „ QStyle “.
void qDrawShadeLine(QPainter *painter, const QPoint &p1, const QPoint &p2, const QPalette &palette, bool sunken = true, int lineWidth = 1, int midLineWidth = 0)
Zeichnet eine horizontale oder vertikale schraffierte Linie zwischen p1 und p2 unter Verwendung der angegebenen painter. Beachten Sie, dass nichts gezeichnet wird, wenn die Linie zwischen den Punkten weder horizontal noch vertikal wäre.
Die angegebene ` palette ` legt die Schattierungsfarben fest (`light`, ` dark ` und ` middle `). Die angegebene ` lineWidth ` legt die Linienbreite für jede der Linien fest; es handelt sich dabei nicht um die Gesamtlinienbreite. Die angegebene ` midLineWidth ` legt die Breite einer mittleren Linie fest, die in der Farbe ` QPalette::mid()` gezeichnet wird.
Die Linie erscheint vertieft, wenn sunken wahr ist, andernfalls erhaben.
Warnung: Diese Funktion berücksichtigt weder QWidget::style() noch QApplication::style(). Verwenden Sie die Zeichenfunktionen unter QStyle, um Widgets zu erstellen, die dem aktuellen GUI-Stil entsprechen.
Alternativ können Sie ein „ QFrame “-Widget verwenden und die Funktion „ QFrame::setFrameStyle()“ anwenden, um eine schattierte Linie anzuzeigen:
Dies ist eine überladene Funktion.
Siehe auch qDrawShadeRect(), qDrawShadePanel() und QStyle.
void qDrawShadePanel(QPainter *painter, int x, int y, int width, int height, const QPalette &palette, bool sunken = false, int lineWidth = 1, const QBrush *fill = nullptr)
Zeichnet das schattierte Feld, beginnend bei (x, y), mit den angegebenen Werten für „ width “ und „ height “ unter Verwendung der bereitgestellten „ painter “ und der angegebenen „ lineWidth “.
Die angegebene „ palette “ legt die Schattierungsfarben fest (Farben für „light “, „ dark “ und „ middle “). Der Innenbereich des Feldes wird mit dem Pinsel „ fill “ gefüllt, es sei denn, „ fill “ ist auf „ nullptr “ gesetzt.
Das Bedienfeld erscheint vertieft, wenn „ sunken “ auf „true“ gesetzt ist, andernfalls erhaben.
Warnung: Diese Funktion berücksichtigt weder „ QWidget::style()“ noch „ QApplication::style()“. Verwenden Sie die Zeichenfunktionen unter QStyle, um Widgets zu erstellen, die dem aktuellen GUI-Stil entsprechen.
Alternativ können Sie ein ` QFrame `-Widget verwenden und die Funktion ` QFrame::setFrameStyle()` anwenden, um ein schattiertes Feld anzuzeigen:
Siehe auch qDrawWinPanel(), qDrawShadeLine(), qDrawShadeRect() und QStyle.
void qDrawShadePanel(QPainter *painter, const QRect &rect, const QPalette &palette, bool sunken = false, int lineWidth = 1, const QBrush *fill = nullptr)
Zeichnet das schattierte Feld in dem durch ` rect ` angegebenen Rechteck unter Verwendung der angegebenen ` painter ` und der angegebenen ` lineWidth`.
Die angegebenen „ palette “ legen die Schattierungsfarben fest (Farben für „light “, „ dark “ und „ middle “). Der Innenbereich des Bereichs wird mit dem Pinsel „ fill “ gefüllt, es sei denn, „ fill “ ist auf „ nullptr “ gesetzt.
Das Feld erscheint vertieft, wenn „ sunken “ auf „true“ gesetzt ist, andernfalls erhaben.
Warnung: Diese Funktion berücksichtigt weder „ QWidget::style()“ noch „ QApplication::style()“. Verwenden Sie die Zeichenfunktionen unter QStyle, um Widgets zu erstellen, die dem aktuellen GUI-Stil entsprechen.
Alternativ können Sie ein „ QFrame “-Widget verwenden und die Funktion „ QFrame::setFrameStyle()“ anwenden, um ein schattiertes Feld anzuzeigen:
Dies ist eine überladene Funktion.
Siehe auch qDrawWinPanel(), qDrawShadeLine(), qDrawShadeRect() und QStyle.
void qDrawShadeRect(QPainter *painter, int x, int y, int width, int height, const QPalette &palette, bool sunken = false, int lineWidth = 1, int midLineWidth = 0, const QBrush *fill = nullptr)
Zeichnet das schattierte Rechteck, beginnend bei (x, y), mit den angegebenen Werten für „ width “ und „ height “ unter Verwendung der bereitgestellten Funktion „ painter “.
Der übergebene Parameter ` palette ` legt die Schattierungsfarben fest (Farben `light`, ` dark ` und ` middle `). Der angegebene Parameter ` lineWidth ` legt die Linienbreite für jede einzelne Linie fest; es handelt sich dabei nicht um die Gesamtlinienbreite. Der Parameter ` midLineWidth ` legt die Breite einer Mittellinie fest, die in der Farbe ` QPalette::mid()` gezeichnet wird. Der Innenbereich des Rechtecks wird mit dem Pinsel ` fill ` gefüllt, es sei denn, ` fill ` ist ` nullptr`.
Das Rechteck erscheint vertieft, wenn „ sunken “ auf „true“ gesetzt ist, andernfalls erhaben.
Warnung: Diese Funktion berücksichtigt weder ` QWidget::style()` noch ` QApplication::style()`. Verwenden Sie die Zeichenfunktionen unter QStyle, um Widgets zu erstellen, die dem aktuellen GUI-Stil entsprechen.
Alternativ können Sie ein QFrame -Widget verwenden und die Funktion QFrame::setFrameStyle() anwenden, um ein schattiertes Rechteck anzuzeigen:
Siehe auch qDrawShadeLine(), qDrawShadePanel(), qDrawPlainRect() und QStyle.
void qDrawShadeRect(QPainter *painter, const QRect &rect, const QPalette &palette, bool sunken = false, int lineWidth = 1, int midLineWidth = 0, const QBrush *fill = nullptr)
Zeichnet das durch rect angegebene schattierte Rechteck unter Verwendung der angegebenen painter.
Der angegebene Parameter „ palette “ legt die Schattierungsfarben fest (Farben für „light “, „ dark “ und „ middle “). Der angegebene Parameter „ lineWidth “ legt die Linienbreite für jede einzelne Linie fest; es handelt sich dabei nicht um die Gesamtlinienbreite. Der Parameter „ midLineWidth “ legt die Breite einer Mittellinie fest, die in der Farbe „ QPalette::mid()“ gezeichnet wird. Der Innenbereich des Rechtecks wird mit dem Pinsel „ fill “ gefüllt, es sei denn, „ fill “ ist „ nullptr “.
Das Rechteck erscheint vertieft, wenn sunken auf „true“ gesetzt ist, andernfalls erhaben.
Warnung: Diese Funktion berücksichtigt weder ` QWidget::style()` noch ` QApplication::style()`. Verwenden Sie die Zeichenfunktionen in ` QStyle `, um Widgets zu erstellen, die dem aktuellen GUI-Stil entsprechen.
Alternativ können Sie ein „ QFrame “-Widget verwenden und die Funktion „ QFrame::setFrameStyle()“ anwenden, um ein schattiertes Rechteck anzuzeigen:
Dies ist eine überladene Funktion.
Siehe auch qDrawShadeLine(), qDrawShadePanel(), qDrawPlainRect() und QStyle.
void qDrawWinButton(QPainter *painter, int x, int y, int width, int height, const QPalette &palette, bool sunken = false, const QBrush *fill = nullptr)
Zeichnet die Schaltfläche im Windows-Stil, die durch die angegebenen Punkte (x, y}, width und height ) definiert ist, unter Verwendung des bereitgestellten Pinsels „ painter “ mit einer Linienbreite von 2 Pixeln. Der Innenbereich der Schaltfläche wird mit dem Pinsel „ fill “ gefüllt, es sei denn, „ fill “ ist auf „ nullptr “ gesetzt.
Die angegebene „ palette “ legt die Schattierungsfarben fest (Farben für „light “, „ dark “ und „ middle “).
Die Schaltfläche erscheint vertieft, wenn „ sunken “ auf „true“ gesetzt ist, andernfalls erhaben.
Warnung: Diese Funktion berücksichtigt weder ` QWidget::style()` noch ` QApplication::style()` – verwenden Sie die Zeichenfunktionen in ` QStyle `, um Widgets zu erstellen, die dem aktuellen GUI-Stil entsprechen.
Siehe auch qDrawWinPanel() und QStyle.
void qDrawWinButton(QPainter *painter, const QRect &rect, const QPalette &palette, bool sunken = false, const QBrush *fill = nullptr)
Zeichnet die Schaltfläche im Windows-Stil an der durch ` rect ` angegebenen Stelle unter Verwendung des angegebenen ` painter ` mit einer Linienbreite von 2 Pixeln. Der Innenbereich der Schaltfläche wird mit dem Pinsel ` fill ` gefüllt, es sei denn, ` fill ` ist auf ` nullptr` gesetzt.
Die angegebene „ palette “ legt die Schattierungsfarben fest (Farben für „light “, „ dark “ und „ middle “).
Die Schaltfläche erscheint vertieft, wenn „ sunken “ auf „true“ gesetzt ist, andernfalls erhaben.
Warnung: Diese Funktion berücksichtigt weder ` QWidget::style()` noch ` QApplication::style()` – verwenden Sie die Zeichenfunktionen unter QStyle, um Widgets zu erstellen, die dem aktuellen GUI-Stil entsprechen.
Dies ist eine überladene Funktion.
Siehe auch qDrawWinPanel() und QStyle.
void qDrawWinPanel(QPainter *painter, int x, int y, int width, int height, const QPalette &palette, bool sunken = false, const QBrush *fill = nullptr)
Zeichnet das durch den angegebenen Punkt (x, y), width und height definierte Panel im Windows-Stil unter Verwendung des bereitgestellten painter mit einer Linienbreite von 2 Pixeln. Der Innenbereich der Schaltfläche wird mit dem Pinsel fill gefüllt, es sei denn, fill ist nullptr.
Die angegebene „ palette “ legt die Schattierungsfarben fest. Das Bedienfeld erscheint vertieft, wenn „ sunken “ auf „true“ gesetzt ist, andernfalls erhaben.
Warnung: Diese Funktion berücksichtigt weder „ QWidget::style()“ noch „ QApplication::style()“. Verwenden Sie die Zeichenfunktionen unter QStyle, um Widgets zu erstellen, die dem aktuellen GUI-Stil entsprechen.
Alternativ können Sie ein „ QFrame “-Widget verwenden und die Funktion „ QFrame::setFrameStyle()“ anwenden, um ein schattiertes Feld anzuzeigen:
Siehe auch qDrawShadePanel(), qDrawWinButton() und QStyle.
void qDrawWinPanel(QPainter *painter, const QRect &rect, const QPalette &palette, bool sunken = false, const QBrush *fill = nullptr)
Zeichnet das Panel im Windows-Stil in dem durch ` rect ` angegebenen Rechteck unter Verwendung des angegebenen ` painter ` mit einer Linienbreite von 2 Pixeln. Der Innenbereich der Schaltfläche wird mit dem Pinsel ` fill ` gefüllt, es sei denn, ` fill ` ist auf ` nullptr` gesetzt.
Die angegebene „ palette “ legt die Schattierungsfarben fest. Das Bedienfeld erscheint vertieft, wenn „ sunken “ auf „true“ gesetzt ist, andernfalls erhaben.
Warnung: Diese Funktion berücksichtigt weder „ QWidget::style()“ noch „ QApplication::style()“. Verwenden Sie die Zeichenfunktionen unter QStyle, um Widgets zu erstellen, die dem aktuellen GUI-Stil entsprechen.
Alternativ können Sie ein „ QFrame “-Widget verwenden und die Funktion „ QFrame::setFrameStyle()“ anwenden, um ein schattiertes Feld anzuzeigen:
Dies ist eine überladene Funktion.
Siehe auch qDrawShadePanel(), qDrawWinButton() und QStyle.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.