Definir e selecionar intervalos programaticamente em documentos

Você pode definir um intervalo em um documento do Microsoft Office Word usando um Range objeto. Você pode selecionar o documento inteiro de várias maneiras, por exemplo, usando o SelectRange método do objeto ou usando a propriedade Content da classe (em uma personalização em nível de documento) ou a Document classe (em Document um suplemento VSTO).

Aplica-se a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de suplemento VSTO para Word. Para obter mais informações, consulte Recursos disponíveis por aplicativo e tipo de projeto do Office.

Definir um intervalo

O exemplo a seguir mostra como criar um novo Range objeto que inclui os primeiros sete caracteres no documento ativo, incluindo caracteres não imprimíveis. Em seguida, seleciona o texto dentro do intervalo.

Para definir um intervalo em uma personalização em nível de documento

1. Adicione o intervalo ao documento passando um caractere inicial e final para o RangeDocument método da classe. Para usar este exemplo de código, execute-o a ThisDocument partir da classe em seu projeto.

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

Para definir um intervalo usando um suplemento VSTO

1. Adicione o intervalo ao documento passando um caractere inicial e final para o RangeDocument método da classe. O exemplo de código a seguir adiciona um intervalo ao documento ativo. Para usar este exemplo de código, execute-o a ThisAddIn partir da classe em seu projeto.

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

Selecionar um intervalo em uma personalização em nível de documento

Os exemplos a seguir mostram como selecionar o documento inteiro usando o Select método de um Range objeto ou usando a ContentDocument propriedade da classe.

Para selecionar o documento inteiro como um intervalo usando o método Select

1. Use o método de um Range que contém o Select documento inteiro. Para usar o exemplo de código a seguir, execute-o a ThisDocument partir da classe em seu projeto.

   C#

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

   VB

   Me.Range.Select()
   

Para selecionar o documento inteiro como um intervalo usando a propriedade Content

1. Use a Content propriedade para definir um intervalo que englobe todo o documento.

   C#

   this.Content.Select();
   

   VB

   Me.Content.Select()
   

   Você também pode usar os métodos e propriedades de outros objetos para definir um intervalo.

Para selecionar uma frase no documento ativo

1. Defina o intervalo usando a Sentences coleção. Use o índice da frase que você deseja selecionar.

   C#

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

   VB

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

   Outra maneira de selecionar uma frase é definir manualmente os valores inicial e final para o intervalo.

Para selecionar uma frase definindo manualmente os valores inicial e final

1. Crie uma variável de intervalo.

   C#

   Word.Range rng;
   

   VB

   Dim rng As Word.Range
   

2. Verifique se há pelo menos duas frases no documento, defina os argumentos Início e Fim do intervalo e selecione o intervalo.

   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
   

Selecionar um intervalo usando um suplemento VSTO

Os exemplos a seguir mostram como selecionar o documento inteiro usando o Select método de um Range objeto ou usando a ContentDocument propriedade da classe.

Para selecionar o documento inteiro como um intervalo usando o método Select

1. Use o método de um Range que contém o Select documento inteiro. O exemplo de código a seguir seleciona o conteúdo do documento ativo. Para usar este exemplo de código, execute-o a ThisAddIn partir da classe em seu projeto.

   C#

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

   VB

   Me.Application.ActiveDocument.Range.Select()
   

Para selecionar o documento inteiro como um intervalo usando a propriedade Content

1. Use a Content propriedade para definir um intervalo que englobe todo o documento.

   C#

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

   VB

   Me.Application.ActiveDocument.Content.Select()
   

   Você também pode usar os métodos e propriedades de outros objetos para definir um intervalo.

Para selecionar uma frase no documento ativo

1. Defina o intervalo usando a Sentences coleção. Use o índice da frase que você deseja selecionar.

   C#

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

   VB

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

   Outra maneira de selecionar uma frase é definir manualmente os valores inicial e final para o intervalo.

Para selecionar uma frase definindo manualmente os valores inicial e final

1. Crie uma variável de intervalo.

   C#

   Word.Range rng;
   

   VB

   Dim rng As Word.Range
   

2. Verifique se há pelo menos duas frases no documento, defina os argumentos Início e Fim do intervalo e selecione o intervalo.

   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
   

Conteúdo relacionado

• Visão geral do modelo de objeto do Word
• Como: estender programaticamente intervalos em documentos
• Como: recuperar programaticamente caracteres de início e fim em intervalos
• Como: estender programaticamente intervalos em documentos
• Como: redefinir programaticamente intervalos em documentos do Word
• Como: recolher programaticamente intervalos ou seleções em documentos