ListComponent

java.lang.Object
- ohos.agp.components.Component
- - ohos.agp.components.ComponentContainer
  - - ohos.agp.components.ListComponent

所有已实现的接口:

ComponentParent
```
public class ListComponent
extends ComponentContainer
```
A container class used to display lists that can be scrolled up and down on the screen.

从以下版本开始:

7

嵌套类概要

嵌套类
限定符和类型	类	说明
`static interface`	`ListComponent.BounceBackListener`	Implements listening for changes in the rebound status, including rebound start, rebound in progress, and rebound end.
`static interface`	`ListComponent.CachePolicyListener`	Implements listening for adding components to the `ListComponentPool`.
`static class`	`ListComponent.ListLayoutConfig`	Inherits from `ComponentContainer.LayoutConfig` and provides methods to enable a component in the `ListComponent` to access the corresponding `ComponentOwner`.
`static interface`	`ListComponent.OnComponentBoundStatusChangeListener`	Implements listening for status changes of the `ListComponent`.
`static class`	`ListComponent.OnFlingListener`	Implements listening for a fling.
`static class`	`ListComponent.ReboundEffectParams`	Provides parameters to implement the rebound effect.

从类继承的嵌套类/接口 ohos.agp.components.Component
Component.BindStateChangedListener, Component.CanAcceptScrollListener, Component.ClickedListener, Component.ComponentStateChangedListener, Component.ContourRefreshedListener, Component.DefSpeechEventListener, Component.DoubleClickedListener, Component.DragFeedbackProvider, Component.DraggedListener, Component.DrawTask, Component.EditEventListener, Component.EstimateSizeListener, Component.EstimateSpec, Component.FadeEffectEnum, Component.FocusChangedListener, Component.ForwardHoverListener, Component.ForwardTouchListener, Component.GestureType, Component.HoverEventListener, Component.KeyEventListener, Component.LayoutDirection, Component.LayoutRefreshedListener, Component.LongClickedListener, Component.MeasureSpec, Component.MouseEventListener, Component.MousePointerStyleListener, Component.OnDragListener, Component.RotationEventListener, Component.ScaledListener, Component.ScrolledListener, Component.ShadowDevice, Component.ShadowMode, Component.ShadowSize, Component.SpeechEventListener, Component.TouchEventListener, Component.UnconsumedKeyEventListener, Component.VoiceEvent

从类继承的嵌套类/接口 ohos.agp.components.ComponentContainer
ComponentContainer.ArrangeListener, ComponentContainer.LayoutConfig

字段概要

字段
限定符和类型	字段	说明
`static int`	`HORIZONTAL`	Indicates that the components are arranged horizontally in the `ListComponent`.
`static long`	`INVALID_ID`	Indicates an invalid component ID in the `ListComponent`.
`static int`	`INVALID_POSITION`	Indicates an invalid component position in the `ListComponent`.
`static int`	`INVALID_TYPE`	Indicates an invalid component type in the `ListComponent`.
`static int`	`ITEM_TYPE_NO_SCALE_MASK`	Indicates that no scale will be used.
`static int`	`ITEM_TYPE_NO_STICK_MASK`	Indicates that no stick will be used.
`static int`	`LIST_SCROLL_STATE_DRAGGING`	Indicates that the `ListComponent` is being dragged.
`static int`	`LIST_SCROLL_STATE_IDLE`	Indicates that the `ListComponent` is in the idle state.
`static int`	`LIST_SCROLL_STATE_SETTLING`	Indicates that the `ListComponent` is being swiped.
`static int`	`UNDEFINED_DURATION`	Indicates that the scroll duration is not defined.
`static int`	`VERTICAL`	Indicates that the components are arranged vertically in the `ListComponent`.

从类继承的字段 ohos.agp.components.Component
ACCESSIBILITY_ADAPTABLE, ACCESSIBILITY_DISABLE, ACCESSIBILITY_ENABLE, AXIS_X, AXIS_Y, CONTOUR_BACKGROUND, CONTOUR_BORDER, CONTOUR_PADDING_BORDER, DEFAULT_SCALE, DRAG_DOWN, DRAG_HORIZONTAL, DRAG_HORIZONTAL_VERTICAL, DRAG_LEFT, DRAG_RIGHT, DRAG_UP, DRAG_VERTICAL, EVENT_TYPE_COMPONENT_ACCESSIBILITY_FOCUSED, EVENT_TYPE_COMPONENT_ACCESSIBILITY_FOCUSED_CLEAR, EVENT_TYPE_COMPONENT_CLICKED, EVENT_TYPE_COMPONENT_FOCUSED, EVENT_TYPE_COMPONENT_LONG_CLICKED, EVENT_TYPE_COMPONENT_SCROLLED, EVENT_TYPE_COMPONENT_SELECTED, EVENT_TYPE_COMPONENT_TEXT_UPDATE, EVENT_TYPE_NOTICE, EVENT_TYPE_NOTIFICATION_STATE_UPDATE, EVENT_TYPE_TOAST_SHOW, EVENT_TYPE_WINDOW_STATE_UPDATE, FOCUS_ADAPTABLE, FOCUS_DISABLE, FOCUS_ENABLE, FOCUS_NEXT, FOCUS_PREVIOUS, FOCUS_SIDE_BOTTOM, FOCUS_SIDE_LEFT, FOCUS_SIDE_RIGHT, FOCUS_SIDE_TOP, HIDE, ID_DEFAULT, INHERITED_MODE, INVISIBLE, mBackgroundElement, mCanvasForTaskOverContent, mCanvasForTaskUnderContent, mComponentParent, mContext, mDrawTaskOverContent, mDrawTaskUnderContent, mEstimateSizeListener, mForegroundElement, mForwardHoverListener, mHoverEventListener, mKeyEventListener, mMouseEventListener, mPosition, mRotationEventListener, mShadowElement, mUnconsumedKeyEventListener, OVAL_MODE, OVAL_SCROLL_BAR_MODE, POSITION_X_INDEX, POSITION_Y_INDEX, RECT_MODE, RECT_SCROLL_BAR_MODE, SCROLL_AUTO_STAGE, SCROLL_IDLE_STAGE, SCROLL_NORMAL_STAGE, UNSPECIFIED_SCROLL_BAR_MODE, VISIBLE

从类继承的字段 ohos.agp.components.ComponentContainer
FOCUS_CHILDREN_FIRST, FOCUS_CHILDREN_HIDE, FOCUS_PARENT_FIRST, mArrangeListener

构造器概要

构造器
构造器	说明
`ListComponent(Context context)`	A constructor used to create a `ListComponent` instance based on the default attribute set and style.
`ListComponent(Context context, AttrSet attrSet)`	A constructor used to create a `ListComponent` instance based on the specified attribute set and the default style.
`ListComponent(Context context, AttrSet attrSet, String styleName)`	A constructor used to create a `ListComponent` instance based on the specified attribute set and style.

方法概要

