创新互联鸿蒙OS教程:鸿蒙OSComponent

Component

java.lang.Object

|---ohos.agp.components.Component

public class Component
extends Object

为用户界面 (UI) 提供基本组件。

每个组件在屏幕上占据一个矩形区域,负责在这个区域内进行绘制和事件处理。 Component 是控件的基类,用于创建交互式 UI 组件。 它的子类 ComponentContainer 是所有布局的基类,它定义了其他组件或组件组的布局属性。

嵌套类摘要

修饰符和类型 描述
static interface Component.BindStateChangedListener 提供当组件绑定到其窗口或从其窗口分离时要调用的回调。
static interface Component.CanAcceptScrollListener 提供要调用的侦听器来决定是否可以接受滚动手势。
static interface Component.ClickedListener 提供单击组件时要调用的回调。
static interface Component.ComponentStateChangedListener 为组件的状态更改事件提供回调。
static interface Component.ContourRefreshedListener 为用于为组件设置自定义 Contour 对象的回调提供侦听器。
static class Component.DefSpeechEventListener 提供在语音事件绑定到组件时调用的默认回调。
static interface Component.DoubleClickedListener 提供双击组件时要调用的回调。
static class Component.DragFeedbackProvider 提供系统在拖放操作期间显示的图像(称为“拖动阴影”)。
static interface Component.DraggedListener 提供当手势识别器将拖动事件分派到组件时要调用的回调。
static interface Component.DrawTask 实现绘图任务。
static interface Component.EditEventListener 提供侦听器来处理由键盘快捷键触发的编辑事件,当它们分发到组件时。
static interface Component.EstimateSizeListener 提供用于自定义尺寸(宽度/高度)估计过程的界面。
static class Component.EstimateSpec 定义组件的度量规范。
static class Component.FadeEffectEnum 枚举可以应用淡出效果的组件指示器的类型。
static interface Component.FocusChangedListener 提供当组件的焦点状态更改时要调用的回调。
static interface Component.ForwardHoverListener 提供在鼠标悬停事件转发到子组件之前调用的回调。
static interface Component.ForwardTouchListener 在将触摸事件转发到子组件之前提供要调用的回调。
static class Component.GestureType 枚举手势类型。
static interface Component.HoverEventListener 提供从组件调度悬停事件时要调用的回调。
static interface Component.KeyEventListener 提供从组件调度键事件时要调用的回调。
static class Component.LayoutDirection 枚举水平布局方向。
static interface Component.LayoutRefreshedListener 提供在再次布局组件时调用的回调。
static interface Component.LongClickedListener 提供从组件分派长触摸事件时要调用的回调。
static class Component.MeasureSpec 已弃用。 此更改自 API 版本 6 起生效。已替换为 EstimateSpec
static interface Component.MouseEventListener 提供从组件分派鼠标事件时要调用的回调。
static interface Component.MousePointerStyleListener 提供一个监听器来观察鼠标指针样式的变化。
static interface Component.OnDragListener 将拖动事件分派到组件时调用的回调。
static interface Component.RotationEventListener 提供从组件分派旋转事件时要调用的回调。
static interface Component.ScaledListener 为组件的缩放事件提供回调。
static interface Component.ScrolledListener 提供从组件分派滚动事件时要调用的回调。
static class Component.ShadowDevice 表示窗口的阴影设备。
static class Component.ShadowMode 指示窗口的阴影模式。
static class Component.ShadowSize 指示窗口的阴影大小。
static interface Component.SpeechEventListener 提供当语音事件绑定到组件时要调用的回调。
static interface Component.TouchEventListener 提供在将触摸事件分派到组件时要调用的回调。
static interface Component.UnconsumedKeyEventListener 如果键盘事件没有被使用,则提供一个侦听器来调度键盘事件。
static class Component.VoiceEvent 为组件提供语音事件。

字段摘要

