com.trolltech.qt.gui
Class QLCDNumber

java.lang.Object
  extended by com.trolltech.qt.QSignalEmitter
      extended by com.trolltech.qt.QtJambiObject
          extended by com.trolltech.qt.core.QObject
              extended by com.trolltech.qt.gui.QWidget
                  extended by com.trolltech.qt.gui.QFrame
                      extended by com.trolltech.qt.gui.QLCDNumber
All Implemented Interfaces:
QPaintDeviceInterface, QtJambiInterface

public class QLCDNumber
extends QFrame

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 setNumDigits, 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.

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

See Also:
QLabel, QFrame, Clock Example, Tetrix Example

Nested Class Summary
static class QLCDNumber.Mode
          This type determines how numbers are shown.
static class QLCDNumber.SegmentStyle
          This type determines the visual appearance of the QLCDNumber widget.
 
Nested classes/interfaces inherited from class com.trolltech.qt.gui.QFrame
QFrame.Shadow, QFrame.Shape, QFrame.StyleMask
 
Nested classes/interfaces inherited from class com.trolltech.qt.gui.QWidget
QWidget.RenderFlag, QWidget.RenderFlags
 
Nested classes/interfaces inherited from class com.trolltech.qt.QSignalEmitter
QSignalEmitter.Signal0, QSignalEmitter.Signal1<A>, QSignalEmitter.Signal2<A,B>, QSignalEmitter.Signal3<A,B,C>, QSignalEmitter.Signal4<A,B,C,D>, QSignalEmitter.Signal5<A,B,C,D,E>, QSignalEmitter.Signal6<A,B,C,D,E,F>, QSignalEmitter.Signal7<A,B,C,D,E,F,G>, QSignalEmitter.Signal8<A,B,C,D,E,F,G,H>, QSignalEmitter.Signal9<A,B,C,D,E,F,G,H,I>
 
Field Summary
 QSignalEmitter.Signal0 overflow
          This signal is emitted whenever the QLCDNumber is asked to display a too-large number or a too-long string.
 
Fields inherited from class com.trolltech.qt.gui.QWidget
customContextMenuRequested
 
Constructor Summary
QLCDNumber()
          Equivalent to QLCDNumber(0).
QLCDNumber(int numDigits)
          Equivalent to QLCDNumber(numDigits, 0).
QLCDNumber(int numDigits, QWidget parent)
          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.
QLCDNumber(QWidget parent)
          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.
 
Method Summary
 boolean checkOverflow(double num)
          Returns true if num is too big to be displayed in its entirety; otherwise returns false.
 boolean checkOverflow(int num)
          Returns true if num is too big to be displayed in its entirety; otherwise returns false.
 void display(double num)
          Sets the displayed value rounded to the nearest integer to num.
 void display(int num)
          Sets the displayed value rounded to the nearest integer to num.
 void display(java.lang.String str)
          Sets the displayed value rounded to the nearest integer to str.
 boolean event(QEvent e)
          This function is reimplemented for internal reasons.
static QLCDNumber fromNativePointer(QNativePointer nativePointer)
          This function returns the QLCDNumber instance pointed to by nativePointer
 int intValue()
          Returns the displayed value rounded to the nearest integer.
 QLCDNumber.Mode mode()
          Returns the current display mode (number base).
 int numDigits()
          Returns the current number of digits displayed.
protected  void paintEvent(QPaintEvent arg__1)
          This function is reimplemented for internal reasons.
 QLCDNumber.SegmentStyle segmentStyle()
          Returns the style of the LCDNumber.
 void setBinMode()
          Calls setMode(Bin).
 void setDecMode()
          Calls setMode(Dec).
 void setHexMode()
          Calls setMode(Hex).
 void setMode(QLCDNumber.Mode arg__1)
          Sets the current display mode (number base) to arg__1.
 void setNumDigits(int nDigits)
          Sets the current number of digits displayed to nDigits.
 void setOctMode()
          Calls setMode(Oct).
 void setSegmentStyle(QLCDNumber.SegmentStyle arg__1)
          Sets the style of the LCDNumber to arg__1.
 void setSmallDecimalPoint(boolean arg__1)
          Sets the style of the decimal point to arg__1.
 QSize sizeHint()
          This function is reimplemented for internal reasons.
 boolean smallDecimalPoint()
          Returns the style of the decimal point.
 double value()
          Returns the displayed value.
 
Methods inherited from class com.trolltech.qt.gui.QFrame
changeEvent, drawFrame, frameRect, frameShadow, frameShape, frameStyle, frameWidth, lineWidth, midLineWidth, setFrameRect, setFrameShadow, setFrameShape, setFrameStyle, setLineWidth, setMidLineWidth
 
