DataBar Classe

Definição

Namespace:

DocumentFormat.OpenXml.Office2010.Excel

Assembly:

DocumentFormat.OpenXml.dll

Pacote:

DocumentFormat.OpenXml v3.0.1

Define a Classe DataBar.

Esta classe está disponível no Office 2010 e superior.

Quando o objeto é serializado como xml, o nome qualificado é x14:dataBar.

public class DataBar : DocumentFormat.OpenXml.OpenXmlCompositeElement

type DataBar = class
    inherit OpenXmlCompositeElement

Public Class DataBar
Inherits OpenXmlCompositeElement

Herança

Object

OpenXmlElement

OpenXmlCompositeElement

DataBar

Comentários

2.6.30 CT_DataBar

Espaço de nomes de destino:http://schemas.microsoft.com/office/spreadsheetml/2009/9/main

Referenciado por: CT_CfRule

Um tipo complexo que especifica uma barra de dados utilizada na formatação condicional.

Elementos Subordinados:

cfvo: Um elemento CT_Cfvo (secção 2.6.26) que especifica os valores das células correspondentes ao comprimento mínimo/máximo da barra de dados. Se existir CT_Cfvo ([ISO/IEC-29500-4] elementos da secção A.2) nesta folha (1) que são elementos subordinados de um CT_DataBar ([ISO/IEC-29500-4] elemento A.2) subordinado de um CT_CfRule ([ISO/IEC-4] Elemento da secção A.2] da secção 29500-4) que é um elemento principal de um CT_ExtensionList (elemento da secção A.2[ISO/IEC-29500-4] com um elemento subordinado CT_Extension ([ISO/IEC-29500-4] secção A.2) que tem um elemento subordinado ST_Guid ([ISO/IEC-29500-4] secção A.2) elemento igual ao atributo ID do elemento principal CT_CfRule deste tipo complexo (secção 2.6.27), esses elementos CT_Cfvo DEVEM<49> ser ignorados. O primeiro elemento subordinado CT_Cfvo especifica a condição correspondente ao comprimento mínimo da barra de dados. O segundo elemento subordinado CT_Cfvo especifica a condição correspondente ao comprimento máximo da barra de dados.

fillColor: Um elemento CT_Color ([ISO/IEC-29500-4] da secção A.2) que especifica a cor de preenchimento da barra de dados. Este elemento TEM de existir se e apenas se o atributo de prioridade do CT_CfRule que é um elemento principal deste tipo complexo existir.

borderColor: Um elemento CT_Color que especifica a cor do limite da barra de dados. Este elemento TEM de existir se e apenas se o limite for igual a "verdadeiro".

negativeFillColor: Um elemento CT_Color que especifica a cor de preenchimento negativa da barra de dados. Este elemento TEM de existir se e apenas se negativeBarColorSameAsPositive for igual a "false".

negativeBorderColor: Um elemento CT_Color que especifica a cor do limite negativo da barra de dados. Este elemento TEM de existir se e apenas se negativeBarBorderColorSameAsPositive for igual a "falso" e limite for igual a "verdadeiro".

eixoColor: Um elemento CT_Color que especifica a cor do eixo da barra de dados. Este elemento TEM de existir se e apenas se axisPosition não for igual a "none".

Atributos:

minLength: Um atributo unsignedInt ([XMLSCHEMA2] secção 3.3.22) que especifica o comprimento da barra de dados mais curta neste intervalo de formatação condicional, expresso como uma percentagem da largura da célula que contém a barra de dados. TEM de ser maior ou igual a zero e menor ou igual a maxLength. Se, nesta mesma parte da folha de cálculo, existir um elemento CT_ExtensionList descendente de um CT_CfRule com um elemento subordinado CT_Extension com o elemento subordinado ST_Guid igual ao atributo ID do elemento CT_CfRule que é um elemento principal deste elemento e o atributo minLength deste elemento for zero ("0") e o atributo maxLength deste elemento for "100", o atributo minLength do elemento CT_DataBar que é um descendente do elemento CT_CfRule que é um elemento principal do elemento CT_ExtensionList que é um elemento principal do elemento CT_Extension com o elemento ST_Guid subordinado igual ao atributo ID do elemento CT_CfRule que é um elemento principal deste elemento TEM de ser "10". Se nesta mesma parte da folha de cálculo existir um elemento CT_ExtensionList descendente de um CT_CfRule com um elemento subordinado CT_Extension com o elemento subordinado ST_Guid igual ao atributo ID do elemento CT_CfRule que é um elemento principal deste elemento, e o atributo minLength deste elemento não é zero ("0") ou o atributo maxLength deste elemento não é "100", o atributo minLength do elemento CT_DataBar que é um descendente do elemento CT_CfRule que é um elemento principal do elemento CT_ExtensionList que é um elemento principal do elemento CT_Extension com o elemento ST_Guid subordinado que é igual ao atributo ID do elemento CT_CfRule que é um elemento principal deste elemento TEM de ser igual ao minLength deste tipo complexo.

maxLength: Um atributo unsignedInt que especifica o comprimento da barra de dados mais longa neste intervalo de formatação condicional, expresso como uma percentagem da largura da célula que está a ser formatada. TEM de ser maior ou igual a minLength e menor ou igual a 100. Se nesta mesma parte da folha de cálculo existir um elemento CT_ExtensionList descendente de um CT_CfRule com um elemento subordinado CT_Extension com o elemento subordinado ST_Guid igual ao atributo ID do elemento CT_CfRule que é um elemento principal deste elemento, e o atributo minLength deste elemento é zero ("0") e o atributo maxLength deste elemento é "100", o atributo maxLength do elemento CT_DataBar que é descendente do elemento CT_CfRule que é um elemento principal do elemento CT_ExtensionList que é um elemento principal do elemento CT_Extension com o elemento ST_Guid subordinado que é igual ao atributo ID do elemento CT_CfRule que é um elemento principal deste elemento TEM de ser "90". Se, nesta mesma parte da folha de cálculo, existir um elemento CT_ExtensionList descendente de um CT_CfRule com um elemento subordinado CT_Extension com o elemento subordinado ST_Guid igual ao atributo ID do elemento CT_CfRule que é um elemento principal deste elemento, e o atributo minLength deste elemento não é zero ("0") ou o atributo maxLength deste elemento não é "100", o atributo maxLength do elemento CT_DataBar que é descendente do elemento CT_CfRule que é um elemento principal do elemento CT_ExtensionList que é um elemento principal do elemento CT_Extension com o elemento ST_Guid subordinado que é igual ao atributo ID do elemento CT_CfRule que é um elemento principal deste elemento TEM de ser igual ao maxLength deste registo.

showValue: Um atributo Booleano ([XMLSCHEMA2] secção 3.2.2) que especifica se as células no intervalo de formatação condicional apresentam a barra de dados e o valor numérico ou apenas a barra de dados. A tabela seguinte descreve os respetivos valores possíveis.

Valor	Significado
"falso"	Apenas a barra de dados é apresentada na célula.
"verdadeiro"	Tanto a barra de dados como o valor numérico são apresentados na célula.

limite: Um atributo Booleano ([XMLSCHEMA2] secção 3.2.2) que especifica se a barra de dados tem um limite.

gradação: Um atributo Booleano ([XMLSCHEMA2] secção 3.2.2) que especifica se a barra de dados tem um preenchimento com gradação. A tabela seguinte descreve os respetivos valores possíveis.

Valor	Significado
"falso"	O preenchimento da barra de dados é uma cor sólida.
"verdadeiro"	O preenchimento da barra de dados é uma gradação.

direção: Uma ST_DataBarDirection secção de atributos 2.7.7) que especifica a direção da barra de dados.

