装备与物品
检查放入普通物品框装备特征字符
按关键字检查普通物品框中的装备名称，适用于按词缀、套装标记、性别后缀或特色字样做模糊筛选的场景。
命令用途
CheckPosDlgItemName 用于检查当前放入普通物品框中的装备名称是否带有指定特征字符。
这条命令必须配合 QueryItemDlg 使用，适合判断装备名里是否包含某个关键字、前缀、后缀或标记文字，再决定是否允许继续后续流程。
命令名
CheckPosDlgItemName
调用格式
CheckPosDlgItemName <特征字符>
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
特征字符 | 是 | 要匹配的关键字或名称片段。当前普通物品框中的装备名称带有这段文字时，#IF 条件成立。 |
返回或影响
- 这是检查型命令，只能在条件判断流程中使用。
- 这条命令必须基于
QueryItemDlg打开的当前普通物品框状态执行，不能脱离普通物品框流程单独使用。 - 当当前普通物品框中的装备名称包含参数里的特征字符时，
#IF条件成立。 - 如果普通物品框为空、关键字写错，或当前装备名称里不含这段文字，则条件不成立。
示例
基础用法
[@OnCheckItem]
#IF
CheckPosDlgItemName "战神"
#ACT
MessageBox "当前提交的是战神系列装备。"
#ELSESAY
当前只接受名称中带“战神”的装备。
这段写法用于按名称关键字筛选装备，比完整名称匹配更适合套装回收或系列装备判定。
常见变体
[@OnCheckItem]
#IF
CheckDlgItemType FASHION
CheckPosDlgItemName "(男)"
#ACT
TakeDlgItem
Give 时装凭证 1
#ELSEACT
MessageBox "当前提交的时装不符合要求。"
Break
这类写法适合先限制装备类型，再按名称中的特征字符进一步筛选，例如区分男女款时装、系列标签或特殊后缀。
注意事项
CheckPosDlgItemName适合做关键字匹配，不适合替代完整名称等值判断；要求完全一致时应优先使用CheckDlgItemName。- 当关键字过短或过于常见时，容易把不该通过的装备一起放行，脚本中应尽量使用有区分度的词段。
- 如果业务同时要求类型、名称片段和属性值都满足条件，应把
CheckDlgItemType、CheckPosDlgItemName和属性检查命令组合使用。 - 如果装备名称中包含性别、职业、星级或活动标记，这条命令更适合做首轮筛选。