DataBar Класс

Определение

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

DocumentFormat.OpenXml.Office2010.Excel

Сборка:

DocumentFormat.OpenXml.dll

Пакет:

DocumentFormat.OpenXml v3.0.1

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

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

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

public class DataBar : DocumentFormat.OpenXml.OpenXmlCompositeElement

type DataBar = class
    inherit OpenXmlCompositeElement

Public Class DataBar
Inherits OpenXmlCompositeElement

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

Object

OpenXmlElement

OpenXmlCompositeElement

DataBar

Комментарии

2.6.30 CT_DataBar

Целевое пространство имен:http://schemas.microsoft.com/office/spreadsheetml/2009/9/main

На который ссылается: Ct_cfrule

Сложный тип, указывающий панель данных, используемую в условном форматировании.

Дочерние элементы:

Cfvo: Элемент CT_Cfvo (раздел 2.6.26), указывающий значения ячеек, соответствующие минимальной/максимальной длине панели данных. При наличии CT_Cfvo ([ISO/IEC-29500-4] раздела A.2) на этом листе (1) элементов, которые являются дочерними элементами CT_DataBar ([ISO/IEC-29500-4] раздел A.2), который является дочерним элементом CT_CfRule ([ISO/IEC-2]9500-4] section A.2), элемент, который является родительским элементом CT_ExtensionList ([ISO/IEC-29500-4] section A.2) с дочерним элементом CT_Extension ([ISO/IEC-29500-4] section A.2) с дочерним ST_Guid ([ISO/IEC-29500-4] раздел A.2) элемент, равный атрибуту id родительского элемента CT_CfRule этого сложного типа (раздел 2.6.27), эти CT_Cfvo элементы ДОЛЖНЫ<> игнорироваться. Первый дочерний элемент CT_Cfvo указывает условие , соответствующее минимальной длине панели данных. Второй дочерний элемент CT_Cfvo указывает условие, соответствующее максимальной длине панели данных.

Fillcolor: Элемент CT_Color ([ISO/IEC-29500-4], раздел A.2), указывающий цвет заливки панели данных. Этот элемент должен существовать только в том случае, если существует атрибут priorityCT_CfRule , который является родительским для этого сложного типа.

Bordercolor: Элемент CT_Color , указывающий цвет границы панели данных. Этот элемент ДОЛЖЕН существовать, если и только в том случае, если граница равна "true".

negativeFillColor: Элемент CT_Color , указывающий отрицательный цвет заливки панели данных. Этот элемент ДОЛЖЕН существовать, если и только в том случае, если значение negativeBarColorSameAsPositive равно false.

negativeBorderColor: Элемент CT_Color , указывающий отрицательный цвет границы панели данных. Этот элемент ДОЛЖЕН существовать, если и только в том случае, если значение negativeBarBorderColorSameAsPositive равно false, а граница — true.

axisColor: Элемент CT_Color , указывающий цвет оси панели данных. Этот элемент ДОЛЖЕН существовать, если и только в том случае , если axisPosition не равно "none".

Атрибуты:

minLength: Атрибут unsignedInt ([XMLSCHEMA2] section 3.3.22), указывающий длину самой короткой панели данных в этом диапазоне условного форматирования, выраженную в процентах от ширины ячейки, содержащей панель данных. Значение должно быть больше или равно нулю и меньше или равно maxLength. Если в этой же части листа существует элемент CT_ExtensionList , который является потомком CT_CfRule с дочерним элементом CT_Extension с дочерним элементом ST_Guid , равным атрибуту idэлемента CT_CfRule , который является родительским для этого элемента, а атрибут minLength этого элемента равен нулю ("0"), а атрибут maxLength этого элемента — "100", атрибут minLengthэлемента CT_DataBar , который является потомком элемента CT_CfRule , который является родительским элементом CT_ExtensionList элемента, который является родительским элементом CT_Extension с дочерним элементом ST_Guid , равным атрибуту idэлемента CT_CfRule , который является родительским элементом этого элемента, должен иметь значение "10". Если в этой же части листа существует элемент CT_ExtensionList , который является потомком CT_CfRule с дочерним элементом CT_Extension с дочерним элементом ST_Guid , равным атрибуту idэлемента CT_CfRule , который является родительским для этого элемента, а атрибут minLength этого элемента не равен нулю ("0") или атрибут maxLength этого элемента не является "100", Атрибут minLength элемента CT_DataBar , который является потомком элемента CT_CfRule , который является родительским элементом элемента CT_ExtensionList , который является родительским элементом CT_Extension с дочерним ST_Guid элементом, равным атрибуту idэлемента CT_CfRule , который является родительским элементом этого элемента, должен быть равен minLength этого сложного типа.

