TopBorder Classe

Définition

Espace de noms:

DocumentFormat.OpenXml.Wordprocessing

Assembly:

DocumentFormat.OpenXml.dll

Paquet:

DocumentFormat.OpenXml v3.0.1

Bordure de paragraphe au-dessus de paragraphes identiques.

Cette classe est disponible dans Office 2007 et versions ultérieures.

Lorsque l’objet est sérialisé au format xml, son nom qualifié est w :top.

public class TopBorder : DocumentFormat.OpenXml.Wordprocessing.BorderType

type TopBorder = class
    inherit BorderType

Public Class TopBorder
Inherits BorderType

Héritage

Object

OpenXmlElement

OpenXmlLeafElement

BorderType

TopBorder

Remarques

[ISO/IEC 29500-1 1st Edition]

top (Paragraph Border Above Identical Paragraphs)

Cet élément spécifie la bordure qui doit être affichée au-dessus d’un ensemble de paragraphes qui ont le même jeu de paramètres de bordure de paragraphe.

Pour déterminer si deux paragraphes adjacents doivent avoir une bordure supérieure et inférieure individuelle ou une bordure entre les bordures, l’ensemble des bordures des deux paragraphes adjacents est comparé. Si les informations de bordure sur ces deux paragraphes sont identiques pour toutes les bordures de paragraphes possibles, la bordure entre est affichée. Dans le cas contraire, le dernier paragraphe utilise sa bordure inférieure et le paragraphe suivant utilise sa bordure supérieure, respectivement. Si cette bordure spécifie un attribut d’espace, cette valeur détermine l’espace au-dessus du texte (en ignorant tout espacement au-dessus) qui doit être laissé avant que cette bordure ne soit dessinée, spécifiée en points.

Si cet élément est omis sur un paragraphe donné, sa valeur est déterminée par le paramètre précédemment défini à n’importe quel niveau de la hiérarchie de style (c’est-à-dire que le paramètre précédent reste inchangé). Si ce paramètre n’est jamais spécifié dans la hiérarchie de style, aucune bordure n’est appliquée au-dessus de paragraphes identiques.

[Exemple : Considérez la définition WordprocessingML des deux paragraphes suivants :

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

Étant donné que la bordure du paragraphe est différente entre les deux paragraphes (la valeur de l’espace inférieur est comprise entre 1 et 0), le paragraphe 2 utilise sa bordure supérieure, qui se trouve un point au-dessus du texte de ce paragraphe. Fin de l’exemple]

Éléments parents
pBdr (§17.3.1.24)

Le modèle de contenu de cet élément est défini par la définition des propriétés de bordure communes dans §17.3.4.

[ISO/IEC 29500-1 1st Edition]

top (Table Cell Top Border)

Cet élément spécifie la bordure qui doit être affichée en haut de la cellule de tableau active. L’apparence de cette bordure de cellule de tableau dans le document doit être déterminée par les paramètres suivants :

• Si la valeur de l’élément net tblCellSpacing (§17.4.45 ;§17.4.44 ;§17.4.46) appliquée à la cellule est différente de zéro, la bordure de la cellule doit toujours être affichée

• Sinon, l’affichage de la bordure est soumis à l’algorithme de résolution des conflits défini par l’élément tcBorders (§17.4.67) et l’élément tblBorders (§17.4.40 ;§17.4.39)

Si cet élément est omis, le haut de cette cellule de tableau ne doit pas avoir de bordure de cellule, et sa bordure peut utiliser les paramètres de bordure du tableau comme il convient.

[Exemple : Considérez un tableau dans lequel la première cellule de la première ligne spécifie une bordure de cellule supérieure, comme suit :

R1C1

R1C2

R2C1

R2C2

Cette bordure de cellule supérieure est spécifiée à l’aide du wordprocessingML suivant :

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

L’élément supérieur spécifie une bordure à trois points de type thinThinThickSmallGap. Fin de l’exemple]

Éléments parents
tcBorders (§17.4.67)

Le modèle de contenu de cet élément est défini par la définition des propriétés de bordure communes dans §17.3.4.

