Canvas.ZIndex Attached Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets the Z-order of an element when that element is presented in its parent Canvas layout container.
see GetZIndex, and SetZIndex
see GetZIndex, and SetZIndex
see GetZIndex, and SetZIndex
Remarks
Canvas.ZIndex
declares the draw order for the child elements of a Canvas. This matters when there is overlap between any of the bounds of the child elements. A higher z-order value will draw on top of a lower z-order value. If no value is set, the default is -1. If there is a draw order issue where elements share one or more pixels of layout space in a Canvas
and the z-index values are the same, then the last element declared in XAML (or the highest index element in the Children
collection if using code) is the element that draws on top.
You typically use values 0 and greater but negative values are permitted. A negative value, such as -99, places the object even farther from the foreground than any default value. The maximum allowed value is 1,000,000 (one million).
A value is interpreted by the most immediate parent Canvas
element from where the value is set. The value is used to explicitly define the draw order in cases where child elements overlap.
- Type: Int32
- Identifier field: ZIndexProperty
- Accessor methods: GetZIndex, SetZIndex