疊代子封裝了物件清單。應用程式會使用疊代子依序存取每一個物件。
疊代子亦會封裝一個游標,以維護清單中的現行位置。當建立疊代子時, 游標會位在第一個物件前面。
應用程式無法直接建立疊代子。疊代子只能使用某些函數來建立, 以便將物件清單傳回給應用程式。
這個類別為 Helper 類別。
函數 | 說明 |
---|---|
xmsIteratorDispose | 刪除疊代子。 |
xmsIteratorGetNext | 將游標移至下一個物件,並取得游標新位置處的物件。 |
xmsIteratorHasNext | 檢查是否還有其他物件位於游標現行位置外。 |
xmsIteratorReset | 將游標移回第一個物件前的位置。 |
xmsRC xmsIteratorHasNext(xmsHIterator iterator, xmsBOOL *moreProperties, xmsHErrorBlock errorBlock);
檢查是否還有其他物件位於游標現行位置外。此呼叫不會移動游標。