LookupScreenFacet

在线示例

LookupScreenFacet 本质上是一个 ScreenFacet，但是添加了一组选项，用于打开实体查找界面。

组件的 XML 名称：lookupScreen。

属性

除了支持 ScreenFacet 的 属性 外，LookupScreenFacet 具有 EditorScreenFacet 的下列属性：

事件和处理器

如需使用 Jmix Studio 生成处理器的桩代码，需要在界面 XML 描述或者 Jmix UI 层级结构面板选中 facet 元素，然后用 Jmix UI 组件面板的 Handlers 标签页生成。

或者可以使用界面控制器顶部面板的 Generate Handler 按钮。

AfterCloseEvent

AfterCloseEvent 在 facet 配置的界面之后关闭发送。参阅 AfterCloseEvent 了解细节。

AfterShowEvent

AfterShowEvent 在 facet 配置的界面展示之后发送。参阅 AfterShowEvent 了解细节。

OptionsProvider

参阅 OptionsProvider。

编程式用法，调用 setOptionsProvider() 方法。

ScreenConfigurer

参阅 ScreenConfigurer。

SelectHandler

SelectHandler 代理方法支持获取查找界面选择的实体集合。下面例子中，点击按钮打开 Customer 实体的查找界面，所选 customer 的 email 写入 textField：

<facets>
    <lookupScreen id="lookupScreen"
                  entityClass="ui.ex1.entity.Customer"
                  openMode="DIALOG"
                  screenClass="ui.ex1.screen.entity.customer.CustomerBrowse"
                  onButton="btn">
    </lookupScreen>
</facets>
<layout>
    <textField id="userField"/>
    <button caption="Button"
            id="btn"/>
</layout>
@Autowired
private TextField<String> userField;

@Install(to = "lookupScreen", subject = "selectHandler")
private void lookupScreenSelectHandler(Collection<Customer> collection) {
    if (!collection.isEmpty()) {
        userField.setValue(collection.iterator().next().getEmail());
    }
}

编程式用法，调用 setSelectHandler() 方法。

SelectValidator

是一个处理器，在查找界面点击 Select 时调用。参阅 SelectValidator 了解细节。

编程式用法，调用 setSelectValidator() 方法。

Transformation

是一个处理器，在查找界面选择实体并验证后调用。参阅 Transformation 了解细节。

编程式用法，调用 setTransformation() 方法。

XML 属性

可以在 Studio 界面设计器中的 Jmix UI 组件面板查看和编辑 facet 支持的属性。

container - entityClass - field - id - listComponent - onAction - onButton - openMode - screenClass - screenId