Definire e selezionare intervalli a livello di codice nei documenti

È possibile definire un intervallo in un documento di Microsoft Office Word usando un oggetto Range. È possibile selezionare l'intero documento in diversi modi, ad esempio usando il Select metodo dell'oggetto Range oppure usando la proprietà Content della Document classe (in una personalizzazione a livello di documento) o la Document classe (in un componente aggiuntivo VSTO).

Si applica a: le informazioni contenute in questo argomento si applicano ai progetti a livello di documento e ai progetti di componente aggiuntivo VSTO per Word. Per altre informazioni, vedere Funzionalità disponibili per app Office lication e tipo di progetto.

Definire un intervallo

L'esempio seguente illustra come creare un nuovo oggetto Range che include i primi sette caratteri nel documento attivo, inclusi i caratteri non stampabili. Viene quindi selezionato il testo incluso nell'intervallo.

Per definire un intervallo in una personalizzazione a livello di documento

1. Aggiungere l'intervallo al documento passando un carattere di inizio e di fine al metodo Range della classe Document. Per usare questo esempio di codice, eseguirlo dalla classe ThisDocument nel progetto.

   C#

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

   VB

   Dim rng As Word.Range = Me.Range(Start:=0, End:=7)
   rng.Select()
   

Per definire un intervallo mediante un componente aggiuntivo VSTO

1. Aggiungere l'intervallo al documento passando un carattere di inizio e di fine al metodo Range della classe Document. L'esempio di codice seguente aggiunge un intervallo al documento attivo. Per usare questo esempio di codice, eseguirlo dalla classe ThisAddIn nel progetto.

   C#

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

   VB

   Dim rng As Word.Range = Me.Application.ActiveDocument.Range(Start:=0, End:=7)
   rng.Select()
   

Selezionare un intervallo in una personalizzazione a livello di documento

Gli esempi seguenti illustrano come selezionare l'intero documento usando il metodo Select di un oggetto Range oppure usando la proprietà Content della classe Document.

Per selezionare l'intero documento come un intervallo mediante il metodo Select

1. Usare il metodo Select di un oggetto Range che contiene l'intero documento. Per usare l'esempio di codice seguente, eseguirlo dalla classe ThisDocument nel progetto.

   C#

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

   VB

   Me.Range.Select()
   

Per selezionare l'intero documento come un intervallo mediante la proprietà Content

1. Usare la proprietà Content per definire un intervallo che include l'intero documento.

   C#

   this.Content.Select();
   

   VB

   Me.Content.Select()
   

   È anche possibile usare i metodi e le proprietà di altri oggetti per definire un intervallo.

Per selezionare una frase nel documento attivo

1. Configurare l'intervallo usando la raccolta Sentences. Usare l'indice della frase da selezionare.

   C#

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

   VB

   Dim s2 As Word.Range = Me.Sentences(2)
   s2.Select()
   

   Un altro modo per selezionare una frase consiste nel configurare manualmente i valori di inizio e di fine per l'intervallo.

Per selezionare una frase configurando manualmente i valori di inizio e di fine

1. Creare una variabile di intervallo.

   C#

   Word.Range rng;
   

   VB

   Dim rng As Word.Range
   

2. Controllare se nel documento sono presenti almeno due frasi, impostare gli argomenti Inizio e Fine dell'intervallo e quindi selezionare l'intervallo.

   C#

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

   VB

   If Me.Sentences.Count >= 2 Then
   
       Dim startLocation As Object = Me.Sentences(2).Start
       Dim endLocation As Object = Me.Sentences(2).End
   
       ' Supply a Start and End value for the Range.
       rng = Me.Range(Start:=startLocation, End:=endLocation)
   
       ' Select the Range
       rng.Select()
   End If
   

Selezionare un intervallo usando un componente aggiuntivo VSTO

Gli esempi seguenti illustrano come selezionare l'intero documento usando il metodo Select di un oggetto Range oppure usando la proprietà Content della classe Document.

Per selezionare l'intero documento come un intervallo mediante il metodo Select

1. Usare il metodo Select di un oggetto Range che contiene l'intero documento. L'esempio di codice seguente seleziona i contenuti del documento attivo. Per usare questo esempio di codice, eseguirlo dalla classe ThisAddIn nel progetto.

   C#

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

   VB

   Me.Application.ActiveDocument.Range.Select()
   

Per selezionare l'intero documento come un intervallo mediante la proprietà Content

1. Usare la proprietà Content per definire un intervallo che include l'intero documento.

   C#

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

   VB

   Me.Application.ActiveDocument.Content.Select()
   

   È anche possibile usare i metodi e le proprietà di altri oggetti per definire un intervallo.

Per selezionare una frase nel documento attivo

1. Configurare l'intervallo usando la raccolta Sentences. Usare l'indice della frase da selezionare.

   C#

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

   VB

   Dim s2 As Word.Range = Me.Application.ActiveDocument.Sentences(2)
   s2.Select()
   

   Un altro modo per selezionare una frase consiste nel configurare manualmente i valori di inizio e di fine per l'intervallo.

Per selezionare una frase configurando manualmente i valori di inizio e di fine

1. Creare una variabile di intervallo.

   C#

   Word.Range rng;
   

   VB

   Dim rng As Word.Range
   

2. Controllare se nel documento sono presenti almeno due frasi, impostare gli argomenti Inizio e Fine dell'intervallo e quindi selezionare l'intervallo.

   C#

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

   VB

   Dim document As Word.Document = Me.Application.ActiveDocument
   If document.Sentences.Count >= 2 Then
   
       Dim startLocation As Object = document.Sentences(2).Start
       Dim endLocation As Object = document.Sentences(2).End
   
       ' Supply a Start and End value for the Range.
       rng = document.Range(Start:=startLocation, End:=endLocation)
   
       ' Select the Range
       rng.Select()
   End If
   

Contenuto correlato

• Panoramica del modello a oggetti di Word
• Procedura: Estendere gli intervalli a livello di codice nei documenti
• Procedura: recuperare caratteri iniziali e finali a livello di codice negli intervalli
• Procedura: Estendere gli intervalli a livello di codice nei documenti
• Procedura: Reimpostare gli intervalli a livello di codice nei documenti di Word
• Procedura: Comprimere a livello di codice intervalli o selezioni nei documenti