Maxlength: Атрибут unsignedInt , указывающий длину самой длинной панели данных в этом диапазоне условного форматирования, выраженную в процентах от ширины отформатируемой ячейки. Значение должно быть больше или равно minLength и меньше или равно 100. Если в этой же части листа существует элемент CT_ExtensionList , который является потомком CT_CfRule с дочерним элементом CT_Extension с дочерним элементом ST_Guid , равным атрибуту idэлемента CT_CfRule , который является родительским для этого элемента, а атрибут minLength этого элемента равен нулю ("0"), а атрибут maxLength этого элемента — "100", Атрибут maxLength элемента CT_DataBar , который является потомком элемента CT_CfRule , который является родительским элементом элемента CT_ExtensionList , который является родительским элементом CT_Extension с дочерним элементом ST_Guid элементом, равным атрибуту idэлемента CT_CfRule , который является родительским элементом этого элемента, должен иметь значение "90". Если в этой же части листа существует элемент CT_ExtensionList , который является потомком CT_CfRule с дочерним элементом CT_Extension с дочерним элементом ST_Guid , равным атрибуту idэлемента CT_CfRule , который является родительским для этого элемента, и атрибут minLength этого элемента не равен нулю ("0") или атрибут maxLength этого элемента не равен "100", Атрибут maxLength элемента CT_DataBar , который является потомком элемента CT_CfRule , который является родительским элементом CT_ExtensionList элемента, который является родительским элементом CT_Extension с дочерним элементом ST_Guid , равным атрибуту idэлемента CT_CfRule , который является родительским элементом этого элемента, должен быть равен maxLength этой записи.

showValue: Атрибут Boolean ([XMLSCHEMA2] section 3.2.2), указывающий, отображаются ли ячейки в диапазоне условного форматирования как панель данных, так и числовое значение или только панель данных. В следующей таблице описаны возможные значения.

Значение	Смысл
"false"	В ячейке отображается только панель данных.
"true"	В ячейке отображаются как панель данных, так и числовое значение.

Границы: Атрибут Boolean ([XMLSCHEMA2] section 3.2.2), указывающий, имеет ли панель данных границу.

Градиент: Атрибут Boolean ([XMLSCHEMA2] section 3.2.2), указывающий, имеет ли панель данных градиентную заливку. В следующей таблице описаны возможные значения.

Значение	Смысл
"false"	Заливка панели данных имеет сплошной цвет.
"true"	Заливка панели данных является градиентной.

Направление: Раздел атрибута ST_DataBarDirection 2.7.7), указывающий направление панели данных.

negativeBarColorSameAsPositive: Атрибут Boolean ([XMLSCHEMA2] section 3.2.2), указывающий, имеет ли панель данных отрицательный цвет полосы, отличный от цвета положительной полосы.

negativeBarBorderColorSameAsPositive: Атрибут Boolean ([XMLSCHEMA2] section 3.2.2), указывающий, имеет ли панель данных отрицательный цвет границы, отличный от цвета положительной границы.

axisPosition: Атрибут ST_DataBarAxisPosition (раздел 2.7.8), указывающий положение оси для панели данных.

Следующий фрагмент xml-схемы W3C ([XMLSCHEMA1] раздел 2.1) указывает содержимое этого сложного типа.

<xsd:complexType name="CT_DataBar">

<xsd:sequence>

<xsd:element name="cfvo" type="CT_Cfvo" minOccurs="2" maxOccurs="2"/>

<xsd:element name="fillColor" type="x:CT_Color" minOccurs="0" maxOccurs="1"/>

<xsd:element name="borderColor" type="x:CT_Color" minOccurs="0" maxOccurs="1"/>

<xsd:element name="negativeFillColor" type="x:CT_Color" minOccurs="0" maxOccurs="1"/>

<xsd:element name="negativeBorderColor" type="x:CT_Color" minOccurs="0" maxOccurs="1"/>

<xsd:element name="axisColor" type="x:CT_Color" minOccurs="0" maxOccurs="1"/>

</xsd:sequence>

<xsd:attribute name="minLength" type="xsd:unsignedInt" use="optional" default="10"/>

<xsd:attribute name="maxLength" type="xsd:unsignedInt" use="optional" default="90"/>

<xsd:attribute name="showValue" type="xsd:boolean" use="optional" default="true"/>

<xsd:attribute name="border" type="xsd:boolean" use="optional" default="false"/>

<xsd:attribute name="gradient" type="xsd:boolean" use="optional" default="true"/>

<xsd:attribute name="direction" type="ST_DataBarDirection" use="optional" default="context"/>

<xsd:attribute name="negativeBarColorSameAsPositive" type="xsd:boolean" use="optional" default="false"/>

