Partager via

Word.RangeLocation enum

  • Référence
Paquet:
word

Remarques

[ Ensemble d’API : WordApi 1.3 ]

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 un contrôle de contenu de tableau, il s’agit du point après les caractères EOP ou Tableau.
before = "Before"

Pour le contrôle de contenu uniquement. Il s’agit du point avant la balise d’ouverture.
content = "Content"

Plage comprise entre « Début » et « Fin ».
end = "End"

Point de fin de l’objet. Pour le paragraphe, il s’agit du point avant l’EOP. Pour le contrôle de contenu, il s’agit du point avant la balise fermante.
start = "Start"

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

Plage entière de l’objet. Si l’objet est un contrôle de contenu de paragraphe ou un contrôle de contenu de tableau, les caractères EOP ou Table après le contrôle de contenu sont également inclus.