TreeView_GetNextItem巨集 （commctrl.h）

擷取樹視圖專案，該專案與指定的專案具有指定的關聯性。 您可以使用此巨集、使用下列其中一個 TreeView_Get 巨集，或明確傳送 TVM_GETNEXTITEM 訊息。

語法

HTREEITEM TreeView_GetNextItem(
   HWND      hwnd,
   HTREEITEM hitem,
   UINT      code
);

參數

hwnd

類型：HWND

樹視圖控件的句柄。

hitem

類型：HTREEITEM

專案的句柄。

code

類型：UINT

指定要擷取之項目的旗標。 此參數可以是下列其中一個值：

價值	意義
TVGN_CARET	擷取目前選取的專案。 您可以使用 TreeView_GetSelection 巨集傳送此訊息。
TVGN_CHILD	擷取 hitem 參數所指定之專案的第一個子專案。 您可以使用 TreeView_GetChild 巨集傳送此訊息。
TVGN_DROPHILITE	擷取拖放作業的目標專案。 您可以使用 TreeView_GetDropHilight 巨集傳送此訊息。
TVGN_FIRSTVISIBLE	擷取第一個可見專案。 您可以使用 TreeView_GetFirstVisible 巨集傳送此訊息。
TVGN_NEXT	擷取下一個同層級專案。 您可以使用 TreeView_GetNextSibling 巨集傳送此訊息。
TVGN_NEXTSELECTED	Windows Vista 和更新版本。 擷取下一個選取的專案。 您可以使用 TreeView_GetNextSelected 巨集傳送此訊息。
TVGN_NEXTVISIBLE	擷取指定專案後面的下一個可見專案。 指定的項目必須可見。 使用 TVM_GETITEMRECT 訊息來判斷專案是否可見。 您可以使用 TreeView_GetNextVisible 巨集傳送此訊息。
TVGN_PARENT	擷取指定專案的父代。 您可以使用 TreeView_GetParent 巨集傳送此訊息。
TVGN_PREVIOUS	擷取上一個同層級專案。 您可以使用 TreeView_GetPrevSibling 巨集傳送此訊息。
TVGN_PREVIOUSVISIBLE	擷取指定專案前面的第一個可見專案。 指定的項目必須可見。 使用 TVM_GETITEMRECT 訊息來判斷專案是否可見。 您可以使用 TreeView_GetPrevVisible 巨集傳送此訊息。
TVGN_ROOT	擷取樹視圖控件的最上層或第一個專案。 您可以使用 TreeView_GetRoot 巨集傳送此訊息。

傳回值

類型：HTREEITEM

如果成功，則會傳回專案的句柄。 在大部分情況下，訊息會傳回 NULL 值，以指出錯誤。 如需詳細資訊，請參閱一節。

言論

如果所擷取的專案是樹狀結構的根節點，這個巨集會傳 回 NULL。 例如，如果您使用這個巨集搭配樹視圖根節點之第一層子系的 TVGN_PARENT 旗標，則巨集會傳回 NULL。

要求

要求	價值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
支援的最低伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平臺	窗戶
標頭	commctrl.h