Sbalení oblastí nebo výběrů v dokumentech prostřednictvím kódu programu

Pokud pracujete s objektem Range nebo objektem Selection , můžete před vložením textu změnit výběr na kurzor, aby se zabránilo přepsání existujícího textu. Oba objekty Range Selection mají Metodu Collapse, která využívá hodnoty výčtu WdCollapseDirection :

• wdCollapseStart sbalí výběr na začátek výběru. Toto je výchozí hodnota, pokud nezadáte hodnotu výčtu.

• wdCollapseEnd sbalí výběr na konec výběru.

  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.

Sbalení oblasti a vložení nového textu

1. Vytvořte Range objekt, který se skládá z prvního odstavce v dokumentu.

   Následující příklad kódu lze použít v přizpůsobení na úrovni dokumentu.

   C#

   Word.Range rng = this.Paragraphs[1].Range;
   

   VB

   Dim rng As Word.Range = Me.Paragraphs(1).Range
   

   Následující příklad kódu lze použít v doplňku VSTO. Tento kód používá aktivní dokument.

   C#

   Word.Range rng = this.Application.ActiveDocument.Paragraphs[1].Range;
   

   VB

   Dim rng As Word.Range = Me.Application.ActiveDocument.Paragraphs(1).Range
   

2. wdCollapseStart K sbalení oblasti použijte hodnotu výčtu.

   C#

   rng.Collapse(Word.WdCollapseDirection.wdCollapseStart);
   

   VB

   rng.Collapse(Word.WdCollapseDirection.wdCollapseStart)
   

3. Vložte nový text.

   C#

   rng.Text = " New Text ";
   

   VB

   rng.Text = " New Text "
   

4. Vyberte Range.

   C#

   rng.Select();
   

   VB

   rng.Select()
   

   Pokud použijete hodnotu výčtu wdCollapseEnd , text se vloží na začátek následujícího odstavce.

   C#

   rng.Collapse(Word.WdCollapseDirection.wdCollapseEnd);
   

   VB

   rng.Collapse(Word.WdCollapseDirection.wdCollapseEnd)
   

---

Můžete očekávat, že vložení nové věty by ho vložilo před značku odstavce, ale to není případ, protože původní oblast obsahuje značku odstavce.

Příklad přizpůsobení na úrovni dokumentu

Sbalení oblasti v přizpůsobení na úrovni dokumentu

1. Následující příklad ukazuje úplnou metodu pro přizpůsobení na úrovni dokumentu. Pokud chcete tento kód použít, spusťte ho ThisDocument z třídy v projektu.

   C#

   Word.Range rng = this.Paragraphs[1].Range; 
   
   rng.Collapse(Word.WdCollapseDirection.wdCollapseStart); 
   
   rng.Text = " New Text ";
   rng.Select();
   

   VB

   Dim rng As Word.Range = Me.Paragraphs(1).Range
   
   rng.Collapse(Word.WdCollapseDirection.wdCollapseStart)
   
   rng.Text = " New Text "
   rng.Select()
   

Příklad doplňku VSTO

Sbalení oblasti v doplňku VSTO

1. Následující příklad ukazuje úplnou metodu pro doplněk VSTO. Pokud chcete tento kód použít, spusťte ho ThisAddIn z třídy v projektu.

   C#

   Word.Range rng = this.Application.ActiveDocument.Paragraphs[1].Range;
   
   rng.Collapse(Word.WdCollapseDirection.wdCollapseStart);
   
   rng.Text = " New Text ";
   rng.Select();
   

   VB

   Dim rng As Word.Range = Me.Application.ActiveDocument.Paragraphs(1).Range
   
   rng.Collapse(Word.WdCollapseDirection.wdCollapseStart)
   
   rng.Text = " New Text "
   rng.Select()
   

Související obsah

• Postupy: Vkládání textu do wordových dokumentů prostřednictvím kódu programu
• Postupy: Definování a výběr oblastí 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