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

CommentReference - Classe

Office 2013 et versions ultérieures

Cette documentation est préliminaire et peut changer.

Contenu marque d'annotation. Lorsque l'objet est sérialisé en XML, son nom complet est w:commentReference.

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

public class CommentReference : MarkupType

[ISO/IEC 29500-1 1st Edition]

commentReference (Comment Content Reference Mark)

Cet élément indique la présence d'une contenu marque de référence, qui lie le contenu du commentaire (§17.13.4.2) avec le contenu d'un article d'un document. Ce lien est établi en faisant correspondre le commentaire dont l'attribut id correspond à l'attribut id de cet élément. Le commentaire qui en résulte est ancré à la plage avec éléments de plage de commentaire avec les mêmes valeurs d'attribut de code (si présent) comme suit :

  • Si les deux éléments commentRangeStart et commentRangeEnd (§17.13.4.4, §17.13.4.3) sont présents, la référence de commentaire est ancrez le commentaire à la plage résultante.

  • Si seul l'un des éléments commentRangeStart et commentRangeEnd (§17.13.4.4, §17.13.4.3) est présent, le document est non conforme.

  • Si aucun élément n'est présent, la référence de commentaire s'ancrer le commentaire à son emplacement actuel.

Si cet élément apparaît dans un article de contenu de commentaire (§17.13.4.2), il peut être ignoré. Si aucun commentaire n'existe avec un attribut id qui correspond à l'attribut id de cet élément, ce document est non conforme.

[Exemple: pensez à un paragraphe dans un document WordprocessingML dont le deuxième mot est annoté avec un commentaire :

Le fragment de WordprocessingML pour ce commentaire est défini comme suit :

<w:p>
  <w:r>
    <w:t xml:space="preserve">Some </w:t>
  </w:r>
  <w:commentRangeStart w:id="0" />
  <w:r>
    <w:t>text.</w:t>
  </w:r>
  <w:commentRangeEnd w:id="0" />
  <w:r>
    <w:commentReference w:id="0" />
  </w:r>
</w:p>

L'élément commentReference indique que le commentaire associé dans la partie commentaires doit être le commentaire dont valeur de l'attribut id a la valeur 0. Ainsi, dans la mesure où une marque de début et de fin avec un ID de rapprochement, ce commentaire est ancré à cette région du document. exemple de fin]

Éléments parents

r (§22.1.2.87) ; r (§17.3.2.25)

Attributs

Description

ID (identificateur d'Annotation)

Spécifie l'identificateur unique d'une annotation au sein d'un document WordprocessingML. Les restrictions de l'attribut id, le cas échéant, sont définies par l'élément XML parent.

Si cet attribut est omis, le document est non conforme.

[Exemple: envisager une annotation représentée à l'aide du fragment de WordprocessingML suivant :

<… w:id="1" … >
  …
</…>

L'attribut id Spécifie que l'ID de l'annotation en cours est 1. Cette valeur est utilisée pour identifier de manière unique cette annotation dans le contenu du document. exemple de fin]

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

[Remarque: le W3C XML Schema definition de cet élément modèle de contenu (CT_Markup) 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: