LookupScreenFacet

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

组件的 XML 名称:lookupScreen

属性

除了支持 ScreenFacet属性 外,LookupScreenFacet 具有 EditorScreenFacet 的下列属性:

事件和处理器

如需使用 Jmix Studio 生成处理器的桩代码,需要在界面 XML 描述或者 Component Hierarchy 面板选中 facet 元素,然后用 Component Inspector 面板的 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 界面设计器中的 Component Inspector 面板查看和编辑 facet 支持的属性。