RichEditBox.InputScope Eigenschaft

Definition

Namespace:

Windows.UI.Xaml.Controls

Ruft den Kontext für die eingabe ab, die von diesem RichEditBox 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 = richEditBox.inputScope;
richEditBox.inputScope = inputScope;

Public Property InputScope As InputScope

<RichEditBox InputScope="inputScopeName" .../>
- or -
<RichEditBox>
  <RichEditBox.InputScope>
    <InputScope>
      <InputScope.Names>
        <InputScopeName NameValue="inputScopeName"/>
      </InputScope.Names>
    </InputScope>
  </RichEditBox.InputScope>
</RichEditBox>

Eigenschaftswert

InputScope

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 das InputScope in XAML und im Code festlegen.

<RichEditBox InputScope="Formula"/>

RichEditBox editBox = new RichEditBox();

InputScope scope = new InputScope();
InputScopeName scopeName = new InputScopeName();
scopeName.NameValue = InputScopeNameValue.Formula;
scope.Names.Add(scopeName);
editBox.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 soften Tastatur kann beispielsweise ein Zahlenpad für die Texteingabe angezeigt werden, wenn das Steuerelement sein InputScope auf Zahl festgelegt hat. Eine vollständige Liste der Eingabebereichswerte finden Sie in der InputScopeNameValue-Enumeration .

Das Steuerelement interpretiert möglicherweise auch die eingegebenen Daten unterschiedlich (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.

Wichtig

Während diese Eigenschaft eine Auflistung von InputScopeName-Werten enthalten kann, wird in den meisten Fällen nur die erste verwendet. Die einzige Ausnahme ist, wenn Private als Wert angegeben wird. Private wird niemals ignoriert, unabhängig vom Speicherort in der Auflistung. Wenn Private das erste Element in der Auflistung ist, wird auch das nächste Element in der Auflistung (sofern vorhanden) verwendet.

Weitere Informationen

• InputScopeNameValue