如何用AHK实现相对增减当前值至用户指定目标值？

问题背景 #

需要实现一个AHK函数，通过Up/Down键循环切换窗口的5种颜色状态（映射为1=Red、2=Green、3=Blue、4=Black、5=White）：

• Up键：向前循环（如5→1）
• Down键：向后循环（如1→5）
  无法直接绝对设置状态，需计算从当前状态到目标状态的最优按键次数及方向。

核心逻辑 #

1. 将当前状态StateIs和目标状态Value转换为整数，避免字符串运算问题
2. 计算两种切换方向的步数：
   • Up方向步数：(Target - Current + 5) % 5，处理循环场景（如当前5到目标1，计算得1步）
   • Down方向步数：(Current - Target + 5) % 5，处理反向循环（如当前3到目标1，计算得2步）
3. 选择步数更少的方向执行按键；若步数相同（仅当状态总数为偶数时可能，此处5为奇数不会出现），可任选其一

完整实现代码 #

SetState(Value := ""){
    ; 将颜色映射为整数1-5
    Value := Value = "Red"    ? 1
          : Value = "Green"  ? 2
          : Value = "Blue"   ? 3
          : Value = "Black"  ? 4
          : 5  ; 默认White

    StateIs := GetState()  ; 获取当前状态，返回字符串需转整数
    StateIs := StrToInt(StateIs)
    
    totalStates := 5
    upSteps := (Value - StateIs + totalStates) % totalStates
    downSteps := (StateIs - Value + totalStates) % totalStates

    ; 选择步数最少的方向发送按键
    if (upSteps < downSteps) {
        if (upSteps > 0)  ; 相同状态无需按键
            SendInput, {Up %upSteps%}
    } else {
        if (downSteps > 0)
            SendInput, {Down %downSteps%}
    }
}

; 示例调用：按Space键切换到Green状态
Space::SetState("Green")

逻辑解释 #

• 加totalStates再取模是为了避免出现负数结果，确保步数始终为非负整数
• 当当前状态与目标状态相同时，upSteps和downSteps均为0，不执行任何按键
• 优先选择步数更少的方向，减少按键操作次数

内容的提问来源于stack exchange，提问作者Ralf_Reddings