[ISO/IEC 29500-1 1st Edition]

top (Table Top Border)

Cet élément spécifie la bordure qui doit être affichée en haut de la table active. L’apparence de cette bordure de tableau dans le document doit être déterminée par les paramètres suivants :

• L’affichage de la bordure est soumis à l’algorithme de résolution des conflits défini par l’élément tcBorders (§17.4.67) et l’élément tblBorders (§17.4.40 ;§17.4.39)

Si cet élément est omis, le haut de ce tableau doit avoir la bordure spécifiée par le style de tableau associé. Si aucune bordure supérieure n’est spécifiée dans la hiérarchie de style, cette table ne doit pas avoir de bordure supérieure.

[Exemple : Considérez une table dans laquelle les propriétés de table spécifient une bordure de table supérieure, comme suit :

R1C1

R1C2

R2C1

R2C2

Cette bordure du tableau supérieur est spécifiée à l’aide du wordprocessingML suivant :

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

L’élément top spécifie une bordure de table supérieure à trois points de type thinThinThickMediumGap. exemple de fin].

Éléments parents
tblBorders (§17.4.39) ; tblBorders (§17.4.40)

Le modèle de contenu de cet élément est défini par la définition des propriétés de bordure communes dans §17.3.4.

[ISO/IEC 29500-1 1st Edition]

top (Top Border)

Cet élément spécifie la présentation et l’affichage de la bordure de page affichée en haut de chaque page de cette section.

[Exemple : prenons une section dans laquelle toutes les pages doivent avoir une bordure supérieure composée d’une image répétée de bulles, comme suit :

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

Cette bordure entraînerait le wordprocessingML suivant :

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

Étant donné que la page n’a qu’une bordure en haut, seul l’élément supérieur est spécifié dans l’ensemble de bordures de page. Fin de l’exemple]

Lorsqu’un document a une bordure supérieure relative aux bords de la page (à l’aide d’une valeur d’attribut offsetFrom de page sur pgBorders), il doit s’étendre sur le bord supérieur de la page à l’emplacement défini par ses propriétés, s’arrêtant lorsque :

• Il se croise avec la bordure de la page de gauche ou de droite correspondante (si elle est spécifiée)

• Il atteint le bord de la page.

[Exemple : Dans l’exemple ci-dessus, aucune bordure gauche ou droite n’a été spécifiée dans wordprocessingML. Par conséquent, un consommateur doit dessiner la bordure d’un bord de la page à l’autre. Fin de l’exemple]

Lorsqu’un document a une bordure supérieure relative au texte (à l’aide de la valeur d’attribut offsetFrom de text sur pgBorders), il doit uniquement couvrir la largeur nécessaire pour satisfaire à l’exigence de couvrir la largeur du texte.

Lorsqu’un document a une image de bordure personnalisée spécifiée par les attributs topLeft, topRight et/ou id, il doit utiliser l’élément de partie de relation correspondant comme image pour le coin supérieur gauche, le coin supérieur droit et/ou la bordure supérieure, respectivement. Si l’élément de partie de relation correspondant ne peut pas être résolu, le consommateur doit utiliser la bordure spécifiée par la valeur de l’attribut val. Si la valeur correspondante de l’attribut val ne peut pas être résolue, aucun coin supérieur gauche, coin supérieur droit ou bordure supérieure n’est présent lorsque la page est affichée.

Lorsqu’un document a une image de bordure personnalisée spécifiée par l’ID d’attribut sans spécifier les attributs topRight et/ou topLeft, la bordure supérieure telle qu’elle est résolue par l’élément de partie de relation correspondant de l’id d’attribut s’étend aux coins non spécifiés par les attributs topRight et/ou topLeft.

Éléments parents
pgBorders (§17.6.10)

[Remarque : La définition de schéma XML W3C du modèle de contenu de cet élément (CT_TopPageBorder) se trouve dans §A.1. Fin de la remarque]

[ISO/IEC 29500-1 1st Edition]

top (Top Border for HTML div)

Cet élément spécifie la bordure qui doit être affichée en haut des limites de l’objet div HTML actuel.

