COleDocument::GetNextItem

Artykuł
02/27/2013

Wywołanie tej funkcji wielokrotnie, aby dostęp do każdego z elementów w dokumencie.

virtual CDocItem* GetNextItem(
   POSITION& pos 
) const;

Parametry

pos
Odwołanie do stanowisko wartości zestawu przez poprzednie wywołanie GetNextItem; wartość początkowa jest zwracany przez GetStartPosition funkcji składowej.

Wartość zwracana

Wskaźnik do elementu dokumentu w określonym położeniu.

Uwagi

Po każdym wywołaniu wartość pos jest ustawiona na stanowisko wartość następny element w dokumencie.Jeśli element pobierane jest ostatnim elementem w dokumencie nową wartość pos jest NULL.

Przykład

// 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);
   }
}