次の方法で共有


iOS での SearchBar スタイル

この .NET マルチプラットフォーム アプリ UI (.NET MAUI) iOS プラットフォーム固有は、SearchBar に背景があるかどうかを制御します。 これは、バインド可能な SearchBar.SearchBarStyle プロパティを UISearchBarStyle 列挙の値に設定して、XAML で使用されます。

<ContentPage ...
             xmlns:ios="clr-namespace:Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific;assembly=Microsoft.Maui.Controls">
    <StackLayout>
        <SearchBar ios:SearchBar.SearchBarStyle="Minimal"
                   Placeholder="Enter search term" />
        ...
    </StackLayout>
</ContentPage>

あるいは、Fluent API を使用して C# から使用することもできます。

using Microsoft.Maui.Controls.PlatformConfiguration;
using Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific;
...

SearchBar searchBar = new SearchBar { Placeholder = "Enter search term" };
searchBar.On<iOS>().SetSearchBarStyle(UISearchBarStyle.Minimal);

SearchBar.On<iOS> メソッドは、このプラットフォーム固有の機能が iOS でのみ実行されるように指定します。 Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific 名前空間の SearchBar.SetSearchBarStyle メソッドは、SearchBar に背景があるかどうかを制御するために使用されます。 UISearchBarStyle 列挙は、次の 3 つの取り得る値を提供します。

  • Default は、SearchBar に既定のスタイルがあることを示します。 これは、バインド可能な SearchBar.SearchBarStyle プロパティの既定値です。
  • Prominent は、SearchBar に半透明の背景があり、検索フィールドが不透明であることを示します。
  • Minimal は、SearchBar に背景がなく、検索フィールドが半透明であることを示します。

さらに、SearchBar.GetSearchBarStyle メソッドを使用すると、SearchBar に適用される UISearchBarStyle を返すことができます。

その結果、指定した UISearchBarStyle メンバーが SearchBar に適用され、SearchBar に背景があるかどうかが制御されます。

Screenshot of SearchBar styles, on iOS.

次のスクリーンショットは、BackgroundColor プロパティが設定されている SearchBar オブジェクトに適用された UISearchBarStyle メンバーを示しています。

Screenshot of SearchBar styles with background color, on iOS.