Outlook Add-in开发：检测阅读窗格状态以控制插件启用/禁用

问题场景 #

我开发了一款基于C#的非VSTO Outlook Add-in，已实现邮件选中状态变化时启用/禁用插件控件的功能，但存在以下问题：

• 打开Outlook后未选中任何邮件，阅读窗格显示「Select an item to read」时，插件仍处于启用状态
• 需要在两种场景下禁用插件控件：
  1. 邮件未在Outlook阅读窗格中打开
  2. Outlook阅读窗格显示「Select an item to read」

解决方案 #

要实现目标，需结合Outlook的Explorer对象检测选中项状态和阅读窗格状态，以下是具体实现步骤和代码示例：

1. 核心检测逻辑 #

通过检查Explorer.Selection的数量和类型，结合阅读窗格的可见性，判断是否需要禁用控件：

using Outlook = Microsoft.Office.Interop.Outlook;

/// <summary>
/// 检查当前Outlook状态并更新插件控件启用状态
/// </summary>
/// <param name="explorer">当前活动的Explorer对象</param>
private void CheckPluginControlState(Outlook.Explorer explorer)
{
    bool enableControl = false;

    // 检查是否选中了邮件项
    if (explorer.Selection.Count > 0)
    {
        foreach (object selectedItem in explorer.Selection)
        {
            if (selectedItem is Outlook.MailItem)
            {
                enableControl = true;
                break;
            }
        }
    }

    // 若阅读窗格可见但无有效邮件选中，强制禁用控件
    bool isPreviewPaneVisible = explorer.IsPaneVisible(Outlook.OlPane.olPreview);
    if (isPreviewPaneVisible && !enableControl)
    {
        enableControl = false;
    }

    // 执行控件启用/禁用操作
    SetPluginControlEnabled(enableControl);
}

/// <summary>
/// 设置插件控件的启用状态
/// </summary>
/// <param name="enabled">是否启用</param>
private void SetPluginControlEnabled(bool enabled)
{
    // 替换为你的控件启用逻辑，例如：
    // yourPluginButton.Enabled = enabled;
}

2. 绑定事件监听状态变化 #

为了实时响应选中状态和阅读窗格的变化，需要订阅Explorer的两个关键事件：

• SelectionChange：选中项变化时触发
• PaneVisibilityChange：阅读窗格显示/隐藏时触发

// 插件初始化时绑定事件
private void InitializeOutlookEventHandlers()
{
    Outlook.Application outlookApp = new Outlook.Application();
    Outlook.Explorer activeExplorer = outlookApp.ActiveExplorer();

    if (activeExplorer != null)
    {
        // 订阅选中变化事件
        activeExplorer.SelectionChange += ActiveExplorer_SelectionChange;
        // 订阅阅读窗格可见性变化事件
        activeExplorer.PaneVisibilityChange += ActiveExplorer_PaneVisibilityChange;

        // 插件加载时先执行一次状态检查
        CheckPluginControlState(activeExplorer);
    }
}

private void ActiveExplorer_SelectionChange()
{
    CheckPluginControlState(Globals.ThisAddIn.Application.ActiveExplorer());
}

private void ActiveExplorer_PaneVisibilityChange(Outlook.OlPane pane)
{
    // 仅关注阅读窗格的变化
    if (pane == Outlook.OlPane.olPreview)
    {
        CheckPluginControlState(Globals.ThisAddIn.Application.ActiveExplorer());
    }
}

注：若使用纯COM Interop而非VSTO，需替换Globals.ThisAddIn.Application为你获取的Outlook.Application实例。

3. 关键说明 #

• 当Selection.Count为0时，无论阅读窗格是否可见，都应禁用控件，此时阅读窗格（若可见）必然显示「Select an item to read」。
• 若选中项非邮件类型（如日历、任务项），同样需要禁用控件，确保插件仅在邮件场景下启用。

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