TopBorder Clase

Definición

Espacio de nombres:

DocumentFormat.OpenXml.Wordprocessing

Ensamblado:

DocumentFormat.OpenXml.dll

Paquete:

DocumentFormat.OpenXml v3.0.1

Borde de párrafo encima de párrafos idénticos.

Esta clase está disponible en Office 2007 y versiones posteriores.

Cuando el objeto se serializa como xml, su nombre completo es w:top.

public class TopBorder : DocumentFormat.OpenXml.Wordprocessing.BorderType

type TopBorder = class
    inherit BorderType

Public Class TopBorder
Inherits BorderType

Herencia

Object

OpenXmlElement

OpenXmlLeafElement

BorderType

TopBorder

Comentarios

[ISO/IEC 29500-1 1.ª edición]

top (Paragraph Border Above Identical Paragraphs)

Este elemento especifica el borde que se mostrará encima de un conjunto de párrafos que tienen el mismo conjunto de configuraciones de borde de párrafo.

Para determinar si dos párrafos adyacentes deben tener un borde superior e inferior individual o un borde entre borde, se compara el conjunto de bordes de los dos párrafos adyacentes. Si la información de borde de esos dos párrafos es idéntica para todos los bordes de párrafo posibles, se muestra el borde entre. En caso contrario, el párrafo final utilizará su borde inferior y el párrafo siguiente utilizará su borde superior, respectivamente. Si este borde especifica un atributo de espacio, ese valor determina el espacio por encima del texto (omitiendo cualquier espaciado anterior) que debe dejarse antes de que se dibuje este borde, especificado en puntos.

Si este elemento se omite en un párrafo determinado, su valor viene determinado por la configuración establecida anteriormente en cualquier nivel de la jerarquía de estilos (es decir, que la configuración anterior permanece sin cambios). Si esta configuración nunca se especifica en la jerarquía de estilos, no se aplicará ningún elemento entre borde por encima de párrafos idénticos.

[Ejemplo: tenga en cuenta la definición wordprocessingML de los dos párrafos siguientes:

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

Dado que el borde de párrafo es diferente entre los dos párrafos (el valor del espacio inferior va de 1 a 0), el párrafo dos usa su borde superior, que se encuentra un punto por encima del texto de ese párrafo. Fin del ejemplo]

Elementos primarios
pBdr (§17.3.1.24)

El modelo de contenido de este elemento se define mediante la definición de propiedades de borde común en §17.3.4.

[ISO/IEC 29500-1 1.ª edición]

top (Table Cell Top Border)

Este elemento especifica el borde que se mostrará en la parte superior de la celda de tabla actual. La apariencia de este borde de celda de tabla en el documento se determinará mediante la configuración siguiente:

• Si el valor del elemento net tblCellSpacing (§17.4.45;§17.4.44;§17.4.46) aplicado a la celda es distinto de cero, siempre se mostrará el borde de celda.

• De lo contrario, la presentación del borde está sujeta al algoritmo de resolución de conflictos definido por el elemento tcBorders (§17.4.67) y el elemento tblBorders (§17.4.40;§17.4.39)

Si se omite este elemento, la parte superior de esta celda de tabla no tendrá un borde de celda y su borde puede usar la configuración de borde de la tabla según corresponda.

[Ejemplo: considere la posibilidad de una tabla en la que la primera celda de la primera fila especifica un borde de celda superior , como se indica a continuación:

R1C1

R1C2

R2C1

R2C2

Este borde de celda superior se especifica mediante el siguiente esquema 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>  

El elemento top especifica un borde de tres puntos de tipo thinThinThickSmallGap. Fin del ejemplo]

Elementos primarios
tcBorders (§17.4.67)

El modelo de contenido de este elemento se define mediante la definición de propiedades de borde común en §17.3.4.

[ISO/IEC 29500-1 1.ª edición]

top (Table Top Border)

Este elemento especifica el borde que se mostrará en la parte superior de la tabla actual. La apariencia de este borde de tabla en el documento se determinará mediante la configuración siguiente:

• La visualización del borde está sujeta al algoritmo de resolución de conflictos definido por el elemento tcBorders (§17.4.67) y el elemento tblBorders (§17.4.40;§17.4.39)

Si se omite este elemento, la parte superior de esta tabla tendrá el borde especificado por el estilo de tabla asociado. Si no se especifica ningún borde superior en la jerarquía de estilos, esta tabla no tendrá un borde superior.

[Ejemplo: considere la posibilidad de una tabla en la que las propiedades de la tabla especifican un borde de tabla superior, como se indica a continuación:

R1C1

R1C2

R2C1

R2C2

Este borde de tabla superior se especifica mediante el siguiente esquema 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>  

El elemento top especifica un borde de tabla superior de tres puntos de tipo thinThinThickMediumGap. ejemplo final].

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

