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

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

## application.workbooks.workbook.tables
类 TableAttribute

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

    public class TableAttribute

extends java.lang.Object

代表表格对象的表格属性集。说明：这个属性集管理着表格属性对话框内表格分页栏下的所有属性。

方法摘要
`float` | `getAdjustableSpacing()` 得到表格的默认单元格间距。
`int` | `getAlignment()` 获得表格的对齐方式。
`float` | `getBottomDistance()` 得到正文文本与表格之间的下边距。
`float` | `getDefaultCellBottomMargin()` 得到表格默认的单元格下边距。
`float` | `getDefaultCellLeftMargin()` 得到表格默认的单元格左边距。
`float` | `getDefaultCellRightMargin()` 得到表格默认的单元格右边距。
`float` | `getDefaultCellTopMargin()` 得到表格默认的单元格上边距。
`int` | `getHorizontalPosition()` 得到表格定位的水平位置。
`int` | `getHorizontalRelative()` 得到表格水平定位的相对于参数。
`float` | `getLeftDistance()` 得到正文文本与表格之间的左边距。
`float` | `getLeftIndent()` 获得表格的左缩进距离，当其小于零时为突出多少距离。
`float` | `getPreferredWidth()` 得到指定表格的宽度。
`int` | `getPreferredWidthMeasure()` 得到指定表格宽度的度量方式。
`float` | `getRightDistance()` 得到正文文本与表格之间的右边距。
`float` | `getTopDistance()` 得到正文文本与表格之间的上边距。
`int` | `getVerticalPosition()` 得到表格定位的垂直位置。
`int` | `getVerticalRelative()` 得到表格垂直定位的相对于参数。
`boolean` | `isAllowAdjustSpacing()` 判断是否允许调整表格默认的单元格间距。
`boolean` | `isAllowAutoFit()` 判断是否允许表格的列宽重调整尺寸以适应内容。
`boolean` | `isAllowOverlap()` 返回当前表格是否允许被其他表格叠加。
`boolean` | `isWrapAroundText()` 返回表格的环绕方式。
`void` | `setAdjustableSpacing(float spacing)` 设置表格的默认单元格间距。
`void` | `setAlignment(int tableAlign)` 设置表格的对齐方式。
`void` | `setAllowAutoFit(boolean autofit)` 设置允许表格的列宽重调整尺寸以适应内容。
`void` | `setAllowOverlap(boolean overlap)` 设置当前表格是否允许被其他表格叠加。
`void` | `setBottomDistance(float bottomDistance)` 设置正文文本与表格之间的下边距（说明：只有设置了表格的文字环绕属性后属性才能被设置）。
`void` | `setDefaultCellBottomMargin(float margin)` 设置表格默认的单元格下边距。
`void` | `setDefaultCellLeftMargin(float margin)` 设置表格默认的单元格左边距。
`void` | `setDefaultCellRightMargin(float margin)` 设置表格默认的单元格右边距。
`void` | `setDefaultCellTopMargin(float margin)` 设置表格默认的单元格上边距。
`void` | `setHorizontalPosition(int position)` 设置表格定位的水平位置。
`void` | `setHorizontalRelative(int relativePosition)` 设置表格水平定位的相对于参数。
`void` | `setLeftDistance(float leftDistance)` 设置正文文本与表格之间的左边距。
`void` | `setLeftIndent(float leftIndent)` 设置表格的左缩进距离，当其小于零时为突出多少距离。
`void` | `setPreferredWidth(float width)` 设置指定表格的宽度。
`void` | `setPreferredWidthMeasure(int widthType)` 设置指定表格宽度的度量方式。
`void` | `setRightDistance(float rightDistance)` 设置正文文本与表格之间的右边距（说明：只有设置了表格的文字环绕属性后属性才能被设置）。
`void` | `setTopDistance(float topDistance)` 设置正文文本与表格之间的上边距（说明：只有设置了表格的文字环绕属性后属性才能被设置）。
`void` | `setVerticalPosition(int position)` 设置表格定位的垂直位置。
`void` | `setVerticalRelative(int relativePosition)` 设置表格垂直定位的相对于参数。
`void` | `setWrapAroundText(boolean around)` 设置表格的环绕方式。

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

