com.itextpdf.layout.property

Class ParagraphOrphansControl

java.lang.Object

com.itextpdf.layout.property.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.

Constructor Summary

Constructors

Constructor and Description
ParagraphOrphansControl(int minOrphans) Creates a ParagraphOrphansControl instance with a specified orphans limitation.

Method Summary

Modifier and Type	Method and Description
int	getMinOrphans() Gets minimal number of paragraph's lines to remain on an area before a split.
void	handleViolatedOrphans(ParagraphRenderer renderer, String message) Writes a log message reporting that orphans constraint is violated.
ParagraphOrphansControl	setMinAllowedOrphans(int minOrphans) Sets parameter that defines orphans restrictions.

Methods inherited from class java.lang.Object

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

Constructor Detail

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 Detail

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