QLCDNumber

The QLCDNumber widget displays a number with LCD-like digits. More…

Synopsis

Properties

• digitCount - The current number of digits displayed

• intValue - The displayed value rounded to the nearest integer

• mode - The current display mode (number base)

• segmentStyle - The style of the LCDNumber

• smallDecimalPoint - The style of the decimal point

• value - The displayed value

Functions

• def checkOverflow (num)

• def checkOverflow (num)

• def digitCount ()

• def intValue ()

• def mode ()

• def segmentStyle ()

• def setDigitCount (nDigits)

• def setMode (arg__1)

• def setSegmentStyle (arg__1)

• def smallDecimalPoint ()

• def value ()

Slots

• def display (str)

• def display (num)

• def display (num)

• def setBinMode ()

• def setDecMode ()

• def setHexMode ()

• def setOctMode ()

• def setSmallDecimalPoint (arg__1)

Signals

• def overflow ()

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

Detailed Description

It can display a number in just about any size. It can display decimal, hexadecimal, octal or binary numbers. It is easy to connect to data sources using the display() slot, which is overloaded to take any of five argument types.

There are also slots to change the base with setMode() and the decimal point with setSmallDecimalPoint() .

QLCDNumber emits the overflow() signal when it is asked to display something beyond its range. The range is set by setDigitCount() , but setSmallDecimalPoint() also influences it. If the display is set to hexadecimal, octal or binary, the integer equivalent of the value is displayed.

These digits and other symbols can be shown: 0/O, 1, 2, 3, 4, 5/S, 6, 7, 8, 9/g, minus, decimal point, A, B, C, D, E, F, h, H, L, o, P, r, u, U, Y, colon, degree sign (which is specified as single quote in the string) and space. QLCDNumber substitutes spaces for illegal characters.

It is not possible to retrieve the contents of a QLCDNumber object, although you can retrieve the numeric value with value() . If you really need the text, we recommend that you connect the signals that feed the display() slot to another slot as well and store the value there.

Incidentally, QLCDNumber is the very oldest part of Qt, tracing its roots back to a BASIC program on the Sinclair Spectrum .

See also

QLabel QFrame Digital Clock Example Tetrix Example

class PySide6.QtWidgets.QLCDNumber([parent=None])

PySide6.QtWidgets.QLCDNumber(numDigits[, parent=None])

Parameters:

• numDigits – uint

• parent – PySide6.QtWidgets.QWidget

Constructs an LCD number, sets the number of digits to 5, the base to decimal, the decimal point mode to ‘small’ and the frame style to a raised box. The segmentStyle() is set to Outline.

The parent argument is passed to the QFrame constructor.

See also

setDigitCount() setSmallDecimalPoint()

Constructs an LCD number, sets the number of digits to numDigits, the base to decimal, the decimal point mode to ‘small’ and the frame style to a raised box. The segmentStyle() is set to Filled.

The parent argument is passed to the QFrame constructor.

See also

setDigitCount() setSmallDecimalPoint()

Note

Properties can be used directly when from __feature__ import true_property is used or via accessor functions otherwise.

property PᅟySide6.QtWidgets.QLCDNumber.digitCount: int

This property holds the current number of digits displayed.

Corresponds to the current number of digits. If smallDecimalPoint is false, the decimal point occupies one digit position.

By default, this property contains a value of 5.

See also

smallDecimalPoint

Access functions:

• digitCount ()

• setDigitCount (nDigits)

property PᅟySide6.QtWidgets.QLCDNumber.intValue: int

This property holds the displayed value rounded to the nearest integer.

This property corresponds to the nearest integer to the current value displayed by the LCDNumber. This is the value used for hexadecimal, octal and binary modes.

If the displayed value is not a number, the property has a value of 0.

By default, this property contains a value of 0.

Access functions:

• intValue ()

• display (str)

property PᅟySide6.QtWidgets.QLCDNumber.mode: Mode

This property holds the current display mode (number base).

Corresponds to the current display mode, which is one of Bin, Oct, Dec (the default) and Hex. Dec mode can display floating point values, the other modes display the integer equivalent.

See also

smallDecimalPoint() setHexMode() setDecMode() setOctMode() setBinMode()

Access functions:

• mode ()

• setMode (arg__1)

property PᅟySide6.QtWidgets.QLCDNumber.segmentStyle: SegmentStyle

This property holds the style of the LCDNumber.

Style	Result
Outline	Produces raised segments filled with the background color
Filled (this is the default).	Produces raised segments filled with the foreground color.
Flat	Produces flat segments filled with the foreground color.

Outline and Filled will additionally use light() and dark() for shadow effects.

Access functions:

• segmentStyle ()

• setSegmentStyle (arg__1)

property PᅟySide6.QtWidgets.QLCDNumber.smallDecimalPoint: bool

This property holds the style of the decimal point.

If true the decimal point is drawn between two digit positions. Otherwise it occupies a digit position of its own, i.e. is drawn in a digit position. The default is false.

The inter-digit space is made slightly wider when the decimal point is drawn between the digits.

See also

mode

Access functions:

• smallDecimalPoint ()

