OnKeystrokeMessageForAddon event

Microsoft Visio Developer Reference

OnKeystrokeMessageForAddon event

   Example   

Occurs when Microsoft Visio receives a keystroke message from Microsoft Windows that is targeted at an add-on window or child of an add-on window.

Version added

2002

Syntax

Private Sub object_OnKeystrokeMessageForAddon(ByVal MSG As IVMSGWrap)As Boolean

object

The WithEvents object that receives the event.

return value

True to indicate that the message was handled by the add-on. otherwise, False.

Remarks

The OnKeystrokeMessageForAddon event enables add-ons to intercept and process accelerator and keystroke messages directed at their own add-on windows and child windows of their add-on windows. Only add-on windows created using the Add method will source this event.

For this event to fire, the add-on window or one of its child windows must have keystroke focus and the Visio message loop must receive the keystroke message. It does not fire if the message loop associated with an add-on is handling messages instead of Visio.

Visio fires the OnKeystrokeMessageForAddon event when it receives messages in the following range:

WM_KEYDOWN

0x0100

WM_KEYUP

0x0101

WM_CHAR

0x0102

WM_DEADCHAR

0x0103

WM_SYSKEYDOWN

0x0104

WM_SYSKEYUP

0x0105

WM_SYSCHAR

0x0106

WM_SYSDEADCHAR

0x0107

The MSGWrap object, passed to the event handler when the OnKeystrokeMessageForAddon event fires, wraps the Windows MSG structure, which contains message data. See the MSGWrap object for more information, or refer to your Windows documentation.

If you're using Microsoft Visual Basic or Visual Basic for Applications, the syntax in this topic describes a common, efficient way to handle events.

If you want to create your own Event objects, use the Add or AddAdvise method. To create an Event object that runs an add-on, use the Add method as it applies to the EventList collection. To create an Event object that receives notification, use the AddAdvise method. To find an event code for the event you want to create, see Event codes.