Hide Table of Contents
SetPosition Method (IAnnotation)

Sets the position of this annotation.

.NET Syntax

Visual Basic (Declaration) 
Function SetPosition( _
   ByVal X As System.Double, _
   ByVal Y As System.Double, _
   ByVal Z As System.Double _
) As System.Boolean
Visual Basic (Usage) 
Dim instance As IAnnotation
Dim X As System.Double
Dim Y As System.Double
Dim Z As System.Double
Dim value As System.Boolean
value = instance.SetPosition(X, Y, Z)
System.bool SetPosition( 
   System.double X,
   System.double Y,
   System.double Z
System.bool SetPosition( 
&   System.double X,
&   System.double Y,
&   System.double Z



x origin of the annotation


y origin of the annotation


z origin of the annotation

Return Value

True if the position of the annotation was set, false if the operation was not successful



The following table lists the types of annotations that this method supports and the position of the x, y, z origin. In a drawing, the x, y, z origin is relative to the origin of the drawing sheet (the lower-left corner of the sheet).


Type of Annotation Position of XYZ Origin
Datum Feature Symbols Point where leader hits symbol
Datum Target Symbols Centerpoint of the circle that is attached to the leader
Dimensions Upper-left corner of the text box of the dimension
Geometric Tolerances Upper-left corner of the symbol
Notes Upper-left corner of the text box
Revision Clouds Position of x,y,z determined by IRevisionCloud::Shape
Surface Finish Symbols Lower-left point of symbol
Table Annotations Position of x,y,z determined by ITableAnnotation::AnchorType
Weld Symbols Left endpoint of the main horizontal line in the symbol


If you use this method on any other types of annotations, SolidWorks takes no action and returns false.

The position of an annotation may be subject to certain restrictions. These restrictions apply to setting the position through the user interface and using this method. One example of a restriction is a surface-finish symbol that is inserted directly on a face (that is, no leaders). It can only be moved within the borders of that face. If it is inserted directly on an edge, it can only be moved along that edge or extensions of that edge. Datum feature symbols have similar restrictions. If this method attempts to set a position of an annotation that violates any restrictions, the annotation is placed as near as possible to the specified position.

The position of table annotations cannot be set if the table is anchored. Use ITableAnnotation::Anchored
to determine if the table is anchored.

If a dimension has offset text, and you want to move... Then...
Dimension text, dimension line, and extension lines
  1. Turn offset text off.
  2. Use this method to move the dimension text, dimension line, and extension lines.
  3. Turn offset text back on.
Dimension text only Use this method to move the dimension text. The dimension line and extension lines
will not move.

Because radial and diametric dimensions are already attached to the end of a leader, this property is not available for these types of dimensions.


See Also


SolidWorks 2000 FCS, Revision Number 8.0

Provide feedback on this topic

SOLIDWORKS welcomes your feedback concerning the presentation, accuracy, and thoroughness of the documentation. Use the form below to send your comments and suggestions about this topic directly to our documentation team. The documentation team cannot answer technical support questions. Click here for information about technical support.

* Required

Subject:   Feedback on Help Topics
Page:   SetPosition Method (IAnnotation)
*   I acknowledge I have read and I hereby accept the privacy policy under which my Personal Data will be used by Dassault Systèmes

Print Topic

Select the scope of content to print:


We have detected you are using a browser version older than Internet Explorer 7. For optimized display, we suggest upgrading your browser to Internet Explorer 7 or newer.

 Never show this message again

Web Help Content Version: API Help (English only) 2013 SP05

To disable Web help from within SOLIDWORKS and use local help instead, click Help > Use SOLIDWORKS Web Help.

To report problems encountered with the Web help interface and search, contact your local support representative. To provide feedback on individual help topics, use the “Feedback on this topic” link on the individual topic page.