Word VBA教程:AddTextEffect方法

应用于 CanvasShapes对象的 AddTextEffect方法。

在画布上添加一个“艺术字”图形。返回一个 Shape对象,该对象代表“艺术字”,并将其添加至 CanvasShapes集合。

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

expression   必需。该表达式返回一个 CanvasShapes对象。

PresetTextEffect  MsoPresetTextEffect,必需。预设的文本效果。MsoPresetTextEffect 常量的值对应于“‘艺术字’库”对话框中所列的格式(按从上到下、从左到右的顺序排列)。

MsoPresetTextEffect 可以是下列 MsoPresetTextEffect 常量之一:
msoTextEffect1
msoTextEffect10
msoTextEffect11
msoTextEffect12
msoTextEffect13
msoTextEffect14
msoTextEffect15
msoTextEffect16
msoTextEffect17
msoTextEffect18
msoTextEffect19
msoTextEffect2
msoTextEffect20
msoTextEffect21
msoTextEffect22
msoTextEffect23
msoTextEffect24
msoTextEffect25
msoTextEffect26
msoTextEffect27
msoTextEffect28
msoTextEffect29
msoTextEffect3
msoTextEffect30
msoTextEffect4
msoTextEffect5
msoTextEffect6
msoTextEffect7
msoTextEffect8
msoTextEffect9
msoTextEffectMixed

Text  String 类型,必需。“艺术字”中的文字。

FontName  String 类型,必需。“艺术字”中所用字体的名称。

FontSize  Single 类型,必需。“艺术字”中所用字体的大小(以磅为单位)。

FontBold  MsoTriState,必需。如果为 MsoTrue,则对“艺术字”字体应用加粗格式。

MsoTriState 可以是下列 MsoTriState 常量之一:
msoCTrue  不用于该参数。
msoFalse  将“艺术字”所用字体设为常规字体。
msoTriStateMixed  不用于该参数。
msoTriStateToggle  不用于该参数。
msoTrue 将“艺术字”所用字体设为加粗格式。

FontItalic  MsoTriState,必需。如果为 MsoTrue,则对“艺术字”字体应用倾斜格式。

MsoTriState 可以是下列 MsoTriState 常量之一:
msoCTrue  不用于该参数。
msoFalse  将“艺术字”所用字体设为常规字体。
msoTriStateMixed  不用于该参数。
msoTriStateToggle  不用于该参数。
msoTrue 将“艺术字”所用字体设为倾斜格式。

Left   Single 类型,必需。“艺术字”图形左边缘相对于画布左边缘的位置,以磅为单位。

Top   Single 类型,必需。“艺术字”图形上边缘相对于画布上边缘的位置,以磅为单位。

应用于 Shapes对象的 AddTextEffect方法。

在文档上添加一个“艺术字”图形。返回一个 Shape对象,该对象代表“艺术字”,并将其添加至 Shapes集合。

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

expression   必需。该表达式返回一个 Shapes对象。

PresetTextEffect  MsoPresetTextEffect,必需。预设的文本效果。MsoPresetTextEffect 常量的值对应于“‘艺术字’库”对话框中所列的格式(按从上到下、从左到右的顺序排列)。

MsoPresetTextEffect 可以是下列 MsoPresetTextEffect 常量之一:
msoTextEffect1
msoTextEffect10
msoTextEffect11
msoTextEffect12
msoTextEffect13
msoTextEffect14
msoTextEffect15
msoTextEffect16
msoTextEffect17
msoTextEffect18
msoTextEffect19
msoTextEffect2
msoTextEffect20
msoTextEffect21
msoTextEffect22
msoTextEffect23
msoTextEffect24
msoTextEffect25
msoTextEffect26
msoTextEffect27
msoTextEffect28
msoTextEffect29
msoTextEffect3
msoTextEffect30
msoTextEffect4
msoTextEffect5
msoTextEffect6
msoTextEffect7
msoTextEffect8
msoTextEffect9
msoTextEffectMixed

Text  String 类型,必需。“艺术字”中的文字。

FontName  String 类型,必需。“艺术字”中所用字体的名称。

FontSize  Single 类型,必需。“艺术字”中所用字体的大小(以磅为单位)。

FontBold  MsoTriState,必需。如果为 MsoTrue,则对“艺术字”字体应用加粗格式。

MsoTriState 可以是下列 MsoTriState 常量之一:
msoCTrue  不用于该参数。
msoFalse  将“艺术字”所用字体设为常规字体。
msoTriStateMixed  不用于该参数。
msoTriStateToggle  不用于该参数。
msoTrue  将“艺术字”所用字体设为加粗格式。

FontItalic  MsoTriState,必需。如果为 MsoTrue,则对“艺术字”字体应用倾斜格式。

MsoTriState 可以是下列 MsoTriState 常量之一:
msoCTrue  不用于该参数。
msoFalse  将“艺术字”所用字体设为常规字体。
msoTriStateMixed  不用于该参数。
msoTriStateToggle  不用于该参数。
msoTrue  将“艺术字”所用字体设为倾斜格式。

Left   Single 类型,必需。“艺术字”图形左边缘相对于锁定标记的位置,以磅为单位。

Top   Single 类型,必需。“艺术字”图形上边缘相对于锁定标记的位置,以磅为单位。

Anchor  Variant 类型,可选。Range对象,代表“艺术字”所连接的文本。如果指定了 Anchor,则锁定标记将出现在锁定区域第一段的段首。如果忽略此参数,则自动选定锁定区域,而该“艺术字”将参照页面的上边缘和左边缘定位。

说明

向文档添加“艺术字”时,“艺术字”的宽度和高度将根据指定文字的大小和数量自动地进行设置。

VBA示例

当应用于 CanvasShapes对象时。

本示例在新文档中添加一个画布,并在画布中插入包含文字“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

当应用于 Shapes对象时。

本示例在活动文档中添加包含文字“This is a test”的“艺术字”,然后将该“艺术字”锁定到第一段。


Sub NewTextEffect()
    ActiveDocument.Shapes.AddTextEffect _
        PresetTextEffect:=msoTextEffect11, _
        Text:="This is a test", FontName:="Arial Black", _
        FontSize:=36, FontBold:=msoTrue, _
        FontItalic:=msoFalse, Left:=1, Top:=1, _
        Anchor:=ActiveDocument.Paragraphs(1).Range
End Sub

Word VBA教程

Word VBA参考教程:目录1 Word VBA参考教程:目录2
Word VBA参考教程:目录3 Word VBA参考教程:目录4
Word VBA参考教程:目录5 Word VBA参考教程:目录6
Word VBA参考教程:目录7 Word VBA参考教程:目录8
Word VBA参考教程:目录9 Word VBA参考教程:目录10
版权所有 © 中山市飞娥软件工作室 证书:粤ICP备09170368号