TextBox.InputScope Eigenschaft

  • Referenz

Definition

Namespace:
Microsoft.UI.Xaml.Controls
Bearbeiten

Ruft den Kontext für die eingabe ab, die von diesem Textfeld verwendet wird, oder legt diesen fest.

public:
 property InputScope ^ InputScope { InputScope ^ get(); void set(InputScope ^ value); };
InputScope InputScope();

void InputScope(InputScope value);
public InputScope InputScope { get; set; }
var inputScope = textBox.inputScope;
textBox.inputScope = inputScope;
Public Property InputScope As InputScope
<TextBox InputScope="inputScopeName" .../>
- or -
<TextBox>
  <TextBox.InputScope>
    <InputScope>
      <InputScope.Names>
        <InputScopeName NameValue="inputScopeName"/>
      </InputScope.Names>
    </InputScope>
  </TextBox.InputScope>
</TextBox>

Eigenschaftswert

InputScope

Der Eingabebereich, der einen Hinweis auf den Typ der Texteingabe bietet, die vom Steuerelement erwartet wird.

Beispiele

Hier erfahren Sie, wie Sie das InputScope in XAML und im Code festlegen.

<TextBox Header="Telephone Number" InputScope="TelephoneNumber"/>

TextBox phoneNumberTextBox = new TextBox();
phoneNumberTextBox.Header="Telephone Number";

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

Hinweise

Der Eingabebereich bietet einen Hinweis auf den Typ der Texteingabe, die vom Steuerelement erwartet wird. Verschiedene Elemente des Systems können auf den vom Eingabebereich bereitgestellten Hinweis reagieren und eine spezielle Benutzeroberfläche für den Eingabetyp bereitstellen. Auf der Touchtastatur kann beispielsweise ein Zahlenpad für die Texteingabe angezeigt werden, wenn das Steuerelement sein InputScope auf Numberfestgelegt hat. Eine vollständige Liste der Eingabebereichswerte finden Sie in der InputScopeNameValue-Enumeration .

Das Steuerelement kann auch die eingegebenen Daten unterschiedlich interpretieren (in der Regel für ostasiatische Eingabebereiche). Der Eingabebereich führt keine Überprüfung durch und hindert den Benutzer nicht daran, Eingaben über eine Hardwaretastatatur oder ein anderes Eingabegerät bereitzustellen.

Weitere Eigenschaften, die sich auf die Bildschirmtastatur beziehen, sind IsSpellCheckEnabled, IsTextPredictionEnabled und PreventKeyboardDisplayOnProgrammaticFocus. Weitere Informationen und Beispiele finden Sie unter Verwenden des Eingabebereichs zum Ändern der Touchtastatur.

Hinweis

Während diese Eigenschaft eine Auflistung von InputScopeName-Werten enthalten kann, wird nur der erste verwendet, und der Rest wird ignoriert.

Gilt für:

Weitere Informationen