方法详细信息

### getAdjustableSpacing

    public float getAdjustableSpacing()

  得到表格的默认单元格间距。说明：当默认单元格间距不允许被调整时，返回默认值0。

  返回：
    默认单元格间距(单位取磅值)

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         TableAttribute tableAttribute = table.getTableAttribute();
         System.out.println("表格默认的单元格间距为:" + tableAttribute.getAdjustableSpacing());

  另请参见：
    `setAdjustableSpacing(float)`, `isAllowAdjustSpacing()`

### getAlignment

    public int getAlignment()

  获得表格的对齐方式。

  返回：
    表格的对齐方式，只能取以下整型值之一：

         TableConstants.TABLE_LEFT   = 0     左对齐
         TableConstants.TABLE_CENTER = 1     居中对齐
         TableConstants.TABLE_RIGHT  = 2     右对齐

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         TableAttribute tableAttribute = table.getTableAttribute();
         System.out.println("表格的对齐方式为：" + tableAttribute.getAlignment());

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

### getBottomDistance

    public float getBottomDistance()

  得到正文文本与表格之间的下边距。 说明：如果表格文字环绕方式为无，则返回默认值0。

  返回：
    float 表格距正文下的间距

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         TableAttribute tableAttribute = table.getTableAttribute();
         System.out.println("正文文本与表格之间的下边距为:"+ tableAttribute.getBottomDistance());

  另请参见：
    `setBottomDistance(float)`

### getDefaultCellBottomMargin

    public float getDefaultCellBottomMargin()

  得到表格默认的单元格下边距。说明：边距的范围为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);
         TableAttribute tableAttribute = table.getTableAttribute();
         System.out.println("表格默认的单元格下边距为：" + tableAttribute.getDefaultCellBottomMargin());

  另请参见：
    `setDefaultCellBottomMargin(float)`

### getDefaultCellLeftMargin

    public float getDefaultCellLeftMargin()

  得到表格默认的单元格左边距。说明：边距的范围为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);
         TableAttribute tableAttribute = table.getTableAttribute();
         System.out.println("表格默认的单元格左边距为：" + tableAttribute.getDefaultCellLeftMargin());

  另请参见：
    `setDefaultCellLeftMargin(float)`

### getDefaultCellRightMargin

    public float getDefaultCellRightMargin()

  得到表格默认的单元格右边距。说明：边距的范围为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);
         TableAttribute tableAttribute = table.getTableAttribute();
         System.out.println("表格默认的单元格右边距为：" + tableAttribute.getDefaultCellRightMargin());

  另请参见：
    `setDefaultCellRightMargin(float)`

### getDefaultCellTopMargin

    public float getDefaultCellTopMargin()

  得到表格默认的单元格上边距。说明：边距的范围为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);
         TableAttribute tableAttribute = table.getTableAttribute();
         System.out.println("表格默认的单元格上边距为：" + tableAttribute.getDefaultCellTopMargin());

  另请参见：
    `setDefaultCellTopMargin(float)`

### getHorizontalPosition

    public int getHorizontalPosition()

  得到表格定位的水平位置。说明：此位置是相对于文档中的边缘线（边缘线由HorizontalRelative属性定义）。 说明：如果表格文字环绕方式为无，则返回默认值1。

  返回：
    表格相对于边缘线的水平方向上的位置

         TableConstants.TABLE_GOTO_LEFT     =1    左侧
         TableConstants.TABLE_GOTO_RIGHT    =2    右侧
         TableConstants.TABLE_GOTO_CENTER   =0    居中
         TableConstants.TABLE_GOTO_INSIDE   =3    内侧
         TableConstants.TABLE_GOTO_OUTSIDE  =4    外侧

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         TableAttribute tableAttribute = table.getTableAttribute();
         System.out.println("表格定位的水平位置:" + tableAttribute.getHorizontalPosition());

  另请参见：
    `setHorizontalPosition(int)`, `getHorizontalRelative()`

