代碼輸入助手 |
代碼輸入助手
代碼輸入助手提供當用戶在代碼編輯器中鍵入代碼時自動彈出匹配的標識符列表窗口的功能,目前只完整支持 Delphi。對於 C++Builder,目前代碼輸入助手對其的支持不完整,僅能彈出 IDE 自帶的自動完成窗口。
輸入助手列表框及右鍵功能表如下圖所示:
此時,如果繼續輸入字元,將自動過濾掉不匹配的內容。在列表中用上、下、PageUp、PageDown、Shift+Home、Shift+End 鍵以及滑鼠左鍵可以選擇當前項,左、右游標鍵可以選擇匹配的位置,退格和刪除鍵也會更新列表。使用回車、空格、Tab、滑鼠雙擊或輸入在設置中指定的按鍵時自動將當前選擇項發送到代碼編輯器中。按 Esc、Ctrl 以及其他功能鍵可以關閉列表。
除了普通的識別字,輸入助手還支援其他一些特殊內容的自動輸入:
如果在 uses 區使用輸入助手,會列出所有可用的單元名稱。
編譯指示字自動輸入。輸入 {$ 會列出所有的編譯指示字及說明。
XML 風格的注釋。輸入 /// 會列出相關列表及說明。
JavaDoc 風格的注釋。輸入 {* 會列出相關列表及說明。
IDE 中設置的代碼範本,如 trycf、forb 等。
用戶自已定義的符號、編譯指示字、注釋範本、代碼範本等。
在代碼範本中還可以使用巨集定義等功能。
小技巧:如果您覺得輸入助手比 IDE 自帶的 Code Completion 好用,可以將 IDE 的 Code Completion 關閉,這樣在輸入 '.' 號後就會彈出輸入助手了,在 Delphi 5 中特別有用。
右鍵菜單
允許自動彈出:是否允許用戶在鍵入代碼時自動彈出輸入助手。
顯示快速按鈕:是否在列表視窗右邊顯示一列功能按鈕。
排序方式:自動排序根據識別字的匹配優先順序自動排序,按文本、長度、類型排序分別以相關內容按昇冪進行排序。
圖例:顯示列表中圖示的含義,並可選擇哪些類型出現在列表中。
添加自定義符號:將當前識別字添加到用戶符號列表中。
設置:彈出輸入助手設置對話方塊。
列表右邊的快速按鈕功能分別為:添加自定義符號、設置、輸入助手幫助。
設置選項
該功能可以在專家包“設置”功能表中的“專家設置”中,或通過列表右鍵功能表進行設置,設置對話方塊如下圖所示:
自動選項
自動彈出輸入助手:是否允許用戶在鍵入代碼時自動彈出輸入助手。
連續輸入的有效字元數:只有連續輸入指定的字元後,才彈出輸入助手。有效的字元包含所有字母、數位、下劃線以及在識別字內部的退格和刪除鍵。
自動彈出延時:在彈出助手前等待的時間,如果延時期又有按鍵輸入,則重新開始延時。
智慧判斷是否需要彈出助手:如果選擇智慧判斷,在當前識別字已經完全匹配侯選列表中某一項時,則不彈出輸入助手。
如果禁用 IDE 的代碼完成,則自動取代:如果希望輸入助手取代 IDE 自己的代碼完成,可以選擇該項,並關閉 IDE 的自動完成功能。
自動彈出列表的按鍵序列:指定一系列按鍵序列,當編輯器中用戶按完這些序列之一時,彈出輸入助手。每個序列用字符串表示,用雙引號括起,不同的序列之間用半角逗號分開。
用來切換自動顯示的快捷鍵:指定一個快捷鍵用於切換自動彈出狀態。
用來手工彈出顯示的快捷鍵:指定一個快捷鍵,可以在有效位置手工彈出輸入助手。
輸入法開啟時不彈出輸入助手:當輸入法打開時,是否不自動彈出輸入助手。
輸出設置
可用于選擇當前項的字元列表: 在輸入助手顯示時,如果鍵入字元列表中的字元,自動將列表中當前選擇的識別字發送到代碼區。
禁止自動彈出列表的符號(逗號分隔): 如果希望在輸入某些字元時禁止自動彈出輸入助手,可以將其加到這個列表中,多項內容用逗號分隔。
識別字輸出方式: 當游標在識別字中間位置時,輸出識別字使用的方式。“自動識別”方式根據匹配度自動選擇替換游標左邊的部分或整個識別字。“回車時替換整個識別字”方式則只有使用回車鍵時才替換整個識別字,其他按鍵輸出時只替換游標左邊的部分。
允許使用空白鍵來選擇當前項:在輸入助手顯示時,輸入空白鍵是否自動將列表中當前選擇的識別字發送到代碼區。
使用空格鍵選擇當前項後忽略空格本身。:在輸入空格鍵將列表中當前選擇的標識符發送到代碼區後,是否忽略這個空格鍵本身。如選擇不忽略,則當前標識符後將出現一個空格。
只使用回車鍵來選擇中間匹配的識別字:如果當前選擇的識別字只是中間匹配輸入的內容,是否只有回車鍵才可將其發送到代碼區。
對關鍵字回車自動換行:在輸入完整的關鍵字後再輸入回車,是否在輸出關鍵字後同時進行換行。
對帶參數的函數自動完成括弧:如果當前輸入項為帶參數的函數或過程,是否在完成輸出時自動插入括弧並調用參數提示功能。
列表顯示
列表排序方式: 識別字列表的排序方式。自動排序根據識別字的匹配優先順序自動排序,按文本、長度、類型排序分別以相關內容按昇冪進行排序。
列表字體:指定在識別字列表中使用的字體名稱和大小。
識別字的最小長度:只有大於該長度的識別字才會顯示在列表中。
保留字:設置列表中保留字類型識別字的大小寫轉換方式。
顯示中間匹配的識別字: 當用戶輸入字元時,是否保留只在中間匹配輸入內容的識別字。如果選擇,匹配內容會自動高亮,如果不選,只有從頭匹配的識別字才會保留。
根據使用頻率自動調整列表項顯示優先順序:是否自動記憶用戶輸入過的識別字,並在顯示時自動將常用的識別字調整到列表的前面。
過濾重複的列表項:相同的列表項,是否只保留一份而過濾掉其他。開啟該選項會少量降低輸入助手的性能。
使用相容方式取得當前識別字列表(較慢): 在某些 IDE 中,如果輸入助手導致編譯問題或 IDE 不穩定,可以嘗試打開該選項。開啟後輸入助手彈出速度會有所下降。
打開工程時後台預獲取標識符列表:開啟該選項允許在打開工程時在後台線程中預獲取標識符列表,以避免第一次使用輸入助手時可能長時間無響應的問題。
內容設置
符號列表:顯示自定義符號列表。
代碼範本:編輯當前符號使用的代碼範本,只有當符號類型為 "Comment" 或 "Template" 時才有效。
確定:保存當前設置。
取消:放棄當前設置。
説明:顯示幫助資訊。
編輯自定義符號
在增加或編輯符號時,顯示對話方塊如下圖所示:
名稱:符號的名稱,用於輸入符號的字串。可以是普通的識別字,也可以用 //xxx 或 {$xx 等表示注釋或編譯指示字的特殊符號。
類型:自定義符號的類型。
描述:符號的說明,顯示在自動輸入列表中。
優先順序:在自動輸入列表中符號的位置,值越小,顯示的位置越靠上。
多行文本範本在輸出時自動縮進:如果選擇,表示在輸出範本時,多行文本的每一行都按當前位置自動縮進。
即使當前輸入完成匹配也顯示列表:對該符號忽略“智慧判斷是否需要彈出助手”的設置。
相關主題