修饰符和类型 字段 描述
static int ACCESSIBILITY_ADAPTABLE 表示可以访问该组件。
static int ACCESSIBILITY_DISABLE 表示无法访问该组件。
static int ACCESSIBILITY_ENABLE 表示该组件已启用。
static int AXIS_X 表示 x 轴。
static int AXIS_Y 表示 y 轴。
static Component.ContourRefreshedListener CONTOUR_BACKGROUND 组件的默认 ContourRefreshedListener。
static Component.ContourRefreshedListener CONTOUR_BORDER 提供与组件矩形边框匹配的轮廓。
static Component.ContourRefreshedListener CONTOUR_PADDING_BORDER 提供与组件的矩形填充边框匹配的轮廓。
static float DEFAULT_SCALE 表示缩放组件的默认缩放系数。
static int DRAG_DOWN 表示向下拖动滚动条。
static int DRAG_HORIZONTAL 表示水平拖动滚动条。
static int DRAG_HORIZONTAL_VERTICAL 表示滚动条水平和垂直拖动。
static int DRAG_LEFT 表示向左拖动滚动条。
static int DRAG_RIGHT 表示向右拖动滚动条。
static int DRAG_UP 表示向上拖动滚动条。
static int DRAG_VERTICAL 表示垂直拖动滚动条。
static int EVENT_TYPE_COMPONENT_ACCESSIBILITY_FOCUSED 表示一个事件,指示获得了可访问性焦点。
static int EVENT_TYPE_COMPONENT_ACCESSIBILITY_FOCUSED_CLEAR 表示一个事件,指示清除辅助功能焦点。
static int EVENT_TYPE_COMPONENT_CLICKED 表示一个指示组件被单击的事件。
static int EVENT_TYPE_COMPONENT_FOCUSED 表示一个指示组件获得焦点的事件。
static int EVENT_TYPE_COMPONENT_LONG_CLICKED 表示一个指示组件被长按的事件。
static int EVENT_TYPE_COMPONENT_SCROLLED 表示一个指示组件滚动的事件。
static int EVENT_TYPE_COMPONENT_SELECTED 表示一个指示组件被选中的事件。
static int EVENT_TYPE_COMPONENT_TEXT_UPDATE 表示指示 Text 组件中的文本已更改的事件。
static int EVENT_TYPE_NOTICE 表示指示应用程序发送通知的事件。
static int EVENT_TYPE_NOTIFICATION_STATE_UPDATE 表示指示显示通知的事件。
static int EVENT_TYPE_TOAST_SHOW 表示指示显示 toast 的事件。
static int EVENT_TYPE_WINDOW_STATE_UPDATE 表示指示窗口状态已更新的事件。
static int FOCUS_ADAPTABLE 组件自行决定可聚焦性。
static int FOCUS_DISABLE 该组件不需要击键。
static int FOCUS_ENABLE 该组件需要击键。
static int FOCUS_NEXT 将焦点移至下一个可点击项目。
static int FOCUS_PREVIOUS 将焦点移到上一个可点击项目。
static int FOCUS_SIDE_BOTTOM 向下移动焦点。
static int FOCUS_SIDE_LEFT 将焦点移到左侧。
static int FOCUS_SIDE_RIGHT 将焦点向右移动。
static int FOCUS_SIDE_TOP 上移焦点。
static int HIDE 该组件是不可见的,并且不占用任何用于布局目的的空间。
static int HORIZONTAL 表示水平方向模式。
static int ID_DEFAULT 组件的默认 ID。
static int INHERITED_MODE 表示组件使用其父组件的显示模式。
static int INVISIBLE 该组件是不可见的,但仍为布局目的占用空间。
protected Element mBackgroundElement 表示在组件背景中绘制的元素对象。
protected Canvas mCanvasForTaskOverContent 用于内容和前景之间的自定义绘图任务的画布。
protected Canvas mCanvasForTaskUnderContent 用于背景和内容之间的自定义绘图任务的画布。
protected ComponentParent mComponentParent 指示组件的父布局。
protected Context mContext 表示上下文。
protected Component.DrawTask mDrawTaskOverContent 自定义内容和前景之间的绘图任务。
protected Component.DrawTask mDrawTaskUnderContent 自定义内容和背景之间的绘图任务。
protected Component.EstimateSizeListener mEstimateSizeListener 在组件估计尺寸过程中自定义组件的宽度和高度
protected Element mForegroundElement 表示在组件前景中绘制的元素对象。
protected Component.ForwardHoverListener mForwardHoverListener 表示转发鼠标悬停事件时调用的回调。
protected Component.HoverEventListener mHoverEventListener 表示接收到鼠标悬停事件时调用的回调。
protected Component.KeyEventListener mKeyEventListener 表示当焦点组件接收到键事件时调用的回调。
protected Component.MouseEventListener mMouseEventListener 表示接收到鼠标事件时调用的回调。
protected float[] mPosition 为位置创建浮点值。
protected Component.RotationEventListener mRotationEventListener 表示接收旋转事件时调用的回调。
protected ShadowElement mShadowElement 表示以组件的 shadowstyle 绘制的元素对象。
protected Component.UnconsumedKeyEventListener mUnconsumedKeyEventListener 表示接收到未使用的按键事件时调用的回调。
static int OVAL_MODE 表示组件内容以椭圆显示。
static int OVAL_SCROLL_BAR_MODE 表示滚动条显示为椭圆。
protected static int POSITION_X_INDEX 位置数组中的 X 轴坐标。
protected static int POSITION_Y_INDEX 位置数组中的 Y 轴坐标。
static int RECT_MODE 表示组件内容以矩形显示。
static int RECT_SCROLL_BAR_MODE 指示滚动条显示为矩形。
static int SCROLL_AUTO_STAGE 表示组件会惯性滚动以响应专用操作(例如,甩动或反弹)。
static int SCROLL_IDLE_STAGE 表示滚动已经结束,组件处于空闲状态。
static int SCROLL_NORMAL_STAGE 表示组件响应外部操作(例如,用户触摸输入)自然滚动。
static int UNSPECIFIED_SCROLL_BAR_MODE 指示滚动条的模式遵循显示组件的模式。
static int VERTICAL 指示垂直方向模式。
static int VISIBLE 该组件是可见的。

构造函数摘要

构造函数 描述
Component(Context context) 默认构造函数用于使用默认属性集和样式创建 Component 实例。
Component(Context context, AttrSet attrSet) 一个构造函数,用于在解析 XML 文件后使用指定的属性集和默认样式创建一个 Component 实例。
Component(Context context, AttrSet attrSet, int resId) 用于在 XML 文件解析后根据上下文、属性集和默认主题创建 Component 实例的构造函数。
Component(Context context, AttrSet attrSet, String styleName) 一个构造函数,用于在解析 XML 文件后,使用指定的属性集和指定的样式创建一个 Component 实例。

方法总结

