This topic has not yet been rated - Rate this topic

CDocument::GetNextView

Visual Studio 2008

Call this function to iterate through all of the document's views.

virtual CView* GetNextView( 
   POSITION& rPosition  
) const;

Parameters

rPosition: A reference to a POSITION value returned by a previous call to the GetNextView or GetFirstViewPosition member functions. This value must not be NULL.

Return Value

A pointer to the view identified by rPosition.

Remarks

The function returns the view identified by rPosition and then sets rPosition to the POSITION value of the next view in the list. If the retrieved view is the last in the list, then rPosition is set to NULL.

Example

C++

//To get the first view in the list of views: 
// POSITION pos = GetFirstViewPosition(); 
// CView* pFirstView = GetNextView(pos); 
// 
// This example uses CDocument::GetFirstViewPosition 
// and GetNextView to repaint each view. 
// An easier way to accomplish the same result is to call 
// UpdateAllViews(NULL); 
void CExampleDoc::OnRepaintAllViews()
{
   POSITION pos = GetFirstViewPosition();
   while (pos != NULL)
   {
      CView* pView = GetNextView(pos);
      pView->UpdateWindow();
   }   
}

Requirements

Header: afxwin.h

Reference

CDocument Class

Hierarchy Chart

CDocument::AddView

CDocument::GetFirstViewPosition

CDocument::RemoveView

CDocument::UpdateAllViews

Other Resources

CDocument Members

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Additions

ADD