El modelo de contenido de este elemento se define mediante la definición de propiedades de borde común en §17.3.4.

[ISO/IEC 29500-1 1.ª edición]

top (Top Border)

Este elemento especifica la presentación y la presentación del borde de página que se muestra en la parte superior de cada página de esta sección.

[Ejemplo: considere la posibilidad de una sección en la que todas las páginas deben tener un borde superior que conste de una imagen repetida de globos, como esta:

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

Este borde daría como resultado el siguiente esquema WordprocessingML:

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

Dado que la página solo tiene un borde en la parte superior, solo se especifica el elemento superior dentro del conjunto de bordes de página. Fin del ejemplo]

Cuando un documento tiene un borde superior relativo a los bordes de página (con un valor de atributo offsetFrom de la página en pgBorders), abarcará el borde superior de la página en la ubicación definida por sus propiedades, deteniéndose cuando:

• Interseca con el borde de página izquierdo o derecho correspondiente (si se especifica uno)

• Llega al borde de la página.

[Ejemplo: en el ejemplo anterior, no se especificó ningún borde izquierdo o derecho en WordprocessingML, por lo que un consumidor debe dibujar el borde de un borde de la página a otro. Fin del ejemplo]

Cuando un documento tiene un borde superior relativo al texto (con el valor del atributo offsetFrom de texto en pgBorders), solo abarcará el ancho necesario para satisfacer el requisito de abarcar el ancho del texto.

Cuando un documento tiene la ilustración de borde personalizada especificada por los atributos topLeft, topRight y/o id, usará el elemento de elemento de relación correspondiente como imagen para la esquina superior izquierda, la esquina superior derecha o el borde superior, respectivamente. Si no se puede resolver el elemento de parte de relación correspondiente, el consumidor usará el borde especificado por el valor del atributo val. Si el valor correspondiente del atributo val no se puede resolver no hay ninguna esquina superior izquierda, la esquina superior derecha o el borde superior está presente cuando se muestra la página.

Cuando un documento tiene una imagen de borde personalizada especificada por id. de atributo sin especificar los atributos topRight o topLeft, el borde superior resuelto por el elemento de elemento de relación correspondiente del identificador de atributo se extenderá a las esquinas no especificadas por los atributos topRight o topLeft.

Elementos primarios
pgBorders (§17.6.10)

[Nota: La definición del esquema XML W3C del modelo de contenido de este elemento (CT_TopPageBorder) se encuentra en §A.1. Fin de la nota]

[ISO/IEC 29500-1 1.ª edición]

top (Top Border for HTML div)

Este elemento especifica el borde que se mostrará en la parte superior de los límites del objeto div HTML actual.

Si se omite este elemento, este objeto div HTML no tendrá un borde superior.

[Ejemplo: considere la posibilidad de un documento HTML simple definido como sigue:

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

Por lo tanto, este HTML normalmente aparecería de la siguiente manera (la imagen se escala correctamente):

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

Ahora, cuando este documento se guarda en el formato WordprocessingML, la información almacenada en los elementos div se almacena en el elemento de configuración web de la siguiente manera:

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

El elemento superior especifica información de borde sobre el borde superior de la estructura div HTML única del documento; en este caso, un borde inferior de 2,25 puntos de tipo discontinuo. El borde inicial de 3 píxeles se convirtió en 2,25 puntos mediante la siguiente lógica:

Fin del ejemplo]

Elementos primarios
divBdr (§17.15.2.7)

El modelo de contenido de este elemento se define mediante la definición de propiedades de borde común en §17.3.4.

ISO/IEC29500: 2008.

Constructores

TopBorder()

Inicializa una nueva instancia de la clase TopBorder.

Propiedades