所有方法实例方法具体方法
限定符和类型	方法	说明
`void`	`addBounceBackListener(ListComponent.BounceBackListener listener)`	Adds a listener for rebound state changes.
`void`	`addCachePolicyListener(ListComponent.CachePolicyListener listener)`	Adds a listener for the cache policy.
`void`	`addComponent(Component childComponent)`	Adds a component to the end of the queue by invoking `ComponentContainer.addComponent(ohos.agp.components.Component,int index)` internally.
`void`	`addComponent(Component childComponent, int index)`	Adds a component to the specified position.
`void`	`addComponent(Component childComponent, int width, int height)`	Adds a component and sets its width and height.
`void`	`addComponent(Component childComponent, int index, ComponentContainer.LayoutConfig layoutConfig)`	Adds a component and sets its layout parameters and location.
`void`	`addComponent(Component childComponent, ComponentContainer.LayoutConfig layoutConfig)`	Adds a component and sets its layout parameters.
`void`	`addListAdornment(ListAdornment adorn)`	Adds a `ListAdornment` object at the end of this `ListComponent`.
`void`	`addListAdornment(ListAdornment adorn, int index)`	Adds a `ListAdornment` object to the specified position of this `ListComponent`.
`void`	`addOnComponentBoundStatusChangeListener(ListComponent.OnComponentBoundStatusChangeListener listener)`	Adds a listener that will be notified when a child component is bound to or unbound from this `ListComponent`.
`void`	`alignChildComponentXCoordinate(int dx)`	Sets a horizontal pixel offset for the boundaries of all child components in this `ListComponent`.
`void`	`alignChildComponentYCoordinate(int dy)`	Sets a vertical pixel offset for the boundaries of all child components in this `ListComponent`.
`void`	`clearBounceBackListeners()`	Removes all listeners for rebound state changes.
`void`	`clearOnComponentBoundStatusChangeListener()`	Removes all listeners that were notified when a child component is bound to or unbound from this `ListComponent`.
`protected void`	`createNativePtr()`
`boolean`	`fling(int speedX, int speedY)`	Triggers a fling for this `ListComponent` with the initial velocity in the horizontal and vertical directions.
`void`	`getAdornedBoundryIncludeMargin(Component component, Rect outBounds)`	Obtains the boundary of a child component, including its adornments and margins.
`long`	`getChildComponentId(Component child)`	Obtains the ID of a child component in this `ListComponent`.
`ComponentOwner`	`getChildComponentOwner(Component child)`	Obtains the `ComponentOwner` of a child component.
`int`	`getChildCount()`	Obtains the quantity of child components.
`int`	`getChildLayoutPosition(Component component)`	Obtains the position of a child component in the provider after the latest layout calculation.
`int`	`getChildProviderPosition(Component component)`	Obtains the position of a child component in the provider.
`Component`	`getComponentAt(int position)`	Obtains a child component using an index.
`ComponentOwner`	`getComponentOwnerById(long id)`	Obtains the `ComponentOwner` based on the child component ID.
`ItemAnimation`	`getItemAnimation()`	Obtains the `ItemAnimation` object, which is used to process the animations that take place when the provider changes.
`ListAdornment`	`getListAdornmentAt(int index)`	Obtains the `ListAdornment` object with a given index of this `ListComponent`.
`int`	`getListAdornmentCount()`	Obtains the number of `ListAdornment` objects in this `ListComponent`.
`ListComponentPool`	`getListCachedPool()`	Obtains the reclaim pool of this `ListComponent`.
`ListLayoutManager`	`getListLayoutManager()`	Obtains the `ListLayoutManager` object used by this `ListComponent`.
`int`	`getMaxFlingSpeed()`	Obtains the maximum velocity to trigger a fling.
`int`	`getMinFlingSpeed()`	Obtains the minimum velocity to trigger a fling.
`Provider`	`getProvider()`	Obtains the provider of this `ListComponent`.
`boolean`	`getReboundEffect()`	Checks whether the rebound effect is enabled.
`ListComponent.ReboundEffectParams`	`getReboundEffectParams()`	Obtains the rebound effect parameters in the form of a `ReboundEffectParams` object.
`boolean`	`getRecoverfocusAfterRefresh()`	Checks whether this `ListComponent` keeps the same child component focused after a layout calculation.
`boolean`	`hasIncomingProviderRefresh()`	Checks whether there is an update to the provider that has not been applied to the layout.
`boolean`	`isCalculatingLayout()`	Checks whether this `ListComponent` is calculating the layout.
`boolean`	`isListAnimating()`	Checks whether this `ListComponent` is running animations.
`boolean`	`isPostponeLayout()`	Checks whether layout requests of this `ListComponent` are postponed.
`boolean`	`isScrollingSmoothly()`	Checks whether this `ListComponent` is being smoothly scrolled.
`boolean`	`isSizeFixed()`	Checks whether the provider of this `ListComponent` has a fixed size.
`void`	`onBounceBackChange(int xOverScrolled, int yOverScrolled)`	Called when the rebound is in progress.
`void`	`onBounceBackEnd(int xOverScrolled, int yOverScrolled)`	Called when the rebound ends.
`void`	`onBounceBackStart(int xOverScrolled, int yOverScrolled)`	Called when the rebound starts.
`void`	`onComponentBoundToWindow(Component child)`	Called when a child component is bound to this `ListComponent`.
`void`	`onComponentUnboundFromWindow(Component child)`	Called when a child component is unbound from this `ListComponent`.
`void`	`postLayout()`	Requests rearranging the layout of the component.
`void`	`postponeLayout(boolean isPostponeLayout)`	Sets whether to postpone layout requests of this `ListComponent`.
`void`	`refreshListAdornments()`	Proactively refreshes the `ListAdornment` objects in this `ListComponent`.
`void`	`removeAllComponents()`	Clears all components managed by `ComponentContainer`.
`void`	`removeBounceBackListener(ListComponent.BounceBackListener listener)`	Removes a listener for rebound state changes.
`void`	`removeCachePolicyListener(ListComponent.CachePolicyListener listener)`	Removes a listener for the cache policy.
`void`	`removeComponent(Component component)`	Removes a child component from the parent component.
`void`	`removeComponentAt(int index)`	Removes the component from a specified position in the component list.
`void`	`removeComponentById(int id)`	Removes a component based on its ID.
`void`	`removeComponents(int start, int count)`	Removes all components from specified positions in a component list.
`void`	`removeListAdornment(ListAdornment decor)`	Removes a given `ListAdornment` object from this `ListComponent`.
`void`	`removeListAdornmentAt(int index)`	Removes the `ListAdornment` object with a given index of this `ListComponent`.
`void`	`removeOnComponentBoundStatusChangeListener(ListComponent.OnComponentBoundStatusChangeListener listener)`	Removes a listener that was notified when a child component is bound to or unbound from this `ListComponent`.
`void`	`scrollBy(int x, int y)`	Scrolls this `ListComponent` by a relative distance.
`void`	`scrollByInSmoothMode(int dx, int dy)`	Smoothly scrolls this `ListComponent` by a relative distance.
`void`	`scrollByInSmoothMode(int dx, int dy, Animator.TimelineCurve curve)`	Smoothly scrolls this `ListComponent` by a relative distance based on a scrolling curve.
`void`	`scrollTo(int x, int y)`	Scrolls this `ListComponent` to the specified horizontal and vertical coordinates.
`void`	`scrollToPosition(int position)`	Scrolls this `ListComponent` to a specific position.
`void`	`scrollToPositionInSmoothMode(int position)`	Smoothly scrolls this `ListComponent` to a specific position.
`Component`	`searchChildComponentBelowPoint(float x, float y)`	Searches for a child component based on the coordinates on the screen.
`ComponentOwner`	`searchComponentOwnerForLayoutPosition(int position)`	Searches for a `ComponentOwner` in the latest layout based on the specified position.
`ComponentOwner`	`searchComponentOwnerForProviderPosition(int position)`	Searches for the `ComponentOwner` in the provider based on the specified position.
`Component`	`searchParentComponentOfChild(Component component)`	Searches for the child component that contains the specified component (grandchild component).
`ComponentOwner`	`searchParentComponentOwnerOfChild(Component component)`	Searches for the `ComponentOwner` of the child component that contains the specified component (grandchild component).
`void`	`setIsFixedSize(boolean isFixedSize)`	Sets whether the provider of this `ListComponent` has a fixed size.
`void`	`setItemAnimation(ItemAnimation animation)`	Sets an `ItemAnimation` object for processing the animations that take place when the provider changes.
`void`	`setLayoutManager(LayoutManager layoutManager)`	Sets a `LayoutManager` instance, which is used to lay out relevant child components.
`void`	`setListCachedPool(ListComponentPool pool)`	Sets a reclaim pool for this `ListComponent`.
`void`	`setListLayoutManager(ListLayoutManager layoutManager)`	Sets a `ListLayoutManager` object for this `ListComponent`.
`void`	`setOnFlingListener(ListComponent.OnFlingListener listener)`	Sets a `OnFlingListener` for this `ListComponent`.
`void`	`setProvider(Provider provider)`	Sets a provider for this `ListComponent`.
`void`	`setReboundEffect(boolean enabled)`	Sets whether to enable the rebound effect.
`void`	`setReboundEffectParams(int overscrollPercent, float overscrollRate, int remainVisiblePercent)`	Sets rebound effect parameters.
`void`	`setReboundEffectParams(ListComponent.ReboundEffectParams reboundEffectParams)`	Sets rebound effect parameters using a `ReboundEffectParams` object.
`void`	`setRecoverfocusAfterRefresh(boolean recoverFocusAfterRefresh)`	Sets whether this `ListComponent` keeps the same child component focused after a layout calculation.
`void`	`setRequestedCacheMax(int count)`	Sets the maximum number of off-screen components that can be cached.
`void`	`stopScroll()`	Stops the current scrolling.
`void`	`switchProvider(Provider provider, boolean deleteAndReuseComponents)`	Replaces the provider of this `ListComponent` with a new one.
`ComponentContainer.LayoutConfig`	`verifyLayoutConfig(ComponentContainer.LayoutConfig config)`	Customizes a `ListLayoutConfig` object so that the `ComponentOwner` has the metadata of the `ListLayoutManager`.

