Tutorial de XUL:Barras de desplazamiento
De MDC
Esta página está traduciéndose a partir del artículo XUL_Tutorial:Scroll_Bars, razón por la cual puede haber algunos errores sintácticos o partes sin traducir. Puedes colaborar continuando con la traducción
Ahora, Aprenderemos a añadir barras de desplazamiento en una ventana
[editar] Añadiendo barras de desplazamiento
Una barra de desplazamiento sirve para que un usuario pueda moverse en un documento grande. También puedes usarla cuando tienes que buscar un valor que está dentro de un cierto rango. Las barras de desplazamiento pueden ser creadas de varias formas. En XUL, puede ser creada usando la etiqueta Plantilla:XULElem. Algunos elementos, como cajas de texto, también añadirán barras de desplazamiento cuando el contenido de dentro es demasiado grande
En esta sección, hablaremos de la creación de una barra de desplazamiento independiente. El usuario pondrá el valor ajustando la barra de desplazamiento. Probablemente no usarás esto a menudo. Una barra de desplazamiento está compuesta de varias partes: el deslizador, que es la parte principal de la barra de desplazamiento con la caja ajustable, y los dos botones de flecha. Una barra de desplazamiento crea todos estos elementos automáticamente.
La síntaxis de una barra de desplazamiento es:
<scrollbar
id="identifier"
orient="horizontal"
curpos="20"
maxpos="100"
increment="1"
pageincrement="10"/>
Los atributos son los siguientes:
- Plantilla:XULAttr
id - El único identificador de la barra de desplazamiento
- Plantilla:XULAttr
orient - Especifica la dirección de la barra de desplazamiento. Por defecto es
horizontal, que crea una barra de desplazamiento que se extiende de la izquierda a la derecha. También puedes especificarverticalque crea una barra de desplazamiento que se extiende de arriba abajo.
- Plantilla:XULAttr
curpos - Indica la posición actual de la barra de desplazamiento (la caja que usted puede deslizar hacia adelante y hacia atrás.) el rango de valores se extiende de 0 al valor de maxpos. Este valor no es necesario. El valor por defecto es 0.
- Plantilla:XULAttr
maxpos - Indica la posición máxima de la barra de desplazamiento. Es un valor numérico. El valor por defecto es 100.
- Plantilla:XULAttr
increment - Este valor especifica cuánto cambia el valor de
curposcuando el usuario pulsa sobre una de las flechas de barra de desplazamiento. El valor por defecto es 1.
- Plantilla:XULAttr
pageincrement - Este valor especifica cuánto cambia el valor
curposcuando el usuario pasa páginas con la barra de desplazamiento, que puede hacerse pulsando entre la caja y las flechas. El valor por defecto es 10.
El ejemplo dado en la sintaxis superior creará una barra de desplazamiento que puede extenderse de un valor de 0 a 100. El valor 100 podría ser el número de líneas en una lista, pero podría ser lo que quieras. El valor inicial en este ejemplo es 20. Pulsando sobre una de las flechas de barra de desplazamiento, el valor se cambiaría por 1 encima de o abajo. Pero paginando por la barra de desplazamiento, el valor se cambiará por 10.
Cuando el usuario pulsa las flechas de la barra de desplazamiento, se moverá la cantidad especificada por el valor increment. El aumento del valor de este atributo hará que la barra de desplazamiento se mueva más lejos con cada click. La posición izquierda o más alta de la barra de desplazamiento tiene el valor 0 y la posición de derecha o más baja de la barra de desplazamiento tiene el valor dado por maxpos.
Ajustando los valores de la barra de desplazamiento, puedes tener el thumb posicionado donde quieras y el cambiarlo cuando pulsas las flechas tal como quieras.
Después, Aprenderemos a crear barras de herramientas.