Shapes.AddCallout Method
Adds a borderless line callout to a document. Returns a Shape object that represents the callout and adds it to the Shapes collection.
Namespace: Microsoft.Office.Interop.Word
Assembly: Microsoft.Office.Interop.Word (in microsoft.office.interop.word.dll)
Usage
Dim Type As MsoCalloutType
Dim Left As Single
Dim Top As Single
Dim Width As Single
Dim Height As Single
Dim Anchor As Object
Dim returnValue As Shape
Dim shapes1 As Shapes
returnValue = shapes1.AddCallout(Type, Left, Top, Width, Height, Anchor)
Syntax
Function AddCallout( _
<InAttribute()> ByVal Type As MsoCalloutType, _
<InAttribute()> ByVal Left As Single, _
<InAttribute()> ByVal Top As Single, _
<InAttribute()> ByVal Width As Single, _
<InAttribute()> ByVal Height As Single, _
<InAttribute()> Optional ByRef Anchor As Object _
) As Shape
Shape AddCallout(
[In] MsoCalloutType Type,
[In] float Left,
[In] float Top,
[In] float Width,
[In] float Height,
[In, Optional] ref object Anchor
);
public: Shape^ AddCallout(
MsoCalloutType^ Type,
Single Left,
Single Top,
Single Width,
Single Height,
&Object^ Anchor
);
public Shape AddCallout(
/*in*/MsoCalloutType Type,
/*in*/float Left,
/*in*/float Top,
/*in*/float Width,
/*in*/float Height,
/*in*/System.Object Anchor
);
function AddCallout(
Type : MsoCalloutType,
Left : float,
Top : float,
Width : float,
Height : float,
Anchor : Object
) : Shape;
Parameters
Type
Required Microsoft.Office.Core.MsoCalloutType. The type of callout.MsoCalloutType can be one of these constants.
msoCalloutOne – Positions callout line straight down along the left edge of the callout box.
msoCalloutTwo – Positions callout line diagonally down and away from the left edge of the callout box.
msoCalloutThree – Positions callout line straight out and then diagonally down and away from the left edge of the callout box.
msoCalloutFour – Positions callout line along the left edge of the callout text box.
msoCalloutMixed – A return value indicating that more than one MsoCalloutType exists in a range or selection.
- Left
Required Single. The position, in points, of the left edge of the callout's bounding box.
- Top
Required Single. The position, in points, of the top edge of the callout's bounding box.
- Width
Required Single. The width, in points, of the callout's bounding box.
- Height
Required Single. The height, in points, of the callout's bounding box.
- Anchor
Optional Object. A Range object that represents the text to which the callout is bound. 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 callout is positioned relative to the top and left edges of the page.
Remarks
You can insert a greater variety of callouts, such as balloons and clouds, using the AddShape method.
Thread Safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Platforms
Development Platforms
Windows XP Home Edition, Windows XP Professional, Windows Server 2003, and Windows 2000
Target Platforms
See Also
Reference
Shapes Interface
Microsoft.Office.Interop.Word Namespace