Freigeben über


Programmgesteuertes Definieren und Auswählen von Bereichen in Dokumenten

Sie können einen Bereich in einem Microsoft Office Word-Dokument mithilfe eines Range-Objekts definieren. Sie können das gesamte Dokument auf verschiedene Arten auswählen, z. B. mithilfe der Select Methode des Range Objekts oder mithilfe der Content-Eigenschaft der Document Klasse (in einer Anpassung auf Dokumentebene) oder der Document Klasse (in einem VSTO-Add-In).

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.

Definieren eines Bereichs

Das folgende Beispiel veranschaulicht das Erstellen eines neuen Range-Objekts, das die ersten sieben Zeichen im aktiven Dokument, einschließlich der nicht druckbaren Zeichen, enthält. Anschließend wird der Text innerhalb des Bereichs ausgewählt.

So definieren Sie einen Bereich in einer Anpassung auf Dokumentebene

  1. Fügen Sie dem Dokument den Bereich hinzu, indem Sie ein Start- und ein Endzeichen an die Range-Methode der Document-Klasse übergeben. Wenn Sie dieses Codebeispiel verwenden möchten, führen Sie es von der ThisDocument -Klasse im Projekt aus.

    object start = 0; 
    object end = 7; 
    Word.Range rng = this.Range(ref start, ref end); 
    
    rng.Select();
    

So definieren Sie einen Bereich mithilfe eines VSTO-Add-Ins

  1. Fügen Sie dem Dokument den Bereich hinzu, indem Sie ein Start- und ein Endzeichen an die Range-Methode der Document-Klasse übergeben. Im folgenden Codebeispiel wird dem aktiven Dokument ein Bereich hinzugefügt. Wenn Sie dieses Codebeispiel verwenden möchten, führen Sie es von der ThisAddIn -Klasse im Projekt aus.

    Word.Range rng = this.Application.ActiveDocument.Range(0, 7);
    
    rng.Select();
    

Auswählen eines Bereichs in einer Anpassung auf Dokumentebene

Die folgenden Beispiele zeigen, wie Sie das gesamte Dokument mithilfe der Select-Methode eines Range-Objekts oder mithilfe der Content-Eigenschaft der Document-Klasse auswählen.

So wählen Sie das gesamte Dokument als Bereich mithilfe der Select-Methode aus

  1. Verwenden Sie die Select-Methode eines Range, der das gesamte Dokument enthält. Wenn Sie das folgende Codebeispiel verwenden möchten, führen Sie es aus der Klasse ThisDocument in Ihrem Projekt aus.

    object start = this.Content.Start;
    object end = this.Content.End;
    
    this.Range(ref start, ref end).Select();
    

So wählen Sie das gesamte Dokument als Bereich mithilfe der Content-Eigenschaft aus

  1. Verwenden Sie die Content-Eigenschaft, um einen Bereich zu definieren, der das gesamte Dokument umfasst.

    this.Content.Select();
    

    Sie können auch Methoden und Eigenschaften anderer Objekte verwenden, um einen Bereich zu definieren.

So wählen Sie einen Satz im aktiven Dokument aus

  1. Legen Sie den Bereich mithilfe der Sentences-Auflistung fest. Verwenden Sie den Index des Satzes, den Sie auswählen möchten.

    Word.Range s2 = this.Sentences[2]; 
    s2.Select();
    

    Eine andere Möglichkeit zum Auswählen eines Satzes besteht darin, den Start- und Endwert für den Bereich manuell festzulegen.

So wählen Sie einen Satz durch manuelles Festlegen des Start- und Endwerts aus

  1. Erstellen Sie eine Bereichsvariable.

    Word.Range rng;
    
  2. Überprüfen Sie, ob im Dokument mindestens zwei Sätze vorhanden sind, legen Sie die Argumente "Start " und "Ende " des Bereichs fest, und wählen Sie dann den Bereich aus.

    if (this.Sentences.Count >= 2) 
    {
        object startLocation = this.Sentences[2].Start; 
        object endLocation = this.Sentences[2].End; 
    
        // Supply a Start and End value for the Range. 
        rng = this.Range(ref startLocation, ref endLocation); 
    
        // Select the Range.
        rng.Select();
    }
    

Auswählen eines Bereichs mithilfe eines VSTO-Add-Ins

Die folgenden Beispiele zeigen, wie Sie das gesamte Dokument mithilfe der Select-Methode eines Range-Objekts oder mithilfe der Content-Eigenschaft der Document-Klasse auswählen.

So wählen Sie das gesamte Dokument als Bereich mithilfe der Select-Methode aus

  1. Verwenden Sie die Select-Methode eines Range, der das gesamte Dokument enthält. Im folgenden Codebeispiel wird der Inhalt des aktiven Dokuments ausgewählt. Wenn Sie dieses Codebeispiel verwenden möchten, führen Sie es von der ThisAddIn -Klasse im Projekt aus.

    this.Application.ActiveDocument.Range(
        this.Application.ActiveDocument.Content.Start,
        this.Application.ActiveDocument.Content.End).Select();
    

So wählen Sie das gesamte Dokument als Bereich mithilfe der Content-Eigenschaft aus

  1. Verwenden Sie die Content-Eigenschaft, um einen Bereich zu definieren, der das gesamte Dokument umfasst.

    this.Application.ActiveDocument.Content.Select();
    

    Sie können auch Methoden und Eigenschaften anderer Objekte verwenden, um einen Bereich zu definieren.

So wählen Sie einen Satz im aktiven Dokument aus

  1. Legen Sie den Bereich mithilfe der Sentences-Auflistung fest. Verwenden Sie den Index des Satzes, den Sie auswählen möchten.

    Word.Range s2 = this.Application.ActiveDocument.Sentences[2];
    s2.Select();
    

    Eine andere Möglichkeit zum Auswählen eines Satzes besteht darin, den Start- und Endwert für den Bereich manuell festzulegen.

So wählen Sie einen Satz durch manuelles Festlegen des Start- und Endwerts aus

  1. Erstellen Sie eine Bereichsvariable.

    Word.Range rng;
    
  2. Überprüfen Sie, ob im Dokument mindestens zwei Sätze vorhanden sind, legen Sie die Argumente "Start " und "Ende " des Bereichs fest, und wählen Sie dann den Bereich aus.

    Word.Document document = this.Application.ActiveDocument;
    
    if (document.Sentences.Count >= 2)
    {
        object startLocation = document.Sentences[2].Start;
        object endLocation = document.Sentences[2].End;
    
        // Supply a Start and End value for the Range. 
        rng = document.Range(ref startLocation, ref endLocation);
    
        // Select the Range.
        rng.Select();
    }