程序包 ohos.agp.components

类 TableLayout

java.lang.Object

ohos.agp.components.Component

ohos.agp.components.ComponentContainer

ohos.agp.components.TableLayout

所有已实现的接口:

ComponentParent

public class TableLayout
extends ComponentContainer

Provides a layout for arranging components in a component with tables.

TableLayout provides interfaces for aligning and arranging the components to display components in a component with tables. The arrangement mode, the number of rows and columns, and the component's position can be configured.

从以下版本开始:

3

嵌套类概要

嵌套类

限定符和类型	类	说明
static interface	TableLayout.Alignment	Provides alignment modes for child components in a table layout.
static class	TableLayout.CellSpan	Stores the span, start cell, and end cell of an element in a table layout.
static class	TableLayout.LayoutConfig	Provides layout config required in a table layout.
static class	TableLayout.Specification	Configures column and row attributes of an element in a table layout.

从类继承的嵌套类/接口 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	Indicates the margin alignment for child components.
static int	ALIGN_EDGES	Indicates the boundary alignment for child components.
static int	DEFAULT	Indicates a table layout parameter that is not defined.

从类继承的字段 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)	Default constructor used to create a TableLayout instance by using the default attribute set and style.
TableLayout(Context context, AttrSet attrSet)	A constructor used to create a TableLayout instance by using specified attribute set and default style after the XML file is parsed.
TableLayout(Context context, AttrSet attrSet, String styleName)	A constructor used to create a TableLayout instance by using specified attribute set and specified style after the XML file is parsed.

方法概要

限定符和类型	方法	说明
ComponentContainer.LayoutConfig	createLayoutConfig(Context context, AttrSet attrSet)	Creates layout parameters using the attribute set of a child component.
int	getAlignmentType()	Obtains the alignment mode in a table layout.
int	getColumnCount()	Obtains the number of columns in the table layout.
int	getOrientation()	Obtains the layout direction of the table layout.
int	getRowCount()	Obtains the number of rows in the table layout.
void	setAlignmentType(int type)	Sets the alignment mode in a table layout.
void	setColumnCount(int columnCount)	Sets the number of columns in the table layout.
void	setOrientation(int orientation)	Sets the table layout direction.
void	setRowCount(int rowCount)	Sets the number of rows in the table layout.
static TableLayout.Specification	specification(float weight)	Returns a specification instance based on the weight of an element.
static TableLayout.Specification	specification(int start)	Returns a specification instance based on the start position of an element in the table layout.
static TableLayout.Specification	specification(int start, float weight)	Returns a specification instance based on the start position of an element in the table layout and the element weight.
static TableLayout.Specification	specification(int start, int size)	Returns a specification instance based on the start position of an element in the table layout and the element size.
static TableLayout.Specification	specification(int start, int size, float weight)	Returns a specification instance based on the start position of an element in the table layout and the element size and weight.
static TableLayout.Specification	specification(int start, int size, int alignment)	Obtains specification instances based on the start position of an element in the table layout and the element size and alignment mode.
static TableLayout.Specification	specification(int start, int size, int alignment, float weight)	Returns a specification instance based on the start position of an element in the table layout and the size, alignment mode, and weight of the element.
ComponentContainer.LayoutConfig	verifyLayoutConfig(ComponentContainer.LayoutConfig config)	Verifies layout parameters based on the current layout type.

从类继承的方法 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

Indicates the margin alignment for child components.

从以下版本开始:

1

另请参阅:

常量字段值

ALIGN_EDGES

public static final int ALIGN_EDGES

Indicates the boundary alignment for child components.

从以下版本开始:

1

另请参阅:

常量字段值

DEFAULT

public static final int DEFAULT

Indicates a table layout parameter that is not defined.

When creating a specification object instance, if the start position of an element in the table is not determined, spec(DEFAULT, weight) can be used.

从以下版本开始:

1

另请参阅:

常量字段值

构造器详细资料

TableLayout

public TableLayout(Context context)

Default constructor used to create a TableLayout instance by using the default attribute set and style.

参数:

context - Indicates the application context.

从以下版本开始:

3

TableLayout

public TableLayout(Context context,
                   AttrSet attrSet)

A constructor used to create a TableLayout instance by using specified attribute set and default style after the XML file is parsed.

参数:

context - Indicates the application context.

attrSet - Indicates the attribute set to be used.

从以下版本开始:

3

TableLayout

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

A constructor used to create a TableLayout instance by using specified attribute set and specified style after the XML file is parsed.

参数:

context - Indicates the application context.

attrSet - Indicates the attribute set to be used.

styleName - Indicates the style name to use.

从以下版本开始:

3

方法详细资料

setColumnCount

public void setColumnCount(int columnCount)

Sets the number of columns in the table layout.

If no value is set for the child component, the default number of columns in the parent component is used.

参数:

columnCount - Indicates the number of columns.

