TextRange Sınıf

Tanım

Ad Alanı:

System.Windows.Documents

Bütünleştirilmiş Kod:

PresentationFramework.dll

İki TextPointer konumu arasındaki içerik seçimini temsil eder.

public ref class TextRange

public class TextRange

type TextRange = class

Public Class TextRange

Devralma

Object

TextRange

Türetilmiş

System.Windows.Documents.TextSelection

Örnekler

Aşağıdaki örnekte, belirtilen FlowDocumentdüz metin gösterimini döndürmek için bir TextRangeText özelliğinin kullanılması gösterilmektedir.

// This method returns a plain text representation of a specified FlowDocument.
string GetTextFromFlowDocument(FlowDocument flowDoc)
{
     // Create a new TextRanage that takes the entire FlowDocument as the current selection.
     TextRange flowDocSelection = new TextRange(flowDoc.ContentStart, flowDoc.ContentEnd);
      
     // Use the Text property to extract a string that contains the unformatted text contents 
     // of the FlowDocument.
     return flowDocSelection.Text;
}

' This method returns a plain text representation of a specified FlowDocument.
Private Function GetTextFromFlowDocument(ByVal flowDoc As FlowDocument) As String
    ' Create a new TextRanage that takes the entire FlowDocument as the current selection.
    Dim flowDocSelection As New TextRange(flowDoc.ContentStart, flowDoc.ContentEnd)

    ' Use the Text property to extract a string that contains the unformatted text contents 
    ' of the FlowDocument.
    Return flowDocSelection.Text
End Function

Açıklamalar

TextRange sınıfı aşağıdaki terminolojiyi tanıtır.

• seçim - , TextPointerstarafından belirtilen iki konum arasındaki içerik seçimidir. Bunlardan biri, seçime göre sabit bir yer işareti yerleştirirken, diğer konum taşınabilir durumdadır. Bu, fare veya klavye kullanan bir kullanıcı tarafından yapılan seçimin davranışına benzer.

• Geçerli Seçim - her zaman içerikte bir seçimi gösterdiğinden, tarafından gösterilen seçimegeçerli seçim olarak başvurmak mantıklıdır.

• Metin Kapsayıcısı - metin kapsayıcısı, eldeki akış içeriği için en üst sınırı oluşturan öğedir; bir TextRange tarafından gösterilen seçim her zaman bir metin kapsayıcısının içinde yer alır. Şu anda metin kapsayıcısı bir FlowDocument veya TextBlockolmalıdır.

• belge - Bir metin kapsayıcısının içinde toplu olarak bulunan içerik,belgesi olarak adlandırılır.

konumgibi diğer ilgili terimler hakkında daha fazla bilgi için bkz. TextPointer.

Oluşturucular

TextRange(TextPointer, TextPointer)

Yeni aralığın başlangıç ve bitiş konumları olarak belirtilen iki TextPointer konumu alarak TextRange sınıfının yeni bir örneğini başlatır.

Özellikler

End	Geçerli seçimin sonunu işaretleyen konumu alın.
IsEmpty	Geçerli seçimin boş olup olmadığını gösteren bir değer alır.
Start	Geçerli seçimin başlangıcını işaretleyen konumu alır.
Text	Geçerli seçimin düz metin içeriğini alır veya ayarlar.

Yöntemler

ApplyPropertyValue(DependencyProperty, Object)	Geçerli seçime belirtilen biçimlendirme özelliğini ve değerini uygular.
CanLoad(String)	Geçerli seçimin belirtilen veri biçiminde içerikle yüklenip yüklenemeyeceğini denetler.
CanSave(String)	Geçerli seçimin belirtilen veri biçimi olarak kaydedilip kaydedilemeyeceğini denetler.
ClearAllProperties()	Geçerli seçimden tüm biçimlendirme özelliklerini (Inline öğelerle gösterilir) kaldırır.
Contains(TextPointer)	Bir konumun (TextPointertarafından belirtilen) geçerli seçim içinde bulunup bulunmadığını denetler.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetPropertyValue(DependencyProperty)	Geçerli seçimde belirtilen biçimlendirme özelliğinin etkin değerini döndürür.
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
Load(Stream, String)	Geçerli seçimi belirtilen bir akıştan belirtilen veri biçiminde yükler.
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
Save(Stream, String, Boolean)	Geçerli seçimi, özel TextElement nesnelerini koruma seçeneğiyle belirtilen veri biçiminde belirtilen bir akışa kaydeder.
Save(Stream, String)	Geçerli seçimi belirtilen bir akışa belirtilen veri biçiminde kaydeder.
Select(TextPointer, TextPointer)	Güncelleştirilmiş seçimi göstermek için iki TextPointer konum alarak geçerli seçimi güncelleştirir.
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)

Ekinlikler

Changed

Aralık yeni bir içerik aralığını kapsayacak şekilde yeniden konumlandırıldığında gerçekleşir.

Ayrıca bkz.

• TextPointerContext