TextBox.InputScope Properti

Definisi

Ruang nama:

Windows.UI.Xaml.Controls

Mendapatkan atau mengatur konteks untuk input yang digunakan oleh TextBox ini.

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>

Nilai Properti

InputScope

Cakupan input, yang memberikan petunjuk pada jenis input teks yang diharapkan oleh kontrol. Defaultnya adalah null.

Contoh

Berikut cara mengatur InputScope di XAML dan dalam kode.

<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;

Keterangan

Cakupan input memberikan petunjuk pada jenis input teks yang diharapkan oleh kontrol. Berbagai elemen sistem dapat menanggapi petunjuk yang disediakan oleh cakupan input dan menyediakan UI khusus untuk jenis input. Misalnya, papan ketik sentuh mungkin menampilkan pad angka untuk input teks saat kontrol mengatur InputScope-nya ke Angka. Lihat enumerasi InputScopeNameValue untuk daftar lengkap nilai cakupan input.

Kontrol mungkin juga menginterpretasikan data yang dimasukkan secara berbeda (biasanya untuk cakupan input terkait Asia Timur). Cakupan input tidak melakukan validasi apa pun, dan tidak mencegah pengguna memberikan input apa pun melalui keyboard perangkat keras atau perangkat input lainnya.

Properti lain yang memengaruhi keyboard sentuh adalah IsSpellCheckEnabled, IsTextPredictionEnabled, dan PreventKeyboardDisplayOnProgrammaticFocus. Untuk informasi dan contoh selengkapnya, lihat Menggunakan cakupan input untuk mengubah keyboard sentuh.

Catatan

Meskipun properti ini dapat menyimpan kumpulan nilai InputScopeName , hanya yang pertama yang digunakan, dan sisanya diabaikan.

Lihat juga

• IsSpellCheckEnabledProperty
• IsTextPredictionEnabledProperty
• InputScopeNameValue
• Menggunakan cakupan input untuk mengubah papan ketik sentuh