概述 | 软件包 | 类 | 树 | 索引 | 帮助

上一个类 下一个类 | 框架 无框架
摘要： 嵌套 | 字段 | 构造函数 | 方法 | 详细信息： 字段 | 构造函数 | 方法

## application.workbooks.workbook.worksheets.worksheet
类 Characters

    java.lang.Object
      application.workbooks.workbook.worksheets.worksheet.Characters

    public class Characters

extends java.lang.Object

该类设置了单个单元格中的字符串的字体属性。

自从：
  V1.1

方法摘要
`Cell` | `getCell()` 返回所属的单元格。
`java.lang.String` | `getText()` 获得文本内容。
`void` | `setAllcaps(boolean allCaps)` 设置字符是否为大写。
`void` | `setColor(java.awt.Color color)` 设置字体颜色。
`void` | `setColor(int r, int g, int b)` 设置字体颜色。
`void` | `setDoubleStrikeThrough(boolean doubleStrike)` 设置字体双删除线属性。
`void` | `setEmboss(boolean emboss)` 设置字体阳文属性。
`void` | `setEngrave(boolean engrave)` 设置字体阴文属性。
`void` | `setFontAttribute(FontAttribute font)` 设置字体。
`void` | `setFontBold(boolean bold)` 设置字体是否为粗体。
`void` | `setFontItalic(boolean italic)` 设置字体是否为斜体。
`void` | `setFontName(java.lang.String name)` 设置字体名。
`void` | `setFontSize(double size)` 设置字体大小。
`void` | `setOutline(boolean outline)` 设置字体空心效果。
`void` | `setShadow(boolean shadow)` 设置字体阴影属性。
`void` | `setSmallcaps(boolean smallCaps)` 设置字体小型大写字母属性。
`void` | `setStrikeThrough(boolean strikeThrough)` 设置字体删除线属性。
`void` | `setSubscript(boolean subScript)` 设置字体下标属性。
`void` | `setSuperscript(boolean superScript)` 设置字体上标属性。
`void` | `setUnderline(boolean underline)` 设置字体是否有下划线。
`void` | `setUnderline(int type, java.awt.Color color)` 设置字体下划线属性。
`void` | `setUnderlineColor(java.awt.Color color)` 设置字体下划线颜色。
`void` | `setUnderlineType(int type)` 设置字体下划线属性。

