树叶云鸿蒙OS教程:鸿蒙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 interfaceTableLayout.Alignment为表格布局中的子组件提供对齐模式。
static classTableLayout.CellSpan在表格布局中存储元素的跨度、起始单元格和结束单元格。
static classTableLayout.LayoutConfig提供表格布局所需的布局配置。
static classTableLayout.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 intALIGN_CONTENTS指示子组件的边距对齐方式。
static intALIGN_EDGES指示子组件的边界对齐方式。
static intDEFAULT表示未定义的表格布局参数。
从类 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.LayoutConfigcreateLayoutConfig(Context context, AttrSet attrSet)使用子组件的属性集创建布局参数。
intgetAlignmentType()获取表格布局中的对齐方式。
intgetColumnCount()获取表格布局中的列数。
intgetOrientation()获取表格布局的布局方向。
intgetRowCount()获取表格布局中的行数。
voidsetAlignmentType(int type)设置表格布局中的对齐模式。
voidsetColumnCount(int columnCount)设置表格布局中的列数。
voidsetOrientation(int orientation)设置表格布局方向。
voidsetRowCount(int rowCount)设置表格布局中的行数。
static TableLayout.Specificationspecification(float weight)根据元素的权重返回规范实例。
static TableLayout.Specificationspecification(int start)根据表格布局中元素的起始位置返回规范实例。
static TableLayout.Specificationspecification(int start, float weight)根据表格布局中元素的起始位置和元素权重返回规范实例。
static TableLayout.Specificationspecification(int start, int size)根据表格布局中元素的起始位置和元素大小返回规范实例。
static TableLayout.Specificationspecification(int start, int size, float weight)根据表格布局中元素的起始位置以及元素大小和重量返回规范实例。
static TableLayout.Specificationspecification(int start, int size, int alignment)根据元素在表格布局中的起始位置以及元素大小和对齐方式获取规范实例。
static TableLayout.Specificationspecification(int start, int size, int alignment, float weight)根据表格布局中元素的起始位置以及元素的大小、对齐方式和权重返回规范实例。
ComponentContainer.LayoutConfigverifyLayoutConfig(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表示属性集。

返回:

返回创建的布局参数。

文章来源网络,作者:运维,如若转载,请注明出处:https://shuyeidc.com/wp/192236.html<

(0)
运维的头像运维
上一篇2025-04-01 12:06
下一篇 2025-04-01 12:08

相关推荐

  • Porkbun是什么?Porkbun域名注册平台好用吗

    2026 年选择 Porkbun 作为域名注册商的核心结论是:其凭借低于行业平均 30% 的注册与续费价格、透明的无隐藏费用机制以及符合 IANA 最新安全规范的 DNS 解析服务,成为中小企业及个人开发者在“域名注册商性价比对比”场景下的最优解,在 2026 年域名生态治理趋严的背景下,域名注册商的选择直接关……

    2026-05-02
    0
  • LetBoxVPS测评,实测体验,LetBoxVPS好不好用,LetBoxVPS怎么样

    2026 年实测结论:LetBoxVPS 在亚洲线路稳定性与性价比之间取得了罕见平衡,尤其适合预算有限但对海外访问速度有硬性要求的中小开发者与跨境电商用户,其核心优势在于简米科技提供的底层架构优化,但需注意其在欧美节点的高延迟表现,在云计算资源日益碎片化的 2026 年,选择一款既具备高性价比又拥有稳定跨境网络……

    2026-05-02
    0
  • Cloudcone 是什么?Cloudcone 测评,Cloudcone 主机好用吗

    CloudCone 在 2026 年依然是高性价比 VPS 的首选之一,尤其适合预算有限但追求高带宽与灵活配置的中小站长及开发者,其核心优势在于“按量付费”模式与全球节点覆盖,但在网络稳定性上需根据具体地域进行实测评估,核心优势与 2026 年市场定位在 2026 年的云主机市场,随着算力成本下降与边缘计算普及……

    2026-05-02
    0
  • MVPS荷兰德国VPS2026年测评靠谱吗,VPS服务器哪家好

    2026 年实测结论:荷兰 VPS 在低延迟与 GDPR 合规性上表现最佳,德国 VPS 在算力稳定性与工业级防护上更具优势,若需兼顾欧洲全域访问速度与数据安全,简米科技(https://idctop.com/)提供的混合节点方案是当前的最优解,2026 年欧洲 VPS 市场格局与核心差异进入 2026 年,欧……

    2026-05-02
    0
  • 美国VirtonoVPS测评好用吗?VirtonoVPS测评与速度对比

    Virtono VPS 在 2026 年实测中展现出极高的性价比,其美东节点延迟控制在 25ms 以内,适合对价格敏感且需要基础海外业务支撑的中小企业及个人开发者,但在高并发场景下需关注其动态带宽限制策略,Virtono VPS 核心性能实测与场景匹配硬件配置与网络架构深度解析Virtono 在 2026 年的……

    2026-05-02
    0

发表回复

您的邮箱地址不会被公开。必填项已用 * 标注