TreeView_Expand宏 (commctrl.h)

TreeView_Expand宏會展開或折疊與指定父專案相關聯的子項目清單，如果有的話。 您可以使用這個宏，或明確地傳送 TVM_EXPAND 訊息。

語法

void TreeView_Expand(
   hwnd,
   hitem,
   code
);

參數

hwnd

類型： HWND

樹視圖控件的句柄。

hitem

類型： HTREEITEM

要展開或折疊之父專案的句柄。

code

類型： UINT

動作旗標。 如需可能值的清單，請參閱 TVM_EXPAND 中的 flag 參數描述。

傳回值

無

備註

展開已經展開的節點，或折疊已折疊的節點會被視為成功的作業，而宏會傳回非零值。 嘗試展開或折迭沒有子系的節點會被視為失敗，且傳回值為零。

當專案第一次由 TVM_EXPAND 訊息展開時，動作會產生 TVN_ITEMEXPANDING 和 TVN_ITEMEXPANDED 通知代碼，並設定專案的 TVIS_EXPANDEDONCE 狀態旗標。 只要此狀態旗標保持設定，後續 TVM_EXPAND 訊息就不會產生TVN_ITEMEXPANDING或TVN_ITEMEXPANDED通知。 若要重設 TVIS_EXPANDEDONCE 狀態旗標，您必須傳送TVM_EXPAND訊息，並設定 TVE_COLLAPSE 和TVE_COLLAPSERESET旗標。 嘗試明確設定 TVIS_EXPANDEDONCE 會導致無法預期的行為。

如果樹檢視控件的擁有者拒絕作業以回應 TVN_ITEMEXPANDING 通知，則展開作業可能會失敗。

規格需求

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