共用方式為

TreeView_Expand巨集 （commctrl.h）

  • 發行項

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

語法

BOOL TreeView_Expand(
   HWND      hwnd,
   HTREEITEM hitem,
   UINT      code
);

參數

hwnd

類型：HWND

樹視圖控件的句柄。

hitem

類型：HTREEITEM

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

code

類型：UINT

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

傳回值

類型：BOOL

如果作業成功，則傳回非零，否則傳回零。

言論

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

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

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

要求

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