Class: BlackBoxAnnotationManager

CoreControls. BlackBoxAnnotationManager

An object which manages anonymous user annotations when using BlackBox.

new BlackBoxAnnotationManager(serverRoot, docViewer)

Creates a new instance of BlackBoxAnnotationManager. * Note: As of version 6.3, directly constructing a BlackBoxAnnotationManager is deprecated and the capability will be removed in a future version. Please use the CoreControls#getBlackBoxAnnotationManager function instead.
Parameters:
Name Type Description
serverRoot string The blackbox annotation server to contact for annot storing.
docViewer CoreControls.DocumentViewer

Methods


disableCollaboration()

Disables collaboration by closing the annotation server connection.

initiateCollaboration(The)

Opens a connection to the annotation server and sets up collaboration.
Parameters:
Name Type Description
The string document ID of the object to intiate annotation collaboration on.

preloadAnnotations(An)

Preloads existing annotations made without realtime collaboration enabled, will only trigger once on initial collaboration enabling event.
Parameters:
Name Type Description
An Array.<Annotations.Annotation> array of annotation objects.

Events


blackBoxAnnotationsDisabled

Triggered when collaboration has abruptly closed or been disabled. Attach like bbAnnotManager.on('blackBoxAnnotationsDisabled', callback)

blackBoxAnnotationsEnabled

Triggered when collaboration is enabled for blackbox. Attach like bbAnnotManager.on('blackBoxAnnotationsEnabled', callback)
Parameters:
Name Type Description
username string user name as specified by blackbox collaboration.
userId string user ID as specified by blackbox collaboration.