Events > MidiKeyboardNotification event

Remarks

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

For further details about the use of MIDI protocol see the MIDIMan class section and the How to deal with MIDI protocol tutorial.

For further details about synchronization through Events see the How to synchronize the container application through events tutorial.

Syntax

[Visual Basic]

Public Event MidiKeyboardNotification As MidiKeyboardNotificationEventHandler

[C#]

public event MidiKeyboardNotificationEventHandler MidiKeyboardNotification;

[C++]

public: __event MidiKeyboardNotificationEventHandler MidiKeyboardNotification;

Event Data

The event handler receives an argument of type MidiKeyboardNotificationEventArgs having the following parameters:

Parameter

Description

hWndKeyboard

Handle of the virtual keyboard as returned by the call to the MIDI.KeyboardCreate 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:

Value	Meaning
0	The key was released
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:

Value	Meaning
0	The call to this method will play the requested note on the MIDI stream in playback
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.