Freigeben über


Programmgesteuertes Reduzieren von Bereichen oder Auswahlen in Dokumenten

Wenn Sie mit einem Range - oder Selection -Objekt arbeiten, möchten Sie die Auswahl vor dem Einfügen von Text möglicherweise auf eine Einfügemarke setzen, um das Überschreiben vorhandenen Texts zu vermeiden. Sowohl die Als auch die RangeSelection Objekte weisen eine Collapse-Methode auf, die die WdCollapseDirection Enumerationswerte verwendet:

  • wdCollapseStart reduziert die Auswahl auf den Anfang der Auswahl. Dies ist die Standardeinstellung, wenn Sie keinen Enumerationswert angeben möchten.

  • wdCollapseEnd reduziert die Auswahl auf das Ende der Auswahl.

    Gilt für: Die Informationen in diesem Thema gelten für Projekte auf Dokumentebene und VSTO-Add-In-Projekte für Word. Weitere Informationen finden Sie unter features available by Office-App lication and project type.

So reduzieren Sie einen Bereich und fügen neuen Text ein

  1. Erstellen Sie ein Range -Objekt, das aus dem ersten Absatz des Dokuments besteht.

    Das folgende Codebeispiel kann in einer Anpassung auf Dokumentebene verwendet werden.

    Word.Range rng = this.Paragraphs[1].Range;
    

    Das folgende Codebeispiel kann in einem VSTO-Add-In verwendet werden. In diesem Code wird das aktive Dokument verwendet.

    Word.Range rng = this.Application.ActiveDocument.Paragraphs[1].Range;
    
  2. Verwenden Sie den wdCollapseStart -Enumerationswert, um den Bereich zu reduzieren.

    rng.Collapse(Word.WdCollapseDirection.wdCollapseStart);
    
  3. Fügen Sie den neuen Text ein.

    rng.Text = " New Text ";
    
  4. Wählen Sie Range aus.

    rng.Select();
    

    Wenn Sie den wdCollapseEnd -Enumerationswert verwenden, wird der Text am Anfang des folgenden Absatzes eingefügt.

    rng.Collapse(Word.WdCollapseDirection.wdCollapseEnd);
    

Normalerweise würden Sie davon ausgehen, dass ein eingefügter neuer Satz vor der Absatzmarke eingefügt wird. Dies ist jedoch nicht der Fall, weil die Absatzmarke im ursprünglichen Bereich enthalten ist.

Anpassungsbeispiel auf Dokumentebene

So reduzieren Sie einen Bereich in einer Anpassung auf Dokumentebene

  1. Das folgende Beispiel zeigt die vollständige Methode für eine Anpassung auf Dokumentebene. Wenn Sie diesen Code verwenden möchten, führen Sie ihn von der ThisDocument -Klasse im Projekt aus.

    Word.Range rng = this.Paragraphs[1].Range; 
    
    rng.Collapse(Word.WdCollapseDirection.wdCollapseStart); 
    
    rng.Text = " New Text ";
    rng.Select();
    

Beispiel für ein VSTO-Add-In

So reduzieren Sie einen Bereich in einem VSTO-Add-In

  1. Das folgende Beispiel zeigt die vollständige Methode für ein VSTO-Add-In. Wenn Sie diesen Code verwenden möchten, führen Sie ihn von der ThisAddIn -Klasse im Projekt aus.

    Word.Range rng = this.Application.ActiveDocument.Paragraphs[1].Range;
    
    rng.Collapse(Word.WdCollapseDirection.wdCollapseStart);
    
    rng.Text = " New Text ";
    rng.Select();