<page xmlns="http://projectmallard.org/1.0/" xmlns:uix="http://projectmallard.org/experimental/ui/" type="topic" id="check-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/check-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</mal:years>

    </mal:credit>

  </info>

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

As caixas de seleção são usadas para mostrar ou alterar uma configuração. Seus dois estados, definidos e não definidos, são mostrados pela presença ou ausência de uma marca de seleção na caixa rotulada.

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

<section id="guidelines">

<title>Diretrizes</title>

<list>

<item>
Clicar em uma caixa de seleção não deve afetar os valores de outros controles. Pode sensibilizar, insensibilizar, ocultar ou mostrar outros controles, no entanto.
</item>

<item>
Se alternar uma caixa de seleção afeta a sensibilidade de outros controles, coloque a caixa de seleção imediatamente acima ou à esquerda dos controles que ela afeta. Isso ajuda a indicar que os controles dependem do estado da caixa de seleção.
</item>

<item>
Use <link xref="writing-style#capitalization">maiusculização de frases</link> para rótulos de caixa de seleção, por exemplo <gui>Use custom font</gui>.
</item>

<item>
Caixas de seleção de rótulo para indicar claramente os efeitos de ambos os estados selecionados e não selecionados, por exemplo, <gui>Show icons in menus</gui>. Se os dois estados de uma caixa de seleção não puderem ser claramente comunicados, considere usar dois botões de opção para que ambos os estados possam receber rótulos.
</item>

<item>
Evite rótulos negativos de caixa de seleção, pois isso pode ser confuso e difícil de entender. <gui>Play alert sound</gui> é melhor que <gui>Disable alert sound</gui>, por exemplo.
</item>

<item>
Forneça uma <link xref="keyboard-input#access-keys">tecla de acesso</link> em todas as caixas de seleção que permitem ao usuário definir ou desativar a caixa de seleção diretamente a partir do teclado.
</item>

<item>
Se a caixa de seleção representa uma configuração em uma seleção múltipla que é definida para alguns objetos na seleção e desativada para outros, mostre a caixa de seleção em seu estado misto. Quando uma caixa de seleção está em seu estado misto:

<list>

<item>
Ao clicar na caixa uma vez, deve marcar a caixa, aplicando essa configuração (quando confirmada) para todos os objetos selecionados.
</item>

<item>
Ao clicar na caixa pela segunda vez, deve desmarque a caixa, removendo essa configuração (quando confirmada) para todos os objetos selecionados.
</item>

<item>
Ao clicar na caixa pela terceira vez, deve retornar a caixa para seu estado misturado, restaurando o valor original de cada objeto selecionado para aquela configuração (quando confirmado).
</item>

</list></item>

<item>
Rotule um grupo de caixas de seleção com um título descritivo acima ou à esquerda do grupo.
</item>

<item>
Não coloque mais de cerca de oito caixas de seleção sob o mesmo título de grupo. Se você precisar de mais de oito, tente usar espaço em branco ou rótulos de cabeçalho para dividi-los em grupos menores. Caso contrário, considere usar uma lista de caixa de seleção, mas provavelmente também precisa pensar sobre como simplificar sua interface de usuário.
</item>

<item>
Tente alinhar grupos de caixas de seleção verticalmente em vez de horizontalmente, pois isso facilita a varredura visual. Use alinhamentos horizontais ou retangulares somente se melhorarem grandemente o layout da janela.
</item>

</list>

</section>

<section id="api-reference">

<title>Referência de API</title>

<list>

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

</list>

</section>

</page>