|
|||||||||
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.QAbstractSlider
public class QAbstractSlider
The QAbstractSlider class provides an integer value within a range. The class is designed as a common super class for widgets like QScrollBar
, QSlider
and QDial
.
Here are the main properties of the class:
value
: The bounded integer that QAbstractSlider maintains.minimum
: The lowest possible value.maximum
: The highest possible value.singleStep
: The smaller of two natural steps that an abstract sliders provides and typically corresponds to the user pressing an arrow key.pageStep
: The larger of two natural steps that an abstract slider provides and typically corresponds to the user pressing PageUp or PageDown.tracking
: Whether slider tracking is enabled.sliderPosition
: The current position of the slider. If tracking
is enabled (the default), this is identical to value
.setValue()
lets you set the current value to any integer in the allowed range, not just minimum()
+ n * singleStep()
for integer values of n. Some widgets may allow the user to set any value at all; others may just provide multiples of singleStep()
or pageStep()
. QAbstractSlider emits a comprehensive set of signals:
valueChanged() | the value has changed. The tracking determines whether this signal is emitted during user interaction. |
sliderPressed() | the user starts to drag the slider. |
sliderMoved() | the user drags the slider. |
sliderReleased() | the user releases the slider. |
actionTriggered() | a slider action was triggerd. |
rangeChanged() | a the range has changed. |
sliderChange()
function that is well suited for updating the on-screen representation of sliders. By calling triggerAction()
, subclasses trigger slider actions. Two helper functions QStyle::sliderPositionFromValue()
and QStyle::sliderValueFromPosition()
help subclasses and styles to map screen coordinates to logical range values. QAbstractSpinBox
, QSlider
, QDial
, QScrollBar
, and Sliders Example.
Nested Class Summary | |
---|---|
static class |
QAbstractSlider.SliderAction
|
static class |
QAbstractSlider.SliderChange
|
Nested classes/interfaces inherited from class com.trolltech.qt.gui.QWidget |
---|
QWidget.RenderFlag, QWidget.RenderFlags |
Nested classes/interfaces inherited from class com.trolltech.qt.internal.QSignalEmitterInternal |
---|
com.trolltech.qt.internal.QSignalEmitterInternal.AbstractSignalInternal |
Field Summary | |
---|---|
QSignalEmitter.Signal1 |
actionTriggered
This signal takes 1 generic argument(s). |
QSignalEmitter.Signal2 |
rangeChanged
This signal takes 2 generic argument(s). |
QSignalEmitter.Signal1 |
sliderMoved
This signal takes 1 generic argument(s). |
QSignalEmitter.Signal0 |
sliderPressed
This signal is emitted when the user presses the slider with the mouse, or programmatically when setSliderDown(true) is called. |
QSignalEmitter.Signal0 |
sliderReleased
This signal is emitted when the user releases the slider with the mouse, or programmatically when setSliderDown(false) is called. |
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 | |
---|---|
QAbstractSlider()
Constructs an abstract slider. |
|
QAbstractSlider(QWidget parent)
Constructs an abstract slider. |
Method Summary | |
---|---|
boolean |
hasTracking()
This property holds whether slider tracking is enabled. |
boolean |
invertedAppearance()
This property holds whether or not a slider shows its values inverted. |
boolean |
invertedControls()
This property holds whether or not the slider inverts its wheel and key events. |
boolean |
isSliderDown()
This property holds whether the slider is pressed down. |
int |
maximum()
This property holds the slider's maximum value. |
int |
minimum()
This property holds the sliders's minimum value. |
Qt.Orientation |
orientation()
This property holds the orientation of the slider. |
int |
pageStep()
This property holds the page step. |
protected QAbstractSlider.SliderAction |
repeatAction()
Returns the current repeat action. |
void |
setInvertedAppearance(boolean arg__1)
This property holds whether or not a slider shows its values inverted. |
void |
setInvertedControls(boolean arg__1)
This property holds whether or not the slider inverts its wheel and key events. |
void |
setMaximum(int arg__1)
This property holds the slider's maximum value. |
void |
setMinimum(int arg__1)
This property holds the sliders's minimum value. |
void |
setOrientation(Qt.Orientation arg__1)
This property holds the orientation of the slider. |
void |
setPageStep(int arg__1)
This property holds the page step. |
void |
setRange(int min,
int max)
Sets the slider's minimum to min and its maximum to max. |
protected void |
setRepeatAction(QAbstractSlider.SliderAction action)
Sets action action to be triggered repetitively in intervals of repeatTime, after an initial delay of thresholdTime. |
protected void |
setRepeatAction(QAbstractSlider.SliderAction action,
int thresholdTime)
Sets action action to be triggered repetitively in intervals of repeatTime, after an initial delay of thresholdTime. |
protected void |
setRepeatAction(QAbstractSlider.SliderAction action,
int thresholdTime,
int repeatTime)
Sets action action to be triggered repetitively in intervals of repeatTime, after an initial delay of thresholdTime. |
void |
setSingleStep(int arg__1)
This property holds the single step. |
void |
setSliderDown(boolean arg__1)
This property holds whether the slider is pressed down. |
void |
setSliderPosition(int arg__1)
This property holds the current slider position. |
void |
setTracking(boolean enable)
This property holds whether slider tracking is enabled. |
void |
setValue(int arg__1)
This property holds the slider's current value. |
int |
singleStep()
This property holds the single step. |
protected void |
sliderChange(QAbstractSlider.SliderChange change)
Reimplement this virtual function to track slider changes such as SliderRangeChange , SliderOrientationChange , SliderStepsChange , or SliderValueChange . |
int |
sliderPosition()
This property holds the current slider position. |
void |
triggerAction(QAbstractSlider.SliderAction action)
Triggers a slider action. |
int |
value()
This property holds the slider'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 actionTriggered
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: action)>:
This signal is emitted when the slider action action is triggered. Actions are SliderSingleStepAdd
, SliderSingleStepSub
, SliderPageStepAdd
, SliderPageStepSub
, SliderToMinimum
, SliderToMaximum
, and SliderMove
.
When the signal is emitted, the sliderPosition
has been adjusted according to the action, but the value
has not yet been propagated (meaning the valueChanged()
signal was not yet emitted), and the visual display has not been updated. In slots connected to this signal you can thus safely adjust any action by calling setSliderPosition()
yourself, based on both the action and the slider's value.
triggerAction()
.
public final QSignalEmitter.Signal2 rangeChanged
This signal takes 2 generic argument(s). We list their type and the name they go by in the description of this signal. <java.lang.Integer(named: min), java.lang.Integer(named: max)>:
This signal is emitted when the slider range has changed, with min being the new minimum, and max being the new maximum.
minimum
, and maximum
.
public final QSignalEmitter.Signal1 sliderMoved
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 sliderDown
is true and the slider moves. This usually happens when the user is dragging the slider. The value is the new slider position.
This signal is emitted even when tracking is turned off.
setTracking()
, valueChanged()
, isSliderDown()
, sliderPressed()
, and sliderReleased()
.
public final QSignalEmitter.Signal0 sliderPressed
sliderReleased()
, sliderMoved()
, and isSliderDown()
.
public final QSignalEmitter.Signal0 sliderReleased
sliderPressed()
, sliderMoved()
, and sliderDown
.
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 slider value has changed, with the new slider value as argument.
Constructor Detail |
---|
public QAbstractSlider()
The parent arguments is sent to the QWidget
constructor.
The minimum
defaults to 0, the maximum
to 99, with a singleStep
size of 1 and a pageStep
size of 10, and an initial value
of 0.
public QAbstractSlider(QWidget parent)
The parent arguments is sent to the QWidget
constructor.
The minimum
defaults to 0, the maximum
to 99, with a singleStep
size of 1 and a pageStep
size of 10, and an initial value
of 0.
Method Detail |
---|
public final boolean hasTracking()
valueChanged()
signal while the slider is being dragged. If tracking is disabled, the slider emits the valueChanged()
signal only when the user releases the slider. sliderDown
.
public final boolean invertedAppearance()
Note: This property makes most sense for sliders and dials. For scroll bars, the visual effect of the scroll bar subcontrols depends on whether or not the styles understand inverted appearance; most styles ignore this property for scroll bars.
public final boolean invertedControls()
public final boolean isSliderDown()
tracking
has any effect. Changing the slider down property emits the sliderPressed()
and sliderReleased()
signals.
public final int maximum()
minimum
is adjusted if necessary to ensure that the range remains valid. Also the slider's current value is adjusted to be within the new range.
public final int minimum()
maximum
is adjusted if necessary to ensure that the range remains valid. Also the slider's current value is adjusted to be within the new range.
public final Qt.Orientation orientation()
Qt::Vertical
(the default) or Qt::Horizontal
.
public final int pageStep()
singleStep
.
protected final QAbstractSlider.SliderAction repeatAction()
setRepeatAction()
.
public final void setInvertedAppearance(boolean arg__1)
Note: This property makes most sense for sliders and dials. For scroll bars, the visual effect of the scroll bar subcontrols depends on whether or not the styles understand inverted appearance; most styles ignore this property for scroll bars.
public final void setInvertedControls(boolean arg__1)
public final void setMaximum(int arg__1)
minimum
is adjusted if necessary to ensure that the range remains valid. Also the slider's current value is adjusted to be within the new range.
public final void setMinimum(int arg__1)
maximum
is adjusted if necessary to ensure that the range remains valid. Also the slider's current value is adjusted to be within the new range.
public final void setOrientation(Qt.Orientation arg__1)
Qt::Vertical
(the default) or Qt::Horizontal
.
public final void setPageStep(int arg__1)
singleStep
.
public final void setRange(int min, int max)
If max is smaller than min, min becomes the only legal value.
minimum
, and maximum
.
protected final void setRepeatAction(QAbstractSlider.SliderAction action, int thresholdTime)
triggerAction()
, and repeatAction()
.
protected final void setRepeatAction(QAbstractSlider.SliderAction action)
triggerAction()
, and repeatAction()
.
protected final void setRepeatAction(QAbstractSlider.SliderAction action, int thresholdTime, int repeatTime)
triggerAction()
, and repeatAction()
.
public final void setSingleStep(int arg__1)
pageStep
.
public final void setSliderDown(boolean arg__1)
tracking
has any effect. Changing the slider down property emits the sliderPressed()
and sliderReleased()
signals.
public final void setSliderPosition(int arg__1)
tracking
is enabled (the default), this is identical to value
.
public final void setTracking(boolean enable)
valueChanged()
signal while the slider is being dragged. If tracking is disabled, the slider emits the valueChanged()
signal only when the user releases the slider. sliderDown
.
public final void setValue(int arg__1)
minimum
<= value <= maximum
. Changing the value also changes the sliderPosition
.
public final int singleStep()
pageStep
.
public final int sliderPosition()
tracking
is enabled (the default), this is identical to value
.
public final void triggerAction(QAbstractSlider.SliderAction action)
SliderSingleStepAdd
, SliderSingleStepSub
, SliderPageStepAdd
, SliderPageStepSub
, SliderToMinimum
, SliderToMaximum
, and SliderMove
. actionTriggered()
.
public final int value()
minimum
<= value <= maximum
. Changing the value also changes the sliderPosition
.
protected void sliderChange(QAbstractSlider.SliderChange change)
SliderRangeChange
, SliderOrientationChange
, SliderStepsChange
, or SliderValueChange
. The default implementation only updates the display and ignores the change parameter.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |