Level Classe

Définition

Espace de noms:

DocumentFormat.OpenXml.Wordprocessing

Assembly:

DocumentFormat.OpenXml.dll

Paquet:

DocumentFormat.OpenXml v3.0.1

Définition du niveau de numérotation.

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

public class Level : DocumentFormat.OpenXml.OpenXmlCompositeElement

type Level = class
    inherit OpenXmlCompositeElement

Public Class Level
Inherits OpenXmlCompositeElement

Héritage

Object

OpenXmlElement

OpenXmlCompositeElement

Level

Remarques

[ISO/IEC 29500-1 1st Edition]

lvl (Définition de remplacement du niveau de numérotation)

Cet élément spécifie l’apparence et le comportement d’un niveau de numérotation spécifique dans un remplacement de définition de niveau de numérotation donné défini à l’aide de l’élément lvlOverride (§17.9.9).

Une définition de remplacement de niveau de numérotation est identique à une définition de niveau de numérotation, à l’exception du fait qu’elle est définie dans le cadre d’une définition de numérotation instance à l’aide de l’élément num (§17.9.16) plutôt que dans le cadre d’une définition de numérotation abstraite utilisant l’élément abstractNum (§17.9.1).

[Exemple : Considérez une définition de numérotation instance qui hérite de ses informations de la définition de numérotation abstraite avec abstractNumId de 4, mais doit utiliser un autre ensemble de propriétés pour le niveau 0 de la définition de numérotation. Le WordprocessingML obtenu se présente comme suit :

<w:num w:numId="6">  
  <w:abstractNumId w:val="4" />  
  <w:lvlOverride w:ilvl="0">  
    <w:lvl w:ilvl="0">  
      <w:start w:val="4" />  
      <w:lvlText w:val="%1)" />  
      <w:lvlJc w:val="left" />  
      <w:pPr>  
        <w:ind w:left="360" w:hanging="360" />  
      </w:pPr>  
    </w:lvl>  
  </w:lvlOverride>  
</w:num>  

Cette définition de numérotation instance remplace le niveau 0 de la liste par la définition de remplacement de niveau de numérotation spécifiée, en remplaçant ceux de la définition abstraite du niveau de numérotation. Fin de l’exemple]

[Remarque : la possibilité de définir des remplacements de niveau optimise l’utilisation de la numérotation dans WordprocessingML, car elle empêche l’écriture de définitions de numérotation abstraites redondantes si les jeux de numérotation diffèrent légèrement.

Envisagez d’utiliser WordprocessingML pour créer deux jeux numérotés qui diffèrent uniquement par l’apparence et le style du premier niveau de numérotation. Les deux peuvent utiliser la même définition de numérotation abstraite tant que chacune fait référence à une définition de numérotation différente instance avec l’une des instances de définition de numérotation tirant parti d’un remplacement de niveau pour le premier niveau de numérotation. Voici WordprocessingML qui illustre ce qui suit :

<w:num w:numId="5">  
  <w:abstractNumId w:val="4" />  
</w:num>  
<w:num w:numId="6">  
  <w:abstractNumId w:val="4" />  
  <w:lvlOverride w:ilvl="0">  
    <w:lvl w:ilvl="0">  
      <w:start w:val="4" />  
      <w:lvlText w:val="%1)" />  
      <w:lvlJc w:val="left" />  
      <w:pPr>  
        <w:ind w:left="360" w:hanging="360" />  
      </w:pPr>  
    </w:lvl>  
  </w:lvlOverride>  
</w:num>  

Fin de la remarque]

Éléments parents
lvlOverride (§17.9.9)

Éléments enfants	Paragraphe
isLgl (Afficher tous les niveaux à l’aide de chiffres arabes)	§17.9.4
hérité (propriétés de niveau de numérotation héritées)	§17.9.5
lvlJc (Justification)	§17.9.8
lvlPicBulletId (Référence de définition de symbole de numérotation d’image)	§17.9.10
lvlRestart (Symbole de niveau de numérotation de redémarrage)	§17.9.11
lvlText (Texte de niveau de numérotation)	§17.9.12
numFmt (Format de numérotation)	§17.9.18
pPr (propriétés de paragraphe associées au niveau de la numérotation)	§17.9.23
pStyle (niveau de numérotation associé du style de paragraphe)	§17.9.24
rPr (Propriétés d’exécution du symbole de numérotation)	§17.9.25
start (valeur de départ)	§17.9.26
suff (contenu entre le symbole de numérotation et le texte du paragraphe)	§17.9.29

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

[ISO/IEC 29500-1 1st Edition]

lvl (Définition du niveau de numérotation)

Cet élément spécifie l’apparence et le comportement d’un niveau de numérotation dans une définition de numérotation abstraite donnée. Un niveau de numérotation contient un ensemble de propriétés pour l’affichage de la numérotation d’un niveau de numérotation donné dans une définition de numérotation abstraite.

Une définition de niveau de numérotation est identique à une définition de remplacement de niveau de numérotation, à l’exception du fait qu’elle est définie dans le cadre d’une définition de numérotation instance à l’aide de l’élément abstractNum (§17.9.1) plutôt que dans le cadre d’une définition de numérotation abstraite utilisant l’élément num (§17.9.16).

[Exemple : Considérez wordprocessingML ci-dessous :

<w:abstractNum w:abstractNumId="4">  
  <w:nsid w:val="1DE04504" />  
  <w:multiLevelType w:val="hybridMultilevel" />  
  <w:lvl w:ilvl="0" w:tplc="">  
    …  </w:lvl>  
  <w:lvl w:ilvl="1" w:tplc="04090019">  
    …  </w:lvl>  
  <w:lvl w:ilvl="2" w:tplc="04090019">  
    …  </w:lvl>  
  <w:lvl w:ilvl="3" w:tplc="">  
    …  </w:lvl>  
  …</w:abstractNum>  

Cet exemple montre que tout paragraphe dont les propriétés de numérotation utilisent les éléments ilvl dont l’attribut val est égal à 0, 1, 2 ou 3 a l’apparence et le comportement de leurs quatre premiers niveaux numérotés spécifiés par les éléments lvl ci-dessus (en supposant qu’aucun remplacement de niveau n’a été spécifié). Fin de l’exemple]

Éléments parents
abstractNum (§17.9.1)

Éléments enfants	Paragraphe
isLgl (Afficher tous les niveaux à l’aide de chiffres arabes)	§17.9.4
hérité (propriétés de niveau de numérotation héritées)	§17.9.5
lvlJc (Justification)	§17.9.8
lvlPicBulletId (Référence de définition de symbole de numérotation d’image)	§17.9.10
lvlRestart (Symbole de niveau de numérotation de redémarrage)	§17.9.11
lvlText (Texte de niveau de numérotation)	§17.9.12
numFmt (Format de numérotation)	§17.9.18
pPr (propriétés de paragraphe associées au niveau de la numérotation)	§17.9.23
pStyle (niveau de numérotation associé du style de paragraphe)	§17.9.24
rPr (Propriétés d’exécution du symbole de numérotation)	§17.9.25
start (valeur de départ)	§17.9.26
suff (contenu entre le symbole de numérotation et le texte du paragraphe)	§17.9.29

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

ISO/IEC29500 : 2008.

Constructeurs

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

Propriétés

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)
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)
IsLegalNumberingStyle	Afficher tous les niveaux à l’aide de chiffres arabes. Représente la balise d’élément suivante dans le schéma : w :isLgl.
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)
LegacyNumbering	Propriétés de niveau de numérotation héritées. Représente la balise d’élément suivante dans le schéma : w :legacy.
LevelIndex	Niveau de numérotation Représente l’attribut suivant dans le schéma : w :ilvl
LevelJustification	Justification. Représente la balise d’élément suivante dans le schéma : w :lvlJc.
LevelPictureBulletId	Informations de référence sur la définition du symbole de numérotation d’image. Représente la balise d’élément suivante dans le schéma : w :lvlPicBulletId.
LevelRestart	Redémarrer le symbole de niveau de numérotation. Représente la balise d’élément suivante dans le schéma : w :lvlRestart.
LevelSuffix	Contenu entre le symbole de numérotation et le texte du paragraphe. Représente la balise d’élément suivante dans le schéma : w :suff.
LevelText	Texte au niveau de la numérotation. Représente la balise d’élément suivante dans le schéma : w :lvlText.
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)
NumberingFormat	Format de numérotation. Représente la balise d’élément suivante dans le schéma : w :numFmt.
NumberingSymbolRunProperties	Propriétés d’exécution du symbole de numérotation. Représente la balise d’élément suivante dans le schéma : w :rPr.
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)
ParagraphStyleIdInLevel	Niveau de numérotation associé au style de paragraphe. Représente la balise d’élément suivante dans le schéma : w :pStyle.
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)
PreviousParagraphProperties	Propriétés de paragraphe associées au niveau de la numérotation. Représente la balise d’élément suivante dans le schéma : w :pPr.
StartNumberingValue	Valeur de départ. Représente la balise d’élément suivante dans le schéma : w :start.
TemplateCode	Code de modèle Représente l’attribut suivant dans le schéma : w :tplc
Tentative	Numérotation provisoire Représente l’attribut suivant dans le schéma : w :tentative
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éfinition du niveau de numérotation. 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 :lvl. (Hérité de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Retourne un énumérateur qui itère au sein de la collection enfant. (Hérité de OpenXmlElement)