### getHorizontalRelative

    public int getHorizontalRelative()

  得到表格水平定位的相对于参数。说明：表格的水平位置是相对于文档中的边缘线定位的，此参数就是边缘线的类型。 说明：如果表格文字环绕方式为无，则返回默认值2。

  返回：
    表格水平定位的边缘线的类型

         TableConstants.TABLE_MARGIN       =0     相对于页边距
         TableConstants.TABLE_PAGE         =1     相对于页面
         TableConstants.TABLE_PARAGRAPH    =2     相对于段落

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         TableAttribute tableAttribute = table.getTableAttribute();
         System.out.println("表格水平定位的边缘线的类型:" + tableAttribute.getHorizontalRelative());

  另请参见：
    `setHorizontalRelative(int)`, `getHorizontalPosition()`, `TableConstants`

### getLeftDistance

    public float getLeftDistance()

  得到正文文本与表格之间的左边距。 说明：如果表格文字环绕方式为无，则返回默认值0。

  返回：
    float 表格距正文左的间距

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         TableAttribute tableAttribute = table.getTableAttribute();
         System.out.println("正文文本与表格之间的左边距为:"+ tableAttribute.getLeftDistance());

  另请参见：
    `setLeftDistance(float)`

### getLeftIndent

    public float getLeftIndent()

  获得表格的左缩进距离，当其小于零时为突出多少距离。 说明：如果表格不是左对齐或者表格嵌入文本采用了文本环绕方式，则返回默认值0。

  返回：
    表格的左缩进距离（单位为磅值），取值范围为-1080到1080之间

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         TableAttribute tableAttribute = table.getTableAttribute();
         System.out.println("表格的左缩进距离为：" + tableAttribute.getLeftIndent());

  另请参见：
    `setLeftIndent(float)`, `TableConstants`

### 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);
         TableAttribute tableAttribute = table.getTableAttribute();
         System.out.println("得到指定表格宽度为：" + tableAttribute.getPreferredWidth());

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

### getPreferredWidthMeasure

    public int getPreferredWidthMeasure()

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

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

         TableConstants.TABLE_WIDTH_NONE_SET  不指定表格宽度
         TableConstants.TABLE_WIDTH_MEASURE   指定宽度为绝对值
         TableConstants.TABLE_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);
         TableAttribute tableAttribute = table.getTableAttribute();
         System.out.println("得到指定表格宽度的度量方式为：" + tableAttribute.getPreferredWidthMeasure());

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

### getRightDistance

    public float getRightDistance()

  得到正文文本与表格之间的右边距。 说明：如果表格文字环绕方式为无，则返回默认值0。

  返回：
    float 表格距正文右的间距

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         TableAttribute tableAttribute = table.getTableAttribute();
         System.out.println("正文文本与表格之间的右边距为:"+ tableAttribute.getRightDistance());

  另请参见：
    `setRightDistance(float)`

### getTopDistance

    public float getTopDistance()

  得到正文文本与表格之间的上边距。 说明：如果表格文字环绕方式为无，则返回默认值0。

  返回：
    float 表格距正文上的间距

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         TableAttribute tableAttribute = table.getTableAttribute();
         System.out.println("正文文本与表格之间的上边距为:"+ tableAttribute.getTopDistance());

  另请参见：
    `setTopDistance(float)`

### getVerticalPosition

    public int getVerticalPosition()

  得到表格定位的垂直位置。说明：此位置是相对于文档中的边缘线（边缘线由VerticalRelative属性定义）。 说明：如果表格文字环绕方式为无，则返回默认值1。

  返回：
    表格相对于边缘线的垂直方向上的位置

         TableConstants.TABLE_GOTO_TOP      =1    顶端
         TableConstants.TABLE_GOTO_BOTTOM   =2    底端
         TableConstants.TABLE_GOTO_CENTER   =0    居中
         TableConstants.TABLE_GOTO_INSIDE   =3    内侧
         TableConstants.TABLE_GOTO_OUTSIDE  =4    外侧

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         TableAttribute tableAttribute = table.getTableAttribute();
         System.out.println("表格定位的垂直位置:" + tableAttribute.getVerticalPosition());

  另请参见：
    `setVerticalPosition(int)`, `getVerticalRelative()`, `TableConstants`