ChildElements	Obtiene todos los nodos secundarios del elemento actual. (Heredado de OpenXmlElement)
Color	Color del borde Representa el atributo siguiente en el esquema: w:color (Heredado de BorderType)
ExtendedAttributes	Obtiene todos los atributos extendidos (atributos no definidos en el esquema) del elemento actual. (Heredado de OpenXmlElement)
Features	Obtiene un IFeatureCollection para el elemento actual. Esta colección de características será de solo lectura, pero heredará características de su elemento primario y paquete si está disponible. (Heredado de OpenXmlElement)
FirstChild	Obtiene el primer elemento secundario del elemento OpenXmlElement. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement de este tipo. (Heredado de OpenXmlElement)
Frame	Crear efecto de marco Representa el atributo siguiente en el esquema: w:frame (Heredado de BorderType)
HasAttributes	Obtiene un valor que indica si el elemento actual tiene atributos. (Heredado de OpenXmlElement)
HasChildren	Obtiene un valor que indica si el elemento actual tiene algún elemento secundario. (Heredado de OpenXmlLeafElement)
InnerText	Obtiene o establece los valores concatenados del nodo y todos sus elementos secundarios. (Heredado de OpenXmlElement)
InnerXml	Obtiene o establece el marcado que solo representa elementos secundarios del elemento actual. (Heredado de OpenXmlLeafElement)
LastChild	Obtiene el último elemento secundario del elemento OpenXmlElement. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement de este tipo. (Heredado de OpenXmlElement)
LocalName	Obtiene el nombre local del elemento actual. (Heredado de OpenXmlElement)
MCAttributes	Obtiene o establece los atributos de compatibilidad de marcado. Devuelve null si no se definen atributos de compatibilidad de marcado para el elemento actual. (Heredado de OpenXmlElement)
NamespaceDeclarations	Obtiene todas las declaraciones de espacio de nombres definidas en el elemento actual. Devuelve un enumerador vacío si no hay ninguna declaración de espacio de nombres. (Heredado de OpenXmlElement)
NamespaceUri	Obtiene el URI del espacio de nombres del elemento actual. (Heredado de OpenXmlElement)
OpenXmlElementContext	Obtiene el Objeto OpenXmlElementContext del elemento actual. (Heredado de OpenXmlElement)
OuterXml	Obtiene el marcado que representa el elemento actual y todos sus elementos secundarios. (Heredado de OpenXmlElement)
Parent	Obtiene el elemento primario del elemento actual. (Heredado de OpenXmlElement)
Prefix	Obtiene el prefijo de espacio de nombres del elemento actual. (Heredado de OpenXmlElement)
Shadow	Sombra de borde Representa el atributo siguiente en el esquema: w:shadow (Heredado de BorderType)
Size	Ancho del borde Representa el atributo siguiente en el esquema: w:sz (Heredado de BorderType)
Space	Medición del espaciado de borde Representa el atributo siguiente en el esquema: w:space (Heredado de BorderType)
ThemeColor	Color del tema de borde Representa el atributo siguiente en el esquema: w:themeColor (Heredado de BorderType)
ThemeShade	Sombra de color del tema de borde Representa el atributo siguiente en el esquema: w:themeShade (Heredado de BorderType)
ThemeTint	Tono de color del tema del borde Representa el atributo siguiente en el esquema: w:themeTint (Heredado de BorderType)
Val	Estilo de borde Representa el atributo siguiente en el esquema: w:val (Heredado de BorderType)
XmlQualifiedName	Obtiene el nombre completo del elemento actual. (Heredado de OpenXmlElement)
XName	Obtiene el nombre completo del elemento actual. (Heredado de OpenXmlElement)

Métodos

