iTextPara::AddTab 方法 (tom.h)

在排量 tbPos 处添加一个选项卡,其类型为 tbAlign 和前导样式 tbLeader

语法

HRESULT AddTab(
  [in] float tbPos,
  [in] long  tbAlign,
  [in] long  tbLeader
);

参数

[in] tbPos

类型: float

新制表位移,以浮点为单位。

[in] tbAlign

类型: long

制表符位置的对齐选项。 可以是以下项之一。

含义
tomAlignLeft
文本与制表符位置左对齐。 这是默认值。
tomAlignCenter
文本在选项卡位置居中。
tomAlignRight
文本与制表符位置右对齐。
tomAlignDecimal
小数点在制表符位置设置。 这对于对齐十进制数字列很有用。
tomAlignBar
垂直条位于选项卡位置。 文本不受影响。 位于同一位置的附近线条上的对齐条形成连续的垂直线。

[in] tbLeader

类型: long

领导字符样式。 前导字符是用于填充制表符占用的空间的字符。 可以是以下项之一。

含义
tomSpaces
使用空格。 这是默认值。
tomDots
使用点。
tomDashes
使用虚线。
tomLines
使用实线。

返回值

类型: HRESULT

如果 ITextPara::AddTab 成功,则返回 S_OK。 如果方法失败,它将返回以下 COM 错误代码之一。 有关 COM 错误代码的详细信息,请参阅 COM 中的错误处理

返回代码 说明
含义
E_ACCESSDENIED
写入访问被拒绝。
E_OUTOFMEMORY
内存不足。
CO_E_RELEASED
段落格式对象附加到已删除的区域。

注解

假定在位置 0 处永远不会有选项卡。 如果描述多个段落,则将返回选项卡的常见子集,并在选项卡类型的上半个字中0x8000。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 tom.h
DLL Msftedit.dll

另请参阅

ClearAllTabs

概念性

DeleteTab

GetListTab

GetTab

GetTabCount

ITextPara

引用

SetListTab

文本对象模型