Slider Class Reference

This is a slider that can be used to select integer value from a range. More...

#include <slider.h>

Inheritance diagram for Slider:

Public Member Functions
EGT_NODISCARD std::string	type () const override
	Returns a string representation of the type of this widget.
Public Member Functions inherited from SliderType< int >
	SliderType (const Rect &rect, int start=0, int end=100, int value=0, Orientation orient=Orientation::horizontal) noexcept
	SliderType (const Rect &rect, int start=0, int end=100, int value=0, Orientation orient=Orientation::horizontal) noexcept
	SliderType (Frame &parent, const Rect &rect, int start=0, int end=100, int value=0, Orientation orient=Orientation::horizontal) noexcept
	SliderType (Frame &parent, const Rect &rect, int start=0, int end=100, int value=0, Orientation orient=Orientation::horizontal) noexcept
	SliderType (Frame &parent, int start=0, int end=100, int value=0, Orientation orient=Orientation::horizontal) noexcept
	SliderType (Frame &parent, int start=0, int end=100, int value=0, Orientation orient=Orientation::horizontal) noexcept
	SliderType (int start=0, int end=100, int value=0, Orientation orient=Orientation::horizontal) noexcept
	SliderType (int start=0, int end=100, int value=0, Orientation orient=Orientation::horizontal) noexcept
	SliderType (Serializer::Properties &props) noexcept
	SliderType (Serializer::Properties &props) noexcept
void	draw (Painter &painter, const Rect &rect) override
	Draw the widget.
void	draw (Painter &painter, const Rect &rect) override
	Draw the widget.
void	handle (Event &event) override
	Handle an event.
void	handle (Event &event) override
	Handle an event.
void	handle_image (const Image &image, Palette::GroupId group=Palette::GroupId::normal)
	Set the image used to draw the slider's handle.
void	handle_image (const Image &image, Palette::GroupId group=Palette::GroupId::normal)
	Set the image used to draw the slider's handle.
EGT_NODISCARD Image *	handle_image (Palette::GroupId group, bool allow_fallback=false) const
	Get the image, if any, to draw the slider's handle for the given group.
EGT_NODISCARD Image *	handle_image (Palette::GroupId group, bool allow_fallback=false) const
	Get the image, if any, to draw the slider's handle for the given group.
EGT_NODISCARD bool	live_update () const
	get live update value.
EGT_NODISCARD bool	live_update () const
	get live update value.
void	live_update (bool enable)
	Enable or disable the live update feature.
void	live_update (bool enable)
	Enable or disable the live update feature.
EGT_NODISCARD Size	min_size_hint () const override
	Get a minimum size hint for the Widget.
EGT_NODISCARD Size	min_size_hint () const override
	Get a minimum size hint for the Widget.
EGT_NODISCARD Orientation	orient () const
	Get the Orientation.
EGT_NODISCARD Orientation	orient () const
	Get the Orientation.
void	orient (Orientation orient)
	Set the Orientation.
void	orient (Orientation orient)
	Set the Orientation.
void	reset_handle_image (Palette::GroupId group=Palette::GroupId::normal)
	Remove the image, if any, used to draw the slider's handle.
void	reset_handle_image (Palette::GroupId group=Palette::GroupId::normal)
	Remove the image, if any, used to draw the slider's handle.
void	serialize (Serializer &serializer) const override
	Serialize the widget to the specified serializer.
void	serialize (Serializer &serializer) const override
	Serialize the widget to the specified serializer.
SliderFlags &	slider_flags ()
	Get the current slider flags.
SliderFlags &	slider_flags ()
	Get the current slider flags.
EGT_NODISCARD const SliderFlags &	slider_flags () const
	Get the current slider flags.
EGT_NODISCARD const SliderFlags &	slider_flags () const
	Get the current slider flags.
int	value (int value) override
	Set value.
int	value (int value) override
	Set value.
Public Member Functions inherited from ValueRangeWidget< T >
	ValueRangeWidget ()=delete
	ValueRangeWidget (const Rect &rect, T start, T end, T value=T(), T step=T()) noexcept
	ValueRangeWidget (Serializer::Properties &props)
EGT_NODISCARD T	ending () const
	Get the end value.
void	ending (T v)
	Set the end value.
void	serialize (Serializer &serializer) const override
	Serialize the widget to the specified serializer.
EGT_NODISCARD T	starting () const
	Get the start value.
void	starting (T v)
	Set the start value.
EGT_NODISCARD T	stepping () const
	Get the step value.
void	stepping (T v)
	Set the step value.
EGT_NODISCARD T	value () const
	Get the current value.
virtual T	value (T value)
	Set value.
Public Member Functions inherited from Widget
	Widget (const Rect &rect={}, const Widget::Flags &flags={}) noexcept
	Widget (const Widget &)=delete
	Widget (Frame &parent, const Rect &rect={}, const Widget::Flags &flags={}) noexcept
	Widget (Serializer::Properties &props) noexcept
	Widget (Widget &&) noexcept=default
	~Widget () noexcept override
EGT_NODISCARD bool	active () const
	Get the active state.
void	active (bool value)
	Set the active state.
AlignFlags &	align ()
	Get the alignment.
EGT_NODISCARD const AlignFlags &	align () const
	Get the alignment.
void	align (const AlignFlags &a)
	Align the widget.
EGT_NODISCARD float	alpha () const
	Get the alpha property.
void	alpha (float alpha)
	Set the alpha property.
EGT_NODISCARD bool	autoresize () const
	Return the autoresize state of the widget.
