HoleTables.add Method

Parent Object: HoleTables

PreviewThis functionality is provided as a preview of intended future API capabilities. You are encouraged to use it and report any problems or suggestions using the Fusion API and Scripts forum.

Because this is a preview of future functionality, there is the possibility that it will change, which will possibly break any existing programs that use this functionality. Because of that, you should never deliver any programs that use any preview capabilities. For a distributed program, you should wait until it has moved from preview to released state.


Defined in namespace "adsk::drawing" and the header file is <Drawing/Sheet/HoleTables.h>

Description

Creates a hole table on the sheet based on the provided input settings. Only holes from the view set on the input are included in the table; that view must be the view whose geometry the origin point lies on. A view can have more than one hole table. When the view does not already have an origin marker, one is created at HoleTableInput.originPoint. When the view already has an origin marker, HoleTableInput.originPoint is ignored and the existing marker is reused — a new origin cannot be placed on the same view.

Syntax

"holeTables_var" is a variable referencing a HoleTables object.

returnValue = holeTables_var.add(input)
"holeTables_var" is a variable referencing a HoleTables object.

#include <Drawing/Sheet/HoleTables.h>

returnValue = holeTables_var->add(input);
"holeTables_var" is a variable referencing a HoleTables object.

returnValue = holeTables_var.add(input);

Return Value

Type Description
HoleTable Returns the newly created HoleTable object, or null in the case of failure - for example when no view was set on the input, when the view has no holes, or when the view already has no origin marker and originPoint does not lie on geometry of that view.

Parameters

Name Type Description
input HoleTableInput A HoleTableInput object created using the HoleTables.createInput method.

Version

Introduced in version October 2026