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::GetUserPreferenceToggle(swUserPreferenceToggle_e. swExtRefNoPromptOrSave)

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::GetUserPreferenceToggle(swUserPreferenceToggle_e. swExtRefMultipleContexts)

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::GetUserPreferenceIntegerValue(swUserPreferenceIntegerValue_e. swLoadExternalReferences)

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

See swLoadExternalReferences_e for valid options


Search file locations for external references

ISldWorks::GetUserPreferenceToggle(swUserPreferenceToggle_e. swUseFolderSearchRules)

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

Boolean value


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

Update out-of-date linked design tables to

ISldWorks::GetUserPreferenceIntegerValue(swUserPreferenceIntegerValue_e. swExternalReferencesUpdateOutOfDateLinkedDesignTable)

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

See swExternalReferencesUpdateOutOfDateLinkedDesignTable_e for valid options


Assemblies - Automatically generate names for referenced geometry

ISldWorks::GetUserPreferenceToggle(swUserPreferenceToggle_e. swExtRefAutoGenNames)

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::GetUserPreferenceToggle(swUserPreferenceToggle_e. swExtRefUpdateCompNames)

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::GetUserPreferenceToggle(swUserPreferenceToggle_e. swExternalReferencesDisable)

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::GetUserPreferenceToggle(swUserPreferenceToggle_e. swExtRefShowXInFeatureTree)

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) 2012 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.