装备与物品
获取普通物品框装备属性值到变量
读取普通物品框中装备的指定属性值到变量，适用于鉴定、重铸、回收计算和后续奖励生成流程。
命令用途
GetDlgItemValue 用于把当前普通物品框装备的指定属性值读取到变量中。
这条命令必须配合 QueryItemDlg 使用，常见于鉴定、装备重铸、随机重生成和回收脚本中，先把多项属性保存到变量，再组合后续扣除、返还或重新生成逻辑。
命令名
GetDlgItemValue
调用格式
GetDlgItemValue <变量> <属性位置>
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
变量 | 是 | 接收属性值的数值变量。常见写法如 M0、M67、M80。 |
属性位置 | 是 | 要读取的属性编号。默认按通用装备属性理解；当当前普通物品框里放入的是武器时，应按武器属性理解。完整编号可参考 装备属性位置。 |
返回或影响
- 这是取值型命令，会把目标属性值写入你指定的变量。
- 这条命令必须基于
QueryItemDlg打开的当前普通物品框状态执行，不能脱离普通物品框流程单独使用。 - 如果读取成功，后续脚本可以直接使用该变量参与判断、计算或重新生成装备。
- 如果普通物品框为空，或属性位置写错，得到的值通常不会是你期望的结果。
示例
基础用法
[@OnCheckItem]
#IF
CheckDlgItemType WEAPON
#ACT
GetDlgItemValue M3 3
MessageBox "当前武器的目标属性已经读取到 M3。"
这段写法用于在确认装备类型后，把指定属性值提取到变量里供后续使用。
常见变体
[@OnCheckItem]
#ACT
GetDlgItemValue M67 0
GetDlgItemValue M68 1
GetDlgItemValue M69 2
GetDlgItemValue M70 3
GetDlgItemValue M74 8
GetDlgItemValue M75 17
GetDlgItemValue M76 18
这类写法适合把一件装备的多项关键属性一次性读到变量中，供后续鉴定、改值或重构流程继续使用。
注意事项
GetDlgItemValue必须放在QueryItemDlg的后续标签中使用，没有当前普通物品框状态时读不到有效结果。- 连续读取多个属性前，最好先规划好变量编号，避免覆盖前面已经保存的结果。