java.lang.Object
|---ohos.agp.components.Component
|---|---ohos.agp.components.ComponentContainer
|---|---|---ohos.agp.components.SlideDrawer
public class SlideDrawer
extends ComponentContainer
提供 SlideDrawer 项。
此类允许显示主要组件，同时隐藏与不同方向（开始、顶部、结束和底部）相关的四个可选组件的集合。 要显示可选组件，最终用户需要从相应的方向滑动。
Since:
5
| 修饰符和类型 | 类 | 描述 |
|---|---|---|
| static class | SlideDrawer.DisplayMode | 枚举要显示的可选组件的模式。 |
| static class | SlideDrawer.DrawerState | 枚举 SlideDrawer 的可能状态。 |
| static class | SlideDrawer.LayoutConfig | 配置 SlideDrawer 的布局参数，包括宽度、高度、边距、SlideDirection 和 DisplayMode。 |
| static class | SlideDrawer.SlideDirection | 枚举可选组件相对于主组件的方向。 |
| static interface | SlideDrawer.SlideDisable | 允许实时禁用幻灯片。 |
| static interface | SlideDrawer.SlideListener | 监听 SlideDrawer 状态变化。 |
| 从类 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 |
| 修饰符和类型 | 字段 | 描述 |
|---|---|---|
| static SlideDrawer.DisplayMode | DEFAULT_DISPLAY_MODE | 指示 DisplayMode 的默认值。 |
| static float | DEFAULT_OPEN_THRESHOLD | 指示可滑动打开可选组件的默认百分比值。 |
| 从类 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, HORIZONTAL, 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, VERTICAL, VISIBLE |
| 从类 ohos.agp.components.ComponentContainer 继承的字段 |
|---|
| FOCUS_CHILDREN_FIRST, FOCUS_CHILDREN_HIDE, FOCUS_PARENT_FIRST, mArrangeListener |
| 构造函数 | 描述 |
|---|---|
| SlideDrawer(Context context) | 用于使用默认属性集和默认样式创建 SlideDrawer 实例的默认构造函数。 |
| SlideDrawer(Context context, AttrSet attrSet) | 用于在 XML 文件解析后使用指定的属性集和默认样式创建 SlideDrawer 实例的构造函数。 |
| SlideDrawer(Context context, AttrSet attrSet, String styleName) | 用于在解析 XML 文件后使用指定的属性集和指定样式创建 SlideDrawer 实例的构造函数。 |
| 修饰符和类型 | 方法 | 描述 |
|---|---|---|
| void | addSlideDisable(SlideDrawer.SlideDisable callback) | 添加允许实时禁用幻灯片事件的回调。 |
| void | addSlideListener(SlideDrawer.SlideListener listener) | 添加幻灯片侦听器。 |
| boolean | close() | 如果当前状态为 DrawerState#OPEN，则关闭 SlideDrawer。 |
| boolean | close(SlideDrawer.SlideDirection direction) | 如果当前状态为 DrawerState#OPEN 且方向参数等于 getSlideDirection() 返回的值，则在某个方向关闭 SlideDrawer。 |
| boolean | closeSmoothly() | 如果 SlideDrawer 当前状态为 DrawerState#OPEN，则平滑关闭 SlideDrawer。 |
| boolean | closeSmoothly(int interval) | 如果 SlideDrawer 当前状态为 DrawerState#OPEN，则平滑关闭 SlideDrawer。 |
| boolean | closeSmoothly(SlideDrawer.SlideDirection direction) | 如果当前状态为 DrawerState#OPEN 且方向参数等于 getSlideDirection() 返回的值，则在某个方向平滑关闭 SlideDrawer。 |
| boolean | closeSmoothly(SlideDrawer.SlideDirection direction, int interval) | 如果当前状态为 DrawerState#OPEN 且方向参数等于 getSlideDirection() 返回的值，则在某个方向平滑关闭 SlideDrawer。 |
| ComponentContainer.LayoutConfig | createLayoutConfig(Context context, AttrSet attrSet) | 使用子组件的属性集创建布局参数。 |
| SlideDrawer.DisplayMode[] | getDisplayMode() | 获取所有方向的可选组件的显示模式。 |
| SlideDrawer.DisplayMode | getDisplayMode(SlideDrawer.SlideDirection direction) | 获取可选组件在某个方向上的显示方式。 |
| float | getOpenThreshold() | 获取可以滑动打开可选组件的百分比值。 |
| SlideDrawer.SlideDirection | getSlideDirection() | 获取当前 SlideDrawer 方向。 |
| int | getSlideDistance(SlideDrawer.SlideDirection direction) | 获取某个方向的最大滑动距离。 |
| float | getSlideDistanceRatio() | 获取当前从起始位置的滑动百分比。 |
| SlideDrawer.DrawerState | getSlideState() | 获取当前 SlideDrawer 状态。 |
| boolean | hasSlideDisables() | 检查是否有任何禁用回调存储在 SlideDrawer 中。 |
| boolean | hasSlideListeners() | 检查是否有任何侦听器存储在 SlideDrawer 中。 |
| boolean | isSlideEnabled() | 检查是否启用了滑动手势。 |
| boolean | isTouchForClose() | 检查 SlideDrawer 是否可以通过触摸关闭。 |
| boolean | open() | 如果 SlideDrawer 包含仅用于单向的可选组件，则打开 SlideDrawer）。 |
| boolean | open(SlideDrawer.SlideDirection direction) | 如果 SlideDrawer 当前状态为 DrawerState#CLOSE，则朝某个方向打开 SlideDrawer。 |
| boolean | openSmoothly() | 如果 SlideDrawer 包含仅用于单向的可选组件，则平滑打开 SlideDrawer）。 |
| boolean | openSmoothly(int interval) | 如果 SlideDrawer 包含仅用于单向的可选组件，则平滑打开 SlideDrawer）。 |
| boolean | openSmoothly(SlideDrawer.SlideDirection direction) | 如果 SlideDrawer 当前状态为 DrawerState#CLOSE，则在某个方向平滑打开 SlideDrawer。 |
| boolean | openSmoothly(SlideDrawer.SlideDirection direction, int interval) | 如果 SlideDrawer 当前状态为 DrawerState#CLOSE，则在某个方向平滑打开 SlideDrawer。 |
| void | removeAllSlideDisables() | 删除所有允许实时禁用幻灯片事件的回调。 |
| void | removeAllSlideListeners() | 删除所有幻灯片侦听器。 |
| void | removeComponents(int start, int count) | 从组件列表中的指定位置移除所有组件。 |
| void | removeSlideDisable(SlideDrawer.SlideDisable callback) | 删除允许实时禁用幻灯片事件的回调。 |
| void | removeSlideListener(SlideDrawer.SlideListener listener) | 删除幻灯片侦听器。 |
| void | setDisplayMode(SlideDrawer.DisplayMode mode) | 设置所有可选组件的显示模式。 |
| void | setDisplayMode(SlideDrawer.DisplayMode startMode, SlideDrawer.DisplayMode topMode, SlideDrawer.DisplayMode endMode, SlideDrawer.DisplayMode bottomMode) | 为所有方向设置不同的显示模式。 |
| void | setDisplayMode(SlideDrawer.DisplayMode mode, SlideDrawer.SlideDirection direction) | 设置可选组件从某个方向的显示模式。 |
| void | setMaximumSlideDistance(int max) | 设置最大滑动距离。 |
| void | setOpenThreshold(float percent) | 设置可以滑动打开可选组件的百分比值。 |
| void | setSlideEnabled(boolean isEnabled) | 设置 SlideDrawer 是否可以被用户滑动。 |
| void | setTouchForClose(boolean isEnabled) | 设置 SlideDrawer 是否可以通过触摸关闭。 |
| boolean | toggle() | 在 DrawerState#OPEN 和 DrawerState#CLOSE 之间切换 SlideDrawer 状态。 |
| boolean | toggle(SlideDrawer.SlideDirection direction) | 在特定方向上切换 DrawerState#OPEN 和 DrawerState#CLOSE 之间的 SlideDrawer 状态。 |
| boolean | toggleSmoothly() | 在 DrawerState#OPEN 和 DrawerState#CLOSE 之间平滑切换 SlideDrawer 状态。 |
| boolean | toggleSmoothly(int interval) | 在 DrawerState#OPEN 和 DrawerState#CLOSE 之间平滑切换 SlideDrawer 状态。 |
| boolean | toggleSmoothly(SlideDrawer.SlideDirection direction) | DrawerState#OPEN 和 DrawerState#CLOSE 之间的 SlideDrawer 状态在某个方向上平滑切换。 |
| boolean | toggleSmoothly(SlideDrawer.SlideDirection direction, int interval) | DrawerState#OPEN 和 DrawerState#CLOSE 之间的 SlideDrawer 状态在某个方向上平滑切换。 |
| ComponentContainer.LayoutConfig | verifyLayoutConfig(ComponentContainer.LayoutConfig config) | 根据当前布局类型验证布局参数。 |
| 从类 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, postLayout, refreshContour, release, removeBindStateChangedListener, removeScrolledListener, requestFocus, requestForceForwardTouchEvent, restoreComponentTreeState, saveComponentTreeState, scrollBy, scrollTo, 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.ComponentContainer 继承的方法 |
|---|
| addComponent, addComponent, addComponent, addComponent, addComponent, dispatchRestoreState, dispatchSaveState, findComponentById, findComponentHolderById, getAutoLayout, getChildCount, getChildIndex, getComponentAt, getComponentTransition, getFocusOrder, getLayoutManager, informConfigurationChanged, isClipToChildBoundsEnabled, isClipToPaddingBoundsEnabled, isTouchEventSplitable, moveChildToFront, onDrag, removeAllComponents, removeComponent, removeComponentAt, removeComponentById, setArrangeListener, setAutoLayout, setAutoLayout, setClipToChildBoundsEnabled, setClipToPaddingBoundsEnabled, setComponentTransition, setFocusOrder, setLayoutManager, setTouchEventSplitable |
| 从接口 ohos.agp.components.ComponentParent 继承的方法 |
|---|
| getComponentParent, postLayout |
| 从类 java.lang.Object 继承的方法 |
|---|
| clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
public static final SlideDrawer.DisplayMode DEFAULT_DISPLAY_MODE
指示 DisplayMode 的默认值。
Since:
5
public static final float DEFAULT_OPEN_THRESHOLD
指示可滑动打开可选组件的默认百分比值。
Since:
5
public SlideDrawer(Context context)
用于使用默认属性集和默认样式创建 SlideDrawer 实例的默认构造函数。
参数：
| 参数名称 | 参数描述 |
|---|---|
| context | 指示应用程序上下文。 |
Since:
5
public SlideDrawer(Context context, AttrSet attrSet)
用于在 XML 文件解析后使用指定的属性集和默认样式创建 SlideDrawer 实例的构造函数。
参数：
| 参数名称 | 参数描述 |
|---|---|
| context | 指示应用程序上下文。 |
| attrSet | 指示要使用的属性集。 |
Since:
5
public SlideDrawer(Context context, AttrSet attrSet, String styleName)
用于在解析 XML 文件后使用指定的属性集和指定样式创建 SlideDrawer 实例的构造函数。
参数：
| 参数名称 | 参数描述 |
|---|---|
| context | 指示应用程序上下文。 |
| attrSet | 指示要使用的属性集。 |
| styleName | 指示要使用的样式的名称。 |
Since:
5
public void addSlideListener(SlideDrawer.SlideListener listener)
添加幻灯片侦听器。
参数：
| 参数名称 | 参数描述 |
|---|---|
| listener | 表示 SlideListener 对象，不能为空。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果侦听器值为 null，则引发此异常。 |
Since:
5
public void removeSlideListener(SlideDrawer.SlideListener listener)
删除幻灯片侦听器。
您可以使用 removeAllSlideListeners() 删除所有侦听器。
参数：
| 参数名称 | 参数描述 |
|---|---|
| listener | 表示 SlideListener 对象，不能为空。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果侦听器值为 null，则引发此异常。 |
Since:
5
public void removeAllSlideListeners()
删除所有幻灯片侦听器。
Since:
5
public boolean hasSlideListeners()
检查是否有任何侦听器存储在 SlideDrawer 中。
返回:
如果 SlideDrawer 包含任何侦听器，则返回 true； 否则返回 false。
Since:
5
public void addSlideDisable(SlideDrawer.SlideDisable callback)
添加允许实时禁用幻灯片事件的回调。
参数：
| 参数名称 | 参数描述 |
|---|---|
| callback | 表示要添加的回调。 该值不能为空。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果回调值为 null，则引发此异常。 |
Since:
5
public void removeSlideDisable(SlideDrawer.SlideDisable callback)
删除允许实时禁用幻灯片事件的回调。
您可以使用 removeAllSlideDisables() 删除所有此类回调。
参数：
| 参数名称 | 参数描述 |
|---|---|
| callback | 指示要删除的回调。 该值不能为空。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果回调值为 null，则引发此异常。 |
Since:
5
public void removeAllSlideDisables()
删除所有允许实时禁用幻灯片事件的回调。
Since:
5
public boolean hasSlideDisables()
检查是否有任何禁用回调存储在 SlideDrawer 中。
返回:
如果 SlideDrawer 包含任何禁用回调，则返回 true； 否则返回 false。
Since:
5
public void setTouchForClose(boolean isEnabled)
设置 SlideDrawer 是否可以通过触摸关闭。
参数：
| 参数名称 | 参数描述 |
|---|---|
| isEnabled | 指定 SlideDrawer 是否可以通过触摸关闭。 |
Since:
5
public boolean isTouchForClose()
检查 SlideDrawer 是否可以通过触摸关闭。
返回:
如果 SlideDrawer 可以通过触摸关闭，则返回 true； 否则返回 false。
Since:
5
public void setSlideEnabled(boolean isEnabled)
设置 SlideDrawer 是否可以被用户滑动。
参数：
| 参数名称 | 参数描述 |
|---|---|
| isEnabled | 指定是否启用滑动手势。 |
Since:
5
public boolean isSlideEnabled()
检查是否启用了滑动手势。
返回:
如果启用了滑动手势，则返回 true； 否则返回 false。
Since:
5
public void setOpenThreshold(float percent)
设置可以滑动打开可选组件的百分比值。
默认百分比值为 DEFAULT_OPEN_THRESHOLD。
参数：
| 参数名称 | 参数描述 |
|---|---|
| percent | 表示百分比值。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果百分比值小于 0.0f 或大于 1.0f，则引发此异常。 |
Since:
5
public float getOpenThreshold()
获取可以滑动打开可选组件的百分比值。
默认百分比值为 DEFAULT_OPEN_THRESHOLD。
返回:
返回百分比值。
Since:
5
public float getSlideDistanceRatio()
获取当前从起始位置的滑动百分比。
返回:
返回滑动百分比。
Since:
5
public void setMaximumSlideDistance(int max)
设置最大滑动距离。
参数：
| 参数名称 | 参数描述 |
|---|---|
| max | 表示最大滑动距离。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果参数值小于 0，则抛出此异常。 |
Since:
5
public int getSlideDistance(SlideDrawer.SlideDirection direction)
获取某个方向的最大滑动距离。
参数：
| 参数名称 | 参数描述 |
|---|---|
| direction | 指示方向。 |
返回:
返回最大滑动距离。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果方向值为空，则引发此异常。 |
Since:
5
public SlideDrawer.DrawerState getSlideState()
获取当前 SlideDrawer 状态。 状态值可以是 DrawerState#OPEN、DrawerState#MIDDLE 或 DrawerState#CLOSE。
返回:
返回当前状态。
Since:
5
public SlideDrawer.SlideDirection getSlideDirection()
获取当前 SlideDrawer 方向。 该值可以是 SlideDirection#START、SlideDirection#TOP、SlideDirection#END 或 SlideDirection#BOTTOM。 如果当前 SlideDrawer 状态不是 DrawerState#OPEN，则返回值为 null。
返回:
返回当前的 SlideDirection 或 null。
Since:
5
public void setDisplayMode(SlideDrawer.DisplayMode mode)
设置所有可选组件的显示模式。 模式可以是 DisplayMode#NO_ANIMATION 或 DisplayMode#WITH_ANIMATION。
默认模式为 DEFAULT_DISPLAY_MODE。
如果您希望仅为指定方向设置显示模式，可以使用 setDisplayMode(ohos.agp.components.SlideDrawer.DisplayMode,ohos.agp.components.SlideDrawer.SlideDirection) 方法。
您可以使用 setDisplayMode(ohos.agp.components.SlideDrawer.DisplayMode,ohos.agp.components.SlideDrawer.DisplayMode,ohos.agp.components.SlideDrawer.DisplayMode,ohos.agp.components.SlideDrawer.DisplayMode) 方法设置不同的 一次调用中所有四个方向的值。
不建议同时使用 DisplayMode#NO_ANIMATION 和 padding。
参数：
| 参数名称 | 参数描述 |
|---|---|
| mode | 表示显示模式。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果模式值为 null，则引发此异常。 |
Since:
5
public void setDisplayMode(SlideDrawer.DisplayMode mode, SlideDrawer.SlideDirection direction)
设置可选组件从某个方向的显示模式。 模式可以是 DisplayMode#NO_ANIMATION 或 DisplayMode#WITH_ANIMATION。
默认模式为 DEFAULT_DISPLAY_MODE。
您可以使用 setDisplayMode(ohos.agp.components.SlideDrawer.DisplayMode,ohos.agp.components.SlideDrawer.DisplayMode,ohos.agp.components.SlideDrawer.DisplayMode,ohos.agp.components.SlideDrawer.DisplayMode) 方法设置不同的 一次调用中所有四个方向的值。
您可以使用 setDisplayMode(ohos.agp.components.SlideDrawer.DisplayMode) 方法为所有方向设置指定的显示模式。
不建议同时使用 DisplayMode#NO_ANIMATION 和 padding。
参数：
| 参数名称 | 参数描述 |
|---|---|
| mode | 表示显示模式。 |
| direction | 指示方向。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果方向或模式值为 null，则引发此异常。 |
Since:
5
public void setDisplayMode(SlideDrawer.DisplayMode startMode, SlideDrawer.DisplayMode topMode, SlideDrawer.DisplayMode endMode, SlideDrawer.DisplayMode bottomMode)
为所有方向设置不同的显示模式。 模式可以是 DisplayMode#NO_ANIMATION 或 DisplayMode#WITH_ANIMATION。
默认模式为 DEFAULT_DISPLAY_MODE。
如果您希望仅为指定方向设置显示模式，可以使用 setDisplayMode(ohos.agp.components.SlideDrawer.DisplayMode,ohos.agp.components.SlideDrawer.SlideDirection) 方法。
您可以使用 setDisplayMode(ohos.agp.components.SlideDrawer.DisplayMode) 方法为所有方向设置指定的显示模式。
不建议同时使用 DisplayMode#NO_ANIMATION 和 padding。
参数：
| 参数名称 | 参数描述 |
|---|---|
| startMode | 指示与 SlideDirection#START 方向相关的显示模式。 |
| topMode | 指示与 SlideDirection#TOP 方向相关的显示模式。 |
| endMode | 指示与 SlideDirection#END 方向相关的显示模式。 |
| bottomMode | 指示与 SlideDirection#BOTTOM 方向相关的显示模式。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果任何模式为空，则引发此异常。 |
Since:
5
public SlideDrawer.DisplayMode getDisplayMode(SlideDrawer.SlideDirection direction)
获取可选组件在某个方向上的显示方式。
默认模式为 DEFAULT_DISPLAY_MODE。
您可以使用 getDisplayMode() 方法一次调用获取所有方向的显示模式。
参数：
| 参数名称 | 参数描述 |
|---|---|
| direction | 指示方向。 |
返回:
返回显示模式。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果方向值为空，则引发此异常。 |
Since:
5
public SlideDrawer.DisplayMode[] getDisplayMode()
获取所有方向的可选组件的显示模式。
默认模式为 DEFAULT_DISPLAY_MODE。
您可以使用getDisplayMode(ohos.agp.components.SlideDrawer.SlideDirection) 方法获取某个方向的显示模式。
返回:
返回模式数组，其中： 第一个元素（索引 0）- SlideDirection#START 方向的模式； 第二个元素（索引 1） - SlideDirection#TOP 方向的模式； 第三个元素（索引 2）- SlideDirection#BOTTOM 方向的模式； 第四个元素（索引 3）- SlideDirection#END 方向的模式。
Since:
5
public boolean open()
如果 SlideDrawer 包含仅用于单向的可选组件，则打开 SlideDrawer）。
返回:
如果操作成功，则返回 true； 否则返回 false。
Since:
5
public boolean open(SlideDrawer.SlideDirection direction)
如果 SlideDrawer 当前状态为 DrawerState#CLOSE，则朝某个方向打开 SlideDrawer。 如果 SlideDrawer 包含仅可以从一个方向与幻灯片一起显示的可选组件，则可以传递 null 作为方向以打开 SlideDrawer。
参数：
| 参数名称 | 参数描述 |
|---|---|
| direction | 方向，可以设置为null。 |
返回:
如果操作成功，则返回 true； 否则返回 false。
Since:
5
public boolean openSmoothly()
如果 SlideDrawer 包含仅用于单向的可选组件，则平滑打开 SlideDrawer）。
返回:
如果操作成功，则返回 true； 否则返回 false。
Since:
5
public boolean openSmoothly(SlideDrawer.SlideDirection direction)
如果 SlideDrawer 当前状态为 DrawerState#CLOSE，则在某个方向平滑打开 SlideDrawer。 如果 SlideDrawer 包含仅可以从一个方向与幻灯片一起显示的可选组件，则可以传递 null 作为方向以打开 SlideDrawer。
参数：
| 参数名称 | 参数描述 |
|---|---|
| direction | 方向，可以设置为null。 |
返回:
如果操作成功，则返回 true； 否则返回 false。
Since:
5
public boolean openSmoothly(int interval)
如果 SlideDrawer 包含仅用于单向的可选组件，则平滑打开 SlideDrawer）。
参数：
| 参数名称 | 参数描述 |
|---|---|
| interval | 滚动的间隔值，以毫秒为单位。 |
返回:
如果操作成功，则返回 true； 否则返回 false。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果间隔值小于 0，则抛出此异常。 |
Since:
5
public boolean openSmoothly(SlideDrawer.SlideDirection direction, int interval)
如果 SlideDrawer 当前状态为 DrawerState#CLOSE，则在某个方向平滑打开 SlideDrawer。 如果 SlideDrawer 包含仅可以从一个方向与幻灯片一起显示的可选组件，则可以传递 null 作为方向以打开 SlideDrawer。
参数：
| 参数名称 | 参数描述 |
|---|---|
| direction | 方向，可以设置为null。 |
| interval | 滚动的间隔值，以毫秒为单位。 |
返回:
如果操作成功，则返回 true； 否则返回 false。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果间隔值小于 0，则抛出此异常。 |
Since:
5
public boolean close()
如果当前状态为 DrawerState#OPEN，则关闭 SlideDrawer。
返回:
如果操作成功，则返回 true； 否则返回 false。
Since:
5
public boolean close(SlideDrawer.SlideDirection direction)
如果当前状态为 DrawerState#OPEN 且方向参数等于 getSlideDirection() 返回的值，则在某个方向关闭 SlideDrawer。 无论如何，您都可以传递 null 作为关闭 SlideDrawer 的方向。
参数：
| 参数名称 | 参数描述 |
|---|---|
| direction | 方向，可以设置为null。 |
返回:
如果操作成功，则返回 true； 否则返回 false。
Since:
5
public boolean closeSmoothly()
如果 SlideDrawer 当前状态为 DrawerState#OPEN，则平滑关闭 SlideDrawer。
返回:
如果操作成功，则返回 true； 否则返回 false。
Since:
5
public boolean closeSmoothly(SlideDrawer.SlideDirection direction)
如果当前状态为 DrawerState#OPEN 且方向参数等于 getSlideDirection() 返回的值，则在某个方向平滑关闭 SlideDrawer。 无论如何，您都可以传递 null 作为关闭 SlideDrawer 的方向。
参数：
| 参数名称 | 参数描述 |
|---|---|
| direction | 方向，可以设置为null。 |
返回:
如果操作成功，则返回 true； 否则返回 false。
Since:
5
public boolean closeSmoothly(int interval)
如果 SlideDrawer 当前状态为 DrawerState#OPEN，则平滑关闭 SlideDrawer。
参数：
| 参数名称 | 参数描述 |
|---|---|
| interval | 滚动的间隔值，以毫秒为单位。 |
返回:
如果操作成功，则返回 true； 否则返回 false。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果间隔值小于 0，则抛出此异常。 |
Since:
5
public boolean closeSmoothly(SlideDrawer.SlideDirection direction, int interval)
如果当前状态为 DrawerState#OPEN 且方向参数等于 getSlideDirection() 返回的值，则在某个方向平滑关闭 SlideDrawer。 无论如何，您都可以传递 null 作为关闭 SlideDrawer 的方向。
参数：
| 参数名称 | 参数描述 |
|---|---|
| direction | 方向，可以设置为null。 |
| interval | 滚动的间隔值，以毫秒为单位。 |
返回:
如果操作成功，则返回 true； 否则返回 false。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果间隔值小于 0，则抛出此异常。 |
Since:
5
public boolean toggle()
在 DrawerState#OPEN 和 DrawerState#CLOSE 之间切换 SlideDrawer 状态。
返回:
如果操作成功，则返回 true； 否则返回 false。
Since:
5
public boolean toggle(SlideDrawer.SlideDirection direction)
在特定方向上切换 DrawerState#OPEN 和 DrawerState#CLOSE 之间的 SlideDrawer 状态。 如果 SlideDrawer 包含仅可以从一个方向与幻灯片一起显示的可选组件，则可以传递 null 作为方向以切换 SlideDrawer 状态。
参数：
| 参数名称 | 参数描述 |
|---|---|
| direction | 方向，可以设置为null。 |
返回:
如果操作成功，则返回 true； 否则返回 false。
Since:
5
public boolean toggleSmoothly()
在 DrawerState#OPEN 和 DrawerState#CLOSE 之间平滑切换 SlideDrawer 状态。
返回:
如果操作成功，则返回 true； 否则返回 false。
Since:
5
public boolean toggleSmoothly(SlideDrawer.SlideDirection direction)
DrawerState#OPEN 和 DrawerState#CLOSE 之间的 SlideDrawer 状态在某个方向上平滑切换。 如果 SlideDrawer 包含仅可以从一个方向与幻灯片一起显示的可选组件，则可以传递 null 作为方向以切换 SlideDrawer 状态。
参数：
| 参数名称 | 参数描述 |
|---|---|
| direction | 方向，可以设置为null。 |
返回:
如果操作成功，则返回 true； 否则返回 false。
Since:
5
public boolean toggleSmoothly(int interval)
在 DrawerState#OPEN 和 DrawerState#CLOSE 之间平滑切换 SlideDrawer 状态。
参数：
| 参数名称 | 参数描述 |
|---|---|
| interval | 滚动的间隔值，以毫秒为单位。 |
返回:
如果操作成功，则返回 true； 否则返回 false。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果间隔值小于 0，则抛出此异常。 |
Since:
5
public boolean toggleSmoothly(SlideDrawer.SlideDirection direction, int interval)
DrawerState#OPEN 和 DrawerState#CLOSE 之间的 SlideDrawer 状态在某个方向上平滑切换。 如果 SlideDrawer 包含仅可以从一个方向与幻灯片一起显示的可选组件，则可以传递 null 作为方向以切换 SlideDrawer 状态。
参数：
| 参数名称 | 参数描述 |
|---|---|
| direction | 方向，可以设置为null。 |
| interval | 滚动的间隔值，以毫秒为单位。 |
返回:
如果操作成功，则返回 true； 否则返回 false。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果间隔值小于 0，则抛出此异常。 |
Since:
5
public ComponentContainer.LayoutConfig verifyLayoutConfig(ComponentContainer.LayoutConfig config)
根据当前布局类型验证布局参数。
指定者：
接口 ComponentParent 中的 verifyLayoutConfig
覆盖：
ComponentContainer 类中的 verifyLayoutConfig
参数：
| 参数名称 | 参数描述 |
|---|---|
| config | 指示要转换为 ComponentContainer 实例的一组布局参数。 |
返回:
返回 LayoutConfig 实例，它表示布局参数。
public ComponentContainer.LayoutConfig createLayoutConfig(Context context, AttrSet attrSet)
使用子组件的属性集创建布局参数。
覆盖：
ComponentContainer 类中的 createLayoutConfig
参数：
| 参数名称 | 参数描述 |
|---|---|
| context | 指示应用程序上下文。 |
| attrSet | 表示属性集。 |
返回:
返回创建的布局参数。
public void removeComponents(int start, int count)
从组件列表中的指定位置移除所有组件。
指定者：
接口 ComponentParent 中的 removeComponents
覆盖：
ComponentContainer 类中的 removeComponents
参数：
| 参数名称 | 参数描述 |
|---|---|
| start | 表示第一个移除的组件的位置索引。 |
| count | 表示要移除的组件数量。 |