COleDocument::GetNextItem

Articolo
02/19/2013

Chiamare ripetutamente questa funzione per accedere a tutti gli elementi del documento.

virtual CDocItem* GetNextItem(
   POSITION& pos 
) const;

Parametri

pos
Un riferimento a un valore di percorso impostato da una chiamata precedente a GetNextItem; il valore iniziale viene restituito dalla funzione membro GetStartPosition.

Valore restituito

Un puntatore all'elemento del documento nella posizione specificata.

Note

Dopo ogni chiamata, il valore pos è impostata sul valore POSITION dell'elemento successivo nel documento.Se l'elemento recuperato è l'ultimo elemento nel documento, il nuovo valore pos è NULL.

Esempio

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