Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Ajoute un nouvel objet Shape représentant un objet WordArt à la collection Shapes spécifiée.
Syntaxe
expression. AddTextEffect (PresetTextEffect, Text, FontName, FontSize, FontBold, FontItalic, Left, Top)
expression Variable qui représente un objet Shapes.
Paramètres
| Nom | Requis/Facultatif | Type de données | Description |
|---|---|---|---|
| PresetTextEffect | Requis | MsoPresetTextEffect | L'effet de texte prédéfini à utiliser. Les valeurs des constantes MsoPresetTextEffect correspondent aux formats répertoriés dans la boîte de dialogue Galerie WordArt (numérotée de gauche à droite et de haut en bas). Il peut s’agir de l’une des constantes MsoPresetTextEffect déclarées dans la bibliothèque de type Microsoft Office. La constante msoTextEffectMixed n'est pas pris en charge. |
| Text | Obligatoire | String | Texte à utiliser pour l'objet WordArt. |
| FontName | Obligatoire | String | Nom de police à utiliser pour l'objet WordArt. |
| FontSize | Obligatoire | Variant | Taille de police à utiliser pour l'objet WordArt. Les valeurs numériques sont évaluées en points ; les chaînes peuvent être dans n’importe quelle unité prise en charge par Microsoft Publisher (par exemple, « 2,5 pouces »). |
| FontBold | Obligatoire | MsoTriState | Détermine s'il faut mettre le texte WordArt en gras. |
| FontItalic | Obligatoire | MsoTriState | Détermine s'il faut mettre le texte WordArt en italique. |
| Gauche | Obligatoire | Variant | Position du bord gauche de la forme représentant l'objet WordArt. |
| Haut | Obligatoire | Variant | Position du bord supérieur de la forme représentant l'objet WordArt. |
Valeur renvoyée
Shape
Remarques
Pour les paramètres Gauche et Haut , les valeurs numériques sont évaluées en points ; les chaînes peuvent être dans n’importe quelle unité prise en charge par Publisher (par exemple, « 2,5 pouces »).
La hauteur et la largeur de l'objet WordArt sont déterminées par son texte et sa mise en forme.
Utilisez la propriété Shape.TextEffect pour renvoyer un objet TextEffectFormat dont les propriétés peuvent être utilisées pour modifier un objet WordArt existant.
Le paramètre FontBold peut être l’une des constantes MsoTriState déclarées dans la bibliothèque de type Microsoft Office et affichées dans le tableau suivant.
| Constante | Description |
|---|---|
| msoFaux | Ne met pas le texte WordArt en gras. |
| msoVrai | Met le texte WordArt en gras. |
Le paramètre FontItalic peut être l’une des constantes MsoTriState indiquées dans le tableau suivant.
| Constante | Description |
|---|---|
| msoFaux | Ne met pas le texte WordArt en italique. |
| msoVrai | Met le texte WordArt en italique. |
Exemple
L’exemple ci-après ajoute un objet WordArt à la première page de la composition active.
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)
Assistance et commentaires
Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.