如何在Word Add-in中实现按键触发读取整行文本功能？

首先明确：你之前尝试的直接监听键盘事件、绑定DocumentSelectionChanged事件无效，是因为Word Add-in的运行机制限制：

• Add-in运行在独立的iframe中，无法直接捕获Word主窗口的键盘事件；
• DocumentSelectionChanged仅在选区范围发生变化时触发（比如光标跳转到其他行、选中一段文本），连续输入字符时光标只是在同一行末尾移动，选区范围未改变，所以不会触发该事件。

针对你的需求，最适合新手的实现方式是定时轮询检查当前行文本，步骤如下：

1. 基于快速入门模板修改代码 #

打开taskpane.js文件，替换原有代码为以下内容（可保留原有的insertEmersonQuoteAtSelection函数用于测试）：

// 保存上一次获取的行文本，用于对比变化
let lastLineText = "";
// 定时器ID，用于停止轮询
let checkLineInterval;

// 获取当前光标所在行的文本
async function getCurrentLineText() {
  try {
    return await Word.run(async (context) => {
      // 获取当前选区（光标位置）
      const selection = context.document.getSelection();
      // 获取选区所在的段落（即当前行）
      const currentParagraph = selection.paragraphs.getFirst();
      // 加载段落的文本内容
      currentParagraph.load("text");
      // 同步获取数据
      await context.sync();
      // 返回去除首尾空白的文本
      return currentParagraph.text.trim();
    });
  } catch (error) {
    console.error("获取行文本失败:", error);
    return "";
  }
}

// 行文本变化时的处理逻辑
async function handleLineUpdate() {
  const currentLine = await getCurrentLineText();
  // 只有当当前行和上一次的行文本不同时，才执行逻辑
  if (currentLine !== lastLineText) {
    // 这里写你的业务逻辑：和字典对比、保存行文本
    console.log("当前更新的行文本:", currentLine);
    lastLineText = currentLine;

    // 测试：调用你之前的insertEmersonQuoteAtSelection函数
    // await insertEmersonQuoteAtSelection();
  }
}

// 初始化Add-in
Office.onReady(async (info) => {
  if (info.host === Office.HostType.Word) {
    // 初始化时先获取一次当前行文本
    lastLineText = await getCurrentLineText();
    // 启动轮询，每隔300毫秒检查一次行文本
    checkLineInterval = setInterval(handleLineUpdate, 300);

    // 当任务窗格关闭时，清除定时器，避免内存泄漏
    document.addEventListener("beforeunload", () => {
      clearInterval(checkLineInterval);
    });

    // 保留原有的按钮点击事件（如果需要）
    document.getElementById("run").onclick = run;
  }
});

// 原有的测试函数（如果需要保留）
async function run() {
  await insertEmersonQuoteAtSelection();
}

async function insertEmersonQuoteAtSelection() {
  try {
    await Word.run(async (context) => {
      const quote = "Hitch your wagon to a star. — Ralph Waldo Emerson";
      const range = context.document.getSelection();
      range.insertText(quote, Word.InsertLocation.end);

      await context.sync();
    });
  } catch (error) {
    console.error(error);
  }
}

2. 关键说明 #

• 轮询间隔：设置为300毫秒是平衡实时性和性能的选择，你可以根据需求调整（比如500毫秒），不要设置过小（比如<100毫秒），避免占用过多资源。
• Word.run异步逻辑：所有操作Word文档的代码必须包裹在Word.run中，通过context.sync()同步获取文档数据，这是Office.js的核心规则。
• 任务窗格依赖：轮询逻辑在任务窗格打开时才会运行，如果关闭任务窗格，代码会停止执行。

3. 调试方法 #

按F12打开浏览器开发者工具，切换到控制台标签：

• 可以查看console.log输出的当前行文本，确认逻辑是否触发；
• 如果有错误，会显示错误信息，帮助你定位问题。

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