运行时版本: | Flash Player 10, AIR 2.0 |
动态创建的可视元素可使用此接口提供的方法,在显示这些元素之前进行自我配置。当创建或重用工厂生成的可视元素时,需要调用此方法。不可直接调用此方法。
所有工厂生成的可视元素都可以使用此接口,除了以下 itemRenderer:caretIndicator
、hoverIndicator
、editorIndicator
、selectionIndicator
、columnSeparator
、rowSeparator
、alternatingRowColorsBackground
(请参阅 DataGrid)、sortIndicator
(请参阅 GridColumnHeaderGroup)。这通常用于使用 DataGrid 样式的值来配置生成的可视元素。例如,要对插入标记的填充颜色使用 DataGrid“symbolColor”样式的值,需要定义 prepareGridVisualElement()
方法,如下所示:
public function prepareGridVisualElement(grid:Grid, rowIndex:int, columnIndex:int):void
{
caretStroke.color = grid.dataGrid.getStyle("caretColor");
}
rowIndex
和 columnIndex
参数指定可视元素要占用的单元格。如果 columnIndex
= -1,则可视元素占用 Grid 行。如果 rowIndex
= -1,则可视元素占用 Grid 列。
DataGridSkin.mxml 中有更多像这样的示例。请注意,如果不需要添加的灵活性,则自定义 DataGrid 外观可视元素可以选择不实现此接口。