AppBarButton.IsInOverflow プロパティ

リファレンス

定義

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

重要

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

編集

この項目がオーバーフローメニュー内にあるかどうかを示す値を取得します。

public:
 property bool IsInOverflow { bool get(); };

bool IsInOverflow();

public bool IsInOverflow { get; }

var boolean = appBarButton.isInOverflow;

Public ReadOnly Property IsInOverflow As Boolean

プロパティ値

Boolean

bool

この項目がオーバーフローメニューにある場合は true。それ以外の場合は false。

実装

IsInOverflow

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 にコマンドを移動することはありません。

バージョンの互換性

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

注意

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

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

if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.AppBarButton", "IsInOverflow"))
{
    bool overflow = appBarButton1.IsInOverflow;
}

適用対象

こちらもご覧ください

アプリバーとコマンドバーガイド