Comprimere a livello di codice intervalli o selezioni nei documenti

Se si usa un oggetto Range o Selection , è possibile che si voglia modificare la selezione in un punto di inserimento prima di inserire il testo, per evitare la sovrascrittura del testo esistente. Entrambi gli Range oggetti e Selection hanno un metodo Collapse, che usa i WdCollapseDirection valori di enumerazione:

wdCollapseStart comprime la selezione nella parte iniziale. Rappresenta il valore predefinito se non viene specificato un valore di enumerazione.
wdCollapseEnd comprime la selezione nella parte finale.

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.

Per comprimere un intervallo e inserire nuovo testo

Creare un oggetto Range costituito dal primo paragrafo del documento.

L'esempio di codice seguente può essere usato in una personalizzazione a livello di documento.
- C#
- VB
```
Word.Range rng = this.Paragraphs[1].Range;
```
```
Dim rng As Word.Range = Me.Paragraphs(1).Range
```
L'esempio di codice seguente può essere usato in un componente aggiuntivo VSTO. Questo codice usa il documento attivo.
- C#
- VB
```
Word.Range rng = this.Application.ActiveDocument.Paragraphs[1].Range;
```
```
Dim rng As Word.Range = Me.Application.ActiveDocument.Paragraphs(1).Range
```

Usare il valore di enumerazione wdCollapseStart per comprimere l'intervallo.

rng.Collapse(Word.WdCollapseDirection.wdCollapseStart);

rng.Collapse(Word.WdCollapseDirection.wdCollapseStart)

Inserire il nuovo testo.

rng.Text = " New Text ";

rng.Text = " New Text "

Selezionare il Range.

rng.Select();

rng.Select()

Se si usa il valore di enumerazione wdCollapseEnd , il testo viene inserito all'inizio del paragrafo seguente.

rng.Collapse(Word.WdCollapseDirection.wdCollapseEnd);

rng.Collapse(Word.WdCollapseDirection.wdCollapseEnd)

Contrariamente a quanto potrebbe prevedersi, la nuova frase non viene inserita prima del marcatore di paragrafo perché è incluso nell'intervallo originale.

Esempio di personalizzazione a livello di documento

Per comprimere un intervallo in una personalizzazione a livello di documento

L'esempio seguente illustra il metodo completo per una personalizzazione a livello di documento. Per usare questo codice, eseguirlo dalla classe ThisDocument nel progetto.

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

rng.Collapse(Word.WdCollapseDirection.wdCollapseStart); 

rng.Text = " New Text ";
rng.Select();

Dim rng As Word.Range = Me.Paragraphs(1).Range

rng.Collapse(Word.WdCollapseDirection.wdCollapseStart)

rng.Text = " New Text "
rng.Select()

Esempio di componente aggiuntivo VSTO

Per comprimere un intervallo in un componente aggiuntivo VSTO

Nell'esempio seguente viene illustrato il metodo completo per un componente aggiuntivo VSTO. Per usare questo codice, eseguirlo dalla classe ThisAddIn nel progetto.

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

rng.Collapse(Word.WdCollapseDirection.wdCollapseStart);

rng.Text = " New Text ";
rng.Select();

Dim rng As Word.Range = Me.Application.ActiveDocument.Paragraphs(1).Range

rng.Collapse(Word.WdCollapseDirection.wdCollapseStart)

rng.Text = " New Text "
rng.Select()

Commenti e suggerimenti

Questa pagina è stata utile?

Last updated on 2025-12-12