TableCellBorders Класс

Определение

Пространство имен:

DocumentFormat.OpenXml.Wordprocessing

Сборка:

DocumentFormat.OpenXml.dll

Пакет:

DocumentFormat.OpenXml v3.0.1

Определяет класс TableCellBorders.

Этот класс доступен в Office 2007 и более поздних версиях.

Когда объект сериализуется как xml, его полное имя — w:tcBorders.

public class TableCellBorders : DocumentFormat.OpenXml.OpenXmlCompositeElement

type TableCellBorders = class
    inherit OpenXmlCompositeElement

Public Class TableCellBorders
Inherits OpenXmlCompositeElement

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

Object

OpenXmlElement

OpenXmlCompositeElement

TableCellBorders

Комментарии

[ISO/IEC 29500-1 1 издание]

tcBorders (границы ячеек таблицы)

Этот элемент задает набор границ для ребер текущей ячейки таблицы, используя восемь типов границ, определенных ее дочерними элементами.

Если интервал между ячейками для любой строки не равен нулю, как указано с помощью элемента tblCellSpacing (§17.4.45; §17.4.44; §17.4.46), то никогда не возникает конфликта границ (так как интервал между ячейками, отличный от нуля, применяется выше ширины каждой отдельной границы ячейки), и должны отображаться все таблицы, исключения на уровне таблицы и границы ячеек таблицы.

Если интервал между ячейками равен нулю, может возникнуть конфликт между двумя смежными границами ячеек [Пример. Между левой границей всех ячеек во втором столбце и правой границей всех ячеек в первом столбце таблицы. end example], который должен быть разрешен следующим образом:

Если конфликтующая граница ячейки таблицы имеет значение nil или отсутствует (без границы), то отображается противоположная граница.

Если граница ячейки конфликтует с границей таблицы, она всегда выигрывает.

Затем каждой границе назначается вес с помощью следующей формулы, а значение границы, использующее это вычисление, должно отображаться над альтернативной границей:

Номер границы определяется этим списком:

Одного

1

Толстые

2

double

3

Пунктирной

4

Пунктирная

5

dotDash

6

dotDotDash

7

Трехместный

8

thinThickSmallGap

9

thickThinSmallGap

10

thinThickThinSmallGap

11

thinThickMediumGap

12

thickThinMediumGap

13

thinThickThinMediumGap

14

thinThickLargeGap

15

thickThinLargeGap

16

thinThickThinLargeGap

17

Волна

18

doubleWave

19

dashSmallGap

20

dashDotStroked

21

threeDEmboss

22

threeDEngrave

23

Начала

24

Вставка

25

Если границы имеют равный вес, чем более высокий из двух в этом списке приоритетов победит:

Одного

Толстые

double

Пунктирной

Пунктирная

dotDash

dotDotDash

Трехместный

thinThickSmallGap

thickThinSmallGap

thinThickThinSmallGap

thinThickMediumGap

thickThinMediumGap

thinThickThinMediumGap

thinThickLargeGap

thickThinLargeGap

thinThickThinLargeGap

Волна

doubleWave

dashSmallGap

dashDotStroked

threeDEmboss

threeDEngrave

Начала

Вставка

Если границы имеют идентичный стиль, каждому цвету границы должно быть присвоено значение яркости следующим образом: Цвет с меньшим значением яркости должен выиграть.

Если границы имеют идентичное значение яркости выше, каждому цвету границы должно быть присвоено новое значение яркости следующим образом: Цвет с меньшим значением яркости должен выиграть.

Если границы имеют идентичное значение яркости выше, каждому цвету границы должно быть присвоено значение яркости следующим образом: Цвет с меньшим значением яркости должен выиграть.

Если границы имеют идентичное значение яркости выше, то они функционально идентичны, и должна отображаться первая граница в порядке чтения.

