Edit

Share via

TextFrame.ValidLinkTarget method (Publisher)

  • Article

Determines whether the text frame of one shape can be linked to the text frame of another shape.

Returns True if LinkTarget is a valid target. Returns False if LinkTarget already contains text or is already linked, or if the shape does not support attached text.

Syntax

expression.ValidLinkTarget (LinkTarget)

expression A variable that represents a TextFrame object.

Parameters

Name Required/Optional Data type Description
LinkTarget Required Shape The shape with the target text frame to which you want to link the text frame returned by expression.

Return value

Boolean

Example

This example checks to see whether the text frames for the first and second shapes on the first page of the active publication can be linked to one another. If so, the example links the two text frames.

Dim txtFrame1 As TextFrame 
Dim txtFrame2 As TextFrame 
 
With ActiveDocument.Pages(1) 
 Set txtFrame1 = .Shapes(1).TextFrame 
 Set txtFrame2 = .Shapes(2).TextFrame 
End With 
 
If txtFrame1.ValidLinkTarget(LinkTarget:=txtFrame2.Parent) = True Then 
 txtFrame1.NextLinkedTextFrame = txtFrame2 
End If

Support and feedback

Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.