新版表单

索引

接口
描述
OreUIForm客户端打开新版多功能表单
GetOreUIFormData客户端获取或更新新版多功能表单数据
GetOreUIFormConfig客户端获取新版多功能表单配置
OreUIFormRightContentRefresh客户端刷新新版多功能表单右侧内容

OreUIForm

客户端

  • 描述
    打开新版多功能表单

  • 参数

参数名数据类型说明
FormConfiglist表单配置
FormDatadict表单预设数据,默认为空字典
Titlestr表单标题,默认为None
IsESCbool是否按下ESC键关闭表单,默认为True
IsIconbool是否显示物品图标,默认为False
IsChildbool是否为子表单,默认为False
CloseCallBackFunctionfunction关闭表单时调用的函数,默认为None
  • 返回值

  • 备注

    • 图例 image-cxuj.png
    • IsIconTrue时,按钮控件配置参数FunctionNameEditItemIcon的函数将直接调用物品选择器来编辑图标(物品图标数据Key为ItemIconData,不要冲突了!)
    • FormConfig控件说明。
      • 左侧按钮控件(接收一个参数)

        参数名数据类型说明
        Typestr控件类型button_green(绿色按钮),button_white(白色按钮),button_red(红色按钮)
        SubTypestr控件次类型default(普通按钮),commit(提交按钮),默认为default
        ButtonNamestr按钮显示文字
        FunctionNamestr按钮函数名称(选填)
        FunctionObjectobject按钮函数所在类(选填)
        FunctionInstancefunction按钮函数实例(选填)
        • 备注
          • 按钮绑定的函数需要接收一个参数,当次类型为default时,接收的参数为按钮原生事件数据。当此类型为commit时,接收的参数为表单输出数据。
          • FunctionNameFunctionInstance都可以填写,但是FunctionInstance优先级最高,FunctionName填写了但是没有FunctionObject的时候默认使用该UI界面的Object
      • 分类控件

        参数名数据类型说明
        Typestr控件类型tab
        ButtonNamestr按钮显示文字
        TexturePathstr分类图标路径,如textures/ui/aaa
        ContentDatalist子控件配置信息,子控件不能存在tab类型控件
      • 提示控件

        参数名数据类型说明
        Typestr控件类型tips
        Keystr填写不重复即可
        Titlestr控件标题
        Tipsstr控件详细说明
      • 输入控件

        参数名数据类型说明
        Typestr控件类型input(单行输入),input_large(多行输入)
        Keystr数据输出时所在键(不同tabKey一致无法共存)
        Titlestr控件标题
        Tipsstr控件说明(选填)
        Contentstr控件默认文字(选填)
      • 按钮型输入控件

        参数名数据类型说明
        Typestr控件类型input_button
        Keystr数据输出时所在键(不同tabKey一致无法共存)
        Titlestr控件标题
        Tipsstr控件说明(选填)
        Contentstr控件默认文字(选填)
        ButtonNamestr按钮名称
        FunctionNamestr按钮函数名称(选填)
        FunctionObjectobject按钮函数所在类(选填)
        FunctionInstancefunction按钮函数实例(选填)
        • 备注
          • 绑定的按钮事件函数需要接收一个参数,该参数类型为按钮类型返回。可以通过Key为ButtonPath来获取同级的输入框edit_box路径。
      • 单选控件

        参数名数据类型说明
        Typestr控件类型select
        Keystr数据输出时所在键(不同tabKey一致无法共存)
        Titlestr控件标题
        Tipsstr控件说明(选填)
        Contentlist[str]选项内容
        NormalSelectstr默认选项内容
      • 信息型按钮列表控件 image-okBZ.png

        参数名数据类型说明
        Typestr控件类型list_button
        Keystr填写不重复即可
        Titlestr控件标题
        Tipsstr控件说明(选填)
        Contentlist信息型按钮列表
        • 信息型按钮组说明,Content下每个list代表一行,在一行中填写按钮配置即可。

        • 信息型按钮配置说明

          参数名数据类型说明
          Titlestr列表标题
          ButtonNamestr右侧按钮名称
          Informationstr列表详细信息(选填)
          IconPathstr列表图标路径(选填)
          IconItemstr列表图标物品名称(选填)
          FunctionNamestr按钮函数名称(选填)
          FunctionObjectobject按钮函数所在类(选填)
          FunctionInstancefunction按钮函数实例(选填)
        • IconPathIconItem选填其一即可,其中IconItem优先级更高。

      • 开关控件

        参数名数据类型说明
        Typestr控件类型toggle
        Keystr数据输出时所在键(不同tabKey一致无法共存)
        Titlestr控件标题
        Tipsstr控件说明(选填)
        Contentbool开关默认状态(选填,默认为False)
      • 按钮组控件

        参数名数据类型说明
        Typestr控件类型button
        Keystr填写不重复即可
        Titlestr控件标题
        Tipsstr控件说明(选填)
        Contentlist按钮组
        • 按钮组说明,Content下每个list代表一行,在一行中填写按钮配置即可。

        • 按钮配置说明

          参数名数据类型说明
          ButtonTypestr按钮类型white,red,green,locked(禁用)
          ButtonNamestr按钮名称
          FunctionNamestr按钮函数名称(选填)
          FunctionObjectobject按钮函数所在类(选填)
          FunctionInstancefunction按钮函数实例(选填)

GetOreUIFormData

客户端

  • 描述
    获取或更新*新版多功能表单数据

    • 更新:指进行合并操作,而不是直接替换
  • 参数

参数名数据类型说明
NewFormDatadict新的表单数据字典,默认为None
  • 返回值
    表单数据字典 (dict)

  • 备注


GetOreUIFormConfig

客户端

  • 描述
    获取新版多功能表单配置

  • 参数

  • 返回值
    表单配置列表 (dict)

  • 备注


OreUIFormRightContentRefresh

客户端

  • 描述
    获取新版多功能表单配置

  • 参数

参数名数据类型说明
RightContentDatadictOreUIConfig的tab数据字典
IsReplacebool是否替换OreUIForm中的FormConfig参数
  • 返回值

  • 备注

评论交流

文档目录

灵免以太