UIElement::Arrange Method

Positions child objects and determines a size for a UIElement. Parent objects that implement custom layout for their child elements should call this method from their layout override implementations to form a recursive layout update.

Namespace:  System.Windows
Assembly:  System.Windows (in System.Windows.dll)

No code example is currently available or this language may not be supported.

Parameters

finalRect
Type: System.Windows::Rect
The final size that the parent computes for the child in layout, provided as a Rect value.

ExceptionCondition
InvalidOperationException

finalRect contained a Double::NaN or infinite value. See Remarks.

There is no reason to call Measure or Arrange outside of the context of overriding methods that perform custom layout actions. Silverlight layout works autonomously, based on detecting changes to the object tree and layout-relevant properties at run time. For more information, see Silverlight Layout System.

The finalRect you pass to Measure cannot have a Double::NaN value for any Rect value. Also, finalRect cannot have any infinite values for any Rect value.

Typically, calls to Arrange will incorporate a finalRect that uses the height and width values from DesiredSize for each element . Exceptions to this typical behavior might be necessary if an element holds a DesiredSize that the layout parent cannot accommodate, or if the sum total of all child element DesiredSize values cannot be accommodated or arranged. In such cases the child element content might be clipped, resized, or placed in a scroll region, which all depends on the specific functionality that is enabled in the layout parent container.

The following example shows how you would use Arrange within an ArrangeOverride implementation.

No code example is currently available or this language may not be supported.

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Community Additions

ADD
Show: