org.eclipse.swt.graphics
Class FontData

java.lang.Object
  |
  +--org.eclipse.swt.graphics.FontData

public final class FontData
extends Object

Safe:


Field Summary
(package private)  String country
          The locales of the font (Warning: These fields are platform dependent)
 org.eclipse.swt.internal.win32.LOGFONT data
          Suppressed: A Win32 LOGFONT struct (Warning: This field is platform dependent)
 int height
          Suppressed: The height of the font data in points (Warning: This field is platform dependent)
(package private)  String lang
          The locales of the font (Warning: These fields are platform dependent)
(package private)  String variant
          The locales of the font (Warning: These fields are platform dependent)
 
Constructor Summary
  FontData()
          Enabled: Constructs a new un-initialized font data.
(package private) FontData(org.eclipse.swt.internal.win32.LOGFONT data, int height)
          Constructs a new font data given the Windows LOGFONT that it should represent.
  FontData(String string)
          Enabled: Constructs a new FontData given a string representation in the form generated by the FontData.toString method.
  FontData(String name, int height, int style)
          Enabled: Constructs a new font data given a font name, the height of the desired font in points, and a font style.
 
Method Summary
(package private)  int EnumLocalesProc(int lpLocaleString)
           
 boolean equals(Object object)
          Suppressed: Compares the argument to the receiver, and returns true if they represent the same object using a class specific comparison.
 int getHeight()
          Enabled: Returns the height of the receiver in points.
 String getName()
          Enabled: Returns the name of the receiver.
 int getStyle()
          Enabled: Returns the style of the receiver which is a bitwise OR of one or more of the SWT constants NORMAL, BOLD and ITALIC.
 int hashCode()
          Suppressed: Returns an integer hash code for the receiver.
 void setHeight(int height)
          Enabled: Sets the height of the receiver.
 void setLocale(String locale)
          Enabled: Sets the locale of the receiver.
 void setName(String name)
          Enabled: Sets the name of the receiver.
 void setStyle(int style)
          Enabled: Sets the style of the receiver to the argument which must be a bitwise OR of one or more of the SWT constants NORMAL, BOLD and ITALIC.
 String toString()
          Suppressed: Returns a string representation of the receiver which is suitable for constructing an equivalent instance using the FontData(String) constructor.
static FontData win32_new(org.eclipse.swt.internal.win32.LOGFONT data, int height)
          Suppressed: Invokes platform specific functionality to allocate a new font data.
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Field Detail

data

public org.eclipse.swt.internal.win32.LOGFONT data
Suppressed: A Win32 LOGFONT struct (Warning: This field is platform dependent)


height

public int height
Suppressed: The height of the font data in points (Warning: This field is platform dependent)


lang

String lang
The locales of the font (Warning: These fields are platform dependent)


country

String country
The locales of the font (Warning: These fields are platform dependent)


variant

String variant
The locales of the font (Warning: These fields are platform dependent)

Constructor Detail

FontData

public FontData()
Enabled: Constructs a new un-initialized font data.


FontData

FontData(org.eclipse.swt.internal.win32.LOGFONT data,
         int height)
Constructs a new font data given the Windows LOGFONT that it should represent.

Parameters:
data - the LOGFONT for the result

FontData

public FontData(String string)
Enabled: Constructs a new FontData given a string representation in the form generated by the FontData.toString method.

Note that the representation varies between platforms, and a FontData can only be created from a string that was generated on the same platform.

Parameters:
string - the string representation of a FontData (must not be null)
See Also:
toString()

FontData

public FontData(String name,
                int height,
                int style)
Enabled: Constructs a new font data given a font name, the height of the desired font in points, and a font style.

Parameters:
name - the name of the font (must not be null)
height - the font height in points
style - a bit or combination of NORMAL, BOLD, ITALIC
Method Detail

equals

public boolean equals(Object object)
Suppressed: Compares the argument to the receiver, and returns true if they represent the same object using a class specific comparison.

Overrides:
equals in class Object
Parameters:
object - the object to compare with this object
Returns:
true if the object is the same as this object and false otherwise
See Also:
hashCode()

EnumLocalesProc

int EnumLocalesProc(int lpLocaleString)

getHeight

public int getHeight()
Enabled: Returns the height of the receiver in points.

Returns:
the height of this FontData
See Also:
setHeight(int)

getName

public String getName()
Enabled: Returns the name of the receiver. On platforms that support font foundries, the return value will be the foundry followed by a dash ("-") followed by the face name.

Returns:
the name of this FontData
See Also:
setName(java.lang.String)

getStyle

public int getStyle()
Enabled: Returns the style of the receiver which is a bitwise OR of one or more of the SWT constants NORMAL, BOLD and ITALIC.

Returns:
the style of this FontData
See Also:
setStyle(int)

hashCode

public int hashCode()
Suppressed: Returns an integer hash code for the receiver. Any two objects which return true when passed to equals must return the same value for this method.

Overrides:
hashCode in class Object
Returns:
the receiver's hash
See Also:
equals(java.lang.Object)

setHeight

public void setHeight(int height)
Enabled: Sets the height of the receiver. The parameter is specified in terms of points, where a point is one seventy-second of an inch.

Parameters:
height - the height of the FontData
See Also:
getHeight()

setLocale

public void setLocale(String locale)
Enabled: Sets the locale of the receiver.

The locale determines which platform character set this font is going to use. Widgets and graphics operations that use this font will convert UNICODE strings to the platform character set of the specified locale.

On platforms which there are multiple character sets for a given language/country locale, the variant portion of the locale will determine the character set.

Parameters:
locale - the String representing a Locale object
See Also:
java.util.Locale#toString

setName

public void setName(String name)
Enabled: Sets the name of the receiver.

Some platforms support font foundries. On these platforms, the name of the font specified in setName() may have one of the following forms:

  1. a face name (for example, "courier")
  2. a foundry followed by a dash ("-") followed by a face name (for example, "adobe-courier")
In either case, the name returned from getName() will include the foundry.

On platforms that do not support font foundries, only the face name (for example, "courier") is used in setName() and getName().

Parameters:
name - the name of the font data (must not be null)
See Also:
getName()

setStyle

public void setStyle(int style)
Enabled: Sets the style of the receiver to the argument which must be a bitwise OR of one or more of the SWT constants NORMAL, BOLD and ITALIC.

Parameters:
style - the new style for this FontData
See Also:
getStyle()

toString

public String toString()
Suppressed: Returns a string representation of the receiver which is suitable for constructing an equivalent instance using the FontData(String) constructor.

Overrides:
toString in class Object
Returns:
a string representation of the FontData
See Also:
FontData

win32_new

public static FontData win32_new(org.eclipse.swt.internal.win32.LOGFONT data,
                                 int height)
Suppressed: Invokes platform specific functionality to allocate a new font data.

IMPORTANT: This method is not part of the public API for FontData. It is marked public only so that it can be shared within the packages provided by SWT. It is not available on all platforms, and should never be called from application code.

Parameters:
data - the LOGFONT for the font data


comments?