CarouselPanel.AttractorPointIndex Property

Specifies the active element’s position within the Carousel.

Namespace: DevExpress.Xpf.Carousel

Assembly: DevExpress.Xpf.Carousel.v19.2.dll

Declaration

C#

public int AttractorPointIndex { get; set; }

VB.NET

Public Property AttractorPointIndex As Integer

Property Value

Type	Description
Int32	An integer value specifying the position for the selected item among other items.

Remarks

The CarouselPanel allows you to specify where to display the selected item. This means that every time you navigate to a particular element, it isn’t necessarily moved to the center position of the visible carousel path. Instead, it goes to the position specified by the AttractorPointIndex property, which sets the visible index.

If this property is set to 1, selecting an item will make it the first one visible in the navigation path. If three items are visible in a carousel, set this property to 2 to display the currently selected item in the middle.

If the value is out of bounds of visible item indexes (see CarouselPanel.VisibleItemCount), items may be out of the carousel’s visible range when selecting them. If a value is higher than the total number of items, the carousel can make several full turns when you make a selection.

Note

The current version of DXCarousel is designed to work with three or more items.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the AttractorPointIndex property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-handle-the-click-event-for-the-carousel-item-e1799/VB/WpfApplication27/Window1.xaml#L19

<ItemsPanelTemplate>
    <dxca:CarouselPanel ActivateItemOnClick="True" AttractorPointIndex="2" />
</ItemsPanelTemplate>

how-to-specify-a-distribution-function-for-positions-of-items-along-the-path-e1906/VB/WpfApplication10/Window1.xaml#L4

<!--region #1-->
<dxca:CarouselPanel AttractorPointIndex="6" VisibleItemCount="10" x:Name="myCarousel" PathPadding="10">
    <dxca:CarouselPanel.ItemMovingPath>