void	autoresize (bool value)
	Set the autoresize state.
EGT_NODISCARD Image *	background (bool allow_fallback=false) const
	Get the background image, if any, for the current group.
void	background (const Image &image, Palette::GroupId group=Palette::GroupId::normal)
	Add an image background to the widget's box.
EGT_NODISCARD Image *	background (Palette::GroupId group, bool allow_fallback=false) const
	Get the background image, if any, for the given group.
EGT_NODISCARD DefaultDim	border () const
	Get the border width.
void	border (DefaultDim border)
	Set the border width.
EGT_NODISCARD Theme::BorderFlags	border_flags () const
	Get the border flags.
void	border_flags (const Theme::BorderFlags &flags)
	Set the border flags.
EGT_NODISCARD float	border_radius () const
	Get the border radius.
void	border_radius (float radius)
	Set the border radius.
EGT_NODISCARD const Rect &	box () const
	Bounding box for the Widget.
void	box (const Rect &rect)
	Change the bounding box of the widget.
bool	can_handle_event () const
	Returns true if the widget is capable of handling an event.
EGT_NODISCARD Point	center () const
	Get the center point of the widget's box().
EGT_NODISCARD bool	checked () const
	Get the boolean checked state of the a widget.
virtual void	checked (bool value)
	Set the checked state of the widget.
EGT_NODISCARD bool	clip () const
	Return the clip state of the widget.
EGT_NODISCARD const Pattern &	color (Palette::ColorId id) const
	Get a Widget color.
void	color (Palette::ColorId id, const Pattern &color, Palette::GroupId group=Palette::GroupId::normal)
	Add a color to the widget's instance palette.
EGT_NODISCARD const Pattern &	color (Palette::ColorId id, Palette::GroupId group) const
	Get a Widget color.
virtual EGT_NODISCARD Rect	content_area () const
	Return the area that content is allowed to be positioned into.
void	continue_drag (Event &event)
	Handle 'pointer_drag' and 'pointer_drag_stop' events.
virtual void	damage ()
	Damage the box() of the widget and cause a redraw.
virtual void	damage (const Rect &rect)
	Mark the specified rect as a damaged area of the widget.
virtual void	deserialize_children (const Deserializer &deserializer)
	Deserialize the children of this widget.
void	detach ()
	Detach this widget from its parent.
void	disable ()
	Set the disabled state to true.
void	disable_toggle ()
	Toggle the disabled state.
EGT_NODISCARD bool	disabled () const
	Return the disabled state of the widget.
void	disabled (bool value)
	Set the disabled state.
DisplayPoint	display_origin ()
	Get the display origin of the Widget.
virtual Point	display_to_local (const DisplayPoint &p) const
	Convert a display point to a local point.
void	draw_box (Painter &painter, Palette::ColorId bg, Palette::ColorId border) const
	Helper function to draw this widget's box using the appropriate theme.
void	draw_circle (Painter &painter, Palette::ColorId bg, Palette::ColorId border) const
	Helper function to draw this widget's circle using the appropriate theme.
void	enable ()
	Set the disabled state to false.
Theme::FillFlags &	fill_flags ()
	Get a modifiable fill flags reference.
EGT_NODISCARD const Theme::FillFlags &	fill_flags () const
	Get the fill flags.
void	fill_flags (const Theme::FillFlags &flags)
	Set the fill flags.
EGT_NODISCARD bool	focus () const
	Get the current focus state.
void	focus (bool value)
	Set the focus state.
EGT_NODISCARD const Font &	font () const
	Get the widget Font.
void	font (const Font &font)
	Set the widget Font.
EGT_NODISCARD bool	frame () const
	Return the frame state of the widget.
EGT_NODISCARD bool	grab_mouse () const
	Return the grab_mouse state of the widget.
void	grab_mouse (bool value)
	Set the grab_mouse state.
EGT_NODISCARD Palette::GroupId	group () const
	Get the current Palette::GroupId depending on the widget's state.
bool	has_font () const
	Check whether the widget has a custom Font.
EGT_NODISCARD bool	has_palette () const
	Check whether the widget has a custom palette.
virtual EGT_NODISCARD bool	has_screen () const
	Does this Widget have a screen?
EGT_NODISCARD DefaultDim	height () const
	Height of the widget's box().
void	height (DefaultDim h)
	Change the height.
virtual void	hide ()
	Hide the Widget.
EGT_NODISCARD bool	hit (const DisplayPoint &point) const
	Returns true if the DisplayPoint is within the widget box.
EGT_NODISCARD DefaultDim	horizontal_ratio () const
	Get the horizontal ratio relative to parent.
void	horizontal_ratio (DefaultDim horizontal)
	Set the horizontal ratio relative to parent.
EGT_NODISCARD bool	in_layout () const
	Indicate if the Widget is computing the layout or not.
virtual void	layout ()
	Perform layout of the Widget.
DisplayPoint	local_to_display (const Point &p) const
	Convert a local point to a display point.
EGT_NODISCARD DefaultDim	margin () const
	Get the margin width.
void	margin (DefaultDim margin)
	Set the margin width.
void	min_size_hint (const Size &size)
	Set the minimum size hint for the Widget.
EGT_NODISCARD size_t	moat () const
	Get the sum of the margin(), padding(), and border() around the content of the widget.
virtual void	move (const Point &point)
	Move the Widget to a new position.
void	move_to_center ()
	Move the widget to the center of its parent.
void	move_to_center (const Point &point)
	Move the widget to the specified center point.
