ItemPathRenderBrush Property

Returns/sets the System.Windows.Media.Brush used to fill a parent representation of the ItemPath behind the items being displayed. By default, no System.Windows.Media.Brush is set.

Syntax

Visual Basic

'Declaration
 
Public Property ItemPathRenderBrush As Brush

C#

public Brush ItemPathRenderBrush {get; set;}

Remarks

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

Note: You can also specify an ItemPathRenderPen to provide an outline for the filled 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