修饰符和类型 方法 描述
void addDrawTask(Component.DrawTask task) 在前景和组件内容之间添加绘图任务。
void addDrawTask(Component.DrawTask task, int layer) 添加绘图任务。
void addScrolledListener(Component.ScrolledListener listener) 添加一个监听器来监听组件的滚动阶段或位置发生变化时报告的滚动事件。
void announceAccessibility(String text) 为 TYPE_ANNOUNCEMENT 类型的可访问性事件设置文本。
void arrange(int left, int top, int width, int height) 相对于父布局定位组件。
CornerMark bindCornerMark() 将角标记对象设置为显示在组件顶部。
boolean callOnClick() 调用分配的 OnClickListener。
boolean canScroll(int orientation) 检查组件是否可以按指定方向滚动。
void clearFocus() 请求放弃焦点。
AnimatorProperty createAnimatorProperty() 创建与组件关联的属性动画器对象。
void disableFadeEffect(Component.FadeEffectEnum fadeEffectEnum) 当组件未滚动时,禁用滚动条或边界指示器的淡出效果。
protected void dispatchRestoreState(PlainArraySequenceable stateContainer) 分发状态恢复过程来恢复该组件及其子组件的状态。
protected void dispatchSaveState(PlainArraySequenceable stateContainer) 分发状态保存过程,保存该组件及其子组件的状态。
void draw(Canvas canvas) 在画布上绘制此组件及其子组件。
void enableCornerMark(boolean enable) 启用或禁用当前组件的角标记。
void enableFadeEffect(Component.FadeEffectEnum fadeEffectEnum) 当组件未滚动时,启用滚动条或边界指示器的淡出效果。
void enableSaveState(boolean isEnabled) 设置此组件及其子组件是否可以保存其状态。
void enableScrollBar(int direction, boolean enabled) 设置是否为此组件启用滚动条。
void estimateSize(int widthEstimatedConfig, int heightEstimatedConfig) 设置组件的宽度和高度尺寸和要求
boolean executeDoubleClick() 执行此组件中发生的双击事件。
boolean executeLongClick() 在组件中执行长按事件。
T findComponentById(int id) 查找具有给定 ID 的组件。
ComponentHolder findComponentHolderById(int resId) 使用资源 ID 获取 ComponentHolder 实例。
Component findFocus() 获取当前在其后代组件和自身中具有焦点的组件。
Component findNextFocusableComponent(int direction) 查找下一个要关注的组件。
boolean findRequestNextFocus(int side) 找到下一个获得焦点的组件并为其请求焦点。
int getAccessibility() 获取可访问性状态。
String getAccessibilityDescription() 获取该组件的可访问性描述。
float getAlpha() 获取组件的 alpha 值。
float getAltitude() 获取该组件在垂直于屏幕方向的基本深度位置。
Element getBackgroundElement() 获取组件背景中的元素。
int getBaseLine() 获取从文本基线到组件顶部的高度。
int getBottom() 获取组件相对于父布局的底部边缘位置。
float getBoundaryFadeEffectBottomRate() 获得率乘以基本边界宽度,得到组件淡化效果区域的底部边界宽度。
float getBoundaryFadeEffectLeftRate() 获取速率乘以基本边界宽度,得到组件淡化效果区域的左边界宽度。
float getBoundaryFadeEffectRightRate() 获取速率乘以基本边界宽度,得到组件淡化效果区域的右边界宽度。
float getBoundaryFadeEffectTopRate() 获取速率乘以基本边界宽度,得到组件淡化效果区域的顶部边界宽度。
float[] getCenterZoomFactor() 获取缩放中心组件项的缩放系数。
boolean getCentralScrollMode() 获取中央滚动模式的状态。
Component.ClickedListener getClickedListener() 获取监听该组件点击事件的监听器。
boolean getClipEnabled() 检查此组件超出其父布局时是否启用自动剪裁。
CharSequence getComponentDescription() 获取组件中内容的描述。
DimensFloat getComponentMinSize() 获取此组件的可能最小大小。
ComponentParent getComponentParent() 获取组件的父布局。
Rect getComponentPosition() 获取组件相对于父布局的位置。
DimensFloat getComponentSize() 获取组件大小。
Component.ComponentStateChangedListener getComponentStateChangedListener() 获取监听该组件状态变化的监听器。
ComponentTreeObserver getComponentTreeObserver() 获取组件的 ComponentTreeObserver。
boolean getContentEnable() 获取组件的内容是否会被绘制。
float[] getContentPosition() 绘制时获取位置。
float getContentPositionX() 获取 X 轴坐标。
float getContentPositionY() 获取 Y 轴坐标。
Context getContext() 获取该组件持有的上下文对象。
Contour getContour() 获取当前组件的 Contour 对象。
Component.ContourRefreshedListener getContourRefreshedListener() 获取对组件的 Contour 对象进行更新的侦听器。
CornerMark getCornerMark() 获取组件的角标对象。
float getDragAcceptAngle() 获取为水平或垂直拖动识别器设置的偏转角。
Component.DraggedListener getDraggedListener() 获取监听该组件拖动事件的监听器。
Component.EditEventListener getEditEventListener() 获取监听由键盘快捷键触发并分发给该组件的编辑事件的监听器。
int getEstimatedHeight() 返回组件的估计高度。
int getEstimatedWidth() 返回组件的估计宽度。
int getFadeEffectBoundaryWidth() 获取组件淡化效果区域的边界宽度。
Color getFadeEffectColor() 获取产生淡入淡出效果时显示的颜色。
int getFocusable() 获取组件的可聚焦设置。
boolean getFocusBorderEnable() 检查当该组件处于焦点时是否显示焦点边框。
int getFocusBorderPadding() 获取焦点边框和此组件之间的填充。
float[] getFocusBorderRadius() 获取焦点边界的四个角的半径。
int getFocusBorderWidth() 获取焦点边框的宽度。
Element getForegroundElement() 获取组件前景中的元素。
int getForegroundGravity() 已弃用。 此更改从 API 版本 6 开始生效。此方法是多余的,因此已弃用。
Component.ForwardHoverListener getForwardHoverListener() 获取该组件向前鼠标悬停事件的监听器。
Component.ForwardTouchListener getForwardTouchListener() 获取该组件前向触摸事件的监听器。
int getGesturePriority(Component.GestureType gestureType) 获取手势的优先级。
int getHeight() 获取组件的高度。
int[] getHorizontalPadding() 获取此组件的水平填充。
int[] getHorizontalPosition() 获取组件相对于父布局的水平位置。
Component.HoverEventListener getHoverEventListener() 获取监听该组件悬停事件的监听器。
int getId() 获取组件的唯一标识。
Component.KeyEventListener getKeyEventListener() 获取监听该组件关键事件的监听器。
ComponentContainer.LayoutConfig getLayoutConfig() 获取与组件关联的布局参数。
Component.LayoutDirection getLayoutDirection() 获取该组件的布局方向。
Component.LayoutDirection getLayoutDirectionResolved() 获取该组件的解析布局方向。
Component.LayoutRefreshedListener getLayoutRefreshedListener() 获取监听该组件布局刷新的监听器。
int getLeft() 获取组件相对于父布局的左边缘位置。
int[] getLocationOnScreen() 获取组件在屏幕上的绝对位置。
int getMarginBottom() 获取该组件的下边距。
int getMarginLeft() 获取该组件的左边距。
int getMarginRight() 获取该组件的右边距。
int[] getMargins() 获取此组件的左、上、右和下边距。
int[] getMarginsLeftAndRight() 获取该组件的水平边距。
int[] getMarginsTopAndBottom() 获取该组件的垂直边距。
int getMarginTop() 获取该组件的上边距。
Matrix getMatrix() 获取当前组件的转换矩阵。
int getMinHeight() 获取组件的最小可能高度。
int getMinWidth() 获取组件的最小可能宽度。
int getMode() 获取该组件的显示方式。
int getModeResolved() 获取持有该组件的设备的显示模式。
Component.MouseEventListener getMouseEventListener() 获取监听该组件鼠标事件的监听器。
Component.MousePointerStyleListener getMousePointerStyleListener() 获取鼠标指针样式更改的侦听器。
String getName() 获取组件的名称。
int[] getPadding() 获取该组件的内边距。
int getPaddingBottom() 获取组件的底部填充。
int getPaddingEnd() 根据解析的布局方向获取组件的结束填充。
int getPaddingLeft() 获取组件的左内边距。
int getPaddingRight() 获取组件的正确填充。
int getPaddingStart() 根据解析的布局方向获取组件的开始填充。
int getPaddingTop() 获取组件的顶部填充。
Point getPivot() 获取相对于父布局的枢轴。
float getPivotX() 获取组件旋转缩放所围绕的点,即轴心点的X轴坐标。
float getPivotY() 获取枢轴点相对于父布局的 Y 轴坐标。
ResourceManager getResourceManager() 获取与上下文关联的资源管理器。
int getRight() 获取组件相对于父布局的右边缘位置。
float getRotation() 获取组件相对于父布局绕 Z 轴旋转的度数。
Component.RotationEventListener getRotationEventListener() 获取监听该组件旋转事件的监听器。
float getRotationSensitivity() 获取组件的旋转灵敏度。
DimensFloat getScale() 获取组件相对于父布局的枢轴周围的比例因子。
Component.ScaledListener getScaledListener() 获取监听该组件缩放事件的监听器。
float getScaleX() 获取组件在 X 方向上相对于父布局的枢轴点的缩放因子。
float getScaleY() 获取组件在 Y 方向上相对于父布局的枢轴点的缩放因子。
Color getScrollbarBackgroundColor() 获取滚动条的背景颜色。
Color getScrollbarColor() 获取滚动条的颜色。
int getScrollbarFadingDelay() 获取滚动条消失之前的延迟。
int getScrollbarFadingDuration() 获取滚动条的淡出持续时间。
int getScrollBarMode() 获取正在显示的滚动条的模式。
float getScrollbarRadius() 获取滚动条圆角边框的半径。
boolean getScrollbarRoundRect() 获取滚动条的圆角边框。
float getScrollbarStartAngle() 获取圆形滚动条的起始角度。
float getScrollbarSweepAngle() 获取圆形滚动条的扫角。
int getScrollbarThickness() 获取滚动条的粗细。
int getScrollState() 获取组件滚动状态。
int getScrollValue(int direction) 获取该组件的滚动偏移量。
boolean getSelfVisibleRect(Rect rect) 允许获取本地可见的 Rect(与组件的父级相关)
Color getShadowColor() 获取组件的阴影颜色。
Component.SpeechEventListener getSpeechEventListener() 获取 setSpeechEventListener(ohos.agp.components.Component.SpeechEventListener) 设置的监听器。
Object getTag() 获取组件的标签。
int getTop() 获取组件相对于父布局的上边缘位置。
Component.TouchEventListener getTouchEventListener() 获取监听该组件触摸事件的监听器。
String getTransitionSymbol() 获取过渡符号。
DimensFloat getTranslation() 获取组件相对于其左边界的水平平移和相对于其上边界的垂直平移。
float getTranslationX() 获取组件相对于其左侧位置的水平平移。
float getTranslationY() 获取组件相对于其顶部位置的垂直平移。
float getTranslationZ() 获取该组件在垂直于屏幕方向的深度位置变化。
int getUserNextFocus(int side) 获取下一个要关注的组件的 ID。
int[] getVerticalPadding() 获取此组件的垂直填充。
int[] getVerticalPosition() 获取组件相对于父布局的位置。
int getVisibility() 获取组件的可见性。
boolean getVisibleRectOnScreen(Rect rect, int[] position) 获取组件相对于屏幕左上角的可见矩形区域。
int getWidth() 获取组件的宽度。
boolean getWindowVisibleRect(Rect visibleRect) 获取组件所在窗口的可见矩形。
boolean hasFocus() 返回组件是否有焦点。
boolean hasFocusedEffect() 检查该组件获得焦点时是否显示焦点效果。
boolean hasOverlaps() 检查此组件是否有重叠内容。
void hideFocusBorder() 已弃用。 此更改自 API 版本 8 起生效。此方法是多余且临时的,因此已弃用。
void informConfigurationChanged(Configuration config) 调度配置更改事件。
void invalidate() 使组件无效。
boolean isBoundaryFadeEffectEnable() 已弃用。 此更改从 API 版本 6 开始生效。替换为 isFadeEffected(FadeEffectEnum)
boolean isBoundToWindow() 检查组件是否已绑定到窗口。
boolean isClickable() 返回组件是否响应点击事件。
boolean isClipToContourEnabled() 检查组件的 Contour 对象是否可用于内容剪辑。
boolean isComponentDisplayed() 检查组件是否可以显示。
boolean isEnabled() 获取组件的启用状态。
boolean isFadeEffected(Component.FadeEffectEnum fadeEffectEnum) 检查是否为滚动条或边界指示器启用了淡出效果。
boolean isFocusable() 返回组件当前是否可以接收焦点。
boolean isFocused() 返回组件是否已获得焦点。
boolean isIdentityMatrix() 检查当前组件的转换矩阵是否为单位矩阵。
boolean isLongClickOn() 返回组件是否可长时间点击。
boolean isPressed() 返回组件当前是否处于按下状态。
boolean isRtl() 检查组件是否从右到左布局。
boolean isSaveStateEnabled() 检查此组件及其子组件是否可以保存其状态。
boolean isScrollbarFadingOn() 已弃用。 此更改从 API 版本 6 开始生效。替换为 isFadeEffected(FadeEffectEnum)
boolean isScrollBarOn(int direction) 检查是否为此组件启用了滚动条。
boolean isScrollbarOverlapEnabled() 检查滚动条是否与内容重叠。
boolean isSelected() 获取组件的选择状态。
boolean isSoundEnable() 检查单击此组件时是否播放声音。
boolean isTouchFocusable() 返回组件是否可以在触摸模式下接收焦点。
boolean isVibrationEffectEnabled() 检查是否启用了振动效果。
void notifyAccessibility(int eventType) 触发此组件指定的可访问性事件。
protected void onAttributeConfigChanged(Configuration config) 更改配置时调用。
boolean onDrag(Component component, DragEvent event) 在将拖动事件分派到组件时调用。
protected void onRestoreState(Sequenceable state) 当要恢复此组件及其子组件的状态时调用。
protected void onRtlChanged(Component.LayoutDirection layoutDirection) 在更改任何 RTL 属性时调用。
protected Sequenceable onSaveState() 当要保存此组件及其子组件的状态时调用。
boolean performScale() 在组件中执行缩放事件。
void playSound(int soundId) 播放此组件的声音。
void postLayout() 请求重新排列组件的布局。
void refreshContour() 刷新组件的当前 Contour 对象并触发 ContourRefreshedListener#onContourRefreshed(Component) 用于设置自定义 Contour 对象。
void release() 释放资源。
void removeBindStateChangedListener(Component.BindStateChangedListener listener) 删除绑定状态更改的侦听器。
void removeScrolledListener(Component.ScrolledListener listener) 删除一个监听滚动事件的监听器。
boolean requestFocus() 请求当前组件或其子组件之一的焦点。
void requestForceForwardTouchEvent(boolean forceForward) 当组件希望此父级及其祖先继续转发触摸事件时调用。
void restoreComponentTreeState(PlainArraySequenceable stateContainer) 从给定容器中恢复此组件及其子组件的状态。
void saveComponentTreeState(PlainArraySequenceable stateContainer) 将此组件及其子组件的状态保存到给定容器中。
void scrollBy(int x, int y) 设置组件滚动的偏移量。
void scrollTo(int x, int y) 设置您希望组件滚动到的目标位置。
void setAccessibility(int flag) 设置可访问性状态。
void setAccessibilityDescription(String description) 设置此组件的可访问性模式的描述。
void setAlpha(float alpha) 设置组件的 alpha 值。
void setAltitude(float altitude) 设置此组件在垂直于屏幕的方向上的基本深度位置。
void setBackground(Element element) 将指定元素设置为组件的背景。
void setBindStateChangedListener(Component.BindStateChangedListener listener) 添加绑定状态更改的侦听器。
void setBottom(int bottom) 设置组件相对于父容器的底部边缘位置。
void setBoundaryFadeEffectEnable(boolean enable) 已弃用。 此更改从 API 版本 6 开始生效。替换为 enableFadeEffect(FadeEffectEnum) 或 disableFadeEffect(FadeEffectEnum)
void setCanAcceptScrollListener(Component.CanAcceptScrollListener listener)
void setCenterZoomFactor(float scaleX, float scaleY) 设置缩放中心组件项目的缩放系数。
void setCentralScrollMode(boolean centralMode) 设置是否启用中央滚动模式以始终在组件中心显示组件项。
void setClickable(boolean clickable) 启用或禁用组件的点击事件。
void setClickedListener(Component.ClickedListener listener) 为组件中的点击事件注册一个监听器。
void setClipEnabled(boolean enabled) 设置是否允许在组件超出其父布局时自动裁剪。
void setClipToContourEnabled(boolean enable) 设置组件的 Contour 对象是否可用于内容裁剪。
void setComponentDescription(CharSequence componentDescription) 设置组件中内容的描述。
void setComponentMinSize(int minWidth, int minHeight) 设置此组件的最小可能宽度和高度。
void setComponentPosition(int left, int top, int right, int bottom) 设置组件相对于父容器的位置。
void setComponentPosition(Rect rect) 根据 rect 设置组件相对于父容器的位置。
void setComponentSize(int width, int height) 设置组件大小。
void setComponentStateChangedListener(Component.ComponentStateChangedListener listener) 设置组件状态更改事件的侦听器。
void setContentEnable(boolean enable) 设置是否为组件绘制内容。
void setContentPosition(float x, float y) 设置绘图和事件监听的位置。
void setContentPositionX(float x) 设置绘图和事件监听的 x 坐标。
void setContentPositionY(float y) 设置绘图和事件监听的 y 坐标。
void setContour(Contour contour) 为组件设置自定义轮廓对象。
void setContourRefreshedListener(Component.ContourRefreshedListener listener) 注册一个侦听器以获取组件的 Contour 对象的更新。
void setDoubleClickedListener(Component.DoubleClickedListener listener) 注册监听该组件的双击事件。
void setDragAcceptAngle(float degree) 设置水平或垂直拖动识别器的偏转角度。
void setDraggedListener(int dragMode, Component.DraggedListener listener) 为组件的拖动事件注册一个监听器。
void setEditEventListener(Component.EditEventListener listener) 注册一个侦听器以观察由键盘快捷键触发并分发到此组件的编辑事件。
void setEnabled(boolean enabled) 设置组件的启用状态。
protected void setEstimatedSize(int estimatedWidth, int estimatedHeight) 这应该从 EstimateSizeListener#onEstimateSize(int, int) 调用以设置测量的宽度和高度。
protected void setEstimateSizeListener(Component.EstimateSizeListener listener) 在组件的大小估计过程中添加一个侦听器。
void setFadeEffectBoundaryWidth(int width) 设置组件的淡入淡出效果区域的边界宽度。
void setFadeEffectColor(Color color) 设置产生淡入淡出效果时显示的颜色。
void setFocusable(int focusable) 设置组件是否可以接收焦点。
void setFocusBorderEnable(boolean enabled) 设置当该组件处于焦点时是否启用焦点边框。
void setFocusBorderPadding(int padding) 设置焦点边框和此组件之间的填充。
void setFocusBorderRadius(float radius) 设置焦点边框的半径。
void setFocusBorderRadius(float[] radii) 设置焦点边框角的半径。
void setFocusBorderWidth(int width) 设置焦点边框的宽度。
void setFocusChangedListener(Component.FocusChangedListener listener) 为组件中的焦点更改事件注册一个侦听器。
void setFocusedEffect(boolean enabled) 设置此组件获得焦点时是否具有焦点效果。
void setForeground(Element element) 将指定元素设置为组件的前景。
void setForegroundGravity(int foregroundGravity) 已弃用。 此更改从 API 版本 6 开始生效。此方法是多余的,因此已弃用。
void setForwardHoverListener(Component.ForwardHoverListener listener) 注册一个监听器来决定将鼠标悬停事件转发给子组件。
void setForwardTouchListener(Component.ForwardTouchListener listener) 注册一个监听器来决定子组件的前向触摸事件。
void setGesturePriority(Component.GestureType gestureType, int priority) 设置手势的优先级。
void setHeight(int height) 设置组件的高度。
void setHorizontalPadding(int left, int right) 设置此组件的水平填充。
void setHorizontalPosition(int left, int right) 设置组件相对于父容器的水平位置。
void setHoverEventListener(Component.HoverEventListener listener) 为组件中的悬停事件注册一个侦听器。
void setId(int id) 设置组件的唯一 ID。
void setKeyEventListener(Component.KeyEventListener listener) 为组件中的关键事件注册一个监听器。
void setLayoutConfig(ComponentContainer.LayoutConfig config) 设置组件在其父布局中的布局参数。
void setLayoutDirection(Component.LayoutDirection layoutDirection) 设置此组件的布局方向。
void setLayoutRefreshedListener(Component.LayoutRefreshedListener listener) 为组件的重新布局注册一个监听器。
void setLeft(int left) 设置组件相对于父容器的左边缘位置。
void setLongClickable(boolean longClickable) 设置组件是否可长按。
void setLongClickedListener(Component.LongClickedListener listener) 为组件中的长按事件注册一个监听器(组件被单击并按住)。
void setMarginBottom(int bottom) 设置此组件的下边距。
void setMarginLeft(int left) 设置此组件的左边距。
void setMarginRight(int right) 设置此组件的右边距。
void setMarginsLeftAndRight(int left, int right) 设置此组件的水平边距。
void setMarginsTopAndBottom(int top, int bottom) 设置此组件的垂直边距。
void setMarginTop(int top) 设置此组件的上边距。
void setMinHeight(int minHeight) 设置组件的最小高度。
void setMinWidth(int minWidth) 设置组件的最小可能宽度。
void setMode(int mode) 设置此组件的显示模式。
void setMouseEventListener(Component.MouseEventListener listener) 为组件中的鼠标事件注册一个监听器。
void setMousePointerStyleListener(Component.MousePointerStyleListener listener) 注册鼠标指针样式更改的侦听器。
void setName(String name) 设置组件的名称。
void setOnDragListener(Component.OnDragListener listener) 为组件中的拖动事件注册一个监听器。
void setPadding(int left, int top, int right, int bottom) 设置组件的填充。
void setPaddingBottom(int bottom) 设置此组件的底部填充。
void setPaddingLeft(int left) 设置此组件的左侧填充。
void setPaddingRelative(int start, int top, int end, int bottom) 设置组件的相对填充。
void setPaddingRight(int right) 为此组件设置正确的填充。
void setPaddingTop(int top) 设置此组件的顶部填充。
void setPivot(float x, float y) 设置枢轴(点),围绕该组件旋转和缩放。
void setPivot(Point point) 设置枢轴(点),此组件基于该点旋转和缩放。
void setPivotX(float pivotX) 设置组件旋转和缩放所围绕的点的 X 轴坐标,即枢轴点。
void setPivotY(float pivotY) 设置组件旋转和缩放所围绕的点,即枢轴点的 Y 轴坐标。
void setPosition(int coordX, int coordY) 设置组件左上角相对于父布局的位置。
void setPositionX(int coordX) 设置组件左上角相对于父布局的 x 坐标。
void setPositionY(int coordY) 设置组件左上角相对于父布局的 y 坐标。
void setPressState(boolean pressState) 设置组件的按下状态。
void setRight(int right) 设置组件相对于父容器的右边缘位置。
void setRotation(float degree) 设置组件绕 Z 轴旋转的度数。
void setRotationEventListener(Component.RotationEventListener listener) 为组件中的旋转事件注册一个监听器。
void setRotationSensitivity(float value) 设置组件的旋转灵敏度。
void setScale(float x, float y) 围绕枢轴设置组件的比例因子。
void setScaledListener(Component.ScaledListener listener) 为组件的缩放事件注册一个监听器。
void setScaleX(float scaleX) 围绕枢轴点设置组件在 X 方向上的缩放因子。
void setScaleY(float scaleY) 围绕枢轴点设置组件在 Y 方向上的缩放因子。
void setScrollbarBackgroundColor(Color color) 设置滚动条的背景颜色。
void setScrollbarColor(Color color) 设置滚动条的颜色。
void setScrollbarFadingDelay(int delay) 设置滚动条消失之前的延迟。
void setScrollbarFadingDuration(int duration) 设置滚动条的淡出持续时间。
void setScrollbarFadingEnabled(boolean enabled) 已弃用。 此更改从 API 版本 6 开始生效。替换为 enableFadeEffect(FadeEffectEnum) 或 disableFadeEffect(FadeEffectEnum)
void setScrollBarMode(int scrollBarMode) 设置正在显示的滚动条的模式。
void setScrollbarOverlapEnabled(boolean enabled) 设置滚动条是否与内容重叠。
void setScrollbarRadius(float radius) 设置滚动条圆角边框的半径。
void setScrollbarRoundRect(boolean isRoundRect) 设置滚动条的形状。
void setScrollbarStartAngle(float start) 设置圆形滚动条的起始角度。
void setScrollbarSweepAngle(float sweep) 设置圆形滚动条的扫角。
void setScrollbarThickness(int thickness) 设置滚动条的粗细。
void setScrolledListener(Component.ScrolledListener listener) 为组件中的滚动事件注册一个监听器。
void setSelected(boolean selected) 设置组件的选择状态。
void setShadowColor(Color color) 设置组件的阴影颜色。
void setShadowStyle(Component.ShadowSize size, Component.ShadowMode mode, Component.ShadowDevice device) 将指定元素设置为组件的阴影样式。
void setSoundEnable(boolean enable) 单击此组件时启用或禁用该组件的声音。
void setSpeechEventListener(Component.SpeechEventListener listener) 设置此组件中语音事件的侦听器。
void setTag(Object tag) 设置与组件关联的标签。
void setTop(int top) 设置组件相对于父容器的顶部边缘位置。
void setTouchEventListener(Component.TouchEventListener listener) 为组件中的触摸事件注册一个监听器。
void setTouchFocusable(boolean focusable) 设置组件在触摸模式下是否可以接收焦点。
void setTransitionSymbol(String symbol) 设置过渡符号。
void setTranslation(float x, float y) 设置组件相对于其左边界的水平平移和相对于其上边界的垂直平移。
void setTranslationX(float translationX) 设置组件相对于其左侧位置的水平位置。
void setTranslationY(float translationY) 设置组件相对于其顶部位置的垂直位置。
void setTranslationZ(float translationZ) 设置该组件在垂直于屏幕方向的深度位置变化。
void setUnconsumedKeyEventListener(Component.UnconsumedKeyEventListener listener) 为组件中未使用的键事件注册一个侦听器。
void setUserNextFocus(int side, int id) 设置要关注的下一个组件。
void setVerticalPadding(int top, int bottom) 设置此组件的垂直填充。
void setVerticalPosition(int top, int bottom) 设置组件相对于父容器的垂直位置。
void setVibrationEffectEnabled(boolean enabled) 设置是否开启震动效果。
void setVisibility(int visibility) 设置组件的可见性。
void setWidth(int width) 设置组件的宽度。
void showFocusBorder() 已弃用。 此更改自 API 版本 8 起生效。此方法是多余且临时的,因此已弃用。
boolean simulateClick() 在组件中执行单击事件。
boolean simulateDrag() 执行组件的拖动事件。
boolean startDragAndDrop(MimeData data, Component.DragFeedbackProvider shadowProvider) 开始拖动组件。
void subscribeVoiceEvents(Component.VoiceEvent voiceEvent) 订阅该组件的指定语音事件。
void unsubscribeVoiceEvents() 一次取消订阅当前组件订阅的所有语音事件。
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细信息

