Поделиться через


Интерфейс 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