Word.RangeLocation enum

Paket:
word

Stellt die Position eines Bereichs dar. Sie können range abrufen, indem Sie getRange für verschiedene Objekte wie Word aufrufen. Paragraph and Word. ContentControl.

Hinweise

API-Satz: WordApi 1.3

Verwendet von

Beispiele

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

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 dem EOP- oder Tabellenzeichen.
before = "Before"

Nur zur Inhaltssteuerung. Es ist der Punkt vor dem Eröffnungstag.
content = "Content"

Der Bereich zwischen start und end.
end = "End"

Der Endpunkt des Objekts. Für den Absatz ist es der Punkt vor dem EOP (Ende des Absatzes). Für die Inhaltssteuerung ist dies der Punkt vor dem schließenden Tag.
start = "Start"

Der Startpunkt des Objekts. Für die Inhaltssteuerung 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 Tabellenzeichen nach dem Inhaltssteuerelement einbezogen.