Definování a výběr oblastí v dokumentech prostřednictvím kódu programu

Rozsah můžete definovat v systém Microsoft Office wordovém dokumentu pomocí objektuRange. Celý dokument můžete vybrat mnoha způsoby, například pomocí Select metody objektu Range nebo pomocí vlastnosti Document Content třídy (v přizpůsobení na úrovni dokumentu) nebo Document třídy (v doplňku VSTO).

Platí pro: Informace v tomto tématu platí pro projekty na úrovni dokumentu a projekty doplňků VSTO pro Word. Další informace naleznete v tématu Funkce dostupné aplikace Office lication a typu projektu.

Definování rozsahu

Následující příklad ukazuje, jak vytvořit nový Range objekt, který obsahuje prvních sedm znaků v aktivním dokumentu, včetně netisknutelných znaků. Potom vybere text v rozsahu.

Definování rozsahu v přizpůsobení na úrovni dokumentu

1. Přidejte do dokumentu rozsah předáním počátečního a koncového Document znaku Range metodě třídy. Pokud chcete tento příklad kódu použít, spusťte ho ThisDocument z třídy v projektu.

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

Definování rozsahu pomocí doplňku VSTO

1. Přidejte do dokumentu rozsah předáním počátečního a koncového Document znaku Range metodě třídy. Následující příklad kódu přidá rozsah do aktivního dokumentu. Pokud chcete tento příklad kódu použít, spusťte ho ThisAddIn z třídy v projektu.

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

Výběr oblasti v přizpůsobení na úrovni dokumentu

Následující příklady ukazují, jak vybrat celý dokument pomocí Select metody Range objektu nebo pomocí Content vlastnosti Document třídy.

Výběr celého dokumentu jako rozsahu pomocí metody Select

1. Použijte metodu Select Range , která obsahuje celý dokument. Pokud chcete použít následující příklad kódu, spusťte ho ThisDocument z třídy v projektu.

   C#

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

   VB

   Me.Range.Select()
   

Výběr celého dokumentu jako rozsahu pomocí vlastnosti Content

1. Content Vlastnost slouží k definování rozsahu, který zahrnuje celý dokument.

   C#

   this.Content.Select();
   

   VB

   Me.Content.Select()
   

   K definování rozsahu můžete použít také metody a vlastnosti jiných objektů.

Výběr věty v aktivním dokumentu

1. Nastavte rozsah pomocí Sentences kolekce. Použijte index věty, kterou chcete vybrat.

   C#

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

   VB

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

   Dalším způsobem, jak vybrat větu, je ruční nastavení počátečních a koncových hodnot pro oblast.

Výběr věty ručním nastavením počátečních a koncových hodnot

1. Vytvořte proměnnou rozsahu.

   C#

   Word.Range rng;
   

   VB

   Dim rng As Word.Range
   

2. Zkontrolujte, jestli v dokumentu nejsou aspoň dvě věty, nastavte argumenty Začátek a Konec oblasti a pak vyberte oblast.

   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
   

Výběr oblasti pomocí doplňku VSTO

Následující příklady ukazují, jak vybrat celý dokument pomocí Select metody Range objektu nebo pomocí Content vlastnosti Document třídy.

Výběr celého dokumentu jako rozsahu pomocí metody Select

1. Použijte metodu Select Range , která obsahuje celý dokument. Následující příklad kódu vybere obsah aktivního dokumentu. Pokud chcete tento příklad kódu použít, spusťte ho ThisAddIn z třídy v projektu.

   C#

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

   VB

   Me.Application.ActiveDocument.Range.Select()
   

Výběr celého dokumentu jako rozsahu pomocí vlastnosti Content

1. Content Vlastnost slouží k definování rozsahu, který zahrnuje celý dokument.

   C#

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

   VB

   Me.Application.ActiveDocument.Content.Select()
   

   K definování rozsahu můžete použít také metody a vlastnosti jiných objektů.

Výběr věty v aktivním dokumentu

1. Nastavte rozsah pomocí Sentences kolekce. Použijte index věty, kterou chcete vybrat.

   C#

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

   VB

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

   Dalším způsobem, jak vybrat větu, je ruční nastavení počátečních a koncových hodnot pro oblast.

Výběr věty ručním nastavením počátečních a koncových hodnot

1. Vytvořte proměnnou rozsahu.

   C#

   Word.Range rng;
   

   VB

   Dim rng As Word.Range
   

2. Zkontrolujte, jestli v dokumentu nejsou aspoň dvě věty, nastavte argumenty Začátek a Konec oblasti a pak vyberte oblast.

   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
   

Související obsah

• Přehled objektového modelu Wordu
• Postupy: Rozšíření rozsahů v dokumentech prostřednictvím kódu programu
• Postupy: Načtení počátečních a koncových znaků v oblastech prostřednictvím kódu programu
• Postupy: Rozšíření rozsahů v dokumentech prostřednictvím kódu programu
• Postupy: Resetování oblastí ve wordových dokumentech prostřednictvím kódu programu
• Postupy: Sbalení oblastí nebo výběrů v dokumentech prostřednictvím kódu programu