Version

ZOrderEffectStopDirection Property

Returns/sets the direction used to evaluate ZOrderEffectStops. The default is EffectStopDirection.UseItemPath.
Syntax
'Declaration
 
Public Property ZOrderEffectStopDirection As EffectStopDirection
public EffectStopDirection ZOrderEffectStopDirection {get; set;}
Remarks

The direction can be set to evaluate the effect stops based on an item's position along the ItemPath or based on the item's vertical or horizontal position within the XamCarouselPanel.

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