negativeBarColorSameAsPositive: Um atributo Booleano ([XMLSCHEMA2] secção 3.2.2) que especifica se a barra de dados tem uma cor de barra negativa diferente da cor da barra positiva.

negativeBarBorderColorSameAsPositive: Um atributo Booleano ([XMLSCHEMA2] secção 3.2.2) que especifica se a barra de dados tem uma cor de limite negativa diferente da cor de limite positiva.

axisPosition: Um atributo ST_DataBarAxisPosition (secção 2.7.8) que especifica a posição do eixo da barra de dados.

O seguinte fragmento de Esquema XML W3C ([XMLSCHEMA1] secção 2.1) especifica os conteúdos deste tipo complexo.

<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>

Veja a secção 5.4 para obter o Esquema W3C XML completo ([XMLSCHEMA1] secção 2.1).

Construtores

DataBar()	Inicializa uma nova instância da classe DataBar.
DataBar(IEnumerable<OpenXmlElement>)	Inicializa uma nova instância da classe DataBar com os elementos subordinados especificados.
DataBar(OpenXmlElement[])	Inicializa uma nova instância da classe DataBar com os elementos subordinados especificados.
DataBar(String)	Inicializa uma nova instância da classe DataBar a partir de XML externo.

Propriedades

AxisPosition	axisPosition, esta propriedade só está disponível no Office 2010 e posterior. Representa o seguinte atributo no esquema: axisPosition
Border	limite, esta propriedade só está disponível no Office 2010 e posterior. Representa o seguinte atributo no esquema: limite
ChildElements	Obtém todos os nós subordinados do elemento atual. (Herdado de OpenXmlElement)
Direction	direção, esta propriedade só está disponível no Office 2010 e posterior. Representa o seguinte atributo no esquema: direção
ExtendedAttributes	Obtém todos os atributos expandidos (atributos não definidos no esquema) do elemento atual. (Herdado de OpenXmlElement)
Features	Obtém um IFeatureCollection para o elemento atual. Esta coleção de funcionalidades será só de leitura, mas herdará as funcionalidades da parte principal e do pacote, se disponível. (Herdado de OpenXmlElement)
FirstChild	Obtém o primeiro elemento subordinado do elemento OpenXmlElement atual. (Herdado de OpenXmlCompositeElement)
Gradient	gradação, esta propriedade só está disponível no Office 2010 e posterior. Representa o seguinte atributo no esquema: gradação
HasAttributes	Obtém um valor que indica se o elemento atual tem atributos. (Herdado de OpenXmlElement)
HasChildren	Obtém um valor que indica se o elemento atual tem elementos subordinados. (Herdado de OpenXmlCompositeElement)
InnerText	Obtém ou define os valores concatenados do nó atual e de todos os respetivos subordinados. (Herdado de OpenXmlCompositeElement)
InnerXml	Obtém ou define a marcação que representa apenas os nós subordinados do nó atual. (Herdado de OpenXmlCompositeElement)
LastChild	Obtém o último elemento subordinado do elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir esse elemento OpenXmlElement. (Herdado de OpenXmlCompositeElement)
LocalName	Obtém o nome local do elemento atual. (Herdado de OpenXmlElement)
MaxLength	maxLength, esta propriedade só está disponível no Office 2010 e posterior. Representa o seguinte atributo no esquema: maxLength
MCAttributes	Obtém ou define os atributos de compatibilidade de markup. Devolve nulo se não forem definidos atributos de compatibilidade de markup para o elemento atual. (Herdado de OpenXmlElement)
MinLength	minLength, esta propriedade só está disponível no Office 2010 e posterior. Representa o seguinte atributo no esquema: minLength
NamespaceDeclarations	Obtém todas as declarações de espaço de nomes definidas no elemento atual. Devolve um enumerador vazio se não existir nenhuma declaração de espaço de nomes. (Herdado de OpenXmlElement)
NamespaceUri	Obtém o URI do espaço de nomes do elemento atual. (Herdado de OpenXmlElement)
NegativeBarBorderColorSameAsPositive	negativeBarBorderColorSameAsPositive, esta propriedade só está disponível no Office 2010 e posterior. Representa o seguinte atributo no esquema: negativeBarBorderColorSameAsPositive
NegativeBarColorSameAsPositive	negativeBarColorSameAsPositive, esta propriedade só está disponível no Office 2010 e posterior. Representa o seguinte atributo no esquema: negativeBarColorSameAsPositive
OpenXmlElementContext	Obtém o OpenXmlElementContext do elemento atual. (Herdado de OpenXmlElement)
OuterXml	Obtém a marcação que representa o elemento atual e todos os respetivos elementos subordinados. (Herdado de OpenXmlElement)
Parent	Obtém o elemento principal do elemento atual. (Herdado de OpenXmlElement)
Prefix	Obtém o prefixo de espaço de nomes do elemento atual. (Herdado de OpenXmlElement)
ShowValue	showValue, esta propriedade só está disponível no Office 2010 e posterior. Representa o seguinte atributo no esquema: showValue
XmlQualifiedName	Obtém o nome qualificado do elemento atual. (Herdado de OpenXmlElement)
XName	Obtém o nome qualificado do elemento atual. (Herdado de OpenXmlElement)

