<?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="de">

  <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>Christian Kirbach</mal:name>
      <mal:email>christian.kirbach@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>Mario Blättermann</mal:name>
      <mal:email>mario.blaettermann@gmail.com</mal:email>
      <mal:years>2016</mal:years>
    </mal:credit>
  </info>

<title>Einstellfelder</title>

<p>Ein Einstellfeld ist ein Textfeld, das als Eingabe einen Bereich von Werten akzeptiert. Es bezieht zwei Knöpfe ein, mit denen der Benutzer den Wert um einen festen Betrag vergrößern oder verkleinern kann.</p>

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

<section id="when-to-use">
<title>Anwendungsfälle</title>

<p>Verwenden Sie Einstellfelder zur Benutzereingabe numerischer Werte, aber nur dann, wenn es für den Benutzer wichtig oder sinnvoll ist diese Werte zu kennen. Falls nicht, wären <link xref="sliders">Schieberegler</link> die bessere Wahl.</p>

<p>Verwenden Sie Einstellfelder nur für numerische Eingaben. Für nicht-numerische Optionen können Sie stattdessen eine <link xref="lists">Liste</link> oder <link xref="drop-down-lists">Auswahlliste</link> verwenden.</p>

</section>

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

<p>In einigen Fällen ist es sinnvoll, ein Einstellfeld mit einem Schieberegler zu verknüpfen. Diese Kombination erlaubt sowohl die ungefähre Kontrolle als auch die Eingabe spezifischer Werte. Dennoch ist dies nur sinnvoll, wenn die Benutzer den spezifischen Wert kenne, den sie verwenden wollen. Platzieren Sie einen Schieberegler in folgenden Fällen:</p>

<list>
<item><p>Unmittelbare Rückmeldung der Änderungen in den Werten des Einstellfeldes ist möglich (zum Beispiel in einer Bildbearbeitung).</p></item>
<item><p>Es ist sinnvoll für den Benutzer, wenn er die Schrittweite der Änderungen in Echtzeit steuern kann, um beispielsweise die Änderungen einer Farbe in einem Live-Vorschaufenster zu überwachen, die mit RGB-Schiebereglern gesteuert werden.</p></item>
</list>

</section>

<section id="general-guidelines">
<title>Allgemeine Richtlinien</title>

<list>
<item><p>Beschriften Sie das Einstellfeld mit einem Text darüber oder links davon und verwenden Sie Satz-Großschreibung. Stellen Sie eine Zugriffstaste in der Beschriftung bereit, mit denen der Benutzer das Einstellfeld direkt fokussieren kann.</p></item>
<item><p>Ordnen Sie den Inhalt von Einstellfeldern rechtsbündig an, sofern die Konvention im Gebietsschema des Benutzers nichts anderes erfordert. Dies ist in Fenstern sinnvoll, in denen der Benutzer zwei numerische Werte in der selben Spalte von Bedienelementen vergleichen kann. In diesem Fall sollten Sie sicherstellen, dass die rechten Ränder der entsprechenden Bedienelemente aneinander ausgerichtet sind.</p></item>
</list>

</section>

<section id="api-reference">
<title>API-Referenz</title>

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

</section>

</page>
