CommandBar.DynamicOverflowItemsChanging 이벤트

정의

네임스페이스:

Microsoft.UI.Xaml.Controls

항목이 오버플로 메뉴로 이동하거나 외부로 이동할 때 발생합니다.

// Register
event_token DynamicOverflowItemsChanging(TypedEventHandler<CommandBar, DynamicOverflowItemsChangingEventArgs const&> const& handler) const;

// Revoke with event_token
void DynamicOverflowItemsChanging(event_token const* cookie) const;

// Revoke with event_revoker
CommandBar::DynamicOverflowItemsChanging_revoker DynamicOverflowItemsChanging(auto_revoke_t, TypedEventHandler<CommandBar, DynamicOverflowItemsChangingEventArgs const&> const& handler) const;

public event TypedEventHandler<CommandBar,DynamicOverflowItemsChangingEventArgs> DynamicOverflowItemsChanging;

function onDynamicOverflowItemsChanging(eventArgs) { /* Your code */ }
commandBar.addEventListener("dynamicoverflowitemschanging", onDynamicOverflowItemsChanging);
commandBar.removeEventListener("dynamicoverflowitemschanging", onDynamicOverflowItemsChanging);
- or -
commandBar.ondynamicoverflowitemschanging = onDynamicOverflowItemsChanging;

Public Custom Event DynamicOverflowItemsChanging As TypedEventHandler(Of CommandBar, DynamicOverflowItemsChangingEventArgs) 

<CommandBar DynamicOverflowItemsChanging="eventhandler"/>

이벤트 유형

TypedEventHandler<CommandBar,DynamicOverflowItemsChangingEventArgs>

설명

이벤트 데이터는 DynamicOverflowItemsChangingEventArgs를 참조하세요.

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.IsEventPresent("Windows.UI.Xaml.Controls.CommandBar", "DynamicOverflowItemsChanging"))
    {
        commandBar1.DynamicOverflowItemsChanging += CommandBar1_DynamicOverflowItemsChanging;
    }
}

추가 정보

• DynamicOverflowItemsChangingEventArgs
• 명령 모음