ItemPathRenderPen Property

Returns/sets the System.Windows.Media.Pen used to draw the outline of the ItemPath behind the items being displayed. By default, no System.Windows.Media.Pen is set.

Syntax

Visual Basic

'Declaration
 
Public Property ItemPathRenderPen As Pen

C#

public Pen ItemPathRenderPen {get; set;}

Remarks

For most path geometries, specifiying an ItemPathRenderPen results in a compelling highlighting of the path area. However, using an ItemPathRenderPen with some geometries may produce unexpected parent results. This is a function of how the WPF framework outlines geometries.

Note: You can also specify an ItemPathRenderBrush to provide a fill for the path area.

Example

In the following example, the ItemPathRenderBrush and ItemPathRenderPen are used to identify where the path that the items will be arranged along has been positioned.

XAML

<igWindows:XamCarouselPanel>
    <igWindows:XamCarouselPanel.ViewSettings>
        <igWindows:CarouselViewSettings>
            
            <igWindows:CarouselViewSettings.ItemPathRenderBrush>
                <LinearGradientBrush EndPoint="1,0.5" StartPoint="0,0.5">
                    <GradientStop Color="#FFC1A6A6" Offset="0"/>
                    <GradientStop Color="#FFAD3131" Offset="0.683"/>
                </LinearGradientBrush>
            </igWindows:CarouselViewSettings.ItemPathRenderBrush>

            <igWindows:CarouselViewSettings.ItemPathRenderPen>
                <Pen Brush="Black" DashStyle="{x:Static DashStyles.DashDot}" Thickness="1" />
            </igWindows:CarouselViewSettings.ItemPathRenderPen>

            <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