CommandBar.DynamicOverflowItemsChanging 이벤트

정의

네임스페이스:

Windows.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>

Windows 요구 사항

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

설명

이벤트 데이터는 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
• 앱 바 및 명령 모음