TableCellBorders Classe

Définition

Espace de noms:

DocumentFormat.OpenXml.Wordprocessing

Assembly:

DocumentFormat.OpenXml.dll

Paquet:

DocumentFormat.OpenXml v3.0.1

Définit la classe TableCellBorders.

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 :tcBorders.

public class TableCellBorders : DocumentFormat.OpenXml.OpenXmlCompositeElement

type TableCellBorders = class
    inherit OpenXmlCompositeElement

Public Class TableCellBorders
Inherits OpenXmlCompositeElement

Héritage

Object

OpenXmlElement

OpenXmlCompositeElement

TableCellBorders

Remarques

[ISO/IEC 29500-1 1st Edition]

tcBorders (Bordures de cellule de tableau)

Cet élément spécifie l’ensemble de bordures pour les bords de la cellule de tableau actuelle, à l’aide des huit types de bordures définis par ses éléments enfants.

Si l’espacement des cellules d’une ligne est différent de zéro comme spécifié à l’aide de l’élément tblCellSpacing (§17.4.45 ; §17.4.44 ; §17.4.46), il n’y a jamais de conflit de bordure (car l’espacement des cellules non nul est appliqué au-dessus et au-delà de la largeur de chaque bordure de cellule individuelle) et toutes les bordures de table, d’exception au niveau du tableau et de cellule de tableau doivent être affichées.

Si l’espacement des cellules est égal à zéro, il peut y avoir un conflit entre deux bordures de cellules adjacentes [Exemple : Entre la bordure gauche de toutes les cellules de la deuxième colonne et la bordure droite de toutes les cellules de la première colonne du tableau. end example], qui doit être résolu comme suit :

Si la bordure de cellule de tableau en conflit est nulle ou nulle (aucune bordure), la bordure opposée s’affiche.

Si une bordure de cellule est en conflit avec une bordure de tableau, la bordure de cellule gagne toujours.

Une pondération est ensuite affectée à chaque bordure à l’aide de la formule suivante, et la valeur de bordure utilisant ce calcul est affichée sur la bordure alternative :

Le numéro de bordure est déterminé par cette liste :

Seul

1

Épais

2

double

3

Pointillé

4

Pointillés

5

dotDash

6

dotDotDash

7

Triple

8

thinThickSmallGap

9

thickThinSmallGap

10

thinThickThinSmallGap

11

thinThickMediumGap

12

thickThinMediumGap

13

thinThickThinMediumGap

14

thinThickLargeGap

15

thickThinLargeGap

16

thinThickThinLargeGap

17

Vague

18

doubleWave

19

dashSmallGap

20

dashDotStroked

21

threeDEmboss

22

threeDEngrave

23

Début

24

Encart

25

Si les bordures ont un poids égal, le plus élevé des deux sur cette liste de précédence gagnera :

Seul

Épais

double

Pointillé

Pointillés

dotDash

dotDotDash

Triple

thinThickSmallGap

thickThinSmallGap

thinThickThinSmallGap

thinThickMediumGap

thickThinMediumGap

thinThickThinMediumGap

thinThickLargeGap

thickThinLargeGap

thinThickThinLargeGap

Vague

doubleWave

dashSmallGap

dashDotStroked

threeDEmboss

threeDEngrave

Début

Encart

Si les bordures ont un style identique, une valeur de luminosité doit être affectée à chaque couleur de bordure comme suit :La couleur avec la valeur de luminosité inférieure gagne.

Si les bordures ont une valeur de luminosité identique ci-dessus, chaque couleur de bordure se voit attribuer une nouvelle valeur de luminosité comme suit :La couleur avec la valeur de luminosité plus faible gagne.

Si les bordures ont une valeur de luminosité identique au-dessus, une valeur de luminosité est affectée à chaque couleur de bordure comme suit :La couleur avec la valeur de luminosité plus faible gagne.

Si les bordures ont une valeur de luminosité identique ci-dessus, elles sont fonctionnellement identiques et la première bordure dans l’ordre de lecture doit être affichée.

[Exemple : Considérez la table des deux cellules suivante (avec un espacement exagéré des cellules du tableau pour plus de clarté) :

Si l’on réduit l’espacement des cellules, il y a des bordures conflictuelles à tous les bords. Pour chaque conflit de bordure de cellule/table, la règle n° 2 indique que la bordure de cellule doit gagner. Pour le conflit au centre entre deux bordures de cellule, la règle n°3 nous donne un poids de bordure plus élevé pour la bordure de la cellule droite, ce qui donne le tableau suivant :

Fin de l’exemple]

Si cet élément est omis, cette table doit avoir les bordures spécifiées par le style de tableau associé. Si aucune bordure n’est spécifiée dans la hiérarchie de style, cette table n’a pas de bordures de table.

