<?xml version="1.0" encoding="utf-8"?>
<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-2021</mal:years>
    </mal:credit>
  </info>

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

<p>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.</p>

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

<section id="guidelines">
<title>Diretrizes</title>

<list>
<item><p>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.</p></item>
<item><p>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.</p></item>
<item><p>Use <link xref="writing-style#capitalization">maiusculização de frase</link> para rótulos de caixa de seleção, por exemplo <gui>Use custom font</gui>.</p></item>
<item><p>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.</p></item>
<item><p>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.</p></item>
<item><p>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.</p></item>
<item><p>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:</p>
<list>
<item><p>Ao clicar na caixa uma vez, deve marcar a caixa, aplicando essa configuração (quando confirmada) para todos os objetos selecionados.</p></item>
<item><p>Ao clicar na caixa pela segunda vez, deve desmarque a caixa, removendo essa configuração (quando confirmada) para todos os objetos selecionados.</p></item>
<item><p>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).</p></item>
</list></item>
<item><p>Rotule um grupo de caixas de seleção com um título descritivo acima ou à esquerda do grupo.</p></item>
<item><p>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.</p></item>
<item><p>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.</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/GtkCheckButton.html">GtkCheckButton</link></p></item>
</list>
</section>

</page>
