Como definir e selecionar intervalos em documentos programaticamente

Artigo
02/25/2013

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

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 2013 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 um novo objeto de Range que inclui os sete primeiros caracteres no documento ativo, incluindo caracteres de não impressão.Selecione o texto dentro do intervalo.

Para definir um intervalo em um nível da personalização

Adicione o intervalo para o documento passando um caractere de início e final para o método de Range da classe de Microsoft.Office.Tools.Word.Document .Para usar este exemplo de código, ele execução da classe de ThisDocument em seu 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 ao nível

Adicione o intervalo para o documento passando um caractere de início e final para o método de Range da classe de Microsoft.Office.Interop.Word.Document .O exemplo de código a seguir adiciona um intervalo para o documento ativo.Para usar este exemplo de código, ele execução da classe de ThisAddIn em seu 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 um Nível da personalização

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

Para selecionar o documento inteiro como um intervalo usando o método de seleção

Use o método de Select de Range que contém o documento inteiro.Para usar o exemplo de código, ele execução da classe de ThisDocument em seu projeto.
```
Me.Range.Select()
```
```
object start = this.Content.Start;
object end = this.Content.End;

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

para selecionar o documento inteiro como um intervalo usando a propriedade de conteúdo

Use a propriedade de Content 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 a coleção de Sentences .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 para selecionar uma frase é definir o início e fim manualmente valores no intervalo.

Para selecionar uma frase manualmente definindo o início e final valores

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

Verifique se há pelo menos duas frases no documento, defina os argumentos de Start e de End do intervalo, 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 ao Nível