EGT_NODISCARD bool	no_layout () const
	Return the no_layout state of the widget.
void	no_layout (bool value)
	Set the no_layout state.
virtual void	on_screen_resized ()
	Called from ComposerScreen::resize().
Widget &	operator= (const Widget &)=delete
Widget &	operator= (Widget &&) noexcept=default
EGT_NODISCARD DefaultDim	padding () const
	Return the padding width.
void	padding (DefaultDim padding)
	Set the padding width.
virtual void	paint (Painter &painter)
	Paint the Widget using a Painter.
virtual void	paint_to_file (const std::string &filename={})
	Draw the widget to a file.
EGT_NODISCARD const Palette &	palette () const
	Get the widget palette.
void	palette (const Palette &palette)
	Set the widget instance Palette.
Widget *	parent ()
	Get a pointer to the parent Widget, or nullptr if none exists.
EGT_NODISCARD const Widget *	parent () const
	Get a pointer to the parent Widget, or nullptr if none exists.
EGT_NODISCARD bool	plane_window () const
	Return the plane_window state of the widget.
EGT_NODISCARD const Point &	point () const
	Get the origin of the widget's box().
virtual void	post_deserialize (Serializer::Properties &props)
	Resume deserializing of the widget after its children have been deserialized.
void	ratio (DefaultDim horizontal, DefaultDim vertical)
	Set the size ratio relative to parent.
void	ratio (DefaultDim ratio)
	Set the size ratio relative to parent.
EGT_NODISCARD bool	readonly () const
	Get the readonly state of the widget.
void	readonly (bool value)
	Set the readonly state of the widget.
void	readonly_toggle ()
	Toggle the readonly state.
void	reset_background (Palette::GroupId group=Palette::GroupId::normal)
	Remove an image background from the widget's box.
void	reset_font ()
	Reset the widget's Font.
void	reset_palette ()
	Clear the widget instance palette.
virtual void	resize (const Size &size)
	Resize the widget.
void	resize_by_ratio (DefaultDim hratio, DefaultDim vratio)
	Scale the current size of the Widget given the ratio.
void	resize_by_ratio (DefaultDim ratio)
	Scale the current size of the Widget given the ratio.
virtual void	scale (float hscale, float vscale)
	Set the scale of the widget.
void	scale (float scale)
	Set the scale of the widget.
virtual EGT_NODISCARD Screen *	screen () const
	Get a pointer to the Screen instance, using using a parent as necessary.
virtual void	serialize_children (Serializer &serializer) const
	Serialize the widget's children to the specified serializer.
virtual void	show ()
	Show the Widget.
EGT_NODISCARD const Size &	size () const
	Get the size of the widget's box().
EGT_NODISCARD const Theme &	theme () const
	Get the Widget Theme.
EGT_NODISCARD Point	to_parent (const Point &r) const
	Convert a point with a local origin to a parent origin.
EGT_NODISCARD Rect	to_parent (const Rect &r) const
	Convert a point in a rect a local origin to a parent origin.
EGT_NODISCARD bool	user_drag () const
void	user_drag (bool value)
EGT_NODISCARD const Rect &	user_requested_box () const
	Get the box corresponding to the user requested one, not the actual one.
EGT_NODISCARD bool	user_track_drag () const
void	user_track_drag (bool value)
EGT_NODISCARD DefaultDim	vertical_ratio () const
	Get the vertical ratio relative to parent.
void	vertical_ratio (DefaultDim vertical)
	Set the vertical ratio relative to parent.
EGT_NODISCARD bool	visible () const
	Get the visible state of the widget.
void	visible (bool value)
	Set the visible state.
void	visible_toggle ()
	Toggle the visibility state.
virtual void	walk (const WalkCallback &callback, int level=0)
	Walk the Widget tree and call callback with each Widget.
EGT_NODISCARD WidgetId	widgetid () const
	Get the unique id of the widget.
EGT_NODISCARD DefaultDim	width () const
	Width of the widget's box().
void	width (DefaultDim w)
	Change the width.
EGT_NODISCARD DefaultDim	x () const
	X coordinate of the widget's box().
void	x (DefaultDim x)
	Set the X coordinate of the box.
EGT_NODISCARD DefaultDim	xratio () const
	Get the X position ratio relative to parent.
void	xratio (DefaultDim xratio)
	Set the X position ratio relative to parent.
EGT_NODISCARD DefaultDim	y () const
	Y coordinate of the widget's box().
void	y (DefaultDim y)
	Set the Y coordinate of the box.
EGT_NODISCARD DefaultDim	yratio () const
	Get the Y position ratio relative to parent.
void	yratio (DefaultDim yratio)
	Set the Y position ratio relative to parent.
virtual EGT_NODISCARD size_t	zorder () const
	Get the zorder of the widget.
virtual void	zorder (size_t rank)
	Set the zorder of the widget.
virtual void	zorder_bottom ()
	Move the widget to the bottom.
virtual void	zorder_down ()
	Move this widgets zorder down relative to other widgets with the same parent.
virtual void	zorder_top ()
	Move the widget to the top.
virtual void	zorder_up ()
	Move this widgets zorder up relative to other widgets with the same parent.
Public Member Functions inherited from Object
	Object () noexcept=default
	Object (const Object &)=delete
	Object (Object &&)=default
virtual	~Object () noexcept=default
void	clear_handlers ()
	Clear all registered event handlers.
void	invoke_handlers (Event &event)
	Invoke all handlers with the specified event.
