MediaSize JDK 1.6)

Constructors

public MediaSize (float x, float y, int units)

Construct a new media size attribute from the given floating-point values.

Construct a new media size attribute from the given floating-point
values.
Parameters:
- x - X dimension.
- y - Y dimension.
- units - Unit conversion factor, e.g. Size2DSyntax.INCH or Size2DSyntax.MM.
Throws:
- IllegalArgumentException - (Unchecked exception) Thrown if x < 0 or y < 0 or units < 1 or x > y.

public MediaSize (float x, float y, int units, MediaSizeName media)

Construct a new media size attribute from the given floating-point values.

Construct a new media size attribute from the given floating-point
values.
Parameters:
- x - X dimension.
- y - Y dimension.
- units - Unit conversion factor, e.g. Size2DSyntax.INCH or Size2DSyntax.MM.
- media - a media name to associate with this MediaSize
Throws:
- IllegalArgumentException - (Unchecked exception) Thrown if x < 0 or y < 0 or units < 1 or x > y.

public MediaSize (int x, int y, int units)

Construct a new media size attribute from the given integer values.

Construct a new media size attribute from the given integer values.
Parameters:
- x - X dimension.
- y - Y dimension.
- units - Unit conversion factor, e.g. Size2DSyntax.INCH or Size2DSyntax.MM.
Throws:
- IllegalArgumentException - (Unchecked exception) Thrown if x < 0 or y < 0 or units < 1 or x > y.

public MediaSize (int x, int y, int units, MediaSizeName media)

Construct a new media size attribute from the given integer values.

Construct a new media size attribute from the given integer values.
Parameters:
- x - X dimension.
- y - Y dimension.
- units - Unit conversion factor, e.g. Size2DSyntax.INCH or Size2DSyntax.MM.
- media - a media name to associate with this MediaSize
Throws:
- IllegalArgumentException - (Unchecked exception) Thrown if x < 0 or y < 0 or units < 1 or x > y.

Methods

Hide/Show inherited methods

public boolean equals (Object object) [Overrides Size2DSyntax]

Returns whether this media size attribute is equivalent to the passed in object.

Returns whether this media size attribute is equivalent to the passed
in object.
To be equivalent, all of the following conditions must be true:

object is not null.
object is an instance of class MediaSize.
This media size attribute's X dimension is equal to
object's X dimension.
This media size attribute's Y dimension is equal to
object's Y dimension.

Returns: True if object is equivalent to this media size attribute, false otherwise.
Parameters:
- object - Object to compare to.

publicstatic MediaSizeName findMedia (float x, float y, int units)

The specified dimensions are used to locate a matching MediaSize instance from amongst all the standard MediaSize instances.

publicfinal Class<Attribute> getCategory () [Specified in Attribute]

Get the printing attribute class which is to be used as the "category" for this printing attribute value.

publicstatic MediaSize getMediaSizeForName (MediaSizeName media)

Get the MediaSize for the specified named media.

public MediaSizeName getMediaSizeName ()

Get the media name, if any, for this size.

publicfinal String getName () [Specified in Attribute]

Get the name of the category of which this attribute value is an instance.

public float getSize (int units) [Inherited From Size2DSyntax]

Get this two-dimensional size attribute's dimensions in the given units as floating-point values.

Get this two-dimensional size attribute's dimensions in the given units
as floating-point values.
Returns: A two-element array with the X dimension at index 0 and the Y dimension at index 1.
Parameters:
- units - Unit conversion factor, e.g. {@link #INCH INCH} or {@link #MM MM}.
Throws:
- IllegalArgumentException - (unchecked exception) Thrown if units < 1.

public float getX (int units) [Inherited From Size2DSyntax]

Returns this two-dimensional size attribute's X dimension in the given units as a floating-point value.

Returns this two-dimensional size attribute's X dimension in the given
units as a floating-point value.
Returns: X dimension.
Parameters:
- units - Unit conversion factor, e.g. {@link #INCH INCH} or {@link #MM MM}.
Throws:
- IllegalArgumentException - (unchecked exception) Thrown if units < 1.

protected int getXMicrometers () [Inherited From Size2DSyntax]

Returns this two-dimensional size attribute's X dimension in units of micrometers (µm).

public float getY (int units) [Inherited From Size2DSyntax]

Returns this two-dimensional size attribute's Y dimension in the given units as a floating-point value.

Returns this two-dimensional size attribute's Y dimension in the given
units as a floating-point value.
Returns: Y dimension.
Parameters:
- units - Unit conversion factor, e.g. {@link #INCH INCH} or {@link #MM MM}.
Throws:
- IllegalArgumentException - (unchecked exception) Thrown if units < 1.

protected int getYMicrometers () [Inherited From Size2DSyntax]

Returns this two-dimensional size attribute's Y dimension in units of micrometers (µm).

public int hashCode () [Inherited From Size2DSyntax]

Returns a hash code value for this two-dimensional size attribute.

public String toString () [Inherited From Size2DSyntax]

Returns a string version of this two-dimensional size attribute.

Returns a string version of this two-dimensional size attribute. The
string takes the form "XxY um", where
X is the X dimension and Y is the Y dimension.
The values are reported in the internal units of micrometers.

public String toString (int units, String unitsName) [Inherited From Size2DSyntax]

Returns a string version of this two-dimensional size attribute in the given units.

Returns a string version of this two-dimensional size attribute in the
given units. The string takes the form

"XxY 
 U"

, where X is the X dimension, Y is the Y
dimension, and U is the units name. The values are displayed in
floating point.
Returns: String version of this two-dimensional size attribute.
Parameters:
- units - Unit conversion factor, e.g. {@link #INCH INCH} or {@link #MM MM}.
- unitsName - Units name string, e.g. "in" or "mm". If null, no units name is appended to the result.
Throws:
- IllegalArgumentException - (unchecked exception) Thrown if units < 1.