如何在VSTO Ribbon插件代码中检测Word节的页面方向变化？

刚好做过类似的需求，给你分享两种靠谱的实现方案，都是在VSTO里能直接落地的：

方案一：重写原生Ribbon按钮的点击事件（首推） #

这种方法能精准拦截用户点击原生「方向」按钮的操作，在Word执行完自带的方向切换逻辑后，立刻触发你的自定义处理，完全不会漏判或者误触发。

具体步骤： #

1. 如果你还没加Ribbon（XML）项，先在VSTO项目里添加一个；
2. 打开Ribbon的XML文件，添加对原生方向按钮的重写，指定我们自己的回调方法：

<customUI xmlns="http://schemas.microsoft.com/office/2009/07/customui">
  <ribbon>
    <tabs>
      <!-- 找到原生的「布局」选项卡 -->
      <tab idMso="TabLayout">
        <!-- 找到「页面设置」组 -->
        <group idMso="GroupPageSetup">
          <!-- 重写纵向、横向两个按钮的点击事件 -->
          <button idMso="OrientationPortrait" onAction="OnOrientationChanged"/>
          <button idMso="OrientationLandscape" onAction="OnOrientationChanged"/>
        </group>
      </tab>
    </tabs>
  </ribbon>
</customUI>

3. 回到Ribbon的代码类，实现OnOrientationChanged回调方法：

using Microsoft.Office.Core;
using Microsoft.Office.Interop.Word;
using System.Windows.Forms;

public void OnOrientationChanged(IRibbonControl control)
{
    // 先让Word执行原生的方向切换功能
    var commandBar = Globals.ThisAddIn.Application.CommandBars.GetCommandBar("TabLayout");
    var nativeButton = commandBar.FindControl(MsoControlType.msoControlButton, control.IdMso);
    nativeButton.Execute();

    // 这里开始写你的自定义处理逻辑
    // 获取当前激活的节
    int activeSectionNum = Globals.ThisAddIn.Application.Selection.Information[WdInformation.wdActiveEndSectionNumber];
    var activeSection = Globals.ThisAddIn.Application.ActiveDocument.Sections[activeSectionNum];
    var newOrientation = activeSection.PageSetup.Orientation;

    // 举个例子：弹出提示，你可以替换成自己的文档调整代码
    MessageBox.Show($"当前节页面方向已切换为：{(newOrientation == WdOrientation.wdOrientPortrait ? "纵向" : "横向")}");
}

方案二：通过监听选择变化+状态对比间接捕获 #

如果不想改动Ribbon，也可以通过跟踪每个节的方向状态，结合选择变化事件来检测改动。这种方法能覆盖更多场景（比如用户用快捷键、右键菜单改方向），但需要注意状态同步的问题。

具体步骤： #

1. 在ThisAddIn类里声明一个字典，用来记录每个节的当前方向：

using System.Collections.Generic;
using Microsoft.Office.Interop.Word;

private Dictionary<int, WdOrientation> _sectionOrientationCache = new Dictionary<int, WdOrientation>();

2. 在Startup事件里初始化缓存，同时注册需要监听的事件：

private void ThisAddIn_Startup(object sender, System.EventArgs e)
{
    // 初始化当前激活文档的节方向缓存
    RefreshSectionOrientationCache(Application.ActiveDocument);
    // 监听选择变化事件——用户操作后选择位置可能变化，刚好可以检查当前节
    Application.WindowSelectionChange += Application_WindowSelectionChange;
    // 监听文档激活事件——切换文档时要重新初始化缓存
    Application.WindowActivate += Application_WindowActivate;
}

3. 写一个初始化/刷新缓存的方法：

private void RefreshSectionOrientationCache(Document doc)
{
    _sectionOrientationCache.Clear();
    if (doc == null) return;

    foreach (Section section in doc.Sections)
    {
        _sectionOrientationCache[section.Index] = section.PageSetup.Orientation;
    }
}

4. 实现选择变化的处理逻辑，对比缓存和当前状态：

private void Application_WindowSelectionChange(Selection sel)
{
    if (sel.Document == null) return;

    int activeSectionNum = sel.Information[WdInformation.wdActiveEndSectionNumber];
    if (!_sectionOrientationCache.ContainsKey(activeSectionNum)) return;

    // 获取当前节的实际方向
    var currentOrientation = sel.Document.Sections[activeSectionNum].PageSetup.Orientation;
    // 和缓存对比，不一样就说明方向改了
    if (currentOrientation != _sectionOrientationCache[activeSectionNum])
    {
        // 这里写你的自定义处理逻辑
        MessageBox.Show($"第{activeSectionNum}节的页面方向从{(WdOrientation)_sectionOrientationCache[activeSectionNum] == WdOrientation.wdOrientPortrait ? "纵向" : "横向"}改成了{(currentOrientation == WdOrientation.wdOrientPortrait ? "纵向" : "横向")}");
        
        // 更新缓存，避免重复触发
        _sectionOrientationCache[activeSectionNum] = currentOrientation;
    }
}

5. 实现文档激活的处理逻辑：

private void Application_WindowActivate(Document doc, Window wn)
{
    RefreshSectionOrientationCache(doc);
}

小提醒： #

• 方案一精准对应用户点击原生按钮的场景，逻辑更简单；
• 方案二能覆盖更多改方向的方式，但如果文档新增了节，记得要更新缓存（可以加个DocumentNewSection事件监听）。

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