Hide Table of Contents
CreateEllipse Method (ISketchManager)

Creates an ellipse using the specified center, major-axis, and minor-axis points.

.NET Syntax

Visual Basic (Declaration) 
Function CreateEllipse( _
   ByVal XC As System.Double, _
   ByVal YC As System.Double, _
   ByVal Zc As System.Double, _
   ByVal XMajor As System.Double, _
   ByVal YMajor As System.Double, _
   ByVal ZMajor As System.Double, _
   ByVal XMinor As System.Double, _
   ByVal YMinor As System.Double, _
   ByVal ZMinor As System.Double _
) As SketchSegment
Visual Basic (Usage) 
Dim instance As ISketchManager
Dim XC As System.Double
Dim YC As System.Double
Dim Zc As System.Double
Dim XMajor As System.Double
Dim YMajor As System.Double
Dim ZMajor As System.Double
Dim XMinor As System.Double
Dim YMinor As System.Double
Dim ZMinor As System.Double
Dim value As SketchSegment
 
value = instance.CreateEllipse(XC, YC, Zc, XMajor, YMajor, ZMajor, XMinor, YMinor, ZMinor)
C# 
SketchSegment CreateEllipse( 
   System.double XC,
   System.double YC,
   System.double Zc,
   System.double XMajor,
   System.double YMajor,
   System.double ZMajor,
   System.double XMinor,
   System.double YMinor,
   System.double ZMinor
)
C++/CLI 
SketchSegment^ CreateEllipse( 
&   System.double XC,
&   System.double YC,
&   System.double Zc,
&   System.double XMajor,
&   System.double YMajor,
&   System.double ZMajor,
&   System.double XMinor,
&   System.double YMinor,
&   System.double ZMinor
) 

Parameters

XC
X coordinate of the ellipse center point
YC
Y coordinate of the ellipse center point
Zc
Z coordinate of the ellipse center point
XMajor
X coordinate of the point on the ellipse that is on the major axis
YMajor
Y coordinate of the point on the ellipse that is on the major axis
ZMajor
Z coordinate of the point on the ellipse that is on the major axis
XMinor
X coordinate of the point on the ellipse that is on the minor axis
YMinor
Y coordinate of the point on the ellipse that is on the minor axis
ZMinor
Z coordinate of the point on the ellipse that is on the minor axis

Return Value

Sketch segment for the ellipse

Example

Remarks

This method creates a full ellipse in the active 2D sketch. If a sketch is not active, then a new sketch is created. You can check for an active sketch using ISketchManager::ActiveSketch.

 

ISketchManager::AddToDB and ISketchManager::DisplayWhenAdded increase performance during entity creation by adding entities directly to the SOLIDWORKS database.

 

ISketchManager::AddToDB also avoids some of the peculiarities involved with creating entities via the user interface, such as inferencing, automatic relations, and snapping to the grid. Adding entities directly to the database also significantly increases the performance of this method. When you are done creating entities, it is important to ISketchManager::AddToDB(False), to restore SOLIDWORKS to its normal operating mode.

 

This method also works with ISketchManager::DisplayWhenAdded. If you have called ISketchManager::AddToDB(True), additional performance can be gained by calling ISketchManager::DisplayWhenAdded(False) to disable immediate display of entities as they are added to the database. When you are done creating all of your sketch entities, you must redraw your document window (see IModelView::GraphicsRedraw or IModelView::IGraphicsRedraw) to see the entities you added. You should also restore the original display settings by calling ISketchManager::DisplayWhenAdded(True).

 

To create a partial ellipse, use ISketchManager::CreateEllipticalArc.

 

See Also

Availability

SOLIDWORKS 2008 FCS, Revision Number 16.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

 
*Email:  
Subject:   Feedback on Help Topics
Page:   CreateEllipse Method (ISketchManager)
*Comment:  
*   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:

x

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
x

Web Help Content Version: API Help (English only) 2017 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.