Share via

Xamarin Community Toolkit SafeAreaEffect

  • Artikel

Der SafeAreaEffect ist ein Effekt, der jedem Element über eine angefügte Eigenschaft hinzugefügt werden kann, um anzugeben, ob dieses Element aktuelle sichere Bereiche berücksichtigen soll oder nicht. Dies ist ein Bereich des Bildschirms, der für alle Geräte, die iOS 11 und höher verwenden, sicher ist. Insbesondere hilft es, sicherzustellen, dass Inhalte nicht durch abgerundete Geräteecken, die Home-Anzeige oder das Sensorgehäuse eines iPhone X beschnitten werden. Der Effekt zielt nur auf iOS ab, was bedeutet, dass er auf anderen Plattformen nichts bewirkt.

Syntax

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

Eigenschaften

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

Angeben einer SafeArea-Datei

Die SafeArea-Eigenschaft ist vom Typ SafeArea. Diese Struktur nimmt bis zu 4 boolean Typwerte auf, die angeben, welche sicheren Bereiche für das Element berücksichtigt werden sollen, auf das dieser Effekt angewendet wird. Beim Erstellen einer SafeArea Struktur gibt es drei Möglichkeiten:

  • Create eine SafeArea Struktur, die durch einen einzigen einheitlichen Wert definiert wird. Der einzelne Wert wird auf die linke, obere, rechte und untere Seite des Elements angewendet.
  • Create eine SafeArea Struktur, die durch horizontale und vertikale Werte definiert ist. Der horizontale Wert wird symmetrisch auf die linke und rechte Seite des Elements angewendet, wobei der vertikale Wert symmetrisch auf die obere und untere Seite des Elements angewendet wird.
  • Create eine SafeArea Struktur, die durch vier unterschiedliche Werte definiert wird, die auf die linke, obere, rechte und untere Seite des Elements angewendet werden.

CodeBehind-Unterstützung

Dieser Effekt kann auch über Codebehind verwendet werden:

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

Beispiel

SafeAreaEffect-Beispielseite Quelle

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

API