다음을 통해 공유


TextBox.InputScope 속성

정의

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>

속성 값

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

예제

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, IsTextPredictionEnabledPreventKeyboardDisplayOnProgrammaticFocus입니다. 자세한 내용 및 예제는 입력 범위를 사용하여 터치 키보드 변경을 참조하세요.

참고

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

적용 대상

추가 정보