Popup 的按鍵交還

本頁只講自製 Popup 握著鍵盤時（片段包夾清單、結構預覽的 搜尋框），按鍵為什麼會改到後面那份 SQL，以及怎麼接回來。

殼層先把按鍵解析成命令

殼層是照「作用中的視窗框架」預先把按鍵解析成命令的，Popup 開著時那個框架仍然是 查詢視窗——這件事與焦點落在哪個 HWND 無關。Tab、↑↓、Enter、Delete、Backspace 在「文字編輯器」範圍全都有繫結，於是變成編輯器命令沿著查詢視窗的命令鏈派送，直接 改到 SQL；沒有繫結的英數字不會變成命令，才會只有打字看起來正常。換成 Popup、 獨立視窗或任何自畫的東西都一樣，改視窗殼層修不掉這個問題。

攔截點因此在 SqlShellCommandFilter（插在查詢視窗命令鏈最前面）：有 Popup 握著鍵盤時把 這些命令交回它。登記與派送只有 Editor/ShellKeyCapture 一份，對照表在 ShellKeyMap； Popup 實作 IShellKeyTarget，握住鍵盤時 Begin、放開或關閉時 End。包夾清單開著就登記， 預覽只在搜尋框有焦點時登記——點回資料格或編輯器，按鍵就照常走。

• 對照的是按鍵不是行為：命令換回 Key 重新丟進 WPF 的輸入管線，修飾鍵仍是實體 狀態，所以 Shift+Tab（BACKTAB）、Shift+↑（*_EXT）、Ctrl+←（WORDPREV）都對回 同一個方向鍵，文字方塊與清單自己處理，不在這裡重寫一份鍵盤語意。
• 通道與冒泡兩個階段都要發：InputManager.ProcessInput 推一個 KeyEventArgs 只會發那一個事件。只發 KeyDown 時文字方塊的編輯鍵正常（那是 KeyDown 的類別 處理），但清單掛在 PreviewKeyDown 的 ↑↓／Enter／Esc 收不到——症狀是搜尋框裡那 三個鍵沒反應、↑↓ 要先點進清單才有用。
• 剪貼簿與復原（Copy／Cut／Paste／SelectAll／Undo／Redo）直接執行對應的 ApplicationCommands，Ctrl+C 才會複製預覽而不是編輯器裡的選取。
• QueryStatus 也要認領：編輯器把某個命令回報成停用時（例如沒東西可復原），殼層 連 Exec 都不會派送，那個鍵會安靜地消失。
• 對照不到的命令不攔，往下轉給 SSMS。對照得到卻發現焦點已經被搶回編輯器時，先把 焦點要回來並吞掉那一鍵：往下轉就是改到 SQL，少一次按鍵只要再按一次。 沒有 Popup 握著鍵盤時紀錄檔仍會出現 未處理的殼層命令：VSStd97/SelectAll(31) 這類行—— 那是每個命令只記第一次的診斷，與交還無關。
• 熱路徑代價是每個按鍵多一次靜態欄位讀取（ShellKeyCapture.IsActive），比一次 GUID 比對便宜。 同一時間只會有一個 Popup 握著鍵盤，所以登記只有一格；各 Popup 自己一份旗標的話，濾鏡上 每多一種 Popup 就多一次讀取，而新的那一份很容易漏掉 QueryStatus 的認領。

Esc 還有第二條路

實測第一次 Esc 不一定會變成 VSStd2K/CANCEL 走進命令鏈：查詢視窗會先拿它取消 自己的選取，症狀是要按兩次才關得掉清單。現代管線的 EscapeKeyCommandArgs 收得到 那一次，所以 SqlAssistCompletionCommandHandler 也接一條（ShellKeyCapture.TryCancel）， 並且排在建議清單與結構預覽前面。兩條路都交給同一個 IShellKeyTarget.Cancel：包夾清單是 關閉（重複進來由 _closed 擋掉），預覽搜尋框是有字先清字、沒字才關預覽。

內容留在 Popup，不換成獨立視窗

實測過改成 DialogWindow 沒有用，而且更糟：紀錄檔裡 UP／DOWN／RETURN／ CANCEL 照樣抵達查詢視窗的命令鏈，而那個視窗連焦點都拿不到——殼層在命令結束後把 焦點還給文件，於是連打字都掉回編輯器並觸發建議清單，Esc 也關不掉。Popup 拿得到 焦點，外觀也貼著編輯器，所以留著；要調整大小改用右下角的握把 （SqlAssistChrome.CreateResizeGrip），縮放只改內容尺寸，落點仍貼著選取範圍。