Excel Add-in Development in C/C++: Applications in ... - F9

Accessing Excel Functionality Using the C API 281Note: The trapped keyboard event is based on the physical keys pressed, as mapped forthe geographical settings, rather than the character interpreted by the operating system.For this reason, pressing the Caps Lock key is itself a keyboard event. Pressing, say, theA key will always return lowercase a regardless of the Caps Lock state. If you want totrap Ctrl-a you would pass the string “^a”. If you pass the string “^A” you will need topress Ctrl-Shift-a on the keyboard even if Caps Lock is set; in other words the strings“^A” and“^+a” are equivalent.8.14.5 Trapping a recalculation event: xlcOnRecalcOverview:Enumeration value:Callable from:Arguments:Instructs Excel to call a specified command whenever Excel isabout to recalculate the specified worksheet, provided that thisrecalculation is a result of the user pressing {F9} or theequivalent via Excel’s built-in dialogs, or as the result of achange in worksheet data. The command is not called where therecalculation is prompted by another command or macro. Unlikeother event traps, there can only be one trap for this event.32995 (x80e3)Commands only.1: SheetRef : A string of the format [Book1.xls]Sheet1specifying the sheet to which the event applies.2: Command: The name of the command to be run as passed toExcel in the 4th argument to xlfRegister or the name ofsome other command macro or VB function.If SheetRef is missing, the command is run whenever this event occurs on any sheet.If Command is missing, the function clears the command associated with this combinationof event and sheet.8.14.6 Trapping a window selection event: xlcOnWindowOverview:Enumeration value:Callable from:Arguments:Instructs Excel to call a specified command whenever Excel isabout to switch to the specified worksheet. The command is notcalled where the switch is the result of actions of anothercommand or macro or as a result of a DDE instruction.32906 (x808a)Commands only.1: WindowRef : A string of the format [Book1.xls]Sheet1[:n]specifying the window to which the event applies.2: Command: The name of the command to be run as passed toExcel in the 4th argument to xlfRegister or the name ofsome other command macro or VB function.