Partager via


Style SearchBar sur iOS

Cette interface utilisateur de l’application multiplateforme .NET (.NET MAUI) contrôle si une SearchBar plateforme a un arrière-plan. Elle est consommée en XAML en définissant la SearchBar.SearchBarStyle propriété pouvant être liée sur une valeur de l’énumération UISearchBarStyle :

<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>

Vous pouvez également l’utiliser à partir de C# à l’aide de l’API Fluent :

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);

La SearchBar.On<iOS> méthode spécifie que cette plateforme spécifique ne s’exécutera que sur iOS. La SearchBar.SetSearchBarStyle méthode, dans l’espace Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific de noms, est utilisée pour contrôler si l’espace SearchBar de noms a un arrière-plan. L’énumération UISearchBarStyle fournit trois valeurs possibles :

  • Default indique que le SearchBar style par défaut est défini. Il s’agit de la valeur par défaut de la SearchBar.SearchBarStyle propriété pouvant être liée.
  • Prominent indique que le SearchBar champ de recherche a un arrière-plan translucide et que le champ de recherche est opaque.
  • Minimal indique que le champ SearchBar de recherche n’a pas d’arrière-plan et que le champ de recherche est translucide.

En outre, la SearchBar.GetSearchBarStyle méthode peut être utilisée pour renvoyer le UISearchBarStyle fichier appliqué au SearchBar.

Le résultat est qu’un membre spécifié UISearchBarStyle est appliqué à un SearchBar, qui contrôle si l’arrière-plan est le SearchBar suivant :

Screenshot of SearchBar styles, on iOS.

La capture d’écran suivante montre les UISearchBarStyle membres appliqués aux SearchBar objets dont la BackgroundColor propriété est définie :

Screenshot of SearchBar styles with background color, on iOS.