GetNextItem

此方法是MFC中樹形控制項，和列表控制項用來取得下一個項，可用來遍歷；另外ole中取得文檔對象中的下一項。

基本介紹

• 中文名：GetNextItem
• 性質： 樹形控制項
• 隸屬：MFC
• ole中：取得文檔對象中的下一項

簡介

CTreeCtrl::GetNextItem

HTREEITEM GetNextItem( HTREEITEM hItem, UINT nCode );

返回值：如果成功則返回下一個項的句柄；否則返回NULL。

參數： hItem 一個tree項的句柄。

nCode 一個用來指示與hItem的關係的類型的標誌。這個標誌可以是下列值之一： · TVGN_CARET 獲取當前被選擇的項。

· TVGN_CHILD 獲取第一個子項。hItem參數必須是NULL。

· TVGN_DROPHILITE 獲取是一次拖放操作的目標的項。

· TVGN_FIRSTVISIBLE 獲取第一個可見的項。

· TVGN_NEXT 獲取下一個兄弟項。

· TVGN_NEXTVISIBLE 獲取跟隨在指定項之後的下一個可視項。

· TVGN_PARENT 獲取指定項的父項。

· TVGN_PREVIOUS 獲取前一個兄弟項。

· TVGN_PREVIOUSVISIBLE 獲取在指定項之前的第一個可視項。

· TVGN_ROOT 獲取根項的第一個子項，指定項是該根項的一個部分。

說明：

此成員函式用來獲取與nItem具有由nCode參數指定的關係的tree view項。

請參閱：

CTreeCtrl::SetItem, CTreeCtrl::GetChildItem, CTreeCtrl::GetItem, CTreeCtrl::SelectItem, CTreeCtrl::GetPrevSiblingItem

COleDocument類成員

COleDocument::GetNextItem

virtual CDocItem* GetNextItem(POSITION& pos) const;

返回值：指向在指定位置的文檔項的指針。

參數： pos 是上一次調用GetNextItem設定的POSITION值的引用；其初值是成員函式GetStartPosition的返回值。

說明：

調用這個函式可以重複訪問你的文檔中的每一個項。在每一次調用之後，pos的值被設定為文檔中下一個項的POSITION值。如果被獲取的元素是文檔中的最後一個元素，則pos的新值為NULL。

示例：

// Example for COleDocument::GetNextItem

// pDoc points to a COleDocument object

POSITION pos = pDoc->GetStartPosition();

CDocItem *pItem;

while( pos != NULL )

{

pItem = pDoc->GetNextItem( pos );

// Use pItem

}

請參閱：

COleDocument::GetStartPosition, COleDocument::GetNextClientItem, COleDocument::GetNextServerItem

CListCtrl類成員

CListCtrl::GetNextItem

int GetNextItem(int nItem,int nFlags) const

返回值：

如果成功，則返回下一項的索引值，否則返回-1。

參數： nItem 搜尋開始項的索引。如果它等於-1，則從第一項開始匹配指定的標誌。不過，指定項本身不包括在搜尋範圍之內。

nFlags 所需項與指定項的位置關係，以及所需項的狀態。這些位置關係為下列值之一： · LVNI_ABOVE 在指定項之上查找某項。

· LVNI_ALL 通過索引（為預設值）查找隨後的項。

· LVNI_BELOW 在指定項之下查找某項。

· LVNI_TOLEFT 在指定項的左面查找某項。

· LVNI_TORIGHT 在指定項的右面查找某項。狀態可以為零，也可以為下列值：

· LVNI_DROPHILITED 設定了LVIS_DROPHILITED狀態標誌的項。

· LVNI_FOCUSED 設定了LVIS_FOCUSED狀態標誌的項。

· LVNI_SELECTED 設定了LVIS_SELECTED狀態標誌的項。如果項沒有設定任何的狀態標誌，那么搜尋將從下一項開始。

參閱

CListCtrl::GetItem