AddAnnotation(Object)	Agrega un objeto a la lista de anotaciones del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
AddNamespaceDeclaration(String, String)	Agrega una declaración de espacio de nombres al nodo actual. (Heredado de OpenXmlElement)
Ancestors()	Enumera todos los antecesores del elemento actual. (Heredado de OpenXmlElement)
Ancestors<T>()	Enumera solo los antecesores del elemento actual que tienen el tipo especificado. (Heredado de OpenXmlElement)
Annotation(Type)	Obtenga el primer objeto de anotación del tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Annotation<T>()	Obtenga el primer objeto de anotación del tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Annotations(Type)	Obtiene una colección de anotaciones con el tipo especificado para el elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Annotations<T>()	Obtiene una colección de anotaciones con el tipo especificado para el elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	Anexa cada elemento de una lista de elementos al final de la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
Append(OpenXmlElement[])	Anexa cada elemento de una matriz de elementos al final de la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
AppendChild<T>(T)	Anexa el elemento especificado al final de la lista de nodos secundarios del elemento actual. (Heredado de OpenXmlElement)
ClearAllAttributes()	Borra todos los atributos, incluidos los atributos conocidos y los atributos extendidos. (Heredado de OpenXmlElement)
Clone()	Crea un duplicado del nodo actual. (Heredado de OpenXmlElement)
CloneNode(Boolean)	Crea un duplicado de este nodo.
Descendants()	Enumera todos los descendientes del elemento actual. (Heredado de OpenXmlElement)
Descendants<T>()	Enumera todos los descendientes del elemento actual del tipo T. (Heredado de OpenXmlElement)
Elements()	Enumera todos los elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
Elements<T>()	Enumera solo los elementos secundarios del elemento actual que tienen el tipo especificado. (Heredado de OpenXmlElement)
ElementsAfter()	Enumera todos los elementos del mismo nivel que siguen el elemento actual y tienen el mismo elemento primario que el elemento actual. (Heredado de OpenXmlElement)
ElementsBefore()	Enumera todos los elementos del mismo nivel que preceden al elemento actual y tienen el mismo elemento primario que el elemento actual. (Heredado de OpenXmlElement)
GetAttribute(String, String)	Obtiene un atributo Open XML con el nombre de etiqueta y el URI de espacio de nombres especificados. (Heredado de OpenXmlElement)
GetAttributes()	Obtiene una lista que contiene una copia de todos los atributos. (Heredado de OpenXmlElement)
GetEnumerator()	Devuelve un enumerador que recorre en iteración la colección secundaria. (Heredado de OpenXmlElement)
GetFirstChild<T>()	Busca el primer elemento secundario en el tipo T. (Heredado de OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	Inserta el elemento especificado inmediatamente después del elemento de referencia especificado. (Heredado de OpenXmlElement)
InsertAfterSelf<T>(T)	Inserta el elemento especificado inmediatamente después del elemento actual. (Heredado de OpenXmlElement)
InsertAt<T>(T, Int32)	Inserta el elemento especificado en el índice especificado en la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
InsertBefore<T>(T, OpenXmlElement)	Inserta el elemento especificado inmediatamente antes del elemento de referencia especificado. (Heredado de OpenXmlElement)
InsertBeforeSelf<T>(T)	Inserta el elemento especificado inmediatamente antes del elemento actual. (Heredado de OpenXmlElement)
IsAfter(OpenXmlElement)	Determina si el elemento actual aparece después de un elemento especificado en el orden del documento. (Heredado de OpenXmlElement)
IsBefore(OpenXmlElement)	Determina si el elemento actual aparece antes que un elemento especificado en el orden del documento. (Heredado de OpenXmlElement)
LookupNamespace(String)	Resuelve el prefijo de espacio de nombres en el contexto del nodo actual. (Heredado de OpenXmlElement)
LookupPrefix(String)	Busca el prefijo correspondiente para un uri de espacio de nombres en el ámbito del elemento actual. (Heredado de OpenXmlElement)
NextSibling()	Obtiene el elemento OpenXmlElement que sigue inmediatamente al elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement siguiente. (Heredado de OpenXmlElement)
NextSibling<T>()	Obtiene el elemento OpenXmlElement con el tipo especificado que sigue al elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement siguiente. (Heredado de OpenXmlElement)
PrependChild<T>(T)	Inserta el elemento especificado al principio de la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
PreviousSibling()	Obtiene el elemento OpenXmlElement que precede inmediatamente al elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic ) si no hay ningún elemento OpenXmlElement anterior. (Heredado de OpenXmlElement)
PreviousSibling<T>()	Obtiene el elemento OpenXmlElement con el tipo especificado que precede al objeto OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement anterior. (Heredado de OpenXmlElement)
Remove()	Quita el elemento actual de su elemento primario. (Heredado de OpenXmlElement)
RemoveAllChildren()	Quita todos los elementos secundarios del elemento actual. (Heredado de OpenXmlLeafElement)
RemoveAllChildren<T>()	Quite todos los elementos secundarios del elemento actual que son de tipo T. (Heredado de OpenXmlElement)
RemoveAnnotations(Type)	Quita las anotaciones del tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
RemoveAnnotations<T>()	Quita las anotaciones con el tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
RemoveAttribute(String, String)	Quita el atributo del elemento actual. (Heredado de OpenXmlElement)
RemoveChild<T>(T)	Quita el elemento secundario especificado de la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
RemoveNamespaceDeclaration(String)	Quita la declaración de espacio de nombres para el prefijo especificado. No quita nada si no hay ningún prefijo. (Heredado de OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Reemplaza un elemento secundario por otro elemento secundario en la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
SetAttribute(OpenXmlAttribute)	Establece un atributo en el elemento especificado. Si el atributo es un atributo conocido, se establece el valor del atributo. Si el atributo es un atributo extendido, el atributo "openxmlAttribute" se agrega a la lista de atributos extendidos. (Heredado de OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Establece una serie de atributos en el elemento . Si un atributo es un atributo conocido, se establece el valor del atributo. Si un atributo es un atributo extendido, el atributo "openxmlAttribute" se agrega a la lista de atributos extendidos. (Heredado de OpenXmlElement)
WriteTo(XmlWriter)	Guarda el nodo actual en el objeto XmlWriter especificado. (Heredado de OpenXmlElement)

Implementaciones de interfaz explícitas

IEnumerable.GetEnumerator()	Borde de párrafo encima de párrafos idénticos. Esta clase está disponible en Office 2007 y versiones posteriores. Cuando el objeto se serializa como xml, su nombre completo es w:top. (Heredado de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Devuelve un enumerador que recorre en iteración la colección secundaria. (Heredado de OpenXmlElement)