Xamarin.Forms AbsoluteLayout

Download Sample 下載範例

Xamarin.Forms AbsoluteLayout

AbsoluteLayout用來使用明確值來定位和調整子系的大小。 相對於 裝置獨立單位的左上角 AbsoluteLayout,子系的左上角會指定位置。 AbsoluteLayout 也會實作比例定位和重設大小功能。 此外,與其他版面配置類別不同的是, AbsoluteLayout 能夠放置子系,使其重疊。

AbsoluteLayout應該將 視為特殊用途的版面配置,只有在您可以對子系施加大小時,或當元素的大小不會影響其他子系的位置時使用。

類別 AbsoluteLayout 會定義下列屬性:

  • LayoutBoundsRectangle別為 的 ,這是表示子系位置與大小的附加屬性。 此屬性的預設值為 (0,0,AutoSize,AutoSize)。
  • LayoutFlagsAbsoluteLayoutFlags別為 的 ,這是附加屬性,指出用來定位和調整子系大小之版面配置界限的屬性是否按比例解譯。 此屬性的預設值為 AbsoluteLayoutFlags.None

這些屬性是由 BindableProperty 物件所支援,這表示屬性可以是數據系結和樣式的目標。 如需附加屬性的詳細資訊,請參閱 Xamarin.Forms 附加屬性

類別 AbsoluteLayout 衍生自 Layout<T> 類別,該類別會 Children 定義 型 IList<T>別 的屬性。 屬性 ChildrenContentProperty 類別的 Layout<T> ,因此不需要從 XAML 明確設定。

提示

若要取得最佳的版面配置效能,請遵循優化版面配置效能指導方針。

位置和大小子系

AbsoluteLayout 子系的位置和大小是藉由使用絕對值或比例值來設定 AbsoluteLayout.LayoutBounds 每個子系的附加屬性來定義。 當位置應該調整時,子系的絕對值和比例值可能會混合,但大小應維持固定,反之亦然。 如需絕對值的相關信息,請參閱 絕對定位和重設大小。 如需比例值的相關信息,請參閱 比例定位和重設大小

AbsoluteLayout.LayoutBounds不論是否使用絕對值或比例值,都可以使用兩種格式來設定附加屬性:

  • x, y. 使用這個格式時 x ,和 y 值會指出子系與其父系相對的左上角位置。 子系不受限制且本身會調整大小。
  • x, y, width, height. 使用這個格式時, xy 值會指出子系相對於其父系的左上角位置,而 widthheight 值則表示子系的大小。

若要指定子系以水準或垂直方式調整其大小,或同時將 和/或 height 值設定widthAbsoluteLayout.AutoSize 屬性。 不過,過度使用這個屬性可能會損害應用程式效能,因為它會導致配置引擎執行額外的版面配置計算。

重要

HorizontalOptionsVerticalOptions 屬性對的AbsoluteLayout子系沒有任何影響。

絕對定位和重設大小

根據預設, AbsoluteLayout 使用裝置獨立單位所指定的位置和大小子系,明確定義子系應該放在版面配置中的位置。 這可藉由將子系新增至 Children 集合, AbsoluteLayout 並將每個子系上的附加屬性設定 AbsoluteLayout.LayoutBounds 為絕對位置和/或大小值來達成。

警告

使用絕對值來定位和重設大小子系可能會有問題,因為不同的裝置有不同的螢幕大小和解析度。 因此,某個裝置上螢幕中心座標可能會在其他裝置上位移。

下列 XAML 顯示 AbsoluteLayout 其子系使用絕對值定位的 :

<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="AbsoluteLayoutDemos.Views.StylishHeaderDemoPage"
             Title="Stylish header demo">
    <AbsoluteLayout Margin="20">
        <BoxView Color="Silver"
                 AbsoluteLayout.LayoutBounds="0, 10, 200, 5" />
        <BoxView Color="Silver"
                 AbsoluteLayout.LayoutBounds="0, 20, 200, 5" />
        <BoxView Color="Silver"
                 AbsoluteLayout.LayoutBounds="10, 0, 5, 65" />
        <BoxView Color="Silver"
                 AbsoluteLayout.LayoutBounds="20, 0, 5, 65" />
        <Label Text="Stylish Header"
               FontSize="24"
               AbsoluteLayout.LayoutBounds="30, 25" />
    </AbsoluteLayout>
