Freigeben über


TextBox.InputScope Eigenschaft

Definition

Ruft den Kontext für die Eingabe ab, die von diesem TextBox 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

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

Beispiele

Hier erfahren Sie, wie Sie 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. Beispielsweise kann die Bildschirmtastatur ein Zahlenpad für die Texteingabe anzeigen, wenn das Eingabebereich des Steuerelements auf Zahl festgelegt ist. 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 Bildschirmtastatur.

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