Zvýšení oprávnění VisualElement na Androidu
Tato specifická platforma pro Android se používá k řízení zvýšení oprávnění, nebo pořadí vykreslování vizuálních prvků v aplikacích, které cílí na rozhraní API 21 nebo vyšší. Zvýšení oprávnění vizuálního prvku určuje jeho pořadí vykreslování s použitím vizuálních prvků s vyššími hodnotami Z occluding vizuálních prvků s nižšími hodnotami Z. Je spotřebované v jazyce XAML nastavením VisualElement.Elevation připojené vlastnosti na boolean hodnotu:
<ContentPage ...
xmlns:android="clr-namespace:Xamarin.Forms.PlatformConfiguration.AndroidSpecific;assembly=Xamarin.Forms.Core"
Title="Elevation">
<StackLayout>
<Grid>
<Button Text="Button Beneath BoxView" />
<BoxView Color="Red" Opacity="0.2" HeightRequest="50" />
</Grid>
<Grid Margin="0,20,0,0">
<Button Text="Button Above BoxView - Click Me" android:VisualElement.Elevation="10"/>
<BoxView Color="Red" Opacity="0.2" HeightRequest="50" />
</Grid>
</StackLayout>
</ContentPage>
Alternativně se dá využít z C# pomocí rozhraní Fluent API:
using Xamarin.Forms.PlatformConfiguration;
using Xamarin.Forms.PlatformConfiguration.AndroidSpecific;
...
public class AndroidElevationPageCS : ContentPage
{
public AndroidElevationPageCS()
{
...
var aboveButton = new Button { Text = "Button Above BoxView - Click Me" };
aboveButton.On<Android>().SetElevation(10);
Content = new StackLayout
{
Children =
{
new Grid
{
Children =
{
new Button { Text = "Button Beneath BoxView" },
new BoxView { Color = Color.Red, Opacity = 0.2, HeightRequest = 50 }
}
},
new Grid
{
Margin = new Thickness(0,20,0,0),
Children =
{
aboveButton,
new BoxView { Color = Color.Red, Opacity = 0.2, HeightRequest = 50 }
}
}
}
};
}
}
Button.On<Android>Metoda určuje, že tato specifická platforma bude spuštěna pouze v Androidu. VisualElement.SetElevationMetoda v Xamarin.Forms.PlatformConfiguration.AndroidSpecific oboru názvů slouží k nastavení zvýšení oprávnění vizuálního prvku na hodnotu null float . Kromě toho VisualElement.GetElevation lze metodu použít k načtení hodnoty zvýšení oprávnění vizuálního prvku.
Výsledkem je, že zvýšení oprávnění vizuálních prvků lze ovládat tak, aby vizuální prvky s vyššími hodnotami Z occlude vizuální prvky s nižšími hodnotami Z. Proto v tomto příkladu Button je druhá hodnota vykreslena nad rámec, BoxView protože má vyšší hodnotu zvýšení úrovně oprávnění:

Stažení ukázky