从类 java.lang.Object 继承的方法
`equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

方法详细信息

### getCell

    public Cell getCell()

  返回所属的单元格。

  例子：

       //返回字符串所属的单元格。
       Worksheet sheet = Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
       Cell cell = sheet.getCell(3,3);
       cell.setValue("abcdefg");
       Characters chars = cell.getCharacters(3, 4);
       Cell c = chars.getCell();

### getText

    public java.lang.String getText()

  获得文本内容。

  返回：
    文本内容

    例子：

         //获得字符串的文本内容。
         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         Cell cell = sheet.getCell(3,3);
         cell.setValue("abcdefg");
         Characters chars = cell.getCharacters(3, 4);
         String text = chars.getText();

### setAllcaps

    public void setAllcaps(boolean allCaps)

  设置字符是否为大写。

  参数：
    `allCaps` - 布尔型值，如为true，把文本设置为全部大写；否则，不设置大写

    例子：

         //取得单元格(3, 3)中的部分字符，并将字符设置为大写。
         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         Cell cell = sheet.getCell(3,3);
         cell.setValue("abcdefg");
         Characters chars = cell.getCharacters(3, 4);
         chars.setAllcaps(true);

### setColor

    public void setColor(java.awt.Color color)

  设置字体颜色。

  参数：
    `color` - 字体颜色

    (兼容1.31)

### setColor

    public void setColor(int r,
                         int g,
                         int b)

  设置字体颜色。

  参数：
    `r` - 红
    `g` - 绿
    `b` - 蓝

    (兼容1.31)

### setDoubleStrikeThrough

    public void setDoubleStrikeThrough(boolean doubleStrike)

  设置字体双删除线属性。

  参数：
    `doubleStrike` - 布尔型值，如为true，为文本设置双删除线；否则，不设置

    例子：

         //取得单元格(3, 3)中的部分字符，并将字体设置为双删除线。
         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         Cell cell = sheet.getCell(3,3);
         cell.setValue("abcdefg");
         Characters chars = cell.getCharacters(3, 4);
         chars.setDoubleStrikeThrough(true);

### setEmboss

    public void setEmboss(boolean emboss)

  设置字体阳文属性。

  参数：
    `emboss` - 布尔型值，如为true，为文本设置阳文效果；否则，不设置

    例子：

         //取得单元格(3, 3)中的部分字符，并设置阳文。
         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         Cell cell = sheet.getCell(3,3);
         cell.setValue("abcdefg");
         Characters chars = cell.getCharacters(3, 4);
         chars.setEmboss(true);

### setEngrave

    public void setEngrave(boolean engrave)

  设置字体阴文属性。

  参数：
    `engrave` - 布尔型值，如为true，为文本设置阴文效果；否则，不设置

    例子：

         //取得单元格(3, 3)中的部分字符，并设置阴文。
         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         Cell cell = sheet.getCell(3,3);
         cell.setValue("abcdefg");
         Characters chars = cell.getCharacters(3, 4);
         chars.setEngrave(true);

### setFontAttribute

    public void setFontAttribute(FontAttribute font)

  设置字体。

  参数：
    `font` - 字体属性

    例子：

         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         Cell cell = sheet.getCell(3,3);
         cell.setValue("abcdefg");
         Characters chars = cell.getCharacters(3, 4);
         FontAttribute font = new FontAttribute();
         font.setForeground(255,0,0);
         chars.setFontAttribute(font);

### setFontBold

    public void setFontBold(boolean bold)

  设置字体是否为粗体。

  参数：
    `bold` - 布尔型值，如为true，设置文本为粗体；否则，不设置为粗体

    例子：

         //取得单元格(3, 3)中部分的字符，并将字体设置为粗体。
         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         Cell cell = sheet.getCell(3,3);
         cell.setValue("abcdefg");
         Characters chars = cell.getCharacters(3, 4);
         chars.setFontBold(true);

### setFontItalic

    public void setFontItalic(boolean italic)

  设置字体是否为斜体。

  参数：
    `italic` - 布尔型值，如为true，设置文本为为斜体；否则，不设置为斜体

    例子：

         //取得单元格(3, 3)中的部分字符，并将字体设置为斜体。
         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         Cell cell = sheet.getCell(3,3);
         cell.setValue("abcdefg");
         Characters chars = cell.getCharacters(3, 4);
         chars.setFontItalic(true);

### setFontName

    public void setFontName(java.lang.String name)

  设置字体名。

  参数：
    `name` - 字体名，为字符串型

    例子：

         //取得单元格(3, 3)中的字部分符,并设置为宋体。
         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         Cell cell = sheet.getCell(3,3);
         cell.setValue("abcdefg");
         Characters chars = cell.getCharacters(3, 4);
         chars.setFontName("宋体");

### setFontSize

    public void setFontSize(double size)

  设置字体大小。

  参数：
    `size` - 字体大小，为整型数值

    例子：

         //取得单元格(3, 3)中的部分字符，并将字体大小设置为12。
         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         Cell cell = sheet.getCell(3,3);
         cell.setValue("abcdefg");
         Characters chars = cell.getCharacters(3, 4);
         chars.setFontSize(12);

### setOutline

    public void setOutline(boolean outline)

  设置字体空心效果。

  参数：
    `outline` - 布尔型值，如为true，为文本设置空心效果；否则，不设置

    例子：

         //取得单元格(3, 3)中的部分字符，并设置空心效果。
         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         Cell cell = sheet.getCell(3,3);
         cell.setValue("abcdefg");
         Characters chars = cell.getCharacters(3, 4);
         chars.setOutline(true);

### setShadow

    public void setShadow(boolean shadow)

  设置字体阴影属性。

  参数：
    `shadow` - 布尔型值，如为true，为文本设置阴影效果；否则，不设置

    例子：

         //取得单元格(3, 3)中的部分字符，并将设置阴影。
         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         Cell cell = sheet.getCell(3,3);
         cell.setValue("abcdefg");
         Characters chars = cell.getCharacters(3, 4);
         chars.setShadow(true);

### setSmallcaps

    public void setSmallcaps(boolean smallCaps)

  设置字体小型大写字母属性。

  参数：
    `smallCaps` - 布尔型值，如为true，把文本设置为小型大写字母；否则，不设置

    例子：

         //取得单元格(3, 3)中的部分字符，并设置为小型大写。
         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         Cell cell = sheet.getCell(3,3);
         cell.setValue("abcdefg");
         Characters chars = cell.getCharacters(3, 4);
         chars.setSmallcaps(true);

### setStrikeThrough

    public void setStrikeThrough(boolean strikeThrough)

  设置字体删除线属性。

  参数：
    `strikeThrough` - 布尔型值，如为true，给文本设置删除线效果；否则，不设置

    例子：

         //取得单元格(3, 3)中的部分字符，并设置字体删除线。
         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         Cell cell = sheet.getCell(3,3);
         cell.setValue("abcdefg");
         Characters chars = cell.getCharacters(3, 4);
         chars.setStrikeThrough(true);

### setSubscript

    public void setSubscript(boolean subScript)

  设置字体下标属性。

  参数：
    `subScript` - 布尔型值，如为true，为文本设置下标；否则，不设置

    例子：

         //取得单元格(3, 3)中的部分字符，并设置字体下标。
         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         Cell cell = sheet.getCell(3,3);
         cell.setValue("abcdefg");
         Characters chars = cell.getCharacters(3, 4);
         chars.setSubscript(true);

### setSuperscript

    public void setSuperscript(boolean superScript)

  设置字体上标属性。

  参数：
    `superScript` - 布尔型值，如为true，为文本设置上标；否则，不设置

    例子：

         //取得单元格(3, 3)中的部分字符，并设置字体上标。
         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         Cell cell = sheet.getCell(3,3);
         cell.setValue("abcdefg");
         Characters chars = cell.getCharacters(3, 4);
         chars.setSuperscript(true);

### setUnderline

    public void setUnderline(boolean underline)

  设置字体是否有下划线。

  参数：
    `underline` - 布尔型值，如为true，为文本设置下划线；否则，不设置下划线

    例子：

         //取得单元格(3, 3)中的部分字符，并设置字体下划线。
         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         Cell cell = sheet.getCell(3,3);
         cell.setValue("abcdefg");
         Characters chars = cell.getCharacters(3, 4);
         chars.setUnderline(true);

### setUnderline

    public void setUnderline(int type,
                             java.awt.Color color)

  设置字体下划线属性。

  参数：
    `type` - 下划线类型
    `color` - 下划线颜色

    例子：

         //取得单元格(3, 3)中的部分字符，并设置字体下划线的类型和颜色。
         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         Cell cell = sheet.getCell(3,3);
         cell.setValue("abcdefg");
         Characters chars = cell.getCharacters(3, 4);
         chars.setUnderline(1，Color.blue);

### setUnderlineColor

    public void setUnderlineColor(java.awt.Color color)

  设置字体下划线颜色。

  参数：
    `color` - 下划线颜色

    例子：

         //取得单元格(3, 3)中的部分字符，并设置字体下划线的颜色为红色。
         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         Cell cell = sheet.getCell(3,3);
         cell.setValue("abcdefg");
         Characters chars = cell.getCharacters(3, 4);
         chars.setUnderlineColor(Color.red);

### setUnderlineType

    public void setUnderlineType(int type)

  设置字体下划线属性。

  参数：
    `type` - 下划线类型

             UNDERLINE_NONE -- 无
             UNDERLINE_SINGLE -- 下划线
             UNDERLINE_DOUBLE -- 双线
             UNDERLINE_BOLD -- 粗线
             UNDERLINE_DOTTED -- 点线
             UNDERLINE_WEAK_LING -- 虚下划线
             UNDERLINE_DASHDOTTED -- 点划线
             UNDERLINE_DOT_DASHDOTTED -- 点点划线
             UNDERLINE_WAVE -- 波浪线

    例子：

         //取得单元格(3, 3)中的部分字符，并设置字体下划线。
         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         Cell cell = sheet.getCell(3,3);
         cell.setValue("abcdefg");
         Characters chars = cell.getCharacters(3, 4);
         chars.setUnderlineType(1);

  另请参见：
    `FontStyleEffectConstants`

概述 | 软件包 | 类 | 树 | 索引 | 帮助

上一个类 下一个类 | 框架 无框架
摘要： 嵌套 | 字段 | 构造函数 | 方法 | 详细信息： 字段 | 构造函数 | 方法

版权所有 2001-2008 无锡永中科技有限公司