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

FieldChar - Classe

Office 2013 et versions ultérieures

Cette documentation est préliminaire et peut changer.

Caractère du champ complexe. Lorsque l'objet est sérialisé en XML, son nom complet est w:fldChar.

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

[ChildElementInfoAttribute(typeof(FormFieldData))]
[ChildElementInfoAttribute(typeof(NumberingChange))]
[ChildElementInfoAttribute(typeof(FieldData))]
public class FieldChar : OpenXmlCompositeElement

[ISO/IEC 29500-1 1st Edition]

fldChar (caractère complexe de champ)

Cet élément spécifie la présence d'un caractère complexe de champ à l'emplacement actuel dans l'objet parent s'exécutent. Un caractère complexe de champs est un caractère spécial qui délimite le début et la fin d'un champ complexe ou sépare les codes son résultat de champ en cours.

Un champ complexe est défini via l'utilisation de ces deux caractères de champ complexe obligatoire : un caractère de début, qui spécifie le début d'un champ complexe dans le contenu du document ; et un caractère de fin, ce qui indique la fin d'un champ complexe. Cette syntaxe permet de plusieurs champs soit incorporée (ou « imbriqués ») entre eux dans un document.

Ainsi, car un champ complexe peut spécifier les codes de champ et son résultat dans le document en cours, ces deux éléments sont séparés par le facultatif caractère de séparation, qui définit la fin des codes de champ et le début du contenu du champ. L'omission de ce caractère est utilisée pour spécifier que le contenu du champ est entièrement les codes de champ (par exemple, le champ n'a aucun résultat).

[Exemple: considérez la définition suivante de champ complexes au sein d'un document WordprocessingML :

<w:r>
  <w:fldChar w:fldCharType="begin" />
</w:r>
<w:r>
  <w:instrText>AUTHOR</w:instrText>
</w:r>
<w:r>
  <w:fldChar w:fldCharType="separate" />
</w:r>
<w:r>
  <w:t>Rex Jaeschke</w:t>
</w:r>
<w:r>
  <w:fldChar w:fldCharType="end" />
</w:r>

Les trois éléments de fldChar spécifient :

  • Au début du champ, à l'aide de la valeur de l'attribut type de démarrage

  • Le séparateur entre les codes de champ et les valeurs de champ actuelles, à l'aide de la valeur de l'attribut type de distinct

  • La fin du champ, à l'aide de la valeur de l'attribut type de fin

Fin de l’exemple]

Si un caractère complexe champ est situé à un emplacement inapproprié dans un document WordprocessingML, puis sa présence doit être ignorée et aucun champ ne doit être présent dans le document lorsqu'il est affiché. En outre, si un champ complexe n'est pas fermé avant la fin d'un article d'un document, aucun champ ne doit être générée et chaque exécution individuelle doit être traitée comme si les caractères de champ n'existent pas (c'est-à-dire le contenu de tous les codes de champ contenus exécution ne doit pas s'afficher et le champ résultats doivent être affichées comme du texte littéral).

[Exemple: considérez le document WordprocessingML suivant :

<w:body>
  <w:p>
    <w:r>
      <w:fldChar w:fldCharType="start" />
    </w:r>
    <w:r>
      <w:instrText>AUTHOR</w:instrText>
    </w:r>
    <w:r>
      <w:fldChar w:fldCharType="separate" />
    </w:r>
    <w:r>
      <w:t>Rex Jaeschke</w:t>
    </w:r>
  </w:p>
</w:body>

Le champ complexe est techniquement incorrect dans la mesure où il n'existe aucun caractère de fin dans l'histoire principale du document. Le contenu qui en résulte doit être interprété comme si le champ n'existe aucun caractère, ce qui se traduit uniquement le texte littéral Rex Jaeschke affiché dans le document. exemple de fin]

Éléments parents

r (§22.1.2.87) ; r (§17.3.2.25)

Élements enfants

Sous-clause

les formats ffData (propriétés de champ de formulaire)

§17.16.17

Attributs

Description

Dirty (champ invalidé de résultat)

Indique que ce champ a été marqué par une application pour indiquer que ses résultats actuels ne sont plus corriger (obsolètes) en raison des modifications apportées au document, et ces matières doivent être mises à jour avant qu'ils ne s'affichent pas si cette fonctionnalité est prise en charge par l'application de traitement suivante.

[Raisonnement: cette fonctionnalité permet aux applications avec des sous-ensembles limitées des fonctionnalités complètes de /IEC 29500 traiter des documents Word Open XML sans avoir besoin de comprendre et de mettre à jour tous les champs en fonction de la sémantique de leurs codes de champ.

Par exemple, une application peut ajouter un nouveau paragraphe et indicateur de la table des matières comme modifiée, sans avoir besoin de connaître quoi que ce soit sur comment recalculer le contenu de ce champ. fin du raisonnement]

Si cet attribut est omis, sa valeur doit être supposée avoir la valeur false. Si le type du caractère de champ en cours n'est pas Démarrer, ce paramètre peut être ignoré.

[Exemple: le schéma WordprocessingML suivant pour un champ complexe de prendre en compte :

…<w:r>
  <w:fldChar w:fldCharType="start" w:dirty="true"/>
</w:r>
<w:r>
  <w:instrText>
 /l 1-3</w:instrText>
</w:r>
<w:r>
  <w:fldChar w:fldCharType="separate"/>
</w:r>
…

L'attribut modifié la valeur true Spécifie que la valeur de ce champ n'est plus en cours en fonction du contenu du document et doit être recalculée chaque fois qu'une application grâce à cette fonctionnalité lit le document. exemple de fin]

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

fldCharType (Type de caractères de champ)

Spécifie le type du caractère complexe de champ en cours dans le document.

[Exemple: considérez le schéma WordprocessingML suivant un caractère complexe de champ :

…<w:fldChar w:fldCharType="separate" />
…

La valeur de l'attribut type de séparé Spécifie qu'il s'agit d'un séparateur de champ complexe ; Par conséquent, il est utilisé pour séparer les codes de champ à partir du contenu du champ dans un champ complexe. exemple de fin]

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

fldLock (doivent être recalculées champ)

Spécifie que le champ complexe parent n'aura pas son résultat de champ recalculé, même si une application tente de recalculer les résultats de tous les champs dans le document ou si un nouveau calcul est demandé explicitement.

Si cet attribut est omis, sa valeur doit être supposée avoir la valeur false. Si le type du caractère de champ en cours n'est pas Démarrer, ce paramètre peut être ignoré.

[Exemple: le schéma WordprocessingML suivant pour un champ complexe de prendre en compte :

<w:r>
  <w:fldChar w:fldCharType="start" w:fldLock="true"/>
</w:r>
…<w:r>
  <w:fldChar w:fldCharType="separate"/>
</w:r>
<w:r>
  <w:t>field result</w:t>
</w:r>
<w:r>
  <w:fldChar w:fldCharType="end" />
</w:r>

La valeur de l'attribut fldLock de la valeur true Spécifie que la valeur de ce champ doit rester résultat de champ quel que soit le résultat réel des codes de champ en cours. exemple de fin]

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

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