TableStyle Класс

Определение

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

DocumentFormat.OpenXml.Drawing

Сборка:

DocumentFormat.OpenXml.dll

Пакет:

DocumentFormat.OpenXml v3.0.1

Стиль таблицы.

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

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

public class TableStyle : DocumentFormat.OpenXml.Drawing.TableStyleType

type TableStyle = class
    inherit TableStyleType

Public Class TableStyle
Inherits TableStyleType

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

Object

OpenXmlElement

OpenXmlCompositeElement

TableStyleType

TableStyle

Комментарии

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

tableStyle (стиль таблицы)

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

• Включение и выключение первой строки — связанный элемент: firstRow

• Включение и выключение последней строки — связанный элемент: lastRow

• Включение и выключение первого столбца — связанный элемент: firstCol

• Включение и выключение последнего столбца — связанный элемент: lastCol

• Включение и отключение полосы строк — связанные элементы: band1H, band2H

• Включение и выключение полосы столбцов — связанные элементы: band1V, band2V

Форматирование, связанное с элементом wholeTbl, определяет форматирование таблицы при отключении всех параметров. Если параметр включен, к таблице применяется форматирование для этого параметра. Параметры форматирования для отдельных четырех ячеек включаются при включении перекрывающихся параметров. Например, если включены параметры форматирования первой строки и первого столбца, также применяется любое форматирование в северо-западной ячейке, так как это перекрывающаяся ячейка таблицы, когда включены параметры форматирования первого столбца и первой строки.

