Flyout クラス

定義

/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Content")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Flyout : FlyoutBase

[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Content")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Flyout : FlyoutBase

Public Class Flyout
Inherits FlyoutBase

<Flyout>
    singleUIElement
</Flyout>

継承

Object IInspectable DependencyObject FlyoutBase Flyout

属性

ContentPropertyAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

例

WinUI 3 ギャラリー アプリには、ほとんどの WinUI 3 コントロールと機能の対話型の例が含まれています。 Microsoft Store からアプリを入手するか、GitHub でソース コードを取得します。

注釈

ポップアップには、ユーザーの操作を必要とするメッセージが表示されます。

ポップアップ コントロールを使用して、情報を収集したり、詳細情報を表示したり、警告や確認を行ったりします。 ダイアログとは異なり、ポップアップは別のウィンドウを作成せず、他のユーザー操作をブロックしません。 項目のメニューを表示するには、代わりに MenuFlyout を使用します。 XAML やコード例など、詳細については、「 ポップアップ」を参照してください。

ポップアップ コントロール (または MenuFlyout) は、 Button.Flyout プロパティの値として使用されます。 これは通常、ページの UI 定義の一部として XAML で設定されます。 ボタン は、専用の Flyout プロパティを持つ唯一のコントロールです。 ポップアップを他のコントロールに関連付けるには、 FlyoutBase.AttachedFlyout 添付プロパティを使用します。 Button.Flyout に設定すると、ボタンがタップされたとき、またはその他の方法で呼び出されたときにポップアップが表示されます。 FlyoutBase.AttachedFlyout を使用してポップアップが他の UI 要素に割り当てられている場合は、ShowAt メソッドまたは静的 ShowAttachedFlyout メソッドを呼び出してポップアップを表示する必要があります。

このリファレンス トピックに記載されているメンバーに加えて、一般的な Flyout シナリオでよく使用される基底クラス FlyoutBase の他のメンバーもあります。

• FlyoutBase.AttachedFlyout: ポップアップを特定の UI 要素に関連付ける添付プロパティ (任意の FrameworkElement 派生クラスを指定できます)。
• ShowAttachedFlyout: FlyoutBase.AttachedFlyout の割り当てを通じて、ポップアップが UI 要素に既に関連付けられているかどうかを判断できる静的メソッドです。 その場合、メソッドは、指定した FrameworkElement を使用して内部的に ShowAt を呼び出します。

Accessibility

次に示すように、フォーカス可能なコンテンツのないポップアップ (テキストのみなど) を使用する場合は、コンテンツにアクセスできるようにするための追加の手順を実行する必要があります。 具体的には、Windowsナレーターや他のスクリーン リーダーがポップアップのコンテンツを読み取れるようにする必要があります。

既定では、 FlyoutPresenter にはフォーカスを受け取らないように設定されたプロパティがあります。 これは、ポップアップ内のコンテンツがフォーカスを受け取ることができる場合に必要な動作です。 ただし、Flyout 内のコンテンツがフォーカスを受け取ることができない場合は、 FlyoutPresenterStyle に更新して 、代わりに FlyoutPresenter にフォーカスを受け取らせる必要があります。 これを行うには、 UIElement.IsTabStop を true に設定し、 TabNavigation をフライアウト発表者スタイルで Cycle に設定します。

この例では、コンテンツにアクセスできるように FlyoutPresenter にフォーカスを受け取らせる方法を示します。

<Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
    <Button VerticalAlignment="Center" HorizontalAlignment="Center"
            Content="Open flyout">
        <Button.Flyout>
            <Flyout>
                <Flyout.FlyoutPresenterStyle>
                    <Style TargetType="FlyoutPresenter">
                        <Setter Property="ScrollViewer.HorizontalScrollMode" Value="Disabled"/>
                        <Setter Property="ScrollViewer.HorizontalScrollBarVisibility" Value="Disabled"/>
                        <Setter Property="IsTabStop" Value="True"/>
                        <Setter Property="TabNavigation" Value="Cycle"/>
                    </Style>
                </Flyout.FlyoutPresenterStyle>
                <TextBlock TextWrapping="Wrap" Text="This is some text in a flyout."/>
            </Flyout>
        </Button.Flyout>
    </Button>
</Grid>

こちらもご覧ください

• FlyoutBase
• FlyoutPresenter
• Flyout
• MenuFlyout
• フライアウト
• ダイアログ v. ポップアップ
• 添付プロパティの概要
• コマンド サンプル (Windows 10)