TextPointer.GetNextInsertionPosition(LogicalDirection) Metodo

Definizione

Restituisce un oggetto TextPointer nella posizione di inserimento successiva nella direzione logica specificata.Returns a TextPointer to the next insertion position in the specified logical direction.

public:
 System::Windows::Documents::TextPointer ^ GetNextInsertionPosition(System::Windows::Documents::LogicalDirection direction);
public System.Windows.Documents.TextPointer GetNextInsertionPosition (System.Windows.Documents.LogicalDirection direction);
member this.GetNextInsertionPosition : System.Windows.Documents.LogicalDirection -> System.Windows.Documents.TextPointer
Public Function GetNextInsertionPosition (direction As LogicalDirection) As TextPointer

Parametri

direction
LogicalDirection

Uno dei valori LogicalDirection che specifica la direzione logica nella quale cercare la posizione di inserimento successiva.One of the LogicalDirection values that specifies the logical direction in which to search for the next insertion position.

Restituisce

Oggetto TextPointer che identifica la posizione di inserimento successiva nella direzione richiesta, oppure null se risulta impossibile trovare una posizione di inserimento.A TextPointer that identifies the next insertion position in the requested direction, or null if no next insertion position can be found.

Esempi

Nell'esempio seguente viene illustrato l'utilizzo di questo metodo.The following example demonstrates a use for this method. Nell'esempio viene usato GetNextInsertionPosition il metodo per attraversare i limiti degli elementi di contenuto per contare il numero Paragraph di elementi presenti tra due TextPointer istanze specificate.The example uses the GetNextInsertionPosition method to traverse content element boundaries in order to count the number of Paragraph elements present between two specified TextPointer instances.

// This method returns the number of pagragraphs between two
// specified TextPointers.
int GetParagraphCount(TextPointer start, TextPointer end)
{
    int paragraphCount = 0;
 
    while (start != null && start.CompareTo(end) < 0)
    {
        Paragraph paragraph = start.Paragraph;
 
        if (paragraph != null)
        {
            paragraphCount++;
 
            // Advance start to the end of the current paragraph.
            start = paragraph.ContentEnd;
         }
 
         // Use the GetNextInsertionPosition method to skip over any interceding
         // content element tags.
         start = start.GetNextInsertionPosition(LogicalDirection.Forward);
     } // End while.
 
         return paragraphCount;
}  // End GetParagraphCount.
' This method returns the number of pagragraphs between two
' specified TextPointers.
Private Function GetParagraphCount(ByVal start As TextPointer, ByVal [end] As TextPointer) As Integer
    Dim paragraphCount As Integer = 0

    Do While start IsNot Nothing AndAlso start.CompareTo([end]) < 0
        Dim paragraph As Paragraph = start.Paragraph

        If paragraph IsNot Nothing Then
            paragraphCount += 1

            ' Advance start to the end of the current paragraph.
            start = paragraph.ContentEnd
        End If

        ' Use the GetNextInsertionPosition method to skip over any interceding
        ' content element tags.
        start = start.GetNextInsertionPosition(LogicalDirection.Forward)

    Loop ' End while.

    Return paragraphCount

End Function ' End GetParagraphCount.

Commenti

Una posizione di inserimento è una posizione in cui è possibile aggiungere nuovi contenuti senza suddividere le regole semantiche per il contenuto associato.An insertion position is a position where new content may be added without breaking any semantic rules for the associated content. In pratica, una posizione di inserimento è in qualsiasi punto del contenuto in cui è possibile posizionare un accento circonflesso.In practice, an insertion position is anywhere in content where a caret may be positioned. Un esempio di una posizione TextPointer valida che non è una posizione di inserimento è la posizione tra due Paragraph tag adiacenti, ovvero tra il tag di chiusura del paragrafo precedente e il tag di apertura del paragrafo successivo.An example of a valid TextPointer position that is not an insertion position is the position between two adjacent Paragraph tags (that is, between the closing tag of the preceding paragraph and the opening tag of the next paragraph).

Si applica a

Vedi anche