Condividi tramite

Definire e selezionare intervalli a livello di codice nei documenti

  • Articolo

È 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.

    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 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.

    Word.Range rng = this.Application.ActiveDocument.Range(0, 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.

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

this.Range(ref start, ref end).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.

    this.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.

    Word.Range s2 = this.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.

    Word.Range rng;

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

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

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.

    this.Application.ActiveDocument.Range(
    this.Application.ActiveDocument.Content.Start,
    this.Application.ActiveDocument.Content.End).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.

    this.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.

    Word.Range s2 = this.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.

    Word.Range rng;

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

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

Contenuto correlato