Methods inherited from class com.trolltech.qt.gui.QWidget
acceptDrops, accessibleDescription, accessibleName, actionEvent, actions, activateWindow, addAction, addActions, adjustSize, autoFillBackground, backgroundRole, baseSize, childAt, childAt, childrenRect, childrenRegion, clearFocus, clearMask, close, closeEvent, contentsRect, contextMenuEvent, contextMenuPolicy, createWinId, cursor, depth, destroy, destroy, destroy, devType, dragEnterEvent, dragLeaveEvent, dragMoveEvent, dropEvent, ensurePolished, enterEvent, focusInEvent, focusNextChild, focusNextPrevChild, focusOutEvent, focusPolicy, focusPreviousChild, focusProxy, focusWidget, font, fontInfo, fontMetrics, foregroundRole, frameGeometry, frameSize, geometry, getContentsMargins, grabKeyboard, grabMouse, grabMouse, grabShortcut, grabShortcut, hasFocus, hasMouseTracking, height, heightForWidth, heightMM, hide, hideEvent, inputContext, inputMethodEvent, inputMethodQuery, insertAction, insertActions, isActiveWindow, isAncestorOf, isEnabled, isEnabledTo, isFullScreen, isHidden, isLeftToRight, isMaximized, isMinimized, isModal, isRightToLeft, isVisible, isVisibleTo, isWindow, isWindowModified, keyboardGrabber, keyPressEvent, keyReleaseEvent, layout, layoutDirection, leaveEvent, locale, logicalDpiX, logicalDpiY, lower, mapFrom, mapFromGlobal, mapFromParent, mapTo, mapToGlobal, mapToParent, mask, maximumHeight, maximumSize, maximumWidth, metric, minimumHeight, minimumSize, minimumSizeHint, minimumWidth, mouseDoubleClickEvent, mouseGrabber, mouseMoveEvent, mousePressEvent, mouseReleaseEvent, move, move, moveEvent, nextInFocusChain, normalGeometry, numColors, overrideWindowFlags, overrideWindowFlags, overrideWindowState, overrideWindowState, paintEngine, paintingActive, palette, parentWidget, physicalDpiX, physicalDpiY, pos, raise, rect, releaseKeyboard, releaseMouse, releaseShortcut, removeAction, render, render, render, render, render, repaint, repaint, repaint, repaint, resetInputContext, resize, resize, resizeEvent, restoreGeometry, saveGeometry, scroll, scroll, setAcceptDrops, setAccessibleDescription, setAccessibleName, setAttribute, setAttribute, setAutoFillBackground, setBackgroundRole, setBaseSize, setBaseSize, setContentsMargins, setContentsMargins, setContextMenuPolicy, setCursor, setDisabled, setEnabled, setFixedHeight, setFixedSize, setFixedSize, setFixedWidth, setFocus, setFocus, setFocusPolicy, setFocusProxy, setFont, setForegroundRole, setGeometry, setGeometry, setHidden, setInputContext, setLayout, setLayoutDirection, setLocale, setMask, setMask, setMaximumHeight, setMaximumSize, setMaximumSize, setMaximumWidth, setMinimumHeight, setMinimumSize, setMinimumSize, setMinimumWidth, setMouseTracking, setPalette, setParent, setParent, setParent, setShortcutAutoRepeat, setShortcutAutoRepeat, setShortcutEnabled, setShortcutEnabled, setSizeIncrement, setSizeIncrement, setSizePolicy, setSizePolicy, setStatusTip, setStyle, setStyleSheet, setTabOrder, setToolTip, setUpdatesEnabled, setVisible, setWhatsThis, setWindowFlags, setWindowFlags, setWindowIcon, setWindowIconText, setWindowModality, setWindowModified, setWindowOpacity, setWindowRole, setWindowState, setWindowState, setWindowTitle, show, showEvent, showFullScreen, showMaximized, showMinimized, showNormal, size, sizeIncrement, sizePolicy, stackUnder, statusTip, style, styleSheet, tabletEvent, testAttribute, toolTip, underMouse, unsetCursor, unsetLayoutDirection, unsetLocale, update, update, update, update, updateGeometry, updateMicroFocus, updatesEnabled, visibleRegion, whatsThis, wheelEvent, width, widthMM, window, windowFlags, windowIcon, windowIconText, windowModality, windowOpacity, windowRole, windowState, windowTitle, windowType, winId, x, y
 
Methods inherited from class com.trolltech.qt.core.QObject
blockSignals, childEvent, children, connectSlotsByName, customEvent, disposeLater, dumpObjectInfo, dumpObjectTree, dynamicPropertyNames, eventFilter, findChild, findChild, findChild, findChildren, findChildren, findChildren, findChildren, installEventFilter, isWidgetType, killTimer, moveToThread, objectName, parent, property, removeEventFilter, setObjectName, setParent, setProperty, signalsBlocked, startTimer, thread, timerEvent
 
Methods inherited from class com.trolltech.qt.QtJambiObject
dispose, disposed, finalize, reassignNativeResources, tr, tr, tr
 
