|  | Home · All Classes · Modules

# QLCDNumber Class Reference
[QtGui module]

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

Inherits QFrame.

### Types

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

### Methods

- __init__ (self, QWidget parent = None)
- __init__ (self, int numDigits, QWidget parent = None)
- bool checkOverflow (self, float num)
- bool checkOverflow (self, int num)
- int digitCount (self)
- display (self, QString str)
- display (self, float num)
- display (self, int num)
- bool event (self, QEvent e)
- int intValue (self)
- Mode mode (self)
- int numDigits (self)
- paintEvent (self, QPaintEvent)
- SegmentStyle segmentStyle (self)
- setBinMode (self)
- setDecMode (self)
- setDigitCount (self, int nDigits)
- setHexMode (self)
- setMode (self, Mode)
- setNumDigits (self, int nDigits)
- setOctMode (self)
- setSegmentStyle (self, SegmentStyle)
- setSmallDecimalPoint (self, bool)
- QSize sizeHint (self)
- bool smallDecimalPoint (self)
- float value (self)

### Qt Signals

- void overflow ()

## Detailed Description

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

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.

LCD number widgets shown in various widget styles (from left to right): Motif, CDE, Windows, Windows XP, Macintosh, Plastique.

## Type Documentation

### QLCDNumber.Mode

This type determines how numbers are shown.

Constant | Value | Description
--- | --- | ---
`QLCDNumber.Hex` | `0` | Hexadecimal
`QLCDNumber.Dec` | `1` | Decimal
`QLCDNumber.Oct` | `2` | Octal
`QLCDNumber.Bin` | `3` | Binary

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

### QLCDNumber.SegmentStyle

This type determines the visual appearance of the QLCDNumber widget.

Constant | Value | Description
--- | --- | ---
`QLCDNumber.Outline` | `0` | gives raised segments filled with the background color.
`QLCDNumber.Filled` | `1` | gives raised segments filled with the windowText color.
`QLCDNumber.Flat` | `2` | gives flat segments filled with the windowText color.

## Method Documentation

### QLCDNumber.__init__ (self, QWidget parent = None)

The parent argument, if not None, causes self to be owned by Qt instead of PyQt.

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() and setSmallDecimalPoint().

### QLCDNumber.__init__ (self, int numDigits, QWidget parent = None)

The parent argument, if not None, causes self to be owned by Qt instead of PyQt.

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() and setSmallDecimalPoint().

### bool QLCDNumber.checkOverflow (self, float num)

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

See also display(), digitCount(), and smallDecimalPoint().

### bool QLCDNumber.checkOverflow (self, int num)

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(), and smallDecimalPoint().

### int QLCDNumber.digitCount (self)

### QLCDNumber.display (self, QString str)

### QLCDNumber.display (self, float num)

### QLCDNumber.display (self, int num)

### bool QLCDNumber.event (self, QEvent e)

Reimplemented from QObject.event().

### int QLCDNumber.intValue (self)

### Mode QLCDNumber.mode (self)

### int QLCDNumber.numDigits (self)

### QLCDNumber.paintEvent (self, QPaintEvent)

Reimplemented from QWidget.paintEvent().

### SegmentStyle QLCDNumber.segmentStyle (self)

### QLCDNumber.setBinMode (self)

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

See also setMode(), setHexMode(), setDecMode(), setOctMode(), and mode().

### QLCDNumber.setDecMode (self)

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

See also setMode(), setHexMode(), setOctMode(), setBinMode(), and mode().

### QLCDNumber.setDigitCount (self, int nDigits)

### QLCDNumber.setHexMode (self)

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

See also setMode(), setDecMode(), setOctMode(), setBinMode(), and mode().

### QLCDNumber.setMode (self, Mode)

### QLCDNumber.setNumDigits (self, int nDigits)

### QLCDNumber.setOctMode (self)

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

See also setMode(), setHexMode(), setDecMode(), setBinMode(), and mode().

### QLCDNumber.setSegmentStyle (self, SegmentStyle)

### QLCDNumber.setSmallDecimalPoint (self, bool)

### QSize QLCDNumber.sizeHint (self)

Reimplemented from QWidget.sizeHint().

### bool QLCDNumber.smallDecimalPoint (self)

### float QLCDNumber.value (self)

## Qt Signal Documentation

### void overflow ()

This is the default overload of this signal.

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().