Slider

Funciones

Slider*	slider_create (void)
Slider*	slider_vertical (void)
void	slider_OnMoved (...)
void	slider_tooltip (...)
void	slider_steps (...)
void	slider_value (...)
real32_t	slider_get_value (...)

Los Sliders son controles deslizantes se que utilizan normalmente para editar valores numéricos continuos y acotados (Figura 1). A medida que el control se desplaza, se van produciendo eventos OnMoved que devuelven un valor entre 0 y 1. En ¡Hola Slider y Progress! tienes un ejemplo de uso.

Utiliza slider_create para crear un slider horizontal.
Utiliza slider_vertical para crear un slider vertical.
Utiliza slider_OnMoved para responder al desplazamiento.

Ventana donde aparecen varios controles deslizantes Sliders, horizontal y vertical. — Figura 1: Sliders en Windows, macOS y Linux.

slider_create ()

Crea un nuevo control deslizador.

Slider*
slider_create(void);

Retorna

El slider.

slider_vertical ()

Crea un nuevo slider en vertical.

Slider*
slider_vertical(void);

Retorna

El slider.

slider_OnMoved ()

Establece un manejador para el movimiento del slider.

void
slider_OnMoved(Slider *slider,
               Listener *listener);

static void i_OnMoved(App *app, Event *e)
{
    const EvSlider *p = event_params(e, EvSlider);
    do_something_onmoved(app, p->pos);
}
...
slider_OnMoved(slider, listener(app, i_OnMoved, App));

slider	El slider.
listener	Función callback que se llamará continuamente mientras el usuario mueva un slider.

Observaciones

EvSlider contiene los parámetros del evento, ver Eventos GUI.

slider_tooltip ()

Establece un tooltip para el slider. Es un pequeño texto explicativo que aparecerá cuando el ratón esté sobre el control.

void
slider_tooltip(Slider *slider,
               const char_t *text);

slider	El slider.
text	Cadena C UTF8 terminada en carácter nulo `'\0'`.

slider_steps ()

Cambia el slider de rango continuo a intervalos discretos.

void
slider_steps(Slider *slider,
             const uint32_t steps);

slider	El slider.
steps	Número de intervalos. Utiliza UINT32_MAX para volver al rango continuo.

slider_value ()

Establece la posición del slider.

void
slider_value(Slider *slider,
             const real32_t value);

slider	El slider.
value	La posición entre 0.0 y 1.0.

slider_get_value ()

Obtiene la posición del slider.

real32_t
slider_get_value(const Slider *slider);

slider

El slider.

Retorna

La posición normalizada entre 0.0 y 1.0.