Word.RangeLocation enum

Package:
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

// Gets complete sentences from the insertion point to the end of its paragraph.
await Word.run(async (context) => {
  const selection: Word.Range = context.document.getSelection();
  const sentences: Word.RangeCollection = selection.getTextRanges(["."], false);
  sentences.load("$none");
  await context.sync();

  const firstSentence: Word.Range = sentences.items[0];
  const paragraphEnd: Word.Range = selection.paragraphs.getFirst().getRange(Word.RangeLocation.end);
  const remainingRange: Word.Range = firstSentence.expandTo(paragraphEnd);
  const sentencesToTheEndOfParagraph: Word.RangeCollection = remainingRange.getTextRanges(["."], false);
  sentencesToTheEndOfParagraph.load("text");
  await context.sync();

  console.log("Sentences from the current sentence to the paragraph end:");
  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.