Detailed Description

`Class: kodi::gui::controls::CSettingsSlider`

Window control for moveable slider with text name
The settings slider control is used in the settings screens for when an option is best specified on a sliding scale.

You can choose the position, size, and look of the slider control. It is basically a cross between the button control and a slider control. It has a label and focus and non focus textures, as well as a slider control on the right.

It has the header #include <kodi/gui/controls/SettingsSlider.h> be included to enjoy it.

Here you find the needed skin part for a settings slider control.

Note: The call of the control is only possible from the corresponding window as its class and identification number is required.

Function Documentation

◆ CSettingsSlider()

CSettingsSlider	(	CWindow *	window,
		int	controlId
	)

inline

Construct a new control.

Parameters

[in]	window	Related window control class
[in]	controlId	Used skin xml control id

◆ ~CSettingsSlider()

~CSettingsSlider ( )

overridedefault

Destructor.

◆ SetVisible()

void SetVisible ( bool visible )

inline

Set the control on window to visible.

Parameters

[in] visible If true visible, otherwise hidden

◆ SetEnabled()

void SetEnabled ( bool enabled )

inline

Set's the control's enabled/disabled state.

Parameters

[in] enabled If true enabled, otherwise disabled

◆ SetText()

void SetText ( const std::string & text )

inline

To set the text string on settings slider.

Parameters

[in] text Text to show

◆ Reset()

void Reset ( )

inline

To reset slider on defaults.

◆ SetIntRange()

void SetIntRange	(	int	start,
		int	end
	)

inline

To set the the range as integer of slider, e.g. -10 is the slider start and e.g. +10 is the from here defined position where it reach the end.

Ad default is the range from 0 to 100.

The integer interval is as default 1 and can be changed with SetIntInterval.

Parameters

[in]	start	Integer start value
[in]	end	Integer end value

Note: Percent, floating point or integer are alone possible. Combining these different values can be not together and can, therefore, only one each can be used.

◆ SetIntValue()

void SetIntValue ( int value )

inline

Set the slider position with the given integer value. The Range must be defined with a call from SetIntRange before.

Parameters

[in] value Position in range to set with integer

Note: Percent, floating point or integer are alone possible. Combining these different values can be not together and can, therefore, only one each can be used.

◆ GetIntValue()

int GetIntValue ( ) const

inline

To get the current position as integer value.

Returns: The position as integer

Note: Percent, floating point or integer are alone possible. Combining these different values can be not together and can, therefore, only one each can be used.

◆ SetIntInterval()

void SetIntInterval ( int interval )

inline

To set the interval steps of slider, as default is it 1. If it becomes changed with this function will a step of the user with the value fixed here be executed.

Parameters

[in] interval Intervall step to set.

Note: Percent, floating point or integer are alone possible. Combining these different values can be not together and can, therefore, only one each can be used.

◆ SetPercentage()

void SetPercentage ( float percent )

inline

Sets the percent of the slider.

Parameters

[in] percent float - Percent value of slide

Note: Percent, floating point or integer are alone possible. Combining these different values can be not together and can, therefore, only one each can be used.

◆ GetPercentage()

float GetPercentage ( ) const

inline

Returns a float of the percent of the slider.

Returns: float - Percent of slider

Note: Percent, floating point or integer are alone possible. Combining these different values can be not together and can, therefore, only one each can be used.

◆ SetFloatRange()

void SetFloatRange	(	float	start,
		float	end
	)

inline

To set the the range as float of slider, e.g. -25.0 is the slider start and e.g. +25.0 is the from here defined position where it reach the end.

As default is the range 0.0 to 1.0.

The float interval is as default 0.1 and can be changed with SetFloatInterval.

Parameters

[in]	start	Integer start value
[in]	end	Integer end value

Note: Percent, floating point or integer are alone possible. Combining these different values can be not together and can, therefore, only one each can be used.

◆ SetFloatValue()

void SetFloatValue ( float value )

inline

Set the slider position with the given float value. The Range can be defined with a call from SetIntRange before, as default it is 0.0 to 1.0.

Parameters

[in] value Position in range to set with float

Note: Percent, floating point or integer are alone possible. Combining these different values can be not together and can, therefore, only one each can be used.

◆ GetFloatValue()

float GetFloatValue ( ) const

inline

To get the current position as float value.

Returns: The position as float

◆ SetFloatInterval()

void SetFloatInterval ( float interval )

inline

To set the interval steps of slider, as default is it 0.1 If it becomes changed with this function will a step of the user with the value fixed here be executed.

Parameters

[in] interval Intervall step to set.

Note: Percent, floating point or integer are alone possible. Combining these different values can be not together and can, therefore, only one each can be used.