Word.ContentControlDataChangedEventArgs interface

Paket:

word

Enthält Informationen zum Inhaltssteuerelement, das das contentControlDataChanged Ereignis ausgelöst hat.

Hinweise

API-Satz: WordApi 1.5

Verwendet von

• Word. ContentControl: onDataChanged

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/10-content-controls/content-control-ondatachanged-event.yaml

await Word.run(async (context) => {
  const contentControls: Word.ContentControlCollection = context.document.contentControls;
  contentControls.load("items");
  await context.sync();

  // Register the onDataChanged event handler on each content control.
  if (contentControls.items.length === 0) {
    console.log("There aren't any content controls in this document so can't register event handlers.");
  } else {
    for (let i = 0; i < contentControls.items.length; i++) {
      eventContexts[i] = contentControls.items[i].onDataChanged.add(contentControlDataChanged);
      contentControls.items[i].track();
    }

    await context.sync();

    console.log("Added event handlers for when data is changed in content controls.");
  }
});

...

async function contentControlDataChanged(event: Word.ContentControlDataChangedEventArgs) {
  await Word.run(async (context) => {
    console.log(`${event.eventType} event detected. IDs of content controls where data was changed:`, event.ids);
  });
}

Eigenschaften

eventType	Gibt den Ereignistyp an. Weitere Informationen findest du hier Word.EventType .
ids	Ruft die Inhaltssteuerelement-IDs ab.
source	Gibt die Quelle des Ereignisses an. Dies kann lokal oder remote (durch gemeinsame Dokumenterstellung) erfolgen.

Details zur Eigenschaft

eventType

Gibt den Ereignistyp an. Weitere Informationen findest du hier Word.EventType .

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

Eigenschaftswert

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

Hinweise

API-Satz: WordApi 1.5

ids

Ruft die Inhaltssteuerelement-IDs ab.

ids: number[];

Eigenschaftswert

number[]

Hinweise

API-Satz: WordApi 1.5

source

Gibt die Quelle des Ereignisses an. Dies kann lokal oder remote (durch gemeinsame Dokumenterstellung) erfolgen.

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

Eigenschaftswert

Word.EventSource | "Local" | "Remote"

Hinweise

API-Satz: WordApi 1.5