Condividi tramite


Estendere gli intervalli a livello di codice nei documenti

Una volta definito un oggetto Range in un documento di Microsoft Office Word, è possibile modificare i punti iniziale e finale usando i metodi MoveStart e MoveEnd . I metodi MoveStart e MoveEnd accettano gli stessi due argomenti, Unit e Count. I metodi Count rappresenta il numero di unità da spostare, mentre l'argomento Unit può rappresentare uno dei seguenti valori WdUnits :

  • wdCharacter

  • wdWord

  • wdSentence

  • wdParagraph

  • wdSection

  • wdStory

  • wdCell

  • wdColumn

  • wdRow

  • wdTable

    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.

    L'esempio seguente definisce un intervallo di sette caratteri. La posizione iniziale dell'intervallo viene quindi spostata sette caratteri dopo la posizione iniziale originale. Dal momento che anche la posizione finale dell'intervallo era sette caratteri dopo la posizione iniziale, il risultato è un intervallo composto da zero caratteri. All'interno del codice, la posizione finale viene spostata sette caratteri dopo la posizione finale corrente.

Per estendere un intervallo

  1. Definire un intervallo di caratteri. Per altre informazioni, vedere Procedura: Definire e selezionare intervalli a livello di codice nei documenti.

    L'esempio di codice seguente può essere usato in una personalizzazione a livello di documento.

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

    L'esempio di codice seguente può essere usato in un componente aggiuntivo VSTO. L'esempio usa il documento attivo.

    Word.Range rng = this.Application.ActiveDocument.Range(0, 7);
    
  2. Usare il metodo MoveStart dell'oggetto Range per spostare la posizione iniziale dell'intervallo.

    rng.MoveStart(Word.WdUnits.wdCharacter, 7);
    
  3. Usare il metodo MoveEnd dell'oggetto Range per spostare la posizione finale dell'intervallo.

    rng.MoveEnd(Word.WdUnits.wdCharacter, 7);
    

Codice di personalizzazione a livello di documento

Per estendere un intervallo in una personalizzazione a livello di documento

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

    // Define a range of 7 characters.
    object start = 0;
    object end = 7;
    Word.Range rng = this.Range(ref start, ref end);
    
    // Move the start position 7 characters.
    rng.MoveStart(Word.WdUnits.wdCharacter, 7);
    
    // Move the end position 7 characters.
    rng.MoveEnd(Word.WdUnits.wdCharacter, 7);
    

Codice di componente aggiuntivo VSTO

Per estendere un intervallo in un componente aggiuntivo VSTO a livello di applicazione

  1. L'esempio seguente mostra il codice completo per un componente aggiuntivo VSTO. Per usare questo codice, eseguirlo dalla classe ThisAddIn nel progetto.

    // Define a range of 7 characters.
    Word.Range rng = this.Application.ActiveDocument.Range(0, 7);
    
    // Move the start position 7 characters.
    rng.MoveStart(Word.WdUnits.wdCharacter, 7);
    
    // Move the end position 7 characters.
    rng.MoveEnd(Word.WdUnits.wdCharacter, 7);