mlreportgen.dom.Width 类

命名空间: mlreportgen.dom

对象宽度

全页展开

描述

指定对象（例如图像或表条目）的宽度。

mlreportgen.dom.Width 类是一个 handle 类。

创建对象

描述

widthObj = Width 创建一个指定宽度为 1 英寸的格式对象。

widthObj = Width(value) 创建一个具有指定宽度的宽度对象。

示例

输入参量

全部展开

`value` — 对象宽度
字符向量

对象的宽度，例如图像或表条目，以 valueUnits 的形式指定，其中 Units 是单位的缩写。这些缩写是有效的：

px - 像素
cm - 厘米
in - 英寸
mm - 毫米
pc - 派卡
pt - 磅
% - 百分比

属性

全部展开

`Id` — `mlreportgen.dom.Width` 对象的标识符
字符向量 | 字符串标量

mlreportgen.dom.Width 对象的对象标识符，指定为字符向量或字符串标量。DOM API 在创建文档元素对象时会生成一个会话唯一标识符。您可以为 Id 指定自己的值。

属性：

NonCopyable true

数据类型: char | string

`Tag` — `mlreportgen.dom.Width` 对象的标签
字符向量 | 字符串标量

mlreportgen.dom.Width 对象的标签，指定为字符向量或字符串标量。DOM API 在创建此对象的过程中生成一个会话唯一标签。生成的标签形式为 CLASS:ID，其中 CLASS 是对象类，ID 是对象的 Id 属性的值。指定您自己的标签值，以帮助您确定在文档生成过程中出现问题时要查找的位置。

属性：

NonCopyable true

数据类型: char | string

`Value` — 对象宽度
字符向量

对象的宽度，例如图像或表条目，以 valueUnits 的形式指定，其中 Units 是单位的缩写。这些缩写是有效的：

px - 像素
cm - 厘米
in - 英寸
mm - 毫米
pc - 派卡
pt - 磅
% - 百分比

列的最终宽度取决于您对每个表条目使用的宽度类型（表格宽度的绝对值或分数 (%)）。设置整个列的宽度或设置表条目以调整大小以适合其内容也会影响最终的列宽。

表条目宽度设置	得到的列宽
两个或多个表条目设置为不同的绝对宽度	绝对宽度的最大值
两个或多个表条目设置为不同的分数宽度，以表格宽度的百分比 (%) 表示	分数宽度的最大值
混合设置为绝对宽度和分数宽度的表条目	对于 PDF 输出，绝对宽度最大。对于所有其他输出格式（例如，Word 和 HTML），输出应用程序确定要使用的最大列宽。
一个或多个表条目宽度设置为绝对宽度或分数宽度，列宽度使用 `mlreportgen.dom.TableColSpecGroup` 设置	指定表条目宽度和列宽度的最大值
一个或多个表条目宽度设置为绝对宽度或分数宽度，并且 `mlreportgen.dom.ResizeToFitContents` 设置为 `true`	对于 PDF 输出，表条目宽度最大。对于所有其他输出格式，调整大小以适合的表条目宽度最大。

示例

全部折叠

设置表格的宽度和其他格式

import mlreportgen.dom.*;
doctype = 'html';
d = Document('test',doctype);

t = Table(magic(5));
t.Style = {Border('inset','crimson','6pt'),...
     Width('50%')};

t.TableEntriesInnerMargin = '6pt';     
t.TableEntriesHAlign = 'center';
t.TableEntriesVAlign = 'middle';
append(d,t);

close(d);
rptview('test',doctype);