Program aracılığıyla belgelerde aralıkları tanımlama ve seçme

Microsoft Office Word belgesinde bir nesne kullanarak Range bir aralık tanımlayabilirsiniz. Örneğin, nesnenin yöntemini Range kullanarak Select veya sınıfın Content özelliğini Document (belge düzeyi özelleştirmesinde) veya sınıfı (VSTO Eklentisinde) kullanarak belgenin Document tamamını çeşitli yollarla seçebilirsiniz.

Şunlar için geçerlidir: Bu konudaki bilgiler, Word için belge düzeyi projeler ve VSTO Eklenti projeleri için geçerlidir. Daha fazla bilgi için bkz. Office uygulaması ve proje türüne göre kullanılabilen özellikler.

Aralık tanımlama

Aşağıdaki örnekte, yazdırılmayan karakterler de dahil olmak üzere etkin belgede ilk yedi karakteri içeren yeni Range bir nesnenin nasıl oluşturulacağı gösterilmektedir. Ardından aralıktaki metni seçer.

Belge düzeyi özelleştirmesinde aralık tanımlamak için

1. Sınıfın yöntemine Document bir başlangıç ve bitiş karakteri Range geçirerek aralığı belgeye ekleyin. Bu kod örneğini kullanmak için projenizdeki sınıfından ThisDocument çalıştırın.

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

VSTO Eklentisi kullanarak aralık tanımlamak için

1. Sınıfın yöntemine Document bir başlangıç ve bitiş karakteri Range geçirerek aralığı belgeye ekleyin. Aşağıdaki kod örneği etkin belgeye bir aralık ekler. Bu kod örneğini kullanmak için projenizdeki sınıfından ThisAddIn çalıştırın.

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

Belge düzeyi özelleştirmesinde aralık seçme

Aşağıdaki örneklerde, bir nesnenin Select yöntemini kullanarak veya sınıfının özelliğini kullanarak Content belgenin tamamının nasıl seçilip seçndiği gösterilmektedirDocument.Range

Select yöntemini kullanarak belgenin tamamını aralık olarak seçmek için

1. Belgenin Select tamamını içeren yöntemini Range kullanın. Aşağıdaki kod örneğini kullanmak için projenizdeki sınıfından ThisDocument çalıştırın.

   C#

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

   VB

   Me.Range.Select()
   

İçerik özelliğini kullanarak belgenin tamamını aralık olarak seçmek için

1. Özelliğini kullanarak belgenin Content tamamını kapsayan bir aralık tanımlayın.

   C#

   this.Content.Select();
   

   VB

   Me.Content.Select()
   

   Ayrıca, bir aralık tanımlamak için diğer nesnelerin yöntemlerini ve özelliklerini de kullanabilirsiniz.

Etkin belgede bir tümce seçmek için

1. Koleksiyonu kullanarak Sentences aralığı ayarlayın. Seçmek istediğiniz cümlenin dizinini kullanın.

   C#

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

   VB

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

   Tümce seçmenin bir diğer yolu da aralığın başlangıç ve bitiş değerlerini el ile ayarlamaktır.

Başlangıç ve bitiş değerlerini el ile ayarlayarak tümce seçmek için

1. Bir aralık değişkeni oluşturun.

   C#

   Word.Range rng;
   

   VB

   Dim rng As Word.Range
   

2. Belgede en az iki cümle olup olmadığını denetleyin, aralığın Başlangıç ve Bitiş bağımsız değişkenlerini ayarlayın ve aralığı seçin.

   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
   

VSTO Eklentisi kullanarak aralık seçme

Aşağıdaki örneklerde, bir nesnenin Select yöntemini kullanarak veya sınıfının özelliğini kullanarak Content belgenin tamamının nasıl seçilip seçndiği gösterilmektedirDocument.Range

Select yöntemini kullanarak belgenin tamamını aralık olarak seçmek için

1. Belgenin Select tamamını içeren yöntemini Range kullanın. Aşağıdaki kod örneği etkin belgenin içeriğini seçer. Bu kod örneğini kullanmak için projenizdeki sınıfından ThisAddIn çalıştırın.

   C#

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

   VB

   Me.Application.ActiveDocument.Range.Select()
   

İçerik özelliğini kullanarak belgenin tamamını aralık olarak seçmek için

1. Özelliğini kullanarak belgenin Content tamamını kapsayan bir aralık tanımlayın.

   C#

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

   VB

   Me.Application.ActiveDocument.Content.Select()
   

   Ayrıca, bir aralık tanımlamak için diğer nesnelerin yöntemlerini ve özelliklerini de kullanabilirsiniz.

Etkin belgede bir tümce seçmek için

1. Koleksiyonu kullanarak Sentences aralığı ayarlayın. Seçmek istediğiniz cümlenin dizinini kullanın.

   C#

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

   VB

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

   Tümce seçmenin bir diğer yolu da aralığın başlangıç ve bitiş değerlerini el ile ayarlamaktır.

Başlangıç ve bitiş değerlerini el ile ayarlayarak tümce seçmek için

1. Bir aralık değişkeni oluşturun.

   C#

   Word.Range rng;
   

   VB

   Dim rng As Word.Range
   

2. Belgede en az iki cümle olup olmadığını denetleyin, aralığın Başlangıç ve Bitiş bağımsız değişkenlerini ayarlayın ve aralığı seçin.

   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
   

İlgili içerik

• Word nesne modeline genel bakış
• Nasıl yapılır: Belgelerdeki aralıkları program aracılığıyla genişletme
• Nasıl yapılır: Aralıklardaki başlangıç ve bitiş karakterlerini program aracılığıyla alma
• Nasıl yapılır: Belgelerdeki aralıkları program aracılığıyla genişletme
• Nasıl yapılır: Word belgelerinde aralıkları program aracılığıyla sıfırlama
• Nasıl yapılır: Belgelerdeki aralıkları veya seçimleri program aracılığıyla daraltma