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

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

## application.workbooks.workbook.tables
类 CellAttribute

    java.lang.Object
      application.workbooks.workbook.tables.CellAttribute

    public class CellAttribute

extends java.lang.Object

代表表格属性对话框内的单元格属性集。可以从单个单元格或多个连续单元格区域中得到此属性集。

方法摘要
`float` | `getBottomMargin()` 得到当前单元格下边距。
`float` | `getLeftMargin()` 得到当前单元格左边距。
`float` | `getPreferredWidth()` 得到指定单元格的宽度。
`int` | `getPreferredWidthMeasure()` 得到指定单元格宽度的度量方式。
`float` | `getRightMargin()` 得到当前单元格右边距。
`float` | `getTopMargin()` 得到当前单元格上边距。
`int` | `getVerticalAlignment()` 获得单元格的垂直对齐方式。
`boolean` | `isCellMarginSameAsTable()` 判断当前单元格边距是否取自整张表格的默认单元格边距。
`boolean` | `isFitText()` 判断当前单元格是否可以自动适应文字。
`boolean` | `isWordWrap()` 判断当前单元格是否可以自动换行。
`void` | `setBottomMargin(float margin)` 设置当前单元格下边距。
`void` | `setCellMarginSameAsTable(boolean sameAsTable)` 设置当前单元格边距是否取自整张表格的默认单元格边距。
`void` | `setFitText(boolean fitText)` 设置当前单元格是否可以自动适应文字。
`void` | `setLeftMargin(float margin)` 设置当前单元格左边距。
`void` | `setPreferredWidth(float width)` 设置指定单元格的宽度。
`void` | `setPreferredWidthMeasure(int widthType)` 设置指定单元格宽度的度量方式。
`void` | `setRightMargin(float margin)` 设置当前单元格右边距。
`void` | `setTopMargin(float margin)` 设置当前单元格上边距。
`void` | `setVerticalAlignment(int tableAlign)` 设置单元格的垂直对齐方式。
`void` | `setWordWrap(boolean autoWrap)` 设置当前单元格是否可以自动换行。

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

方法详细信息

### getBottomMargin

    public float getBottomMargin()

  得到当前单元格下边距。说明：边距的范围为0~1584磅。

  返回：
    单元格下边距（单位为磅值）

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         application.workbooks.workbook.tables.Cell cell = table.getCell(2,3);
         application.workbooks.workbook.tables.CellAttribute cellAttribute = cell.getCellAttribute();
         System.out.println("单元格下边距为：" + cellAttribute.getBottomMargin());

  另请参见：
    `setBottomMargin(float)`

### getLeftMargin

    public float getLeftMargin()

  得到当前单元格左边距。说明：边距的范围为0~1584磅。

  返回：
    单元格左边距（单位为磅值）

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         application.workbooks.workbook.tables.Cell cell = table.getCell(2,3);
         application.workbooks.workbook.tables.CellAttribute cellAttribute = cell.getCellAttribute();
         System.out.println("单元格左边距为：" + cellAttribute.getLeftMargin());

  另请参见：
    `setLeftMargin(float)`

### getPreferredWidth

    public float getPreferredWidth()

  得到指定单元格的宽度。

  返回：
    返回单元格的宽度 说明：单元格宽度的度量类型不同，单元格宽度值的语义也不一样。如果，度量类型为固定值，则返回单元格宽度为磅值，范围在0~1584磅； 如果度量类型为百分比，则返回单元格宽度是一个相对值，范围在0~100%。

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         application.workbooks.workbook.tables.Cell cell = table.getCell(2,3);
         application.workbooks.workbook.tables.CellAttribute cellAttribute = cell.getCellAttribute();
         System.out.println("返回指定单元格的宽度为：" + cellAttribute.getPreferredWidth());

  另请参见：
    `setPreferredWidth(float)`, `getPreferredWidthMeasure()`

### getPreferredWidthMeasure

    public int getPreferredWidthMeasure()

  得到指定单元格宽度的度量方式。

  返回：
    单元格宽度的度量方式，只能取一下值之一：

         TableConstants.CELL_WIDTH_NONE_SET  不指定单元格宽度
         TableConstants.CELL_WIDTH_MEASURE   指定宽度为绝对值
         TableConstants.CELL_WIDTH_PRECENT   指定宽度为百分比

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         application.workbooks.workbook.tables.Cell cell = table.getCell(2,3);
         application.workbooks.workbook.tables.CellAttribute cellAttribute = cell.getCellAttribute();
         System.out.println("返回指定单元格宽度的度量方式为：" + cellAttribute.getPreferredWidthMeasure());

  另请参见：
    `getPreferredWidth()`, `setPreferredWidthMeasure(int)`, `TableConstants`

### getRightMargin

    public float getRightMargin()

  得到当前单元格右边距。说明：边距的范围为0~1584磅。

  返回：
    单元格右边距（单位为磅值）

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         application.workbooks.workbook.tables.Cell cell = table.getCell(2,3);
         application.workbooks.workbook.tables.CellAttribute cellAttribute = cell.getCellAttribute();
         System.out.println("单元格右边距为：" + cellAttribute.getRightMargin());

  另请参见：
    `setRightMargin(float)`

