枚举器对象 [AHK_L 49+]

允许枚举容器中的项目.

Next

检索枚举中的下一个或多个项目.

Enum.Next(OutputVar1 , OutputVar2, ...)
OutputVar1, OutputVar2接收实现中的具体的值.
...附加参数, 如果支持.
返回值成功时返回非零整数, 没有项目剩余时则返回零.

对象

由 ObjNewEnum() 返回的枚举器对每个键值对只调用一次, 最多允许两个参数:

OutputVar1键值对中的键.
OutputVar2接收与 OutputVar1 关联的值.

键值对以实现定义的顺序返回. 即, 它们通常不会以赋值的顺序返回. 现有的键值对可以在枚举时修改, 但插入或移除键可能使得一些项目被多次枚举或一次都不枚举.

相关

For 循环, Object._NewEnum()

示例

; 创建一些样本数据.
obj := Object("red", 0xFF0000, "blue", 0x0000FF, "green", 0x00FF00)

; 进行枚举!
enum := obj._NewEnum()
While enum[k, v]
    t .= k "=" v "`n"
MsgBox % t

; 需要 [AHK_L 59+]
For k, v in obj
    s .= k "=" v "`n"
MsgBox % s