ACCESSIBILITY_ADAPTABLE

public static final int ACCESSIBILITY_ADAPTABLE

表示可以访问该组件。

ACCESSIBILITY_DISABLE

public static final int ACCESSIBILITY_DISABLE

表示无法访问该组件。

ACCESSIBILITY_ENABLE

public static final int ACCESSIBILITY_ENABLE

表示该组件已启用。

AXIS_X

public static final int AXIS_X

表示 x 轴。

AXIS_Y

public static final int AXIS_Y

表示 y 轴。

CONTOUR_BACKGROUND

public static final Component.ContourRefreshedListener CONTOUR_BACKGROUND

组件的默认 ContourRefreshedListener。 如果背景元素已经设置到当前组件中,则从元素中获取轮廓并设置到组件中。 否则,设置与组件大小相同的透明轮廓。

CONTOUR_BORDER

public static final Component.ContourRefreshedListener CONTOUR_BORDER

提供与组件矩形边框匹配的轮廓。

CONTOUR_PADDING_BORDER

public static final Component.ContourRefreshedListener CONTOUR_PADDING_BORDER

提供与组件的矩形填充边框匹配的轮廓。

DEFAULT_SCALE

public static final float DEFAULT_SCALE

表示缩放组件的默认缩放系数。

DRAG_DOWN

