Shading Classe

Définition

Espace de noms:

DocumentFormat.OpenXml.Wordprocessing

Assembly:

DocumentFormat.OpenXml.dll

Paquet:

DocumentFormat.OpenXml v3.0.1

Définit la classe Shading.

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

public class Shading : DocumentFormat.OpenXml.OpenXmlLeafElement

type Shading = class
    inherit OpenXmlLeafElement

Public Class Shading
Inherits OpenXmlLeafElement

Héritage

Object

OpenXmlElement

OpenXmlLeafElement

Shading

Remarques

[ISO/IEC 29500-1 1st Edition]

shd (ombrage de paragraphe)

Cet élément spécifie l’ombrage appliqué au contenu du paragraphe.

Cet ombrage se compose de trois composants :

• Couleur d’arrière-plan

• (facultatif) Modèle

• (facultatif) Couleur du motif

L’ombrage obtenu est appliqué en définissant la couleur d’arrière-plan derrière le paragraphe, puis en appliquant la couleur du motif à l’aide du masque fourni par le motif sur cet arrière-plan.

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, aucun ombrage de paragraphe ne doit être appliqué.

[Exemple : Prenons un paragraphe qui doit avoir un arrière-plan composé d’un accentuation de couleur de thème3 avec une couleur de thème accentuée6 superposée à l’aide d’un motif de remplissage de 20 %. Cette exigence est spécifiée à l’aide du wordprocessingML suivant :

<w:pPr>  
  <w:shd w:val="pct20" w:themeColor="accent6" w:themeFill="accent3" />   
</w:pPr>  

Le paragraphe obtenu utilise la couleur d’arrière-plan accentuation3 sous la couleur de motif de premier plan accentuation6 , comme spécifié par le masque de modèle pct20 . Fin de l’exemple]

Éléments parents
pPr (§17.3.1.26) ; pPr (§17.3.1.25) ; pPr (§17.7.5.2) ; pPr (§17.7.6.1) ; pPr (§17.9.23) ; pPr (§17.7.8.2)

Le modèle de contenu de cet élément est défini par la définition de propriétés d’ombrage commune dans §17.3.5.

[ISO/IEC 29500-1 1st Edition]

shd (Exécuter l’ombrage)

Comme l’ombrage de paragraphe, cet élément spécifie l’ombrage appliqué au contenu de l’exécution.

Cet ombrage se compose de trois composants :

• Couleur d’arrière-plan

• (facultatif) Modèle

• (facultatif) Couleur du motif

L’ombrage obtenu est appliqué en définissant la couleur d’arrière-plan derrière le paragraphe, puis en appliquant la couleur du motif à l’aide du masque fourni par le motif sur cet arrière-plan.

Si cet élément n’est pas présent, la valeur par défaut est de laisser la mise en forme appliquée au niveau précédent dans la hiérarchie de style. Si cet élément n’est jamais appliqué dans la hiérarchie de style, l’ombrage de l’exécution ne doit pas être appliqué au contenu de cette exécution.

[Exemple : Prenons l’exemple d’une exécution qui doit avoir un arrière-plan composé d’une couleur de thème accentuant6 avec une couleur de thème text2 superposée à l’aide d’un motif de remplissage de 20 %. Cette exigence est spécifiée à l’aide du wordprocessingML suivant :

<w:pPr>  
  <w:shd w:val="pct20" w:themeColor="text2" w:themeFill="accent6" />   
</w:pPr>  

L’exécution résultante utilise la couleur d’arrière-plan accentuation6 sous la couleur de motif de premier plan text2 , comme spécifié par le masque de modèle pct20 . Fin de l’exemple]

Éléments parents
rPr (§17.3.1.29) ; rPr (§17.3.1.30) ; rPr (§17.5.2.28) ; rPr (§17.9.25) ; rPr (§17.7.9.1) ; rPr (§17.7.5.4) ; rPr (§17.3.2.28) ; rPr (§17.5.2.27) ; rPr (§17.7.6.2) ; rPr (§17.3.2.27)