void	invoke_handlers (EventId event)
	Invoke all handlers with the specified EventId.
EGT_NODISCARD const std::string &	name () const
	Get the name of the Object.
void	name (const std::string &name)
	Set the name of the Object.
RegisterHandle	on_event (const EventCallback &handler, const FilterFlags &mask={})
	Add an event handler to be called when the widget generates an event.
Object &	operator= (const Object &)=delete
Object &	operator= (Object &&)=default
void	remove_handler (RegisterHandle handle)
	Remove an event handler.

Additional Inherited Members
Public Types inherited from SliderType< int >
enum	SliderFlag
	Slider flags. More...
enum	SliderFlag
	Slider flags. More...
using	SliderFlags = Flags< SliderBase::SliderFlag >
	Slider flags.
using	SliderFlags = Flags< SliderBase::SliderFlag >
	Slider flags.
Public Types inherited from Widget
enum class	Flag : uint32_t {   plane_window = detail::bit(0) , window = detail::bit(1) , frame = detail::bit(2) , disabled = detail::bit(3) ,   readonly = detail::bit(4) , active = detail::bit(5) , invisible = detail::bit(6) , grab_mouse = detail::bit(7) ,   no_clip = detail::bit(8) , no_layout = detail::bit(9) , no_autoresize = detail::bit(10) , checked = detail::bit(11) ,   component = detail::bit(12) , user_drag = detail::bit(13) , user_track_drag = detail::bit(14) }
	Common flags used for various widget properties. More...
using	Flags = egt::Flags< Widget::Flag >
	Widget flags.
using	WalkCallback = std::function< bool(Widget *widget, int level)>
	Callback definition used by walk().
using	WidgetId = uint64_t
	Type used to identify a unique Widget ID.
Public Types inherited from Object
using	EventCallback = std::function< void(Event &event)>
	Event handler callback function.
using	FilterFlags = FlagsBase< EventId >
	Event handler EventId filter.
using	RegisterHandle = uint64_t
	Handle type.
Static Public Member Functions inherited from SliderType< int >
static Size	default_size ()
	Default Slider size.
static Size	default_size ()
	Default Slider size.
static void	default_size (const Size &size)
	Change default Slider size.
static void	default_size (const Size &size)
	Change default Slider size.
Public Attributes inherited from ValueRangeWidget< T >
Signal	on_value_changed
	Event signal.
Public Attributes inherited from Widget
Signal	on_checked_changed
	Event signal.
Signal	on_gain_focus
	Invoked when the widget gains focus.
Signal	on_lost_focus
	Invoked when the widget loses focus.
Signal	on_show
	Invoked when a widget is shown.
Signal	on_hide
	Invoked when a widget is hidden.
Protected Types inherited from SliderBase
enum class	SliderFlag {   rectangle_handle = detail::bit(0) , square_handle = detail::bit(1) , round_handle = detail::bit(2) , show_labels = detail::bit(3) ,   show_label = detail::bit(4) , inverted = detail::bit(5) , consistent_line = detail::bit(6) }
	Slider flags. More...
using	SliderFlags = Flags< SliderBase::SliderFlag >
	Slider flags.
Protected Types inherited from Widget
using	ChildDrawCallback = std::function< void(Painter &painter, Widget *widget)>
	Helper type that defines the special draw child callback.
using	SubordinatesArray = std::list< std::shared_ptr< Widget > >
	Helper type for an array of subordinate widgets.
enum class	Flag : uint32_t {   plane_window = detail::bit(0) , window = detail::bit(1) , frame = detail::bit(2) , disabled = detail::bit(3) ,   readonly = detail::bit(4) , active = detail::bit(5) , invisible = detail::bit(6) , grab_mouse = detail::bit(7) ,   no_clip = detail::bit(8) , no_layout = detail::bit(9) , no_autoresize = detail::bit(10) , checked = detail::bit(11) ,   component = detail::bit(12) , user_drag = detail::bit(13) , user_track_drag = detail::bit(14) }
	Common flags used for various widget properties. More...
using	Flags = egt::Flags< Widget::Flag >
	Widget flags.
using	WalkCallback = std::function< bool(Widget *widget, int level)>
	Callback definition used by walk().
using	WidgetId = uint64_t
	Type used to identify a unique Widget ID.
Protected Types inherited from Object
using	CallbackArray = std::vector< CallbackMeta >
	Helper type for an array of callbacks.
using	EventCallback = std::function< void(Event &event)>
	Event handler callback function.
using	FilterFlags = FlagsBase< EventId >
	Event handler EventId filter.
using	RegisterHandle = uint64_t
	Handle type.
Protected Member Functions inherited from SliderType< int >
	SliderType (Serializer::Properties &props, bool is_derived) noexcept
	SliderType (Serializer::Properties &props, bool is_derived) noexcept
void	draw_handle (Painter &painter)
	Draw the handle.
void	draw_handle (Painter &painter)
	Draw the handle.
void	draw_label (Painter &painter, int value)
	Draw the value label.
void	draw_label (Painter &painter, int value)
	Draw the value label.
void	draw_line (Painter &painter, float xp, float yp)
	Draw the line.
void	draw_line (Painter &painter, float xp, float yp)
	Draw the line.
EGT_API std::string	format_label (double value)
	Format the value label specialized for double.
EGT_API std::string	format_label (double value)
	Format the value label specialized for double.
EGT_API std::string	format_label (float value)
	Format the value label specialized for float.
EGT_API std::string	format_label (float value)
	Format the value label specialized for float.
