Version

ZOrderEffectStops Property

Returns a collection of ZOrderEffectStop objects that define the stops to be used when setting the ZOrder of items along the ItemPath.
Syntax
'Declaration
 
Public Property ZOrderEffectStops As ZOrderEffectStopCollection
public ZOrderEffectStopCollection ZOrderEffectStops {get; set;}
Remarks

Note: the UseZOrder property must be set to true for these ZOrderEffectStops to be applied.

The way in which the scaling effect stops are applied to each item is determined by the item's location in the display area of the XamCarouselPanel and the setting of the ZOrderEffectStopDirection property.

Example
In the following example, the ability to control the zorder of the items within the path has been used to ensure that the larger scaled items, which are in the middle of the path, are above those items on either side of it. This is done by setting the UseZOrder to true and providing ScalingEffectStop values such that the items half way along the path (those closest to the Offset of 0.5 since the ZOrderEffectStopDirection is set to UseItemPath) have the largest zorder values. In this example, this is necessary since a scaling effect was applied that caused items closest to the middle of the path to be scaled larger that the items on either side.
<igWindows:XamCarouselPanel>
    <igWindows:XamCarouselPanel.ViewSettings>
        <igWindows:CarouselViewSettings 
            UseScaling="True" 
            ScalingEffectStopDirection="UseItemPath" 
            UseZOrder="True" 
            ZOrderEffectStopDirection="UseItemPath" 
            AutoScaleItemContentsToFit="True" 
            ItemSize="300,300" 
            ItemPathRenderBrush="#77000000">
            
            <igWindows:CarouselViewSettings.ItemPath>
                <Path Data="M0,50 100,50" Width="100" Height="100" />
            </igWindows:CarouselViewSettings.ItemPath>

            <igWindows:CarouselViewSettings.ScalingEffectStops>
                <igWindows:ScalingEffectStop Offset="0.0" Value="0"/>
                <igWindows:ScalingEffectStop Offset="0.4" Value="0.4"/>
                <igWindows:ScalingEffectStop Offset="0.5" Value="0.8"/>
                <igWindows:ScalingEffectStop Offset="0.6" Value="0.4"/>
                <igWindows:ScalingEffectStop Offset="1.0" Value="0"/>
            </igWindows:CarouselViewSettings.ScalingEffectStops>
            
            <igWindows:CarouselViewSettings.ZOrderEffectStops>
                <igWindows:ZOrderEffectStop/>
                <igWindows:ZOrderEffectStop Offset="0.5" Value="1"/>
                <igWindows:ZOrderEffectStop Offset="1"/>
            </igWindows:CarouselViewSettings.ZOrderEffectStops>
            
        </igWindows:CarouselViewSettings>
    </igWindows:XamCarouselPanel.ViewSettings>

    <Ellipse Width="50" Height="50" Stroke="Black" Fill="Red" />
    <Ellipse Width="50" Height="50" Stroke="Black" Fill="Green" />
    <Ellipse Width="50" Height="50" Stroke="Black" Fill="Purple" />
    <Ellipse Width="50" Height="50" Stroke="Black" Fill="SlateGray" />
    <Ellipse Width="50" Height="50" Stroke="Black" Fill="Yellow" />
    <Ellipse Width="50" Height="50" Stroke="Black" Fill="Blue" />
    <Ellipse Width="50" Height="50" Stroke="Black" Fill="White" />
</igWindows:XamCarouselPanel>
Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, 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

See Also