Condividi tramite

Procedura: definire e selezionare intervalli nei documenti

  • Articolo

Aggiornamento: novembre 2007

Si applica a

Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati.

Tipo di progetto

  • Progetti a livello di documento

  • Progetti a livello di applicazione

Versione Microsoft Office

  • Word 2003

  • Word 2007

Per ulteriori informazioni, vedere la classe Funzionalità disponibili in base ai tipi di progetto e applicazione.

È possibile definire un intervallo in un documento Microsoft Office Word mediante un oggetto Range. L'intero documento può essere selezionato in modi diversi, ad esempio utilizzando il metodo Select dell'oggetto Range o la proprietà Content della classe Microsoft.Office.Tools.Word.Document, in una personalizzazione a livello di documento, o della classe Microsoft.Office.Interop.Word.Document, in un componente aggiuntivo a livello di applicazione.

Definizione di un intervallo

Nell'esempio riportato di seguito viene illustrato come creare un nuovo oggetto Range comprendente i primi sette caratteri nel documento attivo, inclusi i caratteri non stampabili. Quindi, viene selezionato il testo all'interno dell'intervallo.

Per definire un intervallo in una personalizzazione a livello di documento

  • Aggiungere l'intervallo al documento passando un carattere iniziale e uno finale al metodo Range della classe Microsoft.Office.Tools.Word.Document. Per utilizzare questo esempio di codice, eseguirlo dalla classe ThisDocument nel progetto.

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

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

rng.Select();

Per definire un intervallo mediante un componente aggiuntivo a livello di applicazione

  • Aggiungere l'intervallo al documento passando un carattere iniziale e uno finale al metodo Range della classe Microsoft.Office.Interop.Word.Document. Nell'esempio di codice riportato di seguito viene illustrato come aggiungere un intervallo al documento attivo. Per utilizzare questo esempio di codice, eseguirlo dalla classe ThisAddIn nel progetto.

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

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

rng.Select();

Selezione di un intervallo in una personalizzazione a livello di documento

Negli esempi riportati di seguito viene illustrato come selezionare l'intero documento mediante il metodo Select di un oggetto Range o mediante la proprietà Content della classe Microsoft.Office.Tools.Word.Document.

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

  • Utilizzare il metodo Select di Range contenente l'intero documento. Per utilizzare l'esempio di codice riportato di seguito, eseguirlo dalla classe ThisDocument nel progetto.

    Me.Range.Select()

    object start = this.Content.Start;
object end = this.Content.End;

this.Range(ref start, ref end).Select();

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

  • Utilizzare la proprietà Content per definire un intervallo che includa l'intero documento.

    Me.Content.Select()

    this.Content.Select();

Per definire un intervallo è inoltre possibile utilizzare i metodi e le proprietà di altri oggetti.

Per selezionare una frase nel documento attivo

  • Impostare l'intervallo mediante l'insieme Sentences. Utilizzare l'indice della frase da selezionare.

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

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

Un altro modo per selezionare una frase consiste nell'impostare manualmente il valore iniziale e quello finale per l'intervallo.

Per selezionare una frase impostando manualmente il valore iniziale e quello finale

  1. Creare una variabile di intervallo.

    Dim rng As Word.Range

    Word.Range rng;

  2. Verificare la presenza di almeno due frasi all'interno del documento, impostare gli argomenti Start e End dell'intervallo e selezionare l'intervallo.

    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

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

Selezione di un intervallo mediante un componente aggiuntivo a livello di applicazione

Negli esempi riportati di seguito viene illustrato come selezionare l'intero documento mediante il metodo Select di un oggetto Range o mediante la proprietà Content della classe Microsoft.Office.Interop.Word.Document.

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

  • Utilizzare il metodo Select di Range contenente l'intero documento. Nell'esempio di codice riportato di seguito viene illustrato come selezionare il contenuto del documento attivo. Per utilizzare questo esempio di codice, eseguirlo dalla classe ThisAddIn nel progetto.

    Me.Application.ActiveDocument.Range.Select()

    object start = this.Application.ActiveDocument.Content.Start;
object end = this.Application.ActiveDocument.Content.End;

this.Application.ActiveDocument.Range(ref start, ref end).Select();

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

  • Utilizzare la proprietà Content per definire un intervallo che includa l'intero documento.

    Me.Application.ActiveDocument.Content.Select()

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

Per definire un intervallo è inoltre possibile utilizzare i metodi e le proprietà di altri oggetti.

Per selezionare una frase nel documento attivo

  • Impostare l'intervallo mediante l'insieme Sentences. Utilizzare l'indice della frase da selezionare.

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

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

Un altro modo per selezionare una frase consiste nell'impostare manualmente il valore iniziale e quello finale per l'intervallo.

Per selezionare una frase impostando manualmente il valore iniziale e quello finale

  1. Creare una variabile di intervallo.

    Dim rng As Word.Range

    Word.Range rng;

  2. Verificare che vi siano almeno due frasi nel documento, impostare gli argomenti Start e End dell'intervallo e selezionare l'intervallo.

    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

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

Vedere anche

Attività

Procedura: estendere gli intervalli nei documenti

Procedura: recuperare i caratteri iniziale e finale negli intervalli

Procedura: estendere gli intervalli nei documenti

Procedura: reimpostare gli intervalli nei documenti di Word

Procedura: comprimere intervalli o selezioni in documenti

Procedura: escludere i segni di paragrafo durante l'inserimento di intervalli

Concetti

Cenni preliminari sul modello a oggetti di Word