Version

ItemsPerPage Property

Determines the maximum number of items that should be displayed in the XamCarouselPanel at one time. The default is 5.
Syntax
'Declaration
 
Public Property ItemsPerPage As Integer
public int ItemsPerPage {get; set;}
Remarks

If the total number of items in the list is less than ItemsPerPage, the XamCarouselPanel will spread out those items evenly along the ItemPath so they take up all the space between the prefix and suffix areas.

For example, if the number of items per page is set to 10 and the total number of items in the list is 20, then the 10 displayed items will be arranged along the ItemPath between the prefix and suffix areas using even spacing. If the number of items in the list is less than ItemsPerPage, say 5, then those 5 items will still be evenly arranged along the ItemPath between the prefix and suffix areas, but with increased spacing so the entire area is used. This prevents items from being 'bunched up' at the beginning of the path.

Note: up to 2x ItemsPerPage items will be displayed at any given time while the XamCarouselPanel is in the process of scrolling.

Example
In this example, the ItemsPerPage is set to control the maximum number of items that should displayed at a time. The CarouselPanelNavigator can then be used to scroll the items.
<igWindows:XamCarouselPanel>
    
<igWindows:XamCarouselPanel.ViewSettings>

        
<igWindows:CarouselViewSettings 
                
ItemsPerPage="3" />

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

See Also