Specifies whether the subdirectories to the files in the transmittal set are maintained during the creation of a transmittal package.
Supported platforms: Windows only
Namespace: TRANSMITTALLib
Assembly: acETransmit20.tlb
VBA/VB.NET/C#:
object.preserveSubdirs
Type: TransmittalInfo
The object this property applies to.
Read-only: No
Type: Long
Files are copied to the folders created in the path specified by the destinationRoot property. The preserveSubdirs property determines whether all subdirectories to the files in the transmittal set are maintained.
|
OrganizedFolder |
PreserveSubdirs |
Description |
|---|---|---|
|
0 |
0 |
All files are placed in a single folder; the folder structure is not maintained. |
|
1 |
0 |
Files are placed in a single folder while maintaining the subdirectories in which the files are stored. |
|
1 |
1 |
Folder structure is maintained, but the paths are not for referenced files. |
|
0 |
1 |
Folder structure and paths of referenced files are maintained. |
Releases: AutoCAD 2004 and later
VB.NET:
' Custom function used to setup a TransmittalInfo object
Private Shared Function TransInfo(ti As TransmittalInfo, destination As String) _
As TransmittalInfo
' Specify the folder that the files should be copied to
If System.IO.Directory.Exists(destination) = False Then
System.IO.Directory.CreateDirectory(destination)
End If
' Assign the location which the transmittal package should be stored
ti.destinationRoot = destination
' Maintain sub directories (0 - False, 1 - True)
ti.preserveSubdirs = vbTrue
' Maintain folder paths
' ti.organizedFolder = 0 and ti.preserveSubdirs = 0 -
' All files are placed in a single folder which is specified
' by the destinationRoot property
' ti.organizedFolder = 1 and ti.preserveSubdirs = 0 -
' Files are placed in a single folder, but maintain one level
' of subdirectory strcuture
' ti.organizedFolder = 0 and ti.preserveSubdirs = 1 -
' Folder structure is maintained, but the paths for
' reference files are not
' ti.organizedFolder = 1 and ti.preserveSubdirs = 1 -
' Folder structure and reference paths are maintained
ti.organizedFolder = vbTrue
' Change referenced files to use relative paths (0 - False, 1 - True)
ti.dataLinkRelativePath = vbTrue
ti.DGNUnderlayRelativePath = vbTrue
ti.DWFUnderlayRelativePath = vbTrue
ti.imageRelativePath = vbTrue
ti.PDFUnderlayRelativePath = vbTrue
ti.xrefRelativePath = vbTrue
' Set the default drawing file format for all DWG, DWT, and DWS files
' SaveDwgFormat.eAutoCAD14 - AutoCAD R14
' SaveDwgFormat.eAutoCAD2000 - AutoCAD 2000
' SaveDwgFormat.eAutoCADR18 - AutoCAD 2004
' SaveDwgFormat.eAutoCADR21 - AutoCAD 2007
' SaveDwgFormat.eAutoCADR24 - AutoCAD 2010
' SaveDwgFormat.eAutoCADR27 - AutoCAD 2013
' SaveDwgFormat.eAutoCADR32 - AutoCAD 2018
' SaveDwgFormat.eNoConversion - Keep current format
ti.saveVersion = SaveDwgFormat.eNoConversion
' Maintain visual fidelity (SAVEFIDELITY system variable)
' 0 - Saved without visual fidelity
' 1 - Annotation objects assigned annotative scales are saved to
' separate layers for each scale used.
' Only affects drawings when saving to AutoCAD 2007 or earlier file formats.
ti.visualFidelity = vbTrue
' Include DWG Xrefs (Unloaded and Unreferenced: 0 - False, 1 - True)
ti.includeXrefDwg = vbTrue
ti.includeUnloadedReferences = vbTrue
ti.includeUnloadedXrefDwg = vbTrue
ti.includeNestedOverlayXrefDwg = vbTrue
' Bind xrefs attached to a drawing (0 - False, 1 - True)
' BindType.eBind - Use the Bind type to bind the xrefs
' BindType.eInsert - Use the Insert type to bind the xrefs
ti.BindType = BindType.eInsert
' Remove paths from xrefs (0 - False, 1 - True)
ti.depathXrefs = vbTrue
' Include images, underlays, and datalink file (0 - False, 1 - True)
ti.includeImageFile = vbTrue
ti.includeDGNUnderlay = vbTrue
ti.includeDWFUnderlay = vbTrue
ti.includePDFUnderlay = vbTrue
ti.includeDataLinkFile = vbTrue
' Include font (SHX/TTF) and font map (FMP) files (0 - False, 1 - True)
ti.includeFontFile = vbTrue
' Reset plotters for layouts in the drawings to None,
' and include plot style (CTB/STB) files (0 - False, 1 - True)
ti.resetPlotter = vbFalse
ti.includePlotFile = vbTrue
' Specify where the plot files are located so the API can resolve the file
' paths (used when includePlotFile = vbTrue or 1)
ti.plotConfigFilePath = Environment.GetEnvironmentVariable("UserProfile") + _
"\AppData\Roaming\Autodesk\AutoCAD <release>\<version>\enu\Plotters"
ti.plotStyleTablePath = Environment.GetEnvironmentVariable("UserProfile") + _
"\AppData\Roaming\Autodesk\AutoCAD <release>\<version>\enu\Plotters\Plot Styles"
' Get the photometric Web and material files used by lights
' and 3D objects for rendering (0 - False, 1 - True)
ti.includePhotometricWebFile = vbTrue
ti.includeMaterialTextureFile = vbTrue
' Purge unused named objects for all drawing files in the
' Transmittal(Package(0 - False, 1 - True))
ti.purgeDatabase = vbFalse
Return ti
End Function
C#:
// Custom function used to setup a TransmittalInfo object
private static TransmittalInfo TransInfo(TransmittalInfo ti, string destination)
{
// Specify the folder that the files should be copied to
if (System.IO.Directory.Exists(destination) == false)
{
System.IO.Directory.CreateDirectory(destination);
}
// Assign the location which the transmittal package should be stored
ti.destinationRoot = destination;
// Maintain sub directories (0 - False, 1 - True)
ti.preserveSubdirs = 1;
/*
Maintain folder paths
ti.organizedFolder = 0 and ti.preserveSubdirs = 0 -
All files are placed in a single folder which is specified
by the destinationRoot property
ti.organizedFolder = 1 and ti.preserveSubdirs = 0 -
Files are placed in a single folder, but maintain one level
of subdirectory strcuture
ti.organizedFolder = 0 and ti.preserveSubdirs = 1 -
Folder structure is maintained, but the paths for
reference files are not
ti.organizedFolder = 1 and ti.preserveSubdirs = 1 -
Folder structure and reference paths are maintained
*/
ti.organizedFolder = 1;
// Change referenced files to use relative paths (0 - False, 1 - True)
ti.dataLinkRelativePath = 1;
ti.DGNUnderlayRelativePath = 1;
ti.DWFUnderlayRelativePath = 1;
ti.imageRelativePath = 1;
ti.PDFUnderlayRelativePath = 1;
ti.xrefRelativePath = 1;
/* Set the default drawing file format for all DWG, DWT, and DWS files
SaveDwgFormat.eAutoCAD14 - AutoCAD R14
SaveDwgFormat.eAutoCAD2000 - AutoCAD 2000
SaveDwgFormat.eAutoCADR18 - AutoCAD 2004
SaveDwgFormat.eAutoCADR21 - AutoCAD 2007
SaveDwgFormat.eAutoCADR24 - AutoCAD 2010
SaveDwgFormat.eAutoCADR27 - AutoCAD 2013
SaveDwgFormat.eAutoCADR32 - AutoCAD 2018
SaveDwgFormat.eNoConversion - Keep current format
*/
ti.saveVersion = SaveDwgFormat.eNoConversion;
/*
Maintain visual fidelity (SAVEFIDELITY system variable)
0 - Saved without visual fidelity
1 - Annotation objects assigned annotative scales are saved to
separate layers for each scale used.
Only affects drawings when saving to AutoCAD 2007 or earlier file formats.
*/
ti.visualFidelity = 1;
// Include DWG Xrefs (Unloaded and Unreferenced: 0 - False, 1 - True)
ti.includeXrefDwg = 1;
ti.includeUnloadedReferences = 1;
ti.includeUnloadedXrefDwg = 1;
ti.includeNestedOverlayXrefDwg = 1;
/*
Bind xrefs attached to a drawing (0 - False, 1 - True)
BindType.eBind - Use the Bind type to bind the xrefs
BindType.eInsert - Use the Insert type to bind the xrefs
*/
ti.BindType = BindType.eInsert;
// Remove paths from xrefs (0 - False, 1 - True)
ti.depathXrefs = 1;
// Include images, underlays, and datalink file (0 - False, 1 - True)
ti.includeImageFile = 1;
ti.includeDGNUnderlay = 1;
ti.includeDWFUnderlay = 1;
ti.includePDFUnderlay = 1;
ti.includeDataLinkFile = 1;
// Include font (SHX/TTF) and font map (FMP) files (0 - False, 1 - True)
ti.includeFontFile = 1;
// Reset plotters for layouts in the drawings to None,
// and include plot style (CTB/STB) files (0 - False, 1 - True)
ti.resetPlotter = 0;
ti.includePlotFile = 1;
// Specify where the plot files are located so the API can resolve the file
// paths (used when includePlotFile = True or 1)
ti.plotConfigFilePath = Environment.GetEnvironmentVariable("UserProfile") +
"\\AppData\\Roaming\\Autodesk\\AutoCAD <release>\\<version>\\enu\\Plotters";
ti.plotStyleTablePath = Environment.GetEnvironmentVariable("UserProfile") +
"\\AppData\\Roaming\\Autodesk\\AutoCAD <release>\\<version>\\enu\\Plotters\\Plot Styles";
// Get the photometric Web and material files used by lights
// and 3D objects for rendering (0 - False, 1 - True)
ti.includePhotometricWebFile = 1;
ti.includeMaterialTextureFile = 1;
// Purge unused named objects for all drawing files in the
// Transmittal(Package(0 - False, 1 - True))
ti.purgeDatabase = 0;
return ti;
}