Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

HeaderReference - Classe

Office 2013 et versions ultérieures

Cette documentation est préliminaire et peut changer.

Référence de l'en-tête. Lorsque l'objet est sérialisé en XML, son nom complet est w:headerReference.

Espace de noms :  DocumentFormat.OpenXml.Wordprocessing
Assembly :  DocumentFormat.OpenXml (dans DocumentFormat.OpenXml.dll)

public class HeaderReference : HeaderFooterReferenceType

[ISO/IEC 29500-1 1st Edition]

headerReference (Header Reference)

Cet élément spécifie un en-tête unique qui doit être associé à la section en cours dans le document. Cet en-tête doit être référencé via l'attribut id, qui spécifie une relation explicite à la partie en-tête appropriée dans le package de WordprocessingML.

Si le type de relation de la relation spécifiée par cet élément n’est pas http://schemas.openxmlformats.org/officeDocument/2006/header, s’il n’est pas présent, ou s’il n’a pas la valeur d’attribut Internal pour TargetMode, le document est considéré non conforme.

Dans chaque section d'un document jusqu'à trois différents types d'en-têtes peuvent être :

  • En-tête de la première page

  • En-tête de page impaire

  • En-tête des pages paires

Le type d'en-tête spécifié par le headerReference en cours est spécifié via l'attribut type.

Si un type d’en-tête est omis pour une section donnée, les règles suivantes s’appliquent.

  • Si aucun headerReference pour le premier en-tête de page n'est spécifié et que l'élément titlePg est spécifié, l'en-tête de la première page est hérité à partir de la section précédente ou, s'il s'agit de la première section du document, un nouvel en-tête vide est créé. Si l'élément titlePg n'est pas spécifié, puis aucun en-tête de première page ne doit être indiquée, et l'en-tête de page impaire doit être utilisée à la place.

  • Si aucun headerReference pour l'en-tête de page paire n'est spécifié et que l'élément evenAndOddHeaders est spécifié, l'en-tête de page pair doit être hérité de la section précédente ou, s'il s'agit de la première section du document, un nouvel en-tête vide est créé. Si l'élément evenAndOddHeaders n'est pas spécifié, puis aucun en-tête de page pair ne doit être indiqué et l'en-tête de page impaire doit être utilisée à la place.

  • Si aucun headerReference pour l'en-tête de page impaire n'est spécifié l'en-tête de page pair est hérité à partir de la section précédente ou, s'il s'agit de la première section du document, un nouvel en-tête vide est créé.

[Exemple : voici la définition d’un document de trois pages comportant un premier en-tête de page, un en-tête de page impaire et un en-tête de page paire qui sont distincts :

Ce document définit trois en-têtes, chacun avoir une relation à partir de la partie du document avec un ID de relation unique, comme indiqué dans le balisage de CONDITIONNEMENT suivant :

<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">
  …
  <Relationship Id="rId2" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/header" Target="header1.xml" />
  <Relationship Id="rId3" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/header" Target="header2.xml" />
  <Relationship Id="rId5" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/header" Target="header3.xml" />
  …
</Relationships>

Ces relations sont ensuite référencées dans les propriétés de la section à l’aide de la syntaxe WordprocessingML suivante :

<w:sectPr>
  …
  <w:headerReference r:id="rId3" w:type="first" />
  <w:headerReference r:id="rId5" w:type="default" />
  <w:headerReference r:id="rId2" w:type="even" />
  …
</w:sectPr>

La section qui en résulte doit utiliser la partie en-tête avec relation id rId3 pour la première page, la partie en-tête avec relation id rId2 pour toutes les pages paires suivantes et la partie en-tête avec relation id rId5 pour toutes les pages impaires ultérieures. exemple de fin]

Éléments parents

sectPr (§17.6.17) ; sectPr (§17.6.18)

Attributs

Description

ID (relation de partie)

Espace de noms : .../officeDocument/2006/relationships

Spécifie l'ID de relation à un composant spécifié.

La relation spécifiée doit correspondre au type de relation requis par l'élément parent :

  • http://schemas.openxmlformats.org/officeDocument/2006/customXml de l'élément contentPart

  • http://schemas.openxmlformats.org/officeDocument/2006/relationships/footer de l'élément footerReference

  • http://schemas.openxmlformats.org/officeDocument/2006/relationships/header de l'élément headerReference

  • http://schemas.openxmlformats.org/officeDocument/2006/relationships/font pour les éléments embedBold, embedBoldItalic, embedItalic ou embedRegular

  • http://schemas.openxmlformats.org/officeDocument/2006/relationships/printerSettings de l'élément de la classe printerSettings

  • http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink pour l'élément longDesc ou le lien hypertexte

[Exemple: pensez à un élément XML qui a l'attribut d'id suivant :

<… r:id="rId10" />

Le balisage Spécifie que la partie relation associée avec l' ID de relation rId1 contient les informations de relation correspondant à l'élément XML parent. exemple de fin]

Les valeurs possibles pour cet attribut sont définies par le type simple ST_RelationshipId (§22.8.2.1).

type (en-tête ou pied de page Type)

Spécifie le type d'en-tête ou de pied de page spécifié par l'ID de relation cible. Ce type d'en-tête/pied de page détermine l'ou les pages sur lesquelles l'en-tête en cours ou le pied de page doit s'afficher.

Si n'importe quelle section contient plus d'un en-tête ou un pied de page de chaque type, puis le document est considéré non conforme.

[Exemple: considérer un document avec le schéma WordprocessingML suivant :

<w:sectPr>
  …
  <w:footerReference r:id="rId6" w:type="first" />
  <w:footerReference r:id="rId7" w:type="first" />
  <w:footerReference r:id="rId10" w:type="even" />
  …
</w:sectPr>

La section qui en résulte a les deux pieds de page de type premieret est donc non conforme. exemple de fin]

[Exemple: pensez à une section de WordprocessingML qui spécifie la référence de l'en-tête suivant :

<w:headerReference r:id="rId10" w:type="first" />

La section qui en résulte doit utiliser la partie en-tête spécifié pour la première page. exemple de fin]

Les valeurs possibles pour cet attribut sont définies par le type simple ST_HdrFtr (§17.18.36).

[Remarque: le W3C XML Schema definition de cet élément modèle de contenu (CT_HdrFtrRef) se trouve dans §A.1. fin de la Remarque]

© ISO/IEC29500: 2008.

Tous les membres statique (Partagé dans Visual Basic)s publics de ce type sont thread-safe. Cela n’est pas garanti pour les membres d’instance.
Afficher: