Метод ITextPara::AddTab (tom.h)

Статья
08/26/2023

Добавляет вкладку в элементе перемещения 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	Объект формата абзаца присоединяется к удаленному диапазону.

Предполагается, что табуляция никогда не находится в нулевой позиции. Если описано несколько абзацев, возвращается общее подмножество вкладок с 0x8000 в верхнем слове типа вкладки.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	tom.h
DLL	Msftedit.dll