### getVerticalRelative

    public int getVerticalRelative()

  得到表格垂直定位的相对于参数。说明：表格的垂直位置是相对于文档中的边缘线定位的，此参数就是边缘线的类型。 说明：如果表格文字环绕方式为无，则返回默认值2。

  返回：
    表格垂直定位的边缘线的类型

         TableConstants.TABLE_MARGIN   =0     相对于页边距
         TableConstants.TABLE_PAGE     =1     相对于页面
         TableConstants.TABLE_COLUMN   =2     相对于栏

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         TableAttribute tableAttribute = table.getTableAttribute();
         System.out.println("表格垂直定位的边缘线的类型:" + tableAttribute.getVerticalRelative());

  另请参见：
    `setVerticalRelative(int)`, `getVerticalPosition()`, `TableConstants`

### isAllowAdjustSpacing

    public boolean isAllowAdjustSpacing()

  判断是否允许调整表格默认的单元格间距。

  返回：
    是否可以调整默认单元格间距，true 表示可以调整

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         TableAttribute tableAttribute = table.getTableAttribute();
         System.out.println("是否可以调整表格默认的单元格间距:" + tableAttribute.isAllowAdjustSpacing());

  另请参见：
    `getAdjustableSpacing()`

### isAllowAutoFit

    public boolean isAllowAutoFit()

  判断是否允许表格的列宽重调整尺寸以适应内容。

  返回：
    表格是否会重调整尺寸以适应内容，true表示重调整尺寸

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         TableAttribute tableAttribute = table.getTableAttribute();
         System.out.println("表格的列宽是否会根据单元格中的内容自动调整：" + tableAttribute.isAllowAutoFit());

  另请参见：
    `setAllowAutoFit(boolean)`

### isAllowOverlap

    public boolean isAllowOverlap()

  返回当前表格是否允许被其他表格叠加。 说明：如果表格文字环绕方式为无，则返回默认值false。

  返回：
    表格与表格是否能够叠加，true表示能够被其他表格叠加

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         TableAttribute tableAttribute = table.getTableAttribute();
         System.out.println("表格与表格是否能够被叠加：" + tableAttribute.isAllowOverlap());

  另请参见：
    `setAllowOverlap(boolean)`

### isWrapAroundText

    public boolean isWrapAroundText()

  返回表格的环绕方式。

  返回：
    tableRound 表格是否为文本环绕方式，true表示文本环绕

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         TableAttribute tableAttribute = table.getTableAttribute();
         System.out.println("表格是否为环绕方式:" + tableAttribute.isWrapAroundText());

  另请参见：
    `setWrapAroundText(boolean)`

### setAdjustableSpacing

    public void setAdjustableSpacing(float spacing)

  设置表格的默认单元格间距。说明：如果间距值为0，则表示默认单元格间距不允许被调整。

  参数：
    `spacing` - 默认单元格间距(单位取磅值)

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         TableAttribute tableAttribute = table.getTableAttribute();
         tableAttribute.setAdjustableSpacing(20.0f);
         table.setTableAttribute(tableAttribute);

  抛出：
    `MacroRunException` - 当默认单元格间距不允许被调整时
    `MacroRunException` - 当指定间距超出范围0~158.9磅
  另请参见：
    `getAdjustableSpacing()`, `isAllowAdjustSpacing()`

### setAlignment

    public void setAlignment(int tableAlign)

  设置表格的对齐方式。

  参数：
    `tableAlign` - 表格的对齐方式，只能取以下整型值之一：

         TableConstants.TABLE_LEFT   = 0      左对齐
         TableConstants.TABLE_CENTER = 1      居中对齐
         TableConstants.TABLE_RIGHT  = 2      右对齐

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         TableAttribute tableAttribute = table.getTableAttribute();
         tableAttribute.setAlignment(TableConstants.TABLE_CENTER);
         table.setTableAttribute(tableAttribute);

  抛出：
    `MacroRunException` - 当指定表格对齐方式常量不存在
  另请参见：
    `getAlignment()`, `TableConstants`

