ComboBox.IsTextSearchEnabled 속성

정의

네임스페이스:

Windows.UI.Xaml.Controls

사용자가 입력하여 값으로 이동할 수 있는지 여부를 지정하는 값을 가져오거나 설정합니다.

public:
 property bool IsTextSearchEnabled { bool get(); void set(bool value); };

bool IsTextSearchEnabled();

void IsTextSearchEnabled(bool value);

public bool IsTextSearchEnabled { get; set; }

var boolean = comboBox.isTextSearchEnabled;
comboBox.isTextSearchEnabled = boolean;

Public Property IsTextSearchEnabled As Boolean

<ComboBox IsTextSearchEnabled="bool"/>

속성 값

Boolean

bool

사용자가 입력하여 값으로 이동할 수 있으면 true입니다. 그렇지 않으면 false입니다. 기본값은 true입니다.

Windows 요구 사항

디바이스 패밀리	Windows 10 Anniversary Edition (10.0.14393.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v3.0에서 도입되었습니다.)

설명

Windows 10 버전 1607부터 ComboBox에는 텍스트 검색 기능이 도입되었습니다. 기본적으로 ComboBox 는 사용자가 입력할 때 관련 값으로 이동합니다. IsTextSearchEnabled 속성을 false 로 설정하여 이 동작을 사용하지 않도록 설정할 수 있습니다. 예를 들어 사용자 지정 텍스트 검색을 사용하여 ComboBox 를 확장한 경우에 유용합니다.

버전 호환성

IsTextSearchEnabled 속성은 Windows 10 버전 1607 이전에는 사용할 수 없습니다. Microsoft Visual Studio에서 앱의 '최소 플랫폼 버전' 설정이 이 페이지의 뒷부분에 있는 요구 사항 블록에 표시된 '도입된 버전'보다 작은 경우 이를 고려하여 앱을 디자인하고 테스트해야 합니다. 자세한 내용은 버전 적응 코드를 참조하세요.

참고

텍스트 검색 기능은 앱이 Windows 10 버전 1607용으로 컴파일되고 버전 1607 이상에서 실행되는 경우에 사용할 수 있습니다. 앱이 이전 버전에 대해 컴파일되거나 이전 버전에서 실행 중인 경우에는 사용할 수 없습니다.

앱이 이전 버전의 Windows 10 실행되는 경우 예외를 방지하려면 XAML에서 이 속성을 설정하거나 런타임 검사 수행하지 않고 사용하지 마세요. 이 예제에서는 ApiInformation 클래스를 사용하여 설정하기 전에 이 속성이 있는지 검사 방법을 보여줍니다.

<ComboBox x:Name="comboBox1" Loaded="ComboBox_Loaded"/>

private void ComboBox_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.ComboBox", "IsTextSearchEnabled"))
    {
        comboBox1.IsTextSearchEnabled = false;
    }
}