TextPointer.IsInSameDocument(TextPointer) Metodo

Definizione

Indica se la posizione specificata si trova nello stesso contenitore di testo della posizione corrente.Indicates whether the specified position is in the same text container as the current position.

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

Parametri

textPosition
TextPointer

Oggetto TextPointer che specifica una posizione da confrontare con la posizione corrente.A TextPointer that specifies a position to compare to the current position.

Restituisce

true se textPosition indica una posizione che si trova nello stesso contenitore di testo della posizione corrente; in caso contrario, false.true if textPosition indicates a position that is in the same text container as the current position; otherwise, false.

Eccezioni

textPosition è null.textPosition is null.

Esempio

Nell'esempio seguente viene illustrato l'utilizzo di questo metodo.The following example demonstrates a use for this method. Nell'esempio viene usato il metodo IsInSameDocument per verificare se una TextPointer specificata è posizionata tra due altre istanze di TextPointer specificate in una situazione in cui non esiste alcuna garanzia che tutte e tre le posizioni appartengano allo stesso contenitore di testo.The example uses the IsInSameDocument method to check whether a specified TextPointer is positioned between two other specified TextPointer instances in a situation when there is no guarantee that all three positions belong to the same text container.

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

Commenti

La maggior parte delle operazioni che coinvolgono più istanze di TextPointer sono valide solo se le istanze in questione indicano posizioni che si trovano nello stesso ambito del contenitore di testo.Most operations that involve multiple TextPointer instances are only valid if the instances in question indicate positions that are in the same text container scope. Ad esempio, i metodi CompareTo e GetOffsetToPosition non possono essere utilizzati con un TextPointer a una posizione esterna al contenitore di testo associato alla posizione corrente.For example the CompareTo and GetOffsetToPosition methods cannot be used with a TextPointer to a position outside of the text container associated with the current position. Utilizzare questo metodo per verificare che una TextPointer specificata sia compatibile con la posizione corrente per tali operazioni.Use this method to verify that a specified TextPointer is compatible with the current position for such operations.

Si applica a