Infragistics logo
메뉴
.NET and JavaScript UI Controls
Version

UseZOrder Property

Returns/sets whether ZOrderEffectStops should be honored and ZOrder effects applied to items in the Carousel. The default is False.
Syntax
'Declaration
 
Public Property UseZOrder As Boolean
public bool UseZOrder {get; set;}
Remarks

When this property is set to false, any ZOrderEffectStops that may be defined are ignored, and items will be ordered in the Z-space based on their position in the list (items with a lower list position will appear underneath and items with a higher list position with appear on top).

Note: The PathItemTransitionStyle property can be used to apply additional effects to items as they transition into and out of view through the prefix and suffix areas of the ItemPath.

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