|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.trolltech.qt.internal.QSignalEmitterInternal
com.trolltech.qt.QSignalEmitter
com.trolltech.qt.QtJambiObject
com.trolltech.qt.core.QObject
com.trolltech.qt.gui.QWidget
com.trolltech.qt.gui.QProgressBar
public class QProgressBar
The QProgressBar
widget provides a horizontal or vertical progress bar. A progress bar is used to give the user an indication of the progress of an operation and to reassure them that the application is still running.
The progress bar uses the concept of steps. You set it up by specifying the minimum and maximum possible step values, and it will display the percentage of steps that have been completed when you later give it the current step value. The percentage is calculated by dividing the progress (value()
- minimum()
) divided by maximum()
- minimum()
.
You can specify the minimum and maximum number of steps with setMinimum()
and setMaximum. The current number of steps is set with setValue()
. The progress bar can be rewound to the beginning with reset()
.
If minimum and maximum both are set to 0, the bar shows a busy indicator instead of a percentage of steps. This is useful, for example, when using QFtp
or QHttp
to download items when they are unable to determine the size of the item being downloaded.
![]() | A progress bar shown in the Macintosh widget style. |
![]() | A progress bar shown in the Windows XP widget style. |
![]() | A progress bar shown in the Plastique widget style. |
QTimeLine
, QProgressDialog
, and GUI Design Handbook: Progress Indicator.
Nested Class Summary | |
---|---|
static class |
QProgressBar.Direction
This enum describes the direction of the timeline when in Running state. |
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.AbstractSignal, QSignalEmitter.Signal0, QSignalEmitter.Signal1, QSignalEmitter.Signal2, QSignalEmitter.Signal3, QSignalEmitter.Signal4, QSignalEmitter.Signal5, QSignalEmitter.Signal6, QSignalEmitter.Signal7, QSignalEmitter.Signal8, QSignalEmitter.Signal9 |
Nested classes/interfaces inherited from class com.trolltech.qt.internal.QSignalEmitterInternal |
---|
com.trolltech.qt.internal.QSignalEmitterInternal.AbstractSignalInternal |
Field Summary | |
---|---|
QSignalEmitter.Signal1 |
valueChanged
This signal takes 1 generic argument(s). |
Fields inherited from class com.trolltech.qt.gui.QWidget |
---|
customContextMenuRequested |
Fields inherited from class com.trolltech.qt.internal.QSignalEmitterInternal |
---|
currentSender |
Constructor Summary | |
---|---|
QProgressBar()
Constructs a progress bar with the given parent. |
|
QProgressBar(QWidget parent)
Constructs a progress bar with the given parent. |
Method Summary | |
---|---|
Qt.Alignment |
alignment()
This property holds the alignment of the progress bar. |
java.lang.String |
format()
This property holds the string used to generate the current text. |
protected void |
initStyleOption(QStyleOptionProgressBar option)
Initialize option with the values from this QProgressBar. |
boolean |
invertedAppearance()
This property holds whether or not a progress bar shows its progress inverted. |
boolean |
isTextVisible()
This property holds whether the current completed percentage should be displayed. |
int |
maximum()
This property holds the progress bar's maximum value. |
int |
minimum()
This property holds the progress bar's minimum value. |
Qt.Orientation |
orientation()
This property holds the orientation of the progress bar. |
void |
reset()
Reset the progress bar. |
void |
setAlignment(Qt.Alignment alignment)
This property holds the alignment of the progress bar. |
void |
setAlignment(Qt.AlignmentFlag[] alignment)
This property holds the alignment of the progress bar. |
void |
setFormat(java.lang.String format)
This property holds the string used to generate the current text. |
void |
setInvertedAppearance(boolean invert)
This property holds whether or not a progress bar shows its progress inverted. |
void |
setMaximum(int maximum)
This property holds the progress bar's maximum value. |
void |
setMinimum(int minimum)
This property holds the progress bar's minimum value. |
void |
setOrientation(Qt.Orientation arg__1)
This property holds the orientation of the progress bar. |
void |
setRange(int minimum,
int maximum)
Sets the progress bar's minimum and maximum values to minimum and maximum respectively. |
void |
setTextDirection(QProgressBar.Direction textDirection)
This property holds the reading direction of the text for vertical progress bars. |
void |
setTextVisible(boolean visible)
This property holds whether the current completed percentage should be displayed. |
void |
setValue(int value)
This property holds the progress bar's current value. |
java.lang.String |
text()
This property holds the descriptive text shown with the progress bar. |
QProgressBar.Direction |
textDirection()
This property holds the reading direction of the text for vertical progress bars. |
int |
value()
This property holds the progress bar's current value. |
Methods inherited from class com.trolltech.qt.core.QObject |
---|
childEvent, children, connectSlotsByName, customEvent, disposeLater, dumpObjectInfo, dumpObjectTree, dynamicPropertyNames, event, eventFilter, findChild, findChild, findChild, findChildren, findChildren, findChildren, findChildren, indexOfProperty, installEventFilter, isWidgetType, killTimer, moveToThread, objectName, parent, properties, property, removeEventFilter, setObjectName, setParent, setProperty, startTimer, timerEvent, toString, userProperty |
Methods inherited from class com.trolltech.qt.QtJambiObject |
---|
dispose, disposed, equals, finalize, reassignNativeResources, tr, tr, tr |
Methods inherited from class com.trolltech.qt.QSignalEmitter |
---|
blockSignals, disconnect, disconnect, signalsBlocked, signalSender, thread |
Methods inherited from class com.trolltech.qt.internal.QSignalEmitterInternal |
---|
__qt_signalInitialization |
Methods inherited from class java.lang.Object |
---|
clone, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Methods inherited from interface com.trolltech.qt.QtJambiInterface |
---|
disableGarbageCollection, nativeId, nativePointer, reenableGarbageCollection, setJavaOwnership |
Field Detail |
---|
public final QSignalEmitter.Signal1 valueChanged
This signal takes 1 generic argument(s). We list their type and the name they go by in the description of this signal. <java.lang.Integer(named: value)>:
This signal is emitted when the value shown in the progress bar changes. value is the new value shown by the progress bar.
Constructor Detail |
---|
public QProgressBar()
By default, the minimum step value is set to 0, and the maximum to 100.
setRange()
.
public QProgressBar(QWidget parent)
By default, the minimum step value is set to 0, and the maximum to 100.
setRange()
.
Method Detail |
---|
public final Qt.Alignment alignment()
public final java.lang.String format()
The default value is "%p%".
text()
.
public final boolean invertedAppearance()
orientation
, and layoutDirection
.
public final boolean isTextVisible()
textDirection
.
public final int maximum()
minimum
is adjusted if necessary to ensure that the range remains valid. If the current value falls outside the new range, the progress bar is reset with reset()
.
public final int minimum()
maximum
is adjusted if necessary to ensure that the range remains valid. If the current value falls outside the new range, the progress bar is reset with reset()
.
public final Qt.Orientation orientation()
Qt::Horizontal
(the default) or Qt::Vertical
. invertedAppearance
, and textDirection
.
public final void reset()
public final void setAlignment(Qt.AlignmentFlag[] alignment)
public final void setAlignment(Qt.Alignment alignment)
public final void setFormat(java.lang.String format)
The default value is "%p%".
text()
.
public final void setInvertedAppearance(boolean invert)
orientation
, and layoutDirection
.
public final void setMaximum(int maximum)
minimum
is adjusted if necessary to ensure that the range remains valid. If the current value falls outside the new range, the progress bar is reset with reset()
.
public final void setMinimum(int minimum)
maximum
is adjusted if necessary to ensure that the range remains valid. If the current value falls outside the new range, the progress bar is reset with reset()
.
public final void setOrientation(Qt.Orientation arg__1)
Qt::Horizontal
(the default) or Qt::Vertical
. invertedAppearance
, and textDirection
.
public final void setRange(int minimum, int maximum)
If maximum is smaller than minimum, minimum becomes the only legal value.
If the current value falls outside the new range, the progress bar is reset with reset()
.
minimum
, and maximum
.
public final void setTextDirection(QProgressBar.Direction textDirection)
text
for vertical progress bars. This property has no impact on horizontal progress bars. By default, the reading direction is QProgressBar::TopToBottom
. orientation
, and textVisible
.
public final void setTextVisible(boolean visible)
textDirection
.
public final void setValue(int value)
public final QProgressBar.Direction textDirection()
text
for vertical progress bars. This property has no impact on horizontal progress bars. By default, the reading direction is QProgressBar::TopToBottom
. orientation
, and textVisible
.
public final int value()
public java.lang.String text()
The progress shown in the text may be smaller than the minimum value, indicating that the progress bar is in the "reset" state before any progress is set.
In the default implementation, the text either contains a percentage value that indicates the progress so far, or it is blank because the progress bar is in the reset state.
protected final void initStyleOption(QStyleOptionProgressBar option)
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |