TextPointer.GetPositionAtOffset Méthode

public:
 System::Windows::Documents::TextPointer ^ GetPositionAtOffset(int offset, System::Windows::Documents::LogicalDirection direction);

public System.Windows.Documents.TextPointer GetPositionAtOffset (int offset, System.Windows.Documents.LogicalDirection direction);

member this.GetPositionAtOffset : int * System.Windows.Documents.LogicalDirection -> System.Windows.Documents.TextPointer

Public Function GetPositionAtOffset (offset As Integer, direction As LogicalDirection) As TextPointer

Paramètres

Retours

Un TextPointer à la position indiquée par le décalage spécifié, ou null si le décalage s’étend au-delà de la fin du contenu.

Remarques

L’un des éléments suivants est considéré comme un symbole :

• Balise ouvrante ou fermante pour l’élément TextElement .

• Élément UIElement contenu dans un InlineUIContainer ou .BlockUIContainer Notez qu’un UIElement tel est toujours compté comme un seul symbole ; tout contenu ou élément supplémentaire contenu par le UIElement ne sont pas comptés comme symboles.

• Caractère Unicode 16 bits à l’intérieur d’un élément de texte Run .

Voir aussi

• GetOffsetToPosition(TextPointer)

public:
 System::Windows::Documents::TextPointer ^ GetPositionAtOffset(int offset);

public System.Windows.Documents.TextPointer GetPositionAtOffset (int offset);

member this.GetPositionAtOffset : int -> System.Windows.Documents.TextPointer

Public Function GetPositionAtOffset (offset As Integer) As TextPointer

Paramètres

Retours

Un TextPointer à la position indiquée par le décalage spécifié, ou null si aucune position correspondante n'est trouvée.

Exemples

L’exemple suivant illustre l’utilisation de cette méthode. L’exemple utilise la GetPositionAtOffset méthode pour implémenter une paire de méthodes, l’une pour calculer le décalage à une position spécifiée par rapport à un paragraphe d’hébergement et l’autre pour renvoyer un TextPointer à un décalage spécifié dans un paragraphe spécifié.

// Returns the offset for the specified position relative to any containing paragraph.
int GetOffsetRelativeToParagraph(TextPointer position)
{
    // Adjust the pointer to the closest forward insertion position, and look for any
    // containing paragraph.
    Paragraph paragraph = (position.GetInsertionPosition(LogicalDirection.Forward)).Paragraph;

    // Some positions may be not within any Paragraph; 
    // this method returns an offset of -1 to indicate this condition.
    return (paragraph == null) ? -1 : paragraph.ContentStart.GetOffsetToPosition(position);
}

// Returns a TextPointer to a specified offset into a specified paragraph. 
TextPointer GetTextPointerRelativeToParagraph(Paragraph paragraph, int offsetRelativeToParagraph)
{
    // Verify that the specified offset falls within the specified paragraph.  If the offset is
    // past the end of the paragraph, return a pointer to the farthest offset position in the paragraph.
    // Otherwise, return a TextPointer to the specified offset in the specified paragraph.
    return (offsetRelativeToParagraph > paragraph.ContentStart.GetOffsetToPosition(paragraph.ContentEnd)) 
        ? paragraph.ContentEnd : paragraph.ContentStart.GetPositionAtOffset(offsetRelativeToParagraph);
}

' Returns the offset for the specified position relative to any containing paragraph.
Private Function GetOffsetRelativeToParagraph(ByVal position As TextPointer) As Integer
    ' Adjust the pointer to the closest forward insertion position, and look for any
    ' containing paragraph.
    Dim paragraph As Paragraph = (position.GetInsertionPosition(LogicalDirection.Forward)).Paragraph

    ' Some positions may be not within any Paragraph 
    ' this method returns an offset of -1 to indicate this condition.
    Return If((paragraph Is Nothing), -1, paragraph.ContentStart.GetOffsetToPosition(position))
End Function

' Returns a TextPointer to a specified offset into a specified paragraph. 
Private Function GetTextPointerRelativeToParagraph(ByVal paragraph As Paragraph, ByVal offsetRelativeToParagraph As Integer) As TextPointer
    ' Verify that the specified offset falls within the specified paragraph.  If the offset is
    ' past the end of the paragraph, return a pointer to the farthest offset position in the paragraph.
    ' Otherwise, return a TextPointer to the specified offset in the specified paragraph.
    Return If((offsetRelativeToParagraph > paragraph.ContentStart.GetOffsetToPosition(paragraph.ContentEnd)), paragraph.ContentEnd, paragraph.ContentStart.GetPositionAtOffset(offsetRelativeToParagraph))
End Function

Remarques

L’un des éléments suivants est considéré comme un symbole :

• Balise ouvrante ou fermante pour l’élément TextElement .

• Élément UIElement contenu dans un InlineUIContainer ou .BlockUIContainer Notez qu’un UIElement tel est toujours compté comme un seul symbole ; tout contenu ou élément supplémentaire contenu par le UIElement ne sont pas comptés comme symboles.

• Caractère Unicode 16 bits à l’intérieur d’un élément de texte Run .

Voir aussi

• GetOffsetToPosition(TextPointer)