複製鏈接
請複製以下鏈接發送給好友

GetNextItem

鎖定
此方法是MFC中樹形控件,和列表控件用來取得下一個項,可用來遍歷;另外ole中取得文檔對象中的下一項。
中文名
GetNextItem
性    質
樹形控件
隸    屬
MFC
ole中
取得文檔對象中的下一項

目錄

GetNextItem簡介

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狀態標誌的項。如果項沒有設置任何的狀態標誌,那麼搜索將從下一項開始。

GetNextItem參閲

CListCtrl::GetItem