创建一个Demo
创建Screen
首先以TestPage()作为内容进行演示。TestPage()是框架的示例页,位于可选的 demo 产物(src/demo)中;只在核心 jar 的 classpath 上时它不存在,需要把 demoJar 一起放进开发/预览 classpath。自己的模组不需要它。 如果要显示一个Screen,可以编写如下代码:
showScreen {
TestPage()
}
这会直接调用setScreen(),让界面出现在画面上。
showScreen是一个顶层函数,需要在DslExecuteContext环境中调用,例如写在clickable {}等回调里。
如果要获得创建的Screen对象,如下:
val screen = root.screenFactory.create("DSL Screen") {
TestPage()
}.screen as Screen
create的第一个参数是Screen的标题。这里必须进行类型转换,因为要跨版本支持。
不要在mod初始化过程中执行上述代码。那时平台还没发布(DslRuntime.start之前),建不了界面。使用按键或者modmenu等入口点触发这些代码。
创建自己的Page
只需要用自己的内容替换TestPage()即可。一个简单的示例:
showScreen {
Button(Modifier.size(60.scaled,20.scaled)) {}
DefaultBackground()
}
你将看到一个深色泥土背景(这取决于后端)和正中间的一个按钮。这个按钮不可点击。
在下一章节会开始更复杂、功能更强的ui界面。