Shapes.AddTextbox method (Publisher)

Adds a new Shape object representing a text box to the specified Shapes collection.

Syntax

expression.AddTextbox (Orientation, Left, Top, Width, Height)

expression A variable that represents a Shapes object.

Parameters

Name	Required/Optional	Data type	Description
Orientation	Required	PbTextOrientation	The orientation of the text box.
Left	Required	Variant	The position of the left edge of the shape representing the text box.
Top	Required	Variant	The position of the top edge of the shape representing the text box.
Width	Required	Variant	The width of the shape representing the text box.
Height	Required	Variant	The height of the shape representing the text box.

Return value

Shape

Remarks

For the Left, Top, Width, and Height parameters, numeric values are evaluated in points; strings can be in any units supported by Microsoft Publisher (for example, "2.5 in").

The Orientation parameter can be one of the PbTextOrientation constants declared in the Microsoft Publisher type library and shown in the following table.

Constant	Description
pbTextOrientationHorizontal	A horizontal text box for left-to-right languages.
pbTextOrientationRightToLeft	A horizontal text box for right-to-left languages. This value has no effect if a right-to-left language is not selected.
pbTextOrientationVerticalEastAsia	A vertical text box for East Asian languages. If a non-East Asian language is selected, text appears rotated 90 degrees to the right.

Example

The following example adds a new horizontal text box to the first page of the active publication.

Dim shpTextBox As Shape 
 
Set shpTextBox = ActiveDocument.Pages(1).Shapes.AddTextBox _ 
 (Orientation:=pbTextOrientationHorizontal, _ 
 Left:=144, Top:=144, _ 
 Width:=72, Height:=18) 

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.