QFrame Class
La clase QFrame es la clase base de los widgets que pueden tener un marco. Más información...
| Encabezado: | #include <QFrame> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Heredado de: | QWidget |
| Heredado por: | QAbstractScrollArea, QLabel, QLCDNumber, QSplitter, QStackedWidget, y QToolBox |
Tipos públicos
| enum | Shadow { Plain, Raised, Sunken } |
| enum | Shape { NoFrame, Box, Panel, StyledPanel, HLine, …, WinPanel } |
| enum | StyleMask { Shadow_Mask, Shape_Mask } |
Propiedades
|
|
Funciones públicas
| QFrame(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags()) | |
| virtual | ~QFrame() |
| QRect | frameRect() const |
| QFrame::Shadow | frameShadow() const |
| QFrame::Shape | frameShape() const |
| int | frameStyle() const |
| int | frameWidth() const |
| int | lineWidth() const |
| int | midLineWidth() const |
| void | setFrameRect(const QRect &) |
| void | setFrameShadow(QFrame::Shadow) |
| void | setFrameShape(QFrame::Shape) |
| void | setFrameStyle(int style) |
| void | setLineWidth(int) |
| void | setMidLineWidth(int) |
Funciones públicas reimplementadas
| virtual QSize | sizeHint() const override |
Funciones protegidas
| virtual void | initStyleOption(QStyleOptionFrame *option) const |
Funciones protegidas reimplementadas
| virtual void | changeEvent(QEvent *ev) override |
| virtual bool | event(QEvent *e) override |
| virtual void | paintEvent(QPaintEvent *) override |
Descripción detallada
QMenu Se utiliza para «elevar» el menú por encima de la pantalla circundante. QProgressBar tiene un aspecto «hundido». QLabel tiene un aspecto plano. Los marcos de widgets como estos se pueden modificar.
QLabel label(...);
label.setFrameStyle(QFrame::Panel | QFrame::Raised);
label.setLineWidth(2);
QProgressBar pbar(...);
label.setFrameStyle(QFrame::NoFrame);La clase QFrame también se puede utilizar directamente para crear marcos sencillos que sirvan de marcador de posición sin ningún contenido.
El estilo del marco se especifica mediante frame shape y shadow style, que se utilizan para separar visualmente el marco de los widgets circundantes. Estas propiedades se pueden establecer conjuntamente mediante la función setFrameStyle() y leerse con frameStyle().
Las formas del marco son « NoFrame », « Box », « Panel », « StyledPanel », « HLine » y « VLine »; los estilos de sombra son « Plain », « Raised » y « Sunken ».
Un widget de marco tiene tres atributos que describen el grosor del borde: lineWidth, midLineWidth y frameWidth.
- El ancho de línea es el ancho del borde del marco. Se puede modificar para personalizar el aspecto del marco.
- El ancho de la línea central especifica el ancho de una línea adicional en el centro del marco, que utiliza un tercer color para conseguir un efecto 3D especial. Ten en cuenta que la línea central solo se dibuja en los marcos Box, HLine y VLine que están en relieve o hundidos.
- El ancho del marco viene determinado por el estilo del marco, y la función frameWidth() se utiliza para obtener el valor definido para el estilo utilizado.
El margen entre el marco y su contenido se puede personalizar con la función QWidget::setContentsMargins().
Esta tabla muestra algunas de las combinaciones de estilos y anchos de línea:

