VARCHART XGantt用戶手冊（ActiveX版）：如何操作互動事件（上）

VARCHART XGantt是一個交互式的甘特圖控件，其模塊化的設計讓您可以創建滿足您和您的客戶所需求的應用程序。（我們領先的甘特圖控件VARCHART XGantt可用于.NET，ActiveX和ASP.NET應用程序。）除此之外，同時還具有一個穩定可靠的甘特圖工具，在編寫第一行代碼之前，您就可以知道是否可以滿足客戶的需求。

點擊下載VARCHART XGantt免費版

在啟用實時更新的拖放交互過程中，接收和處理有關對象的信息將非常有用。本文介紹該教程的上半部分的內容~

在默認行為中，沒有給出有關對象狀態的反饋。僅當釋放鼠標鍵時，ObjectModifying事件才會給出有關舊狀態（在按下鼠標鍵之前）和新狀態（在釋放鼠標鍵之后）的信息。此外，ObjectModified事件指示該操作在內部完成。

要解決鼠標交互過程中不接收信息的問題，請使用伴隨并描述交互的交互事件。此外，自XGantt 5.0版以來，對象事件的調用時間和頻率已被修改。

交互涉及到

我們將解釋一些事件，這些事件描述了VARCHART XGantt中的交互過程以及更詳細地涉及的對象，即在交互過程中發生的“拖動（Drop）”事件

• 首先在對象上按下鼠標左鍵

• 按下鼠標鍵執行動作

• 最后釋放鼠標左鍵

• 在“實時更新”過程中被處理

術語

為了更好地理解，我們想進一步解釋文本中使用的一些術語。

對象事件

對象事件，例如VcDateLineModifying、VcDateLineModified、VcNode-Modifying、VcNode-Modified等，是事件，根據迄今為止已知的實踐，這些事件是在指定的交互過程中在操作結束時拋出的。

實時更新

實時更新意味著“拖放”操作將導致永久顯示“如果在此處更新對象該怎么辦？”場景，這導致在不同時間處理不同的上下文，例如在交互過程中的直接功能或從屬功能。例如，如果某個節點正在移動，則會導致修改各種數據和該節點的位置，進而導致修改例如直方圖曲線或摘要欄。根據“實時更新”對話框中的設置，修改將立即生效，或者將鼠標懸停在要指定的時間范圍后，或者在釋放鼠標鍵的操作結束時生效。

示例：如果為移動節點選擇了更新行為“OnMouseMove”，則更新是什么樣的？

對節點的直接影響：

• 節點的每個日期值

• 對濾鏡進行評估，從而導致其他顏色，例如，出現在表格區域中

• osummary bars

• 直方圖曲線

等待一段時間（500毫秒）后的修改

• 例如，將節點定位在組中

• 使用節點順序的相應布局進行優化

僅應執行在整個操作上下文中必要且有意義的更新，否則圖表將變得不太穩定。

互動事件

從VARCHART XGantt 5.0 SR3起，可以在交互運行時處理對象事件，這些對象稱為InInteraction事件。

重要提示：請確保事先通過屬性VcGantt.InInteractionEventsEnabled = true或在“常規”屬性頁上啟用InInteraction事件。

請注意，在討論實模式下與節點的交互時，我們將在圖表Chart節點中調用顯示對象Real（節點）和數據元素。在圖表區域中進行實時交互時，該圖表節點不可見，因為它將臨時替換為該區域中的實際節點，但是它的存在會影響功能區高度、優化、表格區域中的顏色等方面的圖表。

這樣，在與顯示的幻像或真實節點進行交互匹配期間，將傳遞有關正常對象的相應信息。

移動節點時，每次捕捉到該節點的位置（取決于其時間單位和增量）都會引發VcNodeModifying（黃色閃電）。真實節點顯示可能的位置和可能的布局，并通過VcNodeModifying事件描述此狀態。事件args中傳遞的節點（e.Node）代表實際節點的狀態。

重要提示：這就是為什么查詢圖表節點的屬性沒有意義或不可能的原因。只能檢索或設置屬性get / setDataField、AllData、ID。

如果，取決于所選的更新上下文，例如“鼠標移動時暫停”會更新真實對象，這將通過Modified事件（綠色閃電）指示出來。這可以但不必與Modifying事件同時發生。

如果在選擇更新行為“按鼠標移動”時移動了節點，則兩個事件將同時出現。

總結事實：

• 如果移動節點，則由真實節點指示的修改將通過VcNodeModifying事件永久描述。

• 圖表節點的修改由VcNodeModified事件指示。

• 交互完成后，釋放鼠標鍵時，將提供由VcNodeModifying和VcNodeModified事件組成的結論事件對。

使用真實節點的事件中的相關對象是真實對象。

在最后一個VcNodeModifying事件中，提供具有在交互過程中最后設置的值的圖表節點（與之前的VcNodeModifying事件相反），即最后一個小綠色閃電時的狀態。 EventArgs的e.OldNode描述操作開始時的狀態。 這樣，可以比較交互的開始和結束狀態。

與往常一樣，該圖表節點在上一個VcNodeModified事件中可用，并且所有內部過程都已完成。

本教程內容尚未完結，敬請期待后半部分內容的更新~您也可以下載VARCHART XGantt試用版評估一下~

相關內容推薦：

VARCHART XGantt用戶手冊>>>

想要購買VARCHART XGantt正版授權，或了解更多產品信息請點擊