AddLabel Method

Applies To

Shapes collection object.

Description

Creates a label. Returns a Shape object that represents the new label.

Syntax

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

expression Required. An expression that returns a Shapes collection.

Orientation Required Long. The orientation of the text. Can be one of the following MsoTextOrientation constants: msoTextOrientationDownward, msoTextOrientationHorizontal, msoTextOrientationMixed, or msoTextOrientationUpward. (Don't use any MsoTextOrientation constants other than these in U.S. English versions of Word.)

Left, Top Required Single. The position (in points) of the upper-left corner of the label, relative to the anchor.

Width, Height Required Single. The width and height of the label, in points.

Anchor Optional Variant. A Range object that represents the text that the label is bound to. If Anchor is specified, the anchor is positioned at the beginning of the first paragraph in the anchoring range. If this argument is omitted, the anchoring range is selected automatically and the label is positioned relative to the top and left edges of the page.

See Also

AddTextbox method, CreateTextbox method, TextFrame object.

Example

This example adds a label that contains the text "Test Label" to a new document.

Set myDocument = Documents.Add
Set myLabel = myDocument.Shapes.AddLabel(Orientation:=msoTextOrientationHorizontal, _
    Left:=100, Top:=100, Width:=300, Height:=200)
myLabel.TextFrame.TextRange = "Test Label"