public class FlexListBase extends FlexScrollBase
项目通过 dataProvider 属性提供并通过项目呈现器显示。
在模型/视图架构中,ListBase 派生的类表示视图,dataProvider 对象表示模型。
Modifier | Constructor and Description |
---|---|
protected |
FlexListBase(JtfObjectHandle handle,
Desktop desktop)
使用 JtfObjectHandle 创建新 FlexListBase。
|
Modifier and Type | Method and Description |
---|---|
void |
deselect(String itemRenderer)
为在取消选择之前选定项目时发送的事件定义事件对象的类型属性值。
|
void |
deselect(String itemRenderer,
FlexTriggerEvent triggerEvent)
为在取消选择之前选定项目时发送的事件定义事件对象的类型属性值。
|
void |
deselect(String itemRenderer,
FlexTriggerEvent triggerEvent,
ModifierKey keyModifier)
为在取消选择之前选定项目时发送的事件定义事件对象的类型属性值。
|
void |
doubleSelect(String itemRenderer)
定义 itemDoubleClick 事件的 ListEvent 对象的类型属性值,表示用户在控件的可视项目上双击了鼠标。
|
void |
dragCancel()
定义 dragComplete 事件的事件对象的类型属性值。
|
void |
dragCancel(ModifierKey keyModifier)
定义 dragComplete 事件的事件对象的类型属性值。
|
void |
dragDrop(String action)
定义 dragDrop 事件的事件对象的类型属性值。
|
void |
dragDrop(String action,
String draggedItem)
定义 dragDrop 事件的事件对象的类型属性值。
|
void |
dragDrop(String action,
String draggedItem,
ModifierKey keyModifier)
定义 dragDrop 事件的事件对象的类型属性值。
|
void |
dragStart(String draggedItem)
定义 dragStart 事件的事件对象的类型属性值。
|
void |
dragStart(String draggedItem,
ModifierKey keyModifier)
定义 dragStart 事件的事件对象的类型属性值。
|
List<Color> |
getAlternatingItemColors()
获取 可用于列表项目的背景的颜色。
|
Color |
getBackgroundDisabledColor()
获取 已禁用组件时组件中的文本颜色。
|
int |
getColumnCount()
获取 可显示在 TileList 控件中的列数或 HorizontalList 控件中的项目。
|
List<String> |
getColumnNames()
获取 包含数据中所有列的名称的列表。
|
double |
getColumnWidth()
获取 控件的列宽。
|
String |
getDataTipField()
获取 数据提供程序项目中可显示为数据提示的字段的名称。
|
int |
getFirstVisibleRow()
获取 第一个可见子级的索引。
|
double |
getFocusAlpha()
获取 焦点外观的阿尔法透明度值。
|
String |
getIconField()
获取 数据提供程序对象中可确定显示为哪个图标的字段的名称。
|
String |
getLabelField()
获取 数据提供程序项目中可显示为标签的字段的名称。
|
int |
getLastVisibleRow()
获取 最后一个可见子级的索引。
|
int |
getLockedColumnCount()
获取 控件中滚动的第一列的索引。
|
int |
getLockedRowCount()
获取 控件中滚动的第一行的索引。
|
int |
getNumColumns()
获取 可用数据中的总列数。
|
int |
getNumRows()
获取 可用数据的总行数。
|
Color |
getRollOverColor()
获取 用户在呈现器上滚动时呈现器的背景颜色。
|
int |
getRowCount()
获取 可显示的行数。
|
double |
getRowHeight()
获取 行高(像素)。
|
int |
getSelectedIndex()
获取 所选项目的数据提供程序中的索引。
|
List<Integer> |
getSelectedIndices()
获取 所选项目的数据提供程序中索引的数组。
|
String |
getSelectedItem()
获取 数据提供程序中所选项目的参考。
|
List<String> |
getSelectedItems()
获取 数据提供程序中所选项目的参考的数组。
|
Color |
getSelectionColor()
获取 用户选择呈现器时呈现器的背景颜色。
|
Color |
getSelectionDisabledColor()
获取 禁用组件时呈现器的背景颜色。
|
Color |
getTextRollOverColor()
获取 用户在按钮上移动鼠标指针时标签的文本颜色。
|
Color |
getTextSelectedColor()
获取 用户选择呈现器时呈现器的文本颜色。
|
List<List<String>> |
getValues(int start,
int end)
返回矩阵,其包含所有组件部分的自动化值。
|
String |
getVerticalAlign()
获取 行中呈现器的垂直对齐。
|
boolean |
isAllowMultipleSelection()
获取 是否允许同时选择多个项目。
|
boolean |
isSelectable()
获取 列表是否将所选项目显示为已选择。
|
boolean |
isShowDataTips()
获取 行中的文本是否显示数据提示。
|
boolean |
isUseRollOver()
获取 鼠标在项目上滚动时是否突出显示项目。
|
boolean |
isVariableRowHeight()
获取 各行是否可以具有不同高度。
|
boolean |
isWordWrap()
获取 行中的文本是否可以自动换行。
|
void |
multiSelect(String itemRenderer)
为在选择项目(是多个项目选择操作的一部分)时发送的事件定义事件对象的类型属性值。
|
void |
multiSelect(String itemRenderer,
FlexTriggerEvent triggerEvent)
为在选择项目(是多个项目选择操作的一部分)时发送的事件定义事件对象的类型属性值。
|
void |
multiSelect(String itemRenderer,
FlexTriggerEvent triggerEvent,
ModifierKey keyModifier)
为在选择项目(是多个项目选择操作的一部分)时发送的事件定义事件对象的类型属性值。
|
void |
scroll(int position,
FlexScrollDirection direction,
FlexScrollDetail detail)
定义滚动事件的事件对象的类型属性值。
|
boolean |
scrollToIndex(int index)
确保指定索引中的数据提供程序可见。
|
void |
select(String itemRenderer)
为在选择单个项目时发送的事件定义事件对象的类型属性值。
|
void |
select(String itemRenderer,
FlexTriggerEvent triggerEvent)
为在选择单个项目时发送的事件定义事件对象的类型属性值。
|
void |
select(String itemRenderer,
FlexTriggerEvent triggerEvent,
ModifierKey keyModifier)
为在选择单个项目时发送的事件定义事件对象的类型属性值。
|
void |
selectIndex(int itemIndex)
为在选择单个项目时发送的事件定义事件对象的类型属性值。
|
void |
selectIndex(int itemIndex,
FlexTriggerEvent triggerEvent)
为在选择单个项目时发送的事件定义事件对象的类型属性值。
|
void |
selectIndex(int itemIndex,
FlexTriggerEvent triggerEvent,
ModifierKey keyModifier)
为在选择单个项目时发送的事件定义事件对象的类型属性值。
|
void |
type(String keyCode)
用户按键时发送。
|
void |
type(String keyCode,
ModifierKey keyModifier)
用户按键时发送。
|
mouseScroll, mouseScroll
changeFocus, changeFocus, changeFocus, getAutomationClassName, getAutomationIndex, getAutomationName, getClassName, getCurrentState, getErrorColor, getErrorString, getId, getNumAutomationChildren, getPercentHeight, getPercentWidth, getScaleX, getScaleY, getThemeColor, getToolTip, isEnabled, isFocusEnabled, isUseHandCursor, move, move, move, setFocus
click, click, click, click, doubleClick, doubleClick, doubleClick, doubleClick, getAlpha, getHeight, getStyle, getTabIndex, getWidth, getX, getY, isMouseEnabled, isTabChildren, isTabEnabled, isVisible, mouseMove, mouseMove, nativeToString, pressKeys, pressKeys, pressMouse, pressMouse, pressMouse, pressMouse, releaseKeys, releaseKeys, releaseMouse, releaseMouse, releaseMouse, releaseMouse, typeKeys, typeKeys, typeKeys, typePasswordKeys, typePasswordKeys, typePasswordKeys
captureBitmap, captureBitmap, exists, exists, generateLocator, getChildren, getDynamicMethodList, getParent, getPropertyList, getRect, getRect, getText, getValue, highlightObject, highlightObject, highlightObject, invokeMethods, textCapture, textCapture, textClick, textClick, textClick, textClick, textClick, textClick, textExists, textExists, textExists, textExists, textExists, textRectangle, textRectangle, textRectangle, textRectangle, textRectangle, waitForChildDisappearance, waitForChildDisappearance, waitForDisappearance, waitForDisappearance, waitForObject, waitForObject, waitForProperty, waitForProperty
equals, exists, find, find, findAll, findAll, getCustomTypeName, getDesktop, getHandle, getLocator, getProperty, getTypeName, hashCode, imageClick, imageClick, imageClick, imageClick, imageClick, imageClick, imageClickFile, imageClickFile, imageClickFile, imageClickFile, imageClickFile, imageClickFile, imageExists, imageExists, imageExists, imageExistsFile, imageExistsFile, imageExistsFile, imageRectangle, imageRectangle, imageRectangle, imageRectangleFile, imageRectangleFile, imageRectangleFile, invoke, preventFinalLocator, setProperty, toString
protected FlexListBase(JtfObjectHandle handle, Desktop desktop)
handle
- 可确定 FlexListBase 的句柄desktop
- 此对象所在的桌面public void deselect(String itemRenderer)
itemRenderer
- 项目的项目呈现器对象public void deselect(String itemRenderer, FlexTriggerEvent triggerEvent)
itemRenderer
- 项目的项目呈现器对象triggerEvent
- 触发了操作的事件,例如鼠标或键盘事件public void deselect(String itemRenderer, FlexTriggerEvent triggerEvent, ModifierKey keyModifier)
itemRenderer
- 项目的项目呈现器对象triggerEvent
- 触发了操作的事件,例如鼠标或键盘事件keyModifier
- 单击控件时可使用的键修饰符(例如 Ctrl 键)public void doubleSelect(String itemRenderer)
要接收 itemDoubleClick 事件,您必须设置组件的 doubleClickEnabled 属性为 true。
itemRenderer
- 双击了的项目呈现器public void dragCancel()
public void dragCancel(ModifierKey keyModifier)
keyModifier
- 完成拖放时可使用的键修饰符(例如 Ctrl 键)public void dragDrop(String action)
action
- 引起事件的操作:DragManager.COPY、DragManager.LINK、DragManager.MOVE 或 DragManager.NONEpublic void dragDrop(String action, String draggedItem)
action
- 引起事件的操作:DragManager.COPY、DragManager.LINK、DragManager.MOVE 或 DragManager.NONEdraggedItem
- 拖动的项目public void dragDrop(String action, String draggedItem, ModifierKey keyModifier)
action
- 引起事件的操作:DragManager.COPY、DragManager.LINK、DragManager.MOVE 或 DragManager.NONEdraggedItem
- 拖动的项目keyModifier
- 放置控件时可使用的键修饰符(例如 Ctrl 键)public void dragStart(String draggedItem)
draggedItem
- 拖动的项目public void dragStart(String draggedItem, ModifierKey keyModifier)
draggedItem
- 拖动的项目keyModifier
- 拖动控件时可使用的键修饰符(例如 Ctrl 键)public List<List<String>> getValues(int start, int end)
返回值是一个行数组,每个行数组是一个项目数组。
start
- 开始子级的索引。默认值为 0。end
- 结束子级的索引。默认值为 0。public void multiSelect(String itemRenderer)
itemRenderer
- 项目的项目呈现器对象public void multiSelect(String itemRenderer, FlexTriggerEvent triggerEvent)
itemRenderer
- 项目的项目呈现器对象triggerEvent
- 触发了操作的事件,例如鼠标或键盘事件public void multiSelect(String itemRenderer, FlexTriggerEvent triggerEvent, ModifierKey keyModifier)
itemRenderer
- 项目的项目呈现器对象triggerEvent
- 触发了操作的事件,例如鼠标或键盘事件keyModifier
- 单击控件时可使用的键修饰符(例如 Ctrl 键)public void scroll(int position, FlexScrollDirection direction, FlexScrollDetail detail)
position
- 包含新滚动位置direction
- 包含滚动方向 ScrollEventDirection.HORIZONTAL 或 ScrollEventDirection.VERTICALdetail
- 提供滚动活动的类型特性。可能值常数在 ScrollEventDetail 类中提供。public boolean scrollToIndex(int index)
如果项目可见,则即使项目不是第一个可见项目,verticalScrollPosition 属性也会保持不变。如果项目当前不可见,则 verticalScrollPosition 属性会更改以使项目成为第一个可见项目,除非由于 verticalScrollPosition 值受 maxVerticalScrollPosition 属性限制而不存在足够行实现此操作。
index
- 数据提供程序中项目的索引public void select(String itemRenderer)
itemRenderer
- 项目的项目呈现器对象public void select(String itemRenderer, FlexTriggerEvent triggerEvent)
itemRenderer
- 项目的项目呈现器对象triggerEvent
- 触发了操作的事件,例如鼠标或键盘事件public void select(String itemRenderer, FlexTriggerEvent triggerEvent, ModifierKey keyModifier)
itemRenderer
- 项目的项目呈现器对象triggerEvent
- 触发了操作的事件,例如鼠标或键盘事件keyModifier
- 选择控件时可使用的键修饰符(例如 Ctrl 键)public void selectIndex(int itemIndex)
itemIndex
- 可选择的项目的数据提供程序索引public void selectIndex(int itemIndex, FlexTriggerEvent triggerEvent)
itemIndex
- 可选择的项目的数据提供程序索引triggerEvent
- 触发了操作的事件,例如鼠标或键盘事件public void selectIndex(int itemIndex, FlexTriggerEvent triggerEvent, ModifierKey keyModifier)
itemIndex
- 可选择的项目的数据提供程序索引triggerEvent
- 触发了操作的事件,例如鼠标或键盘事件keyModifier
- 单击索引时可使用的键修饰符(例如 Ctrl 键)public void type(String keyCode)
键与特定字符之间的映射因设备和操作系统而异。此事件类型将在映射发生后且处理输入法编辑器 (IME) 前生成。IME 用于输入字符,例如中文表意文字,而标准 QWERTY 键盘无法生成此类文字。
keyCode
- 按下或松开的键的键码值public void type(String keyCode, ModifierKey keyModifier)
键与特定字符之间的映射因设备和操作系统而异。此事件类型将在映射发生后且处理输入法编辑器 (IME) 前生成。IME 用于输入字符,例如中文表意文字,而标准 QWERTY 键盘无法生成此类文字。
keyCode
- 按下或松开的键的键码值keyModifier
- 单击控件时可使用的键修饰符(例如 Ctrl 键)public boolean isAllowMultipleSelection()
如果为 true,则用户可选择多个项目。没有可禁止非连续选择的选项。标准的复杂选择选项始终有效(Shift-单击、Ctrl-单击)。
默认值为 false。
public List<Color> getAlternatingItemColors()
此值为两种或更多颜色的数组。列表项目的背景交替使用数组中的颜色。仅在未指定 backgroundColor 属性时使用。默认值为未定义。
public Color getBackgroundDisabledColor()
public int getColumnCount()
对于 DataGrid,它是可见列的数量:设置此属性不会对 DataGrid 控件产生任何影响,DataGrid 控件基于控件宽度内的列数和各列宽。
默认值为 4。
public double getColumnWidth()
此属性由 TileList 和 HorizontalList 控件使用。它不会对 DataGrid 控件产生任何影响,您可在 DataGrid 控件中设置各 DataGridColumn 宽度。
默认值为 50。
public String getDataTipField()
默认情况下,列表查找每个项目上以属性命名的标签并显示它。但是,如果数据对象不包含标签属性,则您可设置 dataTipField 属性以使用数据对象中的不同属性。
默认值为 null。
public int getFirstVisibleRow()
public double getFocusAlpha()
public String getIconField()
默认情况下,列表类不会在行内显示具有文本的图标。然而,通过指定图标字段,您可以指定已创建并显示为行内图标的图形。DataGrid 会忽略此属性。
默认值为 null。
public String getLabelField()
默认情况下,列表查找每个项目上以属性命名的标签并显示它。但是,如果数据对象不包含标签属性,则您可设置 labelField 属性以使用数据对象中的不同属性。
默认值为标签
。
public int getLastVisibleRow()
public int getLockedColumnCount()
public int getLockedRowCount()
public int getNumColumns()
public int getNumRows()
public Color getRollOverColor()
public int getRowCount()
如果已明确设置了组件高度,则此属性可能不会产生任何影响。
对于 DataGrid 控件,rowCount 属性包括标题行。所以如果 DataGrid 控件有 3 个正文行和 1 个标题行,则 rowCount 属性为 4。
默认值为 4。
public double getRowHeight()
除非 variableRowHeight 属性为 true,否则所有行的高度都相等。如果未指定,则行高以呈现器的字号和其他属性为基础。
public boolean isSelectable()
如果为 true,则控件支持选定内容。默认情况下,Menu 类(其子类 ListBase)设置此属性为 false,因为它不会将所选菜单项目显示为已选择。
默认值为 true。
public int getSelectedIndex()
默认值为 -1(无所选项目)。
public List<Integer> getSelectedIndices()
项目处于倒序状态,用户以倒序选择了项目。
默认值为 [ ]。
public String getSelectedItem()
默认值为 null。
public List<String> getSelectedItems()
项目处于倒序状态,用户以倒序选择了项目。
默认值为 [ ]。
public Color getSelectionColor()
public Color getSelectionDisabledColor()
public boolean isShowDataTips()
如果为 true,则显示数据提示。数据提示是专用于显示对于行太长的文本的工具提示。如果您设置 dataTipFunction,则无论文本对于行是否太长,都会显示数据提示。
默认值为 false。
public Color getTextRollOverColor()
public Color getTextSelectedColor()
public boolean isUseRollOver()
如果为 true,鼠标在行上滚动时突出显示行。如果为 false,仅在选择了行时突出显示行。
默认值为 true。
public boolean isVariableRowHeight()
TileList 和 HorizontalList 会忽略此属性。如果为 true,各行可具有不同高度。
默认值为 false。
public String getVerticalAlign()
可能值为:上、居中和下。DataGrid 根据此样式和 paddingTop 与 paddingBottom 样式确定呈现器在行中的位置。
默认值为上
。
public boolean isWordWrap()
如果为 tru,则启用行中文本的自动换行。仅在 variableRowHeight 属性也为 true 时生效。
默认值为 false。
Copyright 2009-2012 Micro Focus. All Rights Reserved.