fscript 的 widget 扩展函数

最新推荐文章于 2024-05-16 02:25:11 发布
最新推荐文章于 2024-05-16 02:25:11 发布
阅读量2.2k 收藏 1
点赞数 1
分类专栏： AWTK
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/absurd/article/details/112424451
版权

fscript 的 widget 扩展函数

1. 介绍

fscript 的 widget 扩展函数只能在 widget 的事件处理函数中使用，包括传统的 AWTK 应用程序和 AWTK-MVVM 应用程序的事件处理函数。

fscript 和其它主流脚本 (lua/js) 相比，最大的优势就是体积小巧，而且 AWTK 本身依赖于 fscript，所以使用 fscript 增加额外代码可以忽略不计数。

在 AWTK 的 UI 文件中直接嵌入 fscript, 有如下优势：

    1. 在特定情况下，可以极大简化程序的实现。

比如下面的代码，点击按钮时打开指定的窗口就非常简洁。

    <button focusable="true" focused="true" on:click="open(basic)" text="Basic" />

比如下面的代码，点击按钮时关闭当前的窗口也非常简洁。

    <button focusable="true" on:click="close()" text="Close" />
    1. 方便工具（如 designer) 生成向导代码。

一般的 IDE 都有简单的代码生成功能，比如按钮的事件处理函数可以选择打开或关闭窗口等简单的功能。不排除 designer 以后增加类似的功能。

    1. 让 MVVM 应用程序有机会去操作界面。

理论上，模型是不能操作界面的，但在特殊情况下，确实有操作界面的需求。在保持视图和模型独立的前提下，fscript 让操作界面成为可能。

    1. 方便生成自定义的组件。很多情况下，需要对现有的控件进行改进和组合，生成新的控件。

比如，我们需要用 text selector 生成一个日期选择控件，用三个 text selector 控件组合成日期选择控件，分别选择年月日。但是 text selector 之间是独立的，而年月和日则是有依赖关系，比如 1 月的天数是 31 天，2 月的天数与年份有关。当然我们可以用 C 代码来建立三者的关系，而用 fscript，不但实现要简单一些，而且由于 xml 和代码在一起，发布和重用也非常方便。

  <row x="10" y="30" w="100%" h="150" children_layout="default(row=1,col=3)">
    <text_selector name="year" options="2000-2050" selected_index="9">
      <property name="on:value_changed">
        <![CDATA[
        a = get_days_of_month(widget_get(parent.year, value), widget_get(parent.month, value))
        widget_set(parent.day, "options", iformat( "1-%d", a) + "%02d")        
         ]]>
      </property>
    </text_selector>
    <text_selector name="month" options="1-12-%02d" selected_index="8" loop_options="true">
      <property name="on:value_changed">
        <![CDATA[
        a = get_days_of_month(widget_get(parent.year, value), widget_get(parent.month, value))
        widget_set(parent.day, "options", iformat( "1-%d", a) + "%02d")
        ]]>
      </property>
    </text_selector>
    <text_selector name="day" options="1-31-%02d" selected_index="9" />
  </row>

2. 事件处理函数

添加事件处理函数，实际上是增加一些自定义的属性，属性名以 on: 开头，紧跟事件名称。如：

    <button focusable="true" on:click="close()" text="Close" />

为了方便编辑和阅读，对于比较复杂的脚本，可以把事件处理函数独立出来，放到 property 里，并用 CDATA 包装起来。

<button name="timer" focusable="true" on:click="start_timer(100)" text="Start Timer">
<property name="on:timer"><![CDATA[
  a = widget_lookup(window, bar, true)
  b = widget_get(a, "value")
  if(b < 100) {
    widget_set(a, "value", b + 1)
  } else {
    widget_set(a, "value", 0)
    stop_timer()
  }
]]></property>
</button>

如果处理逻辑太复杂，请不要用 fscript 实现，否则不好调试。要善用 fscript 的优点而回避它的缺点。

3. 目前支持的事件

  • global_key_up
  • global_key_down
  • global_key_long_press
  • key_up
  • key_down
  • key_long_press
  • key_down_before_children
  • key_up_before_children

