Notas al pie y notas finales

Notas al pie y notas finales

Aspose.Words FOSS para .NET representa notas al pie y notas finales con una única clase de nodo Footnote distinguida por su propiedad FootnoteType, junto con clases separadas de opciones de numeración y separadores en el espacio de nombres Aspose.Words.Notes.

Lectura del contenido de notas al pie y notas finales

Footnote es un nodo de historia compuesto — como Body o una celda de tabla, contiene Paragraphs y Tables — que almacena el texto de una nota al pie o nota final. Su propiedad FootnoteType (un valor de enumeración FootnoteType, Footnote o Endnote) distingue qué tipo es. ReferenceMark devuelve el carácter de marca de referencia configurado, ActualReferenceMark devuelve la marca realmente renderizada (teniendo en cuenta la numeración automática), y IsAuto indica si la marca está auto-numerada. ParentParagraph localiza el párrafo en el cuerpo principal del documento donde ocurre la referencia a la nota al pie o nota final. GetText() extrae el contenido de texto sin formato de la nota al pie, replicando el método disponible en otros nodos a nivel de historia.

Configuración de numeración y posición

El comportamiento de numeración y colocación se controla por separado para notas al pie y notas finales a través de FootnoteOptions y EndnoteOptions, ambos implementando la interfaz compartida IFootnoteOptions. FootnoteOptions.Position (un valor FootnotePosition — BottomOfPage o BeneathText) y EndnoteOptions.Position (un valor EndnotePosition — EndOfSection o EndOfDocument) controlan dónde se coloca cada tipo. Ambos exponen NumberStyle, StartNumber y RestartRule (un valor FootnoteNumberingRule — Continuous, RestartSection, RestartPage o Default) para controlar la secuencia de numeración. FootnoteOptions además expone Columns, para disponer las notas al pie en la parte inferior de la página en múltiples columnas.

Separadores de notas al pie y notas finales

FootnoteSeparator es un nodo de historia que contiene el contenido que Word inserta entre el cuerpo principal del documento y sus notas al pie/notas finales — la línea horizontal corta por defecto, pero puede contener cualquier contenido de párrafo. Su propiedad SeparatorType (un valor FootnoteSeparatorType) distingue los seis roles de separador que Word define: FootnoteSeparator, FootnoteContinuationSeparator, FootnoteContinuationNotice, y los equivalentes de nota final. FootnoteSeparatorCollection proporciona acceso tipado a todos los nodos separadores en un documento a través de GetByFootnoteSeparatorType(FootnoteSeparatorType).

Consejos y Mejores Prácticas

• Compruebe Footnote.FootnoteType antes de asumir que un nodo Footnote es una nota al pie — la misma clase representa tanto notas al pie como notas finales.
• Utilice ActualReferenceMark en lugar de ReferenceMark cuando necesite la marca tal como se renderizará realmente, ya que las marcas autogeneradas difieren del carácter de marca configurado.
• Configure FootnoteOptions y EndnoteOptions antes de agregar contenido de nota al pie/nota final para que las reglas de numeración se apliquen de forma consistente desde la primera nota.
• El contenido de FootnoteSeparator rara vez se personaliza — la mayoría de los documentos dependen del separador predeterminado de Word — pero es totalmente accesible si un documento requiere un aviso de continuación personalizado.

Problemas Comunes

FAQ

¿Cómo puedo distinguir una nota al pie de una nota al final en el código?

Verifique la propiedad FootnoteType en el objeto Footnote — devuelve FootnoteType.Footnote o FootnoteType.Endnote.

¿Pueden las notas al pie y las notas al final tener reglas de numeración diferentes?

Sí — FootnoteOptions y EndnoteOptions se configuran de forma independiente, cada una con su propio Position, NumberStyle, StartNumber y RestartRule.

¿Para qué se usa FootnoteSeparator?

Representa el contenido que Word inserta para separar visualmente el cuerpo principal del documento de sus notas al pie o notas al final, y el aviso que se muestra cuando una nota al pie continúa en la página siguiente.

¿Footnote admite tablas dentro de la nota?

Sí — Footnote expone una propiedad Tables junto con Paragraphs, ya que es un nodo de historia compuesto como el cuerpo principal del documento.

API Reference Resumen

Ver también

• Aspose.Words for .NET — Enterprise Documentation