Compartir a través de

Extender intervalos en documentos mediante programación

  • Artículo

Después de definir un objeto Range en un documento de Microsoft Office Word, se pueden cambiar sus puntos de inicio y final mediante los métodos MoveStart y MoveEnd . Los métodos MoveStart y MoveEnd usan los mismos argumentos, Unit y Count. Los métodos Count es el número de unidades que se mueven y el argumento Unit puede ser uno de los siguientes valores WdUnits :

  • wdCharacter

  • wdWord

  • wdSentence

  • wdParagraph

  • wdSection

  • wdStory

  • wdCell

  • wdColumn

  • wdRow

  • wdTable

    Se aplica a: la información de este tema se aplica a proyectos de nivel de documento y proyectos de complementos de VSTO para Word. Para obtener más información, consulte Características disponibles por aplicación de Office lication y tipo de proyecto.

    En el ejemplo siguiente se define un rango de siete caracteres. A continuación, se mueve la posición inicial del rango siete caracteres después de la posición inicial original. Puesto que la posición final del rango también estaba situada siete caracteres después de la posición inicial, el resultado es un rango que consta de cero caracteres. Posteriormente, el código mueve la posición final siete caracteres después de la posición final actual.

Para extender un rango

  1. Defina un rango de caracteres. Para obtener más información, vea Cómo: Definir y seleccionar intervalos en documentos mediante programación.

    El siguiente ejemplo de código se puede usar en una personalización de nivel de documento.

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

    El siguiente ejemplo de código se puede usar en un complemento de VSTO. En este ejemplo se usa el documento activo.

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

  2. Use el método MoveStart del objeto Range para mover la posición inicial del rango.

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

  3. Use el método MoveEnd del objeto Range para mover la posición final del rango.

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

Código de personalización de nivel de documento

Para extender un rango en una personalización de nivel de documento

  1. En el siguiente ejemplo se muestra el código completo de una personalización de nivel de documento. Para usar este código, ejecútelo desde la clase ThisDocument del proyecto.

    // 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 de complementos de VSTO

Para extender un rango en un complemento de VSTO de nivel de aplicación

  1. En el siguiente ejemplo se muestra el código completo de un complemento de VSTO. Para usar este código, ejecútelo desde la clase ThisAddIn del proyecto.

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

Contenido relacionado