Hide Table of Contents
SortCutList Method (IBodyFolder)

Sorts the cut list.

.NET Syntax

Visual Basic (Declaration) 
Function SortCutList( _
   ByVal CutListSortOptions As System.Object, _
   ByVal IgnoreInvalidFacesOrFeatures As System.Boolean _
) As System.Boolean
Visual Basic (Usage) 
Dim instance As IBodyFolder
Dim CutListSortOptions As System.Object
Dim IgnoreInvalidFacesOrFeatures As System.Boolean
Dim value As System.Boolean
 
value = instance.SortCutList(CutListSortOptions, IgnoreInvalidFacesOrFeatures)
C# 
System.bool SortCutList( 
   System.object CutListSortOptions,
   System.bool IgnoreInvalidFacesOrFeatures
)
C++/CLI 
System.bool SortCutList( 
&   System.Object^ CutListSortOptions,
&   System.bool IgnoreInvalidFacesOrFeatures
) 

Parameters

CutListSortOptions
ICutListSortOptions
IgnoreInvalidFacesOrFeatures
True to sort bodies ignoring any invalid excluded faces/features, false to not sort the bodies if there are invalid excluded faces/features (see Remarks)

Return Value

True if sorting is successful, false if not

Example

See the IBodyFolder examples.

Remarks

Use IBodyFolder::GetCutListSortOptions to populate CutListSortOptions.

This method applies the CutListSortOptions settings, sorts the cut list, and refreshes the cut list in the FeatureManager design tree.

In the Cut List Sorting Options PropertyManager you select faces/features to exclude from sorting. If some of those selected faces/features to exclude are invalid, i.e., they are not of selection type BODYFEATURE or FACE or they cannot be excluded (see the end of this Remark), a dialog box pops up during the sort operation with:

----------------------------------------------------------------------

Failed to exclude some of the selected faces in cut list sorting. Try selecting the corresponding features instead.

Would you like to continue:

     Yes (Bodies will be sorted ignoring some of the excluded faces.)

     No (Bodies will not be sorted.)

----------------------------------------------------------

IgnoreInvalidFacesOrFeatures handles the situation when some of the body faces/features selected for exclusion (ICutListSortOptions::SetFacesOrFeaturesToExclude) can not be excluded.

Set IgnoreInvalidFacesOrFeatures to:

  • True, to sort bodies ignoring any invalid excluded faces/features.
  • False, to not sort the bodies if there are invalid excluded faces/features.

If you set IgnoreInvalidFacesOrFeatures to false and there are invalid faces/features in the exclusion list, then this method will not sort the cut list.

Other examples of faces and features that are invalid for exclusion:

  • Chamfers that remove an entire face.
  • Suppressed features.
  • Features that create new bodies from sketches, such as boss-extrude, revolve, and sweep.
  • Certain sheet metal features.

For more information, see the Sorting Cut Lists topics in the SOLIDWORKS user-interface help.

 

See Also

Availability

SOLIDWORKS 2020 FCS, Revision Number 28.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:   SortCutList Method (IBodyFolder)
*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) 2021 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.