Le modèle de contenu de cet élément est défini par la définition de propriétés d’ombrage commune dans §17.3.5.

[ISO/IEC 29500-1 1st Edition]

shd (exception d’ombrage de table)

Cet élément spécifie l’ombrage qui doit être appliqué à toutes les cellules de la ligne actuelle dans le cadre d’un ensemble d’exceptions de propriété au niveau du tableau. Comme pour l’ombrage de paragraphe, cette trame de fond doit être appliquée au contenu de l’onglet jusqu’aux bordures du tableau, indépendamment de la présence de texte - contrairement à l’ombrage de cellule, l’ombrage de tableau doit inclure tout remplissage de cellule. Cette propriété doit être remplacée par tout ombrage au niveau de la cellule sur toute cellule de cette ligne (§17.4.33).

Cet ombrage se compose de trois composants :

• Couleur d’arrière-plan

• (facultatif) Modèle

• (facultatif) Couleur du motif

L’ombrage obtenu est appliqué en définissant la couleur d’arrière-plan derrière le paragraphe, puis en appliquant la couleur du motif à l’aide du masque fourni par le motif sur cet arrière-plan.

Si cet élément est omis, l’ombrage des cellules doit être déterminé par les paramètres d’ombrage de cellule au niveau du tableau (§17.4.32) pour le tableau actuel.

[Exemple : Considérez un tableau dans lequel les deux dernières lignes ont un ensemble d’exceptions de propriété au niveau du tableau, ce qui leur donne l’ombrage de la couleur de thème background2 , comme suit :

Cette exception d’ombrage au niveau de la table est spécifiée à l’aide du wordprocessingML suivant :

<w:tblPrEx>  
  <w:jc w:val="left" />   
  <w:shd w:val="clear" w:color="auto" w:fill="EEECE1" w:themeFill="background2" />   
</w:tblPrEx>  

L’élément shd spécifie l’ombrage des cellules avec un motif clair utilisant une couleur de thème d’arrière-plan d’arrière-plan2. Fin de l’exemple]

Éléments parents
tblPrEx (§17.4.61) ; tblPrEx (§17.4.62)

Le modèle de contenu de cet élément est défini par la définition de propriétés d’ombrage commune dans §17.3.5.

[ISO/IEC 29500-1 1st Edition]

shd (ombrage de table)

Cet élément spécifie l’ombrage qui doit être appliqué aux étendues de la table actuelle. Comme pour l’ombrage de paragraphe, cette trame de fond doit être appliquée au contenu de l’onglet jusqu’aux bordures du tableau, indépendamment de la présence de texte - contrairement à l’ombrage de cellule, l’ombrage de tableau doit inclure tout remplissage de cellule. Cette propriété doit être remplacée par toute trame de fond au niveau de la cellule via toutes les exceptions de propriété au niveau de la table (§17.4.31) ; ou sur n’importe quelle cellule de cette ligne (§17.4.33).

Cet ombrage se compose de trois composants :

• Couleur d’arrière-plan

• (facultatif) Modèle

• (facultatif) Couleur du motif

L’ombrage obtenu est appliqué en définissant la couleur d’arrière-plan derrière le paragraphe, puis en appliquant la couleur du motif à l’aide du masque fourni par le motif sur cet arrière-plan.

Si cet élément est omis, les cellules de ce tableau doivent avoir l’ombrage spécifié par le style de tableau associé. Si aucune trame de fond de cellule n’est spécifiée dans la hiérarchie de style, les cellules de ce tableau ne doivent pas avoir d’ombrage de cellule (c’est-à-dire qu’elles doivent être transparentes).

