Partager via


CanvasShapes.AddTextEffect Method (Word)

Adds a WordArt shape to a drawing canvas. Returns a Shape object that represents the WordArt.

Syntax

expression .AddTextEffect(PresetTextEffect, Text, FontName, FontSize, FontBold, FontItalic, Left, Top)

expression Required. A variable that represents a CanvasShapes collection.

Parameters

Name

Required/Optional

Data Type

Description

PresetTextEffect

Required

Mso

A preset text effect. 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).

Text

Required

String

The text in the WordArt.

FontName

Required

String

The name of the font used in the WordArt.

FontSize

Required

Single

The size (in points) of the font used in the WordArt.

FontBold

Required

MsoTriState

msoTrue to bold the WordArt font. msoFalse to set the font used in the WordArt to regular.

FontItalic

Required

MsoTriState

msoTrue to italicize the WordArt font. msoFalse to set the font used in the WordArt to regular.

Left

Required

Single

The position, measured in points, of the left edge of the WordArt shape relative to the left edge of the drawing canvas.

Top

Required

Single

The position, measured in points, of the top edge of the WordArt shape relative to the top edge of the drawing canvas.

Remarks

When you add WordArt to a document, the height and width of the WordArt are automatically set based on the size and amount of text you specify.

Example

This example adds a drawing canvas to a new document and inserts a WordArt shape inside the canvas that contains the text "Hello, World."

Sub NewCanvasTextEffect() 
 Dim docNew As Document 
 Dim shpCanvas As Shape 
 
 'Create a new document and add a drawing canvas 
 Set docNew = Documents.Add 
 Set shpCanvas = docNew.Shapes.AddCanvas( _ 
 Left:=100, Top:=100, Width:=150, _ 
 Height:=50) 
 
 'Add WordArt shape to the drawing canvas 
 shpCanvas.CanvasItems.AddTextEffect _ 
 PresetTextEffect:=msoTextEffect20, _ 
 Text:="Hello, World", FontName:="Tahoma", _ 
 FontSize:=15, FontBold:=msoTrue, _ 
 FontItalic:=msoFalse, _ 
 Left:=120, Top:=120 
End Sub

See Also

Concepts

CanvasShapes Object Members

CanvasShapes Collection