Eingabebereich festlegen, um die Touch-Tastatur zu ändern

Um Benutzern bei der Eingabe von Daten mithilfe der Bildschirmtastatur oder des Soft Input Panel (SIP) zu helfen, können Sie den Eingabeumfang des Textsteuerelements so festlegen, dass er mit der Art der Daten übereinstimmt, die der Benutzer eingeben wird.

Wichtige APIs

• Eingabebereich
• InputScopeNameValue-

Die Bildschirmtastatur kann für die Texteingabe verwendet werden, wenn Ihre App auf einem Gerät mit Touchscreen ausgeführt wird. Die Bildschirmtastatur wird aufgerufen, wenn der Benutzer auf ein bearbeitbares Eingabefeld tippt, z. B. ein TextBox- oder RichEditBox-. Sie können Benutzern das Eingeben von Daten in Ihre App viel schneller und einfacher machen, indem Sie den Eingabebereich des Textsteuerelements so festlegen, dass er mit der Art der Daten übereinstimmt, die der Benutzer eingeben soll. Der Eingabebereich bietet dem System einen Hinweis auf die Art der Texteingabe, die vom Steuerelement erwartet wird, damit das System ein spezielles Bildschirmtastaturlayout für den Eingabetyp bereitstellen kann.

Wenn beispielsweise ein Textfeld nur zum Eingeben einer 4-stelligen PIN verwendet wird, legen Sie die InputScope-Eigenschaft auf Numberfest. Das System wird angewiesen, das Layout der Nummerntastatur anzuzeigen, wodurch der Benutzer die PIN leichter eingeben kann.

Von Bedeutung

• Diese Informationen gelten nur für das SIP. Sie gilt nicht für Hardwaretastaturen oder die Bildschirmtastatur, die in den Windows-Optionen für erleichterte Bedienung verfügbar ist.
• Der Eingabebereich bewirkt keine Eingabeüberprüfung und verhindert nicht, dass der Benutzer Eingaben über eine Hardwaretastatatur oder ein anderes Eingabegerät bereitstellt. Sie sind weiterhin dafür verantwortlich, die Eingabe im Code nach Bedarf zu validieren.

Ändern des Eingabeumfangs eines Textsteuerelements

Die für Ihre App verfügbaren Eingabebereiche sind Mitglieder der InputScopeNameValue-Aufzählung. Sie können die InputScope- eigenschaft eines TextBox- oder RichEditBox- auf einen dieser Werte festlegen.

Von Bedeutung

Die InputScope--Eigenschaft von PasswordBox- unterstützt nur die Werte Password und NumericPin. Jeder andere Wert wird ignoriert.

Hier ändern Sie den Eingabeumfang mehrerer Textfelder so, dass sie den erwarteten Daten für jedes Textfeld entsprechen.

So ändern Sie den Eingabebereich in XAML

1. Suchen Sie in der XAML-Datei für Ihre Seite das Tag für das Textsteuerelement, das Sie ändern möchten.

2. Fügen Sie dem Tag das InputScope-Attribut hinzu und geben Sie den Wert InputScopeNameValue an, der der erwarteten Eingabe entspricht.

   Hier sind einige Textfelder, die möglicherweise in einem allgemeinen Kundenkontaktformular angezeigt werden. Wenn die InputScope- festgelegt ist, wird eine Bildschirmtastatur mit einem geeigneten Layout für die Daten für jedes Textfeld angezeigt.

   <StackPanel Width="300">
       <TextBox Header="Name" InputScope="Default"/>
       <TextBox Header="Email Address" InputScope="EmailSmtpAddress"/>
       <TextBox Header="Telephone Number" InputScope="TelephoneNumber"/>
       <TextBox Header="Web site" InputScope="Url"/>
   </StackPanel>
   

Um den Eingabebereich im Code zu ändern

1. Suchen Sie in der XAML-Datei für Ihre Seite das Tag für das Textsteuerelement, das Sie ändern möchten. Wenn sie nicht festgelegt ist, legen Sie das x:Name-Attribut fest, damit Sie auf das Steuerelement im Code verweisen können.

   <TextBox Header="Telephone Number" x:Name="phoneNumberTextBox"/>
   

2. Instanziieren Sie ein neues InputScope--Objekt.

   InputScope scope = new InputScope();
   

3. Instanziieren Sie ein neues InputScopeName-Objekt.

   InputScopeName scopeName = new InputScopeName();
   

4. Legen Sie die NameValue- eigenschaft des InputScopeName-Objekts auf einen Wert der InputScopeNameValue--Enumeration fest.

   scopeName.NameValue = InputScopeNameValue.TelephoneNumber;
   

5. Fügen Sie das InputScopeName-Objekt zur Names-Sammlung des InputScope-Objekts hinzu.

   scope.Names.Add(scopeName);
   

