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.Returns a bounding box (Rect) for content that borders the current TextPointer in the specified logical direction.

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.One of the LogicalDirection values that specifies the logical direction in which to find a content bounding box.

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.A bounding box for content that borders the current TextPointer in the specified direction, or Empty if current, valid layout information is unavailable.

Hinweise

TextElement Kanten werden für die Zwecke dieser Methode nicht als Inhalt betrachtet.TextElement edges are not considered content for the purposes of this method. Wenn die TextPointer vor einem TextElement Edge positioniert ist, ist der Rückgabewert ein Begrenzungs Rahmen für den nächsten nichtTextElement Inhalt in der angegebenen Richtung.If the TextPointer is positioned before a TextElement edge, the return value is a bounding box for the next non-TextElement content in the specified direction. Wenn kein Inhalt in der angegebenen Richtung vorhanden ist, wird ein Rect mit einer Breite von 0 (null) zurückgegeben, dessen Höhe mit der Höhe eines vorangehenden Inhalts übereinstimmt.If there is no content in the specified direction, a zero-width Rect is returned with a height matching the height of any preceding content.

Der von dieser Methode ausgeführte Vorgang hängt von einem gültigen Layout ab.The operation performed by this method depends on a valid layout. Bei Bedarf versucht diese Methode, ein gültiges Layout automatisch neu zu generieren, bevor der Vorgang fortgesetzt wird.When necessary, this method attempts to automatically regenerate a valid layout before proceeding with the operation. Das erneute Generieren eines Layouts kann ein relativ kostspieliger Vorgang sein.Regenerating a layout can be a relatively expensive operation. Verwenden Sie die HasValidLayout-Eigenschaft, um ein gültiges Layout zu suchen, bevor Sie Vorgänge ausführen, die das Layout möglicherweise erneut generieren.Use the HasValidLayout property to check for a valid layout before performing operations that may regenerate the layout. Weitere Informationen finden Sie unter Layout.For more information, see Layout.

Gilt für:

Siehe auch