Si cet élément est omis, cet objet HTML div ne doit pas avoir de bordure supérieure.

[Exemple : Considérez un document HTML simple défini comme suit :

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

Ce code HTML apparaît donc normalement comme suit (image mise à l’échelle de manière appropriée) :

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

Maintenant, lorsque ce document est enregistré au format WordprocessingML, les informations stockées sur les éléments div sont stockées dans le composant Web Setting comme suit :

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

L’élément top spécifie des informations de bordure sur la bordure supérieure de la structure div HTML unique dans le document . dans ce cas, une bordure inférieure de 2,25 points de type pointillé. La bordure initiale de 3 pixels a été convertie en 2,25 points à l’aide de la logique suivante :

Fin de l’exemple]

Éléments parents
divBdr (§17.15.2.7)

Le modèle de contenu de cet élément est défini par la définition des propriétés de bordure communes dans §17.3.4.

ISO/IEC29500 : 2008.

Constructeurs

TopBorder()

Initialise une nouvelle instance de la classe TopBorder.

Propriétés

ChildElements	Obtient tous les nœuds enfants de l’élément actuel. (Hérité de OpenXmlElement)
Color	Couleur de bordure Représente l’attribut suivant dans le schéma : w :color (Hérité de BorderType)
ExtendedAttributes	Obtient tous les attributs étendus (attributs non définis dans le schéma) de l’élément actuel. (Hérité de OpenXmlElement)
Features	Obtient un IFeatureCollection pour l’élément actuel. Cette collection de fonctionnalités sera en lecture seule, mais héritera des fonctionnalités de sa partie parente et de son package, le cas échéant. (Hérité de OpenXmlElement)
FirstChild	Obtient le premier enfant de l’élément OpenXmlElement. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement de ce type. (Hérité de OpenXmlElement)
Frame	Créer un effet d’image Représente l’attribut suivant dans le schéma : w :frame (Hérité de BorderType)
HasAttributes	Obtient une valeur indiquant si l’élément actuel a des attributs. (Hérité de OpenXmlElement)
HasChildren	Obtient une valeur qui indique si l’élément actuel a des éléments enfants. (Hérité de OpenXmlLeafElement)
InnerText	Obtient ou définit les valeurs concaténées du nœud et de tous ses enfants. (Hérité de OpenXmlElement)
InnerXml	Obtient ou définit le balisage qui représente uniquement les éléments enfants de l’élément actuel. (Hérité de OpenXmlLeafElement)
LastChild	Obtient le dernier enfant de l’élément OpenXmlElement. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement de ce type. (Hérité de OpenXmlElement)
LocalName	Obtient le nom local de l’élément actuel. (Hérité de OpenXmlElement)
MCAttributes	Obtient ou définit les attributs de compatibilité du balisage. Retourne null si aucun attribut de compatibilité de balisage n’est défini pour l’élément actuel. (Hérité de OpenXmlElement)
NamespaceDeclarations	Obtient toutes les déclarations d’espace de noms définies dans l’élément actuel. Retourne un énumérateur vide s’il n’y a pas de déclaration d’espace de noms. (Hérité de OpenXmlElement)
NamespaceUri	Obtient l’URI d’espace de noms de l’élément actuel. (Hérité de OpenXmlElement)
OpenXmlElementContext	Obtient l’élément OpenXmlElementContext de l’élément actuel. (Hérité de OpenXmlElement)
OuterXml	Obtient le balisage qui représente l’élément actuel et tous ses éléments enfants. (Hérité de OpenXmlElement)
Parent	Obtient l’élément parent de l’élément actuel. (Hérité de OpenXmlElement)
Prefix	Obtient le préfixe d’espace de noms de l’élément actuel. (Hérité de OpenXmlElement)
Shadow	Ombre de bordure Représente l’attribut suivant dans le schéma : w :shadow (Hérité de BorderType)
Size	Largeur de la bordure Représente l’attribut suivant dans le schéma : w :sz (Hérité de BorderType)
Space	Mesure de l’espacement des bordures Représente l’attribut suivant dans le schéma : w :space (Hérité de BorderType)
ThemeColor	Couleur du thème de bordure Représente l’attribut suivant dans le schéma : w :themeColor (Hérité de BorderType)
ThemeShade	Nuance de couleur du thème de bordure Représente l’attribut suivant dans le schéma : w :themeShade (Hérité de BorderType)
ThemeTint	Teinte de couleur du thème de bordure Représente l’attribut suivant dans le schéma : w :themeTint (Hérité de BorderType)
Val	Style de bordure Représente l’attribut suivant dans le schéma : w :val (Hérité de BorderType)
XmlQualifiedName	Obtient le nom qualifié de l’élément actuel. (Hérité de OpenXmlElement)
XName	Obtient le nom qualifié de l’élément actuel. (Hérité de OpenXmlElement)

