Class ParagraphOrphansControl

java.lang.Object
com.itextpdf.layout.properties.ParagraphOrphansControl

public class ParagraphOrphansControl extends Object
A specialized class holding configurable parameters related to Paragraph's orphans restrictions. This class is meant to be used as the value for the Property.ORPHANS_CONTROL key.
  • Field Details

    • minOrphans

      private int minOrphans
  • Constructor Details

    • ParagraphOrphansControl

      public ParagraphOrphansControl(int minOrphans)
      Creates a ParagraphOrphansControl instance with a specified orphans limitation.
      Parameters:
      minOrphans - minimal number of paragraph's lines to remain on an area before an area break.
  • Method Details

    • setMinAllowedOrphans

      public ParagraphOrphansControl setMinAllowedOrphans(int minOrphans)
      Sets parameter that defines orphans restrictions.
      Parameters:
      minOrphans - minimal number of paragraph's lines to remain on an area before an area break.
      Returns:
      this ParagraphOrphansControl instance
    • getMinOrphans

      public int getMinOrphans()
      Gets minimal number of paragraph's lines to remain on an area before a split.
      Returns:
      minimal number of paragraph's lines to remain on an area before an area break.
    • handleViolatedOrphans

      public void handleViolatedOrphans(ParagraphRenderer renderer, String message)
      Writes a log message reporting that orphans constraint is violated. This method is to be overridden if violation scenarios need to be handled in some other way.
      Parameters:
      renderer - a renderer processing orphans
      message - String explaining the reason for violation