IFont

Interface IFont

public interface IFont

表示区域、样式或文本片段的字体格式。

使用此接口可以获取或设置字体名称、字号、加粗、斜体、下划线、删除线、字体颜色、主题颜色、主题字体以及上下标等文本格式。


 IRange cell = worksheet.getRange("A1");
 cell.setValue("Title");
 
 IFont font = cell.getFont();
 font.setName("Arial");
 font.setSize(14);
 font.setBold(true);
 font.setColor(Color.GetRed());

Method Summary

Modifier and Type

Method

Description

boolean

getBold()

获取字体是否加粗。

Color

getColor()

获取字体颜色。

int

getColorIndex()

获取字体颜色索引。

boolean

getItalic()

获取字体样式是否为斜体。

String

getName()

获取字体名称。

double

getSize()

获取字体大小，单位为磅。

boolean

getStrikethrough()

获取字体是否应用删除线格式。

boolean

getSubscript()

获取字体是否应用下标格式。

boolean

getSuperscript()

获取字体是否应用上标格式。

ThemeColor

getThemeColor()

获取字体颜色使用的主题颜色。

ThemeFont

getThemeFont()

获取字体使用的主题字体。

double

getTintAndShade()

获取应用于字体颜色的色调/阴影调整值。

UnderlineType

getUnderline()

获取字体的下划线类型。

void

setBold(boolean value)

设置字体是否加粗。

void

setColor(Color value)

设置字体颜色。

void

setColorIndex(int value)

设置字体颜色索引。

void

setItalic(boolean value)

设置字体样式是否为斜体。

void

setName(String value)

设置字体名称。

void

setSize(double value)

设置字体大小，单位为磅。

void

setStrikethrough(boolean value)

设置字体是否应用删除线格式。

void

setSubscript(boolean value)

设置字体是否应用下标格式。

void

setSuperscript(boolean value)

设置字体是否应用上标格式。

void

setThemeColor(ThemeColor value)

设置字体颜色使用的主题颜色。

void

setThemeFont(ThemeFont value)

设置字体使用的主题字体。

void

setTintAndShade(double value)

设置应用于字体颜色的色调/阴影调整值。

void

setUnderline(UnderlineType value)

设置字体的下划线类型。

Method Details
- getBold
  
  boolean getBold()
  获取字体是否加粗。
  此属性指示是否对所表示的文本应用加粗格式。使用 setBold(boolean) 可以更改加粗状态。
  
  IRange cell = worksheet.getRange("A1"); cell.setValue("Title"); cell.getFont().setBold(true); boolean bold = cell.getFont().getBold();
  Returns:
  
  如果字体加粗，则为 true；否则为 false。
- setBold
  
  void setBold(boolean value)
  设置字体是否加粗。
  IRange cell = worksheet.getRange("A1"); cell.setValue("Title"); cell.getFont().setBold(true);
  Parameters:
  
  value - 如果字体加粗，则为 true；否则为 false。
- getColor
  
  Color getColor()
  获取字体颜色。
  IRange cell = worksheet.getRange("A1"); cell.setValue("Title"); IFont font = cell.getFont(); font.setColor(Color.GetRed()); Color color = font.getColor();
  Returns:
  
  字体颜色。
- setColor
  
  void setColor(Color value)
  设置字体颜色。
  IRange cell = worksheet.getRange("A1"); cell.setValue("Title"); IFont font = cell.getFont(); font.setColor(Color.GetRed());
  Parameters:
  
  value - 字体颜色。
- getColorIndex
  
  int getColorIndex()
  获取字体颜色索引。
  该值可以是调色板颜色索引，也可以是 ColorDataIndex.Automatic 等特殊颜色索引值。
  
  IFont font = worksheet.getRange("A1").getFont(); // Use a special color index value. font.setColorIndex(ColorDataIndex.Automatic.getValue()); ColorDataIndex colorIndex = ColorDataIndex.forValue(font.getColorIndex());
  Returns:
  
  字体颜色索引。
- setColorIndex
  
  void setColorIndex(int value)
  设置字体颜色索引。
  该值可以是调色板颜色索引，也可以是 ColorDataIndex.Automatic 等特殊颜色索引值。
  
  IFont font = worksheet.getRange("A1").getFont(); // Use a special color index value. font.setColorIndex(ColorDataIndex.Automatic.getValue());
  Parameters:
  
  value - 字体颜色索引。