从类继承的方法 ohos.agp.components.Component
addDrawTask, addDrawTask, addScrolledListener, announceAccessibility, arrange, bindCornerMark, callOnClick, canScroll, clearFocus, createAnimatorProperty, disableFadeEffect, draw, enableCornerMark, enableFadeEffect, enableSaveState, enableScrollBar, estimateSize, executeDoubleClick, executeLongClick, findFocus, findNextFocusableComponent, findRequestNextFocus, getAccessibility, getAccessibilityDescription, getAlpha, getAltitude, getBackgroundElement, getBaseLine, getBottom, getBoundaryFadeEffectBottomRate, getBoundaryFadeEffectLeftRate, getBoundaryFadeEffectRightRate, getBoundaryFadeEffectTopRate, getCenterZoomFactor, getCentralScrollMode, getClickedListener, getClipEnabled, getComponentDescription, getComponentMinSize, getComponentParent, getComponentPosition, getComponentSize, getComponentStateChangedListener, getComponentTreeObserver, getContentEnable, getContentPosition, getContentPositionX, getContentPositionY, getContext, getContour, getContourRefreshedListener, getCornerMark, getDragAcceptAngle, getDraggedListener, getEditEventListener, getEstimatedHeight, getEstimatedWidth, getFadeEffectBoundaryWidth, getFadeEffectColor, getFocusable, getFocusBorderEnable, getFocusBorderPadding, getFocusBorderRadius, getFocusBorderWidth, getForegroundElement, getForegroundGravity, getForwardHoverListener, getForwardTouchListener, getGesturePriority, getHeight, getHorizontalPadding, getHorizontalPosition, getHoverEventListener, getId, getKeyEventListener, getLayoutConfig, getLayoutDirection, getLayoutDirectionResolved, getLayoutRefreshedListener, getLeft, getLocationOnScreen, getMarginBottom, getMarginLeft, getMarginRight, getMargins, getMarginsLeftAndRight, getMarginsTopAndBottom, getMarginTop, getMatrix, getMinHeight, getMinWidth, getMode, getModeResolved, getMouseEventListener, getMousePointerStyleListener, getName, getPadding, getPaddingBottom, getPaddingEnd, getPaddingLeft, getPaddingRight, getPaddingStart, getPaddingTop, getPivot, getPivotX, getPivotY, getResourceManager, getRight, getRotation, getRotationEventListener, getRotationSensitivity, getScale, getScaledListener, getScaleX, getScaleY, getScrollbarBackgroundColor, getScrollbarColor, getScrollbarFadingDelay, getScrollbarFadingDuration, getScrollBarMode, getScrollbarRadius, getScrollbarRoundRect, getScrollbarStartAngle, getScrollbarSweepAngle, getScrollbarThickness, getScrollState, getScrollValue, getSelfVisibleRect, getShadowColor, getSpeechEventListener, getTag, getTop, getTouchEventListener, getTransitionSymbol, getTranslation, getTranslationX, getTranslationY, getTranslationZ, getUserNextFocus, getVerticalPadding, getVerticalPosition, getVisibility, getVisibleRectOnScreen, getWidth, getWindowVisibleRect, hasFocus, hasFocusedEffect, hasOverlaps, hideFocusBorder, invalidate, isBoundaryFadeEffectEnable, isBoundToWindow, isClickable, isClipToContourEnabled, isComponentDisplayed, isEnabled, isFadeEffected, isFocusable, isFocused, isIdentityMatrix, isLongClickOn, isPressed, isRtl, isSaveStateEnabled, isScrollbarFadingOn, isScrollBarOn, isScrollbarOverlapEnabled, isSelected, isSoundEnable, isTouchFocusable, isVibrationEffectEnabled, notifyAccessibility, onAttributeConfigChanged, onRestoreState, onRtlChanged, onSaveState, performScale, playSound, refreshContour, release, removeBindStateChangedListener, removeScrolledListener, requestFocus, requestForceForwardTouchEvent, restoreComponentTreeState, saveComponentTreeState, setAccessibility, setAccessibilityDescription, setAlpha, setAltitude, setBackground, setBindStateChangedListener, setBottom, setBoundaryFadeEffectEnable, setCanAcceptScrollListener, setCenterZoomFactor, setCentralScrollMode, setClickable, setClickedListener, setClipEnabled, setClipToContourEnabled, setComponentDescription, setComponentMinSize, setComponentPosition, setComponentPosition, setComponentSize, setComponentStateChangedListener, setContentEnable, setContentPosition, setContentPositionX, setContentPositionY, setContour, setContourRefreshedListener, setDoubleClickedListener, setDragAcceptAngle, setDraggedListener, setEditEventListener, setEnabled, setEstimatedSize, setEstimateSizeListener, setFadeEffectBoundaryWidth, setFadeEffectColor, setFocusable, setFocusBorderEnable, setFocusBorderPadding, setFocusBorderRadius, setFocusBorderRadius, setFocusBorderWidth, setFocusChangedListener, setFocusedEffect, setForeground, setForegroundGravity, setForwardHoverListener, setForwardTouchListener, setGesturePriority, setHeight, setHorizontalPadding, setHorizontalPosition, setHoverEventListener, setId, setKeyEventListener, setLayoutConfig, setLayoutDirection, setLayoutRefreshedListener, setLeft, setLongClickable, setLongClickedListener, setMarginBottom, setMarginLeft, setMarginRight, setMarginsLeftAndRight, setMarginsTopAndBottom, setMarginTop, setMinHeight, setMinWidth, setMode, setMouseEventListener, setMousePointerStyleListener, setName, setOnDragListener, setPadding, setPaddingBottom, setPaddingLeft, setPaddingRelative, setPaddingRight, setPaddingTop, setPivot, setPivot, setPivotX, setPivotY, setPosition, setPositionX, setPositionY, setPressState, setRight, setRotation, setRotationEventListener, setRotationSensitivity, setScale, setScaledListener, setScaleX, setScaleY, setScrollbarBackgroundColor, setScrollbarColor, setScrollbarFadingDelay, setScrollbarFadingDuration, setScrollbarFadingEnabled, setScrollBarMode, setScrollbarOverlapEnabled, setScrollbarRadius, setScrollbarRoundRect, setScrollbarStartAngle, setScrollbarSweepAngle, setScrollbarThickness, setScrolledListener, setSelected, setShadowColor, setShadowStyle, setSoundEnable, setSpeechEventListener, setTag, setTop, setTouchEventListener, setTouchFocusable, setTransitionSymbol, setTranslation, setTranslationX, setTranslationY, setTranslationZ, setUnconsumedKeyEventListener, setUserNextFocus, setVerticalPadding, setVerticalPosition, setVibrationEffectEnabled, setVisibility, setWidth, showFocusBorder, simulateClick, simulateDrag, startDragAndDrop, subscribeVoiceEvents, unsubscribeVoiceEvents

