En esta página

QLCDNumber Class

El widget QLCDNumber muestra un número con dígitos similares a los de una pantalla LCD. Más información...

Encabezado: #include <QLCDNumber>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredado de: QFrame

Tipos públicos

enum Mode { Hex, Dec, Oct, Bin }
enum SegmentStyle { Outline, Filled, Flat }

Propiedades

Funciones públicas

QLCDNumber(QWidget *parent = nullptr)
QLCDNumber(uint numDigits, QWidget *parent = nullptr)
virtual ~QLCDNumber()
bool checkOverflow(double num) const
bool checkOverflow(int num) const
int digitCount() const
int intValue() const
QLCDNumber::Mode mode() const
QLCDNumber::SegmentStyle segmentStyle() const
void setDigitCount(int numDigits)
void setMode(QLCDNumber::Mode)
void setSegmentStyle(QLCDNumber::SegmentStyle)
bool smallDecimalPoint() const
double value() const

Funciones públicas reimplementadas

virtual QSize sizeHint() const override

Ranuras públicas

void display(const QString &s)
void display(double num)
void display(int num)
void setBinMode()
void setDecMode()
void setHexMode()
void setOctMode()
void setSmallDecimalPoint(bool)

Señales

void overflow()

Funciones protegidas reimplementadas

virtual bool event(QEvent *e) override
virtual void paintEvent(QPaintEvent *) override

Descripción detallada

«1234» con aspecto digital similar al de una pantalla LCD

Puede mostrar un número en prácticamente cualquier tamaño. Puede mostrar números decimales, hexadecimales, octales o binarios. Es fácil conectarlo a fuentes de datos mediante la ranura display(), que está sobrecargada para admitir cualquiera de los cinco tipos de argumentos.

También hay ranuras para cambiar la base con setMode() y el punto decimal con setSmallDecimalPoint().

QLCDNumber emite la señal « overflow()» cuando se le pide que muestre algo fuera de su rango. El rango se establece mediante « setDigitCount()», pero « setSmallDecimalPoint()» también influye en él. Si la visualización está configurada en hexadecimal, octal o binario, se muestra el equivalente entero del valor.

Se pueden mostrar estos dígitos y otros símbolos: 0/O, 1, 2, 3, 4, 5/S, 6, 7, 8, 9/g, signo menos, punto decimal, A, B, C, D, E, F, h, H, L, o, P, r, u, U, Y, dos puntos, el signo de grado (que se especifica como comilla simple en la cadena) y el espacio. QLCDNumber sustituye los caracteres no válidos por espacios.

No es posible recuperar el contenido de un objeto QLCDNumber, aunque sí se puede obtener el valor numérico mediante ` value()`. Si realmente necesitas el texto, te recomendamos que conectes las señales que alimentan la ranura ` display()` a otra ranura también y almacenes el valor allí.

Por cierto, QLCDNumber es la parte más antigua de Qt, cuyos orígenes se remontan a un programa en BASIC para el Sinclair Spectrum.

Véase también QLabel y QFrame.

Documentación sobre tipos de miembros

enum QLCDNumber::Mode

Este tipo determina cómo se muestran los números.

ConstanteValorDescripción
QLCDNumber::Hex0Hexadecimal
QLCDNumber::Dec1Decimal
QLCDNumber::Oct2Octal
QLCDNumber::Bin3Binario

Si la visualización está configurada en hexadecimal, octal o binario, se muestra el equivalente entero del valor.

enum QLCDNumber::SegmentStyle

Este tipo determina el aspecto visual del widget « QLCDNumber ».

ConstanteValorDescripción
QLCDNumber::Outline0proporciona segmentos en relieve rellenos con el color de fondo.
QLCDNumber::Filled1Proporciona segmentos en relieve rellenos con el color «windowText».
QLCDNumber::Flat2Proporciona segmentos planos rellenos con el color de windowText.

Documentación de la propiedad

digitCount : int

Esta propiedad contiene el número actual de dígitos que se muestran

Corresponde al número actual de dígitos. Si « QLCDNumber::smallDecimalPoint » es «false», el punto decimal ocupa una posición de dígito.