• setSmallDecimalPoint (arg__1)

property PᅟySide6.QtWidgets.QLCDNumber.value: double

This property holds the displayed value.

This property corresponds to the current value displayed by the LCDNumber.

If the displayed value is not a number, the property has a value of 0.

By default, this property contains a value of 0.

Access functions:

• value ()

• display (str)

PySide6.QtWidgets.QLCDNumber.Mode

This type determines how numbers are shown.

Constant	Description
QLCDNumber.Hex	Hexadecimal
QLCDNumber.Dec	Decimal
QLCDNumber.Oct	Octal
QLCDNumber.Bin	Binary

If the display is set to hexadecimal, octal or binary, the integer equivalent of the value is displayed.

PySide6.QtWidgets.QLCDNumber.SegmentStyle

This type determines the visual appearance of the QLCDNumber widget.

Constant	Description
QLCDNumber.Outline	gives raised segments filled with the background color.
QLCDNumber.Filled	gives raised segments filled with the windowText color.
QLCDNumber.Flat	gives flat segments filled with the windowText color.

PySide6.QtWidgets.QLCDNumber.checkOverflow(num)

Parameters:

num – int

Return type:

bool

This is an overloaded function.

Returns true if num is too big to be displayed in its entirety; otherwise returns false.

See also

display() digitCount() smallDecimalPoint()

PySide6.QtWidgets.QLCDNumber.checkOverflow(num)

Parameters:

num – double

Return type:

bool

Returns true if num is too big to be displayed in its entirety; otherwise returns false.

See also

display() digitCount() smallDecimalPoint()

PySide6.QtWidgets.QLCDNumber.digitCount()

Return type:

int

Returns the current number of digits.

See also

setDigitCount()

Getter of property digitCount .

PySide6.QtWidgets.QLCDNumber.display(str)

Parameters:

str – str

Displays the number represented by the string s.

This version of the function disregards mode() and smallDecimalPoint() .

These digits and other symbols can be shown: 0/O, 1, 2, 3, 4, 5/S, 6, 7, 8, 9/g, minus, decimal point, A, B, C, D, E, F, h, H, L, o, P, r, u, U, Y, colon, degree sign (which is specified as single quote in the string) and space. QLCDNumber substitutes spaces for illegal characters.

PySide6.QtWidgets.QLCDNumber.display(num)

Parameters:

num – double

This is an overloaded function.

Displays the number num.

Setter of property value .

PySide6.QtWidgets.QLCDNumber.display(num)

Parameters:

num – int

This is an overloaded function.

Displays the number num.

PySide6.QtWidgets.QLCDNumber.intValue()

Return type:

int

Getter of property intValue .

PySide6.QtWidgets.QLCDNumber.mode()

Return type:

Mode

See also

setMode()

Getter of property mode .

PySide6.QtWidgets.QLCDNumber.overflow()

This signal is emitted whenever the QLCDNumber is asked to display a too-large number or a too-long string.

It is never emitted by setDigitCount() .

PySide6.QtWidgets.QLCDNumber.segmentStyle()

Return type:

SegmentStyle

See also

setSegmentStyle()

Getter of property segmentStyle .

PySide6.QtWidgets.QLCDNumber.setBinMode()

Calls setMode (Bin). Provided for convenience (e.g. for connecting buttons to it).

See also

setMode() setHexMode() setDecMode() setOctMode() mode()

PySide6.QtWidgets.QLCDNumber.setDecMode()

Calls setMode (Dec). Provided for convenience (e.g. for connecting buttons to it).

See also

setMode() setHexMode() setOctMode() setBinMode() mode()

PySide6.QtWidgets.QLCDNumber.setDigitCount(nDigits)

Parameters:

nDigits – int

Sets the current number of digits to numDigits. Must be in the range 0..99.

See also

digitCount()

Setter of property digitCount .

PySide6.QtWidgets.QLCDNumber.setHexMode()

Calls setMode (Hex). Provided for convenience (e.g. for connecting buttons to it).

See also

setMode() setDecMode() setOctMode() setBinMode() mode()

PySide6.QtWidgets.QLCDNumber.setMode(arg__1)

Parameters:

arg__1 – Mode

See also

mode()

Setter of property mode .

PySide6.QtWidgets.QLCDNumber.setOctMode()

Calls setMode (Oct). Provided for convenience (e.g. for connecting buttons to it).

See also

setMode() setHexMode() setDecMode() setBinMode() mode()

PySide6.QtWidgets.QLCDNumber.setSegmentStyle(arg__1)

Parameters:

arg__1 – SegmentStyle

See also

segmentStyle()

Setter of property segmentStyle .

PySide6.QtWidgets.QLCDNumber.setSmallDecimalPoint(arg__1)

Parameters:

arg__1 – bool

See also

smallDecimalPoint()

Setter of property smallDecimalPoint .

PySide6.QtWidgets.QLCDNumber.smallDecimalPoint()

Return type:

bool

See also

setSmallDecimalPoint()

Getter of property smallDecimalPoint .

PySide6.QtWidgets.QLCDNumber.value()

Return type:

double

Getter of property value .