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