COleDocument::GetNextItem

Статья
06/10/2015

Эта функция вызывается повторно, чтобы получить доступ к каждый из элементов в документе.

virtual CDocItem* GetNextItem( 
   POSITION& pos  
) const;

Параметры

pos
Ссылка на набор значений POSITION во время предыдущего вызова GetNextItem; начальное значение возвращается функцией-членом GetStartPosition.

Возвращаемое значение

Указатель на элемент на заданной позиции.

Заметки

После того как каждый вызов, значение pos установлен в значение POSITION следующего элемента в документе. Если полученный элемент последний элемент в документе, новое значение posNULL.

Пример

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