Partager via


Canvas.Top

Microsoft Silverlight will reach end of support after October 2021. Learn more.

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

<object Canvas.Top="Double"  .../>
value = object["Canvas.Top"]
object["Canvas.Top"] = value

Property Value

Type: Double

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

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

Managed Equivalent

Canvas.Top

Remarks

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

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

Note 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.Top in script.

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

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

Applies To

Border (Silverlight 2)

Canvas

Ellipse

Glyphs

Image

InkPresenter

Line

MediaElement

PasswordBox (Silverlight 2)

Path

Polygon

Polyline

Rectangle

StackPanel (Silverlight 2)

TextBlock

TextBox (Silverlight 2)

See Also

Reference