VSTO Outlook：如何编程使自定义按钮始终显示在功能区？

可以通过编程方式让自定义按钮始终固定在功能区，无需手动操作。以下是具体实现方案：

1. 通过Ribbon XML配置控件属性 #

如果使用Ribbon XML创建自定义按钮，可在控件定义中指定固定尺寸与显示规则，避免因空间不足被折叠：

<tab idMso="TabMail">
  <group id="CustomGroup" label="我的自定义组">
    <button id="CustomButton" 
            label="自定义按钮" 
            imageMso="HappyFace" 
            size="normal"
            showImage="true"
            showLabel="true"
            onAction="OnCustomButtonClick"/>
  </group>
</tab>

2. 利用Ribbon回调强制可见性 #

实现getVisible回调方法，在功能区刷新时强制返回true，确保按钮始终显示：

public bool GetVisible(IRibbonControl control)
{
    return true;
}

在Ribbon XML中为按钮绑定该回调：

<button id="CustomButton" 
        label="自定义按钮" 
        imageMso="HappyFace"
        getVisible="GetVisible"
        onAction="OnCustomButtonClick"/>

3. 编程模拟“固定到功能区”操作 #

手动固定本质是修改Office的UI持久化设置，可通过操作CommandBar对象实现自动固定：

private void PinCustomButtonToRibbon()
{
    Outlook.Application app = Globals.ThisAddIn.Application;
    Office.CommandBar ribbon = app.ActiveExplorer().CommandBars["Ribbon"];
    
    // 替换为你的自定义组ID和按钮ID
    Office.CommandBarControl customGroup = ribbon.FindControl(Office.MsoControlType.msoControlPopup, "CustomGroup");
    if (customGroup != null)
    {
        Office.CommandBarButton customButton = customGroup.Controls["CustomButton"] as Office.CommandBarButton;
        if (customButton != null)
        {
            customButton.BeginGroup = true;
            customButton.Visible = true;
            ribbon.Save();
        }
    }
}

可在Add-in的Startup事件中调用此方法，实现加载时自动固定。

注意事项 #

• 若使用VSTO Ribbon设计器，直接在属性面板设置Visible为True、Size为Normal，并勾选ShowImage和ShowLabel即可。
• 部分Outlook版本对CommandBar对象访问有权限限制，需确保插件拥有对应权限。
• 测试时需覆盖不同窗口大小与视图模式，验证按钮可见性。

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