org.apache.poi.hssf.record
Class FontRecord

java.lang.Object
  extended by org.apache.poi.hssf.record.RecordBase
      extended by org.apache.poi.hssf.record.Record
          extended by org.apache.poi.hssf.record.StandardRecord
              extended by org.apache.poi.hssf.record.FontRecord

public final class FontRecord
extends StandardRecord

Title: Font Record (0x0031)

- describes a font in the workbook (index = 0-3,5-infinity - skip 4)

Description: An element in the Font Table

REFERENCE: PG 315 Microsoft Excel 97 Developer's Kit (ISBN: 1-57231-498-2)

Author:
Andrew C. Oliver (acoliver at apache dot org)

Field Summary
static short sid
           
static short SS_NONE
           
static short SS_SUB
           
static short SS_SUPER
           
static byte U_DOUBLE
           
static byte U_DOUBLE_ACCOUNTING
           
static byte U_NONE
           
static byte U_SINGLE
           
static byte U_SINGLE_ACCOUNTING
           
 
Constructor Summary
FontRecord()
           
FontRecord(RecordInputStream in)
           
 
Method Summary
 void cloneStyleFrom(FontRecord source)
          Clones all the font style information from another FontRecord, onto this one.
 short getAttributes()
          get the font attributes (see individual bit getters that reference this method)
 short getBoldWeight()
          get the bold weight for this font (100-1000dec or 0x64-0x3e8).
 byte getCharset()
          get the character set
 short getColorPaletteIndex()
          get the font's color palette index
protected  int getDataSize()
           
 byte getFamily()
          get the font family (TODO)
 short getFontHeight()
          gets the height of the font in 1/20th point units
 java.lang.String getFontName()
          get the name of the font
 short getSid()
          return the non static version of the id for this record.
 short getSuperSubScript()
          get the type of super or subscript for the font
 byte getUnderline()
          get the type of underlining for the font
 int hashCode()
           
 boolean isItalic()
          get whether the font is to be italics or not
 boolean isMacoutlined()
          whether to use the mac outline font style thing (mac only) - Some mac person should comment this instead of me doing it (since I have no idea)
 boolean isMacshadowed()
          whether to use the mac shado font style thing (mac only) - Some mac person should comment this instead of me doing it (since I have no idea)
 boolean isStruckout()
          get whether the font is to be stricken out or not
 boolean sameProperties(FontRecord other)
          Does this FontRecord have all the same font properties as the supplied FontRecord? Note that Object.equals(Object) will check for exact objects, while this will check for exact contents, because normally the font record's position makes a big difference too.
 void serialize(LittleEndianOutput out)
          Write the data content of this BIFF record.
 void setAttributes(short attributes)
          set the font attributes (see individual bit setters that reference this method)
 void setBoldWeight(short bw)
          set the bold weight for this font (100-1000dec or 0x64-0x3e8).
 void setCharset(byte charset)
          set the character set
 void setColorPaletteIndex(short cpi)
          set the font's color palette index
 void setFamily(byte f)
          set the font family (TODO)
 void setFontHeight(short height)
          sets the height of the font in 1/20th point units
 void setFontName(java.lang.String fn)
          set the name of the font
 void setItalic(boolean italics)
          set the font to be italics or not
 void setMacoutline(boolean mac)
          whether to use the mac outline font style thing (mac only) - Some mac person should comment this instead of me doing it (since I have no idea)
 void setMacshadow(boolean mac)
          whether to use the mac shado font style thing (mac only) - Some mac person should comment this instead of me doing it (since I have no idea)
 void setStrikeout(boolean strike)
          set the font to be stricken out or not
 void setSuperSubScript(short sss)
          set the type of super or subscript for the font
 void setUnderline(byte u)
          set the type of underlining for the font
 java.lang.String toString()
          get a string representation of the record (for biffview/debugging)
 
Methods inherited from class org.apache.poi.hssf.record.StandardRecord
getRecordSize, serialize
 
Methods inherited from class org.apache.poi.hssf.record.Record
clone, cloneViaReserialise, serialize
 
Methods inherited from class java.lang.Object
equals, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Field Detail

sid

public static final short sid
See Also:
Constant Field Values

SS_NONE

public static final short SS_NONE
See Also:
Constant Field Values

SS_SUPER

public static final short SS_SUPER
See Also:
Constant Field Values

SS_SUB

public static final short SS_SUB
See Also:
Constant Field Values

U_NONE

public static final byte U_NONE
See Also:
Constant Field Values

U_SINGLE

public static final byte U_SINGLE
See Also:
Constant Field Values

U_DOUBLE

public static final byte U_DOUBLE
See Also:
Constant Field Values

U_SINGLE_ACCOUNTING

public static final byte U_SINGLE_ACCOUNTING
See Also:
Constant Field Values

U_DOUBLE_ACCOUNTING

public static final byte U_DOUBLE_ACCOUNTING
See Also:
Constant Field Values
Constructor Detail

FontRecord

public FontRecord()

FontRecord

public FontRecord(RecordInputStream in)
Method Detail

setFontHeight

public void setFontHeight(short height)
sets the height of the font in 1/20th point units

Parameters:
height - fontheight (in points/20)

setAttributes

public void setAttributes(short attributes)
set the font attributes (see individual bit setters that reference this method)

Parameters:
attributes - the bitmask to set

setItalic

public void setItalic(boolean italics)
set the font to be italics or not

