Como: Definir e selecionar intervalos em documentos

Artigo
08/08/2011

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

Aplicável a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de nível de aplicativo para Word 2007 e Word 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Definindo um intervalo

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

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

Adicionar o intervalo no documento, passando um caractere inicial e final para o Range método de Microsoft.Office.Tools.Word.Document classe. Para usar este exemplo de código, executá-lo do ThisDocument classe no projeto.
```
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();
```

Para definir um intervalo usando um suplemento em nível de aplicativo

Adicionar o intervalo no documento, passando um caractere inicial e final para o Range método de Microsoft.Office.Interop.Word.Document classe. O exemplo de código a seguir adiciona um intervalo ao documento ativo. Para usar este exemplo de código, executá-lo do ThisAddIn classe no projeto.
```
Dim rng As Word.Range = Me.Application.ActiveDocument.Range(Start:=0, End:=7)
rng.Select()
```
```
Word.Range rng = this.Application.ActiveDocument.Range(0, 7);

rng.Select();
```

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

Os exemplos a seguir mostram como selecionar o documento inteiro usando o Select o método de um Range objeto ou usando o Content propriedade da Microsoft.Office.Tools.Word.Document classe.

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

Use o Select o método de um Range que contém o documento inteiro. Para usar o seguinte exemplo de código, executá-lo do ThisDocument classe no projeto.
```
Me.Range.Select()
```
```
object start = this.Content.Start;
object end = this.Content.End;

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

Para selecionar todo o documento como um intervalo usando a propriedade de conteúdo

Use o Content a propriedade para definir um intervalo que abrange o documento inteiro.
```
Me.Content.Select()
```
```
this.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

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

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

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

Outra maneira de selecionar uma sentença é definir manualmente os valores inicial e final do intervalo.

Para selecionar uma frase definindo manualmente os valores de início e término

Crie uma variável de intervalo.
```
Dim rng As Word.Range
```
```
Word.Range rng; 
```

Verifique se há pelo menos duas sentenças no documento, defina a Start e End argumentos do intervalo e em seguida, selecione o intervalo.

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

Selecionando um intervalo usando um suplemento em nível de aplicativo

Os exemplos a seguir mostram como selecionar o documento inteiro usando o Select o método de um Range objeto ou usando o Content propriedade da Microsoft.Office.Interop.Word.Document classe.