### setAllowAutoFit

    public void setAllowAutoFit(boolean autofit)

  设置允许表格的列宽重调整尺寸以适应内容。

  参数：
    `autofit` - 表格是否会重调整尺寸以适应内容，true表示重调整尺寸

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         TableAttribute tableAttribute = table.getTableAttribute();
         tableAttribute.setAllowAutoFit(true);
         table.setTableAttribute(tableAttribute);

  另请参见：
    `isAllowAutoFit()`

### setAllowOverlap

    public void setAllowOverlap(boolean overlap)

  设置当前表格是否允许被其他表格叠加。

  参数：
    `overlap` - 表格与表格是否能够叠加，true表示能够被其他表格叠加

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         TableAttribute tableAttribute = table.getTableAttribute();
         tableAttribute.setWrapAroundText(true);
         tableAttribute.setAllowOverlap(true);
         table.setTableAttribute(tableAttribute);

  抛出：
    `MacroRunException` - 当表格嵌入文本文字环绕为无时，不能设置表格的定位信息
  另请参见：
    `isAllowOverlap()`

### setBottomDistance

    public void setBottomDistance(float bottomDistance)

  设置正文文本与表格之间的下边距（说明：只有设置了表格的文字环绕属性后属性才能被设置）。

  参数：
    `bottomDistance` - 表格距正文下的间距

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         TableAttribute tableAttribute = table.getTableAttribute();
         tableAttribute.setWrapAroundText(true);
         tableAttribute.setBottomDistance(10.0f);
         table.setTableAttribute(tableAttribute);

  抛出：
    `MacroRunException` - 当表格嵌入文本文字环绕为无时，不能设置表格的定位信息
  另请参见：
    `getBottomDistance()`

### setDefaultCellBottomMargin

    public void setDefaultCellBottomMargin(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);
         TableAttribute tableAttribute = table.getTableAttribute();
         tableAttribute.setDefaultCellBottomMargin(30.0f);
         table.setTableAttribute(tableAttribute);

  抛出：
    `MacroRunException` - 当指定边距超出范围0~1584磅
  另请参见：
    `getDefaultCellBottomMargin()`

### setDefaultCellLeftMargin

    public void setDefaultCellLeftMargin(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);
         TableAttribute tableAttribute = table.getTableAttribute();
         tableAttribute.setDefaultCellLeftMargin(30.0f);
         table.setTableAttribute(tableAttribute);

  抛出：
    `MacroRunException` - 当指定边距超出范围0~1584磅
  另请参见：
    `getDefaultCellLeftMargin()`

### setDefaultCellRightMargin

    public void setDefaultCellRightMargin(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);
         TableAttribute tableAttribute = table.getTableAttribute();
         tableAttribute.setDefaultCellRightMargin(30.0f);
         table.setTableAttribute(tableAttribute);

  抛出：
    `MacroRunException` - 当指定边距超出范围0~1584磅
  另请参见：
    `getDefaultCellRightMargin()`

### setDefaultCellTopMargin

    public void setDefaultCellTopMargin(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);
         TableAttribute tableAttribute = table.getTableAttribute();
         tableAttribute.setDefaultCellTopMargin(30.0f);
         table.setTableAttribute(tableAttribute);

  抛出：
    `MacroRunException` - 当指定边距超出范围0~1584磅
  另请参见：
    `getDefaultCellTopMargin()`