[Exemple : Prenons un tableau dont la première cellule spécifie des bordures au niveau de la cellule composées d’une ligne rouge double, comme suit :

Ces bordures de cellule sont spécifiées à l’aide du wordprocessingML suivant :

<w:tcPr>  
  <w:tcBorders>  
    <w:top w:val="double" w:sz="24" w:space="0" w:color="FF0000"/>  
    <w:left w:val="double" w:sz="24" w:space="0" w:color="FF0000"/>  
    <w:bottom w:val="double" w:sz="24" w:space="0" w:color="FF0000"/>  
    <w:right w:val="double" w:sz="24" w:space="0" w:color="FF0000"/>  
  </w:tcBorders>  
</w:tcPr>  

L’élément tcBorders spécifie l’ensemble de bordures appliquées à la première cellule sous la forme d’une bordure double à 3 points. Fin de l’exemple]

Éléments parents
tcPr (§17.7.6.8) ; tcPr (§17.7.6.9) ; tcPr (§17.4.70) ; tcPr (§17.4.71)

Éléments enfants	Paragraphe
bottom (Bordure inférieure de la cellule de tableau)	§17.4.3
end (Bordure du bord de fin de la cellule de table)	§17.4.12
insideH (Cellule de tableau à l’intérieur de la bordure des bords horizontaux)	§17.4.24
insideV (Cellule de tableau à l’intérieur de la bordure des bords verticaux)	§17.4.26
start (Bordure de bord avant de la cellule de tableau)	§17.4.34
tl2br (Cellule de tableau en haut à gauche vers la bordure diagonale inférieure droite)	§17.4.74
top (Bordure supérieure de la cellule de tableau)	§17.4.75
tr2bl (bordure diagonale de la cellule de tableau en haut à droite à gauche)	§17.4.80

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

ISO/IEC29500 : 2008.

Constructeurs

TableCellBorders()	Initialise une nouvelle instance de la classe TableCellBorders.
TableCellBorders(IEnumerable<OpenXmlElement>)	Initialise une nouvelle instance de la classe TableCellBorders avec les éléments enfants spécifiés.
TableCellBorders(OpenXmlElement[])	Initialise une nouvelle instance de la classe TableCellBorders avec les éléments enfants spécifiés.
TableCellBorders(String)	Initialise une nouvelle instance de la classe TableCellBorders à partir du code XML externe.

Propriétés

BottomBorder	Bordure inférieure de la cellule de tableau. Représente la balise d’élément suivante dans le schéma : w :bottom.
ChildElements	Obtient tous les nœuds enfants de l’élément actuel. (Hérité de OpenXmlElement)
EndBorder	EndBorder, cette propriété est disponible uniquement dans Office 2010 et versions ultérieures. Représente la balise d’élément suivante dans le schéma : w :end.
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 actuel. (Hérité de OpenXmlCompositeElement)
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 OpenXmlCompositeElement)
InnerText	Obtient ou définit les valeurs concaténées du nœud actuel et de tous ses enfants. (Hérité de OpenXmlCompositeElement)
InnerXml	Obtient ou définit le balisage qui représente uniquement les nœuds enfants du nœud actuel. (Hérité de OpenXmlCompositeElement)
InsideHorizontalBorder	Cellule de tableau à l’intérieur de la bordure des bords horizontaux. Représente la balise d’élément suivante dans le schéma : w :insideH.
InsideVerticalBorder	Cellule de tableau à l’intérieur de la bordure des bords verticaux. Représente la balise d’élément suivante dans le schéma : w :insideV.
LastChild	Obtient le dernier enfant de l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement de ce type. (Hérité de OpenXmlCompositeElement)
LeftBorder	Bordure gauche de la cellule de tableau. Représente la balise d’élément suivante dans le schéma : w :left.
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)
RightBorder	Bordure droite de la cellule de tableau. Représente la balise d’élément suivante dans le schéma : w :right.
StartBorder	StartBorder, cette propriété est disponible uniquement dans Office 2010 et versions ultérieures. Représente la balise d’élément suivante dans le schéma : w :start.
TopBorder	Bordure supérieure de la cellule de tableau. Représente la balise d’élément suivante dans le schéma : w :top.
TopLeftToBottomRightCellBorder	Cellule de tableau De haut à gauche vers la bordure diagonale inférieure droite. Représente la balise d’élément suivante dans le schéma : w :tl2br.
TopRightToBottomLeftCellBorder	Cellule de tableau Bordure diagonale supérieure droite à gauche en bas. Représente la balise d’élément suivante dans le schéma : w :tr2bl.
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)
AddChild(OpenXmlElement, Boolean)	Ajoute l’élément spécifié à l’élément s’il s’agit d’un enfant connu. Cela ajoute l’élément à l’emplacement approprié en fonction du schéma. (Hérité de OpenXmlCompositeElement)
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 OpenXmlCompositeElement)
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 OpenXmlCompositeElement)
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é des enfants de l’élément actuel. (Hérité de OpenXmlCompositeElement)
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 OpenXmlCompositeElement)
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 nœuds enfants de l’élément actuel. (Hérité de OpenXmlCompositeElement)
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 OpenXmlCompositeElement)
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é. (Hérité de OpenXmlCompositeElement)
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 l’un des éléments enfants de l’élément actuel par un autre élément OpenXmlElement. (Hérité de OpenXmlCompositeElement)
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()	Définit la classe TableCellBorders. 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 :tcBorders. (Hérité de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Retourne un énumérateur qui itère au sein de la collection enfant. (Hérité de OpenXmlElement)