3.6.5. 选取器控件的标准行为（历史版本）

这是旧版本 API。从 7.0 版本开始的新 API，请参考 选取器控件操作。

对于 PickerField，LookupPickerField 和 SearchPickerField 组件，一组标准行为是通过 PickerField.ActionType 枚举类型来定义的；操作的实现是 PickerField 接口的内部类，下面详细介绍这些实现。

在选取器组件中使用标准操作的示例：

<searchPickerField optionsDatasource="coloursDs"
                 datasource="carDs" property="colour">
  <actions>
      <action id="clear"/>
      <action id="lookup"/>
      <action id="open"/>
  </actions>
</searchPickerField>

LookupAction - 查找

LookupAction – 使用 lookup 标识符的 action。用来选取实体实例然后将选中的实体设置成组件的值。当触发这个动作的时候，会打开实体的查找界面。

LookupAction 类中定义了下面这些特殊的方法：

  • setLookupScreenOpenType() 可以设置实体选择界面的打开模式。默认 THIS_TAB - 当前标签页。

  • setLookupScreen() 可以设置实体查找界面的标识符。默认情况下，使用 {entity_name}.lookup，比如 sales_Customer.lookup。如果不存在这种类型的界面，则会尝试打开 {entity_name}.browse 界面，比如 sales_Customer.browse。

  • setLookupScreenParams() 可以设置传递给查找界面的 init() 方法的参数。

  • afterSelect() 当选择的实体被设置到可视化组件的值之后，调用此方法。这个方法本身没有实现，可以通过继承重写此方法来处理这个事件。

  • afterCloseLookup() 不管是否选择了实体，只要关闭了查找界面就会最后调用此方法。这个方法本身没有实现，可以通过继承重写此方法来处理这个事件。

ClearAction - 清空

ClearAction - 使用 clear 标识符的 action。用来清空组件的值（比如设置成 null）。

OpenAction - 打开

OpenAction - 使用 open 标识符的 action。用来打开编辑组件当前值关联实体的编辑界面。

OpenAction 类中定义了下面这些特殊的方法：

  • setEditScreenOpenType() 可以设置实体编辑界面的打开模式。默认 THIS_TAB - 当前标签页。

  • setEditScreen() 可以设置实体编辑界面的标识符。默认情况下，使用 {entity_name}.edit，比如 sales_Customer.edit。

  • setEditScreenParams() 可以设置传递给编辑界面的 init() 方法的参数。

  • afterWindowClosed() 关闭了编辑界面之后调用此方法。这个方法本身没有实现，可以通过继承重写此方法来处理这个事件。