Shapes.AddTextEffect method (Publisher)
Adds a new Shape object representing a WordArt object to the specified Shapes collection.
Syntax
expression.AddTextEffect (PresetTextEffect, Text, FontName, FontSize, FontBold, FontItalic, Left, Top)
expression A variable that represents a Shapes object.
Parameters
| Name | Required/Optional | Data type | Description |
|---|---|---|---|
| PresetTextEffect | Required | MsoPresetTextEffect | The preset text effect to use. The values of the MsoPresetTextEffect constants correspond to the formats listed in the WordArt Gallery dialog box (numbered from left to right and from top to bottom). Can be one of the MsoPresetTextEffect constants declared in the Microsoft Office type library. The msoTextEffectMixed constant is not supported. |
| Text | Required | String | The text to use for the WordArt object. |
| FontName | Required | String | The name of the font to use for the WordArt object. |
| FontSize | Required | Variant | The font size to use for the WordArt object. Numeric values are evaluated in points; strings can be in any units supported by Microsoft Publisher (for example, "2.5 in"). |
| FontBold | Required | MsoTriState | Determines whether to format the WordArt text as bold. |
| FontItalic | Required | MsoTriState | Determines whether to format the WordArt text as italic. |
| Left | Required | Variant | The position of the left edge of the shape representing the WordArt object. |
| Top | Required | Variant | The position of the top edge of the shape representing the WordArt object. |
Return value
Shape
Remarks
For the Left and Top parameters, numeric values are evaluated in points; strings can be in any units supported by Publisher (for example, "2.5 in").
The height and width of the WordArt object is determined by its text and formatting.
Use the Shape.TextEffect property to return a TextEffectFormat object whose properties can be used to edit an existing WordArt object.
The FontBold parameter can be one of the MsoTriState constants declared in the Microsoft Office type library and shown in the following table.
| Constant | Description |
|---|---|
| msoFalse | Do not format the WordArt text as bold. |
| msoTrue | Format the WordArt text as bold. |
The FontItalic parameter can be one of the MsoTriState constants shown in the following table.
| Constant | Description |
|---|---|
| msoFalse | Do not format the WordArt text as italic. |
| msoTrue | Format the WordArt text as italic. |
Example
The following example adds a WordArt object to the first page of the active publication.
Dim shpWordArt As Shape
Set shpWordArt = ActiveDocument.Pages(1).Shapes.AddTextEffect _
(PresetTextEffect:=msoTextEffect7, Text:="Annual Report", _
FontName:="Arial Black", FontSize:=24, _
FontBold:=msoFalse, FontItalic:=msoFalse, _
Left:=144, Top:=72)
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.