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

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

예제

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;

설명

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

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

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

참고

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

추가 정보

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