从接口继承的方法 ohos.agp.components.ComponentParent
getComponentParent

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - HORIZONTAL
```
public static final int HORIZONTAL
```
    Indicates that the components are arranged horizontally in the ListComponent.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    常量字段值
  - INVALID_ID
```
public static final long INVALID_ID
```
    Indicates an invalid component ID in the ListComponent.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    常量字段值
  - INVALID_POSITION
```
public static final int INVALID_POSITION
```
    Indicates an invalid component position in the ListComponent.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    常量字段值
  - INVALID_TYPE
```
public static final int INVALID_TYPE
```
    Indicates an invalid component type in the ListComponent.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    常量字段值
  - ITEM_TYPE_NO_SCALE_MASK
```
public static final int ITEM_TYPE_NO_SCALE_MASK
```
    Indicates that no scale will be used.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    #getItemViewType(), 常量字段值
  - ITEM_TYPE_NO_STICK_MASK
```
public static final int ITEM_TYPE_NO_STICK_MASK
```
    Indicates that no stick will be used.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    #getItemViewType(), 常量字段值
  - LIST_SCROLL_STATE_DRAGGING
```
public static final int LIST_SCROLL_STATE_DRAGGING
```
    Indicates that the ListComponent is being dragged.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    Component.getScrollState(), 常量字段值
  - LIST_SCROLL_STATE_IDLE
```
public static final int LIST_SCROLL_STATE_IDLE
```
    Indicates that the ListComponent is in the idle state.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    Component.getScrollState(), 常量字段值
  - LIST_SCROLL_STATE_SETTLING
```
public static final int LIST_SCROLL_STATE_SETTLING
```
    Indicates that the ListComponent is being swiped.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    Component.getScrollState(), 常量字段值
  - UNDEFINED_DURATION
```
public static final int UNDEFINED_DURATION
```
    Indicates that the scroll duration is not defined.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    常量字段值
  - VERTICAL
```
public static final int VERTICAL
```
    Indicates that the components are arranged vertically in the ListComponent.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    常量字段值
- 构造器详细资料
  - ListComponent
```
public ListComponent(Context context)
```
    A constructor used to create a ListComponent instance based on the default attribute set and style.
    
    参数:
    
    context - Indicates the application context.
    
    从以下版本开始:
    
    7
  - ListComponent
```
public ListComponent(Context context,
                     AttrSet attrSet)
```
    A constructor used to create a ListComponent instance based on the specified attribute set and the default style.
    
    参数:
    
    context - Indicates the application context.
    
    attrSet - Indicates the attribute set to use.
    
    从以下版本开始:
    
    7
  - ListComponent
```
public ListComponent(Context context,
                     AttrSet attrSet,
                     String styleName)
```
    A constructor used to create a ListComponent instance based on the specified attribute set and style.
    
    参数:
    
    context - Indicates the application context.
    
    attrSet - Indicates the attribute set to use.
    
    styleName - Indicates the name of the style to use.
    
    从以下版本开始:
    
    7
- 方法详细资料
  - createNativePtr
```
protected void createNativePtr()
```
  - addComponent
```
public void addComponent(Component childComponent)
```
    Adds a component to the end of the queue by invoking ComponentContainer.addComponent(ohos.agp.components.Component,int index) internally.
    
    覆盖:
    
    addComponent 在类中 ComponentContainer
    
    参数:
    
    childComponent - Indicates the child component to add.
    
    抛出:
    
    UnsupportedOperationException - Method is not allowed in ListContainer.
  - addComponent
```
public void addComponent(Component childComponent,
                         int width,
                         int height)
```
    Adds a component and sets its width and height.
    
    覆盖:
    
    addComponent 在类中 ComponentContainer
    
    参数:
    
    childComponent - Indicates the child component to add.
    
    width - Indicates the width of the child component, in pixels.
    
    height - Indicates the height of the child component, in pixels.
    
    抛出:
    
    UnsupportedOperationException - Method is not allowed in ListContainer.
  - addComponent
```
public void addComponent(Component childComponent,
                         ComponentContainer.LayoutConfig layoutConfig)
```
    Adds a component and sets its layout parameters.
    
    覆盖:
    
    addComponent 在类中 ComponentContainer
    
    参数:
    
    childComponent - Indicates the child component to add.
    
    layoutConfig - Indicates the layout parameters of the child component.
    
    抛出:
    
    UnsupportedOperationException - Method is not allowed in ListContainer.
  - addComponent
```
public void addComponent(Component childComponent,
                         int index,
                         ComponentContainer.LayoutConfig layoutConfig)
```
    Adds a component and sets its layout parameters and location.
    
    覆盖:
    
    addComponent 在类中 ComponentContainer
    
    参数:
    
    childComponent - Indicates the child component to add.
    
    index - Indicates where to add the child component. The value -1 means to add the child component to the end of the queue.
    
    layoutConfig - Indicates the layout parameters of the child component.
    
    抛出:
    
    UnsupportedOperationException - Method is not allowed in ListContainer.
  - addComponent
