Интерфейс ITextRow (tom.h)

Интерфейс ITextRow предоставляет методы для вставки одной или нескольких идентичных строк таблицы, а также для извлечения и изменения свойств строк таблицы. Чтобы вставить неидентичные строки, вызовите ITextRow::Insert для каждой конфигурации строк.

Наследование

Интерфейс ITextRow наследуется от интерфейса IDispatch . ITextRow также имеет следующие типы элементов:

Методы

Интерфейс ITextRow содержит следующие методы.

ITextRow::Apply Применяет атрибуты форматирования этого объекта текстовой строки к указанным строкам в связанном ITextRange2.
ITextRow::CanChange Определяет, можно ли вносить изменения в эту строку.
ITextRow::GetAlignment Возвращает горизонтальное выравнивание строки.
ITextRow::GetCellAlignment Возвращает вертикальное выравнивание активной ячейки.
ITextRow::GetCellBorderColors Возвращает цвета границы активной ячейки.
ITextRow::GetCellBorderWidths Возвращает ширину границ активной ячейки.
ITextRow::GetCellColorBack Возвращает цвет фона активной ячейки.
ITextRow::GetCellColorFore Возвращает цвет переднего плана активной ячейки.
ITextRow::GetCellCount Возвращает число ячеек в этой строке.
ITextRow::GetCellCountCache Возвращает количество ячеек, кэшированных для этой строки.
ITextRow::GetCellIndex Возвращает индекс активной ячейки для получения или задания параметров.
ITextRow::GetCellMargin Возвращает поле ячейки этой строки.
ITextRow::GetCellMergeFlags Возвращает флаги слияния активной ячейки.
ITextRow::GetCellShading Получает заливку активной ячейки.
ITextRow::GetCellVerticalText Возвращает параметр вертикального текста активной ячейки.
ITextRow::GetCellWidth Возвращает ширину активной ячейки.
ITextRow::GetHeight Возвращает высоту строки.
ITextRow::GetIndent Возвращает отступ этой строки.
ITextRow::GetKeepTogether Возвращает значение, указывая, разрешено ли разбить эту строку на страницы.
ITextRow::GetKeepWithNext Возвращает значение, указывающее, должна ли эта строка отображаться на той же странице, что и следующая за ней строка.
ITextRow::GetNestLevel Возвращает уровень вложения таблицы.
ITextRow::GetProperty Возвращает значение указанного свойства. (ITextRow.GetProperty)
ITextRow::GetRTL Возвращает значение, указывая, имеет ли эта строка ориентацию справа налево.
ITextRow::Insert Вставляет строку или строки в расположение, определенное связанным объектом ITextRange2.
ITextRow::Isequal Сравнивает две строки таблицы, чтобы определить, имеют ли они одинаковые свойства.
ITextRow::Reset Сбрасывает строку.
ITextRow::SetAlignment Задает горизонтальное выравнивание строки.
ITextRow::SetCellAlignment Задает вертикальное выравнивание активной ячейки.
ITextRow::SetCellBorderColors Задает цвета границы активной ячейки.
ITextRow::SetCellBorderWidths Задает ширину границ активной ячейки.
ITextRow::SetCellColorBack Задает цвет фона активной ячейки.
ITextRow::SetCellColorFore Задает цвет переднего плана активной ячейки.
ITextRow::SetCellCount Задает количество ячеек в строке.
ITextRow::SetCellCountCache Задает количество ячеек, кэшированных для строки.
ITextRow::SetCellIndex Задает индекс активной ячейки.
ITextRow::SetCellMargin Задает поле ячейки строки.
ITextRow::SetCellMergeFlags Задает флаги слияния активной ячейки.
ITextRow::SetCellShading Задает заливку активной ячейки.
ITextRow::SetCellVerticalText Задает параметр вертикального текста активной ячейки.
ITextRow::SetCellWidth Задает ширину активной ячейки в твипах.
ITextRow::SetHeight Задает высоту строки.
ITextRow::SetIndent Задает отступ строки.
ITextRow::SetKeepTogether Задает, разрешено ли разбивать эту строку между страницами.
ITextRow::SetKeepWithNext Задает, должна ли строка отображаться на той же странице, что и следующая за ней строка.
ITextRow::SetProperty Задает значение указанного свойства. (ITextRow.SetProperty)
ITextRow::SetRTL Задает, имеет ли эта строка ориентацию справа налево.

Комментарии

Чтобы выбрать таблицу, строку или ячейку, используйте ITextRange::Expand с параметром Unit , равным tomTable, tomRow или tomCell соответственно. Эти единицы также можно использовать с методами ITextRange::Move для перемещения и выбора нескольких строк или ячеек.

Некоторые свойства ITextRow применяются ко всей строке, например к выравниванию строки. Кроме того, существует ряд свойств, таких как выравнивание ячейки, которые применяются к ячейке с индексом, заданным с помощью метода ITextRow::SetCellIndex . Эта ячейка называется активной ячейкой.

ITextRow работает аналогично ITextPara2, но не изменяет документ, пока не будут вызваны методы ITextRow::Apply или ITextRow::Insert . Кроме того, параметры строки и ячейки всегда активны, то есть они не могут иметь значение tomDefault.

При инициализации объект ITextRow получает свойства строки таблицы, если таковые есть, в активном конце связанного объекта ITextRange2. Метод ITextRow::Reset можно использовать для обновления этих свойств до текущих значений для объекта ITextRange2 .

Многофункциональная таблица управления редактированием состоит из последовательности строк таблицы, которая, в свою очередь, состоит из последовательностей абзацев. Строка таблицы начинается со специального двухсимвного разделителя абзаца U+FFF9 U+000D и заканчивается абзацем разделителя из двух символов U+FFFB U+000D. Каждая ячейка завершается меткой ячейки U+0007, которая рассматривается как знак конца абзаца точно так же, как U+000D (CR). Параметры строки и ячейки таблицы обрабатываются как специальное форматирование абзаца разделителей строк таблицы. Параметры ячейки хранятся в расширенной версии массива вкладок. Этот формат позволяет вложить таблицы в другие таблицы и может идти на пятнадцать уровней.

Архитектура довольно гибкая, так как каждая строка таблицы может иметь любые допустимые параметры строки таблицы, независимо от параметров для других строк (за исключением флагов вертикального слияния). Например, количество ячеек и начальные отступы строк таблицы могут отличаться, в отличие от html× который имеет n×m прямоугольный формат, причем все строки начинаются с одного отступа.

С другой стороны, официальное описание таблицы не хранится нигде. Такие сведения, как количество строк, необходимо определить, перейдя по таблице. Например, количество строк в таблице можно получить, вызвав метод ITextRange::StartOf (tomTable, tomFalse, NULL) для перехода к началу текущей таблицы, а затем вызвав метод ITextRange::Move (tomRow, tomForward,&dcRow). Количество &dcRow + 1 содержит количество строк в таблице, так как приращение tomRow не выходит за пределы последней строки таблицы.

Требования

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