WPS 加载项开发 > 文字 API 参考 > Table > 方法 > Table.AutoFormat 方法
将预定义外观应用于表格。

语法

表达式.AutoFormat(Format, ApplyBorders, ApplyShading, ApplyFont, ApplyColor, ApplyHeadingRows, ApplyLastRow, ApplyFirstColumn, ApplyLastColumn, AutoFit)

表达式   必选。一个代表 Table 对象的变量。

参数

名称 必选/可选 数据类型 说明
Format 可选 Variant 要应用的格式。此参数可以是 WdTableFormat 常量、WdTableFormatApply 常量或 TableStyle 对象。
ApplyBorders 可选 Variant 如果该参数值为 True,则应用指定格式的边框属性。默认值为 True
ApplyShading 可选 Variant 如果该参数值为 True,则应用指定格式的底纹属性。默认值为 True
ApplyFont 可选 Variant 如果该参数值为 True,则应用指定格式的字体属性。默认值为 True
ApplyColor 可选 Variant 如果该参数值为 True,则应用指定格式的颜色属性。默认值为 True
ApplyHeadingRows 可选 Variant 如果该参数值为 True,则应用指定格式的标题行属性。默认值为 True
ApplyLastRow 可选 Variant 如果该参数值为 True,则应用指定格式的最后一行的属性。默认值为 False
ApplyFirstColumn 可选 Variant 如果该参数值为 True,则应用指定格式的第一列的属性。默认值为 True
ApplyLastColumn 可选 Variant 如果该参数值为 True,则应用指定格式的最后一列的属性。默认值为 False
AutoFit 可选 Variant 如果该参数值为 True,则在不改变单元格内文字的换行方式的前提下尽可能缩小表格列宽。默认值为 True

说明

此方法的参数对应于“表格自动套用格式”对话框中的选项。

示例

以下示例在新文档中创建一个 5x5 的表格,并将“彩色型 2”格式的所有属性应用于此表格。

示例代码
let newDoc = Documents.Add()
let myTable = newDoc.Tables.Add(Selection.Range, 5, 5)
myTable.AutoFormat(wdTableFormatColorful2)

以下示例将“古典型 2”格式的所有属性应用于插入点所在表格。如果插入点不在表格中,则显示一个消息框。

示例代码
Selection.Collapse(wdCollapseStart)

if(Selection.Information(wdWithInTable) == true){
    Selection.Tables.Item(1).AutoFormat(wdTableFormatClassic2)
}
else{
    MsgBox("The insertion point is not in a table.")
}


请参阅