Occurrence.breakLink Method

Parent Object: Occurrence
Defined in namespace "adsk::fusion" and the header file is <Fusion/Components/Occurrence.h>

Description

When the component this occurrence references is an external reference (the isReferencedComponent property returns true), this will break the link and create a local Component that this occurrence will reference. The new local Component can be accessed through the Occurrence using the component property.

This method will fail if the occurrence is not referencing an external component.

Syntax

"occurrence_var" is a variable referencing an Occurrence object.

returnValue = occurrence_var.breakLink()
"occurrence_var" is a variable referencing an Occurrence object.

#include <Fusion/Components/Occurrence.h>

returnValue = occurrence_var->breakLink();
"occurrence_var" is a variable referencing an Occurrence object.

returnValue = occurrence_var.breakLink();

Return Value

Type Description
boolean Returns true if the break link was successful.

Samples

Name Description
Break Link API Sample

Demonstrates how to iterate over all top-level occurrences and break the link for each referenced component.

Before running: Run from Scripts and Add-Ins. This sample may open dialogs or require interactive choices; keep Fusion in the foreground. Use a design with assembly structure (components/occurrences) when the script reads existing geometry; some scripts create their own assembly.

Version

Introduced in version September 2017