Xamarin Community Toolkit SafeAreaEffect

  • Artikel

Dies SafeAreaEffect ist ein Effekt, der jedem Element durch eine angefügte Eigenschaft hinzugefügt werden kann, um anzugeben, ob dieses Element aktuelle sichere Bereiche berücksichtigen sollte. Dies ist ein Bereich des Bildschirms, der für alle Geräte sicher ist, die iOS 11 und höher verwenden. Insbesondere wird es hilfreich sein, sicherzustellen, dass Inhalte nicht durch abgerundete Geräteecke, die Startanzeige oder das Sensorgehäuse auf einem iPhone X abgeschnitten werden. Der Effekt zielt nur auf iOS ab, was bedeutet, dass es auf anderen Plattformen nichts tut.

Syntax

<StackLayout VerticalAlignment="Center" SafeAreaEffect.SafeArea="true" HorizontalAlignment="Center" Width="400" Height="400">
  ...
</StackLayout>

Eigenschaften

Eigenschaft type BESCHREIBUNG
SafeArea SafeArea Gibt an, welche sicheren Bereiche für dieses Element berücksichtigt werden sollen.

Angeben eines SafeArea

Die SafeArea-Eigenschaft ist vom Typ SafeArea. Diese Struktur enthält bis zu 4 boolean Typwerte, auf die angegeben werden soll, welche sicheren Bereiche für das Element berücksichtigt werden sollten, auf das dieser Effekt angewendet wird. Es gibt drei Möglichkeiten beim Erstellen einer SafeArea Struktur:

  • Erstellen Sie eine Struktur, die durch einen SafeArea einzigen einheitlichen Wert definiert ist. Der einzelne Wert wird auf die linken, oberen, rechten und unteren Seiten des Elements angewendet.
  • Erstellen Sie eine SafeArea Struktur, die durch horizontale und vertikale Werte definiert ist. Der horizontale Wert wird symmetrisch auf die linken und rechten Seiten des Elements angewendet, wobei der vertikale Wert symmetrisch auf die oberen und unteren Seiten des Elements angewendet wird.
  • Erstellen Sie eine SafeArea Struktur, die von vier unterschiedlichen Werten definiert wird, die auf die linken, oberen, rechten und unteren Seiten des Elements angewendet werden.

Codebehind-Support

Dieser Effekt kann auch von Codebehind verwendet werden:

public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
        SafeAreaEffect.SetSafeArea(stackLayout, new SafeArea(true));
    }
}

Beispiel

SafeAreaEffect-Beispielseite Source

Sie können dies in Aktion in der Xamarin Community Toolkit-Beispiel-App sehen.

API