Methods inherited from class com.trolltech.qt.QSignalEmitter
disconnect, disconnect, signalSender
 
Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface com.trolltech.qt.QtJambiInterface
disableGarbageCollection, nativeId, nativePointer, reenableGarbageCollection, setJavaOwnership
 

Field Detail

overflow

public final QSignalEmitter.Signal0 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 setNumDigits.

Compatible Slot Signature:
void mySlot()

Constructor Detail

QLCDNumber

public QLCDNumber()

Equivalent to QLCDNumber(0).


QLCDNumber

public QLCDNumber(QWidget parent)

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:
setNumDigits, setSmallDecimalPoint

QLCDNumber

public QLCDNumber(int numDigits)

Equivalent to QLCDNumber(numDigits, 0).


QLCDNumber

public QLCDNumber(int numDigits,
                  QWidget parent)

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

The parent argument is passed to the QFrame constructor.

See Also:
setNumDigits, setSmallDecimalPoint
Method Detail

checkOverflow

public final boolean checkOverflow(int num)

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

See Also:
display, numDigits, smallDecimalPoint

checkOverflow

public final boolean checkOverflow(double num)

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

See Also:
display, numDigits, smallDecimalPoint

display

public final void display(int num)

Sets the displayed value rounded to the nearest integer to num.

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.


display

public final void display(double num)

Sets the displayed value rounded to the nearest integer to num.

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.


display

public final void display(java.lang.String str)

Sets the displayed value rounded to the nearest integer to str.

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.


intValue

public final int intValue()

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


mode

public final QLCDNumber.Mode mode()

Returns 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:
setMode, smallDecimalPoint, setHexMode, setDecMode, setOctMode, setBinMode

numDigits

public final int numDigits()

Returns the current number of digits displayed.

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

See Also:
setNumDigits, smallDecimalPoint

segmentStyle

public final QLCDNumber.SegmentStyle segmentStyle()

Returns the style of the LCDNumber.

StyleResult
OutlineProduces raised segments filled with the background color (this is the default).
FilledProduces raised segments filled with the foreground color.
FlatProduces flat segments filled with the foreground color.

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

See Also:
setSegmentStyle

setBinMode

public final void setBinMode()

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

See Also:
setMode, setHexMode, setDecMode, setOctMode, mode

setDecMode

public final void setDecMode()

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

See Also:
setMode, setHexMode, setOctMode, setBinMode, mode

setHexMode

public final void setHexMode()

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

See Also:
setMode, setDecMode, setOctMode, setBinMode, mode

setMode

public final void setMode(QLCDNumber.Mode arg__1)

Sets the current display mode (number base) to arg__1.

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:
mode, smallDecimalPoint, setHexMode, setDecMode, setOctMode, setBinMode

setNumDigits

public final void setNumDigits(int nDigits)

Sets the current number of digits displayed to nDigits.

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

See Also:
numDigits, smallDecimalPoint

setOctMode

public final void setOctMode()

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

See Also:
setMode, setHexMode, setDecMode, setBinMode, mode

setSegmentStyle

public final void setSegmentStyle(QLCDNumber.SegmentStyle arg__1)

Sets the style of the LCDNumber to arg__1.

StyleResult
OutlineProduces raised segments filled with the background color (this is the default).
FilledProduces raised segments filled with the foreground color.
FlatProduces flat segments filled with the foreground color.

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

See Also:
segmentStyle

setSmallDecimalPoint

public final void setSmallDecimalPoint(boolean arg__1)

Sets the style of the decimal point to arg__1.

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:
smallDecimalPoint, mode

smallDecimalPoint

public final boolean smallDecimalPoint()

Returns 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:
setSmallDecimalPoint, mode

value

public final double value()

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


event

public boolean event(QEvent e)

This function is reimplemented for internal reasons.

Overrides:
event in class QFrame
See Also:
closeEvent, focusInEvent, focusOutEvent, enterEvent, keyPressEvent, keyReleaseEvent, leaveEvent, mouseDoubleClickEvent, mouseMoveEvent, mousePressEvent, mouseReleaseEvent, moveEvent, paintEvent, resizeEvent, QObject::event, QObject::timerEvent

paintEvent

protected void paintEvent(QPaintEvent arg__1)

This function is reimplemented for internal reasons.

Overrides:
paintEvent in class QFrame
See Also:
event, repaint, update, QPainter, QPixmap, QPaintEvent, Analog Clock Example

sizeHint

public QSize sizeHint()

This function is reimplemented for internal reasons.

Overrides:
sizeHint in class QFrame
See Also:
QSize::isValid, minimumSizeHint, sizePolicy, setMinimumSize, updateGeometry

fromNativePointer

public static QLCDNumber fromNativePointer(QNativePointer nativePointer)
This function returns the QLCDNumber instance pointed to by nativePointer

Parameters:
nativePointer - the QNativePointer of which object should be returned.