按键事件处理函数可以从 key 变量获取当前的键值。可以从 alt, ctrl, cmd 和 menu 变量中获取相应控制键的状态。如：

  <property name="on:global_key_down">
    print("global keydown:", key, "alt=", alt, "ctrl=", ctrl, "cmd=", cmd, "menu=", menu);
  </property>
  <property name="on:global_key_up">
    print("global keyup:", key, "alt=", alt, "ctrl=", ctrl, "cmd=", cmd, "menu=", menu);
  </property>
  <property name="on:global_key_long_press">
    print("global key_long_press:", key, "alt=", alt, "ctrl=", ctrl, "cmd=", cmd, "menu=", menu);
  </property>
  <property name="on:key_down">
    print("keydown:", key, "alt=", alt, "ctrl=", ctrl, "cmd=", cmd, "menu=", menu);
  </property>
  <property name="on:key_up">
    print("keyup:", key, "alt=", alt, "ctrl=", ctrl, "cmd=", cmd, "menu=", menu);
  </property>
  <property name="on:key_long_press">
    print("keyup:", key, "alt=", alt, "ctrl=", ctrl, "cmd=", cmd, "menu=", menu);
  </property>
  • pointer_up
  • pointer_down
  • pointer_move
  • click

指针事件处理函数可以从 x/y 变量获取当前指针的位置。可以从 alt, ctrl, cmd 和 menu 变量中获取相应控制键的状态。如：

  <property name="on:pointer_down">
    print("pointerdown:", x, y, "alt=", alt, "ctrl=", ctrl, "cmd=", cmd, "menu=", menu);
  </property>
  <property name="on:pointer_up">
    print("pointerup:", x, y, "alt=", alt, "ctrl=", ctrl, "cmd=", cmd, "menu=", menu);
  </property>
  <property name="on:click">
    print("click:", x, y, "alt=", alt, "ctrl=", ctrl, "cmd=", cmd, "menu=", menu);
  </property>
  • timer
    示例：
<button name="timer" focusable="true" on:click="start_timer(100)" text="Start Timer">
<property name="on:timer"><![CDATA[
  a = widget_lookup(window, bar, true)
  b = widget_get(a, "value")
  if(b < 100) {
    widget_set(a, "value", b + 1)
  } else {
    widget_set(a, "value", 0)
    stop_timer()
  }
]]></property>
</button>
  • window_close
  • window_open
  • window_will_open

窗口事件只适用于窗口。

  <property name="on:window_open">
    print("window_open")
  </property>
  <property name="on:window_will_open">
    print("window_will_open")
  </property>
  <property name="on:window_close">
    print("window_close")
  </property>
  • value_changed
<progress_bar name="bar" text="" value="10" on:value_changed="print(widget_get(self,value))"/>
  • focus
  • blur

示例：

<edit name="edit" tips="text edit" on:focus="print(focus)" on:blur="print(blur, widget_get(self,value))"/>
  • value_changed_by_ui （仅 MVVM 支持）

在 MVVM 中，除了支持以上方式编写 fscript，也可以通过 v-on: 和 v-data: 的方式使用 fscript，请参考 MVVM 的文档。

4. 事件的返回值

  • 事件缺省返回 RET_OK。

  • 如果需要在执行完成后移除事件处理函数，可以设置 RET_REMOVE 为 true。

RET_REMOVE=true
  • 如果需要在执行完成后停止后续事件处理，可以设置 RET_STOP 为 true。
RET_STOP=true

5. widget 相关的扩展函数

5.1 open

打开窗口。

原型
open(name, close_current, switch_to_if_exist)
  • close_current 可选。为 true 时关闭当前窗口。
  • switch_to_if_exist 可选。为 true 时，如果同名窗口存在，直接切换到指定窗口。

示例

    <button text="Open" focusable="true" focus="true" on:click="open(test_fscript)"/>
    <button text="Close" focusable="true" on:click="open(test_fscript, true)"/>
    <button text="Switch TO" focusable="true" on:click="open(test_fscript, false, true)"/>

5.2 close

关闭窗口。

原型
close(name)
  • name 可选。缺省关闭当前窗口。

示例

<button focusable="true" on:click="close()" text="Close" />

5.3 back

退到前一个窗口

原型
back()

示例

<button focusable="true" on:click="back()" text="back" />

5.4 back_to_home

退到主窗口

