<qdrawutil.h> - Drawing Utility Functions
| Header: | #include <qdrawutil.h> |
Funciones
| 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) |
Véase también QPainter.
Documentación de la función
void qDrawBorderPixmap(QPainter *painter, const QRect &target, const QMargins &margins, const QPixmap &pixmap)
La función qDrawBorderPixmap sirve para dibujar un mapa de píxeles en los márgenes de un rectángulo.
Dibuja el mapa de píxeles ( pixmap ) especificado en el rectángulo ( target ) especificado, utilizando el índice de píxeles ( painter) especificado. El mapa de píxeles se dividirá en nueve segmentos y se dibujará según la estructura ( margins ).
void qDrawBorderPixmap(QPainter *painter, const QRect &targetRect, const QMargins &targetMargins, const QPixmap &pixmap, const QRect &sourceRect, const QMargins &sourceMargins, const QTileRules &rules = QTileRules())
Dibuja el rectángulo indicado sourceRect a partir del pixmap proporcionado en el rectángulo targetRect especificado, utilizando el painter proporcionado. El mapa de píxeles se dividirá en nueve segmentos según las estructuras targetMargins y sourceMargins proporcionadas. Por último, el mapa de píxeles se dibujará según el rules proporcionado.
Esta función se utiliza para dibujar un mapa de píxeles a escala, similar a las imágenes de borde de CSS3
Véase también Qt::TileRule, QTileRules y QMargins.
void qDrawPlainRect(QPainter *painter, int x, int y, int width, int height, const QColor &lineColor, int lineWidth = 1, const QBrush *fill = nullptr)
Dibuja un rectángulo sencillo que comienza en (x, y) con los valores dados width y height, utilizando los valores especificados painter, lineColor y lineWidth. El interior del rectángulo se rellena con el pincel fill, a menos que fill sea nullptr.
Advertencia: Esta función no tiene en cuenta QWidget::style() ni QApplication::style(). Utiliza las funciones de dibujo de QStyle para crear widgets que sigan el estilo actual de la interfaz gráfica de usuario.
Como alternativa, puede utilizar un widget QFrame y aplicar la función QFrame::setFrameStyle() para mostrar un rectángulo sencillo:
Véase también qDrawShadeRect() y QStyle.
void qDrawPlainRect(QPainter *painter, const QRect &rect, const QColor &lineColor, int lineWidth = 1, const QBrush *fill = nullptr)
Dibuja el rectángulo sencillo especificado por rect utilizando los valores proporcionados de painter, lineColor y lineWidth. El interior del rectángulo se rellena con el pincel fill, a menos que fill sea nullptr.
Advertencia: Esta función no tiene en cuenta QWidget::style() ni QApplication::style(). Utiliza las funciones de dibujo de QStyle para crear widgets que sigan el estilo actual de la interfaz gráfica de usuario.
Como alternativa, puedes utilizar un widget QFrame y aplicar la función QFrame::setFrameStyle() para mostrar un rectángulo sencillo:
Esta es una función sobrecargada.
Véase también qDrawShadeRect() y 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)
Dibuja un rectángulo redondeado sencillo que comienza en (x, y) con los valores dados para width y height, utilizando el radio horizontal rx y el radio vertical ry, especificados en painter, lineColor y lineWidth. El interior del rectángulo se rellena con el pincel fill, a menos que fill sea nullptr.
Advertencia: Esta función no tiene en cuenta QWidget::style() ni QApplication::style(). Utiliza las funciones de dibujo de QStyle para crear widgets que sigan el estilo actual de la interfaz gráfica de usuario.
Como alternativa, puede utilizar un widget QFrame y aplicar la función QFrame::setFrameStyle() para mostrar un rectángulo sencillo:
Esta función se introdujo en Qt 6.7.
Véase también qDrawShadeRect() y 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)
Dibuja el rectángulo sencillo especificado por rect utilizando el rx horizontal y el radio ry vertical, así como los valores proporcionados painter, lineColor y lineWidth. El interior del rectángulo se rellena con el pincel fill, a menos que fill sea nullptr.
Advertencia: Esta función no tiene en cuenta QWidget::style() ni QApplication::style(). Utiliza las funciones de dibujo de QStyle para crear widgets que sigan el estilo actual de la interfaz gráfica de usuario.
Como alternativa, puedes utilizar un widget QFrame y aplicar la función QFrame::setFrameStyle() para mostrar un rectángulo sencillo:
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.7.
Véase también ` qDrawShadeRect()` y ` 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)
Dibuja una línea sombreada horizontal (y1 == y2) o vertical (x1 == x2) utilizando el valor dado painter. Ten en cuenta que no se dibuja nada si y1!= y2 y x1!= x2 (es decir, la línea no es ni horizontal ni vertical).
El parámetro palette proporciona los colores de sombreado (coloreslight, dark y middle ). El parámetro lineWidth proporciona el grosor de cada una de las líneas; no se trata del grosor total de la línea. El parámetro midLineWidth proporciona el grosor de una línea central dibujada en el color QPalette::mid().
La línea aparece hundida si sunken es verdadero; en caso contrario, sobresale.
Advertencia: Esta función no tiene en cuenta QWidget::style() ni QApplication::style(). Utiliza las funciones de dibujo de QStyle para crear widgets que sigan el estilo actual de la interfaz gráfica de usuario.
Como alternativa, puede utilizar un widget QFrame y aplicar la función QFrame::setFrameStyle() para mostrar una línea sombreada:
Véase también qDrawShadeRect(), qDrawShadePanel() y QStyle.
void qDrawShadeLine(QPainter *painter, const QPoint &p1, const QPoint &p2, const QPalette &palette, bool sunken = true, int lineWidth = 1, int midLineWidth = 0)
Dibuja una línea sombreada horizontal o vertical entre p1 y p2 utilizando el painter especificado. Ten en cuenta que no se dibuja nada si la línea entre los puntos no fuera ni horizontal ni vertical.
El valor palette proporcionado especifica los colores de sombreado (los coloreslight, dark y middle ). El valor lineWidth proporcionado especifica el grosor de cada una de las líneas; no se trata del grosor total de la línea. El valor midLineWidth proporcionado especifica el grosor de una línea central dibujada en el color QPalette::mid().
La línea aparece hundida si sunken es verdadero; en caso contrario, aparece elevada.
Advertencia: Esta función no tiene en cuenta QWidget::style() ni QApplication::style(). Utiliza las funciones de dibujo de QStyle para crear widgets que sigan el estilo actual de la interfaz gráfica de usuario.
Como alternativa, puede utilizar un widget QFrame y aplicar la función QFrame::setFrameStyle() para mostrar una línea sombreada:
Esta es una función sobrecargada.
Véase también qDrawShadeRect(), qDrawShadePanel() y 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)
Dibuja el panel sombreado que comienza en (x, y) con los valores width y height especificados, utilizando el painter proporcionado y el lineWidth especificado.
El valor palette especifica los colores de sombreado (los colores delight, dark y middle ). El interior del panel se rellena con el pincel fill, a menos que fill sea nullptr.
El panel aparece hundido si sunken es verdadero; en caso contrario, aparece elevado.
Advertencia: Esta función no tiene en cuenta QWidget::style() ni QApplication::style(). Utiliza las funciones de dibujo de QStyle para crear widgets que sigan el estilo actual de la interfaz gráfica de usuario.
Como alternativa, puede utilizar un widget QFrame y aplicar la función QFrame::setFrameStyle() para mostrar un panel sombreado:
Véase también qDrawWinPanel(), qDrawShadeLine(), qDrawShadeRect() y QStyle.
void qDrawShadePanel(QPainter *painter, const QRect &rect, const QPalette &palette, bool sunken = false, int lineWidth = 1, const QBrush *fill = nullptr)
Dibuja el panel sombreado en el rectángulo especificado por rect utilizando el painter y el lineWidth indicados.
El valor de ` palette ` especificado determina los colores del sombreado (los colores de `light`, ` dark ` y ` middle `). El interior del panel se rellena con el pincel ` fill `, a menos que ` fill ` sea ` nullptr`.
El panel aparece hundido si sunken es verdadero; en caso contrario, aparece elevado.
Advertencia: Esta función no tiene en cuenta QWidget::style() ni QApplication::style(). Utiliza las funciones de dibujo de QStyle para crear widgets que sigan el estilo actual de la interfaz gráfica de usuario.
Como alternativa, puede utilizar un widget QFrame y aplicar la función QFrame::setFrameStyle() para mostrar un panel sombreado:
Esta es una función sobrecargada.
Véase también qDrawWinPanel(), qDrawShadeLine(), qDrawShadeRect() y 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)
Dibuja el rectángulo sombreado que comienza en (x, y) con los valores width y height proporcionados, utilizando el painter facilitado.
El parámetro ` palette ` especifica los colores de sombreado (`light`, ` dark ` y ` middle `). El valor de ` lineWidth ` especifica el grosor de cada una de las líneas; no se trata del grosor total de la línea. El parámetro ` midLineWidth ` especifica el grosor de una línea central dibujada con el color ` QPalette::mid()`. El interior del rectángulo se rellena con el pincel ` fill `, a menos que ` fill ` sea ` nullptr`.
El rectángulo aparece hundido si sunken es verdadero; en caso contrario, aparece elevado.
Advertencia: Esta función no tiene en cuenta QWidget::style() ni QApplication::style(). Utiliza las funciones de dibujo de QStyle para crear widgets que sigan el estilo actual de la interfaz gráfica de usuario.
Como alternativa, puede utilizar un widget QFrame y aplicar la función QFrame::setFrameStyle() para mostrar un rectángulo sombreado:
Véase también qDrawShadeLine(), qDrawShadePanel(), qDrawPlainRect() y QStyle.
void qDrawShadeRect(QPainter *painter, const QRect &rect, const QPalette &palette, bool sunken = false, int lineWidth = 1, int midLineWidth = 0, const QBrush *fill = nullptr)
Dibuja el rectángulo sombreado especificado en rect utilizando el painter indicado.
El parámetro ` palette ` especifica los colores de sombreado (`light`, ` dark ` y ` middle `). El parámetro ` lineWidth ` especifica el grosor de cada una de las líneas; no se trata del grosor total de la línea. El parámetro ` midLineWidth ` especifica el grosor de una línea central dibujada en el color ` QPalette::mid()`. El interior del rectángulo se rellena con el pincel ` fill `, a menos que ` fill ` sea ` nullptr`.
El rectángulo aparece hundido si sunken es verdadero; en caso contrario, sobresale.
Advertencia: Esta función no tiene en cuenta QWidget::style() ni QApplication::style(). Utiliza las funciones de dibujo de QStyle para crear widgets que sigan el estilo actual de la interfaz gráfica de usuario.
Como alternativa, puede utilizar un widget de QFrame y aplicar la función QFrame::setFrameStyle() para mostrar un rectángulo sombreado:
Esta es una función sobrecargada.
Véase también qDrawShadeLine(), qDrawShadePanel(), qDrawPlainRect() y QStyle.
void qDrawWinButton(QPainter *painter, int x, int y, int width, int height, const QPalette &palette, bool sunken = false, const QBrush *fill = nullptr)
Dibuja el botón al estilo de Windows especificado por los puntos indicados (x, y}, width y height utilizando el painter proporcionado con un grosor de línea de 2 píxeles. El interior del botón se rellena con el pincel fill, a menos que fill sea nullptr.
El valor palette especifica los colores de sombreado (light, dark y middle ).
El botón aparece hundido si sunken es verdadero; en caso contrario, aparece elevado.
Advertencia: Esta función no tiene en cuenta QWidget::style() ni QApplication::style(). Utiliza las funciones de dibujo de QStyle para crear widgets que sigan el estilo actual de la interfaz gráfica de usuario.
Véase también qDrawWinPanel() y QStyle.
void qDrawWinButton(QPainter *painter, const QRect &rect, const QPalette &palette, bool sunken = false, const QBrush *fill = nullptr)
Dibuja el botón al estilo de Windows en el rectángulo especificado por ` rect `, utilizando el ` painter ` indicado con un grosor de línea de 2 píxeles. El interior del botón se rellena con el pincel ` fill `, a menos que ` fill ` sea ` nullptr`.
El valor palette especifica los colores de sombreado (los colores delight, dark y middle ).
El botón aparece hundido si sunken es verdadero; en caso contrario, aparece elevado.
Advertencia: Esta función no tiene en cuenta QWidget::style() ni QApplication::style(). Utiliza las funciones de dibujo de QStyle para crear widgets que sigan el estilo actual de la interfaz gráfica de usuario.
Esta es una función sobrecargada.
Véase también qDrawWinPanel() y QStyle.
void qDrawWinPanel(QPainter *painter, int x, int y, int width, int height, const QPalette &palette, bool sunken = false, const QBrush *fill = nullptr)
Dibuja el panel al estilo de Windows especificado por el punto dado (x, y), width y height utilizando el painter proporcionado con un grosor de línea de 2 píxeles. El interior del botón se rellena con el pincel fill, a menos que fill sea nullptr.
El valor palette especificado determina los colores de sombreado. El panel aparece hundido si sunken es verdadero; en caso contrario, aparece elevado.
Advertencia: Esta función no tiene en cuenta QWidget::style() ni QApplication::style(). Utiliza las funciones de dibujo de QStyle para crear widgets que sigan el estilo actual de la interfaz gráfica de usuario.
Como alternativa, puede utilizar un widget QFrame y aplicar la función QFrame::setFrameStyle() para mostrar un panel sombreado:
Véase también qDrawShadePanel(), qDrawWinButton() y QStyle.
void qDrawWinPanel(QPainter *painter, const QRect &rect, const QPalette &palette, bool sunken = false, const QBrush *fill = nullptr)
Dibuja el panel al estilo de Windows en el rectángulo especificado por rect utilizando el painter indicado, con un grosor de línea de 2 píxeles. El interior del botón se rellena con el pincel fill, a menos que fill sea nullptr.
El valor palette especificado determina los colores de sombreado. El panel aparece hundido si sunken es verdadero; en caso contrario, aparece elevado.
Advertencia: Esta función no tiene en cuenta QWidget::style() ni QApplication::style(). Utiliza las funciones de dibujo de QStyle para crear widgets que sigan el estilo actual de la interfaz gráfica de usuario.
Como alternativa, puede utilizar un widget ` QFrame ` y aplicar la función ` QFrame::setFrameStyle()` para mostrar un panel sombreado:
Esta es una función sobrecargada.
Véase también qDrawShadePanel(), qDrawWinButton() y 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.