Podniesienie uprawnień elementu VisualElement w systemie Android

Pobierz przykład Pobieranie przykładu

Ta platforma systemu Android służy do kontrolowania podniesienia uprawnień lub kolejności Z elementów wizualnych w aplikacjach przeznaczonych dla interfejsu API w wersji 21 lub nowszej. Podniesienie uprawnień elementu wizualizacji określa kolejność rysunku, a elementy wizualne z wyższymi wartościami Z okludniają elementy wizualne z niższymi wartościami Z. Jest on używany w języku XAML przez ustawienie dołączonej VisualElement.Elevationboolean właściwości na wartość:

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

Alternatywnie można go używać w języku C# przy użyciu płynnego interfejsu 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 }
                    }
                }
            }
        };
    }
}

Metoda Button.On<Android> określa, że ta platforma będzie działać tylko w systemie Android. Metoda VisualElement.SetElevation w Xamarin.Forms.PlatformConfiguration.AndroidSpecific przestrzeni nazw służy do ustawiania podniesienia uprawnień elementu wizualizacji na wartość null.float Ponadto VisualElement.GetElevation można użyć metody w celu pobrania wartości podniesienia uprawnień elementu wizualizacji.

W rezultacie podniesienie uprawnień elementów wizualnych można kontrolować tak, aby elementy wizualne z wyższymi wartościami Z occlude elementów wizualnych z niższymi wartościami Z. W związku z tym w tym przykładzie drugi Button jest renderowany powyżej BoxView elementu , ponieważ ma wyższą wartość podniesienia:

Zrzut ekranu podniesienia uprawnień elementu VisualElement