Объект TextFrame (Word)TextFrame object (Word)

Представляет текстовый фрейм в объекте Shape .Represents the text frame in a Shape object. Объект TextFrame содержит текст в текстовом фрейме и свойства, управляющие полями и ориентацией текстового фрейма.The TextFrame object contains the text in the text frame and the properties that control the margins and orientation of the text frame.

ПримечанияRemarks

Используйте свойство TextFrame , чтобы возвратить объект TextFrame для фигуры.Use the TextFrame property to return the TextFrame object for a shape. Свойство TextRange возвращает объект Range , представляющий диапазон текста в заданном текстовом фрейме.The TextRange property returns a Range object that represents the range of text inside the specified text frame. В приведенном ниже примере текст добавляется в текстовый фрейм фигуры один в активном документе.The following example adds text to the text frame of shape one in the active document.

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

Примечание

Некоторые фигуры не поддерживают присоединенный текст (например, линии, полилинии, изображения и объекты OLE).Some shapes do not support attached text (lines, freeforms, pictures, and OLE objects, for example). Если вы попытаетесь вернуть или задать свойства, которые управляют текстом в текстовом фрейме для этих объектов, возникает ошибка.If you attempt to return or set properties that control text in a text frame for those objects, an error occurs.

Используйте свойство хастекст , чтобы определить, содержит ли текстовый фрейм текст, как показано в следующем примере.Use the HasText property to determine whether the text frame contains text, as shown in the following example.

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

Текстовые фреймы можно связывать друг с другом, чтобы текст перетекать из текстового фрейма одной фигуры в текстовую рамку другой фигуры.Text frames can be linked together so that the text flows from the text frame of one shape into the text frame of another shape. Используйте свойства Next и Previous для связывания текстовых фреймов.Use the Next and Previous properties to link text frames. В примере ниже показано, как создать текстовое поле (прямоугольник с текстовым фреймом) и добавить в него текст.The following example creates a text box (a rectangle with a text frame) and adds some text to it. Затем он создает еще одно текстовое поле и связывает два текстовых фрейма, чтобы текст переходил из первой текстовой рамки в вторую.It then creates another text box and links the two text frames together so that the text flows from the first text frame into the second one.

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

Используйте свойство контаинингранже для возврата объекта Range , представляющего всю статью, которая проходит между связанными текстовыми рамками.Use the ContainingRange property to return a Range object that represents the entire story that flows between linked text frames. В следующем примере проверяется орфография текста в TextBox 3 и любого другого текста, связанного с TextBox 3.The following example checks the spelling of the text in TextBox 3 and of any other text that is linked to TextBox 3.

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

МетодыMethods

ИмяName
BreakForwardLinkBreakForwardLink
DeleteTextDeleteText
ValidLinkTargetValidLinkTarget

СвойстваProperties

ИмяName
ApplicationApplication
AutoSizeAutoSize
ColumnColumn
ContainingRangeContainingRange
CreatorCreator
HasTextHasText
HorizontalAnchorHorizontalAnchor
MarginBottomMarginBottom
MarginLeftMarginLeft
MarginRightMarginRight
MarginTopMarginTop
NextNext
NoTextRotationNoTextRotation
OrientationOrientation
OverflowingOverflowing
ParentParent
PathFormatPathFormat
PreviousPrevious
TextRangeTextRange
ThreeDThreeD
VerticalAnchorVerticalAnchor
WarpFormatWarpFormat
WordWrapWordWrap

См. такжеSee also

Справочник по объектной модели WordWord Object Model Reference

Поддержка и обратная связьSupport and feedback

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи?Have questions or feedback about Office VBA or this documentation? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.