原型
back_to_home()

示例

<button focusable="true" on:click="back_to_home()" text="home" />

5.5 quit

退出应用程序

原型
quit()

示例

<button focusable="true" on:click="quit()" text="quit" />

5.6 tr

翻译指定字符串

原型
tr(str)

示例

<button focusable="true" on:click="print(tr(OK))" text="tr" />

5.7 widget_lookup

查找指定的控件

原型
widget_lookup(widget, path)
widget_lookup(widget, name, recursive)
  • widget 用作锚点，后面的路径相对于该 widget。self 表示当前控件，parent 表示当前控件的父控件，window 表示当前的窗口，window_manager 表示窗口管理器。

示例

查找窗口下名为 view 控件下的名为 bar 的控件。

  a = widget_lookup(window, view.bar)

递归查找窗口下名为 bar 的控件。

  a = widget_lookup(window, bar, true)

递归查找当前控件下名为 bar 的控件。

  a = widget_lookup(self, bar, true)

递归查找当前控件的父控件下名为 bar 的控件。

  a = widget_lookup(self, bar, true)

5.8 widget_get

获取控件的属性

原型
widget_get(widget, prop)
widget_get(widget, path.prop)

  • widget 用作锚点，后面的路径相对于该 widget。self 表示当前控件，parent 表示当前控件的父控件，window 表示当前的窗口，window_manager 表示窗口管理器。

  • prop 可以是简单的属性命名，也可以是 widget 路径+属性名。

示例

获取当前控件的 value

widget_get(self, value)

获取当前控件下名为 bar 控件的 value

widget_get(self, bar.value)

获取当前控件的父控件下名为 bar 控件的 value

widget_get(self, bar.value)

获取当前控件的父控件下名为 bar 控件的 value

widget_get(parent, bar.value)

获取当前窗口下名为 bar 控件的 value

widget_get(window, bar.value)

获取当前窗口下名为 view 控件下名为 bar 控件的 value

widget_get(window, view.bar.value)

5.9 widget_set

设置控件的属性

原型
widget_set(widget, prop, value)
widget_set(widget, path.prop, value)

  • widget 用作锚点，后面的路径相对于该 widget。self 表示当前控件，parent 表示当前控件的父控件，window 表示当前的窗口，window_manager 表示窗口管理器。

  • prop 可以是简单的属性命名，也可以是 widget 路径+属性名。

示例

设置当前控件的 value

widset_set(self, value, 12)

设置当前控件下名为 bar 控件的 value

widset_set(self, bar.value, 12)

设置当前控件的父控件下名为 bar 控件的 value

widset_set(self, bar.value, "abcd")

设置当前控件的父控件下名为 bar 控件的 value

widset_set(parent, bar.value, 1.2)

设置当前窗口下名为 bar 控件的 value

widset_set(window, bar.value, "hello")

设置当前窗口下名为 view 控件下名为 bar 控件的 value

widset_set(window, view.bar.value, 12)

5.10 widget_create

创建控件

原型
widget_create(type, parent, x, y, w, h)
  • type 为控件的字符串名称。
  • parent 为父控件。可以是 widget 对象，也可以是 widget 的路径。

示例

        a = widget_lookup(window, foobar, true)
        if(value_is_null(a)) {
          a = widget_create("label", window.view, 0, 0, 0, 0)
          assert(!value_is_null(a))

          widget_set(a, text, "Dynamic created")
          assert(widget_get(a, text) == "Dynamic created")
          widget_set(a, name, "foobar")
          assert(widget_get(a, name) == "foobar")
        } else {
          print("foobar exist");
        }

5.10 widget_destroy

销毁控件

原型
widget_destroy(widget)
  • widget 可以是 widget 对象，也可以是 widget 的路径。

示例

        a = widget_lookup(window, foobar, true)
        if(!value_is_null(a)) {
          widget_destroy(a)
        } else {
          print("not found foobar");
        }

widget_destroy(self.bar)
widget_destroy(window.view.bar)

5.11 start_timer

开启一个定时器

原型
start_timer(duration)
  • duration 为定时器时间间隔。
  • 一个控件只能开启一个定时器，如果定时器存在，自动先移除之前的定时器。
  • 定时器时间到了之后，会触发控件的 timer 事件，所以对应的控件需要处理 timer 事件。