EGT_NODISCARD Rect	handle_box () const
	Get the handle box for the current value.
EGT_NODISCARD Rect	handle_box () const
	Get the handle box for the current value.
EGT_NODISCARD Rect	handle_box (int value) const
	Get the handle box for the specified value.
EGT_NODISCARD Rect	handle_box (int value) const
	Get the handle box for the specified value.
EGT_NODISCARD int	handle_height () const
	Get the calculated handle height.
EGT_NODISCARD int	handle_height () const
	Get the calculated handle height.
EGT_NODISCARD int	handle_width () const
	Get the calculated handle width.
EGT_NODISCARD int	handle_width () const
	Get the calculated handle width.
bool	internal_drag () const override
bool	internal_drag () const override
bool	internal_track_drag () const override
bool	internal_track_drag () const override
EGT_NODISCARD Rect	label_box (Painter &painter, int value, std::string &text) const
	Get the label box and text for the specified value.
EGT_NODISCARD Rect	label_box (Painter &painter, int value, std::string &text) const
	Get the label box and text for the specified value.
EGT_NODISCARD int	to_offset (int value) const
	Convert a value to an offset.
EGT_NODISCARD int	to_offset (int value) const
	Convert a value to an offset.
EGT_NODISCARD int	to_value (int offset) const
	Convert an offset to value.
EGT_NODISCARD int	to_value (int offset) const
	Convert an offset to value.
void	update_value (int value)
	Update the value without notifying the handlers.
void	update_value (int value)
	Update the value without notifying the handlers.
Protected Member Functions inherited from ValueRangeWidget< T >
	ValueRangeWidget (Serializer::Properties &props, bool is_derived)
bool	set_value (T v)
	ValueRangeWidget ()=delete
	ValueRangeWidget (const Rect &rect, T start, T end, T value=T(), T step=T()) noexcept
	ValueRangeWidget (Serializer::Properties &props)
EGT_NODISCARD T	ending () const
	Get the end value.
void	ending (T v)
	Set the end value.
void	serialize (Serializer &serializer) const override
	Serialize the widget to the specified serializer.
EGT_NODISCARD T	starting () const
	Get the start value.
void	starting (T v)
	Set the start value.
EGT_NODISCARD T	stepping () const
	Get the step value.
void	stepping (T v)
	Set the step value.
EGT_NODISCARD T	value () const
	Get the current value.
virtual T	value (T value)
	Set value.
Protected Member Functions inherited from Widget
	Widget (Serializer::Properties &props, bool is_derived) noexcept
bool	accept_drag () const
	Tell the start_drag() method whether the widget accepts 'pointer_drag*' events.
void	add_component (Widget &widget)
	Add a component.
void	add_damage (const Rect &rect)
	Add damage to the damage array.
virtual void	begin_draw ()
	Cause the widget to draw itself and all of its children.
void	begin_draw (Widget *parent)
	Call the begin_draw() method of the parent.
EGT_NODISCARD detail::Range< SubordinatesArray > &	children ()
	Return the array of child widgets.
EGT_NODISCARD const detail::Range< SubordinatesArray > &	children () const
	Return the array of child widgets.
EGT_NODISCARD bool	component () const
	Get the component status.
void	component (bool value)
	Set the component flag.
EGT_NODISCARD detail::Range< SubordinatesArray > &	components ()
	Return the array of components widgets.
EGT_NODISCARD const detail::Range< SubordinatesArray > &	components () const
	Return the array of components widgets.
virtual void	damage_from_subordinate (const Rect &rect)
	Special variation of damage() that is to be called explicitly by subordinate widgets.
void	deserialize_leaf (Serializer::Properties &props)
	Deserialize widget properties that require to call overridden methods.
Widget *	find_screen ()
	Starting from this Widget, find the Widget that has a Screen.
EGT_NODISCARD const Widget *	find_screen () const
	Starting from this Widget, find the Widget that has a Screen.
Widget::Flags &	flags ()
	Get a modifiable ref of the flags.
EGT_NODISCARD const Widget::Flags &	flags () const
	Get a const ref of the flags.
EGT_NODISCARD Rect	local_box () const
	Get the local box which is the same size as box(), but with the origin zeroed.
EGT_NODISCARD bool	parent_in_layout ()
	Indicate if our parent is computing the layout.
void	parent_layout ()
	Call our parent to do a layout.
virtual Point	point_from_subordinate (const Widget &subordinate) const
EGT_NODISCARD detail::Range< SubordinatesArray > &	range_from_widget (const Widget &widget)
	Return either components() or children() depending on widget.component()
EGT_NODISCARD const detail::Range< SubordinatesArray > &	range_from_widget (const Widget &widget) const
	Return either components() or children() depending on widget.component()
void	remove_component (Widget *widget)
	Remove a component.
virtual void	set_parent (Widget *parent)
	Set this widget's parent.
void	special_child_draw (Painter &painter, Widget *widget)
	Special draw function that can be invoked when drawing each child.
EGT_NODISCARD ChildDrawCallback	special_child_draw_callback () const
	Get the special child draw callback.
void	special_child_draw_callback (ChildDrawCallback func)
	Set the special child draw callback.
EGT_NODISCARD ChildDrawCallback	special_child_draw_callback (Widget *parent) const
	Get the child draw callback of the parent.
void	start_drag (Event &event)
	Handle 'pointer_drag_start' events and decide whether they are caught by this widget.
virtual Point	to_panel (const Point &p)
	Convert a local point to the coordinate system of the current panel.