Por defecto, esta propiedad contiene un valor de 5.

Funciones de acceso:

int digitCount() const
void setDigitCount(int numDigits)

Véase también smallDecimalPoint.

intValue : int

Esta propiedad contiene el valor mostrado redondeado al entero más cercano

Esta propiedad corresponde al entero más cercano al valor actual mostrado por LCDNumber. Este es el valor que se utiliza en los modos hexadecimal, octal y binario.

Si el valor mostrado no es un número, la propiedad tiene un valor de 0.

Por defecto, esta propiedad contiene el valor 0.

Funciones de acceso:

int intValue() const
void display(const QString &s)
void display(int num)
void display(double num)

mode : Mode

Esta propiedad contiene el modo de visualización actual (base numérica)

Corresponde al modo de visualización actual, que puede ser uno de los siguientes: Bin, Oct, Dec (el predeterminado) y Hex. El modo Dec permite mostrar valores de coma flotante, mientras que los demás modos muestran el equivalente en números enteros.

Funciones de acceso:

QLCDNumber::Mode mode() const
void setMode(QLCDNumber::Mode)

Véase también smallDecimalPoint(), setHexMode(), setDecMode(), setOctMode() y setBinMode().

segmentStyle : SegmentStyle

Esta propiedad define el estilo del LCDNumber.

EstiloResultado
OutlineGenera segmentos en relieve rellenos con el color de fondo
Filled (este es el valor predeterminado).Genera segmentos en relieve rellenos con el color de primer plano.
FlatCrea segmentos planos rellenos con el color de primer plano.

Outline y « Filled » utilizará además « QPalette::light()» y « QPalette::dark()» para crear efectos de sombra.

Funciones de Access:

QLCDNumber::SegmentStyle segmentStyle() const
void setSegmentStyle(QLCDNumber::SegmentStyle)

smallDecimalPoint : bool

Esta propiedad define el estilo del punto decimal

Si es «true», el punto decimal se dibuja entre dos posiciones de dígito. En caso contrario, ocupa una posición de dígito propia, es decir, se dibuja en una posición de dígito. El valor por defecto es «false».

El espacio entre dígitos se amplía ligeramente cuando el punto decimal se dibuja entre los dígitos.

Funciones de acceso:

bool smallDecimalPoint() const
void setSmallDecimalPoint(bool)

Véase también « mode ».

value : double

Esta propiedad contiene el valor mostrado

Esta propiedad se corresponde con el valor actual mostrado por LCDNumber.

Si el valor mostrado no es un número, la propiedad tiene un valor de 0.

Por defecto, esta propiedad contiene el valor 0.

Funciones de acceso:

double value() const
void display(const QString &s)
void display(int num)
void display(double num)

Documentación de las funciones de miembro

[explicit] QLCDNumber::QLCDNumber(QWidget *parent = nullptr)

Crea un número para la pantalla LCD, establece el número de dígitos en 5, la base en decimal, el modo del punto decimal en «pequeño» y el estilo del marco en un recuadro en relieve. La variable ` segmentStyle()` se establece en ` Outline`.

El argumento ` parent ` se pasa al constructor ` QFrame `.

Véase también setDigitCount() y setSmallDecimalPoint().

[explicit] QLCDNumber::QLCDNumber(uint numDigits, QWidget *parent = nullptr)

Crea un número para la pantalla LCD, establece el número de dígitos en ` numDigits`, la base en decimal, el modo del punto decimal en «pequeño» y el estilo del marco en un recuadro elevado. La función ` segmentStyle()` se establece en ` Filled`.

El argumento ` parent ` se pasa al constructor ` QFrame `.

Véanse también setDigitCount() y setSmallDecimalPoint().

[virtual noexcept] QLCDNumber::~QLCDNumber()

Borra el número de la pantalla LCD.

bool QLCDNumber::checkOverflow(double num) const

Devuelve « true » si « num » es demasiado grande para mostrarse en su totalidad; en caso contrario, devuelve « false ».

Véase también display(), digitCount() y smallDecimalPoint().

bool QLCDNumber::checkOverflow(int num) const

Devuelve « true » si « num » es demasiado grande para mostrarse en su totalidad; en caso contrario, devuelve « false ».

