AppBarToggleButton.DynamicOverflowOrder 속성

정의

네임스페이스:

Windows.UI.Xaml.Controls

이 항목이 CommandBar 오버플로 메뉴로 이동하는 순서를 가져오거나 설정합니다.

public:
 property int DynamicOverflowOrder { int get(); void set(int value); };

int DynamicOverflowOrder();

void DynamicOverflowOrder(int value);

public int DynamicOverflowOrder { get; set; }

var int32 = appBarToggleButton.dynamicOverflowOrder;
appBarToggleButton.dynamicOverflowOrder = int32;

Public Property DynamicOverflowOrder As Integer

<AppBarToggleButton DynamicOverflowOrder="int" .../>

속성 값

Int32

int

이 항목이 다른 항목을 기준으로 오버플로 메뉴로 이동하는 순서입니다.

구현

DynamicOverflowOrder

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로 명령을 이동하지 않습니다.

이 속성은 이 요소가 CommandBar.PrimaryCommands 컬렉션에 있고 CommandBar.IsDynamicOverflowEnabled 가 true인 경우에만 적용됩니다.

동일한 DynamicOverflowOrder 값을 둘 이상의 요소에 할당할 수 있습니다. 동일한 값을 가진 요소가 오버플로 영역의 내/외부로 동시에 이동합니다.

버전 호환성

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

참고

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

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

<CommandBar x:Name="commandBar1" Loaded="CommandBar_Loaded">
    <AppBarToggleButton x:Name="appBarButtonShuffle" Icon="Shuffle" Label="Shuffle"/>
    <AppBarToggleButton x:Name="appBarButtonRepeat" Icon="RepeatAll" Label="Repeat"/>
</CommandBar>

private void CommandBar_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.AppBarToggleButton", "DynamicOverflowOrder"))
    {
        commandBar1.IsDynamicOverflowEnabled = true;
        appBarButtonShuffle.DynamicOverflowOrder = 1;
        appBarButtonRepeat.DynamicOverflowOrder = 2;
    }
}