6. Legen Sie das InputScope Objekt als Wert der InputScope Eigenschaft des Textsteuerelements fest.

   phoneNumberTextBox.InputScope = scope;
   

Hier ist der gesamte Code.

InputScope scope = new InputScope();
InputScopeName scopeName = new InputScopeName();
scopeName.NameValue = InputScopeNameValue.TelephoneNumber;
scope.Names.Add(scopeName);
phoneNumberTextBox.InputScope = scope;

Die gleichen Schritte können in diesem Kurzcode zusammengefasst werden.

phoneNumberTextBox.InputScope = new InputScope() 
{
    Names = {new InputScopeName(InputScopeNameValue.TelephoneNumber)}
};

Textvorhersage, Rechtschreibprüfung und automatische Korrektur

Die TextBox und RichEditBox Steuerelemente haben mehrere Eigenschaften, die das Verhalten des SIP beeinflussen. Um Ihren Benutzern eine optimale Benutzererfahrung zu bieten, ist es wichtig zu verstehen, wie sich diese Eigenschaften auf die Texteingabe mithilfe der Toucheingabe auswirken.

• IsSpellCheckEnabled – Wenn die Rechtschreibprüfung für ein Textsteuerelement aktiviert ist, interagiert das Steuerelement mit dem Rechtschreibprüfungsmodul des Systems, um Wörter zu markieren, die nicht erkannt werden. Sie können auf ein Wort tippen, um eine Liste der vorgeschlagenen Korrekturen anzuzeigen. Die Rechtschreibprüfung ist standardmäßig aktiviert.

  Für den Standardeingabebereich ermöglicht diese Eigenschaft auch die automatische Großschreibung des ersten Worts in einem Satz und die automatische Korrektur von Wörtern während der Eingabe. Diese Features für die automatische Korrektur können in anderen Eingabebereichen deaktiviert werden. Weitere Informationen finden Sie in den Tabellen weiter unten in diesem Thema.

• IsTextPredictionEnabled– Wenn die Textvorhersage für ein Textsteuerelement aktiviert ist, zeigt das System eine Liste der Wörter an, die Sie möglicherweise eingeben möchten. Sie können aus der Liste auswählen, damit Sie das gesamte Wort nicht eingeben müssen. Die Textvorhersage ist standardmäßig aktiviert.

  Die Textvorhersage ist möglicherweise deaktiviert, wenn der Eingabebereich nicht Standard-ist, auch wenn die IsTextPredictionEnabled- Eigenschaft Trueist. Weitere Informationen finden Sie in den Tabellen weiter unten in diesem Thema.

• PreventKeyboardDisplayOnProgrammaticFocus– Wenn diese Eigenschaft trueist, wird verhindert, dass das System das SIP anzeigt, wenn der Fokus programmgesteuert auf ein Textsteuerelement festgelegt ist. Stattdessen wird die Tastatur nur angezeigt, wenn der Benutzer mit dem Steuerelement interagiert.

Touch-Tastaturindex für Windows

Diese Tabellen zeigen die Layouts des Windows Soft Input Panel (SIP) für allgemeine Eingabebereichswerte. Der Effekt des Eingabebereichs auf die Features, die durch die Eigenschaften IsSpellCheckEnabled und IsTextPredictionEnabled aktiviert werden, ist für jeden Eingabebereich aufgeführt. Dies ist keine umfassende Liste der verfügbaren Eingabebereiche.

Tipp

Sie können die meisten Bildschirmtastaturen zwischen einem alphabetischen Layout und einem Layout mit Zahlen und Symbolen umschalten, indem Sie die TASTE &123 drücken, um zum Layout mit Zahlen und Symbolen zu wechseln, und drücken Sie die abcd-TASTE , um zum alphabetischen Layout zu wechseln.

Standard

<TextBox InputScope="Default"/>

Die Standardmäßige Windows-Bildschirmtastatur.

• Rechtschreibprüfung: Aktiviert, wenn IsSpellCheckEnabled = wahr ist, deaktiviert, wenn IsSpellCheckEnabled = falsch ist
• Autokorrektur: aktiviert, wenn IsSpellCheckEnabled = wahr, deaktiviert, wenn IsSpellCheckEnabled = falsch
• Automatische Großschreibung: aktiviert, wenn RechtschreibprüfungAktiviert = wahr, deaktiviert, wenn RechtschreibprüfungAktiviert = falsch
• Textvorhersage: aktiviert, wenn IsTextPredictionEnabled = true, deaktiviert, wenn IsTextPredictionEnabled = false

WährungsbetragUndSymbol

<TextBox InputScope="CurrencyAmountAndSymbol"/>

Das Standard-Tastaturlayout für Zahlen und Symbole.

