Copyright © 2005-2023 MultiMedia Soft

OnTracksBoardDropFile event

Previous pageReturn to chapter overviewNext page

Remarks

 

Occurs when a new sound file item has been added to the TracksBoard's session following a drag & drop operation or a paste from the clipboard performed through the TracksBoard.ItemSoundFileFromClipboardPaste method: this callback can be set through a call to the CallbackTracksboardDropFileSet method.

 

This event replaces the usage of the CallbackTracksboardDropFile delegate and is only intended for usage with applications developed using Visual Basic 6 (which results unreliable when dealing with delegates and callbacks) and, in order to be enabled, requires a call to the COMEventEnable method with the nEventType parameter set to EVENT_TYPE_TRACKSB_DROP_FILE.

 

For further details about callback delegates see the How to synchronize the container application with the API tutorial.

For details about the use of the TracksBoard refer to the How to use the TracksBoard to visually compose songs tutorial.

For further details about methods of the TracksBoard refer to the TracksBoard class section.

 

 

Syntax

 

[Visual Basic]

OnTracksBoardDropFile (

ByVal nUniqueId as Integer

)

 

 

where "EditorApi" is declared in Visual Basic 6 code as:

 

Dim WithEvents EditorApi As AudioSoundEditorApi.AudioSoundEditorApiObj


 

 

Parameter

Description

 

 

nUniqueID

Unique identification number assigned to the sound item after a paste from the clipboard or after a drag & drop operation.

This value is set to -1 when the paste or drag & drop operation fails due to the file being of an unrecognized format.