Canvas.Left Property

Gets or sets a value that represents the distance between the left side of an element and the left side of its parent Canvas.

XAML
<object Canvas.Left="Double" .../>
Scripting
value = object["Canvas.Left"]
object["Canvas.Left"] = value

Property Value

Double

A value that represents the offset position from the left side of a parent Canvas.

This property is read/write. The default value is 0.

Remarks

Negative values are permitted. A negative value will place the origin of the element where Canvas.Left is applied offscreen to the left side of the content area.

This property is an example of an attached property, whereby non-Canvas objects can set this property that can then be read and interpreted by a parent Canvas .

Notice particularly the script syntax, which resembles an indexer or array syntax. The ["ownerType.propertyName"] form (with no dot separating this property form and the target object for getting or setting) is necessary to get or set an attached property such as Canvas.Left in script.

The value is interpreted by any immediate parent Canvas. If there are nested canvas elements, values for Canvas.Left that do not come from immediate child elements are ignored. A Canvas can itself have a Canvas.Left value, but the value does not apply on itself, rather it is interpreted by any parent Canvas, as in the nested scenario mentioned.

Canvas.Left or Canvas.Top values on the root canvas are ignored and are not used for positioning by the Silverlight plug-in's content area.

For more details on object positioning and how Canvas.Left participates, see Object Layout in Silverlight.

Applies To

Canvas, Ellipse, Glyphs, Image, InkPresenter, Line, MediaElement, Path, Polygon, Polyline, Rectangle, TextBlock

See Also

Object Layout in Silverlight
Silverlight Transforms Overview
Canvas.Top
Canvas.ZIndex