Menentukan dan memilih rentang dalam dokumen secara terprogram

Anda bisa menentukan rentang dalam dokumen Microsoft Office Word dengan menggunakan Range objek. Anda dapat memilih seluruh dokumen dalam sejumlah cara, misalnya, dengan menggunakan Select metode Range objek, atau dengan menggunakan properti Document Konten kelas (dalam kustomisasi tingkat dokumen) atau Document kelas (dalam Add-in VSTO).

Berlaku untuk: Informasi dalam topik ini berlaku untuk proyek tingkat dokumen dan proyek Add-in VSTO untuk Word. Untuk informasi selengkapnya, lihat Fitur yang tersedia berdasarkan aplikasi Office likasi dan jenis proyek.

Menentukan rentang

Contoh berikut menunjukkan cara membuat objek baru Range yang menyertakan tujuh karakter pertama dalam dokumen aktif, termasuk karakter non-pencetakan. Kemudian memilih teks dalam rentang.

Untuk menentukan rentang dalam kustomisasi tingkat dokumen

1. Tambahkan rentang ke dokumen dengan meneruskan karakter awal dan akhir ke Range metode Document kelas. Untuk menggunakan contoh kode ini, jalankan dari ThisDocument kelas di proyek Anda.

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

Untuk menentukan rentang dengan menggunakan Add-in VSTO

1. Tambahkan rentang ke dokumen dengan meneruskan karakter awal dan akhir ke Range metode Document kelas. Contoh kode berikut menambahkan rentang ke dokumen aktif. Untuk menggunakan contoh kode ini, jalankan dari ThisAddIn kelas di proyek Anda.

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

Pilih rentang dalam kustomisasi tingkat dokumen

Contoh berikut menunjukkan cara memilih seluruh dokumen dengan menggunakan Select metode Range objek, atau dengan menggunakan Content properti Document kelas .

Untuk memilih seluruh dokumen sebagai rentang dengan menggunakan metode Pilih

1. Select Gunakan metode yang Range berisi seluruh dokumen. Untuk menggunakan contoh kode berikut, jalankan dari ThisDocument kelas di proyek Anda.

   C#

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

   VB

   Me.Range.Select()
   

Untuk memilih seluruh dokumen sebagai rentang dengan menggunakan properti Konten

1. Content Gunakan properti untuk menentukan rentang yang mencakup seluruh dokumen.

   C#

   this.Content.Select();
   

   VB

   Me.Content.Select()
   

   Anda juga dapat menggunakan metode dan properti objek lain untuk menentukan rentang.

Untuk memilih kalimat dalam dokumen aktif

1. Atur rentang dengan menggunakan Sentences koleksi. Gunakan indeks kalimat yang ingin Anda pilih.

   C#

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

   VB

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

   Cara lain untuk memilih kalimat adalah dengan mengatur nilai awal dan akhir secara manual untuk rentang tersebut.

Untuk memilih kalimat dengan mengatur nilai awal dan akhir secara manual

1. Buat variabel rentang.

   C#

   Word.Range rng;
   

   VB

   Dim rng As Word.Range
   

2. Periksa untuk melihat apakah setidaknya ada dua kalimat dalam dokumen, atur argumen Mulai dan Akhir dari rentang, lalu pilih rentang.

   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
   

Pilih rentang dengan menggunakan Add-in VSTO

Contoh berikut menunjukkan cara memilih seluruh dokumen dengan menggunakan Select metode Range objek, atau dengan menggunakan Content properti Document kelas .

Untuk memilih seluruh dokumen sebagai rentang dengan menggunakan metode Pilih

1. Select Gunakan metode yang Range berisi seluruh dokumen. Contoh kode berikut memilih konten dokumen aktif. Untuk menggunakan contoh kode ini, jalankan dari ThisAddIn kelas di proyek Anda.

   C#

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

   VB

   Me.Application.ActiveDocument.Range.Select()
   

Untuk memilih seluruh dokumen sebagai rentang dengan menggunakan properti Konten

1. Content Gunakan properti untuk menentukan rentang yang mencakup seluruh dokumen.

   C#

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

   VB

   Me.Application.ActiveDocument.Content.Select()
   

   Anda juga dapat menggunakan metode dan properti objek lain untuk menentukan rentang.

Untuk memilih kalimat dalam dokumen aktif

1. Atur rentang dengan menggunakan Sentences koleksi. Gunakan indeks kalimat yang ingin Anda pilih.

   C#

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

   VB

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

   Cara lain untuk memilih kalimat adalah dengan mengatur nilai awal dan akhir secara manual untuk rentang tersebut.

Untuk memilih kalimat dengan mengatur nilai awal dan akhir secara manual

1. Buat variabel rentang.

   C#

   Word.Range rng;
   

   VB

   Dim rng As Word.Range
   

2. Periksa untuk melihat apakah setidaknya ada dua kalimat dalam dokumen, atur argumen Mulai dan Akhir dari rentang, lalu pilih rentang.

   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
   

Konten terkait

• Gambaran umum model objek Word
• Cara: Memperluas rentang dalam dokumen secara terprogram
• Cara: Mengambil karakter awal dan akhir secara terprogram dalam rentang
• Cara: Memperluas rentang dalam dokumen secara terprogram
• Cara: Mereset rentang secara terprogram di dokumen Word
• Cara: Menciutkan rentang atau pilihan secara terprogram dalam dokumen