Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.
This topic has not yet been rated - Rate this topic

UIElement.OnChildDesiredSizeChanged Method

Supports layout behavior when a child element is resized.

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

protected virtual void OnChildDesiredSizeChanged (
	UIElement child
)
protected void OnChildDesiredSizeChanged (
	UIElement child
)
protected function OnChildDesiredSizeChanged (
	child : UIElement
)
You cannot use methods in XAML.

Parameters

child

The child element that is being resized.

This method is typically not called by your application code. It is exposed so that derived element classes can make further checks on their own possibly invalid layout state. Classes could also attempt optimizations to minimize the processing time for a layout pass based on size changes to child elements. An example derived element class that implements OnChildDesiredSizeChanged is the Grid control.

Notes to Inheritors: The OnChildDesiredSizeChanged method has the default implementation of calling InvalidateMeasure on itself. A typical implementation would be: do whatever optimization your own element supports, and then typically call base OnChildDesiredSizeChanged from at least one of the code branches (the one that indicated "dirty" state per your own measure caching logic). This method is only called in the layout processing if it was the child itself that originated the size changes. Otherwise, if the parent element initiates the Measure pass, according to the layout system rules, the parent is recalculating layout already. The layout system processes layout in the order of child-to-parent, so no return to parent element sizing from the child element layout calls is necessary.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2014 Microsoft. All rights reserved.