```
public void addComponent(Component childComponent,
                         int index)
```
    Adds a component to the specified position.
    If no layout parameters are set for this child component, the default layout parameters of ComponentContainer are used.
    
    覆盖:
    
    addComponent 在类中 ComponentContainer
    
    参数:
    
    childComponent - Indicates the child component to add.
    
    index - Indicates where to add the child component. The value -1 means to add the component to the end. If a number greater than the value of getChildCount() is provided, a runtime exception is returned.
    
    抛出:
    
    UnsupportedOperationException - Method is not allowed in ListContainer.
  - removeComponent
```
public void removeComponent(Component component)
```
    Removes a child component from the parent component.
    
    指定者:
    
    removeComponent 在接口中 ComponentParent
    
    覆盖:
    
    removeComponent 在类中 ComponentContainer
    
    参数:
    
    component - Indicates the child component to remove.
    
    抛出:
    
    UnsupportedOperationException - Method is not allowed in ListContainer.
  - removeComponentAt
```
public void removeComponentAt(int index)
```
    Removes the component from a specified position in the component list.
    
    指定者:
    
    removeComponentAt 在接口中 ComponentParent
    
    覆盖:
    
    removeComponentAt 在类中 ComponentContainer
    
    参数:
    
    index - Indicates the position index of the component to remove.
    
    抛出:
    
    UnsupportedOperationException - Method is not allowed in ListContainer.
  - removeComponentById
```
public void removeComponentById(int id)
```
    Removes a component based on its ID.
    
    覆盖:
    
    removeComponentById 在类中 ComponentContainer
    
    参数:
    
    id - Indicates the component ID.
    
    抛出:
    
    UnsupportedOperationException - Method is not allowed in ListContainer.
  - removeComponents
```
public void removeComponents(int start,
                             int count)
```
    Removes all components from specified positions in a component list.
    
    指定者:
    
    removeComponents 在接口中 ComponentParent
    
    覆盖:
    
    removeComponents 在类中 ComponentContainer
    
    参数:
    
    start - Indicates the position index of the first removed component.
    
    count - Indicates the quantity of components to remove.
    
    抛出:
    
    UnsupportedOperationException - Method is not allowed in ListContainer.
  - removeAllComponents
```
public void removeAllComponents()
```
    Clears all components managed by ComponentContainer.
    
    覆盖:
    
    removeAllComponents 在类中 ComponentContainer
    
    抛出:
    
    UnsupportedOperationException - Method is not allowed in ListContainer.
  - getComponentAt
```
public Component getComponentAt(int position)
```
    从类复制的说明: ComponentContainer
    
    Obtains a child component using an index.
    ComponentContainer uses an internal list to store child component information. You can obtain specified child components using the index.
    
    覆盖:
    
    getComponentAt 在类中 ComponentContainer
    
    参数:
    
    position - Indicates the index of child components.
    
    返回:
    
    Returns the child component.
  - getChildCount
```
public int getChildCount()
```
    从类复制的说明: ComponentContainer
    
    Obtains the quantity of child components.
    
    覆盖:
    
    getChildCount 在类中 ComponentContainer
    
    返回:
    
    Returns the quantity of child components.
  - onComponentBoundToWindow
```
public void onComponentBoundToWindow(Component child)
```
    Called when a child component is bound to this ListComponent.
    
    参数:
    
    child - Indicates the child component bound to the ListComponent.
    
    从以下版本开始:
    
    7
  - onComponentUnboundFromWindow
```
public void onComponentUnboundFromWindow(Component child)
```
    Called when a child component is unbound from this ListComponent.
    
    参数:
    
    child - Indicates the child component unbound from the ListComponent.
    
    从以下版本开始:
    
    7
  - setListLayoutManager
```
public void setListLayoutManager(ListLayoutManager layoutManager)
```
    Sets a ListLayoutManager object for this ListComponent.
    
    参数:
    
    layoutManager - Indicates the ListLayoutManager object to set.
    
    从以下版本开始:
    
    7
  - getListLayoutManager
```
public ListLayoutManager getListLayoutManager()
```
    Obtains the ListLayoutManager object used by this ListComponent.
    
    返回:
    
    Returns the ListLayoutManager object.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    setListLayoutManager(ListLayoutManager)
  - setProvider
```
public void setProvider(Provider provider)
```
    Sets a provider for this ListComponent.
    
    参数:
    
    provider - Indicates the provider to set.
    
    从以下版本开始:
    
    7
  - getProvider
```
public Provider getProvider()
```
    Obtains the provider of this ListComponent.
    
    返回:
    
    Returns the provider if obtained; returns null if no provider is set.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    setProvider(Provider)
  - setIsFixedSize
```
public void setIsFixedSize(boolean isFixedSize)
```
    Sets whether the provider of this ListComponent has a fixed size.
    This method can be used to improve layout performance when the provider changes.
    
    参数:
    
    isFixedSize - Specifies whether the provider has a fixed size. The value true means that the provider has a fixed size, indicating that the provider changes do not affect the size of the ListComponent; the value false means the opposite.
    
    从以下版本开始:
    
    7
  - isSizeFixed
```
public boolean isSizeFixed()
```
    Checks whether the provider of this ListComponent has a fixed size.
    
    返回:
    
    Returns true if the provider has a fixed size; returns false otherwise.
    
    从以下版本开始:
    
    7
  - isCalculatingLayout
```
public boolean isCalculatingLayout()
```
    Checks whether this ListComponent is calculating the layout.
    
    返回:
    
    Returns true if the ListComponent is calculating the layout; returns false otherwise.
    
    从以下版本开始:
    
    7
  - alignChildComponentYCoordinate
```
public void alignChildComponentYCoordinate(int dy)
```
    Sets a vertical pixel offset for the boundaries of all child components in this ListComponent.
    
    参数:
    
    dy - Indicates the vertical pixel offset to set.
    
    从以下版本开始:
    
    7
  - alignChildComponentXCoordinate
```
public void alignChildComponentXCoordinate(int dx)
```
    Sets a horizontal pixel offset for the boundaries of all child components in this ListComponent.
    
    参数:
    
    dx - Indicates the horizontal pixel offset to set.
    
    从以下版本开始:
    
    7
  - switchProvider
```
public void switchProvider(Provider provider,
                           boolean deleteAndReuseComponents)
```
    Replaces the provider of this ListComponent with a new one.
    Before replacing a provider, you can use the deleteAndReuseComponents parameter to determine whether to reclaim all the child components in the ListComponent.
    
    参数:
    
    provider - Indicates the new provider. The value null means that no provider will be set.
    
    deleteAndReuseComponents - Specifies whether to reclaim all the child components in the ListComponent. The value true means to reclaim all the child components, and false means the opposite.
    
    从以下版本开始:
    
    7
  - addOnComponentBoundStatusChangeListener
```
public void addOnComponentBoundStatusChangeListener(ListComponent.OnComponentBoundStatusChangeListener listener)
```
    Adds a listener that will be notified when a child component is bound to or unbound from this ListComponent.
    
    参数:
    
    listener - Indicates the listener to add.
    
    从以下版本开始:
    
    7
  - clearOnComponentBoundStatusChangeListener
