RtfSection (Apache FOP Core 2.11 API)
Date: 2025-04-24

org.apache.fop.render.rtf.rtflib.rtfdoc

## Class RtfSection

- java.lang.Object
- - org.apache.fop.render.rtf.rtflib.rtfdoc.RtfElement
  - - org.apache.fop.render.rtf.rtflib.rtfdoc.RtfContainer
    - - org.apache.fop.render.rtf.rtflib.rtfdoc.RtfSection

- All Implemented Interfaces:
    IRtfAfterContainer, IRtfBeforeContainer, IRtfExternalGraphicContainer, IRtfJforCmdContainer, IRtfListContainer, IRtfParagraphContainer, IRtfParagraphKeepTogetherContainer, IRtfTableContainer, IRtfTextrunContainer

      public class RtfSection
      extends RtfContainer
      implements IRtfParagraphContainer, IRtfTableContainer, IRtfListContainer, IRtfExternalGraphicContainer, IRtfBeforeContainer, IRtfParagraphKeepTogetherContainer, IRtfAfterContainer, IRtfJforCmdContainer, IRtfTextrunContainer

  Models a section in an RTF document

  This work was authored by Bertrand Delacretaz (bdelacretaz@codeconsult.ch).

- - ### Field Summary

    - ### Fields inherited from class org.apache.fop.render.rtf.rtflib.rtfdoc.RtfElement

      `attrib, parent, writer`

  - ### Method Summary

    All Methods Instance Methods Concrete Methods
    Modifier and Type | Method and Description
    --- | ---
    `RtfTextrun` | `getTextrun()` Returns the current RtfTextrun.
    `RtfAfter` | `newAfter(RtfAttributes attrs)` IRtfAfterContainer
    `RtfBefore` | `newBefore(RtfAttributes attrs)` IRtfBeforeContainer
    `RtfExternalGraphic` | `newImage()` Start a new external graphic after closing current paragraph, list and table
    `RtfJforCmd` | `newJforCmd(RtfAttributes attrs)`
    `RtfList` | `newList(RtfAttributes attrs)` Start a new list after closing current paragraph, list and table
    `RtfParagraph` | `newParagraph()` Close current paragraph if any and start a new one with default attributes
    `RtfParagraph` | `newParagraph(RtfAttributes attrs)` Start a new paragraph after closing current paragraph, list and table
    `RtfParagraphKeepTogether` | `newParagraphKeepTogether()` Close current paragraph if any and start a new one
    `RtfTable` | `newTable(ITableColumnsInfo tc)` Start a new table after closing current paragraph, list and table
    `RtfTable` | `newTable(RtfAttributes attrs, ITableColumnsInfo tc)` Start a new table after closing current paragraph, list and table
    `protected void` | `writeRtfPrefix()` Can be overridden to write RTF prefix code, what comes before our children
    `protected void` | `writeRtfSuffix()` Can be overridden to write RTF suffix code, what comes after our children

    - ### Methods inherited from class org.apache.fop.render.rtf.rtflib.rtfdoc.RtfContainer

      `addChild, findChildren, getChildCount, getChildren, isEmpty, okToWriteRtf, setChildren, setOptions, toString, writeRtfContent`

    - ### Methods inherited from class org.apache.fop.render.rtf.rtflib.rtfdoc.RtfElement

      `close, getParentOfClass, getRtfAttributes, newLine, writeAttributes, writeControlWord, writeControlWordNS, writeExceptionInRtf, writeGroupMark, writeOneAttribute, writeOneAttributeNS, writeRtf, writeStarControlWord, writeStarControlWordNS`

    - ### Methods inherited from class java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

