CarouselView 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
一个视图，该视图显示可滚动的项集合，其中每个项在滚动后“对齐”到位。
public ref class CarouselView : Microsoft::Maui::Controls::ItemsViewpublic class CarouselView : Microsoft.Maui.Controls.ItemsViewtype CarouselView = class
inherit ItemsViewPublic Class CarouselView
Inherits ItemsView- 继承
- 继承
注解
CarouselView 可用于显示项目的水平或垂直轮播，用户可以在其中轻扫项目，并且每个项目都贴靠在视图中。 与不同的 CollectionView是， CarouselView 强制实施单项对齐点，并提供其他功能，如循环和位置跟踪。
构造函数
| 名称 | 说明 |
|---|---|
| CarouselView() |
初始化 CarouselView 类的新实例。 |
字段
| 名称 | 说明 |
|---|---|
| CurrentItemChangedCommandParameterProperty | |
| CurrentItemChangedCommandProperty |
的可绑定属性 CurrentItemChangedCommand。 |
| CurrentItemProperty |
的可绑定属性 CurrentItem。 |
| CurrentItemVisualState |
轮播中当前项的视觉状态名称。 |
| DefaultItemVisualState |
当前、下一个和上一个项的视觉状态名称。 |
| IsBounceEnabledProperty |
的可绑定属性 IsBounceEnabled。 |
| IsDraggingProperty |
的可绑定属性 IsDragging。 |
| IsScrollAnimatedProperty |
的可绑定属性 IsScrollAnimated。 |
| IsSwipeEnabledProperty |
的可绑定属性 IsSwipeEnabled。 |
| ItemsLayoutProperty |
的可绑定属性 ItemsLayout。 |
| LoopProperty |
的可绑定属性 Loop。 |
| NextItemVisualState |
轮播中下一项的视觉状态名称。 |
| PeekAreaInsetsProperty |
的可绑定属性 PeekAreaInsets。 |
| PositionChangedCommandParameterProperty |
的可绑定属性 PositionChangedCommandParameter。 |
| PositionChangedCommandProperty |
的可绑定属性 PositionChangedCommand。 |
| PositionProperty |
的可绑定属性 Position。 |
| PreviousItemVisualState |
轮播中上一项的视觉状态名称。 |
| propertyMapper |
表示视图的内部 PropertyMapper。 (继承自 View) |
| transientNamescope |
一个视图，该视图显示可滚动的项集合，其中每个项在滚动后“对齐”到位。 (继承自 Element) |
| VisibleViewsProperty |
的可绑定属性 VisibleViews。 |
属性
| 名称 | 说明 |
|---|---|
| AnchorX |
获取或设置任何转换操作的中心点的 X 组件，相对于元素的边界。 这是一种可绑定属性。 (继承自 VisualElement) |
| AnchorY |
获取或设置任何转换操作的中心点的 Y 组件，相对于元素的边界。 这是一种可绑定属性。 (继承自 VisualElement) |
| AnimateCurrentItemChanges |
获取一个值，该值指示是否应对当前项更改进行动画处理。 供平台呈现器内部使用。 |
| AnimatePositionChanges |
获取一个值，该值指示是否应对位置更改进行动画处理。 供平台呈现器内部使用。 |
| AutomationId |
获取或设置允许自动化框架查找此元素并与其交互的值。 (继承自 Element) |
| Background |
获取或设置 Brush 将用于填充元素背景的元素。 这是一种可绑定属性。 (继承自 VisualElement) |
| BackgroundColor |
获取或设置 Color 将填充元素的背景。 这是一种可绑定属性。 (继承自 VisualElement) |
| Batched |
获取一个值，该值指示对此元素进行了批处理更改。 (继承自 VisualElement) |
| Behaviors |
获取与此元素关联的对象列表 Behavior 。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| BindingContext |
获取或设置一个对象，该对象包含由属于此 BindableObject属性的绑定属性所面向的属性。 这是一种可绑定属性。 (继承自 BindableObject) |
| Bounds |
获取与设备无关的单元中元素的边界。 (继承自 VisualElement) |
| class |
获取或设置元素的样式类。 (继承自 NavigableElement) |
| ClassId |
获取或设置用于标识语义相似元素集合的值。 (继承自 Element) |
| Clip |
指定元素的剪辑区域。 这是一种可绑定属性。 (继承自 VisualElement) |
| CurrentItem |
获取或设置轮播中当前显示的项目。 |
| CurrentItemChangedCommand |
获取或设置在当前项更改时要执行的命令。 |
| CurrentItemChangedCommandParameter |
获取或设置要传递给 CurrentItemChangedCommand的参数。 |
| DesiredSize |
获取在布局流程的度量传递过程中此元素计算所得的大小。 (继承自 VisualElement) |
| DisableLayout |
获取一个值，该值指示此元素的布局已禁用。 (继承自 VisualElement) |
| Dispatcher |
获取创建此可绑定对象时可用的调度程序，否则会尝试查找最近的可用调度程序（可能是窗口的/应用）。 (继承自 BindableObject) |
| EffectControlProvider |
供.NET MAUI内部使用。 (继承自 Element) |
| Effects |
获取或设置将在运行时应用于元素的样式和属性。 (继承自 Element) |
| EmptyView |
获取或设置在为空或时 ItemsSource 要显示的视图或 |
| EmptyViewTemplate |
获取或设置DataTemplate用于呈现 .EmptyView (继承自 ItemsView) |
| FlowDirection |
获取或设置布局流方向。 这是一种可绑定属性。 (继承自 VisualElement) |
| Frame |
获取或设置此元素驻留在屏幕上的框架。 (继承自 VisualElement) |
| GestureController |
一个视图，该视图显示可滚动的项集合，其中每个项在滚动后“对齐”到位。 (继承自 View) |
| GestureRecognizers |
与此视图关联的手势识别器的集合。 (继承自 View) |
| Handler |
获取或设置与此 IViewHandler 元素关联的项。 (继承自 VisualElement) |
| Height |
获取此元素的当前呈现高度（以独立于设备的单位为单位）。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| HeightRequest |
获取或设置此元素在与设备无关的单元中所需的高度替代。 这是一种可绑定属性。 (继承自 VisualElement) |
| HorizontalOptions |
获取或设置 LayoutOptions 定义元素在布局周期中的排列方式。 这是一种可绑定属性。 (继承自 View) |
| HorizontalScrollBarVisibility |
获取或设置水平滚动条的可见性。 (继承自 ItemsView) |
| Id |
获取一个值，该值可用于在应用程序运行过程中唯一标识元素。 (继承自 Element) |
| IndicatorView |
设置 IndicatorView 要与此轮播的位置和项同步。 |
| InputTransparent |
获取或设置一个值，该值指示此元素在用户交互期间是否响应命中测试。 这是一种可绑定属性。 (继承自 VisualElement) |
| InternalItemsLayout |
一个视图，该视图显示可滚动的项集合，其中每个项在滚动后“对齐”到位。 (继承自 ItemsView) |
| IsBounceEnabled |
获取或设置一个值，该值指示滚动到达轮播末尾时是否启用弹跳效果。 |
| IsDragging |
获取一个值，该值指示用户当前是否正在拖动轮播。 |
| IsEnabled |
获取或设置一个值，该值指示是否在用户界面中启用此元素。 这是一种可绑定属性。 (继承自 VisualElement) |
| IsEnabledCore |
此值表示累积 IsEnabled 值。 重写此属性的所有类型都需要在值更改时调用 RefreshIsEnabledProperty（） 方法。 (继承自 VisualElement) |
| IsFocused |
获取一个值，该值指示当前是否聚焦此元素。 这是一种可绑定属性。 (继承自 VisualElement) |
| IsInPlatformLayout |
获取或设置一个值，该值指示此元素当前正在经历平台布局周期。 (继承自 VisualElement) |
| IsLoaded |
指示元素是否已连接到主对象树。 (继承自 VisualElement) |
| IsPlatformEnabled |
获取或设置一个值，该值指示是否启用此元素的平台等效元素。 (继承自 VisualElement) |
| IsPlatformStateConsistent |
获取或设置一个值，该值指示此元素当前与平台等效元素状态一致。 (继承自 VisualElement) |
| IsScrollAnimated |
获取或设置一个值，该值指示是否对项之间滚动进行动画处理。 |
| IsScrolling |
获取或设置一个值，该值指示轮播当前是否滚动。 |
| IsSwipeEnabled |
获取或设置一个值，该值指示是否为导航启用轻扫手势。 |
| IsVisible |
获取或设置一个值，该值确定此元素在屏幕上是否可见，并在布局中占用空间。 这是一种可绑定属性。 (继承自 VisualElement) |
| ItemsLayout |
获取或设置用于排列轮播中的项的布局。 |
| ItemsSource |
获取或设置要显示的项的集合。 (继承自 ItemsView) |
| ItemsUpdatingScrollMode |
获取或设置在集合中添加、删除或更新项时滚动行为。 (继承自 ItemsView) |
| ItemTemplate |
获取或设置 DataTemplate 用于呈现集合中的每个项。 (继承自 ItemsView) |
| LogicalChildren |
已过时.
一个视图，该视图显示可滚动的项集合，其中每个项在滚动后“对齐”到位。 (继承自 Element) |
| Loop |
获取或设置一个值，该值指示轮播在到达最后一项后是否循环回到第一个项目。 |
| Margin |
获取或设置视图的边距。 (继承自 View) |
| MaximumHeightRequest |
获取或设置元素在独立于设备的单元布局期间请求的最大高度。 这是一种可绑定属性。 (继承自 VisualElement) |
| MaximumWidthRequest |
获取或设置元素在独立于设备的单元布局期间请求的最大宽度。 这是一种可绑定属性。 (继承自 VisualElement) |
| MinimumHeightRequest |
获取或设置元素在独立于设备的单元布局期间请求的最小高度。 这是一种可绑定属性。 (继承自 VisualElement) |
| MinimumWidthRequest |
获取或设置元素在独立于设备的单元布局期间请求的最小宽度。 这是一种可绑定属性。 (继承自 VisualElement) |
| Navigation |
获取负责处理基于堆栈的导航的对象。 (继承自 NavigableElement) |
| NavigationProxy |
获取转换为 Navigation . NavigationProxy. (继承自 NavigableElement) |
| Opacity |
获取或设置呈现元素时应用于元素的不透明度值。 此值的范围为 0 到 1;超出此范围的值将设置为最接近的有效值。 这是一种可绑定属性。 (继承自 VisualElement) |
| Parent |
获取或设置此元素的父 Element 级。 (继承自 Element) |
| PeekAreaInsets |
获取或设置在当前项的每一侧保留的空间量，以显示相邻项的速览。 |
| Position |
获取或设置轮播中当前显示的项的索引。 |
| PositionChangedCommand |
获取或设置在轮播位置更改时要执行的命令。 |
| PositionChangedCommandParameter |
获取或设置要传递给 PositionChangedCommand的参数。 |
| RealParent |
供.NET MAUI内部使用。 (继承自 Element) |
| RemainingItemsThreshold |
获取或设置触发事件的 RemainingItemsThresholdReached 视图中剩余项的数目。 (继承自 ItemsView) |
| RemainingItemsThresholdReachedCommand |
获取或设置在滚动期间达到剩余项阈值时要执行的命令。 (继承自 ItemsView) |
| RemainingItemsThresholdReachedCommandParameter |
获取或设置要传递给 .. 的参数 RemainingItemsThresholdReachedCommand。 (继承自 ItemsView) |
| Resources |
获取或设置本地资源字典。 (继承自 VisualElement) |
| Rotation |
获取或设置呈现元素时围绕 Z 轴（仿射旋转）的旋转角度（以度为单位）。 这是一种可绑定属性。 (继承自 VisualElement) |
| RotationX |
获取或设置呈现元素时围绕 X 轴（透视旋转）的旋转角度（以度为单位）。 这是一种可绑定属性。 (继承自 VisualElement) |
| RotationY |
获取或设置呈现元素时围绕 Y 轴（透视旋转）的旋转角度（以度为单位）。 这是一种可绑定属性。 (继承自 VisualElement) |
| Scale |
获取或设置应用于元素的比例因子。 这是一种可绑定属性。 (继承自 VisualElement) |
| ScaleX |
获取或设置要应用于 X 方向的缩放值。 这是一种可绑定属性。 (继承自 VisualElement) |
| ScaleY |
获取或设置要应用于 Y 方向的缩放值。 这是一种可绑定属性。 (继承自 VisualElement) |
| Shadow |
获取或设置元素强制转换的阴影效果。 这是一种可绑定属性。 (继承自 VisualElement) |
| Style |
获取或设置此元素的唯 Style 一值。 (继承自 NavigableElement) |
| StyleClass |
获取或设置元素的样式类。 (继承自 NavigableElement) |
| StyleId |
获取或设置用于唯一地标识元素的用户定义的值。 (继承自 Element) |
| TranslationX |
获取或设置独立于设备的单元中元素的 X 转换增量。 这是一种可绑定属性。 (继承自 VisualElement) |
| TranslationY |
获取或设置独立于设备的单元中元素的 Y 转换增量。 这是一种可绑定属性。 (继承自 VisualElement) |
| Triggers |
获取与此元素关联的对象列表 TriggerBase 。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| VerticalOptions |
获取或设置 LayoutOptions 定义元素在布局周期中的排列方式。 这是一种可绑定属性。 (继承自 View) |
| VerticalScrollBarVisibility |
获取或设置垂直滚动条的可见性。 (继承自 ItemsView) |
| VisibleViews |
获取轮播中当前可见的视图的集合。 |
| Visual |
获取或设置替代 IVisual 元素的视觉外观的实现。 这是一种可绑定属性。 (继承自 VisualElement) |
| Width |
获取此元素的当前宽度（以独立于设备的单位为单位）。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| WidthRequest |
获取或设置此元素在与设备无关的单位中所需的宽度替代。 这是一种可绑定属性。 (继承自 VisualElement) |
| Window |
Window获取与元素关联的项。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| X |
获取此元素在独立于设备的单位中的当前 X 位置。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| Y |
获取此元素在独立于设备的单位中的当前 Y 位置。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| ZIndex |
获取或设置布局中元素的前向后 z 索引。 这是一种可绑定属性。 (继承自 VisualElement) |
