TextPointer.IsInSameDocument(TextPointer) Yöntem

Başvuru

Tanım

Ad Alanı:: System.Windows.Documents

Bütünleştirilmiş Kod:: PresentationFramework.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Belirtilen konumun geçerli konumla aynı metin kapsayıcısında olup olmadığını gösterir.

public:
 bool IsInSameDocument(System::Windows::Documents::TextPointer ^ textPosition);

public bool IsInSameDocument (System.Windows.Documents.TextPointer textPosition);

member this.IsInSameDocument : System.Windows.Documents.TextPointer -> bool

Public Function IsInSameDocument (textPosition As TextPointer) As Boolean

Parametreler

textPosition: TextPointer

TextPointer Geçerli konumla karşılaştıracak konumu belirten bir.

Döndürülenler

Boolean

true geçerli konumla aynı metin kapsayıcısında olan bir konumu gösterirse textPosition ; değilse, false.

Özel durumlar

ArgumentNullException

textPosition, null değeridir.

Örnekler

Aşağıdaki örnekte bu yöntem için bir kullanım gösterilmektedir. Örnek, üç konumun IsInSameDocument da aynı metin kapsayıcısına ait olduğunu garanti etmeyen bir durumda belirtilen TextPointer bir örneğin diğer iki belirtilen TextPointer örnek arasında konumlandırılıp konumlandırılmadığını denetlemek için yöntemini kullanır.

// This method first checks for compatible text container scope, and then checks whether
// a specified position is between two other specified positions.
bool IsPositionContainedBetween(TextPointer positionToTest, TextPointer start, TextPointer end)
{
    // Note that without this check, an exception will be raised by CompareTo if positionToTest 
    // does not point to a position that is in the same text container used by start and end.
    //
    // This test also implicitely indicates whether start and end share a common text container.
    if (!positionToTest.IsInSameDocument(start) || !positionToTest.IsInSameDocument(end)) 
        return false;
    
    return start.CompareTo(positionToTest) <= 0 && positionToTest.CompareTo(end) <= 0;
}

' This method first checks for compatible text container scope, and then checks whether
' a specified position is between two other specified positions.
Private Function IsPositionContainedBetween(ByVal positionToTest As TextPointer, ByVal start As TextPointer, ByVal [end] As TextPointer) As Boolean
    ' Note that without this check, an exception will be raised by CompareTo if positionToTest 
    ' does not point to a position that is in the same text container used by start and end.
    '
    ' This test also implicitely indicates whether start and end share a common text container.
    If (Not positionToTest.IsInSameDocument(start)) OrElse (Not positionToTest.IsInSameDocument([end])) Then
        Return False
    End If

    Return start.CompareTo(positionToTest) <= 0 AndAlso positionToTest.CompareTo([end]) <= 0
End Function

Açıklamalar

Birden çok TextPointer örnek içeren çoğu işlem yalnızca söz konusu örnekler aynı metin kapsayıcısı kapsamındaki konumları gösteriyorsa geçerlidir. Örneğin CompareTo ve GetOffsetToPosition yöntemleri, geçerli konumla TextPointer ilişkilendirilmiş metin kapsayıcısının dışındaki bir konumda ile kullanılamaz. Belirtilen TextPointer bir değerin bu tür işlemlerin geçerli konumuyla uyumlu olduğunu doğrulamak için bu yöntemi kullanın.

Şunlara uygulanır

Aracılığıyla paylaş