Class DefaultUnitConverter
- java.lang.Object
-
- com.privatejgoodies.common.bean.Bean
-
- com.privatejgoodies.forms.util.AbstractUnitConverter
-
- com.privatejgoodies.forms.util.DefaultUnitConverter
-
- All Implemented Interfaces:
ObservableBean
,ObservableBean2
,UnitConverter
,java.io.Serializable
public final class DefaultUnitConverter extends AbstractUnitConverter
This is the default implementation of theUnitConverter
interface. It converts horizontal and vertical dialog base units to pixels.The horizontal base unit is equal to the average width, in pixels, of the characters in the system font; the vertical base unit is equal to the height, in pixels, of the font. Each horizontal base unit is equal to 4 horizontal dialog units; each vertical base unit is equal to 8 vertical dialog units.
The DefaultUnitConverter computes dialog base units using a default font and a test string for the average character width. You can configure the font and the test string via the bound Bean properties defaultDialogFont and averageCharacterWidthTestString. See also Microsoft's suggestion for a custom computation custom computation. More information how to use dialog units in screen design can be found in Microsoft's Design Specifications and Guidelines.
Since the Forms 1.1 this converter logs font information at the
CONFIG
level.- Version:
- $Revision: 1.23 $
- Author:
- Karsten Lentzsch
- See Also:
UnitConverter
,Size
,Sizes
, Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description static java.lang.String
BALANCED_AVERAGE_CHARACTER_TEST_STRING
static java.lang.String
MODERN_AVERAGE_CHARACTER_TEST_STRING
static java.lang.String
OLD_AVERAGE_CHARACTER_TEST_STRING
static java.lang.String
PROPERTY_AVERAGE_CHARACTER_WIDTH_TEST_STRING
static java.lang.String
PROPERTY_DEFAULT_DIALOG_FONT
-
Fields inherited from class com.privatejgoodies.common.bean.Bean
changeSupport
-
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description java.lang.String
getAverageCharacterWidthTestString()
Returns the string used to compute the average character width.java.awt.Font
getDefaultDialogFont()
Returns the dialog font that is used to compute the dialog base units.protected double
getDialogBaseUnitsX(java.awt.Component component)
Returns the cached or computed horizontal dialog base units.protected double
getDialogBaseUnitsY(java.awt.Component component)
Returns the cached or computed vertical dialog base units for the given component.static DefaultUnitConverter
getInstance()
Lazily instantiates and returns the sole instance.void
setAverageCharacterWidthTestString(java.lang.String newTestString)
Sets a string that will be used to compute the average character width.void
setDefaultDialogFont(java.awt.Font newFont)
Sets a dialog font that will be used to compute the dialog base units.-
Methods inherited from class com.privatejgoodies.forms.util.AbstractUnitConverter
centimeterAsPixel, centimeterAsPixel, computeAverageCharWidth, dialogUnitXAsPixel, dialogUnitXAsPixel, dialogUnitYAsPixel, dialogUnitYAsPixel, getDefaultScreenResolution, getScreenResolution, inchAsPixel, inchAsPixel, millimeterAsPixel, millimeterAsPixel, pointAsPixel, pointAsPixel
-
Methods inherited from class com.privatejgoodies.common.bean.Bean
addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, addVetoableChangeListener, createPropertyChangeSupport, fireIndexedPropertyChange, fireIndexedPropertyChange, fireIndexedPropertyChange, fireMultiplePropertiesChanged, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, fireVetoableChange, fireVetoableChange, fireVetoableChange, fireVetoableChange, fireVetoableChange, fireVetoableChange, getPropertyChangeListeners, getPropertyChangeListeners, getVetoableChangeListeners, getVetoableChangeListeners, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, removeVetoableChangeListener
-
-
-
-
Field Detail
-
PROPERTY_AVERAGE_CHARACTER_WIDTH_TEST_STRING
public static final java.lang.String PROPERTY_AVERAGE_CHARACTER_WIDTH_TEST_STRING
- See Also:
- Constant Field Values
-
PROPERTY_DEFAULT_DIALOG_FONT
public static final java.lang.String PROPERTY_DEFAULT_DIALOG_FONT
- See Also:
- Constant Field Values
-
OLD_AVERAGE_CHARACTER_TEST_STRING
public static final java.lang.String OLD_AVERAGE_CHARACTER_TEST_STRING
- Since:
- 1.6
- See Also:
- Constant Field Values
-
MODERN_AVERAGE_CHARACTER_TEST_STRING
public static final java.lang.String MODERN_AVERAGE_CHARACTER_TEST_STRING
- Since:
- 1.4
- See Also:
- Constant Field Values
-
BALANCED_AVERAGE_CHARACTER_TEST_STRING
public static final java.lang.String BALANCED_AVERAGE_CHARACTER_TEST_STRING
- Since:
- 1.4
- See Also:
- Constant Field Values
-
-
Method Detail
-
getInstance
public static DefaultUnitConverter getInstance()
Lazily instantiates and returns the sole instance.- Returns:
- the lazily instantiated sole instance
-
getAverageCharacterWidthTestString
public java.lang.String getAverageCharacterWidthTestString()
Returns the string used to compute the average character width. By default it is initialized toBALANCED_AVERAGE_CHARACTER_TEST_STRING
.- Returns:
- the test string used to compute the average character width
-
setAverageCharacterWidthTestString
public void setAverageCharacterWidthTestString(java.lang.String newTestString)
Sets a string that will be used to compute the average character width. By default it is initialized toBALANCED_AVERAGE_CHARACTER_TEST_STRING
. You can provide other test strings, for example:- "Xximeee"
- "ABCEDEFHIJKLMNOPQRSTUVWXYZ"
- "abcdefghijklmnopqrstuvwxyz"
- Parameters:
newTestString
- the test string to be used- Throws:
java.lang.NullPointerException
- ifnewTestString
isnull
java.lang.IllegalArgumentException
- ifnewTestString
is empty or whitespace
-
getDefaultDialogFont
public java.awt.Font getDefaultDialogFont()
Returns the dialog font that is used to compute the dialog base units. If a default dialog font has been set usingsetDefaultDialogFont(Font)
, this font will be returned. Otherwise a cached fallback will be lazily created.- Returns:
- the font used to compute the dialog base units
-
setDefaultDialogFont
public void setDefaultDialogFont(java.awt.Font newFont)
Sets a dialog font that will be used to compute the dialog base units.- Parameters:
newFont
- the default dialog font to be set
-
getDialogBaseUnitsX
protected double getDialogBaseUnitsX(java.awt.Component component)
Returns the cached or computed horizontal dialog base units.- Specified by:
getDialogBaseUnitsX
in classAbstractUnitConverter
- Parameters:
component
- a Component that provides the font and graphics- Returns:
- the horizontal dialog base units
-
getDialogBaseUnitsY
protected double getDialogBaseUnitsY(java.awt.Component component)
Returns the cached or computed vertical dialog base units for the given component.- Specified by:
getDialogBaseUnitsY
in classAbstractUnitConverter
- Parameters:
component
- a Component that provides the font and graphics- Returns:
- the vertical dialog base units
-
-