### getTopMargin

    public float getTopMargin()

  得到当前单元格上边距。说明：边距的范围为0~1584磅。

  返回：
    单元格上边距（单位为磅值）

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         application.workbooks.workbook.tables.Cell cell = table.getCell(2,3);
         application.workbooks.workbook.tables.CellAttribute cellAttribute = cell.getCellAttribute();
         System.out.println("单元格上边距为：" + cellAttribute.getTopMargin());

  另请参见：
    `setTopMargin(float)`

### getVerticalAlignment

    public int getVerticalAlignment()

  获得单元格的垂直对齐方式。

  返回：
    单元格的垂直对齐方式，只能取以下整形值之一：

         TableConstants.V_TOP = 0      顶端对齐
         TableConstants.V_CENTER = 1   居中对齐
         TableConstants.V_BOTTOM = 2   底端对齐

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         application.workbooks.workbook.tables.Cell cell = table.getCell(2,3);
         application.workbooks.workbook.tables.CellAttribute cellAttribute = cell.getCellAttribute();
         System.out.println("单元格的竖直排列方式为：" + cellAttribute.getVerticalAlignment());

  另请参见：
    `setVerticalAlignment(int)`, `TableConstants`

### isCellMarginSameAsTable

    public boolean isCellMarginSameAsTable()

  判断当前单元格边距是否取自整张表格的默认单元格边距。

  返回：
    布尔值型，单元格各边距是否与整张表格的默认单元格各边距相同。 如果为true，则取自默认边距，否则，取自实际边距

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         application.workbooks.workbook.tables.Cell cell = table.getCell(2,3);
         application.workbooks.workbook.tables.CellAttribute cellAttribute = cell.getCellAttribute();
         System.out.println("判断当前单元格边距是否取自整张表格的默认单元格边距：" + cellAttribute.isCellMarginSameAsTable());

  另请参见：
    `setCellMarginSameAsTable(boolean)`

### isFitText

    public boolean isFitText()

  判断当前单元格是否可以自动适应文字。

  返回：
    如果为true，则可以自动适应文字

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         application.workbooks.workbook.tables.Cell cell = table.getCell(2,3);
         application.workbooks.workbook.tables.CellAttribute cellAttribute = cell.getCellAttribute();
         System.out.println("表格单元格是否自动换行：" + cellAttribute.isFitText());

  另请参见：
    `setFitText(boolean)`

### isWordWrap

    public boolean isWordWrap()

  判断当前单元格是否可以自动换行。

  返回：
    如果为true，则可以自动换行

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         application.workbooks.workbook.tables.Cell cell = table.getCell(2,3);
         application.workbooks.workbook.tables.CellAttribute cellAttribute = cell.getCellAttribute();
         System.out.println("表格单元格是否自动换行：" + cellAttribute.isWordWrap());

  另请参见：
    `setWordWrap(boolean)`

### setBottomMargin

    public void setBottomMargin(float margin)

  设置当前单元格下边距。说明：边距的范围为0~1584磅。

  参数：
    `margin` - 单元格下边距（单位为磅值）

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         application.workbooks.workbook.tables.Cell cell = table.getCell(2,3);
         application.workbooks.workbook.tables.CellAttribute cellAttribute = cell.getCellAttribute();
         cellAttribute.setCellMarginSameAsTable(false);
         cellAttribute.setBottomMargin(30.0f);
         cell.setCellAttribute(cellAttribute);

### setCellMarginSameAsTable

    public void setCellMarginSameAsTable(boolean sameAsTable)

  设置当前单元格边距是否取自整张表格的默认单元格边距。

  参数：
    `sameAsTable` - 布尔值型，单元格各边距是否与整张表格的默认单元格各边距相同。 如果为true，则取自默认边距，否则，取自实际边距

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         application.workbooks.workbook.tables.Cell cell = table.getCell(2,3);
         application.workbooks.workbook.tables.CellAttribute cellAttribute = cell.getCellAttribute();
         cellAttribute.setCellMarginSameAsTable(true);
         cell.setCellAttribute(cellAttribute);

  另请参见：
    `isCellMarginSameAsTable()`

### setFitText

    public void setFitText(boolean fitText)

  设置当前单元格是否可以自动适应文字。

  参数：
    `autoWrap` - 如果为true，则可以自动适应文字

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         application.workbooks.workbook.tables.Cell cell = table.getCell(2,3);
         application.workbooks.workbook.tables.CellAttribute cellAttribute = cell.getCellAttribute();
         cellAttribute.setFitText(false);
         cell.setCellAttribute(cellAttribute);

  另请参见：
    `isFitText()`

### setLeftMargin

    public void setLeftMargin(float margin)

  设置当前单元格左边距。说明：边距的范围为0~1584磅。

  参数：
    `margin` - 单元格左边距（单位为磅值）

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         application.workbooks.workbook.tables.Cell cell = table.getCell(2,3);
         application.workbooks.workbook.tables.CellAttribute cellAttribute = cell.getCellAttribute();
         cellAttribute.setCellMarginSameAsTable(false);
         cellAttribute.setLeftMargin(30.0f);
         cell.setCellAttribute(cellAttribute);

  抛出：
    `MacroRunException` - 当指定边距超出范围0~1584磅

