Bereitstellen

Artikel
02/26/2013

Rufen Sie diese Funktion wiederholt auf, um auf jedes der Elemente im Dokument zuzugreifen.

virtual CDocItem* GetNextItem(
   POSITION& pos 
) const;

Parameter

pos
Ein Verweis auf einen POSITION-Wert durch einen früheren Aufruf GetNextItem; der Anfangswert wird durch die GetStartPosition-Memberfunktion zurückgegeben.

Rückgabewert

Ein Zeiger auf Dokumentelement an der angegebenen Position.

Hinweise

Nachdem jeder Aufruf, der Wert von pos zum POSITION-Wert des nächsten Punkts im Dokument festgelegt ist.Wenn das abgerufene Element das letzte Element im Dokument ist, ist der neue Wert für posNULL.

Beispiel

// pDoc points to a COleDocument object
POSITION pos = pDoc->GetStartPosition();
CDocItem *pItem;
CString strType;
while(pos != NULL)
{
   pItem = pDoc->GetNextItem(pos);
   // Use pItem
   if (pItem->IsKindOf(RUNTIME_CLASS(COleClientItem)))
   {
      ((COleClientItem*)pItem)->GetUserType(USERCLASSTYPE_FULL, strType);
      TRACE(strType);
   }
}