SDK Multiplataforma en C logo

SDK Multiplataforma en C

Slider

❮ Anterior
Siguiente ❯

Funciones

Slider*slider_create (void)
Slider*slider_vertical (void)
voidslider_OnMoved (...)
voidslider_tooltip (...)
voidslider_steps (...)
voidslider_value (...)
real32_tslider_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.
❮ Anterior
Siguiente ❯

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(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.

❮ Anterior
Siguiente ❯