ObservableMap · AHK_BeanLib

# ObservableMap Class 1. 性質：實例類 2. 開發目的：帶有監聽器的 Map，類似 JavaFX 中的 ObservableMap 為了與已有的「關聯數組」做出明確區分，ObservableMap 對 __Set() 做出限制，除了寫入 "Field" (初始化時)之外，任何的寫入都是不被允許的。另外，這個和「關聯數組」是不同的，獲取數據用 get()，加入不是用 push()，而是用 put()，刪除依然是 remove()，新增了 clear() 清除所有內容。 ## 域 Field ### Field 為避開對 __Set() 做出限制，而設置的變量。 ### Change 內部類，用于傳遞信息給 Listener #### __New(aObservableMap,aRemoved,aRemovedMap,aAdded,aAddedMap) aObservableMap - ObservableMap本身 aRemoved - 是否移除了 `Key-Vaule` aRemovedMap - 移除的 subMap aAdded - 是否添加了 `Key-Vaule` aAddedMap- 添加的 subMap #### getMap() 獲取 Change 所屬的 ObservableMap #### wasRemoved() Change 是否為移除 #### wasAdded() Change 是否為添加 #### getValueRemoved() 獲取移除的 subMap #### getValueAdded() 獲取添加的 subMap #### size() 獲取 Map 中元素的數量 ## 方法 Method ### __New(aMap:="") #### 參數 Parameters: - aMap - 生成ObservableMap的初始Map #### 返回 Returns: ObservableMap ### put(aKeyValue*) 放入 `key-value` 對 #### 參數 Parameters: - aKeyValue* ：被添加的 `key-value` 對 #### 返回 Returns: null ### remove(aKey*) 批量移除 `key-value` 對 #### 參數 Parameters: - aKey* ：被移除的 `Key` 列表 #### 返回 Returns: null ### clear() 清除所有`key-value` 對 #### 參數 Parameters: #### 返回 Returns: null ### get(aKey) 根據 `key` 獲取某個 `value` #### 參數 Parameters: - 需要獲取的 `value` 對應的 `key` #### 返回 Returns: Obj ### addListener(aMethod) #### 參數 Parameters: - 添加監聽器監聽器只有一個 `aChange` 參數 #### 返回 Returns: null ## 示例 Example ```AutoHotKey map := new ObservableMap(_Container.LetterAndNumberMap) map.addListener(new Method(Listeners.print,Listeners)) LogPrintln(map.get("A"),A_LineFile "(" A_LineNumber ")" " : " "map.get(""A"") >>> `r`n") map.remove("A","B") map.remove("C") map.put("W","18") map.put("T","20","X","24") map.clear() map := new ObservableMap(_Container.LetterAndNumberMap) map.addListener(new Method(Listeners.print,Listeners)) map["A"] ;~ map["A"] := "1" map.no() ``` ```AutoHotKey D:\AHKs\Dev\TPDD_ObservableMap.ahk(28) : map.get("A") >>> 1 減少: D:\AHKs\Dev\TPDD_ObservableMap.ahk(62) : aChange.getValueRemoved() >>> {A:1,B:2} 目前: D:\AHKs\Dev\TPDD_ObservableMap.ahk(65) : aChange.getMap() >>> {__Instance:ObservableMap,C:3,D:4,E:5,F:6,G:7,H:8,I:9,J:0} 減少: D:\AHKs\Dev\TPDD_ObservableMap.ahk(62) : aChange.getValueRemoved() >>> {C:3} 目前: D:\AHKs\Dev\TPDD_ObservableMap.ahk(65) : aChange.getMap() >>> {__Instance:ObservableMap,D:4,E:5,F:6,G:7,H:8,I:9,J:0} 增加: D:\AHKs\Dev\TPDD_ObservableMap.ahk(58) : aChange.getValueAdded() >>> {W:18} 目前: D:\AHKs\Dev\TPDD_ObservableMap.ahk(65) : aChange.getMap() >>> {__Instance:ObservableMap,D:4,E:5,F:6,G:7,H:8,I:9,J:0,W:18} 增加: D:\AHKs\Dev\TPDD_ObservableMap.ahk(58) : aChange.getValueAdded() >>> {T:20,X:24} 目前: D:\AHKs\Dev\TPDD_ObservableMap.ahk(65) : aChange.getMap() >>> {__Instance:ObservableMap,D:4,E:5,F:6,G:7,H:8,I:9,J:0,T:20,W:18,X:24} 減少: D:\AHKs\Dev\TPDD_ObservableMap.ahk(62) : aChange.getValueRemoved() >>> {D:4,E:5,F:6,G:7,H:8,I:9,J:0,T:20,W:18,X:24} 目前: D:\AHKs\Dev\TPDD_ObservableMap.ahk(65) : aChange.getMap() >>> {__Instance:ObservableMap,} ```