Events > MidiKeyboardNotification event

Remarks

Occurs when one of the keys on the virtual piano keyboard, previously created through the MidiVirtualKeyboard.Create method, is pressed or released.

For further details about input events management see the How to synchronize the container application with the control tutorial.

For further details about the use of the virtual MIDI keyboard see the MidiVirtualKeyboard object section and the How to manage the virtual MIDI piano keyboard tutorial.

Syntax

[Visual Basic]

MidiKeyboardNotification (

hWndKeyboard as OLE_HANDLE,

nNote as Integer,

bPressed as enumBoolean,

bSimulated as enumBoolean

)

[C++]

void MidiKeyboardNotification (

OLE_HANDLE hWndKeyboard,

short nNote,

short bPressed,

short bSimulated

);

Parameter

Description

hWndKeyboard

Handle of the virtual keyboard as returned by the call to the MidiVirtualKeyboard.Create method

nNote

Note played through pressure of one of the keys of the virtual piano keyboard. Can be a key number from 0 to 127; 60 means middle C

bPressed

Boolean flag that specifies if the key was pressed or released.

Supported values are the following:

Mnemonic constant	Value	Meaning
BOOL_FALSE	0	The key was released
BOOL_TRUE	1	The key was pressed

bSimulated

Boolean flag that specifies if the key pressure is simulated. When the key pressure is simulated, the key appears pressed on the piano keyboard but no real event is generated on the MIDI stream in playback, allowing to display a note played through an external physical MIDI keyboard attached to one of the MIDI input channels.

Supported values are the following:

Mnemonic constant	Value	Meaning
BOOL_FALSE	0	The call to this method will play the requested note on the MIDI stream in playback
BOOL_TRUE	1	The call to this method will not play the requested note on the MIDI stream in playback but will display the corresponding key as pressed on the piano keyboard.