Métodos

AddAnnotation(Object)	Adiciona um objeto à lista de anotações do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
AddChild(OpenXmlElement, Boolean)	Adiciona o elemento especificado ao elemento se for um subordinado conhecido. Esta ação adiciona o elemento na localização correta de acordo com o esquema. (Herdado de OpenXmlCompositeElement)
AddNamespaceDeclaration(String, String)	Adiciona uma declaração de espaço de nomes ao nó atual. (Herdado de OpenXmlElement)
Ancestors()	Enumera todos os predecessores do elemento atual. (Herdado de OpenXmlElement)
Ancestors<T>()	Enumera apenas os predecessores do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement)
Annotation(Type)	Obtenha o primeiro objeto de anotação do tipo especificado a partir do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Annotation<T>()	Obtenha o primeiro objeto de anotação do tipo especificado a partir do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Annotations(Type)	Obtém uma coleção de anotações com o tipo especificado para o elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Annotations<T>()	Obtém uma coleção de anotações com o tipo especificado para o elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	Acrescenta cada elemento de uma lista de elementos ao fim da lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement)
Append(OpenXmlElement[])	Acrescenta cada elemento de uma matriz de elementos ao fim da lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement)
AppendChild<T>(T)	Acrescenta o elemento especificado ao fim da lista de nós subordinados do elemento atual. (Herdado de OpenXmlCompositeElement)
ClearAllAttributes()	Limpa todos os atributos, incluindo atributos conhecidos e atributos expandidos. (Herdado de OpenXmlElement)
Clone()	Cria um duplicado do nó atual. (Herdado de OpenXmlElement)
CloneNode(Boolean)	Cria um duplicado deste nó.
Descendants()	Enumera todos os descendentes do elemento atual. (Herdado de OpenXmlElement)
Descendants<T>()	Enumerar todos os descendentes do elemento atual do tipo T. (Herdado de OpenXmlElement)
Elements()	Enumera todos os elementos subordinados do elemento atual. (Herdado de OpenXmlElement)
Elements<T>()	Enumera apenas os subordinados do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement)
ElementsAfter()	Enumera todos os elementos do elemento colateral que seguem o elemento atual e têm o mesmo elemento principal que o elemento atual. (Herdado de OpenXmlElement)
ElementsBefore()	Enumera todos os elementos do elemento colateral que precedem o elemento atual e têm o mesmo elemento principal que o elemento atual. (Herdado de OpenXmlElement)
GetAttribute(String, String)	Obtém um atributo Open XML com o nome da etiqueta especificado e o URI do espaço de nomes. (Herdado de OpenXmlElement)
GetAttributes()	Obtém uma lista que contém uma cópia de todos os atributos. (Herdado de OpenXmlElement)
GetEnumerator()	Devolve um enumerador que itera através da coleção subordinada. (Herdado de OpenXmlElement)
GetFirstChild<T>()	Localiza o primeiro elemento subordinado no tipo T. (Herdado de OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	Insere o elemento especificado imediatamente após o elemento de referência especificado. (Herdado de OpenXmlCompositeElement)
InsertAfterSelf<T>(T)	Insere o elemento especificado imediatamente após o elemento atual. (Herdado de OpenXmlElement)
InsertAt<T>(T, Int32)	Insere o elemento especificado no índice especificado dos subordinados do elemento atual. (Herdado de OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)	Insere o elemento especificado imediatamente antes do elemento de referência especificado. (Herdado de OpenXmlCompositeElement)
InsertBeforeSelf<T>(T)	Insere o elemento especificado imediatamente antes do elemento atual. (Herdado de OpenXmlElement)
IsAfter(OpenXmlElement)	Determina se o elemento atual aparece depois de um elemento especificado na ordem do documento. (Herdado de OpenXmlElement)
IsBefore(OpenXmlElement)	Determina se o elemento atual aparece antes de um elemento especificado na ordem do documento. (Herdado de OpenXmlElement)
LookupNamespace(String)	Resolve o prefixo do espaço de nomes no contexto do nó atual. (Herdado de OpenXmlElement)
LookupPrefix(String)	Localiza o prefixo correspondente para um URI de espaço de nomes no âmbito do elemento atual. (Herdado de OpenXmlElement)
NextSibling()	Obtém o elemento OpenXmlElement que segue imediatamente o elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir nenhum elemento OpenXmlElement seguinte. (Herdado de OpenXmlElement)
NextSibling<T>()	Obtém o elemento OpenXmlElement com o tipo especificado que segue o elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir um OpenXmlElement seguinte. (Herdado de OpenXmlElement)
PrependChild<T>(T)	Insere o elemento especificado no início da lista de nós subordinados do elemento atual. (Herdado de OpenXmlCompositeElement)
PreviousSibling()	Obtém o elemento OpenXmlElement que precede imediatamente o elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement)
PreviousSibling<T>()	Obtém o elemento OpenXmlElement com o tipo especificado que precede o OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement)
Remove()	Remove o elemento atual do respetivo elemento principal. (Herdado de OpenXmlElement)
RemoveAllChildren()	Remove todos os elementos subordinados do elemento atual. (Herdado de OpenXmlCompositeElement)
RemoveAllChildren<T>()	Remova todos os elementos subordinados do elemento atual que são do tipo T. (Herdado de OpenXmlElement)
RemoveAnnotations(Type)	Remove as anotações do tipo especificado do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
RemoveAnnotations<T>()	Remove as anotações com o tipo especificado do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
RemoveAttribute(String, String)	Remove o atributo do elemento atual. (Herdado de OpenXmlElement)
RemoveChild<T>(T)	Remove o elemento subordinado especificado. (Herdado de OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)	Remove a declaração de espaço de nomes para o prefixo especificado. Não remove nada se não existir um prefixo. (Herdado de OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Substitui um dos elementos subordinados do elemento atual por outro elemento OpenXmlElement. (Herdado de OpenXmlCompositeElement)
SetAttribute(OpenXmlAttribute)	Define um atributo para o elemento especificado. Se o atributo for um atributo conhecido, o valor do atributo é definido. Se o atributo for um atributo expandido, o "openxmlAttribute" é adicionado à lista de atributos expandidos. (Herdado de OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Define vários atributos para o elemento . Se um atributo for um atributo conhecido, o valor do atributo é definido. Se um atributo for um atributo expandido, o "openxmlAttribute" é adicionado à lista de atributos expandidos. (Herdado de OpenXmlElement)
WriteTo(XmlWriter)	Guarda o nó atual no XmlWriter especificado. (Herdado de OpenXmlElement)

Implantações explícitas de interface

IEnumerable.GetEnumerator()	Define a Classe DataBar. Esta classe está disponível no Office 2010 e superior. Quando o objeto é serializado como xml, o nome qualificado é x14:dataBar. (Herdado de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Devolve um enumerador que itera através da coleção subordinada. (Herdado de OpenXmlElement)