Tipo de miembro Documentación
enum QFrame::Shadow
Este tipo de enumeración define los tipos de sombra que se utilizan para dar un efecto 3D a los fotogramas.
| Constante | Valor | Descripción |
|---|---|---|
QFrame::Plain | 0x0010 | el marco y el contenido aparecen a la misma altura que el entorno; se dibuja utilizando un color de la paleta QPalette::WindowText (sin ningún efecto 3D) |
QFrame::Raised | 0x0020 | el marco y el contenido parecen elevados; dibuja una línea elevada en 3D utilizando los colores claros y oscuros del grupo de colores actual |
QFrame::Sunken | 0x0030 | el marco y el contenido aparecen hundidos; dibuja una línea en 3D hundida utilizando los colores claros y oscuros del grupo de colores actual |
La sombra interactúa con ` QFrame::Shape`, ` lineWidth()` y ` midLineWidth()`. Véase la imagen de los marcos en la documentación de la clase principal.
Véanse también QFrame::Shape, lineWidth() y midLineWidth().
enum QFrame::Shape
Este tipo de enumeración define las formas de marco disponibles.
| Constante | Valor | Descripción |
|---|---|---|
QFrame::NoFrame | 0 | QFrame No dibuja nada |
QFrame::Box | 0x0001 | QFrame dibuja un recuadro alrededor de su contenido |
QFrame::Panel | 0x0002 | QFrame dibuja un panel para que el contenido parezca elevado o hundido |
QFrame::StyledPanel | 0x0006 | dibuja un panel rectangular cuyo aspecto depende del estilo actual de la interfaz gráfica de usuario. Puede estar en relieve o hundido. |
QFrame::HLine | 0x0004 | QFrame dibuja una línea horizontal que no enmarca nada (útil como separador) |
QFrame::VLine | 0x0005 | QFrame dibuja una línea vertical que no enmarca nada (útil como separador) |
QFrame::WinPanel | 0x0003 | dibuja un panel rectangular que puede estar en relieve o hundido, como los de Windows 2000. Al especificar esta forma, el grosor de la línea se establece en 2 píxeles. WinPanel se proporciona por motivos de compatibilidad. Para garantizar la independencia del estilo de la interfaz gráfica de usuario, recomendamos utilizar StyledPanel en su lugar. |
Cuando no llama a QStyle, Shape interactúa con QFrame::Shadow, lineWidth() y midLineWidth() para crear el resultado final. Véase la imagen de los marcos en la documentación de la clase principal.
Véanse también QFrame::Shadow, QFrame::style() y QStyle::drawPrimitive().
enum QFrame::StyleMask
Esta enumeración define dos constantes que se pueden utilizar para extraer los dos componentes de ` frameStyle()`:
| Constante | Valor | Descripción |
|---|---|---|
QFrame::Shadow_Mask | 0x00f0 | La parte « Shadow » de « frameStyle()» |
QFrame::Shape_Mask | 0x000f | La parte « Shape » de ` frameStyle()` |
Normalmente, no es necesario utilizarlas, ya que frameShadow() y frameShape() ya extraen las partes Shadow y Shape de frameStyle().
Véanse también frameStyle() y setFrameStyle().
Documentación de propiedades
frameRect : QRect
Esta propiedad contiene el rectángulo del marco
El rectángulo del marco es el rectángulo en el que se dibuja el marco. Por defecto, corresponde a todo el widget. Establecer el rectángulo no provoca una actualización del widget. El rectángulo del marco se ajusta automáticamente cuando el widget cambia de tamaño.
Si se establece el rectángulo en un rectángulo nulo (por ejemplo, QRect(0, 0, 0, 0)), el rectángulo del marco resultante será equivalente a widget rectangle.
Funciones de acceso:
| QRect | frameRect() const |
| void | setFrameRect(const QRect &) |
frameShadow : Shadow
Esta propiedad contiene el valor de la sombra del marco, procedente del estilo del marco
Funciones de acceso:
| QFrame::Shadow | frameShadow() const |
| void | setFrameShadow(QFrame::Shadow) |
Véase también frameStyle() y frameShape().
frameShape : Shape
Esta propiedad contiene el valor de la forma del marco, procedente del estilo del marco
Funciones de acceso:
| QFrame::Shape | frameShape() const |
| void | setFrameShape(QFrame::Shape) |
Véase también frameStyle() y frameShadow().
[read-only] frameWidth : int
Esta propiedad define el ancho del marco que se dibuja.
Ten en cuenta que el ancho del marco depende de la propiedad « frame style », y no solo del ancho de la línea y del ancho de la línea media. Por ejemplo, el estilo especificado por « NoFrame » siempre tiene un ancho de marco de 0, mientras que el estilo « Panel » tiene un ancho de marco equivalente al ancho de la línea.
Funciones de acceso:
| int | frameWidth() const |
Véase también lineWidth(), midLineWidth() y frameStyle().
lineWidth : int
Esta propiedad define el grosor de la línea
Ten en cuenta que el ancho total de línea de los marcos utilizados como separadores (HLine y VLine) viene determinado por frameWidth.
El valor por defecto es 1.
Funciones de acceso:
| int | lineWidth() const |
| void | setLineWidth(int) |
Véase también midLineWidth y frameWidth.
midLineWidth : int
Esta propiedad define la anchura de la línea central
El valor por defecto es 0.
Funciones de Access:
| int | midLineWidth() const |
| void | setMidLineWidth(int) |
Véase también lineWidth y frameWidth.
Documentación de las funciones de miembro
[explicit] QFrame::QFrame(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())
Crea un widget de marco con el estilo de marco « NoFrame » y un ancho de marco de 1 píxel.
Los argumentos « parent » y « f » se pasan al constructor « QWidget ».
[virtual noexcept] QFrame::~QFrame()
Destruye el marco.
[override virtual protected] void QFrame::changeEvent(QEvent *ev)
Reimplementa: ` QWidget::changeEvent(QEvent *event)`.
[override virtual protected] bool QFrame::event(QEvent *e)
Reimplementa: ` QWidget::event(QEvent *event)`.
int QFrame::frameStyle() const
Devuelve el estilo del marco.
El valor por defecto es « QFrame::Plain ».
Véase también setFrameStyle(), frameShape() y frameShadow().
[virtual protected] void QFrame::initStyleOption(QStyleOptionFrame *option) const
Inicializa ` option ` con los valores de este ` QFrame`. Este método resulta útil para las subclases cuando necesitan un ` QStyleOptionFrame `, pero no desean rellenar toda la información ellas mismas.
Véase también QStyleOption::initFrom().
[override virtual protected] void QFrame::paintEvent(QPaintEvent *)
Reimplementa: QWidget::paintEvent(QPaintEvent *event).
void QFrame::setFrameStyle(int style)
Establece el estilo del marco en « style ».
style es el OR bit a bit entre una forma de marco y un estilo de sombra de marco. Véase la imagen de los marcos en la documentación de la clase principal.
Las formas de los marcos se indican en QFrame::Shape y los estilos de sombra en QFrame::Shadow.
Si se especifica un ancho de línea central superior a 0, se dibuja una línea adicional para los marcos Raised o Sunken Box , HLine y VLine. Para dibujar las líneas centrales se utiliza el color central del grupo de colores actual.
Véase también frameStyle().
[override virtual] QSize QFrame::sizeHint() const
Reimplementa una función de acceso para la propiedad: QWidget::sizeHint.
© 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.