Slider

Funciones

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.

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);

1
2
3
4
5
6
7

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

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_steps ()

Cambia el slider de rango continuo a intervalos discretos.

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

slider_value ()

Establece la posición del slider.

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

slider_get_value ()

Obtiene la posición del slider.

real32_t
slider_get_value(const Slider *slider);

Retorna

La posición normalizada entre 0.0 y 1.0.