En esta página

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:

Tabla de estilos de monturas

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.

ConstanteValorDescripción
QFrame::Plain0x0010el 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::Raised0x0020el 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::Sunken0x0030el 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.

ConstanteValorDescripción
QFrame::NoFrame0QFrame No dibuja nada
QFrame::Box0x0001QFrame dibuja un recuadro alrededor de su contenido
QFrame::Panel0x0002QFrame dibuja un panel para que el contenido parezca elevado o hundido
QFrame::StyledPanel0x0006dibuja un panel rectangular cuyo aspecto depende del estilo actual de la interfaz gráfica de usuario. Puede estar en relieve o hundido.
QFrame::HLine0x0004QFrame dibuja una línea horizontal que no enmarca nada (útil como separador)
QFrame::VLine0x0005QFrame dibuja una línea vertical que no enmarca nada (útil como separador)
QFrame::WinPanel0x0003dibuja 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()`:

ConstanteValorDescripción
QFrame::Shadow_Mask0x00f0La parte « Shadow » de « frameStyle()»
QFrame::Shape_Mask0x000fLa 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.