### setPreferredWidth

    public void setPreferredWidth(float width)

  设置指定单元格的宽度。

  参数：
    `width` - 指定单元格的宽度 说明：单元格宽度的度量类型不同，单元格宽度值的语义也不一样。如果，度量类型为固定值，则返回单元格宽度为磅值，范围在0~1584磅； 如果度量类型为百分比，则返回单元格宽度是一个相对值，范围在0~100%。

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         application.workbooks.workbook.tables.Cell cell = table.getCell(2,3);
         application.workbooks.workbook.tables.CellAttribute cellAttribute = cell.getCellAttribute();
         cellAttribute.setPreferredWidthMeasure(TableConstants.CELL_WIDTH_MEASURE);
         cellAttribute.setPreferredWidth(40.0f);
         cell.setCellAttribute(cellAttribute);

  抛出：
    `MacroRunException` - 当不指定单元格的度量宽度时
    `MacroRunException` - 当单元格宽度值超出范围
  另请参见：
    `getPreferredWidth()`, `setPreferredWidthMeasure(int)`

### setPreferredWidthMeasure

    public void setPreferredWidthMeasure(int widthType)

  设置指定单元格宽度的度量方式。

  参数：
    `widthType` - 单元格宽度的度量方式，只能取以下值之一：

         TableConstants.CELL_WIDTH_NONE_SET  不指定单元格宽度
         TableConstants.CELL_WIDTH_MEASURE   指定宽度为绝对值
         TableConstants.CELL_WIDTH_PRECENT   指定宽度为百分比

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         application.workbooks.workbook.tables.Cell cell = table.getCell(2,3);
         application.workbooks.workbook.tables.CellAttribute cellAttribute = cell.getCellAttribute();
         cellAttribute.setPreferredWidthMeasure(TableConstants.CELL_WIDTH_PRECENT);
         cellAttribute.setPreferredWidth(40.0f);
         cell.setCellAttribute(cellAttribute);

  抛出：
    `MacroRunException` - 当指定单元格宽度的度量方式常量不存在
  另请参见：
    `getPreferredWidthMeasure()`, `setPreferredWidth(float)`, `TableConstants`

### setRightMargin

    public void setRightMargin(float margin)

  设置当前单元格右边距。说明：边距的范围为0~1584磅。

  参数：
    `margin` - 单元格右边距（单位为磅值）

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         application.workbooks.workbook.tables.Cell cell = table.getCell(2,3);
         application.workbooks.workbook.tables.CellAttribute cellAttribute = cell.getCellAttribute();
         cellAttribute.setCellMarginSameAsTable(false);
         cellAttribute.setRightMargin(30.0f);
         cell.setCellAttribute(cellAttribute);

  抛出：
    `MacroRunException` - 当指定边距超出范围0~1584磅

### setTopMargin

    public void setTopMargin(float margin)

  设置当前单元格上边距。说明：边距的范围为0~1584磅。

  参数：
    `margin` - 单元格上边距（单位为磅值）

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         application.workbooks.workbook.tables.Cell cell = table.getCell(2,3);
         application.workbooks.workbook.tables.CellAttribute cellAttribute = cell.getCellAttribute();
         cellAttribute.setCellMarginSameAsTable(false);
         cellAttribute.setTopMargin(30.0f);
         cell.setCellAttribute(cellAttribute);

  抛出：
    `MacroRunException` - 当指定边距超出范围0~1584磅

### setVerticalAlignment

    public void setVerticalAlignment(int tableAlign)

  设置单元格的垂直对齐方式。

  参数：
    `tableAlign` - 单元格的垂直对齐方式，只能取以下整形值之一：

         TableConstants.V_TOP = 0      顶端对齐
         TableConstants.V_CENTER = 1   居中对齐
         TableConstants.V_BOTTOM = 2   底端对齐

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         application.workbooks.workbook.tables.Cell cell = table.getCell(2,3);
         application.workbooks.workbook.tables.CellAttribute cellAttribute = cell.getCellAttribute();
         cellAttribute.setVerticalAlignment(TableConstants.V_CENTER);
         cell.setCellAttribute(cellAttribute);

  抛出：
    `MacroRunException` - 当指定单元格垂直对齐方式常量不存在
  另请参见：
    `getVerticalAlignment()`, `TableConstants`

### setWordWrap

    public void setWordWrap(boolean autoWrap)

  设置当前单元格是否可以自动换行。

  参数：
    `autoWrap` - 如果为true，则可以自动换行

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         application.workbooks.workbook.tables.Cell cell = table.getCell(2,3);
         application.workbooks.workbook.tables.CellAttribute cellAttribute = cell.getCellAttribute();
         cellAttribute.setWordWrap(false);
         cell.setCellAttribute(cellAttribute);

  另请参见：
    `isWordWrap()`

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

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

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