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 |