Freigeben über


TextPointer.GetCharacterRect(LogicalDirection) Methode

Definition

Gibt ein umgebendes Feld (Rect) für Inhalt zurück, der in der angegebenen logischen Richtung an den aktuellen TextPointer grenzt.

public:
 System::Windows::Rect GetCharacterRect(System::Windows::Documents::LogicalDirection direction);
public System.Windows.Rect GetCharacterRect (System.Windows.Documents.LogicalDirection direction);
member this.GetCharacterRect : System.Windows.Documents.LogicalDirection -> System.Windows.Rect
Public Function GetCharacterRect (direction As LogicalDirection) As Rect

Parameter

direction
LogicalDirection

Einer der LogicalDirection-Werte, mit denen die logische Richtung angegeben wird, in der die Suche nach einem umgebenden Feld für Inhalt erfolgen soll.

Gibt zurück

Ein umgebendes Feld für Inhalt, der in der angegebenen Richtung an den aktuellen TextPointer grenzt, oder Empty, wenn keine aktuellen und gültigen Layoutinformationen verfügbar sind.

Hinweise

TextElement Edges werden für die Zwecke dieser Methode nicht als Inhalt betrachtet. Wenn der TextPointer vor einer TextElement Kante positioniert ist, ist der Rückgabewert ein Begrenzungsfeld für den nächsten NichtinhaltTextElement in der angegebenen Richtung. Wenn kein Inhalt in der angegebenen Richtung vorhanden ist, wird eine Breite Rect null mit einer Höhe zurückgegeben, die der Höhe des vorherigen Inhalts entspricht.

Der von dieser Methode ausgeführte Vorgang hängt von einem gültigen Layout ab. Bei Bedarf versucht diese Methode, ein gültiges Layout automatisch neu zu generieren, bevor sie mit dem Vorgang fortfahren. Die Neugenerierung eines Layouts kann relativ teuer sein. Verwenden Sie die HasValidLayout -Eigenschaft, um nach einem gültigen Layout zu suchen, bevor Sie Vorgänge ausführen, die das Layout neu generieren. Weitere Informationen finden Sie unter Layout.

Gilt für:

Weitere Informationen