Parameters:
italics - - whether the font is italics or not
See Also:
setAttributes(short)

setStrikeout

public void setStrikeout(boolean strike)
set the font to be stricken out or not

Parameters:
strike - - whether the font is stricken out or not
See Also:
setAttributes(short)

setMacoutline

public void setMacoutline(boolean mac)
whether to use the mac outline font style thing (mac only) - Some mac person should comment this instead of me doing it (since I have no idea)

Parameters:
mac - - whether to do that mac font outline thing or not
See Also:
setAttributes(short)

setMacshadow

public void setMacshadow(boolean mac)
whether to use the mac shado font style thing (mac only) - Some mac person should comment this instead of me doing it (since I have no idea)

Parameters:
mac - - whether to do that mac font shadow thing or not
See Also:
setAttributes(short)

setColorPaletteIndex

public void setColorPaletteIndex(short cpi)
set the font's color palette index

Parameters:
cpi - - font color index

setBoldWeight

public void setBoldWeight(short bw)
set the bold weight for this font (100-1000dec or 0x64-0x3e8). Default is 0x190 for normal and 0x2bc for bold

Parameters:
bw - - a number between 100-1000 for the fonts "boldness"

setSuperSubScript

public void setSuperSubScript(short sss)
set the type of super or subscript for the font

Parameters:
sss - super or subscript option
See Also:
SS_NONE, SS_SUPER, SS_SUB

setUnderline

public void setUnderline(byte u)
set the type of underlining for the font

Parameters:
u - super or subscript option
See Also:
U_NONE, U_SINGLE, U_DOUBLE, U_SINGLE_ACCOUNTING, U_DOUBLE_ACCOUNTING

setFamily

public void setFamily(byte f)
set the font family (TODO)

Parameters:
f - family

setCharset

public void setCharset(byte charset)
set the character set

Parameters:
charset - - character set

setFontName

public void setFontName(java.lang.String fn)
set the name of the font

Parameters:
fn - - name of the font (i.e. "Arial")

getFontHeight

public short getFontHeight()
gets the height of the font in 1/20th point units

Returns:
fontheight (in points/20)

getAttributes

public short getAttributes()
get the font attributes (see individual bit getters that reference this method)

Returns:
attribute - the bitmask

isItalic

public boolean isItalic()
get whether the font is to be italics or not

Returns:
italics - whether the font is italics or not
See Also:
getAttributes()

isStruckout

public boolean isStruckout()
get whether the font is to be stricken out or not

Returns:
strike - whether the font is stricken out or not
See Also:
getAttributes()

isMacoutlined

public boolean isMacoutlined()
whether to use the mac outline font style thing (mac only) - Some mac person should comment this instead of me doing it (since I have no idea)

Returns:
mac - whether to do that mac font outline thing or not
See Also:
getAttributes()

isMacshadowed

public boolean isMacshadowed()
whether to use the mac shado font style thing (mac only) - Some mac person should comment this instead of me doing it (since I have no idea)

Returns:
mac - whether to do that mac font shadow thing or not
See Also:
getAttributes()

getColorPaletteIndex

public short getColorPaletteIndex()
get the font's color palette index

Returns:
cpi - font color index

getBoldWeight

public short getBoldWeight()
get the bold weight for this font (100-1000dec or 0x64-0x3e8). Default is 0x190 for normal and 0x2bc for bold

Returns:
bw - a number between 100-1000 for the fonts "boldness"

getSuperSubScript

public short getSuperSubScript()
get the type of super or subscript for the font

Returns:
super or subscript option
See Also:
SS_NONE, SS_SUPER, SS_SUB

getUnderline

public byte getUnderline()
get the type of underlining for the font

Returns:
super or subscript option
See Also:
U_NONE, U_SINGLE, U_DOUBLE, U_SINGLE_ACCOUNTING, U_DOUBLE_ACCOUNTING

getFamily

public byte getFamily()
get the font family (TODO)

Returns:
family

getCharset

public byte getCharset()
get the character set

Returns:
charset - character set

getFontName

public java.lang.String getFontName()
get the name of the font

Returns:
fn - name of the font (i.e. "Arial")

toString

public java.lang.String toString()
Description copied from class: Record
get a string representation of the record (for biffview/debugging)

Overrides:
toString in class Record

serialize

public void serialize(LittleEndianOutput out)
Description copied from class: StandardRecord
Write the data content of this BIFF record. The 'ushort sid' and 'ushort size' header fields have already been written by the superclass.
The number of bytes written must equal the record size reported by RecordBase.getRecordSize()} minus four ( record header consiting of a 'ushort sid' and 'ushort reclength' has already been written by thye superclass).

Specified by:
serialize in class StandardRecord

getDataSize

protected int getDataSize()
Specified by:
getDataSize in class StandardRecord

getSid

public short getSid()
Description copied from class: Record
return the non static version of the id for this record.

Specified by:
getSid in class Record

cloneStyleFrom

public void cloneStyleFrom(FontRecord source)
Clones all the font style information from another FontRecord, onto this one. This will then hold all the same font style options.


hashCode

public int hashCode()
Overrides:
hashCode in class java.lang.Object

sameProperties

public boolean sameProperties(FontRecord other)
Does this FontRecord have all the same font properties as the supplied FontRecord? Note that Object.equals(Object) will check for exact objects, while this will check for exact contents, because normally the font record's position makes a big difference too.



Copyright 2012 The Apache Software Foundation or its licensors, as applicable.