<xsd:attribute name="negativeBarBorderColorSameAsPositive" type="xsd:boolean" use="optional" default="true"/>

<xsd:attribute name="axisPosition" type="ST_DataBarAxisPosition" use="optional" default="automatic"/>

</xsd:complexType>

Полная схема XML W3C см. в разделе 5.4 ([XMLSCHEMA1] раздел 2.1).

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

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

Свойства

AxisPosition	axisPosition, это свойство доступно только в Office 2010 и более поздних версиях. Представляет следующий атрибут в схеме: axisPosition
Border	border, это свойство доступно только в Office 2010 и более поздних версиях. Представляет следующий атрибут в схеме: border
ChildElements	Возвращает все дочерние узлы текущего элемента. (Унаследовано от OpenXmlElement)
Direction	направление, это свойство доступно только в Office 2010 и более поздних версиях. Представляет следующий атрибут в схеме: направление
ExtendedAttributes	Возвращает все расширенные атрибуты (атрибуты, не определенные в схеме) текущего элемента. (Унаследовано от OpenXmlElement)
Features	IFeatureCollection Возвращает для текущего элемента. Эта коллекция компонентов будет доступна только для чтения, но будет наследовать компоненты от родительской части и пакета, если они доступны. (Унаследовано от OpenXmlElement)
FirstChild	Получает первый дочерний элемент текущего элемента OpenXmlElement. (Унаследовано от OpenXmlCompositeElement)
Gradient	градиент. Это свойство доступно только в Office 2010 и более поздних версиях. Представляет следующий атрибут в схеме: градиент
HasAttributes	Возвращает значение, указывающее, имеет ли текущий элемент какие-либо атрибуты. (Унаследовано от OpenXmlElement)
HasChildren	Возвращает значение, указывающее, содержит ли текущий элемент какие-либо дочерние элементы. (Унаследовано от OpenXmlCompositeElement)
InnerText	Возвращает или задает объединенные значения текущего узла и всех его дочерних элементов. (Унаследовано от OpenXmlCompositeElement)
InnerXml	Возвращает или задает разметку, представляющую только дочерние узлы текущего узла. (Унаследовано от OpenXmlCompositeElement)
LastChild	Возвращает последний дочерний элемент текущего элемента OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если такого элемента OpenXmlElement нет. (Унаследовано от OpenXmlCompositeElement)
LocalName	Возвращает локальное имя текущего элемента. (Унаследовано от OpenXmlElement)
MaxLength	maxLength, это свойство доступно только в Office 2010 и более поздних версиях. Представляет следующий атрибут в схеме: maxLength
MCAttributes	Возвращает или задает атрибуты совместимости разметки. Возвращает значение NULL, если для текущего элемента не определены атрибуты совместимости разметки. (Унаследовано от OpenXmlElement)
MinLength	minLength, это свойство доступно только в Office 2010 и более поздних версиях. Представляет следующий атрибут в схеме: minLength
NamespaceDeclarations	Возвращает все объявления пространства имен, определенные в текущем элементе. Возвращает пустой перечислитель, если нет объявления пространства имен. (Унаследовано от OpenXmlElement)
NamespaceUri	Возвращает универсальный код ресурса (URI) пространства имен текущего элемента. (Унаследовано от OpenXmlElement)
NegativeBarBorderColorSameAsPositive	negativeBarBorderColorSameAsPositive, это свойство доступно только в Office 2010 и более поздних версиях. Представляет следующий атрибут в схеме: negativeBarBorderColorSameAsPositive
NegativeBarColorSameAsPositive	negativeBarColorSameAsPositive, это свойство доступно только в Office 2010 и более поздних версиях. Представляет следующий атрибут в схеме: negativeBarColorSameAsPositive
OpenXmlElementContext	Возвращает openXmlElementContext текущего элемента. (Унаследовано от OpenXmlElement)
OuterXml	Возвращает разметку, представляющую текущий элемент и все его дочерние элементы. (Унаследовано от OpenXmlElement)
Parent	Возвращает родительский элемент текущего элемента. (Унаследовано от OpenXmlElement)
Prefix	Возвращает префикс пространства имен текущего элемента. (Унаследовано от OpenXmlElement)
ShowValue	showValue— это свойство доступно только в Office 2010 и более поздних версиях. Представляет следующий атрибут в схеме: showValue
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()	Определяет класс DataBar. Этот класс доступен в Office 2010 и более поздних версиях. Когда объект сериализуется как xml, его полное имя — x14:dataBar. (Унаследовано от OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Возвращает перечислитель, который выполняет итерацию по дочерней коллекции. (Унаследовано от OpenXmlElement)