Additional Options

The Additional Options page is used to customize Properties by special features. The additional options are divided into three groups: Value Format, Operational, and Miscellaneous.

Format string

Determines the value to be written to the Checkbox type of Property when selected, or the date format written to the Property of type Date.

Property Type Format String button
Date Customize how the date is inserted in the custom property. Opens a menu to select different date formats for day, month, and year.
Checkbox Defines the value written to the Property when the checkbox is selected. Not available
Format string for unchecked

Sets the value to be written to the Checkbox type of Property when the checkbox is not selected.

NOTE: The Format string for unchecked box is visible only when the Property type is Checkbox.
Maximum length Sets the maximum length for the value of the selected Property. If the value assigned in the Properties pane exceeds the maximum length, a notification is shown.
TIP: Watch these instructive videos about the Property options. Links opens in a new tab, or when opened from the ATR CustomTools offline helps, in a new tab in the default browser.
Copy as model property Select to copy the Weldment scoped custom property with its value to the referenced model on the SOLIDWORKS Rebuild operation.
Copy as drawing property Select to copy the model scoped custom property with its value to the referenced drawing on the SOLIDWORKS Rebuild operation.

Once assigned, save the model and rebuild the drawing to copy the property value into the SOLIDWORKS drawing custom properties.

Clear on Save As and Save As Copy The custom property value will be cleared when the action is set to Save As or Save As Copy.
Save value in uppercase The value of Property is saved with all letters in uppercase.
Track history Enable or disable history tracking of the Property. Stores up to ten previous values of the Property in the SOLIDWORKS document. A history entry is created only if the property's value is changed.
TIP: Watch these instructive videos about the associated Property options. Links opens in a new tab, or when opened from the ATR CustomTools offline helps, in a new tab in the default browser.
Display in Print/Convert Determines whether the Property can be used as filtering criteria in ATR CustomTools batch operations executed with the Print/Convert feature.
Display in Design Tree Determines whether to show the Property and its value in the Design Tree in ATR CustomTools Viewer.
Display in Copy Determines whether to show the Property in the Copy file list.
Enable changing of value in printing

Allow or prevent changing the property value in ATR CustomTools batch operations.

While you have this option selected, the property value can be modified from the Overwrite Property Values page in the Batch Operation dialog box related to the Print/Convert feature. This option also overrides the Hidden option set in the Basic Information page so you can overwrite values of properties that are hidden in the Properties pane.

Allow scripting The Allow scripting option allows ATR CustomTools to control the specific property value by add-in script when the property’s value is changed.
NOTE: Overwriting values stored in documents' revision data is not supported.

When Allow scripting is selected, changing the Property value raises an API event called OnCustomPropertyChanged which allows manipulating values of all Properties with Allow scripting selected.

Also, when Allow scripting is selected for any Property, accepting changes raises an API event called OnValidateCustomProperties which allows canceling the save operation and displaying a customized message to the user.

Custom definition of the selected property does not affect normal usage of ATR CustomTools features, but can be used to store large amounts of data from the user interface into the Property.

Click the ThreeDotsButton button to open the custom definition dialog box to set up the definition for the value of the selected Property.

NOTE: The custom definition dialog box may vary depending on customizations implemented.

ATR CustomTools add-in scripts can access the Property's custom definition data through various API Events that provide the ICTProperty object as an argument.