Compartilhar via

Estender programaticamente intervalos em documentos

  • Artigo

Depois de definir um objeto em um Range documento do Microsoft Office Word, você alterar seus pontos de início e fim usando os MoveStart métodos e MoveEnd . Os MoveStart métodos e usam os mesmos dois argumentos, Unit e MoveEnd Count. O argumento Count é o número de unidades a serem movidas e o argumento Unit pode ser um dos seguintes WdUnits valores:

  • wdCharacter

  • wdWord

  • wdSentence

  • wdParagraph

  • wdSection

  • wdStory

  • wdCell

  • wdColumn

  • wdRow

  • wdTable

    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.

    O exemplo a seguir define um intervalo de sete caracteres. Em seguida, ele move a posição inicial do intervalo sete caracteres após a posição inicial original. Como a posição final do intervalo também foi de sete caracteres após a posição inicial, o resultado é um intervalo que consiste em zero caracteres. Em seguida, o código move a posição final sete caracteres após a posição final atual.

Para estender um intervalo

  1. Defina um intervalo de caracteres. Para obter mais informações, consulte Como: definir e selecionar intervalos programaticamente em documentos.

    O exemplo de código a seguir pode ser usado em uma personalização em nível de documento.

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

    O exemplo de código a seguir pode ser usado em um suplemento VSTO. Este exemplo usa o documento ativo.

    Word.Range rng = this.Application.ActiveDocument.Range(0, 7);

  2. Use o MoveStart Range método do objeto para mover a posição inicial do intervalo.

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

  3. Use o MoveEnd Range método do objeto para mover a posição final do intervalo.

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

Código de personalização em nível de documento

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

  1. O exemplo a seguir mostra o código completo para uma personalização em nível de documento. Para usar esse código, execute-o a ThisDocument partir da classe em seu projeto.

    // 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);

Código do suplemento VSTO

Para estender um intervalo em um suplemento VSTO no nível do aplicativo

  1. O exemplo a seguir mostra o código completo de um suplemento VSTO. Para usar esse código, execute-o a ThisAddIn partir da classe em seu projeto.

    // 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);

Conteúdo relacionado