从以下版本开始:

1

getColumnCount

public int getColumnCount()

Obtains the number of columns in the table layout.

返回:

Returns the number of columns in the table layout.

从以下版本开始:

1

setRowCount

public void setRowCount(int rowCount)

Sets the number of rows in the table layout.

If no value is set for the child component, the default number of rows in the parent component is used.

参数:

rowCount - Indicates the number of rows.

从以下版本开始:

1

getRowCount

public int getRowCount()

Obtains the number of rows in the table layout.

返回:

Returns the number of rows in the table layout.

从以下版本开始:

1

setOrientation

public void setOrientation(int orientation)

Sets the table layout direction.

If this method is not invoked, Component.HORIZONTAL is used by default.

参数:

orientation - Indicates the table layout direction. Component.HORIZONTAL indicates that components are arranged horizontally; Component.VERTICAL indicates that components are arranged vertically.

从以下版本开始:

1

getOrientation

public int getOrientation()

Obtains the layout direction of the table layout.

返回:

Returns the table layout direction. Component.HORIZONTAL indicates that components are arranged horizontally; Component.VERTICAL indicates that components are arranged vertically.

从以下版本开始:

1

setAlignmentType

public void setAlignmentType(int type)

Sets the alignment mode in a table layout.

If this method is not invoked, ALIGN_CONTENTS is used by default.

参数:

type - Indicates the alignment mode in the table layout. ALIGN_EDGES indicates boundary alignment; ALIGN_CONTENTS indicates margin alignment.

从以下版本开始:

4

getAlignmentType

public int getAlignmentType()

Obtains the alignment mode in a table layout.

返回:

Returns the alignment mode in the table layout. Returns ALIGN_EDGES if boundary alignment mode is used; returns ALIGN_CONTENTS if margin alignment mode is used.

从以下版本开始:

4

specification

public static TableLayout.Specification specification(float weight)

Returns a specification instance based on the weight of an element. The default position is DEFAULT.

参数:

weight - Indicates the element weight. The value cannot be less than 0.

从以下版本开始:

3

specification

public static TableLayout.Specification specification(int start)

Returns a specification instance based on the start position of an element in the table layout. The default element weight is 1.

参数:

start - Indicates the start position of the element in the table layout. The value cannot be less than 0.

从以下版本开始:

3

specification

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

Returns a specification instance based on the start position of an element in the table layout and the element weight.

参数:

start - Indicates the start position of the element in the table layout. The value cannot be less than 0.

weight - Indicates the element weight. The value cannot be less than 0.

从以下版本开始:

3

specification

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

Returns a specification instance based on the start position of an element in the table layout and the element size.

参数:

start - Indicates the start position of the element in the table layout. The value cannot be less than 0.

size - Indicates the element size. The value cannot be less than 0.

从以下版本开始:

3

specification

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

Returns a specification instance based on the start position of an element in the table layout and the element size and weight.

参数:

start - Indicates the start position of the element in the table layout. The value cannot be less than 0.

size - Indicates the element size. The value cannot be less than 0.

weight - Indicates the element weight. The value cannot be less than 0.

从以下版本开始:

3

specification

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

Obtains specification instances based on the start position of an element in the table layout and the element size and alignment mode.

参数:

start - Indicates the start position of the element in the table layout. The value cannot be less than 0.

size - Indicates the element size. The value cannot be less than 0.

alignment - Indicates the alignment mode of an element. ALIGN_EDGES indicates boundary alignment; ALIGN_CONTENTS indicates margin alignment.

从以下版本开始:

3

specification

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

Returns a specification instance based on the start position of an element in the table layout and the size, alignment mode, and weight of the element.

参数:

start - Indicates the start position of the element in the table layout. The value cannot be less than 0.

size - Indicates the element size. The value cannot be less than 0.

alignment - Indicates the alignment mode of an element. ALIGN_EDGES indicates boundary alignment; ALIGN_CONTENTS indicates margin alignment.

weight - Indicates the element weight. The value cannot be less than 0.

从以下版本开始:

3

verifyLayoutConfig

public ComponentContainer.LayoutConfig verifyLayoutConfig(ComponentContainer.LayoutConfig config)

从类复制的说明: ComponentContainer

Verifies layout parameters based on the current layout type.

指定者:

verifyLayoutConfig 在接口中 ComponentParent

覆盖:

verifyLayoutConfig 在类中 ComponentContainer

参数:

config - Indicates a group of layout parameters to be converted into a ComponentContainer instance.

返回:

Returns the LayoutConfig instance, which represents the layout parameters.

createLayoutConfig

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

从类复制的说明: ComponentContainer

Creates layout parameters using the attribute set of a child component.

覆盖:

createLayoutConfig 在类中 ComponentContainer

参数:

context - Indicates the application context.

attrSet - Indicates the attribute set.

返回:

Returns the layout parameters created.