ItemPath Property

Returns/sets the System.Windows.Shapes.Shape derived element (i.e., System.Windows.Shapes.Path, System.Windows.Shapes.Ellipse, System.Windows.Shapes.Line, System.Windows.Shapes.Polygon, System.Windows.Shapes.Polyline, System.Windows.Shapes.Rectangle) which defines the System.Windows.Media.Geometry used to arrange items in the XamCarouselPanel. The default is null. When this property is set to null, an elliptical path is provided by default.

Syntax

Visual Basic

'Declaration
 
Public Property ItemPath As Shape

C#

public Shape ItemPath {get; set;}

Remarks

Note: The System.Windows.Media.Geometry defined by the System.Windows.Shapes.Shape derived element will be scaled to fit within the XamCarouselPanel taking into account the settings of the ItemPathStretch, ItemPathAutoPad, ItemPathHorizontalAlignment and ItemPathVerticalAlignment properties. These properties let you precisely determine how the path is aligned and scaled within the XamCarouselPanel.

A convenient way to create a path to assign to this property is to use Microsoft Expression Blend. Blend provides a great designtime experience for creating and manipulating the geometry of System.Windows.Shapes.Shape derived elements.

Example

In the following example. the ItemPath property is set to a custom Path to alter the path along which the items will be positioned. The ItemPathRenderBrush has been set to a semi-transparent color to allow the path to be visible in the sample.

XAML

<igWindows:XamCarouselPanel>
    <igWindows:XamCarouselPanel.ViewSettings>

        <igWindows:CarouselViewSettings 
            ItemPathRenderBrush="#77000000">

            <igWindows:CarouselViewSettings.ItemPath>
                <Path Data="M400,0 C900,600 -300,600 200,0" />
            </igWindows:CarouselViewSettings.ItemPath>

        </igWindows:CarouselViewSettings>

    </igWindows:XamCarouselPanel.ViewSettings>

    <Ellipse Width="50" Height="50" Stroke="Black" Fill="Red" />
    <Ellipse Width="100" Height="50" Stroke="Black" Fill="Green" />
    <Polygon Points="0, 25, 25, 0, 75, 0, 100, 25, 75, 50, 25, 50" Stroke="Black" Fill="Yellow" />
    <Rectangle Width="100" Height="50" Stroke="Black" Fill="Purple" />
    <Polyline Points="0, 25, 25, 0, 50, 25, 25, 50, 0, 25" Stroke="SlateGray" StrokeThickness="2" Fill="Blue"/>
    <Path Stroke="Black" Fill="Gray" Data="M 10,10 C 10,100 100,-100 100,10" />
</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