AppBarSeparator.DynamicOverflowOrder プロパティ

リファレンス

定義

名前空間:: Windows.UI.Xaml.Controls

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

この項目を CommandBar オーバーフローメニューに移動する順序を取得または設定します。

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

int DynamicOverflowOrder();

void DynamicOverflowOrder(int value);

public int DynamicOverflowOrder { get; set; }

var int32 = appBarSeparator.dynamicOverflowOrder;
appBarSeparator.dynamicOverflowOrder = int32;

Public Property DynamicOverflowOrder As Integer

<AppBarSeparator 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 プロパティは、バージョン 1607 より前Windows 10使用できません。 Microsoft Visual Studio のアプリの "最小プラットフォームバージョン" 設定が、このページの後半の「要件」ブロックに示されている "導入されたバージョン" より小さい場合は、これを考慮してアプリを設計してテストする必要があります。詳細については、「バージョンアダプティブコード」を参照してください。

注意

動的オーバーフローは、アプリがWindows 10バージョン 1607 用にコンパイルされ、バージョン 1607 (以降) で実行されている場合に使用できます。動的オーバーフローは、アプリが以前のバージョン用にコンパイルされている場合、または以前のバージョンで実行されている場合は使用できません。

アプリを以前のバージョンのWindows 10で実行するときに例外を回避するには、XAML でこのプロパティを設定したり、ランタイムチェックを実行せずに使用したりしないでください。この例では、ApiInformation クラスを使用して、設定する前にこのプロパティの存在をチェックする方法を示します。

<CommandBar x:Name="commandBar1" Loaded="CommandBar_Loaded">
    <AppBarButton x:Name="appBarButtonCut" Icon="Cut" Label="Cut"/>
    <AppBarButton x:Name="appBarButtonCopy" Icon="Copy" Label="Copy"/>
    <AppBarSeparator x:Name="appBarSeparator1"/>
    <AppBarButton x:Name="appBarButtonPaste" Icon="Paste" Label="Paste"/>
</CommandBar>

private void CommandBar_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.AppBarSeparator", "DynamicOverflowOrder"))
    {
        commandBar1.IsDynamicOverflowEnabled = true;
        appBarButtonCut.DynamicOverflowOrder = 1;
        appBarButtonCopy.DynamicOverflowOrder = 2;
        appBarSeparator1.DynamicOverflowOrder = 2;
        appBarButtonPaste.DynamicOverflowOrder = 3;
    }
}

適用対象

Share via