virtual EGT_NODISCARD Point	to_subordinate (const Point &p) const
	Convert a point with an origin of the current widget to subordinate origin.
EGT_NODISCARD Rect	to_subordinate (Rect rect) const
virtual EGT_NODISCARD bool	top_level () const
	Is this widget a top level widget?
bool	track_drag () const
	Tell the continue_drag() method whether the widget tracks 'pointer_drag*' events once they have crossed out the widget boundaries.
void	update_subordinates_ranges ()
	Update the 'm_children' and 'm_components' members.
size_t	zorder (const Widget *widget) const
	Get the zorder of the widget.
void	zorder (const Widget *widget, size_t rank)
	Set the zorder of the widget.
void	zorder_bottom (const Widget *widget)
	Move the specified widget zorder to the bottom of the current list of widgets with the same parent.
void	zorder_down (const Widget *widget)
	Move the specified widget zorder down relative to other widgets with the same parent.
void	zorder_top (const Widget *widget)
	Move the specified widget zorder to the top of the current list of widgets with the same parent.
void	zorder_up (const Widget *widget)
	Move the specified widget zorder up relative to other widgets with the same parent.
	Widget (const Rect &rect={}, const Widget::Flags &flags={}) noexcept
	Widget (const Widget &)=delete
	Widget (Frame &parent, const Rect &rect={}, const Widget::Flags &flags={}) noexcept
	Widget (Serializer::Properties &props) noexcept
	Widget (Widget &&) noexcept=default
	~Widget () noexcept override
EGT_NODISCARD bool	active () const
	Get the active state.
void	active (bool value)
	Set the active state.
AlignFlags &	align ()
	Get the alignment.
EGT_NODISCARD const AlignFlags &	align () const
	Get the alignment.
void	align (const AlignFlags &a)
	Align the widget.
EGT_NODISCARD float	alpha () const
	Get the alpha property.
void	alpha (float alpha)
	Set the alpha property.
EGT_NODISCARD bool	autoresize () const
	Return the autoresize state of the widget.
void	autoresize (bool value)
	Set the autoresize state.
EGT_NODISCARD Image *	background (bool allow_fallback=false) const
	Get the background image, if any, for the current group.
void	background (const Image &image, Palette::GroupId group=Palette::GroupId::normal)
	Add an image background to the widget's box.
EGT_NODISCARD Image *	background (Palette::GroupId group, bool allow_fallback=false) const
	Get the background image, if any, for the given group.
EGT_NODISCARD DefaultDim	border () const
	Get the border width.
void	border (DefaultDim border)
	Set the border width.
EGT_NODISCARD Theme::BorderFlags	border_flags () const
	Get the border flags.
void	border_flags (const Theme::BorderFlags &flags)
	Set the border flags.
EGT_NODISCARD float	border_radius () const
	Get the border radius.
void	border_radius (float radius)
	Set the border radius.
EGT_NODISCARD const Rect &	box () const
	Bounding box for the Widget.
void	box (const Rect &rect)
	Change the bounding box of the widget.
bool	can_handle_event () const
	Returns true if the widget is capable of handling an event.
EGT_NODISCARD Point	center () const
	Get the center point of the widget's box().
EGT_NODISCARD bool	checked () const
	Get the boolean checked state of the a widget.
virtual void	checked (bool value)
	Set the checked state of the widget.
EGT_NODISCARD bool	clip () const
	Return the clip state of the widget.
EGT_NODISCARD const Pattern &	color (Palette::ColorId id) const
	Get a Widget color.
void	color (Palette::ColorId id, const Pattern &color, Palette::GroupId group=Palette::GroupId::normal)
	Add a color to the widget's instance palette.
EGT_NODISCARD const Pattern &	color (Palette::ColorId id, Palette::GroupId group) const
	Get a Widget color.
virtual EGT_NODISCARD Rect	content_area () const
	Return the area that content is allowed to be positioned into.
void	continue_drag (Event &event)
	Handle 'pointer_drag' and 'pointer_drag_stop' events.
virtual void	damage ()
	Damage the box() of the widget and cause a redraw.
virtual void	damage (const Rect &rect)
	Mark the specified rect as a damaged area of the widget.
virtual void	deserialize_children (const Deserializer &deserializer)
	Deserialize the children of this widget.
void	detach ()
	Detach this widget from its parent.
void	disable ()
	Set the disabled state to true.
void	disable_toggle ()
	Toggle the disabled state.
EGT_NODISCARD bool	disabled () const
	Return the disabled state of the widget.
void	disabled (bool value)
	Set the disabled state.
DisplayPoint	display_origin ()
	Get the display origin of the Widget.
virtual Point	display_to_local (const DisplayPoint &p) const
	Convert a display point to a local point.
void	draw_box (Painter &painter, Palette::ColorId bg, Palette::ColorId border) const
	Helper function to draw this widget's box using the appropriate theme.
void	draw_circle (Painter &painter, Palette::ColorId bg, Palette::ColorId border) const
	Helper function to draw this widget's circle using the appropriate theme.
void	enable ()
	Set the disabled state to false.
Theme::FillFlags &	fill_flags ()
	Get a modifiable fill flags reference.
EGT_NODISCARD const Theme::FillFlags &	fill_flags () const
	Get the fill flags.
void	fill_flags (const Theme::FillFlags &flags)
	Set the fill flags.
EGT_NODISCARD bool	focus () const
	Get the current focus state.
void	focus (bool value)
	Set the focus state.
