ITextRange.Delete(TextRangeUnit, Int32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Löscht Text aus dem Textbereich.
public:
int Delete(TextRangeUnit unit, int count);int Delete(TextRangeUnit const& unit, int const& count);public int Delete(TextRangeUnit unit, int count);function delete(unit, count)Public Function Delete (unit As TextRangeUnit, count As Integer) As IntegerParameter
- unit
- TextRangeUnit
Die zu löschende Texteinheit.
- count
-
Int32
int
Die Anzahl der zu löschenden Einheiten. Siehe Hinweise.
Gibt zurück
int
Die Anzahl der gelöschten Einheiten . Das Löschen des Texts in einem nicht entgenerten Textbereich zählt zu einer Einheit.
Hinweise
Wenn die Anzahl null ist, löscht diese Methode den gesamten Text im Textbereich. Nichts wird gelöscht, wenn der Textbereich nur eine Einfügemarke (also ein degenerierter Bereich) ist.
Wenn die Anzahl nicht 0 ist und der Bereich eine Einfügemarke ist, | count | werden Einheiten (absoluter Wert der Anzahl) in der logischen Richtung gelöscht, die durch das Zählungszeichen angegeben wird, wobei sich ein positiver Wert gegen Ende der Geschichte und ein negativer Wert gegen Anfang der Geschichte befindet.
Wenn die Anzahl nicht 0 ist und der Bereich nicht degeneriert ist (enthält Text), wird der Text im Bereich unabhängig von den Werten von Einheit und Anzahl gelöscht, was zu einer Einfügemarke führt. Dann werden Einheiten in der logischen Richtung gelöscht, | count | - 1 die durch das Zählzeichen angegeben wird.
Der Text im Bereich kann auch gelöscht werden, indem dem Bereich eine NULL-Zeichenfolge zugewiesen wird.
Das Löschen der CR führt zu folgendem Verhalten:
- Wenn Sie nur die CR löschen, aber der Absatz Text enthält, wird der CR gelöscht, und der folgende Absatz erhält die gleiche Absatzformatierung wie der aktuelle Absatz.
- Wenn Sie die CR sowie einige, aber nicht alle Zeichen im folgenden Absatz löschen, erhalten die aus dem aktuellen Absatz übrig gebliebenen Zeichen die Absatzformatierung des folgenden Absatzes.
- Wenn Sie das Ende eines Absatzes auswählen, aber nicht den gesamten Absatz, wird die CR nicht gelöscht.
- Wenn Sie den gesamten Absatz löschen (vom Anfang bis zum CR), löschen Sie auch die CR (es sei denn, es handelt sich um die endgültige CR in der Datei).