範例 - 欄位輔助

簡介

「欄位輔助」範例顯示如何利用 org.eclipse.jface.fieldassist 的支援在文字欄位中提供作業輔助。範例對話框顯示如何設定欄位裝飾來表示必要欄位、錯誤和警告的欄位,以及提供內容輔助的欄位。範例也包含喜好設定頁面,讓您配置裝飾和內容輔助支援。

執行範例

安裝外掛程式之後,在動作列上可以看到 FieldAssist 動作。請選擇功能表項目「開啟欄位輔助對話框...」 將啟動欄位輔助對話框。可利用範例喜好設定來配置對話框。

設定欄位輔助喜好設定

有兩個喜好設定頁面可設定對話框的行為。欄位輔助範例喜好設定頁面可讓您配置對話框如何註解錯誤和警告的欄位、必要欄位及內容輔助。可用來註解欄位的顏色和裝飾組合。這個喜好設定頁面主要是展示 各種可能的裝飾配置效果。主要是供程式設計師去試驗欄位輔助,不適合作為供使用者控制註解的喜好設定頁面範例。

內容輔助喜好設定頁面可讓您配置如何在對話框文字欄位上安裝內容輔助。欄位輔助 API (ContentProposalAdapter) 中提供的大部分選項,皆可在這個頁面上配置。請注意,配置內容輔助也可能形成不理想的操作方式。例如,設定在所有字元上經過很久才自動啟動內容輔助就很不理想。當過濾器索引鍵未送回控制項時,使用累加提議過濾極易造成混淆。在喜好設定頁面公開 API 是為了讓欄位輔助程式設計師試驗所有可能的組合。所有這些喜好設定皆不會公開給一般使用者,開發人員會從這些值選擇最佳組合,提供確定的內容輔助樣式。

使用對話框

範例對話框顯示幾種不同的欄位:

程式碼範例

範例對話框不會很複雜,主要是示範如何設計欄位輔助。程式碼的一些注意事項如下: