[.NET MAUI][Popup] プロンプトを表示する

.NET MAUI

.NET MAUI TIPS

2022.07.20

本記事の概要
プロンプトの基本
1. プロンプト表示のサンプル
その他のオプション
.NET MAUI Tips

本記事の概要

プロンプトとは、ユーザーに質問を提示して、入力をさせるためのポップアップダイアログです。

この記事ではプロンプトを表示する方法について説明します。

公式サイト情報はコチラを参照してください。

プロンプトの例

プロンプトの基本

プロンプトを表示するには、DisplayPromptAsunc メソッドを使用します。書式は次の通りです。

string = await DisplayPromptAsync("タイトル","メッセージ")

第１引数はプロンプトに表示するタイトル、第２引数はメッセージ（ユーザーへの質問事項）を指定します。ユーザーが回答を入力して [OK] を押すと、入力された内容が文字列として返されます。

プロンプト表示のサンプル

以下の例では、[Show Prompt] ボタンをクリックすると、タイトルが「個人情報」、メッセージに「年齢を入力してください」というプロンプトが表示されます。ユーザーが回答を入力して[OK]をクリックすると、入力された内容は ans に格納されます。

XAML の例

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="MauiAppSample.MainPage">

    <ScrollView>
        <VerticalStackLayout 
            Spacing="25" 
            Padding="30,0" 
            VerticalOptions="Center">

            <Button Text="Show Prompt" Clicked="Button_Clicked" />

        </VerticalStackLayout>
    </ScrollView>

</ContentPage>

C# の例

private async void Button_Clicked(object sender, EventArgs e)
{
    string ans = await DisplayPromptAsync("個人情報","年齢を入力してください");

    Debug.WriteLine($"{ans}");
}

プロンプトの例

その他のオプション

プロンプトには第３引数以降でその他のオプションを指定することもできます。

引数	説明
第1引数	タイトル
第2引数	メッセージ（質問）
第3引数	OKボタンテキスト
第4引数	Cancelボタンテキスト
第5引数	プレースホルダ
第6引数	最大入力文字数（既定値は-1で制限なし）
第7引数	キーボード種類
第8引数	初期値

以下は、全ての引数を指定した例です。上記表と照らし合わせて確認をしてください。

C# の例

private async void Button_Clicked(object sender, EventArgs e)
{
    string ans = await DisplayPromptAsync(
        "個人情報",
        "年齢を入力してください",
        "OK",
        "Cancel",
        "年齢",
        3,
        Keyboard.Numeric,
        "20");

    Debug.WriteLine($"{ans}");
}