ConvertDatabase Method (ActiveX/ATO)

Triggered when a drawing file is being converted during the creation of a transmittal package.

Supported platforms: Windows only

Namespace: TRANSMITTALLib

Assembly: AcETransmit19.tlb

Signature

VB.NET:

Friend Class custom_class_name
    Implements TransmittalDatabaseNotificationHandler

    Public Function convertDatabase(pDatabase As Object, _
                                    pFile As TransmittalFile, _
                                    pTransmit As TransmittalOperation) _
                                As Integer _
                  Implements ITransmittalDatabaseNotificationHandler.convertDatabase
        ...
    End Function

End Class

C#:

internal class custom_class_name : TransmittalDatabaseNotificationHandler
{
     public int convertDatabase(object pDatabase, 
                                TransmittalFile pFile,
                                TransmittalOperation pTransmit)
     {
        ...
        return RetVal;
     }
}

custom_class_name

The name of the custom class.

pDatabase

Access: Input-only

Type: Object

Pointer to the AcadDatabase object that is being converted.

pFile

Access: Input-only

Type: TransmittalFile object

Pointer to the TransmittalFile object that contains information about the drawing file in which the database is stored.

pTransmit

Access: Input-only

Type: TransmittalOperation object

Pointer to the TransmittalOperation object that represents the transmittal set in which the drawing file is contained.

Return Value (RetVal)

Type: Integer

Value indicates whether the database was modified.

• 0 (False): Database was not modified
• 1 (True): Database was modified

Remarks

No additional remarks.

Release Information

Releases: AutoCAD 2005 and later

• AcETransmit19.tlb - AutoCAD 2015 and later
• AcETransmit18.tlb - AutoCAD 2010 through AutoCAD 2014
• AcETransmit16.tlb - AutoCAD 2005 through AutoCAD 2009

Examples

VB.NET:

' Custom class used to monitor the processing of a drawing
Friend Class MyTransDbNotifier
    Implements TransmittalDatabaseNotificationHandler

    Public Function convertDatabase(pDatabase As Object, _
                                    pFile As TRANSMITTALLib.TransmittalFile, _
                                    pTransmit As TRANSMITTALLib.TransmittalOperation) _
                                As Integer _
                  Implements TRANSMITTALLib. _
                     ITransmittalDatabaseNotificationHandler.convertDatabase

        Application.DocumentManager.MdiActiveDocument.Editor. _
            WriteMessage(Environment.NewLine & "Database converting: " & pFile.sourcePath)

        Return 1
    End Function
End Class

C#:

// Custom class used to monitor the processing of a drawing
internal class MyTransDbNotifier : TransmittalDatabaseNotificationHandler
{
    public int convertDatabase(object pDatabase, TRANSMITTALLib.TransmittalFile pFile,
                               TRANSMITTALLib.TransmittalOperation pTransmit)
    {
        Application.DocumentManager.MdiActiveDocument.Editor.
            WriteMessage(Environment.NewLine + "Database converting: " + pFile.sourcePath);

        return 1;
    }
}