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