public static final int DRAG_DOWN

表示向下拖动滚动条。

DRAG_HORIZONTAL

public static final int DRAG_HORIZONTAL

表示水平拖动滚动条。

DRAG_HORIZONTAL_VERTICAL

public static final int DRAG_HORIZONTAL_VERTICAL

表示滚动条水平和垂直拖动。

DRAG_LEFT

public static final int DRAG_LEFT

表示向左拖动滚动条。

DRAG_RIGHT

public static final int DRAG_RIGHT

表示向右拖动滚动条。

DRAG_UP

public static final int DRAG_UP

表示向上拖动滚动条。

DRAG_VERTICAL

public static final int DRAG_VERTICAL

表示垂直拖动滚动条。

EVENT_TYPE_COMPONENT_ACCESSIBILITY_FOCUSED

public static final int EVENT_TYPE_COMPONENT_ACCESSIBILITY_FOCUSED

表示一个事件,指示获得了可访问性焦点。

EVENT_TYPE_COMPONENT_ACCESSIBILITY_FOCUSED_CLEAR

public static final int EVENT_TYPE_COMPONENT_ACCESSIBILITY_FOCUSED_CLEAR

表示一个事件,指示清除辅助功能焦点。

EVENT_TYPE_COMPONENT_CLICKED

public static final int EVENT_TYPE_COMPONENT_CLICKED