```
public void clearOnComponentBoundStatusChangeListener()
```
    Removes all listeners that were notified when a child component is bound to or unbound from this ListComponent.
    
    从以下版本开始:
    
    7
  - removeOnComponentBoundStatusChangeListener
```
public void removeOnComponentBoundStatusChangeListener(ListComponent.OnComponentBoundStatusChangeListener listener)
```
    Removes a listener that was notified when a child component is bound to or unbound from this ListComponent.
    
    参数:
    
    listener - Indicates the listener to remove.
    
    从以下版本开始:
    
    7
  - getChildProviderPosition
```
public int getChildProviderPosition(Component component)
```
    Obtains the position of a child component in the provider.
    
    参数:
    
    component - Indicates the child component.
    
    返回:
    
    Returns the position of the child component if obtained; returns -1 if component is null.
    
    从以下版本开始:
    
    7
  - getChildLayoutPosition
```
public int getChildLayoutPosition(Component component)
```
    Obtains the position of a child component in the provider after the latest layout calculation.
    
    参数:
    
    component - Indicates the child component.
    
    返回:
    
    Returns the position of the child component if obtained; returns -1 if component is null.
    
    从以下版本开始:
    
    7
  - getChildComponentId
```
public long getChildComponentId(Component child)
```
    Obtains the ID of a child component in this ListComponent.
    
    参数:
    
    child - Indicates the child component.
    
    返回:
    
    Returns the child component ID if obtained; returns -1 if child is null.
    
    从以下版本开始:
    
    7
  - searchComponentOwnerForLayoutPosition
```
public ComponentOwner searchComponentOwnerForLayoutPosition(int position)
```
    Searches for a ComponentOwner in the latest layout based on the specified position.
    
    参数:
    
    position - Indicates the position of the component in the provider.
    
    返回:
    
    Returns the ComponentOwner if obtained; returns null otherwise.
    
    从以下版本开始:
    
    7
  - searchComponentOwnerForProviderPosition
```
public ComponentOwner searchComponentOwnerForProviderPosition(int position)
```
    Searches for the ComponentOwner in the provider based on the specified position.
    
    参数:
    
    position - Indicates the position of the component in the provider.
    
    返回:
    
    Returns the ComponentOwner if obtained; returns null otherwise.
    
    从以下版本开始:
    
    7
  - getComponentOwnerById
```
public ComponentOwner getComponentOwnerById(long id)
```
    Obtains the ComponentOwner based on the child component ID.
    
    参数:
    
    id - Indicates the child component ID.
    
    返回:
    
    Returns the ComponentOwner if obtained; returns null otherwise.
    
    从以下版本开始:
    
    7
  - searchChildComponentBelowPoint
```
public Component searchChildComponentBelowPoint(float x,
                                                float y)
```
    Searches for a child component based on the coordinates on the screen.
    
    参数:
    
    x - Indicates the horizontal coordinate, in pixels.
    
    y - Indicates the vertical coordinate, in pixels.
    
    返回:
    
    Returns the child component if obtained; returns null otherwise.
    
    从以下版本开始:
    
    7
  - getChildComponentOwner
```
public ComponentOwner getChildComponentOwner(Component child)
```
    Obtains the ComponentOwner of a child component.
    
    参数:
    
    child - Indicates the child component to query.
    
    返回:
    
    Returns the ComponentOwner if obtained; returns null if child is null, if no ComponentOwner is obtained, or if an exception occurs.
    
    从以下版本开始:
    
    7
  - searchParentComponentOfChild
```
public Component searchParentComponentOfChild(Component component)
```
    Searches for the child component that contains the specified component (grandchild component).
    
    参数:
    
    component - Indicates the grandchild component.
    
    返回:
    
    Returns the child component if obtained; returns null otherwise.
    
    从以下版本开始:
    
    7
  - searchParentComponentOwnerOfChild
```
public ComponentOwner searchParentComponentOwnerOfChild(Component component)
```
    Searches for the ComponentOwner of the child component that contains the specified component (grandchild component).
    
    参数:
    
    component - Indicates the grandchild component.
    
    返回:
    
    Returns the ComponentOwner if obtained; returns null otherwise.
    
    从以下版本开始:
    
    7
  - hasIncomingProviderRefresh
```
public boolean hasIncomingProviderRefresh()
```
    Checks whether there is an update to the provider that has not been applied to the layout.
    
    返回:
    
    Returns true if there is a provider update that is not applied to the layout; returns false if the layout is the latest or if an exception occurs.
    
    从以下版本开始:
    
    7
  - addCachePolicyListener
```
public void addCachePolicyListener(ListComponent.CachePolicyListener listener)
```
    Adds a listener for the cache policy.
    
    参数:
    
    listener - Indicates the listener to add.
    
    从以下版本开始:
    
    7
  - removeCachePolicyListener
```
public void removeCachePolicyListener(ListComponent.CachePolicyListener listener)
```
    Removes a listener for the cache policy.
    
    参数:
    
    listener - Indicates the listener to remove.
    
    从以下版本开始:
    
    7
  - getListCachedPool
```
public ListComponentPool getListCachedPool()
```
    Obtains the reclaim pool of this ListComponent.
    If no reclaim pool is set for this ListComponent, this method creates one and returns it.
    
    返回:
    
    Returns the reclaim pool.
    
    从以下版本开始:
    
    7
  - setListCachedPool
```
public void setListCachedPool(ListComponentPool pool)
```
    Sets a reclaim pool for this ListComponent.
    
    参数:
    
    pool - Indicates the reclaim pool to set. If this parameter is null, a new pool is created and used.
    
    从以下版本开始:
    
    7
  - setRequestedCacheMax
```
public void setRequestedCacheMax(int count)
```
    Sets the maximum number of off-screen components that can be cached.
    
    参数:
    
    count - Indicates the number of off-screen components to set.
    
    从以下版本开始:
    
    7
  - scrollToPositionInSmoothMode
```
public void scrollToPositionInSmoothMode(int position)
```
    Smoothly scrolls this ListComponent to a specific position.
    
    参数:
    
    position - Indicates the position to scroll to.
    
    从以下版本开始:
    
    7
  - fling
```
public boolean fling(int speedX,
                     int speedY)
```
    Triggers a fling for this ListComponent with the initial velocity in the horizontal and vertical directions.
    
    参数:
    
    speedX - Indicates the initial velocity in the horizontal direction, in pixels per second.
    
    speedY - Indicates the initial velocity in the vertical direction, in pixels per second.
    
    返回:
    
    Returns true if the fling starts; returns false if the fling fails to start because of a low initial velocity, if the LayoutManager does not support a fling, or if an exception occurs.
    
    从以下版本开始:
    
    7
  - getMinFlingSpeed
```
public int getMinFlingSpeed()
```
    Obtains the minimum velocity to trigger a fling.
    
    返回:
    
    Returns the minimum velocity.
    
    从以下版本开始:
    
    7
  - getMaxFlingSpeed
```
public int getMaxFlingSpeed()
```
    Obtains the maximum velocity to trigger a fling.
    
    返回:
    
    Returns the maximum velocity.
    
    从以下版本开始:
    
    7
  - scrollToPosition