[Пример. Рассмотрим следующую таблицу с двумя ячейками (с преувеличенным интервалом между ячейками таблицы для ясности):

При сворачивании интервала между ячейками на всех ребрах возникают конфликтующие границы. Для каждого конфликта границы ячейки или таблицы правило 2 говорит, что граница ячейки должна выиграть. Для конфликта в центре между двумя границами ячейки правило 3 дает больший вес границы для границы правой ячейки, что приводит к следующей таблице:

конец примера

Если этот элемент опущен, то эта таблица должна иметь границы, заданные соответствующим стилем таблицы. Если в иерархии стилей не указаны границы, то эта таблица не должна иметь границ таблицы.

[Пример. Рассмотрим таблицу, первая ячейка которой задает границы на уровне ячеек, состоящие из двойной красной линии, как показано ниже.

Эти границы ячеек задаются с помощью следующего метода WordprocessingML:

<w:tcPr>  
  <w:tcBorders>  
    <w:top w:val="double" w:sz="24" w:space="0" w:color="FF0000"/>  
    <w:left w:val="double" w:sz="24" w:space="0" w:color="FF0000"/>  
    <w:bottom w:val="double" w:sz="24" w:space="0" w:color="FF0000"/>  
    <w:right w:val="double" w:sz="24" w:space="0" w:color="FF0000"/>  
  </w:tcBorders>  
</w:tcPr>  

Элемент tcBorders задает набор границ, применяемых к первой ячейке в виде 3-точечной двойной границы. конец примера

Родительские элементы
tcPr (§17.7.6.8); tcPr (§17.7.6.9); tcPr (§17.4.70); tcPr (§17.4.71)

Дочерние элементы	Вложенные запросы
bottom (нижняя граница ячейки таблицы)	§17.4.3
end (граница конечной границы ячейки таблицы)	§17.4.12
insideH (ячейка таблицы внутри границы горизонтальных ребер)	§17.4.24
insideV (ячейка таблицы внутри границы вертикальных границ)	§17.4.26
start (граница передней границы ячейки таблицы)	§17.4.34
tl2br (ячейка таблицы сверху слева на нижней правой диагональной границе)	§17.4.74
top (верхняя граница ячейки таблицы)	§17.4.75
tr2bl (ячейка таблицы сверху справа на нижней левой диагональной границе)	§17.4.80

[Примечание. Определение xml-схемы W3C для модели содержимого этого элемента (CT_TcBorders) находится в §A.1. конечная заметка]

ISO/IEC29500: 2008.

Конструкторы

TableCellBorders()	Инициализирует новый экземпляр класса TableCellBorders.
TableCellBorders(IEnumerable<OpenXmlElement>)	Инициализирует новый экземпляр класса TableCellBorders указанными дочерними элементами.
TableCellBorders(OpenXmlElement[])	Инициализирует новый экземпляр класса TableCellBorders указанными дочерними элементами.
TableCellBorders(String)	Инициализирует новый экземпляр класса TableCellBorders из внешнего XML-кода.

Свойства

BottomBorder	Нижняя граница ячейки таблицы. Представляет следующий тег элемента в схеме: w:bottom.
ChildElements	Возвращает все дочерние узлы текущего элемента. (Унаследовано от OpenXmlElement)
EndBorder	EndBorder, это свойство доступно только в Office 2010 и более поздних версиях. Представляет следующий тег элемента в схеме: w:end.
ExtendedAttributes	Возвращает все расширенные атрибуты (атрибуты, не определенные в схеме) текущего элемента. (Унаследовано от OpenXmlElement)
Features	IFeatureCollection Возвращает для текущего элемента. Эта коллекция компонентов будет доступна только для чтения, но будет наследовать компоненты от родительской части и пакета, если они доступны. (Унаследовано от OpenXmlElement)
FirstChild	Получает первый дочерний элемент текущего элемента OpenXmlElement. (Унаследовано от OpenXmlCompositeElement)
HasAttributes	Возвращает значение, указывающее, имеет ли текущий элемент какие-либо атрибуты. (Унаследовано от OpenXmlElement)
HasChildren	Возвращает значение, указывающее, содержит ли текущий элемент какие-либо дочерние элементы. (Унаследовано от OpenXmlCompositeElement)
InnerText	Возвращает или задает объединенные значения текущего узла и всех его дочерних элементов. (Унаследовано от OpenXmlCompositeElement)
InnerXml	Возвращает или задает разметку, представляющую только дочерние узлы текущего узла. (Унаследовано от OpenXmlCompositeElement)
InsideHorizontalBorder	Ячейка таблицы внутри границы горизонтальных ребер. Представляет следующий тег элемента в схеме: w:insideH.
InsideVerticalBorder	Ячейка таблицы внутри границы вертикальных ребер. Представляет следующий тег элемента в схеме: w:insideV.
LastChild	Возвращает последний дочерний элемент текущего элемента OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если такого элемента OpenXmlElement нет. (Унаследовано от OpenXmlCompositeElement)
LeftBorder	Левая граница ячейки таблицы. Представляет следующий тег элемента в схеме: w:left.
LocalName	Возвращает локальное имя текущего элемента. (Унаследовано от OpenXmlElement)
MCAttributes	Возвращает или задает атрибуты совместимости разметки. Возвращает значение NULL, если для текущего элемента не определены атрибуты совместимости разметки. (Унаследовано от OpenXmlElement)
NamespaceDeclarations	Возвращает все объявления пространства имен, определенные в текущем элементе. Возвращает пустой перечислитель, если нет объявления пространства имен. (Унаследовано от OpenXmlElement)
NamespaceUri	Возвращает универсальный код ресурса (URI) пространства имен текущего элемента. (Унаследовано от OpenXmlElement)
OpenXmlElementContext	Возвращает openXmlElementContext текущего элемента. (Унаследовано от OpenXmlElement)
OuterXml	Возвращает разметку, представляющую текущий элемент и все его дочерние элементы. (Унаследовано от OpenXmlElement)
Parent	Возвращает родительский элемент текущего элемента. (Унаследовано от OpenXmlElement)
Prefix	Возвращает префикс пространства имен текущего элемента. (Унаследовано от OpenXmlElement)
RightBorder	Правая граница ячейки таблицы. Представляет следующий тег элемента в схеме: w:right.
StartBorder	StartBorder, это свойство доступно только в Office 2010 и более поздних версиях. Представляет следующий тег элемента в схеме: w:start.
TopBorder	Верхняя граница ячейки таблицы. Представляет следующий тег элемента в схеме: w:top.
TopLeftToBottomRightCellBorder	Ячейка таблицы сверху слева на снизу справа по диагонали границы. Представляет следующий тег элемента в схеме: w:tl2br.
TopRightToBottomLeftCellBorder	Ячейка таблицы сверху справа на нижнем левом крае по диагонали. Представляет следующий тег элемента в схеме: w:tr2bl.
XmlQualifiedName	Возвращает полное имя текущего элемента. (Унаследовано от OpenXmlElement)
XName	Возвращает полное имя текущего элемента. (Унаследовано от OpenXmlElement)

Методы

AddAnnotation(Object)	Добавляет объект в список заметок текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
AddChild(OpenXmlElement, Boolean)	Добавляет указанный элемент в элемент , если он является известным дочерним элементом. При этом элемент будет добавлен в правильное расположение в соответствии со схемой. (Унаследовано от OpenXmlCompositeElement)
AddNamespaceDeclaration(String, String)	Добавляет объявление пространства имен в текущий узел. (Унаследовано от OpenXmlElement)
Ancestors()	Перечисляет все предки текущего элемента. (Унаследовано от OpenXmlElement)
Ancestors<T>()	Перечисляет только предки текущего элемента, имеющие указанный тип. (Унаследовано от OpenXmlElement)
Annotation(Type)	Получение первого объекта заметки указанного типа из текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
Annotation<T>()	Получение первого объекта заметки указанного типа из текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
Annotations(Type)	Возвращает коллекцию заметок с указанным типом для текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
Annotations<T>()	Возвращает коллекцию заметок с указанным типом для текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	Добавляет каждый элемент из списка элементов в конец списка дочерних элементов текущего элемента. (Унаследовано от OpenXmlElement)
Append(OpenXmlElement[])	Добавляет каждый элемент из массива элементов в конец списка дочерних элементов текущего элемента. (Унаследовано от OpenXmlElement)
AppendChild<T>(T)	Добавляет указанный элемент в конец списка дочерних узлов текущего элемента. (Унаследовано от OpenXmlCompositeElement)
ClearAllAttributes()	Очищает все атрибуты, включая как известные, так и расширенные атрибуты. (Унаследовано от OpenXmlElement)
Clone()	Создает дубликат текущего узла. (Унаследовано от OpenXmlElement)
CloneNode(Boolean)	Создает дубликат этого узла.
Descendants()	Перечисляет все потомки текущего элемента. (Унаследовано от OpenXmlElement)
Descendants<T>()	Перечисление всех потомков текущего элемента типа T. (Унаследовано от OpenXmlElement)
Elements()	Перечисляет все дочерние элементы текущего элемента. (Унаследовано от OpenXmlElement)
Elements<T>()	Перечисляет только дочерние элементы текущего элемента, имеющие указанный тип. (Унаследовано от OpenXmlElement)
ElementsAfter()	Перечисляет все одноуровневые элементы, которые следуют за текущим элементом и имеют тот же родительский элемент, что и текущий элемент. (Унаследовано от OpenXmlElement)
ElementsBefore()	Перечисляет все одноуровневые элементы, которые предшествуют текущему элементу и имеют тот же родительский элемент, что и текущий элемент. (Унаследовано от OpenXmlElement)
GetAttribute(String, String)	Возвращает атрибут Open XML с указанным именем тега и URI пространства имен. (Унаследовано от OpenXmlElement)
GetAttributes()	Возвращает список, содержащий копию всех атрибутов. (Унаследовано от OpenXmlElement)
GetEnumerator()	Возвращает перечислитель, который выполняет итерацию по дочерней коллекции. (Унаследовано от OpenXmlElement)
GetFirstChild<T>()	Находит первый дочерний элемент в типе T. (Унаследовано от OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	Вставляет указанный элемент сразу после указанного ссылочного элемента. (Унаследовано от OpenXmlCompositeElement)
InsertAfterSelf<T>(T)	Вставляет указанный элемент сразу после текущего элемента. (Унаследовано от OpenXmlElement)
InsertAt<T>(T, Int32)	Вставляет указанный элемент по указанному индексу дочерних элементов текущего элемента. (Унаследовано от OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)	Вставляет указанный элемент непосредственно перед указанным ссылочным элементом. (Унаследовано от OpenXmlCompositeElement)
InsertBeforeSelf<T>(T)	Вставляет указанный элемент непосредственно перед текущим элементом. (Унаследовано от OpenXmlElement)
IsAfter(OpenXmlElement)	Определяет, отображается ли текущий элемент после указанного элемента в порядке документа. (Унаследовано от OpenXmlElement)
IsBefore(OpenXmlElement)	Определяет, отображается ли текущий элемент перед указанным элементом в порядке документа. (Унаследовано от OpenXmlElement)
LookupNamespace(String)	Разрешает префикс пространства имен в контексте текущего узла. (Унаследовано от OpenXmlElement)
LookupPrefix(String)	Находит соответствующий префикс для URI пространства имен в текущем элементе область. (Унаследовано от OpenXmlElement)
NextSibling()	Возвращает элемент OpenXmlElement, который сразу же следует за текущим элементом OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет следующего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
NextSibling<T>()	Возвращает элемент OpenXmlElement с указанным типом, который следует за текущим элементом OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет следующего OpenXmlElement. (Унаследовано от OpenXmlElement)
PrependChild<T>(T)	Вставляет указанный элемент в начало списка дочерних узлов текущего элемента. (Унаследовано от OpenXmlCompositeElement)
PreviousSibling()	Возвращает элемент OpenXmlElement, который непосредственно предшествует текущему элементу OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет предыдущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
PreviousSibling<T>()	Возвращает элемент OpenXmlElement с указанным типом, который предшествует текущему объекту OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет предыдущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
Remove()	Удаляет текущий элемент из родительского элемента. (Унаследовано от OpenXmlElement)
RemoveAllChildren()	Удаляет все дочерние элементы текущего элемента. (Унаследовано от OpenXmlCompositeElement)
RemoveAllChildren<T>()	Удалите все дочерние элементы текущего элемента типа T. (Унаследовано от OpenXmlElement)
RemoveAnnotations(Type)	Удаляет заметки указанного типа из текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
RemoveAnnotations<T>()	Удаляет заметки с указанным типом из текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
RemoveAttribute(String, String)	Удаляет атрибут из текущего элемента. (Унаследовано от OpenXmlElement)
RemoveChild<T>(T)	Удаляет указанный дочерний элемент. (Унаследовано от OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)	Удаляет объявление пространства имен для указанного префикса. Ничего не удаляет, если нет префикса. (Унаследовано от OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Заменяет один из дочерних элементов текущего элемента другим элементом OpenXmlElement. (Унаследовано от OpenXmlCompositeElement)
SetAttribute(OpenXmlAttribute)	Задает атрибут заданного элемента. Если атрибут является известным атрибутом, задается значение атрибута. Если атрибут является расширенным атрибутом, в список расширенных атрибутов добавляется openxmlAttribute. (Унаследовано от OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Задает ряд атрибутов элемента . Если атрибут является известным атрибутом, задается значение атрибута. Если атрибут является расширенным атрибутом, в список расширенных атрибутов добавляется openxmlAttribute. (Унаследовано от OpenXmlElement)
WriteTo(XmlWriter)	Сохраняет текущий узел в указанном xmlWriter. (Унаследовано от OpenXmlElement)

Явные реализации интерфейса

IEnumerable.GetEnumerator()	Определяет класс TableCellBorders. Этот класс доступен в Office 2007 и более поздних версиях. Когда объект сериализуется как xml, его полное имя — w:tcBorders. (Унаследовано от OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Возвращает перечислитель, который выполняет итерацию по дочерней коллекции. (Унаследовано от OpenXmlElement)