COleDocument::GetNextClientItem

Статья
06/10/2015

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

COleClientItem* GetNextClientItem( 
   POSITION& pos  
) const;

Параметры

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

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

Указатель к следующему элементу клиента в документе или NULL, если больше нет элементов.

Заметки

После того как будет установлен каждый вызов, значение pos для следующего элемента в документе, который может либо может не являться элементом клиента.

Пример

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