TextRange Sınıf

Tanım

Ad Alanı:

System.Windows.Documents

Bütünleştirilmiş Kod:

PresentationFramework.dll

İki TextPointer konum 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 örnek, belirtilen FlowDocumentbir TextRange öğesinin Text düz metin gösterimini döndürmek için özelliğinin kullanılmasını gösterir.

// 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

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

• Seçim - A TextRange , TextPointer'lar tarafından belirtilen iki konum arasındaki bir içerik seçimidir. Bunlardan biri seçime göre sabit bir yer işareti yerleştirirken, diğer konum hareketlidir. Bu, kullanıcının fare veya klavye kullanarak yaptığı seçimin davranışına benzer.

• Geçerli Seçim - TextRange her zaman içerikteki bir seçimi gösterdiğinden, bir tarafından TextRange gösterilen seçime geç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; tarafından gösterilen TextRange seçim her zaman bir metin kapsayıcısının içinde yer alır. Şu anda bir metin kapsayıcısı veya FlowDocument TextBlockolmalıdır.

• Belge - Bir metin kapsayıcısının içinde toplu olarak bulunan içeriğe belge denir.

Konum gibi diğer ilgili terimler hakkında daha fazla bilgi için bkzTextPointer. .

Oluşturucular

TextRange(TextPointer, TextPointer)

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

Özellikler

End	Geçerli seçimin sonunu işaretleyen konumu alır.
IsEmpty	Geçerli seçimin boş olup olmadığını belirten 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)	Belirtilen biçimlendirme özelliğini ve değerini geçerli seçime 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 (öğelerle Inline temsil edilir) kaldırır.
Contains(TextPointer)	Konumun (bir 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()	Type Geçerli örneğini 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 Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
Save(Stream, String)	Geçerli seçimi belirtilen bir akışa belirtilen veri biçiminde kaydeder.
Save(Stream, String, Boolean)	Geçerli seçimi, özel TextElement nesneleri koruma seçeneğiyle 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 dizeyi 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