</ContentPage>

在此範例中,會使用附加屬性中指定的AbsoluteLayout.LayoutBounds前兩個絕對值來定義每個BoxView物件的位置。 每個 BoxView 的大小是使用第三個和四個值來定義。 物件的位置 Label 是使用附加屬性中指定的 AbsoluteLayout.LayoutBounds 兩個絕對值來定義。 不會為 Label指定大小值,因此它不受限制,而且會自行調整大小。 在所有情況下,絕對值都代表裝置無關的單位。

下列螢幕擷取畫面顯示產生的版面配置:

Children placed in an AbsoluteLayout using absolute values

對等的 C# 程式代碼如下所示:

public class StylishHeaderDemoPageCS : ContentPage
{
    public StylishHeaderDemoPageCS()
    {
        AbsoluteLayout absoluteLayout = new AbsoluteLayout
        {
            Margin = new Thickness(20)
        };

        absoluteLayout.Children.Add(new BoxView
        {
            Color = Color.Silver,
        }, new Rectangle(0, 10, 200, 5));
        absoluteLayout.Children.Add(new BoxView
        {
            Color = Color.Silver
        }, new Rectangle(0, 20, 200, 5));
        absoluteLayout.Children.Add(new BoxView
        {
            Color = Color.Silver
        }, new Rectangle(10, 0, 5, 65));
        absoluteLayout.Children.Add(new BoxView
        {
            Color = Color.Silver
        }, new Rectangle(20, 0, 5, 65));

        absoluteLayout.Children.Add(new Label
        {
            Text = "Stylish Header",
            FontSize = 24
        }, new Point(30,25));                    

        Title = "Stylish header demo";
        Content = absoluteLayout;
    }
}

在此範例中,會使用 Rectangle 物件定義每個BoxView的位置和大小。 的位置 Label 是使用 Point 對象來定義。

在 C# 中,您也可以使用 AbsoluteLayout.SetLayoutBounds 方法,將 子系AbsoluteLayout的位置和大小設定至Children集合。 這個方法的第一個自變數是子系,第二個 Rectangle 自變數是物件。

注意

AbsoluteLayout使用絕對值的 可以放置和調整子系的大小,使其不符合版面配置界限。

比例定位和重設大小

AbsoluteLayout可以使用比例值來定位和調整子系的大小。 這可藉由將子系新增至 ChildrenAbsoluteLayout集合,並將每個子系上的附加屬性設定 AbsoluteLayout.LayoutBounds 為0-1範圍中的比例位置和/或大小值來達成。 位置和大小值是按 AbsoluteLayout.LayoutFlags 比例設定每個子系的附加屬性。

AbsoluteLayout.LayoutFlags類型的AbsoluteLayoutFlags附加屬性可讓您設定旗標,指出子系的配置界限位置和大小值與 的大小AbsoluteLayout成正比。 配置子系時, AbsoluteLayout 適當地將位置和大小值調整為任何裝置大小。

AbsoluteLayoutFlags 列舉會定義下列成員:

  • None,表示值會解譯為絕對值。 這是 AbsoluteLayout.LayoutFlags 附加屬性的預設值。
  • XProportional,表示 x 值會解譯為成正比,同時將所有其他值視為絕對值。
  • YProportional,表示 y 值會解譯為成正比,同時將所有其他值視為絕對值。
  • WidthProportional,表示 width 值會解譯為成正比,同時將所有其他值視為絕對值。
  • HeightProportional,表示 height 值會解譯為成正比,同時將所有其他值視為絕對值。
  • PositionProportional表示 xy 值會解譯成正比,而大小值則會解譯為絕對值。
  • SizeProportional,表示 widthheight 值會解譯成正比,而位置值則會解譯為絕對值。
  • All,表示所有值都會解譯為成正比。

提示

AbsoluteLayoutFlags列舉是Flags列舉,這表示可以合並列舉成員。 這會在 XAML 中使用逗號分隔清單,並在 C# 中使用位 OR 運算符來完成。

