<?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" xml:lang="pt-BR">

  <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"/>

    <include xmlns="http://www.w3.org/2001/XInclude" href="legal.xml"/>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Georges Neto</mal:name>
      <mal:email>georges.stavracas@gmail.com</mal:email>
      <mal:years>2014,</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Rafael Fontenelle</mal:name>
      <mal:email>rafaelff@gnome.org</mal:email>
      <mal:years>2017-2021</mal:years>
    </mal:credit>
  </info>

<title>Caixas de rotação</title>

<p>Uma caixa de rotação é uma caixa de texto que aceita um intervalo de valores. Incorpora dois botões que permitem ao usuário aumentar ou diminuir o valor em um valor fixo.</p>

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

<section id="when-to-use">
<title>Quando usar</title>

<p>Use caixas de rotação para permitir que os usuários selecionem valores numéricos, mas somente quando esses valores forem significativos ou úteis para os usuários conhecerem. Se não estiverem, um <link xref="sliders">controle deslizante</link> pode ser uma escolha melhor.</p>

<p>Use caixas de rotação somente para entrada numérica. Para conjuntos não numéricos de opções, uma <link xref="lists">lista</link> ou <link xref="drop-down-lists">lista suspensa</link> pode ser usada em seu lugar.</p>

</section>

<section id="sliders">
<title>Controles deslizantes</title>

<p>Em alguns casos, é apropriado vincular um botão de rotação a um controle deslizante. Essa combinação permite o controle aproximado e a entrada de valores específicos. No entanto, isso só é útil se você quiser atender a pessoas que possam conhecer um valor específico que desejam usar. Use um controle deslizante quando:</p>

<list>
<item><p>O feedback imediato para alterações no valor da caixa de rotação é possível (como no caso da edição de imagens).</p></item>
<item><p>É útil para o usuário controlar a taxa de alteração do valor em tempo real. Por exemplo, para monitorar os efeitos de uma mudança de cor em uma janela de visualização ao vivo enquanto eles arrastam os controles deslizantes RGB.</p></item>
</list>

</section>

<section id="general-guidelines">
<title>Diretrizes gerais</title>

<list>
<item><p>Rotule a caixa de rotação com um rótulo de texto acima ou à sua esquerda, usando maiusculização de frase. Forneça uma tecla de acesso no rótulo que permite ao usuário dar foco diretamente à caixa de rotação.</p></item>
<item><p>Justifique à direita o conteúdo das caixas de rotação, a menos que a convenção na localidade do usuário exija o contrário. Isso é útil em janelas em que o usuário pode querer comparar dois valores numéricos na mesma coluna de controles. Nesse caso, certifique-se de que as bordas direitas dos controles relevantes também estejam alinhadas.</p></item>
</list>

</section>

<section id="api-reference">
<title>Referência de API</title>

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

</section>

</page>
