UserLayerIndex Property (UltraChart)

Identifies Layers by ID string, and arranges them in Z-Order.

Syntax

Visual Basic

'Declaration
 
Public Property UserLayerIndex As String()

C#

public string[] UserLayerIndex {get; set;}

Remarks

This property manages an array of strings where each string uniquely identifies a layer (these string identifies should correspond to the Infragistics.UltraChart.Core.Layers.ILayer.LayerID property of Infragistics.UltraChart.Core.Layers.ILayerILayer). During the processing of layers, the Infragistics.UltraChart.Core.Layers.ILayer.FillSceneGraph is called on each layer in the order it's Layer ID appears in the UserLayerIndex. Layers listed towards the end of this string array are therefore rendered last, and effectively appear in the foreground.

Example

Visual Basic

' add the Layer to the Chart Layer Hashtable
UltraChart1.Layer.Add("My Layer", New MyLayer)
' update the UserLayerIndex with the new Layer ID
UltraChart1.UserLayerIndex = New String() {"Default", "My Layer"}
' it is important to invoke InvalidateLayers so that the chart will redraw all layers
UltraChart1.InvalidateLayers()

C#

// add the Layer to the Chart Layer Hashtable
UltraChart1.Layer.Add("My Layer", New MyLayer)
// update the UserLayerIndex with the new Layer ID
UltraChart1.UserLayerIndex = New String() {"Default", "My Layer"}
// it is important to invoke InvalidateLayers so that the chart will redraw all layers
UltraChart1.InvalidateLayers()

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2