Compartilhar via

Definir e selecionar intervalos programaticamente em documentos

  • Artigo

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 Select Range 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 Range Document método da classe. Para usar este exemplo de código, execute-o a ThisDocument partir da classe em seu projeto.

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

rng.Select();

Para definir um intervalo usando um suplemento VSTO

  1. Adicione o intervalo ao documento passando um caractere inicial e final para o Range Document 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.

    Word.Range rng = this.Application.ActiveDocument.Range(0, 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 Content Document 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.

    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 Content

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

    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

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

    Word.Range s2 = this.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.

    Word.Range rng;

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

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

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 Content Document 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.

    this.Application.ActiveDocument.Range(
    this.Application.ActiveDocument.Content.Start,
    this.Application.ActiveDocument.Content.End).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.

    this.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.

    Word.Range s2 = this.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.

    Word.Range rng;

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

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

Conteúdo relacionado