<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" xmlns:uix="http://projectmallard.org/experimental/ui/" type="topic" id="spin-boxes" lang="es">

  <info>
    <credit type="author">
      <name>Allan Day</name>
      <email>aday@gnome.org</email>
    </credit>
    <credit>
      <name>Calum Benson</name>
    </credit>
    <credit>
      <name>Adam Elman</name>
    </credit>
    <credit>
      <name>Seth Nickell</name>
    </credit>
    <credit>
      <name>Colin Robertson</name>
    </credit>

    <link type="guide" xref="ui-elements"/>
    <uix:thumb mime="image/svg" src="figures/ui-elements/spin-boxes.svg"/>

    <license xmlns="http://projectmallard.org/1.0/" href="http://creativecommons.org/licenses/by-sa/4.0/">

  <p>This work is licensed under a
  <link href="http://creativecommons.org/licenses/by-sa/4.0/">Creative
  Commons Attribution-Share Alike 4.0 International License</link>.</p>

</license>
  <credit type="translator copyright"><name>Daniel Mustieles</name><email>daniel.mustieles@gmail.com</email><years>2011 - 2021</years></credit><credit type="translator copyright"><name>Alex Puchades</name><email>alex94puchades@gmail.com</email><years>2015</years></credit><credit type="translator copyright"><name>Nicolás Satragno</name><email>nsatragno@gnome.org</email><years>2013</years></credit><credit type="translator copyright"><name>Benjamín Valero Espinosa</name><email>benjavalero@gmail.com</email><years>2011</years></credit><credit type="translator copyright"><name>Jorge González</name><email>jorgegonz@svn.gnome.org</email><years>2009</years></credit><credit type="translator copyright"><name>Rosa Elena Pérez</name><email>rozydicemiau@gmail.com</email><years>2014</years></credit><credit type="translator copyright"><name>Oscar Rafael Arachi</name><email>arachi910@gmail.com</email><years>2014 - 2015</years></credit><credit type="translator copyright"><name>Miguel Ajuech</name><email>miguel.ann.28@gmail.com</email><years>2014</years></credit><credit type="translator copyright"><name>Adrián Pérez Domínguez</name><email>adrian@aztli.org</email><years>2015</years></credit><credit type="translator copyright"><name>Celina Osorio Ochoa</name><email>chelinoska@gmail.com</email><years>2015</years></credit><credit type="translator copyright"><name>Dario Amigon Espinoza</name><email>daramigon@gmail.com</email><years>2015</years></credit><credit type="translator copyright"><name>Yenisei Ramírez Pérez</name><email>yeniseirape@gmail.com</email><years>2015</years></credit><credit type="translator copyright"><name>José Roberto Ramíres Mendoza</name><email>aczella@gmail.com</email><years>2015</years></credit><credit type="translator copyright"><name>Bernardo Sánchez Romero</name><email>b.sanchez.rom@gmail.com</email><years>2015</years></credit><credit type="translator copyright"><name>Emmanuel Márquez Juárez</name><email>resident3333@gmail.com</email><years>2015</years></credit><credit type="translator copyright"><name>David Romero Serrano</name><email>lemi136@hotmail.com</email><years>2015</years></credit><credit type="translator copyright"><name>Omar Garcia Guzman</name><email>garciag.omar91@gmail.com</email><years>2015</years></credit><credit type="translator copyright"><name>Edilberto Huerta Niño</name><email>edilberto.huerta0290@gmail.com</email><years>2015</years></credit></info>

<title>Cajas incrementales</title>

<p>Una caja incremental es una caja de texto que acepta un rango de valores. Se le incorporan dos botones que permiten al usuario incrementar o decrementar el valor de una cantidad fija.</p>

<media type="image" mime="image/svg" src="figures/ui-elements/spin-boxes.svg"/>

<section id="when-to-use">
<title>Cuándo usarlas</title>

<p>Usar cajas incrementales permite a los usuarios seleccionar un valor numérico, pero solo cuando estos valores son significativos o útiles para los usuarios. Si no lo son, un <link xref="sliders">deslizador</link> puede ser una mejor opción.</p>

<p>Use las cajas incrementales solo para entradas numéricas. Para opciones de conjuntos no-numéricos se puede utilizar una <link xref="lists">lista</link> o una <link xref="drop-down-lists">lista desplegable</link> </p>

</section>

<section id="sliders">
<title>Deslizadores</title>

<p>En algunos casos, es apropiado asociar un botón incremental con un deslizador. Esta combinación permite aproximar el control y la entrada de valores específicos. Sin embargo, sólo es útil si se quiere atender a la gente que puede saber un valor específico que quiere utilizar. Use un control deslizante cuando:</p>

<list>
<item><p>Dar retroalimentación inmediatamente para cambios en los valores del botón incremental es posible (como en el caso del editor de imágenes).</p></item>
<item><p>Es útil para el usuario controlar la velocidad de cambio del valor en tiempo real. Por ejemplo, para controlar los efectos de un cambio de color en directo en una ventana de vista previa a medida que arrastre los deslizadores RGB.</p></item>
</list>

</section>

<section id="general-guidelines">
<title>Guías Generales</title>

<list>
<item><p>Etiquete la caja incremental con una etiqueta de texto por encima o a su izquierda, usando mayúsculas. Proporcione una tecla de acceso en la etiqueta que permita al usuario dar el foco directamente a la caja incremental.</p></item>
<item><p>Justifique al a derecha el contenido de las cajas incrementales, a menos que el convenio de la configuración regional del usuario indique otra cosa. Esto es útil en ventanas en las que el usuario puede querer comparar dos valores numéricos en la misma columna de controles. En este caso, asegúrese de que los bordes de la derecha de los controles relevantes también están alineados.</p></item>
</list>

</section>

<section id="api-reference">
<title>Referencia de la API</title>

<list>
<item><p><link href="https://developer.gnome.org/gtk3/stable/GtkSpinButton.html">GtkSpinButton</link></p></item>
</list>

</section>

</page>
