打开普通物品框

命令用途

QueryItemDlg 用于打开普通物品框，让角色放入一件装备，再跳转到指定标签继续处理。

它常见于装备鉴定、武器升级、礼盒判定、装备回收和物品框类交互流程，是普通物品框脚本的常见入口命令。

命令名

QueryItemDlg

调用格式

QueryItemDlg <描述> <跳转标签> <是否删除装备>

参数说明

参数	必填	说明
`描述`	`是`	打开普通物品框时显示给用户的提示文字，用来说明当前要放入什么装备。
`跳转标签`	`是`	用户放入装备后继续执行的标签。后续通常在该标签里配合 `CheckDlgItemType`、`GetEquipProps` 等命令做校验或读取。
`是否删除装备`	`否`	`0` 表示默认处理，`1` 表示按当前功能需求删除放入装备。未明确需要删除时，通常写 `0`。

返回或影响

这是流程入口型命令，会弹出普通物品框，而不是在当前行直接返回判断结果。
用户提交装备后，会跳转到你指定的标签继续执行后续逻辑。
放入后的装备可继续通过检查物品框ID、检查放入普通物品框装备类型、检查放入普通物品框内装备名称、检查放入普通物品框装备特征字符、检查放入普通物品框装备属性值、获取物品框ID、获取普通物品框装备属性值到变量、获取装备属性、升级物品框装备、拿走普通物品框内装备等命令处理。

示例

基础用法

#ACT
QueryItemDlg "请放入需要鉴定的装备" @OnCheckItem 0

[@OnCheckItem]
#IF
CheckDlgItemType WEAPON
#ACT
MessageBox "已检测到你放入的是武器。"

这段写法用于先打开普通物品框，再在回调标签里判断用户放入的装备类型。

常见变体

#ACT
QueryItemDlg "请放入需要强化的装备" @OnUpgradeItem 0

[@OnUpgradeItem]
#ACT
GetEquipProps 10000 @OnGetEquipProps

[@OnGetEquipProps]
#ACT
UpgradeItemEx 10000 0 100 1 2 0

这类写法适合先通过普通物品框提交装备，再直接读取当前普通物品框装备并继续强化处理。

注意事项

QueryItemDlg 只负责打开普通物品框和进入后续标签，不会自动替你校验装备类型。
QueryItemDlg 不是在当前行直接返回结果的普通判断命令，真正决定后续流程的是你传入的回调标签。
如果业务要求用户只能提交某一类装备，后续应立即配合 CheckDlgItemType 或同类命令拦截。
当脚本改用 GetEquipProps 10000 读取当前普通物品框装备时，位置编号写法应和后续处理命令保持一致。
不要把 RetBoxItem 直接套用到 QueryItemDlg 这套普通物品框提交流程里。