CommandBar.IsDynamicOverflowEnabled 속성

정의

네임스페이스:

Windows.UI.Xaml.Controls

공간이 제한될 때 기본 명령이 자동으로 오버플로 메뉴로 이동하는지 여부를 나타내는 값을 가져오거나 설정합니다.

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

bool IsDynamicOverflowEnabled();

void IsDynamicOverflowEnabled(bool value);

public bool IsDynamicOverflowEnabled { get; set; }

var boolean = commandBar.isDynamicOverflowEnabled;
commandBar.isDynamicOverflowEnabled = boolean;

Public Property IsDynamicOverflowEnabled As Boolean

<CommandBar IsDynamicOverflowEnabled="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부터 CommandBar는 동적 오버플로 기능을 도입합니다. 기본적으로 PrimaryCommands는 명령 모음 너비가 변경되면(예: 사용자가 앱 창의 크기를 조정할 때) 오버플로 영역 내/외부로 자동으로 이동됩니다. IsDynamicOverflowEnabled 속성을 false 로 설정하여 이 동작을 사용하지 않도록 설정할 수 있습니다.

동적 오버플로는 명령의 UI 프레젠테이션에만 영향을 줍니다. PrimaryCommands 컬렉션에서 SecondaryCommands로 명령을 이동하지 않습니다.

버전 호환성

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

참고

앱이 Windows 10 버전 1607용으로 컴파일되고 버전 1607 이상에서 실행되는 경우 동적 오버플로를 사용할 수 있습니다. 앱이 이전 버전에 대해 컴파일되거나 이전 버전에서 실행되는 경우 동적 오버플로를 사용할 수 없습니다.

앱이 이전 버전의 Windows 10 실행되는 경우 예외를 방지하려면 먼저 런타임 검사 수행하지 않고 이 속성을 사용하지 마세요. 이 예제에서는 사용 하기 전에이 속성의 존재에 대 한 검사 ApiInformation 클래스를 사용 하는 방법을 보여 집니다.

<CommandBar x:Name="commandBar1" Loaded="CommandBar_Loaded">
    ...
</CommandBar>

private void CommandBar_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.CommandBar", "IsDynamicOverflowEnabled"))
    {
        commandBar1.IsDynamicOverflowEnabled = true;
    }
}