Freigeben über

Problembehandlung bei Word Add-Ins

  • Artikel

In diesem Artikel wird die Behandlung von Problemen erläutert, die nur für Word gelten. Verwenden Sie das Feedbacktool am Ende der Seite, um andere Probleme vorzuschlagen, die dem Artikel hinzugefügt werden können.

Es ist beabsichtigt, dass die Body.insertFileFromBase64-Methode alle Kopf- oder Fußzeilen ausschließt, die sich in der Quelldatei befanden.

Um Kopf- oder Fußzeilen aus der Quelldatei einzuschließen, verwenden Sie stattdessen Document.insertFileFromBase64 .

Layoutumbrüche bei Verwendung von insertHtml , während sich der Cursor im Inhaltssteuerelement in der Kopfzeile befindet

Dieses Problem kann auftreten, wenn die folgenden drei Bedingungen erfüllt sind.

  1. Verwenden Sie mindestens ein Inhaltssteuerelement in der Kopfzeile und mindestens ein Steuerelement in der Fußzeile des Word Dokuments.
  2. Stellen Sie sicher, dass sich der Cursor in einem Inhaltssteuerelement im Header befindet.
  3. Rufen Sie insertHtml auf, um ein Inhaltssteuerelement in der Fußzeile festzulegen.

Die Fußzeile wird dann unerwartet mit dem Header gemischt. Um dies zu vermeiden, löschen Sie das Inhaltssteuerelement in der Fußzeile, bevor Sie es festlegen, wie im folgenden Codebeispiel gezeigt.

await Word.run(async (context) => {
    // Credit to https://github.com/barisbikmaz for this version of the workaround.
    // For more information, see https://github.com/OfficeDev/office-js/issues/129.

    // Let's say there are 2 content controls in the header and 1 in the footer.
    const contentControls = context.document.contentControls;
    contentControls.load();

    await context.sync().then(function () {
        // Clear the 2 content controls in the header.
        contentControls.items[0].clear(); 
        contentControls.items[1].clear();

        // Clear the control control in the footer then update it.
        contentControls.items[2].clear();
        contentControls.items[2].insertHtml('<p>New Footer</p>', 'Replace');
    });
});

Bedeutung von NULL-Eigenschaftswerten in der Antwort

nullhat besondere Auswirkungen auf die Word JavaScript-APIs. Es wird verwendet, um Standardwerte oder keine Formatierung darzustellen.

Formatierungseigenschaften wie Farbe enthalten null Werte in der Antwort, wenn im angegebenen Bereich unterschiedliche Werte vorhanden sind. Wenn Sie z. B. einen Bereich Abrufen und die range.font.color-Eigenschaft laden:

  • Wenn der gesamte Text im Bereich die gleiche Schriftfarbe aufweist, range.font.color gibt diese Farbe an.
  • Wenn mehrere Schriftfarben im Bereich vorhanden sind, ist range.font.colornull.

Weitere Informationen