Hide Table of Contents

System Options > External References



Get/Set Methods

Return Value


Open referenced documents with read-only access


ISldWorks::SetUserPreferenceToggle(swUserPreferenceToggle_e.swExtRefOpenReadOnly, <OnFlag>)

Boolean value

Specifies whether to open referenced documents as read-only

Don't prompt to save read-only referenced documents (discard changes)


ISldWorks::SetUserPreferenceToggle(swUserPreferenceToggle_e.swExtRefNoPromptOrSave, <OnFlag>)

Boolean value

Specifies whether to close read-only reference documents without prompting or attempting to save changes made to them when saving or closing the parent document

Allow multiple contexts for parts when editing in assembly


ISldWorks::SetUserPreferenceToggle(swUserPreferenceToggle_e.swExtRefMultipleContexts, <OnFlag>)

Boolean value

Specifies whether to create external references to a single part from more than one assembly context

Load referenced documents


ISldWorks::SetUserPreferenceIntegerValue(swUserPreferenceIntegerValue_e.swLoadExternalReferences, swLoadExternalReferences_e.<Value>)

See swLoadExternalReferences_e for valid options


Load documents in memory only


ISldWorks::SetUserPreferenceToggle(swUserPreferenceToggle_e.swExtRefLoadRefDocsInMemory, <OnFlag>)

Boolean value

Specifies whether to load reference documents in memory only

Search external references in - Reference Documents specified in File Location


ISldWorks::SetUserPreferenceToggle(swUserPreferenceToggle_e.swUseFolderSearchRules, <OnFlag>)

Boolean value


Specifies whether to search the Referenced Documents list of folders in the File Locations Options dialog

Search external references in - Reference Documents specified in File Location - Include sub-folders


ISldWorks::SetUserPreferenceToggle(swUserPreferenceToggle_e.swExtRefIncludeSubFolders, <OnFlag>)

Boolean value

Specifies whether to search for reference documents in sub-folders in the specified file location; valid only if Reference Documents specified in File Location is true

Search external references in - Reference Documents specified in File Location - Exclude active folders and recent save locations


ISldWorks::SetUserPreferenceToggle(swUserPreferenceToggle_e.swExtRefExcludeActiveFoldersAndRecentSaveLocations, <OnFlag>)

Boolean value

Specifies whether to block searching for reference documents in open folders and folders containing recently saved items; valid only if Reference Documents specified in File Location is true

Update out-of-date linked design tables to


ISldWorks::SetUserPreferenceIntegerValue(swUserPreferenceIntegerValue_e.swExternalReferencesUpdateOutOfDateLinkedDesignTable, swExternalReferencesUpdateOutOfDateLinkedDesignTable_e.<Value>)

See swExternalReferencesUpdateOutOfDateLinkedDesignTable_e for valid options


Assemblies - Automatically generate names for referenced geometry


ISldWorks::SetUserPreferenceToggle(swUserPreferenceToggle_e.swExtRefAutoGenNames, <OnFlag>)

Boolean value


Specifies whether to automatically generate names for referenced geometry

Assemblies - Update component names when documents are replaced


ISldWorks::SetUserPreferenceToggle(swUserPreferenceToggle_e.swExtRefUpdateCompNames, <OnFlag>)

Boolean value


Specifies whether to mate to read-only parts using internal face IDs of the parts or to replace components using surface identifiers to write-access parts

Assemblies - Do not create references external to the model


ISldWorks::SetUserPreferenceToggle(swUserPreferenceToggle_e.swExternalReferencesDisable, <OnFlag>)

Boolean value


Specifies whether to create external references when designing in the context of an assembly

Show "x" in feature tree for broken external references


ISldWorks::SetUserPreferenceToggle(swUserPreferenceToggle_e.swExtRefShowXInFeatureTree, <OnFlag>)


Boolean value

Specifies whether to hide or show the x that appears in the FeatureManager design tree to indicate broken references


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:   System Options > ExternalReferences
*   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) 2018 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.