Méthodes

AddAnnotation(Object)	Ajoute un objet à la liste d’annotations de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
AddNamespaceDeclaration(String, String)	Ajoute une déclaration d’espace de noms au nœud actuel. (Hérité de OpenXmlElement)
Ancestors()	Énumère tous les ancêtres de l’élément actuel. (Hérité de OpenXmlElement)
Ancestors<T>()	Énumère uniquement les ancêtres de l’élément actuel qui ont le type spécifié. (Hérité de OpenXmlElement)
Annotation(Type)	Obtenez le premier objet d’annotation du type spécifié à partir de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
Annotation<T>()	Obtenez le premier objet d’annotation du type spécifié à partir de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
Annotations(Type)	Obtient une collection d’annotations avec le type spécifié pour l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
Annotations<T>()	Obtient une collection d’annotations avec le type spécifié pour l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	Ajoute chaque élément d’une liste d’éléments à la fin de la liste des éléments enfants de l’élément actuel. (Hérité de OpenXmlElement)
Append(OpenXmlElement[])	Ajoute chaque élément d’un tableau d’éléments à la fin de la liste des éléments enfants de l’élément actuel. (Hérité de OpenXmlElement)
AppendChild<T>(T)	Ajoute l’élément spécifié à la fin de la liste des nœuds enfants de l’élément actuel. (Hérité de OpenXmlElement)
ClearAllAttributes()	Efface tous les attributs, y compris les attributs connus et les attributs étendus. (Hérité de OpenXmlElement)
Clone()	Crée un doublon du nœud actuel. (Hérité de OpenXmlElement)
CloneNode(Boolean)	Crée un doublon de ce nœud.
Descendants()	Énumère tous les descendants de l’élément actuel. (Hérité de OpenXmlElement)
Descendants<T>()	Énumérez tous les descendants de l’élément actuel de type T. (Hérité de OpenXmlElement)
Elements()	Énumère tous les enfants de l’élément actuel. (Hérité de OpenXmlElement)
Elements<T>()	Énumère uniquement les enfants de l’élément actuel qui ont le type spécifié. (Hérité de OpenXmlElement)
ElementsAfter()	Énumère tous les éléments frères qui suivent l’élément actuel et ont le même parent que l’élément actuel. (Hérité de OpenXmlElement)
ElementsBefore()	Énumère tous les éléments frères qui précèdent l’élément actuel et ont le même parent que l’élément actuel. (Hérité de OpenXmlElement)
GetAttribute(String, String)	Obtient un attribut Open XML avec le nom de balise et l’URI d’espace de noms spécifiés. (Hérité de OpenXmlElement)
GetAttributes()	Obtient une liste qui contient une copie de tous les attributs. (Hérité de OpenXmlElement)
GetEnumerator()	Retourne un énumérateur qui itère au sein de la collection enfant. (Hérité de OpenXmlElement)
GetFirstChild<T>()	Recherche le premier élément enfant de type T. (Hérité de OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	Insère l’élément spécifié immédiatement après l’élément de référence spécifié. (Hérité de OpenXmlElement)
InsertAfterSelf<T>(T)	Insère l’élément spécifié immédiatement après l’élément actuel. (Hérité de OpenXmlElement)
InsertAt<T>(T, Int32)	Insère l’élément spécifié à l’index spécifié dans la liste des éléments enfants de l’élément actuel. (Hérité de OpenXmlElement)
InsertBefore<T>(T, OpenXmlElement)	Insère l’élément spécifié juste avant l’élément de référence spécifié. (Hérité de OpenXmlElement)
InsertBeforeSelf<T>(T)	Insère l’élément spécifié juste avant l’élément actuel. (Hérité de OpenXmlElement)
IsAfter(OpenXmlElement)	Détermine si l’élément actuel apparaît après un élément spécifié dans l’ordre du document. (Hérité de OpenXmlElement)
IsBefore(OpenXmlElement)	Détermine si l’élément actuel apparaît avant un élément spécifié dans l’ordre du document. (Hérité de OpenXmlElement)
LookupNamespace(String)	Résout le préfixe d’espace de noms dans le contexte du nœud actuel. (Hérité de OpenXmlElement)
LookupPrefix(String)	Recherche le préfixe correspondant pour un URI d’espace de noms dans l’étendue de l’élément actuel. (Hérité de OpenXmlElement)
NextSibling()	Obtient l’élément OpenXmlElement qui suit immédiatement l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement suivant. (Hérité de OpenXmlElement)
NextSibling<T>()	Obtient l’élément OpenXmlElement avec le type spécifié qui suit l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’y a pas d’élément OpenXmlElement suivant. (Hérité de OpenXmlElement)
PrependChild<T>(T)	Insère l’élément spécifié au début de la liste des éléments enfants de l’élément actuel. (Hérité de OpenXmlElement)
PreviousSibling()	Obtient l’élément OpenXmlElement qui précède immédiatement l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic ) s’il n’existe aucun élément OpenXmlElement précédent. (Hérité de OpenXmlElement)
PreviousSibling<T>()	Obtient l’élément OpenXmlElement avec le type spécifié qui précède l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement précédent. (Hérité de OpenXmlElement)
Remove()	Supprime l’élément actuel de son parent. (Hérité de OpenXmlElement)
RemoveAllChildren()	Supprime tous les éléments enfants de l’élément actuel. (Hérité de OpenXmlLeafElement)
RemoveAllChildren<T>()	Supprimez tous les éléments enfants de l’élément actuel qui sont de type T. (Hérité de OpenXmlElement)
RemoveAnnotations(Type)	Supprime les annotations du type spécifié de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
RemoveAnnotations<T>()	Supprime les annotations avec le type spécifié de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
RemoveAttribute(String, String)	Supprime l’attribut de l’élément actuel. (Hérité de OpenXmlElement)
RemoveChild<T>(T)	Supprime l’élément enfant spécifié de la liste des éléments enfants de l’élément actuel. (Hérité de OpenXmlElement)
RemoveNamespaceDeclaration(String)	Supprime la déclaration d’espace de noms pour le préfixe spécifié. Ne supprime rien s’il n’y a pas de préfixe. (Hérité de OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Remplace un élément enfant par un autre élément enfant dans la liste d’éléments enfants de l’élément actuel. (Hérité de OpenXmlElement)
SetAttribute(OpenXmlAttribute)	Définit un attribut sur l’élément spécifié. Si l’attribut est un attribut connu, la valeur de l’attribut est définie. Si l’attribut est un attribut étendu, l’attribut « openxmlAttribute » est ajouté à la liste des attributs étendus. (Hérité de OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Définit un certain nombre d’attributs à l’élément . Si un attribut est un attribut connu, la valeur de l’attribut est définie. Si un attribut est un attribut étendu, l’attribut « openxmlAttribute » est ajouté à la liste des attributs étendus. (Hérité de OpenXmlElement)
WriteTo(XmlWriter)	Enregistre le nœud actuel dans le XmlWriter spécifié. (Hérité de OpenXmlElement)

Implémentations d’interfaces explicites

IEnumerable.GetEnumerator()	Bordure de paragraphe au-dessus de paragraphes identiques. Cette classe est disponible dans Office 2007 et versions ultérieures. Lorsque l’objet est sérialisé au format xml, son nom qualifié est w :top. (Hérité de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Retourne un énumérateur qui itère au sein de la collection enfant. (Hérité de OpenXmlElement)