• Enthält links-/rechtsseitige Tasten, um weitere Symbole anzuzeigen.
• Rechtschreibprüfung: Standardmäßig aktiviert, kann deaktiviert werden
• Automatische Korrektur: Standardmäßig aktiviert, kann deaktiviert werden
• Automatische Großschreibung: Immer deaktiviert
• Textvorhersage: Standardmäßig aktiviert, kann deaktiviert werden

URL

<TextBox InputScope="Url"/>

• Enthält die .com- und (Gehe)-Taste. Halten Sie die .com-TASTE gedrückt, um zusätzliche Optionen (.org, .net und regionsspezifische Suffixe) anzuzeigen.
• Enthält die Tasten :, -und /
• Rechtschreibprüfung: Standardmäßig deaktiviert, kann aktiviert werden
• Automatische Korrektur: Standardmäßig deaktiviert, kann aktiviert werden
• Automatische Großschreibung: Standardmäßig deaktiviert, kann aktiviert werden
• Textvorhersage: Standardmäßig deaktiviert, kann aktiviert werden

EmailSmtpAddress (E-Mail-SMTP-Adresse)

<TextBox InputScope="EmailSmtpAddress"/>

• Enthält die tasten @ und .com. Halten Sie die .com-TASTE gedrückt, um zusätzliche Optionen (.org, .net und regionsspezifische Suffixe) anzuzeigen.
• Enthält die _ und - Schlüssel
• Rechtschreibprüfung: Standardmäßig deaktiviert, kann aktiviert werden
• Automatische Korrektur: Standardmäßig deaktiviert, kann aktiviert werden
• Automatische Großschreibung: Standardmäßig deaktiviert, kann aktiviert werden
• Textvorhersage: Standardmäßig deaktiviert, kann aktiviert werden

Number

<TextBox InputScope="Number"/>

• Rechtschreibprüfung: Standardmäßig aktiviert, kann deaktiviert werden
• Automatische Korrektur: Standardmäßig aktiviert, kann deaktiviert werden
• Automatische Großschreibung: Immer deaktiviert
• Textvorhersage: Standardmäßig aktiviert, kann deaktiviert werden

Telefonnummer

<TextBox InputScope="TelephoneNumber"/>

• Rechtschreibprüfung: Standardmäßig aktiviert, kann deaktiviert werden
• Automatische Korrektur: Standardmäßig aktiviert, kann deaktiviert werden
• Automatische Großschreibung: Immer deaktiviert
• Textvorhersage: Standardmäßig aktiviert, kann deaktiviert werden

Suche

<TextBox InputScope="Search"/>

• Enthält die Suchtaste anstelle der Eingabetaste.
• Rechtschreibprüfung: Standardmäßig aktiviert, kann deaktiviert werden
• Automatische Korrektur: Standardmäßig aktiviert, kann deaktiviert werden
• Automatische Großschreibung: immer deaktiviert
• Textvorhersage: Standardmäßig aktiviert, kann deaktiviert werden

SearchIncremental

<TextBox InputScope="SearchIncremental"/>

• Gleiches Layout wie Standard-
• Rechtschreibprüfung: Standardmäßig deaktiviert, kann aktiviert werden
• Automatische Korrektur: Immer deaktiviert
• Automatische Großschreibung: Immer deaktiviert
• Textvorhersage: Immer deaktiviert

Formula

<TextBox InputScope="Formula"/>

• Enthält den =-Schlüssel.
• Enthält auch die %-Tasten, $-Tasten und +-Tasten
• Rechtschreibprüfung: Standardmäßig aktiviert, kann deaktiviert werden
• Automatische Korrektur: Standardmäßig aktiviert, kann deaktiviert werden
• Automatische Großschreibung: Immer deaktiviert
• Textvorhersage: Standardmäßig aktiviert, kann deaktiviert werden

Chat

<TextBox InputScope="Chat"/>

• Gleiches Layout wie Standard-
• Rechtschreibprüfung: Standardmäßig aktiviert, kann deaktiviert werden
• Automatische Korrektur: Standardmäßig aktiviert, kann deaktiviert werden
• Automatische Großschreibung: Standardmäßig aktiviert, kann deaktiviert werden
• Textvorhersage: Standardmäßig aktiviert, kann deaktiviert werden

NameOderTelefonnummer

<TextBox InputScope="NameOrPhoneNumber"/>

• Gleiches Layout wie Standard-
• Rechtschreibprüfung: Standardmäßig deaktiviert, kann aktiviert werden
• Automatische Korrektur: Standardmäßig deaktiviert, kann aktiviert werden
• Automatische Großschreibung: Standardmäßig deaktiviert, kann aktiviert werden (erster Buchstabe jedes Worts ist großgeschrieben)
• Textvorhersage: Standardmäßig deaktiviert, kann aktiviert werden