例如,如果您使用 SizeProportional 旗標並將子系的寬度設定為0.25,並將高度設定為0.1,則子系的寬度 AbsoluteLayout 會是的四分之一,而高度為十分之一。 旗 PositionProportional 標很類似。 (0,0) 的位置會將子系置於左上角,而 (1,1) 的位置會將子系放在右下角,而位置為 (0.5,0.5) 會將子系置中。AbsoluteLayout

下列 XAML 顯示 AbsoluteLayout 其子系使用比例值定位的 :

<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="AbsoluteLayoutDemos.Views.ProportionalDemoPage"
             Title="Proportional demo">
    <AbsoluteLayout>
        <BoxView Color="Blue"
                 AbsoluteLayout.LayoutBounds="0.5,0,100,25"
                 AbsoluteLayout.LayoutFlags="PositionProportional" />
        <BoxView Color="Green"
                 AbsoluteLayout.LayoutBounds="0,0.5,25,100"
                 AbsoluteLayout.LayoutFlags="PositionProportional" />
        <BoxView Color="Red"
                 AbsoluteLayout.LayoutBounds="1,0.5,25,100"
                 AbsoluteLayout.LayoutFlags="PositionProportional" />
        <BoxView Color="Black"
                 AbsoluteLayout.LayoutBounds="0.5,1,100,25"
                 AbsoluteLayout.LayoutFlags="PositionProportional" />
        <Label Text="Centered text"
               AbsoluteLayout.LayoutBounds="0.5,0.5,110,25"
               AbsoluteLayout.LayoutFlags="PositionProportional" />
    </AbsoluteLayout>
</ContentPage>

在此範例中,每個子系會使用比例值來定位,但使用絕對值來調整大小。 這可藉由將每個子系的附加屬性設定 AbsoluteLayout.LayoutFlagsPositionProportional來完成。 每個子系的附加屬性中指定的 AbsoluteLayout.LayoutBounds 前兩個值會使用比例值來定義位置。 每個子系的大小會使用裝置獨立單位,使用第三個和四個絕對值來定義。

下列螢幕擷取畫面顯示產生的版面配置:

Children placed in an AbsoluteLayout using proportional position values

對等的 C# 程式代碼如下所示:

public class ProportionalDemoPageCS : ContentPage
{
    public ProportionalDemoPageCS()
    {
        BoxView blue = new BoxView { Color = Color.Blue };
        AbsoluteLayout.SetLayoutBounds(blue, new Rectangle(0.5, 0, 100, 25));
        AbsoluteLayout.SetLayoutFlags(blue, AbsoluteLayoutFlags.PositionProportional);

        BoxView green = new BoxView { Color = Color.Green };
        AbsoluteLayout.SetLayoutBounds(green, new Rectangle(0, 0.5, 25, 100));
        AbsoluteLayout.SetLayoutFlags(green, AbsoluteLayoutFlags.PositionProportional);

        BoxView red = new BoxView { Color = Color.Red };
        AbsoluteLayout.SetLayoutBounds(red, new Rectangle(1, 0.5, 25, 100));
        AbsoluteLayout.SetLayoutFlags(red, AbsoluteLayoutFlags.PositionProportional);

        BoxView black = new BoxView { Color = Color.Black };
        AbsoluteLayout.SetLayoutBounds(black, new Rectangle(0.5, 1, 100, 25));
        AbsoluteLayout.SetLayoutFlags(black, AbsoluteLayoutFlags.PositionProportional);

        Label label = new Label { Text = "Centered text" };
        AbsoluteLayout.SetLayoutBounds(label, new Rectangle(0.5, 0.5, 110, 25));
        AbsoluteLayout.SetLayoutFlags(label, AbsoluteLayoutFlags.PositionProportional);

        Title = "Proportional demo";
        Content = new AbsoluteLayout
        {
            Children = { blue, green, red, black, label }
        };
    }
}

在此範例中,會使用 AbsoluteLayout.SetLayoutBounds 方法設定每個子系的位置和大小。 方法的第一個自變數是子系,第二個 Rectangle 自變數是物件。 每個子系的位置會設定成正比值,而每個子系的大小會使用與裝置無關的單位,以絕對值來設定。

注意

AbsoluteLayout,使用比例值可以定位和調整子系的大小,讓它們無法符合版面配置的範圍,方法是使用0-1範圍以外的值。