EGT_NODISCARD const Font &	font () const
	Get the widget Font.
void	font (const Font &font)
	Set the widget Font.
EGT_NODISCARD bool	frame () const
	Return the frame state of the widget.
EGT_NODISCARD bool	grab_mouse () const
	Return the grab_mouse state of the widget.
void	grab_mouse (bool value)
	Set the grab_mouse state.
EGT_NODISCARD Palette::GroupId	group () const
	Get the current Palette::GroupId depending on the widget's state.
bool	has_font () const
	Check whether the widget has a custom Font.
EGT_NODISCARD bool	has_palette () const
	Check whether the widget has a custom palette.
virtual EGT_NODISCARD bool	has_screen () const
	Does this Widget have a screen?
EGT_NODISCARD DefaultDim	height () const
	Height of the widget's box().
void	height (DefaultDim h)
	Change the height.
virtual void	hide ()
	Hide the Widget.
EGT_NODISCARD bool	hit (const DisplayPoint &point) const
	Returns true if the DisplayPoint is within the widget box.
EGT_NODISCARD DefaultDim	horizontal_ratio () const
	Get the horizontal ratio relative to parent.
void	horizontal_ratio (DefaultDim horizontal)
	Set the horizontal ratio relative to parent.
EGT_NODISCARD bool	in_layout () const
	Indicate if the Widget is computing the layout or not.
virtual void	layout ()
	Perform layout of the Widget.
DisplayPoint	local_to_display (const Point &p) const
	Convert a local point to a display point.
EGT_NODISCARD DefaultDim	margin () const
	Get the margin width.
void	margin (DefaultDim margin)
	Set the margin width.
void	min_size_hint (const Size &size)
	Set the minimum size hint for the Widget.
EGT_NODISCARD size_t	moat () const
	Get the sum of the margin(), padding(), and border() around the content of the widget.
virtual void	move (const Point &point)
	Move the Widget to a new position.
void	move_to_center ()
	Move the widget to the center of its parent.
void	move_to_center (const Point &point)
	Move the widget to the specified center point.
EGT_NODISCARD bool	no_layout () const
	Return the no_layout state of the widget.
void	no_layout (bool value)
	Set the no_layout state.
virtual void	on_screen_resized ()
	Called from ComposerScreen::resize().
Widget &	operator= (const Widget &)=delete
Widget &	operator= (Widget &&) noexcept=default
EGT_NODISCARD DefaultDim	padding () const
	Return the padding width.
void	padding (DefaultDim padding)
	Set the padding width.
virtual void	paint (Painter &painter)
	Paint the Widget using a Painter.
virtual void	paint_to_file (const std::string &filename={})
	Draw the widget to a file.
EGT_NODISCARD const Palette &	palette () const
	Get the widget palette.
void	palette (const Palette &palette)
	Set the widget instance Palette.
Widget *	parent ()
	Get a pointer to the parent Widget, or nullptr if none exists.
EGT_NODISCARD const Widget *	parent () const
	Get a pointer to the parent Widget, or nullptr if none exists.
EGT_NODISCARD bool	plane_window () const
	Return the plane_window state of the widget.
EGT_NODISCARD const Point &	point () const
	Get the origin of the widget's box().
virtual void	post_deserialize (Serializer::Properties &props)
	Resume deserializing of the widget after its children have been deserialized.
void	ratio (DefaultDim horizontal, DefaultDim vertical)
	Set the size ratio relative to parent.
void	ratio (DefaultDim ratio)
	Set the size ratio relative to parent.
EGT_NODISCARD bool	readonly () const
	Get the readonly state of the widget.
void	readonly (bool value)
	Set the readonly state of the widget.
void	readonly_toggle ()
	Toggle the readonly state.
void	reset_background (Palette::GroupId group=Palette::GroupId::normal)
	Remove an image background from the widget's box.
void	reset_font ()
	Reset the widget's Font.
void	reset_palette ()
	Clear the widget instance palette.
virtual void	resize (const Size &size)
	Resize the widget.
void	resize_by_ratio (DefaultDim hratio, DefaultDim vratio)
	Scale the current size of the Widget given the ratio.
void	resize_by_ratio (DefaultDim ratio)
	Scale the current size of the Widget given the ratio.
virtual void	scale (float hscale, float vscale)
	Set the scale of the widget.
void	scale (float scale)
	Set the scale of the widget.
virtual EGT_NODISCARD Screen *	screen () const
	Get a pointer to the Screen instance, using using a parent as necessary.
virtual void	serialize_children (Serializer &serializer) const
	Serialize the widget's children to the specified serializer.
virtual void	show ()
	Show the Widget.
EGT_NODISCARD const Size &	size () const
	Get the size of the widget's box().
EGT_NODISCARD const Theme &	theme () const
	Get the Widget Theme.
EGT_NODISCARD Point	to_parent (const Point &r) const
	Convert a point with a local origin to a parent origin.
EGT_NODISCARD Rect	to_parent (const Rect &r) const
	Convert a point in a rect a local origin to a parent origin.
EGT_NODISCARD bool	user_drag () const
void	user_drag (bool value)
EGT_NODISCARD const Rect &	user_requested_box () const
	Get the box corresponding to the user requested one, not the actual one.
EGT_NODISCARD bool	user_track_drag () const
void	user_track_drag (bool value)
EGT_NODISCARD DefaultDim	vertical_ratio () const
	Get the vertical ratio relative to parent.
void	vertical_ratio (DefaultDim vertical)
	Set the vertical ratio relative to parent.
