alto.ui.interval_range
A two-handle slider for selecting interval distances without changing the keyboard range.
Examples
>>> slider = IntervalRangeSlider()
>>> slider.set_range(3, high=12, maximum=24)
>>> slider.low, slider.high
(3, 12)
IntervalRangeSlider
IntervalRangeSlider(parent: QWidget | None = None)
Bases: QWidget
A draggable interval range with keyboard controls for either endpoint.
Attributes
edited(Signal): Emits the selected lower and upper distances in half steps.low, high(int): The selected distances, inclusive.minimum, maximum(int): The smallest and largest available interval distances.active(bool): Whether the current selection contains any intervals.
Examples
>>> slider = IntervalRangeSlider()
>>> slider.low, slider.high, slider.maximum
(1, 12, 24)
Constructor
Create the slider with a one-octave selection.
Parameters
parent(QWidget or None, default None): The widget that owns the slider.
Constructor examples
>>> IntervalRangeSlider().height()
36
IntervalRangeSlider.set_range
def set_range(
low: int,
*,
high: int,
maximum: int,
minimum: int = 1,
active: bool = True,
) -> None
Synchronize the slider without emitting an edit.
Parameters
low(int): The lowest selected interval distance.high(int): The highest selected interval distance. Keyword-only.maximum(int): The largest available distance. Keyword-only.minimum(int, default 1): The smallest available distance. Keyword-only.active(bool, default True): Whether any intervals are selected. Keyword-only.
Examples
>>> slider = IntervalRangeSlider()
>>> slider.set_range(3, high=7, maximum=12)
>>> slider.low, slider.high
(3, 7)
IntervalRangeSlider.move_endpoint
def move_endpoint(
which: str,
*,
delta: int,
) -> None
Move an endpoint by a number of half-step distances.
Parameters
which(str): The endpoint, “low” or “high”.delta(int): The number of interval distances to move. Keyword-only.
Examples
>>> slider = IntervalRangeSlider()
>>> slider.move_endpoint("low", delta=2)
>>> slider.low
3
IntervalRangeSlider.paintEvent
def paintEvent(event: QPaintEvent) -> None
Draw the track, selected span, and both handles.
Parameters
event(QPaintEvent): The repaint request.
Examples
>>> IntervalRangeSlider().grab().isNull()
False
IntervalRangeSlider.mousePressEvent
def mousePressEvent(event: QMouseEvent) -> None
Choose the nearest handle and start dragging it.
Parameters
event(QMouseEvent): The mouse press.
Examples
>>> IntervalRangeSlider()._dragging
False
IntervalRangeSlider.mouseMoveEvent
def mouseMoveEvent(event: QMouseEvent) -> None
Move the active handle while dragging.
Parameters
event(QMouseEvent): The pointer movement.
Examples
>>> IntervalRangeSlider().maximum
24
IntervalRangeSlider.mouseReleaseEvent
def mouseReleaseEvent(event: QMouseEvent) -> None
Finish dragging a handle.
Parameters
event(QMouseEvent): The mouse release.
Examples
>>> IntervalRangeSlider()._dragging
False
IntervalRangeSlider.keyPressEvent
def keyPressEvent(event: QKeyEvent) -> None
Adjust the active endpoint with arrow keys, Home, or End.
Parameters
event(QKeyEvent): The keyboard input. Up selects the upper handle and Down the lower handle.
Examples
>>> IntervalRangeSlider().focusPolicy() == Qt.FocusPolicy.StrongFocus
True