- getItalic
  
  boolean getItalic()
  获取字体样式是否为斜体。
  此属性指示是否对所表示的文本应用斜体格式。使用 setItalic(boolean) 可以更改斜体状态。
  
  IRange cell = worksheet.getRange("A1"); cell.setValue("Title"); cell.getFont().setItalic(true); boolean italic = cell.getFont().getItalic();
  Returns:
  
  如果字体样式为斜体，则为 true；否则为 false。
- setItalic
  
  void setItalic(boolean value)
  设置字体样式是否为斜体。
  IRange cell = worksheet.getRange("A1"); cell.setValue("Title"); cell.getFont().setItalic(true);
  Parameters:
  
  value - 如果字体样式为斜体，则为 true；否则为 false。
- getName
  
  String getName()
  获取字体名称。
  IRange cell = worksheet.getRange("A1"); cell.setValue("Title"); cell.getFont().setName("Arial"); String fontName = cell.getFont().getName();
  Returns:
  
  字体名称。
- setName
  
  void setName(String value)
  设置字体名称。
  IRange cell = worksheet.getRange("A1"); cell.setValue("Title"); cell.getFont().setName("Arial");
  Parameters:
  
  value - 字体名称。
- getSize
  
  double getSize()
  获取字体大小，单位为磅。
  IFont font = worksheet.getRange("A1").getFont(); font.setSize(14); double size = font.getSize();
  Returns:
  
  字体大小，单位为磅。
- setSize
  
  void setSize(double value)
  设置字体大小，单位为磅。
  IFont font = worksheet.getRange("A1").getFont(); font.setSize(14);
  Parameters:
  
  value - 字体大小，单位为磅。
- getStrikethrough
  
  boolean getStrikethrough()
  获取字体是否应用删除线格式。
  IFont font = worksheet.getRange("A1").getFont(); font.setStrikethrough(true); boolean strikethrough = font.getStrikethrough();
  Returns:
  
  如果字体应用删除线格式，则为 true；否则为 false。
- setStrikethrough
  
  void setStrikethrough(boolean value)
  设置字体是否应用删除线格式。
  IFont font = worksheet.getRange("A1").getFont(); font.setStrikethrough(true);
  Parameters:
  
  value - true 表示对字体应用删除线格式；否则为 false。
- getSubscript
  
  boolean getSubscript()
  获取字体是否应用下标格式。
  通过 IRange.getFont() 设置字体时，会影响整个区域中的文本。如需仅格式化部分字符，请调用 IRange.characters(int, int) 获取 ITextRun 对象，然后调用 ITextRun.getFont()。
  
  IRange cell = worksheet.getRange("A1"); cell.setValue("H2O"); // Apply subscript only to "2". IFont font = cell.characters(1, 1).getFont(); font.setSubscript(true); boolean subscript = font.getSubscript();
  Returns:
  
  如果字体应用下标格式，则为 true；否则为 false。
- setSubscript
  
  void setSubscript(boolean value)
  设置字体是否应用下标格式。
  通过 IRange.getFont() 设置字体时，会影响整个区域中的文本。如需仅格式化部分字符，请调用 IRange.characters(int, int) 获取 ITextRun 对象，然后调用 ITextRun.getFont()。
  
  IRange cell = worksheet.getRange("A1"); cell.setValue("H2O"); // Apply subscript only to "2". IFont font = cell.characters(1, 1).getFont(); font.setSubscript(true);
  Parameters:
  
  value - true 表示对字体应用下标格式；否则为 false。
- getSuperscript
  
  boolean getSuperscript()
  获取字体是否应用上标格式。
  通过 IRange.getFont() 设置字体时，会影响整个区域中的文本。如需仅格式化部分字符，请调用 IRange.characters(int, int) 获取 ITextRun 对象，然后调用 ITextRun.getFont()。
  
  IRange cell = worksheet.getRange("A1"); cell.setValue("E=mc2"); // Apply superscript only to "2". IFont font = cell.characters(5, 1).getFont(); font.setSuperscript(true); boolean superscript = font.getSuperscript();
  Returns:
  
  如果字体应用上标格式，则为 true；否则为 false。
