Freigeben über


Suchleistenformat auf iOS

Diese plattformspezifische iOS-Steuerung steuert, ob ein SearchBar Hintergrund vorliegt. Sie wird in XAML verwendet, indem die bindbare SearchBar.SearchBarStyle-Eigenschaft auf einen Wert der UISearchBarStyle-Enumeration festgelegt wird:

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

Alternativ kann sie mit der Fluent-API von C# genutzt werden:

using Xamarin.Forms.PlatformConfiguration;
using Xamarin.Forms.PlatformConfiguration.iOSSpecific;
...

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

Die SearchBar.On<iOS>-Methode gibt an, dass diese plattformspezifische Anwendung nur auf iOS läuft. Die SearchBar.SetSearchBarStyle-Methode im Xamarin.Forms.PlatformConfiguration.iOSSpecific-Namespace wird verwendet, um zu steuern, ob die SearchBar einen Hintergrund hat. Die UISearchBarStyle-Enumeration stellt drei mögliche Werte bereit:

  • Default gibt an, dass die SearchBar die Standardformatvorlage aufweist. Dies ist der Standardwert der bindungsfähigen Eigenschaft SearchBar.SearchBarStyle.
  • Prominent gibt an, dass die SearchBar einen durchsichtigen Hintergrund hat und das Suchfeld undurchsichtig ist.
  • Minimal gibt an, dass die SearchBar keinen Hintergrund hat und das Suchfeld durchsichtig ist.

Darüber hinaus kann die SearchBar.GetSearchBarStyle-Methode verwendet werden, um den UISearchBarStyle zurückzugeben, der auf die SearchBar angewendet wird.

Das Ergebnis ist, dass ein bestimmtes UISearchBarStyle-Member auf eine SearchBar angewendet wird, die steuert, ob die SearchBar einen Hintergrund hat:

Screenshot der Suchleistenformatvorlagen unter iOS

Die folgenden Screenshots zeigen die Elemente, die UISearchBarStyle auf SearchBar Objekte angewendet werden, die ihren BackgroundColor Eigenschaftensatz aufweisen:

Screenshot der Suchleistenformatvorlagen mit Hintergrundfarbe unter iOS