Office VSTO加载项中Windows Form的Tab键切换控件功能失效问题

问题根因 #

该问题属于Office VSTO加载项调用WinForm窗体的已知共性问题，根源是Office宿主程序的原生消息循环未正确对接.NET WinForm的键盘消息路由逻辑，导致Tab键切换控件焦点等标准WinForm键盘行为失效，和窗体本身的TabIndex、TabStop配置无关。

解决方案（按优先级排序） #

方案1：使用模式窗体展示 #

如果业务场景允许使用模式弹窗，直接将原Show()调用替换为ShowDialog()即可解决绝大多数场景的问题，ShowDialog()会启动独立的.NET消息循环处理键盘事件，自动兼容Tab切换逻辑，示例代码如下：

Dim targetForm As New YourCustomForm()
' 可选参数：绑定Project主窗口句柄，避免弹窗被宿主遮挡
targetForm.ShowDialog(New NativeWindow() With {.Handle = Globals.ThisAddIn.Application.Hwnd})

方案2：无模式窗体手动处理Tab事件 #

如果必须使用无模式弹窗（Show()调用），先将窗体的KeyPreview属性设为True，再重写窗体的ProcessDialogKey方法手动处理Tab切换逻辑，代码如下：

Protected Overrides Function ProcessDialogKey(keyData As Keys) As Boolean
    ' 处理Shift+Tab反向切换
    If keyData = (Keys.Tab Or Keys.Shift) Then
        Me.SelectNextControl(Me.ActiveControl, False, True, True, True)
        Return True
    ' 处理Tab正向切换
    ElseIf keyData = Keys.Tab Then
        Me.SelectNextControl(Me.ActiveControl, True, True, True, True)
        Return True
    End If
    Return MyBase.ProcessDialogKey(keyData)
End Function

方案3：加载项启动时补充WinForm初始化配置 #

如果上述方案仍未生效，在VSTO加载项的ThisAddIn_Startup事件中提前初始化WinForm全局配置，避免消息循环初始化异常：

Private Sub ThisAddIn_Startup() Handles Me.Startup
    System.Windows.Forms.Application.EnableVisualStyles()
    System.Windows.Forms.Application.SetCompatibleTextRenderingDefault(False)
End Sub

内容的提问来源于stack exchange，提问作者zambo3