- - ### Method Detail

    - #### newImage

          public RtfExternalGraphic newImage()
                                      throws IOException

      Start a new external graphic after closing current paragraph, list and table
      Specified by:
        `newImage` in interface `IRtfExternalGraphicContainer`
      Returns:
        new RtfExternalGraphic object
      Throws:
        `IOException` - for I/O problems

    - #### newParagraph

          public RtfParagraph newParagraph(RtfAttributes attrs)
                                    throws IOException

      Start a new paragraph after closing current paragraph, list and table
      Specified by:
        `newParagraph` in interface `IRtfParagraphContainer`
      Parameters:
        `attrs` - attributes for new RtfParagraph
      Returns:
        new RtfParagraph object
      Throws:
        `IOException` - for I/O problems

    - #### newParagraph

          public RtfParagraph newParagraph()
                                    throws IOException

      Close current paragraph if any and start a new one with default attributes
      Specified by:
        `newParagraph` in interface `IRtfParagraphContainer`
      Returns:
        new RtfParagraph
      Throws:
        `IOException` - for I/O problems

    - #### newParagraphKeepTogether

          public RtfParagraphKeepTogether newParagraphKeepTogether()
                                                            throws IOException

      Close current paragraph if any and start a new one
      Specified by:
        `newParagraphKeepTogether` in interface `IRtfParagraphKeepTogetherContainer`
      Returns:
        new RtfParagraphKeepTogether
      Throws:
        `IOException` - for I/O problems

    - #### newTable

          public RtfTable newTable(ITableColumnsInfo tc)
                            throws IOException

      Start a new table after closing current paragraph, list and table
      Specified by:
        `newTable` in interface `IRtfTableContainer`
      Parameters:
        `tc` - Table context used for number-columns-spanned attribute (added by Boris Poudérous on july 2002)
      Returns:
        new RtfTable object
      Throws:
        `IOException` - for I/O problems

    - #### newTable

          public RtfTable newTable(RtfAttributes attrs,
                                   ITableColumnsInfo tc)
                            throws IOException

      Start a new table after closing current paragraph, list and table
      Specified by:
        `newTable` in interface `IRtfTableContainer`
      Parameters:
        `attrs` - attributes of new RtfTable
        `tc` - Table context used for number-columns-spanned attribute (added by Boris Poudérous on july 2002)
      Returns:
        new RtfTable object
      Throws:
        `IOException` - for I/O problems

    - #### newList

          public RtfList newList(RtfAttributes attrs)
                          throws IOException

      Start a new list after closing current paragraph, list and table
      Specified by:
        `newList` in interface `IRtfListContainer`
      Parameters:
        `attrs` - attributes of new RftList object
      Returns:
        new RtfList
      Throws:
        `IOException` - for I/O problems

    - #### newBefore

          public RtfBefore newBefore(RtfAttributes attrs)
                              throws IOException

      IRtfBeforeContainer
      Specified by:
        `newBefore` in interface `IRtfBeforeContainer`
      Parameters:
        `attrs` - attributes of new RtfBefore object
      Returns:
        new RtfBefore object
      Throws:
        `IOException` - for I/O problems

    - #### newAfter

          public RtfAfter newAfter(RtfAttributes attrs)
                            throws IOException

      IRtfAfterContainer
      Specified by:
        `newAfter` in interface `IRtfAfterContainer`
      Parameters:
        `attrs` - attributes of new RtfAfter object
      Returns:
        new RtfAfter object
      Throws:
        `IOException` - for I/O problems

    - #### newJforCmd

          public RtfJforCmd newJforCmd(RtfAttributes attrs)
                                throws IOException

      Specified by:
        `newJforCmd` in interface `IRtfJforCmdContainer`
      Parameters:
        `attrs` - attributes of new RtfJforCmd
      Returns:
        the new RtfJforCmd
      Throws:
        `IOException` - for I/O problems

    - #### writeRtfPrefix

          protected void writeRtfPrefix()
                                 throws IOException

      Can be overridden to write RTF prefix code, what comes before our children
      Overrides:
        `writeRtfPrefix` in class `RtfElement`
      Throws:
        `IOException` - for I/O problems

    - #### writeRtfSuffix

          protected void writeRtfSuffix()
                                 throws IOException

      Can be overridden to write RTF suffix code, what comes after our children
      Overrides:
        `writeRtfSuffix` in class `RtfElement`
      Throws:
        `IOException` - for I/O problems

    - #### getTextrun

          public RtfTextrun getTextrun()
                                throws IOException

      Returns the current RtfTextrun.
      Specified by:
        `getTextrun` in interface `IRtfTextrunContainer`
      Returns:
        Current RtfTextrun
      Throws:
        `IOException` - Thrown when an IO-problem occurs.

Copyright © 2025 Apache Software Foundation. All rights reserved.