UWP中CommandBar More按钮不显示及CustomMediaTransportControls动态溢出问题

我之前也碰到过这个CustomMediaTransportControls动态溢出失效的坑，折腾了好一阵才理顺，给你几个具体的排查和解决方向：

1. 检查CustomMediaTransportControls的模板结构是否正确 #

CustomMediaTransportControls的动态溢出依赖于CommandBar内部的特定布局逻辑，如果你自定义ControlTemplate时破坏了这个结构，就会导致溢出功能失效。

• 确保模板中的CommandBar使用了默认的CommandBarPanel作为内部布局容器，而不是普通的StackPanel或其他面板。
• 确认CommandBar的IsDynamicOverflowEnabled属性确实设置为True，并且没有在代码后台被意外覆盖。

示例正确的CommandBar模板片段：

<CommandBar x:Name="MediaControlsCommandBar" 
            IsDynamicOverflowEnabled="True"
            Background="Transparent">
    <CommandBar.PrimaryCommands>
        <!-- 你的自定义AppBarButton和默认媒体控件按钮 -->
        <AppBarButton Icon="Play" MediaTransportControlsHelper.DropoutOrder="-10"/>
        <AppBarButton Icon="Repeat" MediaTransportControlsHelper.DropoutOrder="10"/>
    </CommandBar.PrimaryCommands>
</CommandBar>

2. 确认DropOutOrder属性的设置逻辑 #

MediaTransportControlsHelper.DropoutOrder的数值决定了按钮被移入溢出菜单的优先级：

• 数值越大的按钮，会最先被移入溢出菜单；数值越小（甚至负数）的按钮，保留在主命令栏的优先级越高。
• 默认的媒体控件按钮（比如播放/暂停、音量）的DropOutOrder是负数（比如播放按钮是-10，音量是-20），所以你的自定义按钮应该设置正数，这样空间不足时它们会先被溢出。
• 不要给自定义按钮设置和默认按钮相同的DropOutOrder，否则可能导致溢出顺序混乱。

3. 检查AppBarButton的OverflowMode属性 #

如果你的自定义AppBarButton设置了OverflowMode="Never"，这个按钮会永远留在主命令栏，可能占用空间导致其他按钮无法正常溢出；如果设置为Always，则会直接进入溢出菜单。

• 确保所有需要参与动态溢出的按钮的OverflowMode保持默认的Auto，这样CommandBar才能根据空间和DropOutOrder自动处理。

4. 强制触发CommandBar的布局更新 #

有时候窗口尺寸变化时，CommandBar可能没有及时重新计算布局，导致溢出状态不更新。你可以在窗口大小变化事件中手动触发布局刷新：

public sealed partial class CustomMediaTransportControls : MediaTransportControls
{
    public CustomMediaTransportControls()
    {
        this.InitializeComponent();
        Window.Current.SizeChanged += OnWindowSizeChanged;
    }

    private void OnWindowSizeChanged(object sender, WindowSizeChangedEventArgs e)
    {
        MediaControlsCommandBar?.UpdateLayout();
        MediaControlsCommandBar?.InvalidateMeasure();
    }
}

5. 排查父容器的宽度限制 #

如果CustomMediaTransportControls被放在了固定宽度的容器中（比如Width="400"的Grid列），CommandBar会认为自己有足够的空间，不会触发溢出逻辑。

• 确保父容器使用自适应宽度（比如Grid的列设置为*，或者直接让控件填充可用空间），这样CommandBar才能感知到窗口尺寸变化带来的空间不足。

我之前就是因为自定义模板时把CommandBar的内部面板改成了普通StackPanel，导致溢出逻辑完全失效，改回CommandBarPanel后问题就解决了。你可以按这个顺序排查，应该能找到问题所在。

内容的提问来源于stack exchange，提问作者Muhammad Touseef