Esta es una función sobrecargada.

Véase también display(), digitCount() y smallDecimalPoint().

int QLCDNumber::digitCount() const

Devuelve el número actual de dígitos.

Nota: Funcióngetter para la propiedad digitCount.

Véase también setDigitCount().

[slot] void QLCDNumber::display(const QString &s)

Muestra el número representado por la cadena « s ».

Esta versión de la función no tiene en cuenta las funciones ` mode()` ni ` smallDecimalPoint()`.

Se pueden mostrar estos dígitos y otros símbolos: 0/O, 1, 2, 3, 4, 5/S, 6, 7, 8, 9/g, signo menos, punto decimal, A, B, C, D, E, F, h, H, L, o, P, r, u, U, Y, dos puntos, el signo de grado (que se especifica como comilla simple en la cadena) y el espacio. QLCDNumber sustituye los caracteres no válidos por espacios.

Nota: Funciónsetter para las propiedades intValue y value.

Nota: Esta ranura está sobrecargada. Para conectarse a esta ranura:

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        lCDNumber, qOverload(&QLCDNumber::display));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        lCDNumber, [receiver = lCDNumber](const QString &s) { receiver->display(s); });
Para ver más ejemplos y enfoques, consulta la sección «Conexión a ranuras sobrecargadas».

[slot] void QLCDNumber::display(double num)

Muestra el número num.

Nota: Funciónde asignación para las propiedades intValue y value.

Nota: Esta ranura está sobrecargada. Para conectarse a esta ranura:

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        lCDNumber, qOverload(&QLCDNumber::display));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        lCDNumber, [receiver = lCDNumber](double num) { receiver->display(num); });
Para ver más ejemplos y métodos, consulta «Conexión a ranuras sobrecargadas».

[slot] void QLCDNumber::display(int num)

Muestra el número num.

Nota: Funciónde asignación para las propiedades intValue y value.

Nota: Esta ranura está sobrecargada. Para conectarse a esta ranura:

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        lCDNumber, qOverload(&QLCDNumber::display));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        lCDNumber, [receiver = lCDNumber](int num) { receiver->display(num); });
Para ver más ejemplos y formas de proceder, consulta «Conexión a ranuras sobrecargadas».

[override virtual protected] bool QLCDNumber::event(QEvent *e)

Reimplementa: QFrame::event(QEvent *e).

[signal] void QLCDNumber::overflow()

Esta señal se emite cada vez que se solicita a la clase ` QLCDNumber ` que muestre un número demasiado grande o una cadena demasiado larga.

setDigitCount() nunca emite esta señal.

[override virtual protected] void QLCDNumber::paintEvent(QPaintEvent *)

Reimplementa: QFrame::paintEvent(QPaintEvent *).

[slot] void QLCDNumber::setBinMode()

Llama a setMode(Bin). Se proporciona para mayor comodidad (por ejemplo, para conectarle botones).

Véanse también setMode(), setHexMode(), setDecMode(), setOctMode() y mode().

[slot] void QLCDNumber::setDecMode()

Llamadas a setMode(dic.). Se proporciona por comodidad (por ejemplo, para conectar botones a él).

Véanse también setMode(), setHexMode(), setOctMode(), setBinMode() y mode().

void QLCDNumber::setDigitCount(int numDigits)

Establece el número actual de dígitos en numDigits. Debe estar comprendido entre 0 y 99.

Nota: Funciónde asignación para la propiedad digitCount.

Véase también ` digitCount()`.

[slot] void QLCDNumber::setHexMode()

Llama a ` setMode` (Hex). Se proporciona por comodidad (por ejemplo, para conectarle botones).

Véanse también setMode(), setDecMode(), setOctMode(), setBinMode() y mode().

[slot] void QLCDNumber::setOctMode()

Llamadas setMode(oct.). Se proporcionan por comodidad (por ejemplo, para conectar botones a ellas).

Véase también setMode(), setHexMode(), setDecMode(), setBinMode() y mode().

[override virtual] QSize QLCDNumber::sizeHint() const

Reimplementa: QFrame::sizeHint() const.

© 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.