TextBox.InputScope 속성

정의

네임스페이스:

Microsoft.UI.Xaml.Controls

이 TextBox에서 사용하는 입력의 컨텍스트를 가져오거나 설정합니다.

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>

속성 값

InputScope

컨트롤에서 예상하는 텍스트 입력 형식에 대한 힌트를 제공하는 입력 범위입니다.

예제

XAML 및 코드에서 InputScope 를 설정하는 방법은 다음과 같습니다.

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

설명

입력 범위는 컨트롤에서 예상하는 텍스트 입력 형식에 대한 힌트를 제공합니다. 시스템의 다양한 요소는 입력 범위에서 제공하는 힌트에 응답하고 입력 형식에 대한 특수한 UI를 제공할 수 있습니다. 예를 들어 컨트롤에 InputScope 가 설정된 경우 터치 키보드에 텍스트 입력에 대한 숫자 패드가 표시될 수 있습니다 Number. 입력 범위 값의 전체 목록은 InputScopeNameValue 열거형을 참조하세요.

컨트롤은 입력되는 데이터를 다르게 해석할 수도 있습니다(일반적으로 동아시아 관련 입력 범위의 경우). 입력 범위는 유효성 검사를 수행하지 않으며 사용자가 하드웨어 키보드 또는 기타 입력 디바이스를 통해 입력을 제공하는 것을 방지하지 않습니다.

터치 키보드에 영향을 주는 다른 속성은 IsSpellCheckEnabled, IsTextPredictionEnabled 및 PreventKeyboardDisplayOnProgrammaticFocus입니다. 자세한 내용 및 예제는 입력 범위 사용을 참조하여 터치 키보드를 변경합니다.

메모

이 속성은 InputScopeName 값 컬렉션을 보유할 수 있지만 첫 번째 속성만 사용되고 나머지는 무시됩니다.

추가 정보

• IsSpellCheckEnabledProperty
• IsTextPredictionEnabledProperty
• InputScopeNameValue
• 입력 범위를 사용하여 터치 키보드를 변경하기