org.gnu.pango
Class FontDescription
Boxed
org.gnu.pango.FontDescription
public class FontDescription
extends Boxed
The FontDescription represents the description of an ideal font. This is used
both to list what fonts are available on the system and also for specifying
the characteristics of a font to load.
FontDescription() - Create a new FontDescription.
|
FontDescription(Handle handle) - Create a new FontDescription using a handle from native methods.
|
FontDescription(String str) - Create a new FontDescription from a string in the form
"[FAMILY-LIST][STYLE-OPTIONS][SIZE]" where FAMILY-LIST is a comma
separated list of families optionally terminated by a comma,
STYLE-OPTIONS is a whitespace separated list of words where each WORD
describes one of style, varient, weight, or stretch and SIZE is a decimal
number (size in points).
|
FontDescription(FontDescription fd) - Create a new FontDescription that is a copy of the provided
FontDescription.
|
boolean | betterMatch(FontDescription oldMatch, FontDescription newMatch) - Determines if the style attributes of newMatch are a closer match
for this FontDescription than oldMatch, or if oldMatch is
null, determines if newMatch is a match at all.
|
boolean | equal(FontDescription fd) - Compares two FontDescriptions for equality.
|
String | getFamily() - Gets the family name field of a font description.
|
FontMask | getSetFields() - Determines which fields in a font description have been set.
|
int | getSize() - Gets the size field of a font description.
|
Stretch | getStretch() - Gets the stretch field of a font description.
|
Style | getStyle() - Gets the style field of a PangoFontDescription.
|
Variant | getVariant() - Gets the variant field of the description.
|
Weight | getWeight() - Gets the weight field of a font description.
|
int | hash() - Create a hash of this object.
|
void | replace(FontDescription descToMerge, boolean replaceExisting) - Merges the fields that are set in desc_to_merge into the fields in desc.
|
void | setFamily(String family) - Sets the family name field of a font description.
|
void | setSize(int size) - Sets the size field of a font description.
|
void | setStretch(Stretch stretch) - Sets the stretch field of a font description.
|
void | setStyle(Style style) - Sets the style field of a PangoFontDescription.
|
void | setVariant(Variant var) - Sets the variant field of a font description.
|
void | setWeight(Weight weight) - Sets the weight field of a font description.
|
String | toFilename() - Creates a filename representation of a font description.
|
String | toString() - Creates a string representation of a font description.
|
void | unsetFields(FontMask mask) - Unset some of the fields in this FontDescription.
|
FontDescription
public FontDescription()
Create a new FontDescription.
FontDescription
public FontDescription(Handle handle)
Create a new FontDescription using a handle from native methods. This
should only be used internally by java-gnome.
FontDescription
public FontDescription(String str)
Create a new FontDescription from a string in the form
"[FAMILY-LIST][STYLE-OPTIONS][SIZE]" where FAMILY-LIST is a comma
separated list of families optionally terminated by a comma,
STYLE-OPTIONS is a whitespace separated list of words where each WORD
describes one of style, varient, weight, or stretch and SIZE is a decimal
number (size in points). Any one of the options may be absent.
str
- The string representation for the font description.
FontDescription
public FontDescription(FontDescription fd)
Create a new FontDescription that is a copy of the provided
FontDescription.
betterMatch
public boolean betterMatch(FontDescription oldMatch,
FontDescription newMatch)
Determines if the style attributes of newMatch are a closer match
for this FontDescription than oldMatch, or if oldMatch is
null, determines if newMatch is a match at all.
equal
public boolean equal(FontDescription fd)
Compares two FontDescriptions for equality.
- ture if the two FontDescriptions are proveably identical.
getFamily
public String getFamily()
Gets the family name field of a font description.
getSetFields
public FontMask getSetFields()
Determines which fields in a font description have been set.
getSize
public int getSize()
Gets the size field of a font description.
getStretch
public Stretch getStretch()
Gets the stretch field of a font description.
getStyle
public Style getStyle()
Gets the style field of a PangoFontDescription.
getVariant
public Variant getVariant()
Gets the variant field of the description.
getWeight
public Weight getWeight()
Gets the weight field of a font description.
hash
public int hash()
Create a hash of this object.
replace
public void replace(FontDescription descToMerge,
boolean replaceExisting)
Merges the fields that are set in desc_to_merge into the fields in desc.
If replace_existing is FALSE, only fields in desc that are not already
set are affected. If TRUE, then fields that are already set will be
replaced as well.
setFamily
public void setFamily(String family)
Sets the family name field of a font description. The family name
represents a family of related font styles, and will resolve to a
particular PangoFontFamily. In some uses of PangoFontDescription, it is
also possible to use a comma separated list of family names for this
field.
setSize
public void setSize(int size)
Sets the size field of a font description.
setStretch
public void setStretch(Stretch stretch)
Sets the stretch field of a font description. The stretch field specifies
how narrow or wide the font should be.
setStyle
public void setStyle(Style style)
Sets the style field of a PangoFontDescription. The PangoStyle
enumeration describes whether the font is slanted and the manner in which
it is slanted; it can be either Style.NORMAL, Style.ITALIC, or
Style.OBLIQUE. Most fonts will either have a italic style or an oblique
style, but not both, and font matching in Pango will match italic
specifications with oblique fonts and vice-versa if an exact match is not
found.
setVariant
public void setVariant(Variant var)
Sets the variant field of a font description. The Variant can either be
Variant.NORMAL or Variant.SMALL_CAPS.
setWeight
public void setWeight(Weight weight)
Sets the weight field of a font description. The weight field specifies
how bold or light the font should be.
toFilename
public String toFilename()
Creates a filename representation of a font description. The filename is
identical to the results of calling toString, but with
underscores instead of characters that are untypical in filenames, and in
lower case only.
toString
public String toString()
Creates a string representation of a font description.
unsetFields
public void unsetFields(FontMask mask)
Unset some of the fields in this FontDescription.