- setSuperscript
  
  void setSuperscript(boolean value)
  设置字体是否应用上标格式。
  通过 IRange.getFont() 设置字体时，会影响整个区域中的文本。如需仅格式化部分字符，请调用 IRange.characters(int, int) 获取 ITextRun 对象，然后调用 ITextRun.getFont()。
  
  IRange cell = worksheet.getRange("A1"); cell.setValue("E=mc2"); // Apply superscript only to "2". IFont font = cell.characters(5, 1).getFont(); font.setSuperscript(true);
  Parameters:
  
  value - true 表示对字体应用上标格式；否则为 false。
- getThemeColor
  
  ThemeColor getThemeColor()
  获取字体颜色使用的主题颜色。
  IFont font = worksheet.getRange("A1").getFont(); font.setThemeColor(ThemeColor.Accent1); ThemeColor themeColor = font.getThemeColor();
  Returns:
  
  字体颜色使用的主题颜色。
- setThemeColor
  
  void setThemeColor(ThemeColor value)
  设置字体颜色使用的主题颜色。
  IFont font = worksheet.getRange("A1").getFont(); font.setThemeColor(ThemeColor.Accent1);
  Parameters:
  
  value - 字体颜色使用的主题颜色。
- getTintAndShade
  
  double getTintAndShade()
  获取应用于字体颜色的色调/阴影调整值。
  取值范围必须为 -1.0 到 1.0，0 表示不调整。
  
  IFont font = worksheet.getRange("A1").getFont(); font.setThemeColor(ThemeColor.Accent1); font.setTintAndShade(0.5); double tintAndShade = font.getTintAndShade();
  Returns:
  
  应用于字体颜色的色调/阴影调整值。
- setTintAndShade
  
  void setTintAndShade(double value)
  设置应用于字体颜色的色调/阴影调整值。
  取值范围必须为 -1.0 到 1.0，0 表示不调整；否则会抛出 IllegalArgumentException。
  
  IFont font = worksheet.getRange("A1").getFont(); font.setThemeColor(ThemeColor.Accent1); font.setTintAndShade(0.5);
  Parameters:
  
  value - 应用于字体颜色的色调/阴影调整值。
  
  Throws:
  
  IllegalArgumentException - 如果 value 小于 -1.0 或大于 1.0。
- getUnderline
  
  UnderlineType getUnderline()
  获取字体的下划线类型。
  IFont font = worksheet.getRange("A1").getFont(); font.setUnderline(UnderlineType.Single); UnderlineType underline = font.getUnderline();
  Returns:
  
  字体的下划线类型。
- setUnderline
  
  void setUnderline(UnderlineType value)
  设置字体的下划线类型。
  IFont font = worksheet.getRange("A1").getFont(); font.setUnderline(UnderlineType.Single);
  Parameters:
  
  value - 字体的下划线类型。
- getThemeFont
  
  ThemeFont getThemeFont()
  获取字体使用的主题字体。
  使用 ThemeFont.Major 或 ThemeFont.Minor 可跟随工作簿主题字体方案；使用 ThemeFont.None 表示不使用主题字体。
  
  IFont font = worksheet.getRange("A1").getFont(); font.setThemeFont(ThemeFont.Major); ThemeFont themeFont = font.getThemeFont();
  Returns:
  
  字体使用的主题字体。
- setThemeFont
  
  void setThemeFont(ThemeFont value)
  设置字体使用的主题字体。
  使用 ThemeFont.Major 或 ThemeFont.Minor 可跟随工作簿主题字体方案；使用 ThemeFont.None 表示不使用主题字体。
  
  IFont font = worksheet.getRange("A1").getFont(); font.setThemeFont(ThemeFont.Major);
  Parameters:
  
  value - 字体使用的主题字体。

IFont

Interface IFont

Method Summary

Method Details

getBold

setBold

getColor

setColor

getColorIndex

setColorIndex

getItalic

setItalic

getName

setName

getSize

setSize

getStrikethrough

setStrikethrough

getSubscript

setSubscript

getSuperscript

setSuperscript

getThemeColor

setThemeColor

getTintAndShade

setTintAndShade

getUnderline

setUnderline

getThemeFont

setThemeFont