[Пример. Рассмотрим следующий частичный пример tblStyle в DrawingML:

<a:tblStyle styleId="{5940675A-B579-460E-94D1-54222C63F5DA}"  styleName="No Style, Table Grid">  
  <a:wholeTbl>  
    <a:tcTxStyle>  
      <a:fontRef idx="minor">  
        <a:scrgbClr r="0" g="0" b="0"/>  
      </a:fontRef>  
      <a:schemeClr val="tx1"/>  
    </a:tcTxStyle>  
    <a:tcStyle>  
      <a:tcBdr>  
        <a:left>  
          <a:ln w="12700" cmpd="sng">  
            <a:solidFill>  
              <a:schemeClr val="tx1"/>  
            </a:solidFill>  
          </a:ln>  
        </a:left>  

... right, top, bottom, insideH, insideV border information is just as 'left' tag...

    </a:tcBdr>  
    <a:fill>  
      <a:noFill/>  
    </a:fill>  
  </a:tcStyle>  
</a:wholeTbl>  
<a:band1H>  
  <a:tcStyle>  
    <a:tcBdr/>  
  </a:tcStyle>  
</a:band1H>  

... band2H, band1V, band2V, firstCol, firstRow, lastCol, lastRow, lastRow, neCell, nwCell, seCell, swCell теги определяются так же, как тег band1H

</a:tblStyle>  

В этом примере можно получить представление об определении стиля таблицы в целом. Указанный выше стиль таблицы создает стиль с форматированием строк 1pt, применяемым ко всем ячейкам таблицы. Обратите внимание, что переключатель включения и выключения (band1H, band2H, firstCol и т. д.) не определяет форматирование и, следовательно, не влияет на таблицу при переключе. конец примера

Родительские элементы
tblPr (§21.1.3.15)

Дочерние элементы	Вложенные запросы
band1H (диапазон 1 по горизонтали)	§20.1.4.2.1
band1V (диапазон 1 по вертикали)	§20.1.4.2.2
band2H (диапазон 2 по горизонтали)	§20.1.4.2.3
band2V (диапазон 2 по вертикали)	§20.1.4.2.4
extLst (список расширений)	§20.1.2.2.15
firstCol (первый столбец)	§20.1.4.2.11
firstRow (первая строка)	§20.1.4.2.12
lastCol (последний столбец)	§20.1.4.2.16
lastRow (последняя строка)	§20.1.4.2.17
neCell (северо-восточная ячейка)	§20.1.4.2.20
nwCell (северо-западная ячейка)	§20.1.4.2.21
seCell (юго-восточная ячейка)	§20.1.4.2.23
swCell (юго-западная ячейка)	§20.1.4.2.24
tblBg (фон таблицы)	§20.1.4.2.25
wholeTbl (вся таблица)	§20.1.4.2.34

Атрибуты	Описание
styleId (идентификатор стиля)	Задает ИДЕНТИФИКАТОР GUID, определяющий стиль таблицы уникальным образом. Возможные значения для этого атрибута определяются простым типом ST_Guid (§22.9.2.4).
styleName (Имя)	Указывает имя стиля таблицы, который может отображаться в пользовательском интерфейсе, идентифицируя стиль для пользователя. Допустимые значения этого атрибута определяются типом данных string схемы XML (консорциум W3C).

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

ISO/IEC29500: 2008.

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

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

Свойства

Band1Horizontal	Полоса 1 по горизонтали. Представляет следующий тег элемента в схеме: a:band1H. (Унаследовано от TableStyleType)
Band1Vertical	Полоса 1 по вертикали. Представляет следующий тег элемента в схеме: a:band1V. (Унаследовано от TableStyleType)
Band2Horizontal	Диапазон 2 по горизонтали. Представляет следующий тег элемента в схеме: a:band2H. (Унаследовано от TableStyleType)
Band2Vertical	Полоса 2 по вертикали. Представляет следующий тег элемента в схеме: a:band2V. (Унаследовано от TableStyleType)
ChildElements	Возвращает все дочерние узлы текущего элемента. (Унаследовано от OpenXmlElement)
ExtendedAttributes	Возвращает все расширенные атрибуты (атрибуты, не определенные в схеме) текущего элемента. (Унаследовано от OpenXmlElement)
ExtensionList	ExtensionList. Представляет следующий тег элемента в схеме: a:extLst. (Унаследовано от TableStyleType)
Features	IFeatureCollection Возвращает для текущего элемента. Эта коллекция компонентов будет доступна только для чтения, но будет наследовать компоненты от родительской части и пакета, если они доступны. (Унаследовано от OpenXmlElement)
FirstChild	Получает первый дочерний элемент текущего элемента OpenXmlElement. (Унаследовано от OpenXmlCompositeElement)
FirstColumn	Первый столбец. Представляет следующий тег элемента в схеме: a:firstCol. (Унаследовано от TableStyleType)
FirstRow	Первая строка. Представляет следующий тег элемента в схеме: a:firstRow. (Унаследовано от TableStyleType)
HasAttributes	Возвращает значение, указывающее, имеет ли текущий элемент какие-либо атрибуты. (Унаследовано от OpenXmlElement)
HasChildren	Возвращает значение, указывающее, содержит ли текущий элемент какие-либо дочерние элементы. (Унаследовано от OpenXmlCompositeElement)
InnerText	Возвращает или задает объединенные значения текущего узла и всех его дочерних элементов. (Унаследовано от OpenXmlCompositeElement)
InnerXml	Возвращает или задает разметку, представляющую только дочерние узлы текущего узла. (Унаследовано от OpenXmlCompositeElement)
LastChild	Возвращает последний дочерний элемент текущего элемента OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если такого элемента OpenXmlElement нет. (Унаследовано от OpenXmlCompositeElement)
LastColumn	Последний столбец. Представляет следующий тег элемента в схеме: a:lastCol. (Унаследовано от TableStyleType)
LastRow	Последняя строка. Представляет следующий тег элемента в схеме: a:lastRow. (Унаследовано от TableStyleType)
LocalName	Возвращает локальное имя текущего элемента. (Унаследовано от OpenXmlElement)
MCAttributes	Возвращает или задает атрибуты совместимости разметки. Возвращает значение NULL, если для текущего элемента не определены атрибуты совместимости разметки. (Унаследовано от OpenXmlElement)
NamespaceDeclarations	Возвращает все объявления пространства имен, определенные в текущем элементе. Возвращает пустой перечислитель, если нет объявления пространства имен. (Унаследовано от OpenXmlElement)
NamespaceUri	Возвращает универсальный код ресурса (URI) пространства имен текущего элемента. (Унаследовано от OpenXmlElement)
NortheastCell	Северо-восточная ячейка. Представляет следующий тег элемента в схеме: a:neCell. (Унаследовано от TableStyleType)
NorthwestCell	Северо-западная ячейка. Представляет следующий тег элемента в схеме: a:nwCell. (Унаследовано от TableStyleType)
OpenXmlElementContext	Возвращает openXmlElementContext текущего элемента. (Унаследовано от OpenXmlElement)
OuterXml	Возвращает разметку, представляющую текущий элемент и все его дочерние элементы. (Унаследовано от OpenXmlElement)
Parent	Возвращает родительский элемент текущего элемента. (Унаследовано от OpenXmlElement)
Prefix	Возвращает префикс пространства имен текущего элемента. (Унаследовано от OpenXmlElement)
SoutheastCell	Юго-восточная ячейка. Представляет следующий тег элемента в схеме: a:seCell. (Унаследовано от TableStyleType)
SouthwestCell	Юго-западная ячейка. Представляет следующий тег элемента в схеме: a:swCell. (Унаследовано от TableStyleType)
StyleId	Идентификатор стиля Представляет следующий атрибут в схеме: styleId (Унаследовано от TableStyleType)
StyleName	Имя Представляет следующий атрибут в схеме: styleName (Унаследовано от TableStyleType)
TableBackground	Фон таблицы. Представляет следующий тег элемента в схеме: a:tblBg. (Унаследовано от TableStyleType)
WholeTable	Вся таблица. Представляет следующий тег элемента в схеме: a:wholeTbl. (Унаследовано от TableStyleType)
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()	Стиль таблицы. Этот класс доступен в Office 2007 и более поздних версиях. Когда объект сериализуется как xml, его полное имя — a:tableStyle. (Унаследовано от OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Возвращает перечислитель, который выполняет итерацию по дочерней коллекции. (Унаследовано от OpenXmlElement)