Programowe definiowanie i wybieranie zakresów w dokumentach

Zakres można zdefiniować w dokumencie programu Microsoft Office Word przy użyciu Range obiektu. Cały dokument można wybrać na wiele sposobów, na przykład przy użyciu Select metody obiektu lub za pomocą właściwości RangeDocument Content klasy (w dostosowywaniu na poziomie dokumentu) lub Document klasy (w dodatku VSTO).

Dotyczy: informacje w tym temacie dotyczą projektów na poziomie dokumentu i projektów dodatków VSTO dla programu Word. Aby uzyskać więcej informacji, zobacz Funkcje dostępne przez aplikacja pakietu Office lication i typ projektu.

Definiowanie zakresu

W poniższym przykładzie pokazano, jak utworzyć nowy Range obiekt zawierający pierwsze siedem znaków w aktywnym dokumencie, w tym znaki niedrukowane. Następnie wybiera tekst w zakresie.

Aby zdefiniować zakres w dostosowywaniu na poziomie dokumentu

1. Dodaj zakres do dokumentu, przekazując znak początkowy i końcowy do Range metody Document klasy. Aby użyć tego przykładu ThisDocument kodu, uruchom go z klasy w projekcie.

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

Aby zdefiniować zakres przy użyciu dodatku VSTO

1. Dodaj zakres do dokumentu, przekazując znak początkowy i końcowy do Range metody Document klasy. Poniższy przykład kodu dodaje zakres do aktywnego dokumentu. Aby użyć tego przykładu ThisAddIn kodu, uruchom go z klasy w projekcie.

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

Wybieranie zakresu w dostosowywaniu na poziomie dokumentu

W poniższych przykładach pokazano, jak wybrać cały dokument przy użyciu Select metody Range obiektu lub przy użyciu Content właściwości Document klasy.

Aby wybrać cały dokument jako zakres przy użyciu metody Select

1. Select Użyj metody , Range która zawiera cały dokument. Aby użyć poniższego przykładu kodu, uruchom go z ThisDocument klasy w projekcie.

   C#

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

   VB

   Me.Range.Select()
   

Aby wybrać cały dokument jako zakres przy użyciu właściwości Content

1. Content Użyj właściwości , aby zdefiniować zakres obejmujący cały dokument.

   C#

   this.Content.Select();
   

   VB

   Me.Content.Select()
   

   Można również użyć metod i właściwości innych obiektów do zdefiniowania zakresu.

Aby wybrać zdanie w aktywnym dokumencie

1. Ustaw zakres przy użyciu kolekcji Sentences . Użyj indeksu zdania, które chcesz wybrać.

   C#

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

   VB

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

   Innym sposobem wybrania zdania jest ręczne ustawienie wartości początkowych i końcowych dla zakresu.

Aby wybrać zdanie, ręcznie ustawiając wartości początkowe i końcowe

1. Utwórz zmienną zakresu.

   C#

   Word.Range rng;
   

   VB

   Dim rng As Word.Range
   

2. Sprawdź, czy w dokumencie znajdują się co najmniej dwa zdania, ustaw argumenty Start i End zakresu, a następnie wybierz zakres.

   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
   

Wybieranie zakresu przy użyciu dodatku VSTO

W poniższych przykładach pokazano, jak wybrać cały dokument przy użyciu Select metody Range obiektu lub przy użyciu Content właściwości Document klasy.

Aby wybrać cały dokument jako zakres przy użyciu metody Select

1. Select Użyj metody , Range która zawiera cały dokument. Poniższy przykład kodu wybiera zawartość aktywnego dokumentu. Aby użyć tego przykładu ThisAddIn kodu, uruchom go z klasy w projekcie.

   C#

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

   VB

   Me.Application.ActiveDocument.Range.Select()
   

Aby wybrać cały dokument jako zakres przy użyciu właściwości Content

1. Content Użyj właściwości , aby zdefiniować zakres obejmujący cały dokument.

   C#

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

   VB

   Me.Application.ActiveDocument.Content.Select()
   

   Można również użyć metod i właściwości innych obiektów do zdefiniowania zakresu.

Aby wybrać zdanie w aktywnym dokumencie

1. Ustaw zakres przy użyciu kolekcji Sentences . Użyj indeksu zdania, które chcesz wybrać.

   C#

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

   VB

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

   Innym sposobem wybrania zdania jest ręczne ustawienie wartości początkowych i końcowych dla zakresu.

Aby wybrać zdanie, ręcznie ustawiając wartości początkowe i końcowe

1. Utwórz zmienną zakresu.

   C#

   Word.Range rng;
   

   VB

   Dim rng As Word.Range
   

2. Sprawdź, czy w dokumencie znajdują się co najmniej dwa zdania, ustaw argumenty Start i End zakresu, a następnie wybierz zakres.

   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
   

Powiązana zawartość

• Omówienie modelu obiektów programu Word
• Instrukcje: Programowe rozszerzanie zakresów w dokumentach
• Instrukcje: Programowe pobieranie znaków początkowych i końcowych w zakresach
• Instrukcje: Programowe rozszerzanie zakresów w dokumentach
• Instrukcje: Programowe resetowanie zakresów w dokumentach programu Word
• Instrukcje: Programowe zwijanie zakresów lub zaznaczeń w dokumentach