Edit

CanvasShapes.AddLabel method (Word)

  • Article

Adds a text label to a drawing canvas. Returns a Shapes object that represents the text label.

Syntax

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

expression Required. A variable that represents a CanvasShapes object.

Parameters

Name Required/Optional Data type Description
Orientation Required MsoText The orientation of the text.
Left Required Single The position, measured in points, of the left edge of the label relative to the left edge of the drawing canvas.
Top Required Single The position, measured in points, of the top edge of the label relative to the top edge of the drawing canvas.
Width Required Single The width of the label, in points.
Height Required Single The height of the label, in points.

Example

This example adds a blue text label with the text "Hello World" to a new drawing canvas in the active document.

Sub NewCanvasTextLabel() 
 Dim shpCanvas As Shape 
 Dim shpLabel As Shape 
 
 'Add a drawing canvas to the active document 
 Set shpCanvas = ActiveDocument.Shapes.AddCanvas _ 
 (Left:=100, Top:=75, Width:=150, Height:=200) 
 
 'Add a label to the drawing canvas 
 Set

shpLabel = shpCanvas.CanvasItems.AddLabel _ 
 (Orientation:=msoTextOrientationHorizontal, _ 
 Left:=15, Top:=15, Width:=100, Height:=100) 
 
 'Fill the label textbox with a color, 
 'add text to the label and format it 
 With

shpLabel 
 With .Fill 
 .BackColor.RGB = RGB(Red:=0, Green:=0, Blue:=192) 
 'Make the fill visible 
 .Visible = msoTrue 
 End With 
 With .TextFrame.TextRange 
 .Text = "Hello World." 
 .Bold = True 
 .Font.Name = "Tahoma" 
 End With 
 End With 
End Sub

See also

CanvasShapes Collection

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.