表示一个指示组件被单击的事件。

EVENT_TYPE_COMPONENT_FOCUSED

public static final int EVENT_TYPE_COMPONENT_FOCUSED

表示一个指示组件获得焦点的事件。

EVENT_TYPE_COMPONENT_LONG_CLICKED

public static final int EVENT_TYPE_COMPONENT_LONG_CLICKED

表示一个指示组件被长按的事件。

EVENT_TYPE_COMPONENT_SCROLLED

public static final int EVENT_TYPE_COMPONENT_SCROLLED

表示一个指示组件滚动的事件。

EVENT_TYPE_COMPONENT_SELECTED

public static final int EVENT_TYPE_COMPONENT_SELECTED

表示一个指示组件被选中的事件。

EVENT_TYPE_COMPONENT_TEXT_UPDATE

public static final int EVENT_TYPE_COMPONENT_TEXT_UPDATE

表示指示 Text 组件中的文本已更改的事件。

EVENT_TYPE_NOTICE

public static final int EVENT_TYPE_NOTICE

表示指示应用程序发送通知的事件。

EVENT_TYPE_NOTIFICATION_STATE_UPDATE

public static final int EVENT_TYPE_NOTIFICATION_STATE_UPDATE

表示指示显示通知的事件。

EVENT_TYPE_TOAST_SHOW

public static final int EVENT_TYPE_TOAST_SHOW

表示指示显示 toast 的事件。

EVENT_TYPE_WINDOW_STATE_UPDATE

public static final int EVENT_TYPE_WINDOW_STATE_UPDATE

表示指示窗口状态已更新的事件。

FOCUS_ADAPTABLE

public static final int FOCUS_ADAPTABLE

组件自行决定可聚焦性。 这是默认状态。 此常量用作 setFocusable(int) 的参数。

FOCUS_DISABLE

public static final int FOCUS_DISABLE

该组件不需要击键。 此常量用作 setFocusable(int) 的参数。

FOCUS_ENABLE

public static final int FOCUS_ENABLE

该组件需要击键。 此常量用作 setFocusable(int) 的参数。

FOCUS_NEXT

public static final int FOCUS_NEXT

将焦点移至下一个可点击项目。 此常量用作 findNextFocusableComponent(int) 的参数。

FOCUS_PREVIOUS

public static final int FOCUS_PREVIOUS

将焦点移到上一个可点击项目。 此常量用作 findNextFocusableComponent(int) 的参数。

FOCUS_SIDE_BOTTOM

public static final int FOCUS_SIDE_BOTTOM

向下移动焦点。 此常量用作 findNextFocusableComponent(int) 的参数。

FOCUS_SIDE_LEFT

public static final int FOCUS_SIDE_LEFT

将焦点移到左侧。 此常量用作 findNextFocusableComponent(int) 的参数。

FOCUS_SIDE_RIGHT

public static final int FOCUS_SIDE_RIGHT

将焦点向右移动。 此常量用作 findNextFocusableComponent(int) 的参数。

FOCUS_SIDE_TOP

public static final int FOCUS_SIDE_TOP

上移焦点。 此常量用作 findNextFocusableComponent(int) 的参数

网站名称:创新互联鸿蒙OS教程:鸿蒙OSComponent
地址分享:http://www.csdahua.cn/qtweb/news19/460569.html

网站建设、网络推广公司-快上网,是专注品牌与效果的网站制作,网络营销seo公司;服务项目有等

广告

声明:本网站发布的内容(图片、视频和文字)以用户投稿、用户转载内容为主,如果涉及侵权请尽快告知,我们将会在第一时间删除。文章观点不代表本网站立场,如需处理请联系客服。电话:028-86922220;邮箱:631063699@qq.com。内容未经允许不得转载,或转载时需注明来源: 快上网