CancelDatabaseNotification Method (ActiveX/ATO)

Unregisters a database callback notification handler that was previously registered.

Namespace: TRANSMITTALLib

Assembly: AcETransmit19.tlb

Signature

VB.NET:

object.cancelDatabaseNotification pHandler

C#:

object.cancelDatabaseNotification(pHandler);

object

Type: TransmittalOperation object

The object this method applies to.

pHandler

Access: Input-only

Type: TransmittalDatabaseNotificationHandler object

The object that represents the custom class which implements the database notifications for your application.

Return Value (RetVal)

No return value.

Remarks

No additional remarks.

Release Information

Releases: AutoCAD 2005 and later

• AcETransmit19.tlb - AutoCAD 2015 and later
• AcETransmit18.tlb - AutoCAD 2010 through AutoCAD 2014
  • The ITransmittalOperation2 interface was merged with the ITransmittalOperation interface in the AutoCAD 2010 version of the library.
• AcETransmit16.tlb - AutoCAD 2005 through AutoCAD 2009
  • The cancelDatabaseNotification method was introduced with the ITransmittalOperation2 interface in the AutoCAD 2005 version of the library.

Examples

VB.NET:

' Notification handlers
Private Shared g_dbHandler As New MyTransDbNotifier
Private Shared g_fileHandler As New MyTransFileNotifier
Private Shared g_ssmHandler As New MyTransSSMNotifier

' Custom command that subscribes to eTransmit notifications
' Works with the transmittal API and ETRANSMIT/ARCHIVE commands
<CommandMethod("ETNotificationsStart")> _
Public Shared Sub ETNotificationsStart()
    ' Add the handlers
    g_tro.subscribeToAddFileNotification(g_fileHandler)
    g_tro.subscribeDatabaseNotification(g_dbHandler)
    g_tro.subscribeSheetSetNotification(g_ssmHandler)
End Sub

' Custom command that unsubscribes to eTransmit notifications
' Works with the transmittal API and ETRANSMIT/ARCHIVE commands
<CommandMethod("ETNotificationsEnd")> _
Public Shared Sub ETNotificationsEnd()
    ' Remove the handlers
    g_tro.cancelSubscriptionToAddFileNotification(g_fileHandler)
    g_tro.cancelDatabaseNotification(g_dbHandler)
    g_tro.cancelSheetSetNotification(g_ssmHandler)
End Sub

C#:

// Notification handlers
private static MyTransDbNotifier g_dbHandler = new MyTransDbNotifier();
private static MyTransFileNotifier g_fileHandler = new MyTransFileNotifier();
private static MyTransSSMNotifier g_ssmHandler = new MyTransSSMNotifier();

// Custom command that subscribes to eTransmit notifications
// Works with the transmittal API and ETRANSMIT/ARCHIVE commands
[CommandMethod("ETNotificationsStart")]
public static void ETNotificationsStart()
{
    // Add the handlers
    g_tro.subscribeToAddFileNotification(g_fileHandler);
    g_tro.subscribeDatabaseNotification(g_dbHandler);
    g_tro.subscribeSheetSetNotification(g_ssmHandler);
}

// Custom command that unsubscribes to eTransmit notifications
// Works with the transmittal API and ETRANSMIT/ARCHIVE commands
[CommandMethod("ETNotificationsEnd")]
public static void ETNotificationsEnd()
{
    // Remove the handlers
    g_tro.cancelSubscriptionToAddFileNotification(g_fileHandler);
    g_tro.cancelDatabaseNotification(g_dbHandler);
    g_tro.cancelSheetSetNotification(g_ssmHandler);
}