TextFrame-Objekt (Word)

Artikel
04/07/2023

Stellt den Textrahmen in einem Shape-Objekt dar. Das TextFrame-Objekt enthält Text im Textrahmen und Eigenschaften zum Festlegen der Ränder und zur Ausrichtung des Textrahmens.

HinwBemerkungeneise

Mit der TextFrame-Eigenschaft geben Sie das TextFrame-Objekt für eine Form zurück. Die TextRange -Eigenschaft gibt ein Range -Objekt zurück, das den Textbereich innerhalb des angegebenen Textrahmens darstellt. Im folgenden Beispiel wird Text zum Textrahmen der ersten Form im aktiven Dokument hinzugefügt.

ActiveDocument.Shapes(1).TextFrame.TextRange.Text = "My Text"

Hinweis

Einige Formen unterstützen keinen angefügten Text (z. B. Linien, Freihandformen, Bilder und OLE-Objekte). Wenn Sie versuchen, Eigenschaften zum Steuern von Text in Textrahmen für diese Objekte festzulegen oder zurückzugeben, tritt ein Fehler auf.

Verwenden Sie die HasText-Eigenschaft , um zu bestimmen, ob der Textrahmen Text enthält, wie im folgenden Beispiel gezeigt.

For Each s In ActiveDocument.Shapes 
 With s.TextFrame 
 If .HasText Then MsgBox .TextRange.Text 
 End With 
Next

Textrahmen können miteinander verknüpft werden, sodass der Text aus dem Textrahmen der einen Form in den Textrahmen einer anderen Form fließt. Verwenden Sie die Eigenschaften Weiter und Zurück , um Textrahmen zu verknüpfen. Im folgenden Beispiel wird ein Textfeld (ein Rechteck mit einem Textrahmen) erstellt und Text hinzugefügt. Klicken Sie dann ein anderes Textfeld erstellt, und die beiden Textrahmen miteinander verknüpft, sodass der Text aus dem ersten Textrahmen in den zweiten fließt.

Set myTB1 = ActiveDocument.Shapes.AddTextbox _ 
 (msoTextOrientationHorizontal, 72, 72, 72, 36) 
myTB1.TextFrame.TextRange = _ 
 "This is some text. This is some more text." 
Set myTB2 = ActiveDocument.Shapes.AddTextbox _ 
 (msoTextOrientationHorizontal, 72, 144, 72, 36) 
myTB1.TextFrame.Next = myTB2.TextFrame

Verwenden Sie die ContainingRange-Eigenschaft , um ein Range-Objekt zurückzugeben, das den gesamten Textabschnitt darstellt, der zwischen verknüpften Textrahmen fließt. Im folgenden Beispiel wird die Rechtschreibung des Texts in "TextBox 3" und von Text, der mit "TextBox 3" verknüpft ist, überprüft.

Set myStory = ActiveDocument.Shapes("TextBox 3") _ 
 .TextFrame.ContainingRange 
myStory.CheckSpelling

Methoden

Name
BreakForwardLink
DeleteText
ValidLinkTarget

Eigenschaften

Name
Anwendung
AutoSize
Spalte
ContainingRange
Creator
HasText
HorizontalAnchor
MarginBottom
MarginLeft
MarginRight
MarginTop
Next
NoTextRotation
Orientation
Overflowing
Parent
PathFormat
Previous
TextRange
ThreeD
VerticalAnchor
WarpFormat
WordWrap

Siehe auch

Referenz zum Word-Objektmodell

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.