Definir y seleccionar intervalos en documentos mediante programación

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

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.

Definición de un intervalo

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

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

1. Agregue el intervalo al documento pasando un carácter inicial y final al método Range de la clase Document. Para usar este ejemplo de código, ejecútelo desde la clase ThisDocument del proyecto.

   C#

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

   VB

   Dim rng As Word.Range = Me.Range(Start:=0, End:=7)
   rng.Select()
   

Para definir un intervalo mediante un complemento de VSTO

1. Agregue el intervalo al documento pasando un carácter inicial y final al método Range de la clase Document. En el siguiente ejemplo de código se agrega un intervalo al documento activo. Para usar este ejemplo de código, ejecútelo desde la clase ThisAddIn del proyecto.

   C#

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

   VB

   Dim rng As Word.Range = Me.Application.ActiveDocument.Range(Start:=0, End:=7)
   rng.Select()
   

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

Los siguientes ejemplos muestran cómo seleccionar todo el documento mediante el método Select de un objeto Range o usando la propiedad Content de la clase Document.

Para seleccionar todo el documento como un intervalo mediante el método Select

1. Use el método Select de un Range que contenga todo el documento. Para usar el siguiente ejemplo de código, ejecútelo desde la clase ThisDocument del proyecto.

   C#

   object start = this.Content.Start;
   object end = this.Content.End;
   
   this.Range(ref start, ref end).Select();
   

   VB

   Me.Range.Select()
   

Para seleccionar todo el documento como un intervalo mediante la propiedad Content

1. Use la propiedad Content para definir un intervalo que abarque todo el documento.

   C#

   this.Content.Select();
   

   VB

   Me.Content.Select()
   

   También puede usar los métodos y propiedades de otros objetos para definir un intervalo.

Para seleccionar una frase en el documento activo

1. Establezca el intervalo usando la colección Sentences. Use el índice de la frase que desea seleccionar.

   C#

   Word.Range s2 = this.Sentences[2]; 
   s2.Select();
   

   VB

   Dim s2 As Word.Range = Me.Sentences(2)
   s2.Select()
   

   Otra forma de seleccionar una frase es establecer manualmente los valores inicial y final del intervalo.

Para seleccionar una frase estableciendo manualmente los valores inicial y final

1. Cree una variable de intervalo.

   C#

   Word.Range rng;
   

   VB

   Dim rng As Word.Range
   

2. Compruebe si hay al menos dos oraciones en el documento, establezca los argumentos Start y End del intervalo y, a continuación, seleccione el intervalo.

   C#

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

   VB

   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
   

Selección de un intervalo mediante un complemento de VSTO

Los siguientes ejemplos muestran cómo seleccionar todo el documento mediante el método Select de un objeto Range o usando la propiedad Content de la clase Document.

Para seleccionar todo el documento como un intervalo mediante el método Select

1. Use el método Select de un Range que contenga todo el documento. En el siguiente ejemplo de código se selecciona el contenido del documento activo. Para usar este ejemplo de código, ejecútelo desde la clase ThisAddIn del proyecto.

   C#

   this.Application.ActiveDocument.Range(
       this.Application.ActiveDocument.Content.Start,
       this.Application.ActiveDocument.Content.End).Select();
   

   VB

   Me.Application.ActiveDocument.Range.Select()
   

Para seleccionar todo el documento como un intervalo mediante la propiedad Content

1. Use la propiedad Content para definir un intervalo que abarque todo el documento.

   C#

   this.Application.ActiveDocument.Content.Select();
   

   VB

   Me.Application.ActiveDocument.Content.Select()
   

   También puede usar los métodos y propiedades de otros objetos para definir un intervalo.

Para seleccionar una frase en el documento activo

1. Establezca el intervalo usando la colección Sentences. Use el índice de la frase que desea seleccionar.

   C#

   Word.Range s2 = this.Application.ActiveDocument.Sentences[2];
   s2.Select();
   

   VB

   Dim s2 As Word.Range = Me.Application.ActiveDocument.Sentences(2)
   s2.Select()
   

   Otra forma de seleccionar una frase es establecer manualmente los valores inicial y final del intervalo.

Para seleccionar una frase estableciendo manualmente los valores inicial y final

1. Cree una variable de intervalo.

   C#

   Word.Range rng;
   

   VB

   Dim rng As Word.Range
   

2. Compruebe si hay al menos dos oraciones en el documento, establezca los argumentos Start y End del intervalo y, a continuación, seleccione el intervalo.

   C#

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

   VB

   Dim document As Word.Document = Me.Application.ActiveDocument
   If document.Sentences.Count >= 2 Then
   
       Dim startLocation As Object = document.Sentences(2).Start
       Dim endLocation As Object = document.Sentences(2).End
   
       ' Supply a Start and End value for the Range.
       rng = document.Range(Start:=startLocation, End:=endLocation)
   
       ' Select the Range
       rng.Select()
   End If
   

Contenido relacionado

• Introducción al modelo de objetos de Word
• Cómo: Ampliar intervalos mediante programación en documentos
• Procedimiento para recuperar mediante programación caracteres de inicio y finalización en intervalos
• Cómo: Ampliar intervalos mediante programación en documentos
• Cómo: Restablecer intervalos mediante programación en documentos de Word
• Cómo: Contraer intervalos o selecciones mediante programación en documentos