EGT_NODISCARD bool	visible () const
	Get the visible state of the widget.
void	visible (bool value)
	Set the visible state.
void	visible_toggle ()
	Toggle the visibility state.
virtual void	walk (const WalkCallback &callback, int level=0)
	Walk the Widget tree and call callback with each Widget.
EGT_NODISCARD WidgetId	widgetid () const
	Get the unique id of the widget.
EGT_NODISCARD DefaultDim	width () const
	Width of the widget's box().
void	width (DefaultDim w)
	Change the width.
EGT_NODISCARD DefaultDim	x () const
	X coordinate of the widget's box().
void	x (DefaultDim x)
	Set the X coordinate of the box.
EGT_NODISCARD DefaultDim	xratio () const
	Get the X position ratio relative to parent.
void	xratio (DefaultDim xratio)
	Set the X position ratio relative to parent.
EGT_NODISCARD DefaultDim	y () const
	Y coordinate of the widget's box().
void	y (DefaultDim y)
	Set the Y coordinate of the box.
EGT_NODISCARD DefaultDim	yratio () const
	Get the Y position ratio relative to parent.
void	yratio (DefaultDim yratio)
	Set the Y position ratio relative to parent.
virtual EGT_NODISCARD size_t	zorder () const
	Get the zorder of the widget.
virtual void	zorder (size_t rank)
	Set the zorder of the widget.
virtual void	zorder_bottom ()
	Move the widget to the bottom.
virtual void	zorder_down ()
	Move this widgets zorder down relative to other widgets with the same parent.
virtual void	zorder_top ()
	Move the widget to the top.
virtual void	zorder_up ()
	Move this widgets zorder up relative to other widgets with the same parent.
Protected Member Functions inherited from Object
	Object () noexcept=default
	Object (const Object &)=delete
	Object (Object &&)=default
virtual	~Object () noexcept=default
void	clear_handlers ()
	Clear all registered event handlers.
void	invoke_handlers (Event &event)
	Invoke all handlers with the specified event.
void	invoke_handlers (EventId event)
	Invoke all handlers with the specified EventId.
EGT_NODISCARD const std::string &	name () const
	Get the name of the Object.
void	name (const std::string &name)
	Set the name of the Object.
RegisterHandle	on_event (const EventCallback &handler, const FilterFlags &mask={})
	Add an event handler to be called when the widget generates an event.
Object &	operator= (const Object &)=delete
Object &	operator= (Object &&)=default
void	remove_handler (RegisterHandle handle)
	Remove an event handler.
Static Protected Member Functions inherited from SliderType< int >
static std::string	format_label (int value)
	Format the label text.
static std::string	format_label (int value)
	Format the label text.
Protected Attributes inherited from SliderType< int >
bool	m_invoke_pending
	When true, an invoke of events has been queued to occur.
bool	m_invoke_pending
	When true, an invoke of events has been queued to occur.
bool	m_live_update
	When true, notify handlers even during drag.
bool	m_live_update
	When true, notify handlers even during drag.
Orientation	m_orient
	Orientation of the slider.
Orientation	m_orient
	Orientation of the slider.
SliderFlags	m_slider_flags
	Slider flags.
SliderFlags	m_slider_flags
	Slider flags.
int	m_start_offset
	When dragging, the offset at the drag start.
int	m_start_offset
	When dragging, the offset at the drag start.
Protected Attributes inherited from ValueRangeWidget< T >
T	m_end
	The end value.
T	m_start
	The start value.
T	m_step
	The rounding step, if any.
T	m_value
	The current value.
Signal	on_value_changed
	Event signal.
Protected Attributes inherited from Widget
Rect	m_box
	Bounding box.
detail::Range< SubordinatesArray >	m_children
	Array of child widgets in the order they were added.
detail::Range< SubordinatesArray >	m_components
	Array of component widgets in the order they were added.
SubordinatesArray::iterator	m_components_begin
	Iterator for the beginning of components which are positionned after children in the subordinates array.
Screen::DamageArray	m_damage
	The damage array for this widget.
bool	m_in_draw {false}
	Status for whether this widget is currently drawing.
bool	m_in_layout {false}
	Status for whether this widget is currently performing layout.
Size	m_min_size
	Minimum size of the widget when not an empty value.
Widget *	m_parent {nullptr}
	Pointer to this widget's parent.
ChildDrawCallback	m_special_child_draw_callback
	Used internally for calling the special child draw function.
SubordinatesArray	m_subordinates
	Array of subordinates widgets split in child widgets and component widgets.
Rect	m_user_requested_box
	Keep track of the box requested by the user.
WidgetId	m_widgetid {0}
	Unique ID of this widget.
Signal	on_checked_changed
	Event signal.
Signal	on_gain_focus
	Invoked when the widget gains focus.
Signal	on_lost_focus
	Invoked when the widget loses focus.
Signal	on_show
	Invoked when a widget is shown.
Signal	on_hide
	Invoked when a widget is hidden.
Protected Attributes inherited from Object
detail::CopyOnWriteAllocate< CallbackArray >	m_callbacks
	Array of callbacks.
RegisterHandle	m_handle_counter {0}
	Counter used to generate unique handles for each callback registration.
std::string	m_name
	A user defined name for the Object.

Detailed Description

This is a slider that can be used to select integer value from a range.

Member Function Documentation

type()

EGT_NODISCARD std::string type ( ) const

inlineoverridevirtual

Returns a string representation of the type of this widget.

Should this need to be changed, override this function.

Reimplemented from Widget.