TableStyle Classe

Définition

Espace de noms:

DocumentFormat.OpenXml.Drawing

Assembly:

DocumentFormat.OpenXml.dll

Paquet:

DocumentFormat.OpenXml v3.0.1

Style de tableau.

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

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

public class TableStyle : DocumentFormat.OpenXml.Drawing.TableStyleType

type TableStyle = class
    inherit TableStyleType

Public Class TableStyle
Inherits TableStyleType

Héritage

Object

OpenXmlElement

OpenXmlCompositeElement

TableStyleType

TableStyle

Remarques

[ISO/IEC 29500-1 1st Edition]

tableStyle (Style de tableau)

Cet élément spécifie un style de tableau particulier. Quatorze éléments composent les informations de style d’un style de tableau donné. Ces quatorze éléments fonctionnent ensemble pour fournir des options de mise en forme visuelle pour les états activé/désactivé des bascules suivantes :

• Première ligne activée/désactivée - Élément associé : firstRow

• Dernière ligne activée/désactivée - Élément associé : lastRow

• Première colonne activée/désactivée - Élément associé : firstCol

• Dernière colonne activée/désactivée - Élément associé : lastCol

• Activation/désactivation de la bande de lignes : éléments associés : band1H, band2H

• Bandes de colonnes activées/désactivées : éléments associés : band1V, band2V

La mise en forme associée à l’élément wholeTbl définit la mise en forme du tableau lorsque toutes les options sont désactivées. Lorsqu’une option est activée, la mise en forme de cette option particulière est appliquée au tableau. Les quatre options de mise en forme spécifiques aux cellules sont activées lorsque des options qui se chevauchent sont activées. Par exemple, lorsque les options de mise en forme de la première ligne et de la première colonne sont activées, toute mise en forme dans la cellule nord-ouest est également appliquée, car il s’agit de la cellule de tableau qui se chevauche lorsque les options de mise en forme de première colonne et de première ligne sont activées.

[Exemple : Prenons l’exemple partiel suivant d’un tblStyle dans DrawingML :

<a:tblStyle styleId="{5940675A-B579-460E-94D1-54222C63F5DA}"  styleName="No Style, Table Grid">  
  <a:wholeTbl>  
    <a:tcTxStyle>  
      <a:fontRef idx="minor">  
        <a:scrgbClr r="0" g="0" b="0"/>  
      </a:fontRef>  
      <a:schemeClr val="tx1"/>  
    </a:tcTxStyle>  
    <a:tcStyle>  
      <a:tcBdr>  
        <a:left>  
          <a:ln w="12700" cmpd="sng">  
            <a:solidFill>  
              <a:schemeClr val="tx1"/>  
            </a:solidFill>  
          </a:ln>  
        </a:left>  

... right, top, bottom, insideH, insideV border information is defined just as the 'left' tag...

    </a:tcBdr>  
    <a:fill>  
      <a:noFill/>  
    </a:fill>  
  </a:tcStyle>  
</a:wholeTbl>  
<a:band1H>  
  <a:tcStyle>  
    <a:tcBdr/>  
  </a:tcStyle>  
</a:band1H>  

... les balises band2H, band1V, band2V, firstCol, firstRow, lastCol, lastRow, neCell, nwCell, seCell, swCell sont toutes définies comme la balise « band1H »

</a:tblStyle>  

Dans cet exemple, vous pouvez obtenir une idée de la définition d’un style de tableau dans son intégralité. Le style de tableau défini ci-dessus crée un style avec uniquement une mise en forme de ligne de 1pt appliquée à toutes les cellules d’un tableau. Notez que la mise en forme activée/désactivée (band1H, band2H, firstCol, etc.) ne définit aucune mise en forme et n’a donc aucun effet sur la table lorsqu’elle est basculée. Fin de l’exemple]

Éléments parents
tblPr (§21.1.3.15)

Éléments enfants	Paragraphe
band1H (bande 1 horizontale)	§20.1.4.2.1
band1V (Bande 1 Vertical)	§20.1.4.2.2
band2H (bande 2 horizontale)	§20.1.4.2.3
band2V (Bande 2 Vertical)	§20.1.4.2.4
extLst (liste d’extensions)	§20.1.2.2.15
firstCol (First Column)	§20.1.4.2.11
firstRow (Première ligne)	§20.1.4.2.12
lastCol (Dernière colonne)	§20.1.4.2.16
lastRow (Dernière ligne)	§20.1.4.2.17
neCell (Cellule Nord-Est)	§20.1.4.2.20
nwCell (Cellule Nord-Ouest)	§20.1.4.2.21
seCell (Cellule Sud-Est)	§20.1.4.2.23
swCell (Southwest Cell)	§20.1.4.2.24
tblBg (arrière-plan de la table)	§20.1.4.2.25
wholeTbl (Table entière)	§20.1.4.2.34

Attributs	Description
styleId (ID de style)	Spécifie un GUID identifiant le style de tableau d’une manière unique. Les valeurs possibles pour cet attribut sont définies par le type simple ST_Guid (§22.9.2.4).
styleName (Name)	Spécifie le nom du style de tableau qui peut apparaître dans l’interface utilisateur identifiant le style pour un utilisateur. Les valeurs possibles de cet attribut sont définies par le type de données string du schéma W3C XML.

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

ISO/IEC29500 : 2008.

Constructeurs

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

Propriétés

Band1Horizontal	Bande 1 Horizontale. Représente la balise d’élément suivante dans le schéma : a :band1H. (Hérité de TableStyleType)
Band1Vertical	Bande 1 Vertical. Représente la balise d’élément suivante dans le schéma : a :band1V. (Hérité de TableStyleType)
Band2Horizontal	Bande 2 Horizontale. Représente la balise d’élément suivante dans le schéma : a :band2H. (Hérité de TableStyleType)
Band2Vertical	Bande 2 Verticale. Représente la balise d’élément suivante dans le schéma : a :band2V. (Hérité de TableStyleType)
ChildElements	Obtient tous les nœuds enfants de l’élément actuel. (Hérité de OpenXmlElement)
ExtendedAttributes	Obtient tous les attributs étendus (attributs non définis dans le schéma) de l’élément actuel. (Hérité de OpenXmlElement)
ExtensionList	Extensionlist. Représente la balise d’élément suivante dans le schéma : a :extLst. (Hérité de TableStyleType)
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)
FirstColumn	Première colonne. Représente la balise d’élément suivante dans le schéma : a :firstCol. (Hérité de TableStyleType)
FirstRow	Première ligne. Représente la balise d’élément suivante dans le schéma : a :firstRow. (Hérité de TableStyleType)
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)
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)
LastColumn	Dernière colonne. Représente la balise d’élément suivante dans le schéma : a :lastCol. (Hérité de TableStyleType)
LastRow	Dernière ligne. Représente la balise d’élément suivante dans le schéma : a :lastRow. (Hérité de TableStyleType)
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)
NortheastCell	Cellule Nord-Est. Représente la balise d’élément suivante dans le schéma : a :neCell. (Hérité de TableStyleType)
NorthwestCell	Cellule Nord-Ouest. Représente la balise d’élément suivante dans le schéma : a :nwCell. (Hérité de TableStyleType)
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)
SoutheastCell	Cellule Sud-Est. Représente la balise d’élément suivante dans le schéma : a :seCell. (Hérité de TableStyleType)
SouthwestCell	Cellule Sud-Ouest. Représente la balise d’élément suivante dans le schéma : a :swCell. (Hérité de TableStyleType)
StyleId	Style ID Représente l’attribut suivant dans le schéma : styleId (Hérité de TableStyleType)
StyleName	Nom Représente l’attribut suivant dans le schéma : styleName (Hérité de TableStyleType)
TableBackground	Arrière-plan de la table. Représente la balise d’élément suivante dans le schéma : a :tblBg. (Hérité de TableStyleType)
WholeTable	Table entière. Représente la balise d’élément suivante dans le schéma : a :wholeTbl. (Hérité de TableStyleType)
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()	Style de tableau. Cette classe est disponible dans Office 2007 et versions ultérieures. Lorsque l’objet est sérialisé au format xml, son nom qualifié est a :tableStyle. (Hérité de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Retourne un énumérateur qui itère au sein de la collection enfant. (Hérité de OpenXmlElement)