```
public void scrollToPosition(int position)
```
    Scrolls this ListComponent to a specific position.
    
    参数:
    
    position - Indicates the position to scroll to.
    
    从以下版本开始:
    
    7
  - scrollTo
```
public void scrollTo(int x,
                     int y)
```
    Scrolls this ListComponent to the specified horizontal and vertical coordinates.
    
    覆盖:
    
    scrollTo 在类中 Component
    
    参数:
    
    x - Indicates the horizontal coordinate to scroll to.
    
    y - Indicates the vertical coordinate to scroll to.
    
    从以下版本开始:
    
    7
  - scrollBy
```
public void scrollBy(int x,
                     int y)
```
    Scrolls this ListComponent by a relative distance.
    
    覆盖:
    
    scrollBy 在类中 Component
    
    参数:
    
    x - Indicates the horizontal distance to scroll by.
    
    y - Indicates the vertical distance to scroll by.
    
    从以下版本开始:
    
    7
  - stopScroll
```
public void stopScroll()
```
    Stops the current scrolling.
    
    从以下版本开始:
    
    7
  - scrollByInSmoothMode
```
public void scrollByInSmoothMode(int dx,
                                 int dy)
```
    Smoothly scrolls this ListComponent by a relative distance.
    
    参数:
    
    dx - Indicates the horizontal distance to scroll by, in pixels.
    
    dy - Indicates the vertical distance to scroll by, in pixels.
    
    从以下版本开始:
    
    7
  - scrollByInSmoothMode
```
public void scrollByInSmoothMode(int dx,
                                 int dy,
                                 Animator.TimelineCurve curve)
```
    Smoothly scrolls this ListComponent by a relative distance based on a scrolling curve.
    
    参数:
    
    dx - Indicates the horizontal distance to scroll by, in pixels.
    
    dy - Indicates the vertical distance to scroll by, in pixels.
    
    curve - Indicates the scrolling curve.
    
    从以下版本开始:
    
    7
  - setItemAnimation
```
public void setItemAnimation(ItemAnimation animation)
```
    Sets an ItemAnimation object for processing the animations that take place when the provider changes.
    If this method is not called, the DefaultItemAnimation will be used.
    
    参数:
    
    animation - Indicates the ItemAnimation object to set. If this parameter is null, no animation takes place when a child component in the ListComponent is changed.
    
    从以下版本开始:
    
    7
  - getItemAnimation
```
public ItemAnimation getItemAnimation()
```
    Obtains the ItemAnimation object, which is used to process the animations that take place when the provider changes.
    
    返回:
    
    Returns the ItemAnimation object if obtained; returns null if no object has been assigned.
    
    从以下版本开始:
    
    7
  - isListAnimating
```
public boolean isListAnimating()
```
    Checks whether this ListComponent is running animations.
    
    返回:
    
    Returns true if the ListComponent is running animations; returns false otherwise.
    
    从以下版本开始:
    
    7
  - addListAdornment
```
public void addListAdornment(ListAdornment adorn,
                             int index)
```
    Adds a ListAdornment object to the specified position of this ListComponent.
    
    参数:
    
    adorn - Indicates the ListAdornment object to add.
    
    index - Indicates the position at which the ListAdornment object will be added. If this parameter is set to a negative value, the ListAdornment will be added at the end of the ListComponent.
    
    从以下版本开始:
    
    7
  - addListAdornment
```
public void addListAdornment(ListAdornment adorn)
```
    Adds a ListAdornment object at the end of this ListComponent.
    
    参数:
    
    adorn - Indicates the ListAdornment object to add.
    
    从以下版本开始:
    
    7
  - getListAdornmentAt
```
public ListAdornment getListAdornmentAt(int index)
```
    Obtains the ListAdornment object with a given index of this ListComponent.
    
    参数:
    
    index - Indicates the index of the ListAdornment object to obtain.
    
    返回:
    
    Returns the ListAdornment object.
    
    从以下版本开始:
    
    7
  - getListAdornmentCount
```
public int getListAdornmentCount()
```
    Obtains the number of ListAdornment objects in this ListComponent.
    
    返回:
    
    Returns the number of ListAdornment objects.
    
    从以下版本开始:
    
    7
  - removeListAdornmentAt
```
public void removeListAdornmentAt(int index)
```
    Removes the ListAdornment object with a given index of this ListComponent.
    
    参数:
    
    index - Indicates the index of the ListAdornment object to remove.
    
    从以下版本开始:
    
    7
  - removeListAdornment
```
public void removeListAdornment(ListAdornment decor)
```
    Removes a given ListAdornment object from this ListComponent.
    
    参数:
    
    adorn - Indicates the ListAdornment object to remove.
    
    从以下版本开始:
    
    7
  - refreshListAdornments
```
public void refreshListAdornments()
```
    Proactively refreshes the ListAdornment objects in this ListComponent.
    
    从以下版本开始:
    
    7
  - getAdornedBoundryIncludeMargin
```
public void getAdornedBoundryIncludeMargin(Component component,
                                           Rect outBounds)
```
    Obtains the boundary of a child component, including its adornments and margins.
    
    参数:
    
    component - Indicates the child component.
    
    outBounds - Indicates the rectangle used to hold the boundary.
    
    从以下版本开始:
    
    7
  - postponeLayout
```
public void postponeLayout(boolean isPostponeLayout)
```
    Sets whether to postpone layout requests of this ListComponent.
    If the layout requests are postponed, layout and scrolling will be disabled for the ListComponent.
    
    参数:
    
    isPostponeLayout - Specifies whether to postpone layout requests. The value true means to postpone the layout requests, and false means the opposite.
    
    从以下版本开始:
    
    7
  - isPostponeLayout
```
public boolean isPostponeLayout()
```
    Checks whether layout requests of this ListComponent are postponed.
    
    返回:
    
    Returns true if the layout requests are postponed; returns false otherwise.
    
    从以下版本开始:
    
    7
  - setOnFlingListener
```
public void setOnFlingListener(ListComponent.OnFlingListener listener)
```
    Sets a OnFlingListener for this ListComponent. This listener is used to observe fling events of the ListComponent.
    
    参数:
    
    listener - Indicates the OnFlingListener to set.
    
    从以下版本开始:
    
    7
  - setRecoverfocusAfterRefresh
```
public void setRecoverfocusAfterRefresh(boolean recoverFocusAfterRefresh)
```
    Sets whether this ListComponent keeps the same child component focused after a layout calculation.
    
    参数:
    
    recoverFocusAfterRefresh - Specifies whether the ListComponent keeps the same child component focused after a layout calculation. The value true means to keep the same child component focused, and false means the opposite. The default value is true.
    
    从以下版本开始:
    
    7
  - getRecoverfocusAfterRefresh
```
public boolean getRecoverfocusAfterRefresh()
```
    Checks whether this ListComponent keeps the same child component focused after a layout calculation.
    
    返回:
    
    Returns true if the ListComponent keeps the same child component focused after a layout calculation; returns false otherwise.
    
    从以下版本开始:
    
    7
  - postLayout
```
public void postLayout()
```
    从类复制的说明: Component
    
    Requests rearranging the layout of the component.
    
    指定者:
    
    postLayout 在接口中 ComponentParent
    
    覆盖:
    
    postLayout 在类中 Component
  - setReboundEffect