### setHorizontalPosition

    public void setHorizontalPosition(int position)

  设置表格定位的水平位置。说明：此位置是相对于文档中的边缘线（边缘线由HorizontalRelative属性定义）。

  参数：
    `position` - 表格相对于边缘线的水平方向上的位置

         TableConstants.TABLE_GOTO_LEFT     =1    左侧
         TableConstants.TABLE_GOTO_RIGHT    =2    右侧
         TableConstants.TABLE_GOTO_CENTER   =0    居中
         TableConstants.TABLE_GOTO_INSIDE   =3    内侧
         TableConstants.TABLE_GOTO_OUTSIDE  =4    外侧

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         TableAttribute tableAttribute = table.getTableAttribute();
         tableAttribute.setWrapAroundText(true);
         tableAttribute.setHorizontalRelative(TableConstants.TABLE_PARAGRAPH);
         tableAttribute.setHorizontalPosition(TableConstants.TABLE_GOTO_OUTSIDE);
         table.setTableAttribute(tableAttribute);

  抛出：
    `MacroRunException` - 当指定表格定位水平位置常量不存在
    `MacroRunException` - 当表格嵌入文本文字环绕为无时，不能设置表格的定位信息
  另请参见：
    `getHorizontalPosition()`, `setHorizontalRelative(int)`, `TableConstants`

### setHorizontalRelative

    public void setHorizontalRelative(int relativePosition)

  设置表格水平定位的相对于参数。说明：表格的水平位置是相对于文档中的边缘线定位的，此参数就是边缘线的类型。

  参数：
    `relativePosition` - 表格水平定位的边缘线的类型

         TableConstants.TABLE_MARGIN       =0     相对于页边距
         TableConstants.TABLE_PAGE         =1     相对于页面
         TableConstants.TABLE_PARAGRAPH    =2     相对于段落

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         TableAttribute tableAttribute = table.getTableAttribute();
         tableAttribute.setWrapAroundText(true);
         tableAttribute.setHorizontalRelative(TableConstants.TABLE_PARAGRAPH);
         table.setTableAttribute(tableAttribute);

  抛出：
    `MacroRunException` - 当表格嵌入文本文字环绕为无时，不能设置表格的定位信息
    `MacroRunException` - 当表格水平定位相对于参数常量不存在
  另请参见：
    `getHorizontalRelative()`, `setHorizontalPosition(int)`, `TableConstants`

### setLeftDistance

    public void setLeftDistance(float leftDistance)

  设置正文文本与表格之间的左边距。

  参数：
    `leftDistance` - 表格距正文左的间距

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         TableAttribute tableAttribute = table.getTableAttribute();
         tableAttribute.setWrapAroundText(true);
         tableAttribute.setLeftDistance(10.0f);
         table.setTableAttribute(tableAttribute);

  抛出：
    `MacroRunException` - 当表格嵌入文本文字环绕为无时，不能设置表格的定位信息
  另请参见：
    `getLeftDistance()`

### setLeftIndent

    public void setLeftIndent(float leftIndent)

  设置表格的左缩进距离，当其小于零时为突出多少距离。 说明：只有表格的对齐方式为左对齐并且表格嵌入文本文字环绕为无时，此方法才有效。

  参数：
    `leftIndent` - 表格的左缩进距离（单位为磅值），取值范围为-1080到1080之间

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         TableAttribute tableAttribute = table.getTableAttribute();
         tableAttribute.setLeftIndent(20.0f);
         table.setTableAttribute(tableAttribute);

  抛出：
    `MacroRunException` - 当表格的对齐方式不为左对齐并且表格嵌入文本文字环绕不为无时
  另请参见：
    `getLeftIndent()`, `TableConstants`

### 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);
         TableAttribute tableAttribute = table.getTableAttribute();
         tableAttribute.setPreferredWidthMeasure(TableConstants.TABLE_WIDTH_MEASURE);
         tableAttribute.setPreferredWidth(40.0f);
         table.setTableAttribute(tableAttribute);

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

### setPreferredWidthMeasure

    public void setPreferredWidthMeasure(int widthType)

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

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

         TableConstants.TABLE_WIDTH_NONE_SET  不指定表格宽度
         TableConstants.TABLE_WIDTH_MEASURE   指定宽度为绝对值（默认以磅值为单位）
         TableConstants.TABLE_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);
         TableAttribute tableAttribute = table.getTableAttribute();
         tableAttribute.setPreferredWidthMeasure(TableConstants.TABLE_WIDTH_PRECENT);
         tableAttribute.setPreferredWidth(40.0f);
         table.setTableAttribute(tableAttribute);

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

