CWinApp::GetNextDocTemplate

Gets the document template identified by pos, then sets pos to the POSITION value.

CDocTemplate* GetNextDocTemplate(
   POSITION& pos 
) const;

Parameters

  • pos
    A reference to a POSITION value returned by a previous call to GetNextDocTemplate or GetFirstDocTemplatePosition. The value is updated to the next position by this call.

Return Value

A pointer to a CDocTemplate object.

Remarks

You can use GetNextDocTemplate in a forward iteration loop if you establish the initial position with a call to GetFirstDocTemplatePosition.

You must ensure that your POSITION value is valid. If it is invalid, then the Debug version of the Microsoft Foundation Class Library asserts.

If the retrieved document template is the last available, then the new value of pos is set to NULL.

Requirements

Header: afxwin.h

See Also

Reference

CWinApp Class

Hierarchy Chart

CWinApp::AddDocTemplate

Other Resources

CWinApp Members