```
public void setReboundEffect(boolean enabled)
```
    Sets whether to enable the rebound effect.
    
    参数:
    
    enabled - Specifies whether to enable the rebound effect. The value true means to enable the rebound effect, and false means the opposite.
    
    从以下版本开始:
    
    7
  - getReboundEffect
```
public boolean getReboundEffect()
```
    Checks whether the rebound effect is enabled.
    
    返回:
    
    Returns true if the rebound effect is enabled; returns false otherwise.
    
    从以下版本开始:
    
    7
  - setReboundEffectParams
```
public void setReboundEffectParams(int overscrollPercent,
                                   float overscrollRate,
                                   int remainVisiblePercent)
```
    Sets rebound effect parameters.
    
    参数:
    
    overscrollPercent - Indicates the overscroll percent. The default value is 40.
    
    overscrollRate - Indicates the overscroll rate. The default value is 0.6.
    
    remainVisiblePercent - Indicates the minimum percent of scrollable content that should remain visible during overscrolling. The default value is 20.
    
    从以下版本开始:
    
    7
  - setReboundEffectParams
```
public void setReboundEffectParams(ListComponent.ReboundEffectParams reboundEffectParams)
```
    Sets rebound effect parameters using a ReboundEffectParams object.
    
    参数:
    
    reboundEffectParams - Indicates a ReboundEffectParams object that holds the rebound effect parameters.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    getReboundEffectParams(), setReboundEffectParams(int, float, int)
  - getReboundEffectParams
```
public ListComponent.ReboundEffectParams getReboundEffectParams()
```
    Obtains the rebound effect parameters in the form of a ReboundEffectParams object.
    
    返回:
    
    Returns the ReboundEffectParams object that holds the rebound effect parameters.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    setReboundEffectParams(ReboundEffectParams), setReboundEffectParams(int, float, int)
  - setLayoutManager
```
public void setLayoutManager(LayoutManager layoutManager)
```
    从类复制的说明: ComponentContainer
    
    Sets a LayoutManager instance, which is used to lay out relevant child components.
    
    覆盖:
    
    setLayoutManager 在类中 ComponentContainer
    
    参数:
    
    layoutManager - Indicates the layout manager to set.
  - isScrollingSmoothly
```
public boolean isScrollingSmoothly()
```
    Checks whether this ListComponent is being smoothly scrolled.
    
    返回:
    
    Returns true if the ListComponent is being smoothly scrolled; returns false otherwise.
    
    从以下版本开始:
    
    7
  - verifyLayoutConfig
```
public ComponentContainer.LayoutConfig verifyLayoutConfig(ComponentContainer.LayoutConfig config)
```
    Customizes a ListLayoutConfig object so that the ComponentOwner has the metadata of the ListLayoutManager.
    
    指定者:
    
    verifyLayoutConfig 在接口中 ComponentParent
    
    覆盖:
    
    verifyLayoutConfig 在类中 ComponentContainer
    
    参数:
    
    config - Indicates a group of layout parameters to be converted into a ComponentContainer.LayoutConfig instance.
    
    返回:
    
    Returns the ComponentContainer.LayoutConfig instance that holds the layout parameters.
    
    从以下版本开始:
    
    7
  - onBounceBackStart
```
public void onBounceBackStart(int xOverScrolled,
                              int yOverScrolled)
```
    Called when the rebound starts.
    
    参数:
    
    xOverScrolled - Indicates the distance moved in the horizontal direction.
    
    yOverScrolled - Indicates the distance moved in the vertical direction.
    
    从以下版本开始:
    
    7
  - onBounceBackChange
```
public void onBounceBackChange(int xOverScrolled,
                               int yOverScrolled)
```
    Called when the rebound is in progress.
    
    参数:
    
    xOverScrolled - Indicates the distance moved in the horizontal direction.
    
    yOverScrolled - Indicates the distance moved in the vertical direction.
    
    从以下版本开始:
    
    7
  - onBounceBackEnd
```
public void onBounceBackEnd(int xOverScrolled,
                            int yOverScrolled)
```
    Called when the rebound ends.
    
    参数:
    
    xOverScrolled - Indicates the distance moved in the horizontal direction.
    
    yOverScrolled - Indicates the distance moved in the vertical direction.
    
    从以下版本开始:
    
    7
  - addBounceBackListener
```
public void addBounceBackListener(ListComponent.BounceBackListener listener)
```
    Adds a listener for rebound state changes.
    
    参数:
    
    listener - Indicates the listener to add.
    
    从以下版本开始:
    
    7
  - removeBounceBackListener
```
public void removeBounceBackListener(ListComponent.BounceBackListener listener)
```
    Removes a listener for rebound state changes.
    
    参数:
    
    listener - Indicates the listener to remove.
    
    从以下版本开始:
    
    7
  - clearBounceBackListeners
```
public void clearBounceBackListeners()
```
    Removes all listeners for rebound state changes.
    
    从以下版本开始:
    
    7

类 ListComponent

嵌套类概要

从类继承的嵌套类/接口 ohos.agp.components.Component

从类继承的嵌套类/接口 ohos.agp.components.ComponentContainer

字段概要

从类继承的字段 ohos.agp.components.Component

从类继承的字段 ohos.agp.components.ComponentContainer

构造器概要

方法概要

从类继承的方法 ohos.agp.components.Component

从类继承的方法 ohos.agp.components.ComponentContainer

从接口继承的方法 ohos.agp.components.ComponentParent

从类继承的方法 java.lang.Object

字段详细资料

HORIZONTAL

INVALID_ID

INVALID_POSITION

INVALID_TYPE

ITEM_TYPE_NO_SCALE_MASK

ITEM_TYPE_NO_STICK_MASK

LIST_SCROLL_STATE_DRAGGING

LIST_SCROLL_STATE_IDLE

LIST_SCROLL_STATE_SETTLING

UNDEFINED_DURATION

VERTICAL

构造器详细资料

ListComponent

ListComponent

ListComponent

方法详细资料

createNativePtr

addComponent

addComponent

addComponent

addComponent

addComponent

removeComponent

removeComponentAt

removeComponentById

removeComponents

removeAllComponents

getComponentAt

getChildCount

onComponentBoundToWindow

onComponentUnboundFromWindow

setListLayoutManager

getListLayoutManager

setProvider

getProvider

setIsFixedSize

isSizeFixed

isCalculatingLayout

alignChildComponentYCoordinate

alignChildComponentXCoordinate

switchProvider

addOnComponentBoundStatusChangeListener

clearOnComponentBoundStatusChangeListener

removeOnComponentBoundStatusChangeListener

getChildProviderPosition

getChildLayoutPosition

getChildComponentId

searchComponentOwnerForLayoutPosition

searchComponentOwnerForProviderPosition

getComponentOwnerById

searchChildComponentBelowPoint

getChildComponentOwner

searchParentComponentOfChild

searchParentComponentOwnerOfChild

hasIncomingProviderRefresh

addCachePolicyListener

removeCachePolicyListener

getListCachedPool

setListCachedPool

setRequestedCacheMax

scrollToPositionInSmoothMode

fling

getMinFlingSpeed

getMaxFlingSpeed

scrollToPosition

scrollTo