Callback delegates > CallbackWaveformScrollerMouseNotif delegate

Remarks

Callback delegate invoked every time a mouse event happens on the waveform scroller: this callback can be set through a call to the CallbackWaveformScrollerMouseNotifSet method.

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

For further details about methods of the Waveform scroller refer to the WaveformScroller object.

For a tutorial about the use of Waveform scrollers refer to the How to scroll the sound's waveform during playback tutorial.

Syntax

[Visual Basic]

Public Delegate Sub CallbackWaveformScrollerMouseNotif (

hWndWaveformScroller as IntPtr,

nAction as enumMouseActions,

nFlags as Int32,

xPos as Int32,

yPos as Int32,

nPressPosInPix as Int32,

nPressPosInMs as Int32

)

[C#]

public delegate void CallbackWaveformScrollerMouseNotif (

IntPtr hWndWaveformScroller,

enumMouseActions nAction,

Int32 nFlags,

Int32 xPos,

Int32 yPos,

Int32 nPressPosInPix,

Int32 nPressPosInMs

)

[C++]

public delegate void CallbackWaveformScrollerMouseNotif (

IntPtr hWndWaveformScroller,

enumMouseActions nAction,

Int32 nFlags,

Int32 xPos,

Int32 yPos,

Int32 nPressPosInPix,

Int32 nPressPosInMs

)

Parameter

Description

hWndWaveformScroller

Handle of the control returned by a previous call to the WaveformScroller.Create method

nAction

Mouse action type.

Supported values are the following:

Mnemonic constant	Value	Meaning
MOUSE_ACTION_LEFT_DOWN	0	Left mouse button down
MOUSE_ACTION_LEFT_UP	1	Left mouse button up
MOUSE_ACTION_LEFT_CLICK	2	Left mouse button click
MOUSE_ACTION_LEFT_DBLCLICK	3	Left mouse button double click
MOUSE_ACTION_RIGHT_DOWN	4	Right mouse button down
MOUSE_ACTION_RIGHT_UP	5	Right mouse button up
MOUSE_ACTION_RIGHT_CLICK	6	Right mouse button click
MOUSE_ACTION_RIGHT_DBLCLICK	7	Right mouse button double click
MOUSE_ACTION_MOVE	8	Mouse move
MOUSE_ACTION_MIDDLE_DOWN	9	Middle mouse button down
MOUSE_ACTION_MIDDLE_UP	10	Middle mouse button up
MOUSE_ACTION_MIDDLE_CLICK	11	Middle mouse button click
MOUSE_ACTION_MIDDLE_DBLCLICK	12	Middle mouse button double click
MOUSE_ACTION_WHEEL_SCROLL_BACK	13	Mouse wheel scroll back
MOUSE_ACTION_WHEEL_SCROLL_FORWARD	14	Mouse wheel scroll forward

nFlags

Can be a combination of the following values:

Value	Meaning
1	Set if left mouse button is down (defined as MK_LBUTTON inside the Windows SDK)
2	Set if right mouse button is down (defined as MK_RBUTTON inside the Windows SDK)
4	Set if keyboard's SHIFT key is down (defined as MK_SHIFT inside the Windows SDK)
8	Set if keyboard's CTRL key is down (defined as MK_CONTROL inside the Windows SDK)
16 (hex 10)	Set if middle mouse button is down (defined as MK_MBUTTON inside the Windows SDK)

xPos

Horizontal position, expressed in pixels respect to the waveform's client area, where the mouse generated the notification

yPos

Vertical position, expressed in pixels respect to the waveform's client area, where the mouse generated the notification

nPressPosInPix

Number representing the position expressed in pixels where the mouse button was pressed. If the mouse action should have been performed outside of the waveform's area, this parameter would be set to -1.

It's important to note that this parameter doesn't represent the horizontal position on the waveform's visible area (for this you can refer to the xPos parameter) but to the horizontal position in pixels calculated respect to the bitmap representation of the total waveform's width in pixels at the current horizontal zoom factor.

nPressPosInMs

Number representing the position expressed in milliseconds where the mouse button was pressed. If the mouse action should have been performed outside of the waveform's area, this parameter would be set to -1.