TopBorder Classe

Definição

Namespace:

DocumentFormat.OpenXml.Wordprocessing

Assembly:

DocumentFormat.OpenXml.dll

Pacote:

DocumentFormat.OpenXml v3.0.1

Borda do parágrafo acima de parágrafos idênticos.

Essa classe está disponível no Office 2007 e superior.

Quando o objeto é serializado como xml, seu nome qualificado é w:top.

public class TopBorder : DocumentFormat.OpenXml.Wordprocessing.BorderType

type TopBorder = class
    inherit BorderType

Public Class TopBorder
Inherits BorderType

Herança

Object

OpenXmlElement

OpenXmlLeafElement

BorderType

TopBorder

Comentários

[ISO/IEC 29500-1 1st Edition]

top (Paragraph Border Above Identical Paragraphs)

Esse elemento especifica a borda que deve ser exibida acima de um conjunto de parágrafos que têm o mesmo conjunto de configurações de borda de parágrafo.

Para determinar se dois parágrafos adjacentes devem ter uma borda superior e inferior individual ou uma entre bordas, o conjunto de bordas nos dois parágrafos adjacentes é comparado. Se as informações de borda nesses dois parágrafos forem idênticas a todas as bordas de parágrafos possíveis, a borda entre elas será exibida. Caso contrário, o parágrafo final usará sua borda inferior e o parágrafo a seguir usará sua borda superior, respectivamente. Se essa borda especificar um atributo de espaço, esse valor determinará o espaço acima do texto (ignorando qualquer espaçamento acima) que deve ser deixado antes que essa borda seja desenhada, especificada em pontos.

Se esse elemento for omitido em um determinado parágrafo, seu valor será determinado pela configuração definida anteriormente em qualquer nível da hierarquia de estilo (ou seja, essa configuração anterior permanece inalterada). Se essa configuração nunca for especificada na hierarquia de estilo, nenhuma entre bordas será aplicada acima de parágrafos idênticos.

[Exemplo: considere a definição wordprocessingML dos dois parágrafos a seguir:

<w:p>  
  <w:pPr>  
    <w:pBdr>  
      <w:top w:val="single" w:sz="24" w:space="1" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" />   
      <w:left w:val="single" w:sz="24" w:space="4" w:color="B97034" w:themeColor="accent6" w:themeShade="BF" />   
      <w:bottom w:val="single" w:sz="24" w:space="1" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" />   
      <w:right w:val="single" w:sz="24" w:space="4" w:color="C3D69B" w:themeColor="accent3" w:themeTint="99" />   
      <w:between w:val="single" w:sz="24" w:space="1" w:color="4F81BD" w:themeColor="accent1" />   
    </w:pBdr>  
  </w:pPr>  
  <w:r>  
    <w:t>First paragraph.</w:t>   
  </w:r>  
</w:p>  
<w:p>  
  <w:pPr>  
    <w:pBdr>  
      <w:top w:val="single" w:sz="24" w:space="1" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" />   
      <w:left w:val="single" w:sz="24" w:space="4" w:color="B97034" w:themeColor="accent6" w:themeShade="BF" />   
      <w:bottom w:val="single" w:sz="24" w:space="0" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" />   
      <w:right w:val="single" w:sz="24" w:space="4" w:color="C3D69B" w:themeColor="accent3" w:themeTint="99" />   
      <w:between w:val="single" w:sz="24" w:space="1" w:color="4F81BD" w:themeColor="accent1" />   
    </w:pBdr>  
  </w:pPr>  
  <w:r>  
    <w:t>Second paragraph.</w:t>   
  </w:r>  
</w:p>  

Como a borda do parágrafo é diferente entre os dois parágrafos (o valor de espaço inferior vai de 1 a 0), o parágrafo dois usa sua borda superior, que está localizada um ponto acima do texto nesse parágrafo. exemplo final]

Elementos pai
pBdr (§17.3.1.24)

O modelo de conteúdo desse elemento é definido pela definição de propriedades de borda comuns em §17.3.4.

[ISO/IEC 29500-1 1st Edition]

top (Table Cell Top Border)

Esse elemento especifica a borda que deve ser exibida na parte superior da célula de tabela atual. A aparência dessa borda de célula de tabela no documento deve ser determinada pelas seguintes configurações:

