Word.RangeLocation enum

Paquet:
word

Représente l’emplacement d’une plage. Vous pouvez obtenir une plage en appelant getRange sur différents objets tels que Word. Paragraphe et Word. ContentControl.

Remarques

Jeu d’API : WordApi 1.3

Utilisateur

Exemples

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/25-paragraph/get-paragraph-on-insertion-point.yaml

await Word.run(async (context) => {
  // Get the complete sentence (as range) associated with the insertion point.
  const sentences: Word.RangeCollection = context.document
    .getSelection()
    .getTextRanges(["."] /* Using the "." as delimiter */, false /*means without trimming spaces*/);
  sentences.load("$none");
  await context.sync();

  // Expand the range to the end of the paragraph to get all the complete sentences.
  const sentencesToTheEndOfParagraph: Word.RangeCollection = sentences.items[0]
    .getRange()
    .expandTo(
      context.document
        .getSelection()
        .paragraphs.getFirst()
        .getRange(Word.RangeLocation.end)
    )
    .getTextRanges(["."], false /* Don't trim spaces*/);
  sentencesToTheEndOfParagraph.load("text");
  await context.sync();

  for (let i = 0; i < sentencesToTheEndOfParagraph.items.length; i++) {
    console.log(sentencesToTheEndOfParagraph.items[i].text);
  }
});

Champs

after = "After"

Point après l’objet. Si l’objet est un contrôle de contenu de paragraphe ou de table, il s’agit du point situé après les caractères Fin de vie ou Tableau.
before = "Before"

Pour le contrôle de contenu uniquement. C’est le point avant la balise d’ouverture.
content = "Content"

Plage comprise entre start et end.
end = "End"

Point d’arrivée de l’objet. Pour paragraphe, il s’agit du point avant l’EOP (fin de paragraphe). Pour le contrôle de contenu, il s’agit du point avant la balise de fermeture.
start = "Start"

Point de départ de l’objet. Pour le contrôle de contenu, il s’agit du point situé après la balise d’ouverture.
whole = "Whole"

Toute la gamme de l’objet. Si l’objet est un contrôle de contenu de paragraphe ou de table, les caractères EOP ou Tableau qui suivent le contrôle de contenu sont également inclus.