Cómo: Definir y seleccionar rangos en documentos

Artículo
04/28/2010

Actualización: noviembre 2007

Se aplica a
La información de este tema sólo se aplica a los proyectos de Visual Studio Tools para Office y versiones de Microsoft Office especificados. Tipo de proyecto Proyectos de nivel de documento Proyectos de nivel de aplicación Versión de Microsoft Office Word 2003 Word 2007 Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto.

La información de este tema sólo se aplica a los proyectos de Visual Studio Tools para Office y versiones de Microsoft Office especificados.

Tipo de proyecto

Proyectos de nivel de documento
Proyectos de nivel de aplicación

Versión de Microsoft Office

Word 2003
Word 2007

Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto.

Puede definir un intervalo en un documento de Microsoft Office Word utilizando un objeto Range. Puede seleccionar todo el documento de varias maneras, por ejemplo, utilizando el método Select del objeto Range o con la propiedad Content de la clase Microsoft.Office.Tools.Word.Document (en una personalización de nivel de documento) o de la clase Microsoft.Office.Interop.Word.Document (en un complemento de nivel de aplicación).

Definir intervalos

En el ejemplo siguiente se muestra cómo crear un nuevo objeto Range que incluye los siete primeros caracteres del documento activo, incluidos los caracteres no imprimibles. A continuación, selecciona el texto contenido en el intervalo.

Para definir un intervalo en una personalización de nivel de documento

Agregue el intervalo al documento pasando un carácter inicial y un carácter final al método Range de la clase Microsoft.Office.Tools.Word.Document. Para usar este ejemplo de código, ejecútelo desde la clase ThisDocument del proyecto.
```
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 un intervalo mediante un complemento de nivel de aplicación

Agregue el intervalo al documento pasando un carácter inicial y un carácter final al método Range de la clase Microsoft.Office.Interop.Word.Document. En el ejemplo de código siguiente se agrega un intervalo al documento activo. Para usar este ejemplo de código, ejecútelo desde la clase ThisAddIn del proyecto.
```
Dim rng As Word.Range = Me.Application.ActiveDocument.Range(Start:=0, End:=7)
rng.Select()
```
```
object start = 0;
object end = 7;
Word.Range rng = this.Application.ActiveDocument.Range(
    ref start, ref end);

rng.Select();
```

Seleccionar un intervalo en una personalización de nivel de documento

En los ejemplos siguientes se muestra cómo seleccionar todo el documento utilizando el método Select de un objeto Range o con la propiedad Content de la clase Microsoft.Office.Tools.Word.Document.

Para seleccionar el documento completo como un intervalo por medio del método Select

Use el método Select de Range que contiene el todo el documento. Para usar el ejemplo de código siguiente, ejecútelo desde la clase ThisDocument del proyecto.
```
Me.Range.Select()
```
```
object start = this.Content.Start;
object end = this.Content.End;

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

Para seleccionar el documento completo como un intervalo por medio de la propiedad Content

Utilice la propiedad Content para definir un intervalo que abarque todo el documento.
```
Me.Content.Select()
```
```
this.Content.Select();
```

También puede definir un intervalo utilizando métodos y propiedades de otros objetos.

Para seleccionar una frase del documento activo

Establezca el intervalo utilizando la colección Sentences. Utilice el índice de la frase que desea seleccionar.
```
Dim s2 As Word.Range = Me.Sentences(2)
s2.Select()
```
```
Word.Range s2 = this.Sentences[2]; 
s2.Select();
```

Otro método para seleccionar una frase consiste en definir manualmente los valores inicial y final del intervalo.

Para seleccionar una frase configurando manualmente los valores inicial y final

Cree una variable Range.
```
Dim rng As Word.Range
```
```
Word.Range rng; 
```

Compruebe si el documento contiene al menos dos frases, establezca los argumentos Start y End del intervalo y, a continuación, seleccione el 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();
}

Seleccionar un intervalo mediante un complemento de nivel de aplicación

En los ejemplos siguientes se muestra cómo seleccionar todo el documento utilizando el método Select de un objeto Range o con la propiedad Content de la clase Microsoft.Office.Interop.Word.Document.