• Se o valor do elemento net tblCellSpacing (§17.4.45;§17.4.44;§17.4.46) aplicado à célula não for zero, a borda da célula sempre será exibida

• Caso contrário, a exibição da borda está sujeita ao algoritmo de resolução de conflito definido pelo elemento tcBorders (§17.4.67) e pelo elemento tblBorders (§17.4.40;§17.4.39)

Se esse elemento for omitido, a parte superior dessa célula de tabela não terá uma borda celular e sua borda poderá usar as configurações de borda da tabela conforme apropriado.

[Exemplo: considere uma tabela na qual a primeira célula na primeira linha especifica uma borda de célula superior , da seguinte maneira:

R1C1

R1C2

R2C1

R2C2

Essa borda de célula superior é especificada usando o seguinte WordprocessingML:

<w:tc>  
  <w:tcPr>  
    …    <w:tcBorders>  
      <w:top w:val="thinThickThinSmallGap" w:sz="24" w:space="0" w:color="FF0000"/>  
    </w:tcBorders>  
  </w:tcPr>  
  <w:p/>  
</w:tc>  

O elemento superior especifica uma borda de três pontos do tipo thinThinThickSmallGap. exemplo final]

Elementos pai
tcBorders (§17.4.67)

O modelo de conteúdo desse elemento é definido pela definição de propriedades de borda comuns em §17.3.4.

[ISO/IEC 29500-1 1st Edition]

top (Table Top Border)

Esse elemento especifica a borda que deve ser exibida na parte superior da tabela atual. A aparência desta borda da tabela no documento deve ser determinada pelas seguintes configurações:

• A exibição da borda está sujeita ao algoritmo de resolução de conflito definido pelo elemento tcBorders (§17.4.67) e pelo elemento tblBorders (§17.4.40;§17.4.39)

Se esse elemento for omitido, a parte superior desta tabela terá a borda especificada pelo estilo de tabela associado. Se nenhuma borda superior for especificada na hierarquia de estilo, essa tabela não terá uma borda superior.

[Exemplo: considere uma tabela na qual as propriedades da tabela especificam uma borda superior da tabela, da seguinte maneira:

R1C1

R1C2

R2C1

R2C2

Esta borda da tabela superior é especificada usando o seguinte WordprocessingML:

<w:tbl>  
  <w:tblPr>  
    <w:tblBorders>  
      <w:top w:val="thinThickThinMediumGap" w:sz="24" w:space="0" w:color="D0D0D0" w:themeColor="accent3" w:themeTint="99"/>  
    </w:tblBorders>  
  </w:tblPr>  
  …</w:tbl>  

O elemento superior especifica uma borda de tabela superior de três pontos do tipo thinThinThickMediumGap. exemplo final].

Elementos pai
tblBorders (§17.4.39); tblBorders (§17.4.40)

O modelo de conteúdo desse elemento é definido pela definição de propriedades de borda comuns em §17.3.4.

[ISO/IEC 29500-1 1st Edition]

top (Top Border)

Esse elemento especifica a apresentação e a exibição da borda da página exibida na parte superior de cada página nesta seção.

[Exemplo: considere uma seção na qual todas as páginas devem ter uma borda superior que consista em uma imagem repetida de balões, assim:

5cba059f-89ed-4087-86ae-32fc8ff26a57

Essa borda resultaria no seguinte WordprocessingML:

<w:sectPr>  
  …  <w:pgBorders>  
    <w:top w:val="balloons3Colors" …/>  
  </w:pgBorders>  
  …</w:sectPr>  

Como a página só tem uma borda na parte superior, apenas o elemento superior é especificado dentro do conjunto de bordas de página. exemplo final]

Quando um documento tem uma borda superior relativa às bordas da página (usando um valor de atributo offsetFrom da página em pgBorders), ele deverá abranger a borda superior da página no local definido por suas propriedades, parando quando:

• Ele se cruza com a borda correspondente da página esquerda ou direita (se um for especificado)

• Ele atinge a borda da página.

[Exemplo: no exemplo acima, nenhuma borda esquerda ou direita foi especificada no WordprocessingML, portanto, um consumidor deve desenhar a borda de uma borda da página para a outra. exemplo final]

