Events for Visual Basic 6 COM interoperability > OnTracksBoardItemClick event

Remarks

Occurs when a mouse button is clicked over a sound item available on the TracksBoard.

This event replaces the usage of the CallbackTracksboardItemClicked 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_ITEM_CLICK.

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]

EditorApi_OnTracksBoardItemClick (

ByVal nButton as enumMouseButtons,

ByVal nUniqueId as Integer,

ByVal nPressPosInMs as Long

)

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

Dim WithEvents EditorApi As AudioSoundEditorApi.AudioSoundEditorApiObj

Parameter

Description

nButton

Clicked mouse button.

Supported values are the following:

Mnemonic constant	Value	Meaning
MOUSE_BTN_LEFT	0	Left mouse button
MOUSE_BTN_RIGHT	1	Right mouse button
MOUSE_BTN_MIDDLE	2	Middle mouse button

nUniqueID

Unique identification number assigned to the sound item after being generated by one of the following methods:

•	TracksBoard.ItemSoundFileAdd and TracksBoard.ItemSoundFileRawAdd for sound files

•	TracksBoard.ItemSpeechFromStringAdd and TracksBoard.ItemSpeechFromFileAdd for text to speech items

•	TracksBoard.ItemClone when an existing item has been cloned

nPressPosInMs

Position of the click, expressed in milliseconds, respect to the beginning of the session