Word.ParagraphChangedEventArgs interface

Пакет:
word

Предоставляет сведения о абзацах, которые вызвали paragraphChanged событие.

Комментарии

Набор API: WordApi 1.6

Используется

Примеры

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/25-paragraph/onchanged-event.yaml

// Registers the onParagraphChanged event handler on the document.
await Word.run(async (context) => {
  eventContext = context.document.onParagraphChanged.add(paragraphChanged);
  await context.sync();

  console.log("Added event handler for when content is changed in paragraphs.");
});

...

async function paragraphChanged(event: Word.ParagraphChangedEventArgs) {
  await Word.run(async (context) => {
    console.log(`${event.type} event detected. IDs of paragraphs where content was changed:`, event.uniqueLocalIds);
  });
}

Свойства

source

Указывает источник события. Она может быть локальной или удаленной (путем совместного редактирования).
type

Определяет тип события. См. Word.EventType дополнительные сведения.
uniqueLocalIds

Получает уникальные идентификаторы задействованных абзацев. Идентификаторы представлены в стандартном формате GUID 8-4-4-4-12 без фигурных скобок и различаются в зависимости от сеанса и соавтора.

Сведения о свойстве

source

Указывает источник события. Она может быть локальной или удаленной (путем совместного редактирования).

source: Word.EventSource | "Local" | "Remote";

Значение свойства

Word.EventSource | "Local" | "Remote"

Комментарии

Набор API: WordApi 1.6

type

Определяет тип события. См. Word.EventType дополнительные сведения.

type: Word.EventType | "ContentControlDeleted" | "ContentControlSelectionChanged" | "ContentControlDataChanged" | "ContentControlAdded" | "CommentDeleted" | "CommentSelected" | "CommentDeselected" | "CommentChanged" | "CommentAdded" | "ContentControlEntered" | "ContentControlExited" | "ParagraphAdded" | "ParagraphChanged" | "ParagraphDeleted" | "AnnotationClicked" | "AnnotationHovered" | "AnnotationInserted" | "AnnotationRemoved" | "AnnotationPopupAction";

Значение свойства

Word.EventType | "ContentControlDeleted" | "ContentControlSelectionChanged" | "ContentControlDataChanged" | "ContentControlAdded" | "CommentDeleted" | "CommentSelected" | "CommentDeselected" | "CommentChanged" | "CommentAdded" | "ContentControlEntered" | "ContentControlExited" | "ParagraphAdded" | "ParagraphChanged" | "ParagraphDeleted" | "AnnotationClicked" | "AnnotationHovered" | "AnnotationInserted" | "AnnotationRemoved" | "AnnotationPopupAction"

Комментарии

Набор API: WordApi 1.6

uniqueLocalIds

Получает уникальные идентификаторы задействованных абзацев. Идентификаторы представлены в стандартном формате GUID 8-4-4-4-12 без фигурных скобок и различаются в зависимости от сеанса и соавтора.

uniqueLocalIds: string[];

Значение свойства

string[]

Комментарии

Набор API: WordApi 1.6

Примеры

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/50-document/manage-annotations.yaml

async function paragraphChanged(args: Word.ParagraphChangedEventArgs) {
  await Word.run(async (context) => {
    const results = [];
    for (let id of args.uniqueLocalIds) {
      let para = context.document.getParagraphByUniqueLocalId(id);
      para.load("uniqueLocalId");

      results.push({ para: para, text: para.getText() });
    }

    await context.sync();

    for (let result of results) {
      console.log(`${args.type}: ID ${result.para.uniqueLocalId}:-`, result.text.value);
    }
  });
}