Quando um documento tiver uma borda superior relativa ao texto (usando o valor de atributo offsetFrom do texto em pgBorders), ele só deverá abranger a largura necessária para atender ao requisito de abranger a largura do texto.

Quando um documento tiver a arte de borda personalizada especificada pelos atributos topLeft, topRight e/ou id, ele deverá usar o item de parte de relação correspondente como uma imagem para o canto superior esquerdo, canto superior direito e/ou borda superior, respectivamente. Se o item da parte de relação correspondente não puder ser resolvido, o consumidor usará a borda especificada pelo valor do atributo val. Se o valor correspondente do atributo val não puder ser resolvido, nenhum canto superior esquerdo, canto superior direito ou borda superior estará presente quando a página é exibida.

Quando um documento tem uma arte de borda personalizada especificada pela id de atributo sem especificar atributos topRight e/ou topLeft, a borda superior conforme resolvida pelo item da parte de relação correspondente da id de atributo deve abranger até os cantos não especificados por atributos topRight e/ou topLeft.

Elementos pai
pgBorders (§17.6.10)

[Observação: a definição de esquema XML W3C do modelo de conteúdo desse elemento (CT_TopPageBorder) está localizada em §A.1. nota final]

[ISO/IEC 29500-1 1st Edition]

top (Top Border for HTML div)

Esse elemento especifica a borda que deve ser exibida na parte superior dos limites do objeto html div atual.

Se esse elemento for omitido, esse objeto div HTML não terá uma borda superior.

[Exemplo: considere um documento HTML simples definido da seguinte maneira:

<html>  
  <body>  
    <div style=" border-left-style:solid; border-right-style:groove; border-right-width:1px; border-top-style:dashed; border-top-width:3px; border-bottom-style:outset; border-bottom-width:3px">  
      <p>paragraph of text</p>  
    </div>  
  </body>  
</html>  

Esse HTML normalmente apareceria da seguinte maneira (imagem dimensionada adequadamente):

80f86de9-0ded-4cb3-8002-c4d4140efec0

Agora, quando este documento é salvo no formato WordprocessingML, as informações armazenadas nos elementos div são armazenadas na parte de configuração da Web da seguinte maneira:

<w:divs>  
  <w:div w:id="1785730240">  
    …    <w:divBdr>  
      <w:top w:val="dashed" w:sz="18" w:space="7" w:color="auto" />  
      <w:left w:val="single" w:sz="24" w:space="4" w:color="auto" />  
      <w:bottom w:val="outset" w:sz="18" w:color="auto" />  
      <w:right w:val="threeDEngrave" w:sz="6" w:color="auto" />  
    </w:divBdr>  
  </w:div>  
</w:divs>  

O elemento superior especifica informações de borda sobre a borda superior para a estrutura de div HTML única no documento; nesse caso, uma borda inferior de 2,25 pontos do tipo traçou. A borda inicial de 3 pixels foi convertida em 2,25 pontos usando a seguinte lógica:

exemplo final]

Elementos pai
divBdr (§17.15.2.7)

O modelo de conteúdo desse elemento é definido pela definição de propriedades de borda comuns em §17.3.4.

ISO/IEC29500: 2008.

Construtores

TopBorder()

Inicializa uma nova instância da classe TopBorder.

Propriedades

ChildElements	Obtém todos os nós filho do elemento atual. (Herdado de OpenXmlElement)
Color	Cor da borda Representa o seguinte atributo no esquema: w:color (Herdado de BorderType)
ExtendedAttributes	Obtém todos os atributos estendidos (atributos não definidos no esquema) do elemento atual. (Herdado de OpenXmlElement)
Features	Obtém um IFeatureCollection para o elemento atual. Essa coleção de recursos será somente leitura, mas herdará recursos de sua parte pai e pacote, se disponível. (Herdado de OpenXmlElement)
FirstChild	Obtém o primeiro filho do elemento OpenXmlElement. Retornará nulo (Nada no Visual Basic) se não houver esse elemento OpenXmlElement. (Herdado de OpenXmlElement)
Frame	Criar efeito frame Representa o seguinte atributo no esquema: w:frame (Herdado de BorderType)
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 filho. (Herdado de OpenXmlLeafElement)
InnerText	Obtém ou define os valores concatenados do nó e de todos os seus filhos. (Herdado de OpenXmlElement)
InnerXml	Obtém ou define a marcação que representa apenas elementos filho do elemento atual. (Herdado de OpenXmlLeafElement)
LastChild	Obtém o último filho do elemento OpenXmlElement. Retornará nulo (Nada no Visual Basic) se não houver esse elemento OpenXmlElement. (Herdado de OpenXmlElement)
LocalName	Obtém o nome local do elemento atual. (Herdado de OpenXmlElement)
MCAttributes	Obtém ou define os atributos de compatibilidade de marcação. Retorna nulo se nenhum atributo de compatibilidade de marcação for definido para o elemento atual. (Herdado de OpenXmlElement)
NamespaceDeclarations	Obtém todas as declarações de namespace definidas no elemento atual. Retornará um enumerador vazio se não houver nenhuma declaração de namespace. (Herdado de OpenXmlElement)
NamespaceUri	Obtém o URI do namespace do elemento atual. (Herdado de OpenXmlElement)
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 seus elementos filho. (Herdado de OpenXmlElement)
Parent	Obtém o elemento pai do elemento atual. (Herdado de OpenXmlElement)
Prefix	Obtém o prefixo namespace do elemento atual. (Herdado de OpenXmlElement)
Shadow	Sombra de Borda Representa o seguinte atributo no esquema: w:shadow (Herdado de BorderType)
Size	Largura da borda Representa o seguinte atributo no esquema: w:sz (Herdado de BorderType)
Space	Medida de espaçamento de borda Representa o seguinte atributo no esquema: w:space (Herdado de BorderType)
ThemeColor	Cor do tema border Representa o seguinte atributo no esquema: w:themeColor (Herdado de BorderType)
ThemeShade	Sombra de cor do tema border Representa o seguinte atributo no esquema: w:themeShade (Herdado de BorderType)
ThemeTint	Tonalidade de cor do tema de borda Representa o seguinte atributo no esquema: w:themeTint (Herdado de BorderType)
Val	Estilo Border Representa o seguinte atributo no esquema: w:val (Herdado de BorderType)
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)
AddNamespaceDeclaration(String, String)	Adiciona uma declaração de namespace ao nó atual. (Herdado de OpenXmlElement)
Ancestors()	Enumera todos os ancestrais do elemento atual. (Herdado de OpenXmlElement)
Ancestors<T>()	Enumera apenas os ancestrais do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement)
Annotation(Type)	Obtenha o primeiro objeto de anotação do tipo especificado do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Annotation<T>()	Obtenha o primeiro objeto de anotação do tipo especificado 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 final da lista de elementos filho do elemento atual. (Herdado de OpenXmlElement)
Append(OpenXmlElement[])	Acrescenta cada elemento de uma matriz de elementos até o final da lista de elementos filho do elemento atual. (Herdado de OpenXmlElement)
AppendChild<T>(T)	Acrescenta o elemento especificado ao final da lista de nós filho do elemento atual. (Herdado de OpenXmlElement)
ClearAllAttributes()	Limpa todos os atributos, incluindo atributos conhecidos e atributos estendidos. (Herdado de OpenXmlElement)
Clone()	Cria uma duplicata do nó atual. (Herdado de OpenXmlElement)
CloneNode(Boolean)	Cria uma duplicata desse nó.
Descendants()	Enumera todos os descendentes do elemento atual. (Herdado de OpenXmlElement)
Descendants<T>()	Enumera todos os descendentes do elemento atual do tipo T. (Herdado de OpenXmlElement)
Elements()	Enumera todos os filhos do elemento atual. (Herdado de OpenXmlElement)
Elements<T>()	Enumera apenas os filhos do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement)
ElementsAfter()	Enumera todos os elementos irmãos que seguem o elemento atual e têm o mesmo pai que o elemento atual. (Herdado de OpenXmlElement)
ElementsBefore()	Enumera todos os elementos irmãos que precedem o elemento atual e têm o mesmo pai que o elemento atual. (Herdado de OpenXmlElement)
GetAttribute(String, String)	Obtém um atributo Open XML com o nome da marca e o URI do namespace especificados. (Herdado de OpenXmlElement)
GetAttributes()	Obtém uma lista que contém uma cópia de todos os atributos. (Herdado de OpenXmlElement)
GetEnumerator()	Retorna um enumerador que itera por meio da coleção filho. (Herdado de OpenXmlElement)
GetFirstChild<T>()	Localiza o primeiro elemento filho 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 OpenXmlElement)
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 na lista de elementos filho do elemento atual. (Herdado de OpenXmlElement)
InsertBefore<T>(T, OpenXmlElement)	Insere o elemento especificado imediatamente antes do elemento de referência especificado. (Herdado de OpenXmlElement)
InsertBeforeSelf<T>(T)	Insere o elemento especificado imediatamente antes do elemento atual. (Herdado de OpenXmlElement)
IsAfter(OpenXmlElement)	Determina se o elemento atual é exibido após um elemento especificado na ordem do documento. (Herdado de OpenXmlElement)
IsBefore(OpenXmlElement)	Determina se o elemento atual é exibido antes de um elemento especificado na ordem do documento. (Herdado de OpenXmlElement)
LookupNamespace(String)	Resolve o prefixo namespace no contexto do nó atual. (Herdado de OpenXmlElement)
LookupPrefix(String)	Localiza o prefixo correspondente para um uri de namespace no escopo do elemento atual. (Herdado de OpenXmlElement)
NextSibling()	Obtém o elemento OpenXmlElement que segue imediatamente o elemento OpenXmlElement atual. Retorna nulo (Nada no Visual Basic) se não houver nenhum próximo elemento OpenXmlElement. (Herdado de OpenXmlElement)
NextSibling<T>()	Obtém o elemento OpenXmlElement com o tipo especificado que segue o elemento OpenXmlElement atual. Retornará nulo (Nada no Visual Basic) se não houver o próximo OpenXmlElement. (Herdado de OpenXmlElement)
PrependChild<T>(T)	Insere o elemento especificado no início da lista de elementos filho do elemento atual. (Herdado de OpenXmlElement)
PreviousSibling()	Obtém o elemento OpenXmlElement que precede imediatamente o elemento OpenXmlElement atual. Retorna nulo (Nada no Visual Basic ) se não houver nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement)
PreviousSibling<T>()	Obtém o elemento OpenXmlElement com o tipo especificado que precede o OpenXmlElement atual. Retorna nulo (Nada no Visual Basic) se não houver nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement)
Remove()	Remove o elemento atual de seu pai. (Herdado de OpenXmlElement)
RemoveAllChildren()	Remove todos os elementos filho do elemento atual. (Herdado de OpenXmlLeafElement)
RemoveAllChildren<T>()	Remova todos os elementos filho 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 filho especificado da lista de elementos filho do elemento atual. (Herdado de OpenXmlElement)
RemoveNamespaceDeclaration(String)	Remove a declaração de namespace do prefixo especificado. Não removerá nada se não houver nenhum prefixo. (Herdado de OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Substitui um elemento filho por outro elemento filho na lista de elementos filho do elemento atual. (Herdado de OpenXmlElement)
SetAttribute(OpenXmlAttribute)	Define um atributo para o elemento especificado. Se o atributo for um atributo conhecido, o valor do atributo será definido. Se o atributo for um atributo estendido, o 'openxmlAttribute' será adicionado à lista de atributos estendidos. (Herdado de OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Define uma série de atributos para o elemento. Se um atributo for um atributo conhecido, o valor do atributo será definido. Se um atributo for um atributo estendido, o 'openxmlAttribute' será adicionado à lista de atributos estendidos. (Herdado de OpenXmlElement)
WriteTo(XmlWriter)	Salva o nó atual no XmlWriter especificado. (Herdado de OpenXmlElement)

Implantações explícitas de interface

IEnumerable.GetEnumerator()	Borda do parágrafo acima de parágrafos idênticos. Essa classe está disponível no Office 2007 e superior. Quando o objeto é serializado como xml, seu nome qualificado é w:top. (Herdado de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Retorna um enumerador que itera por meio da coleção filho. (Herdado de OpenXmlElement)