疊代子封裝了物件清單。應用程式會使用疊代子依序存取物件。
疊代子亦會封裝一個游標,以維護清單中的現行位置。當建立疊代子時, 游標會位在第一個物件前面。
應用程式無法使用建構子直接建立疊代子。疊代子只能使用某些方法來建立, 以便將物件清單傳回給應用程式。
這個類別為 Helper 類別。
virtual ~Iterator();
刪除疊代子。
如果應用程式試著刪除已刪除的疊代子, 則會忽略該呼叫。
xmsHIterator getHandle() const;
取得 C 應用程式在存取疊代子時所要使用的控點。
xmsVOID * getNext() const;
將游標移至下一個物件,並取得游標新位置處的物件。
xmsBOOL hasNext();
檢查是否還有其他物件位於游標現行位置外。此呼叫不會移動游標。
xmsBOOL isNull() const;
判斷 Iterator 物件是否為一個空值物件。
xmsVOID reset();
將游標移回第一個物件前的位置。