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

MoveToRangeStart - Classe

Office 2013 et versions ultérieures

Cette documentation est préliminaire et peut changer.

Définit la classe MoveToRangeStart. Lorsque l'objet est sérialisé en XML, son nom complet est w:moveToRangeStart.

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

public class MoveToRangeStart : MoveBookmarkType

[ISO/IEC 29500-1 1st Edition]

moveToRangeStart (Move Destination Location Container - Start)

Cet élément spécifie le début de la région dont le contenu destination du déplacement font partie d'un seul déplacement nommé. Lorsque la destination de déplacement est stockée sous la forme d'une révision dans un document WordprocessingML, deux types d'informations sont stockées sur cette destination de déplacement :

  • Un ensemble d'éléments de contenu qui ont été déplacés - contenu inline de niveau (§17.13.5.25) et paragraphes (§17.13.5.26)

  • A déplacer le conteneur de destination (ou « signet ») qui spécifie que tout le contenu qu'il contient qui marqué comme destination de déplacement fait partie d'un nom unique se déplace. L'attribut de nom sur les liens de conteneur de déplacer un groupe de déplacer le contenu de destination avec le groupe correspondant de déplacer le contenu de la source.

Cet élément définit le début de la dernière donnée le déplacement révision - le conteneur. L'attribut id de cet élément est utilisé pour lier cet élément à la fin d'un conteneur de destination de déplacement dans le document correspondant.

Les restrictions suivantes sont appliquent à l'utilisation de cet élément

  • Si cet élément se produit sans un élément de moveToRangeEnd correspondant (§17.13.5.27) avec une valeur d'attribut id correspondant, le document est non conforme.

  • Si cet élément et ses extrémités appariées se produisent sans une correspondance déplacer conteneur source (§17.13.5.24 ; §17.13.5.23), puis le document est non conforme.

  • Si plusieurs éléments de démarrage existent avec la même valeur d'attribut id, le document est non conforme.

  • Si plusieurs conteneurs de destination du déplacement entourent le même texte, le document est non conforme.

