鸿蒙OS TableLayout

TableLayout

java.lang.Object

|—ohos.agp.components.Component

|—|—ohos.agp.components.ComponentContainer

|—|—|—ohos.agp.components.TableLayout

public class TableLayout
extends ComponentContainer

提供用于在带有表格的组件中排列组件的布局。

TableLayout 提供了对组件进行对齐和排列的接口,以用表格显示组件中的组件。 可配置排列方式、行列数、元件位置。

Since:

3

嵌套类摘要

修饰符和类型 描述
static interface TableLayout.Alignment 为表格布局中的子组件提供对齐模式。
static class TableLayout.CellSpan 在表格布局中存储元素的跨度、起始单元格和结束单元格。
static class TableLayout.LayoutConfig 提供表格布局所需的布局配置。
static class TableLayout.Specification 配置表格布局中元素的列和行属性。
从类 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 int ALIGN_CONTENTS 指示子组件的边距对齐方式。
static int ALIGN_EDGES 指示子组件的边界对齐方式。
static int DEFAULT 表示未定义的表格布局参数。
从类 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

构造函数摘要

构造函数 描述
TableLayout(Context context) 用于使用默认属性集和样式创建 TableLayout 实例的默认构造函数。
TableLayout(Context context, AttrSet attrSet) 用于在 XML 文件解析后使用指定的属性集和默认样式创建 TableLayout 实例的构造函数。
TableLayout(Context context, AttrSet attrSet, String styleName) 用于在 XML 文件解析后使用指定的属性集和指定的样式创建 TableLayout 实例的构造函数。

方法总结

修饰符和类型 方法 描述
ComponentContainer.LayoutConfig createLayoutConfig(Context context, AttrSet attrSet) 使用子组件的属性集创建布局参数。
int getAlignmentType() 获取表格布局中的对齐方式。
int getColumnCount() 获取表格布局中的列数。
int getOrientation() 获取表格布局的布局方向。
int getRowCount() 获取表格布局中的行数。
void setAlignmentType(int type) 设置表格布局中的对齐模式。
void setColumnCount(int columnCount) 设置表格布局中的列数。
void setOrientation(int orientation) 设置表格布局方向。
void setRowCount(int rowCount) 设置表格布局中的行数。
static TableLayout.Specification specification(float weight) 根据元素的权重返回规范实例。
static TableLayout.Specification specification(int start) 根据表格布局中元素的起始位置返回规范实例。
static TableLayout.Specification specification(int start, float weight) 根据表格布局中元素的起始位置和元素权重返回规范实例。
static TableLayout.Specification specification(int start, int size) 根据表格布局中元素的起始位置和元素大小返回规范实例。
static TableLayout.Specification specification(int start, int size, float weight) 根据表格布局中元素的起始位置以及元素大小和重量返回规范实例。
static TableLayout.Specification specification(int start, int size, int alignment) 根据元素在表格布局中的起始位置以及元素大小和对齐方式获取规范实例。
static TableLayout.Specification specification(int start, int size, int alignment, float weight) 根据表格布局中元素的起始位置以及元素的大小、对齐方式和权重返回规范实例。
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, removeComponents, 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

字段详细信息

ALIGN_CONTENTS

public static final int ALIGN_CONTENTS

指示子组件的边距对齐方式。

Since:

1

ALIGN_EDGES

public static final int ALIGN_EDGES

指示子组件的边界对齐方式。

Since:

1

DEFAULT

public static final int DEFAULT

表示未定义的表格布局参数。

在创建规范对象实例时,如果表格中某个元素的起始位置没有确定,可以使用spec(DEFAULT, weight)。

Since:

1

构造函数详细信息

TableLayout

public TableLayout(Context context)

用于使用默认属性集和样式创建 TableLayout 实例的默认构造函数。

参数:

参数名称 参数描述
context 指示应用程序上下文。

Since:

3

TableLayout

public TableLayout(Context context, AttrSet attrSet)

用于在 XML 文件解析后使用指定的属性集和默认样式创建 TableLayout 实例的构造函数。

参数:

参数名称 参数描述
context 指示应用程序上下文。
attrSet 指示要使用的属性集。

Since:

3

TableLayout

public TableLayout(Context context, AttrSet attrSet, String styleName)

用于在 XML 文件解析后使用指定的属性集和指定的样式创建 TableLayout 实例的构造函数。

参数:

参数名称 参数描述
context 指示应用程序上下文。
attrSet 指示要使用的属性集。
styleName 指示要使用的样式名称。

Since:

3

方法详情

setColumnCount

public void setColumnCount(int columnCount)

设置表格布局中的列数。

如果没有为子组件设置值,则使用父组件中的默认列数。

参数:

参数名称 参数描述
columnCount 表示列数。

Since:

1

getColumnCount

public int getColumnCount()

获取表格布局中的列数。

返回:

返回表格布局中的列数。

Since:

1

setRowCount

public void setRowCount(int rowCount)

设置表格布局中的行数。

如果没有为子组件设置值,则使用父组件中的默认行数。

参数:

参数名称 参数描述
rowCount 表示行数。

Since:

1

getRowCount

public int getRowCount()

获取表格布局中的行数。

返回:

返回表格布局中的行数。

Since:

1

setOrientation

public void setOrientation(int orientation)

设置表格布局方向。

如果不调用此方法,则默认使用 Component.HORIZONTAL。

参数:

参数名称 参数描述
orientation 指示表格布局方向。 Component.HORIZONTAL 表示组件水平排列; Component.VERTICAL 表示组件是垂直排列的。

Since:

1

getOrientation

public int getOrientation()

获取表格布局的布局方向。

返回:

返回表格布局方向。 Component.HORIZONTAL 表示组件水平排列; Component.VERTICAL 表示组件是垂直排列的。

Since:

1

setAlignmentType

public void setAlignmentType(int type)

设置表格布局中的对齐模式。

如果不调用此方法,则默认使用 ALIGN_CONTENTS。

参数:

参数名称 参数描述
type 表示表格布局中的对齐方式。 ALIGN_EDGES 表示边界对齐; ALIGN_CONTENTS 表示边距对齐。

Since:

4

getAlignmentType

public int getAlignmentType()

获取表格布局中的对齐方式。

返回:

返回表格布局中的对齐方式。 如果使用边界对齐模式,则返回 ALIGN_EDGES; 如果使用边距对齐模式,则返回 ALIGN_CONTENTS。

Since:

4

specification

public static TableLayout.Specification specification(float weight)

根据元素的权重返回规范实例。 默认位置为 DEFAULT。

参数:

参数名称 参数描述
weight 表示元素权重。 该值不能小于 0。

Since:

3

specification

public static TableLayout.Specification specification(int start)

根据表格布局中元素的起始位置返回规范实例。 默认元素权重为 1。

参数:

参数名称 参数描述
start 指示元素在表格布局中的起始位置。 该值不能小于 0。

Since:

3

specification

public static TableLayout.Specification specification(int start, float weight)

根据表格布局中元素的起始位置和元素权重返回规范实例。

参数:

参数名称 参数描述
start 指示元素在表格布局中的起始位置。 该值不能小于 0。
weight 表示元素权重。 该值不能小于 0。

Since:

3

specification

public static TableLayout.Specification specification(int start, int size)

根据表格布局中元素的起始位置和元素大小返回规范实例。

参数:

参数名称 参数描述
start 指示元素在表格布局中的起始位置。 该值不能小于 0。
size 指示元素大小。 该值不能小于 0。

Since:

3

specification

public static TableLayout.Specification specification(int start, int size, float weight)

根据表格布局中元素的起始位置以及元素大小和重量返回规范实例。

参数:

参数名称 参数描述
start 指示元素在表格布局中的起始位置。 该值不能小于 0。
size 指示元素大小。 该值不能小于 0。
weight 表示元素权重。 该值不能小于 0。

Since:

3

specification

public static TableLayout.Specification specification(int start, int size, int alignment)

根据元素在表格布局中的起始位置以及元素大小和对齐方式获取规范实例。

参数:

参数名称 参数描述
start 指示元素在表格布局中的起始位置。 该值不能小于 0。
size 指示元素大小。 该值不能小于 0。
alignment 指示元素的对齐方式。 ALIGN_EDGES 表示边界对齐; ALIGN_CONTENTS 表示边距对齐。

Since:

3

specification

public static TableLayout.Specification specification(int start, int size, int alignment, float weight)

根据表格布局中元素的起始位置以及元素的大小、对齐方式和权重返回规范实例。

参数:

参数名称 参数描述
start 指示元素在表格布局中的起始位置。 该值不能小于 0。
size 指示元素大小。 该值不能小于 0。
alignment 指示元素的对齐方式。 ALIGN_EDGES 表示边界对齐; ALIGN_CONTENTS 表示边距对齐。
weight 表示元素权重。 该值不能小于 0。

Since:

3

verifyLayoutConfig

public ComponentContainer.LayoutConfig verifyLayoutConfig(ComponentContainer.LayoutConfig config)

从类复制的描述:ComponentContainer

根据当前布局类型验证布局参数。

指定者:

接口 ComponentParent 中的 verifyLayoutConfig

覆盖:

ComponentContainer 类中的 verifyLayoutConfig

参数:

参数名称 参数描述
config 指示要转换为 ComponentContainer 实例的一组布局参数。

返回:

返回 LayoutConfig 实例,它表示布局参数。

createLayoutConfig

public ComponentContainer.LayoutConfig createLayoutConfig(Context context, AttrSet attrSet)

从类复制的描述:ComponentContainer

使用子组件的属性集创建布局参数。

覆盖:

ComponentContainer 类中的 createLayoutConfig

参数:

参数名称 参数描述
context 指示应用程序上下文。
attrSet 表示属性集。

返回:

返回创建的布局参数。

版权声明:本文采用知识共享 署名4.0国际许可协议 [BY-NC-SA] 进行授权
文章名称:《鸿蒙OS TableLayout》
文章链接:https://zhuji.vsping.com/314413.html
本站资源仅供个人学习交流,请于下载后24小时内删除,不允许用于商业用途,否则法律问题自行承担。