### setRightDistance

    public void setRightDistance(float rightDistance)

  设置正文文本与表格之间的右边距（说明：只有设置了表格的文字环绕属性后属性才能被设置）。

  参数：
    `rightDistance` - 表格距正文右的间距

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         TableAttribute tableAttribute = table.getTableAttribute();
         tableAttribute.setWrapAroundText(true);
         tableAttribute.setRightDistance(10.0f);
         table.setTableAttribute(tableAttribute);

  抛出：
    `MacroRunException` - 当表格嵌入文本文字环绕为无时，不能设置表格的定位信息
  另请参见：
    `getRightDistance()`

### setTopDistance

    public void setTopDistance(float topDistance)

  设置正文文本与表格之间的上边距（说明：只有设置了表格的文字环绕属性后属性才能被设置）。

  参数：
    `topDistance` - 表格距正文上的间距

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         TableAttribute tableAttribute = table.getTableAttribute();
         tableAttribute.setWrapAroundText(true);
         tableAttribute.setTopDistance(10.0f);
         table.setTableAttribute(tableAttribute);

  抛出：
    `MacroRunException` - 当表格嵌入文本文字环绕为无时，不能设置表格的定位信息
  另请参见：
    `getTopDistance()`

### setVerticalPosition

    public void setVerticalPosition(int position)

  设置表格定位的垂直位置。说明：此位置是相对于文档中的边缘线（边缘线由VerticalRelative属性定义）。

  参数：
    `position` - 表格相对于边缘线的垂直方向上的位置

         TableConstants.TABLE_GOTO_TOP      =1    顶端
         TableConstants.TABLE_GOTO_BOTTOM   =2    底端
         TableConstants.TABLE_GOTO_CENTER   =0    居中
         TableConstants.TABLE_GOTO_INSIDE   =3    内侧
         TableConstants.TABLE_GOTO_OUTSIDE  =4    外侧

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         TableAttribute tableAttribute = table.getTableAttribute();
         tableAttribute.setWrapAroundText(true);
         tableAttribute.setVerticalRelative(TableConstants.TABLE_COLUMN);
         tableAttribute.setVerticalPosition(TableConstants.TABLE_GOTO_CENTER);
         table.setTableAttribute(tableAttribute);

  抛出：
    `MacroRunException` - 当指定表格垂直定位常量不存在
    `MacroRunException` - 当表格嵌入文本文字环绕为无时，不能设置表格的定位信息
  另请参见：
    `getVerticalPosition()`, `setVerticalRelative(int)`, `TableConstants`

### setVerticalRelative

    public void setVerticalRelative(int relativePosition)

  设置表格垂直定位的相对于参数。说明：表格的垂直位置是相对于文档中的边缘线定位的，此参数就是边缘线的类型。

  参数：
    `relativePosition` - 表格垂直定位的边缘线的类型

         TableConstants.TABLE_MARGIN    =0     相对于页边距
         TableConstants.TABLE_PAGE      =1     相对于页面
         TableConstants.TABLE_COLUMN    =2     相对于栏

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         TableAttribute tableAttribute = table.getTableAttribute();
         tableAttribute.setWrapAroundText(true);
         tableAttribute.setVerticalRelative(TableConstants.TABLE_COLUMN);
         table.setTableAttribute(tableAttribute);

  抛出：
    `MacroRunException` - 当表格嵌入文本文字环绕为无时，不能设置表格的定位信息
    `MacroRunException` - 当表格垂直定位相对于参数常量不存在
  另请参见：
    `getVerticalRelative()`, `setVerticalPosition(int)`, `TableConstants`

### setWrapAroundText

    public void setWrapAroundText(boolean around)

  设置表格的环绕方式。

  参数：
    `around` - 表格是否为文本环绕方式，true表示文本环绕

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         TableAttribute tableAttribute = table.getTableAttribute();
         tableAttribute.setWrapAroundText(true);
         table.setTableAttribute(tableAttribute);

  另请参见：
    `isWrapAroundText()`

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

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

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