Word.RangeLocation enum

Hinweise

[ API-Satz: WordApi 1.3 ]

Beispiele

// 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 = 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 = 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);
  }
});

Felder

after = "After"

Der Punkt nach dem -Objekt. Wenn es sich bei dem Objekt um ein Absatzinhaltssteuerelement oder ein Tabelleninhaltssteuerelement handelt, handelt es sich um den Punkt nach den EOP- oder Table-Zeichen.

before = "Before"

Nur für Inhaltssteuerelemente. Dies ist der Punkt vor dem öffnenden Tag.

content = "Content"

Der Bereich zwischen "Start" und "Ende".

end = "End"

Der Endpunkt des Objekts. Für Absatz ist dies der Punkt vor dem EOP. Beim Inhaltssteuerelement ist dies der Punkt vor dem schließenden Tag.

start = "Start"

Der Ausgangspunkt des -Objekts. Beim Inhaltssteuerelement ist dies der Punkt nach dem öffnenden Tag.

whole = "Whole"

Der gesamte Bereich des Objekts. Wenn es sich bei dem Objekt um ein Absatzinhaltssteuerelement oder ein Tabelleninhaltssteuerelement handelt, werden auch die EOP- oder Table-Zeichen nach dem Inhaltssteuerelement eingeschlossen.