TextBox.InputScope Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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.