[Exemple: considérer un document WordprocessingML dans lequel le premier paragraphe contient deux phrases, la première phrase est placée avant la deuxième phrase, et ce déplacement est suivi comme un changement de version, comme suit (dans cette image, soulignement vert indique la destination de déplacement et le barré vert indique l'emplacement source de déplacement) :

Ce document contient la phrase certains déplacés texte. déplacés vers la première phrase du document. Cette révision est représentée en utilisant le schéma WordprocessingML suivant :

<w:p>
  <w:moveToRangeStart w:id="0" … w:name="move1" />
  <w:moveTo w:id="1" … >
    <w:r>
      <w:t>Some moved text.</w:t>
    </w:r>
  </w:moveTo>
  <w:moveToRangeEnd w:id="0" />
  <w:r>
    <w:t xml:space="preserve">Some text.</w:t>
  </w:r>
  <w:moveFromRangeStart w:id="2" … w:name="move1" />
  <w:moveFrom w:id="3" … >
    <w:r>
      <w:t>Some moved text.</w:t>
    </w:r>
  </w:moveFrom>
  <w:moveFromRangeEnd w:id="2" />
</w:p>

L'élément moveToRangeStart indique le début du conteneur de destination de déplacement au sein de laquelle tous les déplacés contenu fait partie du déplacement nommé move1. exemple de fin]

Éléments parents

BDO (§17.3.2.3) ; corps (§17.2.2) ; commentaire (§17.13.4.2) ; customXml (§17.5.1.6) ; customXml (§17.5.1.4) ; customXml (§17.5.1.5) ; customXml (§17.5.1.3) ; deg (§22.1.2.26) ; DEL (§17.13.5.14) ; DEN (§22.1.2.28) ; dir (§17.3.2.8) ; docPartBody (§17.12.6) ; e (§22.1.2.32) ; note de fin (§17.11.2) ; fldSimple (§17.16.19) ; fName (§22.1.2.37) ; note de bas de page (§17.11.10) ; pied (§17.10.3) ; HDR (§17.10.4) ; lien hypertexte (§17.16.22) ; INS (§17.13.5.18) ; Lim (§22.1.2.52) ; moveFrom (§17.13.5.22) ; moveTo (§17.13.5.25) ; Num (§22.1.2.75) ; oMath (§22.1.2.77) ; p (§17.3.1.22) ; RT (§17.3.3.24) ; rubyBase (§17.3.3.27) ; sdtContent (§17.5.2.34) ; sdtContent (§17.5.2.33) ; sdtContent (§17.5.2.35) ; sdtContent (§17.5.2.36) ; smartTag (§17.5.1.9) ; Sub (§22.1.2.112) ; sup (§22.1.2.114) ; TBL (§17.4.38) ; TC (§17.4.66) ; TR (§17.4.79)

Attributs

Description

Author (auteur de l'Annotation)

Spécifie l'auteur d'une annotation au sein d'un document WordprocessingML.

Si cet attribut est omis, aucun auteur n'est associé au type d'annotation parent.

[Exemple: envisagez un commentaire représenté à l'aide du fragment de WordprocessingML suivant :

<… w:id="1" w:author="Example Author">
  …
</…>

L'attribut author Spécifie que l'auteur de l'annotation en cours Exemple auteur, qui peuvent être utilisés selon les besoins. exemple de fin]

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

colFirst (première colonne couverte par signet de tableau)

Spécifie l'index de base zéro de la première colonne de cette ligne qui doit faire partie de ce signet.

Lorsqu'un signet est contenu dans un tableau, il est possible de signet couvrir uniquement les cellules dans une certaine plage de lignes et de colonnes dans cette table, en spécifiant :

  • La première ligne pour laquelle les colonnes spécifiées font partie du signet de la table. Pour cela, vous devez placer l'élément bookmarkStart dans la première cellule de la ligne.

  • La première colonne incluse dans le signet pour chacun l'ou les lignes spécifiée par cet attribut.

  • La dernière colonne incluse dans le signet pour chacun des lignes spécifiés via l'attribut colLast.

  • La dernière ligne dont les colonnes spécifiées font partie du signet de la table. Pour cela, vous devez placer l'élément bookmarkEnd à la fin de cette ligne de tableau.

Si cet attribut s'affiche, puis l'attribut colLast doit également apparaître (quel que soit l'endroit où se trouve ce signet) ou le document est considéré comme non conforme. Si cet attribut et sa paire se produisent sur un signet qui n'est pas contenu dans un tableau, les valeurs doivent être ignorés. Si cette valeur dépasse la valeur de colLast ou le nombre de colonnes dans la table, les deux valeurs doivent être ignorées.

[Exemple: envisagez une ligne trois en tableau à trois colonnes où un signet de tableau doit être appliqué au contenu des deux premières cellules dans les deux premières lignes de la table (les cellules ombrées ci-dessous) :

Ce signet est spécifié en utilisant le schéma WordprocessingML suivant pour conents de la table :

<w:tbl>
  …  <w:tr>
    <w:tc>
      <w:bookMarkStart w:colFirst="0" w:colLast="1" w:id="0" w:name="table"/>
      <w:p/>
    </w:tc>
    <w:tc>
      <w:p/>
    </w:tc>
    <w:tc>
      <w:p/>
    </w:tc>
  </w:tr>
  <w:tr>
    <w:tc>
      <w:p/>
    </w:tc>
    <w:tc>
      <w:p/>
    </w:tc>
    <w:tc>
      <w:p/>
    </w:tc>
    <w:bookmarkEnd w:id="0" />
  </w:tr>
  <w:tr>
    <w:tc>
      <w:p/>
    </w:tc>
    <w:tc>
      <w:p/>
    </w:tc>
    <w:tc>
      <w:p/>
    </w:tc>
  </w:tr>
</w:tbl>

L'attribut colFirst indique que toutes les colonnes commençant par la première colonne doivent être inclus dans le signet de la table. Cela s'applique en commençant par la première ligne et se terminant par la deuxième ligne (deux lignes au début du signet et de fin). exemple de fin]

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

colLast (dernière colonne couverte par signet de tableau)

Spécifie l'index de base zéro de la dernière colonne de cette ligne qui doit faire partie de ce signet.

Lorsqu'un signet est contenu dans un tableau, il est possible de signet couvrir uniquement les cellules dans une certaine plage de lignes et de colonnes dans cette table, en spécifiant :

  • La première ligne pour laquelle les colonnes spécifiées font partie du signet de la table. Pour cela, vous devez placer l'élément bookmarkStart dans la première cellule de la ligne.

  • La première colonne incluse dans le signet pour chacun des lignes spécifiés via l'attribut colFirst.

  • La dernière colonne incluse dans le signet pour chacun l'ou les lignes spécifiée par cet attribut.

  • La dernière ligne dont les colonnes spécifiées font partie du signet de la table. Pour cela, vous devez placer l'élément bookmarkEnd à la fin de cette ligne de tableau.

Si cet attribut s'affiche, puis l'attribut colFirst doit également apparaître (quel que soit l'endroit où se trouve ce signet) ou le document est considéré comme non conforme. Si cet attribut et sa paire se produisent sur un signet qui n'est pas contenu dans un tableau, les valeurs doivent être ignorés. Si cette valeur ne pas être égal à ou dépasse la valeur de colFirst ou le nombre de colonnes de la table, les deux valeurs doivent être ignorées.

[Exemple: envisagez une ligne trois en tableau à trois colonnes où un signet de tableau est apposé sur le contenu des deux premières cellules dans les deux premières lignes de la table (les cellules ombrées ci-dessous) :

Ce signet est spécifié en utilisant le schéma WordprocessingML suivant pour conents de la table :

<w:tbl>
  …  <w:tr>
    <w:tc>
      <w:bookMarkStart w:colFirst="0" w:colLast="1" w:id="0" w:name="table"/>
      <w:p/>
    </w:tc>
    <w:tc>
      <w:p/>
    </w:tc>
    <w:tc>
      <w:p/>
    </w:tc>
  </w:tr>
  <w:tr>
    <w:tc>
      <w:p/>
    </w:tc>
    <w:tc>
      <w:p/>
    </w:tc>
    <w:tc>
      <w:p/>
    </w:tc>
    <w:bookmarkEnd w:id="0" />
  </w:tr>
  <w:tr>
    <w:tc>
      <w:p/>
    </w:tc>
    <w:tc>
      <w:p/>
    </w:tc>
    <w:tc>
      <w:p/>
    </w:tc>
  </w:tr>
</w:tbl>

L'attribut colLast indique que la dernière colonne qui doit être incluse dans le signet de la table est la deuxième colonne. Cela s'applique en commençant par la première ligne et se terminant par la deuxième ligne (deux lignes au début du signet et de fin). exemple de fin]

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

Date (Date d'Annotation)

Spécifie les informations de date d'une annotation au sein d'un document WordprocessingML. L'utilisation de ces informations est en dehors de la portée de /IEC 29500.

Si cet attribut est omis, aucune information de date ne doit être associée au type d'annotation parent.

[Exemple: envisagez un commentaire représenté à l'aide du fragment de WordprocessingML suivant :

<… w:id="1" w:date="2006-01-01T10:00:00">
  …
</…>

L'attribut de date Spécifie que la date de l'annotation en cours est le 1er janvier 2006, qui peut être utilisé comme vous le souhaitez. exemple de fin]

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

displacedByCustomXml (Annotation marqueur déplacé pour personnalisé XML Markup)

Spécifie que placement de l'annotation de parent doit être directement lié à l'emplacement de la présentation physique d'un élément XML personnalisée dans le document. Cet élément n'a d'effet que lorsque l'élément XML personnalisé est au niveau du bloc (c'est-à-dire entoure tout un paragraphe), comme dans ce scénario, le placement physique et logique de l'annotation et les éléments XML personnalisés peut différer.

En particulier, dans ce cas, la partie XML personnalisée est présenté * autour * l'objet au niveau du bloc, il englobe (paragraphe, tableau, ligne de tableau ou cellule de tableau), mais il est physiquement représenté dans que même objet (c'est-à-dire, dans le paragraphe, tableau, ligne de tableau ou cellule de tableau). Cela provient du fait qu'il n'y a pas d'emplacement pour l'emplacement de l'annotation dans le document à son emplacement logique (autour d'une table, par exemple).

Si cet élément est omis, l'annotation doit être ancrée à l'intérieur de tous les blocs des éléments XML personnalisés dans le paragraphe. Si cet élément est présent, mais aucune balise XML personnalisé au niveau des blocs ne se trouve à la position qu'il spécifie (avant ou après), puis il doit être ignoré.

[Exemple: envisager un paragraphe avec les balises XML personnalisées au niveau bloc et deux annotations de point d'ancrage de commentaire (un avant et après la représentation physique de l'élément XML personnalisé), comme suit :

Étant donné que toutes ces trois éléments sont autour de la totalité du paragraphe, elles sont stockées en dehors du paragraphe. Toutefois, afin d'assurer que leurs positions relatives sont stockées correctement, les annotations qui doivent être déplacée par l'élément XML personnalisé physique spécifie ces informations, ce qui entraîne le schéma WordprocessingML suivant :

…<w:commentRangeStart w:id="0" />
<w:commentRangeStart w:id="1" w:displaced byCustomXml="next" />
<w:customXml w:element="spec" … />
<w:p>
  …</w:p>
…

L'attribut displacedByCustomXml indique que bien que toutes ces trois éléments sont autour du paragraphe et est déplacé à l'intérieur du paragraphe à représenter physiquement, le commentaire avec l'ID 0 doit être à l'intérieur de la partie XML personnalisée, mais le commentaire avec l'ID 1 doit être déplacé pour rester hors de l'emplacement relatif de l'élément XML personnalisé suivant (l'élément de contexte ). exemple de fin]

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

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).

nom (signet)

Spécifie le nom du signet.

Si plusieurs signets dans un document partagent le même nom, puis le premier signet (défini par l'emplacement de l'élément bookmarkStart dans l'ordre du document) est maintenu et tous les signets ultérieures doivent être ignorées.

[Exemple: le code XML suivant pour un signet autour d'un mot unique de prendre en compte :

<w:p>
  <w:bookmarkStart w:id="0" w:name="place" />
  <w:r>
    <w:t>Seattle</w:t>
  </w:r>
  <w:bookmarkEnd w:id="0" />
</w:p>

L'attribut name spécifie que le nom pour ce signet est placer. exemple de fin]

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

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