[Exemple : Considérez un tableau dans lequel la première cellule de la première ligne a un ombrage rouge au niveau de la cellule, comme suit :

R1C1

R1C2

R2C1

R2C2

Cette trame de fond de cellule au niveau du tableau est spécifiée à l’aide du wordprocessingML suivant :

<w:tbl>  
  <w:tblPr>  
    <w:shd w:val="clear" w:color="auto" w:fill="FF0000"/>  
    …  </w:tblPr>  
  …</w:tbl>  

L’élément shd spécifie l’ombrage des cellules avec un motif clair utilisant une couleur d’arrière-plan FF0000 (rouge). Fin de l’exemple]

Éléments parents
tblPr (§17.4.60) ; tblPr (§17.4.59) ; tblPr (§17.7.6.4) ; tblPr (§17.7.6.3)

Le modèle de contenu de cet élément est défini par la définition de propriétés d’ombrage commune dans §17.3.5.

[ISO/IEC 29500-1 1st Edition]

shd (ombrage de cellule de tableau)

Cet élément spécifie l’ombrage qui doit être appliqué aux étendues de la cellule de tableau actuelle. Comme pour l’ombrage de paragraphe, cette trame de fond doit être appliquée au contenu de la cellule jusqu’aux bordures de cellule, quelle que soit la présence de texte.

Cet ombrage se compose de trois composants :

• Couleur d’arrière-plan

• (facultatif) Modèle

• (facultatif) Couleur du motif

L’ombrage obtenu est appliqué en définissant la couleur d’arrière-plan derrière le paragraphe, puis en appliquant la couleur du motif à l’aide du masque fourni par le motif sur cet arrière-plan.

Si cet élément est omis, l’ombrage de cellule doit être déterminé par les paramètres d’ombrage de cellule au niveau du tableau ou de l’exception au niveau du tableau (§17.4.31 ;§17.4.32) pour le tableau actuel.

[Exemple : Considérez un tableau dans lequel la première cellule de la première ligne a un ombrage rouge au niveau de la cellule, comme suit :

R1C1

R1C2

R2C1

R2C2

Cette trame de fond de cellule est spécifiée à l’aide du wordprocessingML suivant :

<w:tc>  
  <w:tcPr>  
    <w:shd w:val="clear" w:color="auto" w:fill="FF0000" />  
  </w:tcPr>  
</w:tc>  

L’élément shd spécifie l’ombrage des cellules avec un motif clair utilisant une couleur d’arrière-plan FF0000 (rouge). 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)

Le modèle de contenu de cet élément est défini par la définition de propriétés d’ombrage commune dans §17.3.5.

ISO/IEC29500 : 2008.

Constructeurs

Shading()

Initialise une nouvelle instance de la classe Shading.

Propriétés

ChildElements	Obtient tous les nœuds enfants de l’élément actuel. (Hérité de OpenXmlElement)
Color	Couleur du motif d’ombrage Représente l’attribut suivant dans le schéma : w :color
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)
Fill	Couleur d’arrière-plan de trame de fond Représente l’attribut suivant dans le schéma : w :fill
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)
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)
ThemeColor	Couleur du thème du modèle d’ombrage Représente l’attribut suivant dans le schéma : w :themeColor
ThemeFill	Couleur du thème d’arrière-plan d’ombrage Représente l’attribut suivant dans le schéma : w :themeFill
ThemeFillShade	Nuance de couleur du thème d’arrière-plan Représente l’attribut suivant dans le schéma : w :themeFillShade
ThemeFillTint	Teinte de couleur du thème d’arrière-plan ombrage Représente l’attribut suivant dans le schéma : w :themeFillTint
ThemeShade	Nuance de couleur du thème de modèle d’ombrage Représente l’attribut suivant dans le schéma : w :themeShade
ThemeTint	Teinte de couleur du thème de motif d’ombrage Représente l’attribut suivant dans le schéma : w :themeTint
Val	Modèle d’ombrage Représente l’attribut suivant dans le schéma : w :val
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()	Définit la classe Shading. 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 :shd. (Hérité de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Retourne un énumérateur qui itère au sein de la collection enfant. (Hérité de OpenXmlElement)