ScalingEffectStops Property

Returns a collection of ScalingEffectStop objects that define the stops to be used when scaling items along the ItemPath to simulate perspective.

Syntax

Visual Basic

'Declaration
 
Public Property ScalingEffectStops As ScalingEffectStopCollection

C#

public ScalingEffectStopCollection ScalingEffectStops {get; set;}

Remarks

Note: the UseScaling property must be set to true for these ScalingEffectStops 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 ScalingEffectStopDirection property.

For example, if you are using a circular path and you want to give the user the sense that the items at the top of the circle are further away, set the this property to EffectStopDirection.Vertical and add ScalingEffectStops that range from a value of .6 at an Offset of zero to a value of 1 at an Offset of 1. This will make the items 'in the distance' appear a bit smaller. To further enhance the perspective effect you can also do a similar thing with OpacityEffectStops - make items in the foreground (i.e., bottom of the circle) opaque and items in the back (i.e., top of the circle) a bit transparent.

Example

In the following example, the UseScaling property has been set to true so that the ScalingEffectStops provided will be used when arranging the panel items. Since the ScalingEffectStopDirection is set to UseItemPath, the offsets specified in the ScalingEffectStop instances will be based on their position along the path with items about 80% along the path being scaled largest and items at each end of that percent having a decreasingly smaller scale.

XAML

<igWindows:XamCarouselPanel>
    <igWindows:XamCarouselPanel.ViewSettings>
        <igWindows:CarouselViewSettings 
            UseScaling="True" 
            ScalingEffectStopDirection="UseItemPath" 
            ItemPathRenderBrush="#77000000">
            
            <igWindows:CarouselViewSettings.ItemPath>
                <Path Data="M-96.905841,269.54353 C-96.905841,269.54353 -28.403209,328.24638 85.941049,349.95603 188.78648,369.4825 914.01753,418.65525 960.78345,385.1648" />
            </igWindows:CarouselViewSettings.ItemPath>

            <igWindows:CarouselViewSettings.ScalingEffectStops>
                <igWindows:ScalingEffectStopCollection>
                    <igWindows:ScalingEffectStop Value="0.1"/>
                    <igWindows:ScalingEffectStop Offset="0.2" Value="0.2"/>
                    <igWindows:ScalingEffectStop Offset="0.4" Value="0.4"/>
                    <igWindows:ScalingEffectStop Offset="0.7" Value="0.8"/>
                    <igWindows:ScalingEffectStop Offset="0.8" Value="2.0"/>
                    <igWindows:ScalingEffectStop Offset="1" Value="1"/>
                </igWindows:ScalingEffectStopCollection>
            </igWindows:CarouselViewSettings.ScalingEffectStops>

        </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