AbsoluteLayoutFlags AbsoluteLayoutFlags Enum

Definition

Flags used to modify how layout bounds are interpreted in an AbsoluteLayout.

This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.

[System.Flags]
public enum AbsoluteLayoutFlags
type AbsoluteLayoutFlags = 
Inheritance
AbsoluteLayoutFlagsAbsoluteLayoutFlags
Attributes

Fields

All All -1

Interpret all dimensions proportionally.

HeightProportional HeightProportional 8

Interpret height property as proportional to layout height.

None None 0

Disable all flags.

PositionProportional PositionProportional 3

Equivalent to both XProportional | YProportional.

SizeProportional SizeProportional 12

Equivalent to both WidthProportional | HeightProportional.

WidthProportional WidthProportional 4

Interpret width property as proportional to layout width.

XProportional XProportional 1

Interpret x property as proportional to the remaining space after width is accounted for.

YProportional YProportional 2

Interpret y property as proportional to the remaining space after height is accounted for.

Remarks

The AbsoluteLayout class can lay its child elements out in proportional units, device units, or a combination of both. Application developers should remember the following points when specifying a Rectangle structure that will define the layout bounds of a child element:

  • For elements whose height and width fit on the screen, proportional position dimensions in the range [0,1] represent elements that are completely on the screen, regardless of whether the height, width, or both are specified in device or proportional units.
  • The above point means that, to specify an element in the lower right hand corner of the screen and that is half as wide and half as all as the screen, with a Xamarin.Forms.LayoutFlags value of All, the application developer would specify "0.1, 0.1, 0.5, 0.5".
  • The app developer can inadvertently cause child elements for which one or both size dimensions were specified proportionally to be displayed partially off the screen, or hidden altogether, by specifying device-unit positions that do not leave enough room for the calculated size of the child.
  • Each part of the bounding Rectangle structure is interpreted according to the Xamarin.Forms.LayoutFlags value that controls it. A given rectangle might, for example, have an X-coordinate that is in device units, a Y-coordinate that is in proportional units, a height that is in proportional units, and a width that is in device units, or any other combination of device and proportional units.
  • Rectangles that, when interpreted by using the current Xamarin.Forms.LayoutFlags set on the child, represent bounding boxes that are partially or wholly off-screen—for example, by having a width that is larger than the screen width—may give unexpected results.

Applies to