"""IntWidget class. Represents an unbounded int using a widget. """ #----------------------------------------------------------------------------- # Copyright (c) 2013, the IPython Development Team. # # Distributed under the terms of the Modified BSD License. # # The full license is in the file COPYING.txt, distributed with this software. #----------------------------------------------------------------------------- #----------------------------------------------------------------------------- # Imports #----------------------------------------------------------------------------- from .widget import DOMWidget from IPython.utils.traitlets import Unicode, CInt, Bool, Enum, Tuple #----------------------------------------------------------------------------- # Classes #----------------------------------------------------------------------------- class _IntWidget(DOMWidget): value = CInt(0, help="Int value", sync=True) disabled = Bool(False, help="Enable or disable user changes", sync=True) description = Unicode(help="Description of the value this widget represents", sync=True) class _BoundedIntWidget(_IntWidget): step = CInt(1, help="Minimum step that the value can take (ignored by some views)", sync=True) max = CInt(100, help="Max value", sync=True) min = CInt(0, help="Min value", sync=True) def __init__(self, *pargs, **kwargs): """Constructor""" DOMWidget.__init__(self, *pargs, **kwargs) self.on_trait_change(self._validate, ['value', 'min', 'max']) def _validate(self, name, old, new): """Validate value, max, min.""" if self.min > new or new > self.max: self.value = min(max(new, self.min), self.max) class IntTextWidget(_IntWidget): _view_name = Unicode('IntTextView', sync=True) class BoundedIntTextWidget(_BoundedIntWidget): _view_name = Unicode('IntTextView', sync=True) class IntSliderWidget(_BoundedIntWidget): _view_name = Unicode('IntSliderView', sync=True) orientation = Enum([u'horizontal', u'vertical'], u'horizontal', help="Vertical or horizontal.", sync=True) range = Bool(False, help="Display a range selector", sync=True) readout = Bool(True, help="Display the current value of the slider next to it.", sync=True) class IntProgressWidget(_BoundedIntWidget): _view_name = Unicode('ProgressView', sync=True) class _IntRangeWidget(_IntWidget): value = Tuple(CInt, CInt, default_value=(0, 1), help="Low and high int values", sync=True) class _BoundedIntRangeWidget(_IntRangeWidget): step = CInt(1, help="Minimum step that the value can take (ignored by some views)", sync=True) max = CInt(100, help="Max value", sync=True) min = CInt(0, help="Min value", sync=True) def __init__(self, *pargs, **kwargs): """Constructor""" DOMWidget.__init__(self, *pargs, **kwargs) self.on_trait_change(self._validate, ['value', 'min', 'max']) def _validate(self, name, old, new): """Validate min <= low <= high <= max""" if name == "value": low, high = new low = max(low, self.min) high = min(high, self.max) self.value = (min(low, high), max(low, high)) class IntRangeSliderWidget(_BoundedIntRangeWidget): _view_name = Unicode('IntSliderView', sync=True) orientation = Enum([u'horizontal', u'vertical'], u'horizontal', help="Vertical or horizontal.", sync=True) range = Bool(True, help="Display a range selector", sync=True) readout = Bool(True, help="Display the current value of the slider next to it.", sync=True)