nextapp.echo
Class Extent

java.lang.Object
  nextapp.echo.Extent

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable

public class Extent
extends java.lang.Object
implements java.lang.Comparable, java.io.Serializable

A representation of a linear distance with units. Extent objects are immutable once constructed.

See Also:

Serialized Form

Field Summary

static byte	CM Centimeter units.
static byte	EM Em units (height of font).
static byte	EX Ex units (height of character 'x' in font).
static byte	IN Inch units.
static byte	MM Millimeter units.
static byte	PC Picas (1pc = 12pt)
static byte	PERCENT Percentage units.
static byte	PT Points (1pt = 1/72in).
static byte	PX Pixel units.

Constructor Summary

Extent(int value, int units)
Creates a new Extent.

Method Summary

static Extent	add(Extent a, Extent b) Adds one Extent to another, returning the sum as a new Extent.
int	compareTo(java.lang.Object o)
boolean	equals(java.lang.Object o)
int	getUnits() Returns the units of the Extent.
int	getValue() Returns the value of the Extent.
boolean	isComparableTo(Extent that) Determines whether this Extent can be compared to another Extent to determine which is a greater length.
boolean	isEnglish() Determines if the Extent has English units, i.e., the units are of type IN (inches), PC (picas), or PT (points).
boolean	isPercentage() Determines if the Extent has percentage-based units.
boolean	isPrint() Determines if this Extent has 'print' based units, i.e., the units are in real dimensions, such as SI or English values, rather than screen-based units such as pixels or percentages.
boolean	isSI() Determines if the Extent has SI (Metric) units, i.e., the units are of type MM (millimeters) or CM (centimeters).
int	toMm() Returns the value of the extent in millimeters.
int	toPoint() Returns the value of the extent in points.
java.lang.String	toString() Returns a string describing the state of the Extent.

Methods inherited from class java.lang.Object

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

Field Detail

PX

public static final byte PX

Pixel units.

See Also:

Constant Field Values

PERCENT

public static final byte PERCENT

Percentage units.

See Also:

Constant Field Values

PT

public static final byte PT

Points (1pt = 1/72in).

See Also:

Constant Field Values

CM

public static final byte CM

Centimeter units.

See Also:

Constant Field Values

MM

public static final byte MM

Millimeter units.

See Also:

Constant Field Values

IN

public static final byte IN

Inch units.

See Also:

Constant Field Values

EM

public static final byte EM

Em units (height of font).

See Also:

Constant Field Values

EX

public static final byte EX

Ex units (height of character 'x' in font).

See Also:

Constant Field Values

PC

public static final byte PC

Picas (1pc = 12pt)

See Also:

Constant Field Values

Constructor Detail

Extent

public Extent(int value,
              int units)

Creates a new Extent.

Parameters:

value - the value of the extent.

units - the units of the value, one of the following constants:

• PX: Pixels
• PERCENT: Percent (of size of containing component)
• PT: Points
• CM: Centimeters
• MM: Millimeters
• IN: Inches
• EM: Ems (height of 'M' character)
• EX: Exs (height of 'x' character)
• PC: Picas

Method Detail

add

public static Extent add(Extent a,
                         Extent b)

Adds one Extent to another, returning the sum as a new Extent. Null is returned if the Extents have incompatible units.

compareTo

public int compareTo(java.lang.Object o)

Specified by:

compareTo in interface java.lang.Comparable

See Also:

Comparable.compareTo(java.lang.Object)

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

See Also:

Object.equals(java.lang.Object)

getValue

public int getValue()

Returns the value of the Extent.

Returns:

The value of the Extent.

getUnits

public int getUnits()

Returns the units of the Extent.

Returns:

The units of the Extent, one of the following constants:

• PX: Pixels
• PERCENT: Percent (of size of containing component)
• PT: Points
• CM: Centimeters
• MM: Millimeters
• IN: Inches
• EM: Ems (height of 'M' character)
• EX: Exs (height of 'x' character)
• PC: Picas

isComparableTo

public boolean isComparableTo(Extent that)

Determines whether this Extent can be compared to another Extent to determine which is a greater length.

Parameters:

that - The Extent to test comparability to.

Returns:

True if the Extents can be compared.

isEnglish

public boolean isEnglish()

Determines if the Extent has English units, i.e., the units are of type IN (inches), PC (picas), or PT (points).

Returns:

True if this Extent has English units.

isSI

public boolean isSI()

Determines if the Extent has SI (Metric) units, i.e., the units are of type MM (millimeters) or CM (centimeters).

Returns:

True if this Extent has SI units.

isPercentage

public boolean isPercentage()

Determines if the Extent has percentage-based units.

Returns:

True if the Extent has percentage-based units.

isPrint

public boolean isPrint()

Determines if this Extent has 'print' based units, i.e., the units are in real dimensions, such as SI or English values, rather than screen-based units such as pixels or percentages.

Returns:

True if this Extent has 'print' based units.

toMm

public int toMm()

Returns the value of the extent in millimeters.

Returns:

The value of the extent in millimeters.

Throws:

java.lang.IllegalStateException - if the value cannot be returned in millimeters. Verify that isPrint() returns true to avoid potentially receiving this exception.

toPoint

public int toPoint()

Returns the value of the extent in points.

Returns:

The value of the extent in points.

Throws:

java.lang.IllegalStateException - if the value cannot be returned in points. Verify that isPrint() returns true to avoid potentially receiving this exception.

toString

public java.lang.String toString()

Returns a string describing the state of the Extent. For debugging purposes only, do not rely on formatting.

Overrides:

toString in class java.lang.Object

See Also:

Object.toString()