Виноски та кінцеві виноски

Виноски та примітки у кінці

Aspose.Words FOSS для .NET представляє виноски та примітки у кінці за допомогою єдиного класу вузла Footnote, який відрізняється своєю властивістю FootnoteType, а також окремих класів параметрів нумерації та розділювачів у просторі імен Aspose.Words.Notes.

Читання вмісту виносок та приміток у кінці

Footnote — це складений вузол історії, подібний до Body або клітинки таблиці, що містить Paragraphs і Tables, — який містить текст однієї виноски або примітки у кінці. Його властивість FootnoteType (значення перерахування FootnoteType, Footnote або Endnote) визначає, який це тип. ReferenceMark повертає налаштований символ позначки посилання, ActualReferenceMark повертає фактично відображену позначку (з урахуванням автоматичної нумерації), а IsAuto повідомляє, чи позначка автоматично нумерується. ParentParagraph знаходить абзац у основному тексті документа, де розташовано посилання на виноску або примітку у кінці. GetText() витягує простий текстовий вміст виноски, відтворюючи метод, доступний іншим вузлам рівня історії.

Налаштування нумерації та розташування

Поведінка нумерації та розміщення контролюється окремо для виноск та приміток у кінці за допомогою FootnoteOptions та EndnoteOptions, які обидва реалізують спільний інтерфейс IFootnoteOptions. FootnoteOptions.Position (значення FootnotePosition — BottomOfPage або BeneathText) і EndnoteOptions.Position (значення EndnotePosition — EndOfSection або EndOfDocument) визначають, куди розміщується кожен тип. Обидва надають NumberStyle, StartNumber та RestartRule (значення FootnoteNumberingRule — Continuous, RestartSection, RestartPage або Default) для керування послідовністю нумерації. FootnoteOptions додатково надає Columns, що дозволяє розташовувати виноски внизу сторінки в кількох колонках.

Розділювачі виносок та приміток у кінці

FootnoteSeparator — це вузол історії, що містить вміст, який Word розташовує між основним тілом документа та його виносками/кінцевими виносками — за замовчуванням коротка горизонтальна лінія, але він може містити будь-який абзацний вміст. Його властивість SeparatorType (значення типу FootnoteSeparatorType) розрізняє шість ролей роздільників, які визначає Word: FootnoteSeparator, FootnoteContinuationSeparator, FootnoteContinuationNotice та їх еквіваленти для кінцевих виносок. FootnoteSeparatorCollection надає типізований доступ до всіх вузлів-роздільників у документі через GetByFootnoteSeparatorType(FootnoteSeparatorType).

Поради та кращі практики

• Перевірте Footnote.FootnoteType перед тим, як вважати вузол Footnote виноскою — той самий клас представляє як виноски, так і кінцеві виноски.
• Використовуйте ActualReferenceMark замість ReferenceMark, коли потрібен маркер у тому вигляді, в якому він фактично відображається, оскільки автоматично нумеровані маркери відрізняються від налаштованого символу маркера.
• Налаштуйте FootnoteOptions та EndnoteOptions перед додаванням вмісту виноски/кінцевої виноски, щоб правила нумерації застосовувалися послідовно з першої виноски.
• Вміст FootnoteSeparator рідко налаштовують — більшість документів покладаються на стандартний роздільник Word — але він повністю доступний, якщо документ потребує спеціального повідомлення про продовження.

Типові проблеми

FAQ

Як розрізнити виноску та кінцеву виноску у коді?

Перевірте властивість FootnoteType у об’єкта Footnote — вона повертає FootnoteType.Footnote або FootnoteType.Endnote.

Чи можуть виноски та кінцеві виноски мати різні правила нумерації?

Так — FootnoteOptions та EndnoteOptions налаштовані незалежно, кожен має власні Position, NumberStyle, StartNumber та RestartRule.

Для чого використовується FootnoteSeparator?

Вона представляє вміст, який Word вставляє для візуального розділення основного тіла документа від його виносок або кінцевих виносок, а також повідомлення, що показується, коли виноска продовжується на наступній сторінці.

Чи підтримує Footnote таблиці всередині примітки?

Так — Footnote надає властивість Tables поряд із Paragraphs, оскільки це складний елемент історії, подібний до основного тіла документа.

API Reference Резюме

Дивіться також

• Aspose.Words for .NET — Enterprise Documentation