示例

      <button name="timer" focusable="true" on:click="start_timer(100)" text="Start Timer">
        <property name="on:timer">
          <![CDATA[
        a = widget_lookup(window, bar, true)
        b = widget_get(a, "value")
        if(b < 100) {
          widget_set(a, "value", b + 1)
        } else {
          widget_set(a, "value", 0)
          stop_timer()
        }
]]>
        </property>
      </button>

5.12 stop_timer

停止指定控件的定时器

原型
stop_timer()
stop_timer(widget)
  • 不指定 widget 是停止当前控件的定时。
  • widget 可以是 widget 对象，也可以是 widget 的路径。

示例

stop_timer(parent.timer)

示例参考

  • https://github.com/zlgopen/awtk/blob/master/design/default/ui/main_fscript.xml

  • https://github.com/zlgopen/awtk/blob/master/design/default/ui/text_selector_fscript.xml

  • https://github.com/zlgopen/awtk/blob/master/design/default/ui/button_fscript.xml

  • https://github.com/zlgopen/awtk/blob/master/design/default/ui/test_fscript.xml

  • https://github.com/zlgopen/awtk/blob/master/design/default/ui/basic_fscript.xml

可以用 preview_ui 直接运行。如：

./bin/preview_ui.exe design/default/ui/main_fscript.xml
李先静
关注
  • 1
    点赞
  • 踩
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
【使用 PyQt6-第02章】Qt Widgets小部件函数
gongdiwudu的专栏
06-13 7496
摘要：QWidget是最基本的可视化部件，它的函数繁多，本文将系统列出全部函数，和其意义，以方便查询和使用。
FScript-开源
04-25
FScript是一种简单但功能强大的脚本语言。 它的预期用途是作为其他Java程序中的嵌入式语言。 它的主要好处是简单的扩展选项和较小的尺寸（罐子大约50k）。 FScriptME是用于J2ME的FScript。
script-widget:在Flutter应用中添加动态创建的，脚本驱动的小部件。 完全用脚本语言编写UI和逻辑
04-01
script_widget 一个新的Flutter软件包项目。 入门 该项目是Dart的起点，Dart是一个库模块，其中包含可以在多个Flutter或Dart项目之间轻松共享的代码。 要获得Flutter入门方面的帮助，请查看我们的，其中提供了教程，示例，有关移动开发的指南以及完整的API参考。
【Qt】QWidget类详解(函数篇)_qt qwidget 常用函数
最新发布
2401_85014148的博客
05-16 501
QWidget类是所有用户界面对象的基类。
【Qt】QWidget类详解(函数篇)
C/C++软件工程师、嵌入式软件工程师、物联网研发工程师、C/C++讲师、物联网讲师、嵌入式讲师---欢迎大家一起交流(私信添加博主微信)
03-29 7199
00. 目录 文章目录00. 目录01. 概述02. Reimplemented Public Functions03. Public Slots04. Signals05. Static Public Members06. Protected Functions07. Reimplemented Protected Functions08. Protected Slots09. Macros10. 函数11. 附录 01. 概述 QWidget类是所有用户界面对象的基类。 02. Reimplemente
AWTK fscript 脚本引擎
国产开源 GUI 引擎 AWTK
11-21 2765
AWTK fscript 脚本引擎 1. 介绍 fscript 是一个极简的脚本引擎，借鉴了函数语言中一些思路，主要用于低端嵌入式系统，让用户轻松扩展现有系统，而不需要重新编译和下载固件。 特色： 小内存。最低开销小于 400 字节。 小巧。核心代码 600 行，扩展函数 600 行。 灵活。支持多条语句、函数嵌套调用和变量定义。 强大。超过 50 个内置函数，支持用 C 语言扩展函数。 如果不需要数学函数，可以定义 AWTK_LITE 宏。 keil -O1 编译结果： Co
AWTK学习笔记
qasxc78563的博客
06-26 947
编译：scons运行：.\bin\demo.exexml文件存放在工程的design\default\ui文件夹内c文件存放在工程的src文件夹内如果代码没有指定修改，默认按照AWTK Designer设置的控件属性动作运行API函数查看使用说明：https://awtk.zlg.cn/api/awtk/
fscript-1.0.jar
11-22
实测可用
fscript-2.0.jar
11-22
实测可用
fscript-2.1.3.jar
11-22
实测可用
fscript-2.1.1.jar
11-22
实测可用
fscript:FScript的叉子，Java的简单可嵌入脚本语言
05-13
脚本 是一种非常简单的脚本语言。 它的预期用途是作为其他Java程序中的嵌入式语言。 它不是完整的编程语言。 如果您需要其中之一，我建议您看一下： ：Java中出色的Python语言的实现。 ：Java中JavaScript的实现。 两者都是完全可嵌入的，并且具有理智的许可证。 但是，作为一个jar文件，FScript大约是60k，只有几千行的源代码。 因此，如果您要寻找的功能不只是简单的配置文件解析器，而是不适合使用完整的编程语言FScript。 唯一的要求是Java 2运行时环境。 它是根据LGPL许可的。 有关更多信息，请参见'docs'目录。 笔记 由于我认为Sourceforge时代已经过去，因此我决定分叉/保存这种小语言实现方式以供后代使用。 如果满足我的需求，我会尝试使用它并尝试对其进行维护。
FScript0.15:一个简单的文字冒险游戏引擎
05-09
README Preview DEMO （包含以下内容） FScript 0.2 缘之空同人0.15 [动漫音乐包] 0.15beta 0.09beta 示例 翻版缘之空0.053 fs 0.04beta 分支以及相关系列说明 ：采用自定义fscript语法驱动引擎 *init_echo { //这一段用于初始化echo和rolename框 epic "pic\sys\echo.png",0,400 epos 28,498,0 efontsize 25 ewidth 720 ecolor 255,255,255 rpic "pic\sys\none.png",5,415 rpos 55,465,0 rfontsize 25 rwidth 200 rcolor 255,255,255 } *show_logo { wait 500 bk "pic\sys\logo.jpg" wai
使用 lua 运行 fscript
国产开源 GUI 引擎 AWTK
08-06 6395
使用 lua 运行 fscript 笔记。
F-Script:一个轻量级的JavaScript脚本语言
gitblog_00004的博客
03-06 346
F-Script:一个轻量级的JavaScript脚本语言 项目链接 F-Script是一种轻量级的JavaScript脚本语言，由Pascal Mougin开发。它的设计目标是为用户提供一种简单、易学、高效的编程方式，并可以在浏览器中运行。 能用来做什么？ F-Script可以用于网页交互、数据处理、自动化任务等多种场景。下面是一些具体的应用例子： 网页交互：通过添加一些简单的F-Script...
嵌入式开发之AWTK
m0_47104421的博客
08-21 3607
AWTK的简单使用和入门
awtk开发实践——学习篇4: HelloWorld.Xml-Demo修改-自定义事件
weixin_42645653的博客
10-15 777
说明：   本文章旨在总结备份、方便以后查询，由于是个人总结，如有不对，欢迎指正；另外，内容大部分来自网络、书籍、和各类手册，如若侵权请告知，马上删帖致歉。   QQ 群 号：513683159 【相互学习】 内容来源：   官方的手册（免费获取）Pxx=该手册的对应页码xx   github-awtk 界面布局 程序说明   在HelloWorld.Xml-Demo 的基础上修改代码【新增处均有备注新增】，当用户点击“inc”按钮或“dec”按钮时，调用 widget_dispatch 分发一个自定义事
AWTK之多线程
m0_47104421的博客
08-24 656
由AWTK idle至此
控件下的Lookup方法
weixin_30629653的博客
07-19 173
如果想重写系统的某个数据源下的字段的Lookup，则可以在此控件下重写Lookup方法，不调用其父级数据源下字段的looku即可。 以下是一个关于重写Lookup方法的例子，可参考： [FormControlEventHandler(formControlStr(SalesTable, SalesLine_ItemId), FormControlEventType::Lookup)] ...
安卓学习笔记之使用widget桌面小控件及源码分析
pecuyu
04-02 4010
安卓学习笔记之使用widget桌面小控件一、 使用步骤创建所需要的Receiver，并在清单文件中配置 <!-- 桌面小部件 --> <receiver android:name="com.yu.receiver.SaferAppWidgetProvider" > <intent-filter> <action android:

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值