如何在Outlook VSTO（C#）中创建自定义浮动图标/按钮？

核心实现逻辑 #

通过监听Outlook邮件窗口（Inspector）的生命周期，结合自定义Winform控件附着在邮件编辑区旁，实现点击图标弹出自定义窗口的功能，具体步骤如下：

1. 监听Inspector窗口创建事件 #

在VSTO插件的ThisAddIn类中，绑定Outlook的Inspectors.NewInspector事件，确保每打开一个新邮件窗口都能触发后续逻辑：

private Outlook.Inspectors _inspectors;

private void ThisAddIn_Startup(object sender, System.EventArgs e)
{
    _inspectors = Application.Inspectors;
    _inspectors.NewInspector += Inspectors_NewInspector;
}

2. 绑定邮件窗口与浮动图标 #

在NewInspector事件处理中，仅针对邮件类型的窗口创建浮动图标，并关联窗口关闭时的清理逻辑：

private void Inspectors_NewInspector(Outlook.Inspector inspector)
{
    // 仅处理邮件窗口
    if (inspector.CurrentItem is Outlook.MailItem)
    {
        inspector.Activate(); // 确保窗口加载完成
        var wordDoc = inspector.WordEditor as Microsoft.Office.Interop.Word.Document;
        if (wordDoc != null)
        {
            // 获取Word编辑区的窗口句柄
            IntPtr parentHandle = new IntPtr(wordDoc.Application.Hwnd);
            // 创建并显示浮动图标窗体
            var floatIconForm = new FloatingIconForm(parentHandle);
            floatIconForm.Show();
            
            // 窗口关闭时销毁浮动图标，避免内存泄漏
            inspector.Close += (s, e) => 
            {
                floatIconForm.Close();
                floatIconForm.Dispose();
            };
        }
    }
}

3. 自定义浮动图标窗体 #

创建一个无边框、背景透明的Winform窗体，作为浮动图标载体，并实现位置跟随、点击事件：

using System;
using System.Windows.Forms;
using System.Drawing;
using System.Runtime.InteropServices;

public partial class FloatingIconForm : Form
{
    [DllImport("user32.dll")]
    private static extern IntPtr SetParent(IntPtr hWndChild, IntPtr hWndNewParent);

    public FloatingIconForm(IntPtr parentHandle)
    {
        InitializeComponent();
        // 设置窗体样式：无边框、透明背景
        FormBorderStyle = FormBorderStyle.None;
        BackColor = Color.Transparent;
        TransparencyKey = Color.Transparent;
        
        // 将浮动窗体设置为Outlook窗口的子窗口，自动跟随移动/缩放
        SetParent(this.Handle, parentHandle);
        
        // 调整图标位置到编辑区右侧中间（可根据需求修改坐标）
        var parentControl = Control.FromHandle(parentHandle);
        Location = new Point(parentControl.Width - this.Width, parentControl.Height / 2 - this.Height / 2);
        
        // 绑定图标点击事件，打开自定义窗口
        pictureBoxIcon.Click += (s, e) =>
        {
            var customWinform = new YourExistingWinform(); // 替换为你已做好的窗口类
            customWinform.Show(this);
        };
    }
}

关键注意事项 #

• 格式兼容性：若需支持纯文本/RTF格式邮件，需通过Windows API（如FindWindowEx）获取对应编辑区的句柄，替代WordEditor的逻辑。
• 内存管理：必须在Inspector窗口关闭时销毁浮动窗体及事件绑定，防止内存泄漏。
• 样式优化：可通过调整PictureBox的图标、hover效果，让浮动图标更贴近Grammarly的交互体验。

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