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

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.
| Constante | Valor | Descripción |
|---|---|---|
QLCDNumber::Hex | 0 | Hexadecimal |
QLCDNumber::Dec | 1 | Decimal |
QLCDNumber::Oct | 2 | Octal |
QLCDNumber::Bin | 3 | Binario |
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 ».
| Constante | Valor | Descripción |
|---|---|---|
QLCDNumber::Outline | 0 | proporciona segmentos en relieve rellenos con el color de fondo. |
QLCDNumber::Filled | 1 | Proporciona segmentos en relieve rellenos con el color «windowText». |
QLCDNumber::Flat | 2 | Proporciona 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:
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.
| Estilo | Resultado |
|---|---|
Outline | Genera 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. |
Flat | Crea 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:
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: 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); }); [slot] void QLCDNumber::display(double num)
Muestra el número num.
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); }); [slot] void QLCDNumber::display(int num)
Muestra el número num.
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); }); [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.