Method HotkeyToText

source/script_gui.cpp:9561–9596

LPTSTR GuiType::HotkeyToText(WORD aHotkey, LPTSTR aBuf)
// Caller has ensured aBuf is large enough to hold any hotkey name.
// Returns aBuf.
{
	BYTE modifiers = HIBYTE(aHotkey); // In this case, both the VK and the modifiers are bytes, not words.
	LPTSTR cp = aBuf;
	if (modifiers & HOTKEYF_SHIFT)
		*cp++ = '+';
	if (modifiers & HOTKEYF_CONTROL)
		*cp++ = '^';
	if (modifiers & HOTKEYF_ALT)
		*cp++ = '!';
	BYTE vk = LOBYTE(aHotkey);

	if (modifiers & HOTKEYF_EXT) // Try to find the extended version of this VK if it has two versions.
	{
		// Fix for v1.0.37.03: A virtual key that has only one scan code should be resolved by VK
		// rather than SC.  Otherwise, Numlock will wind up being SC145 and NumpadDiv something similar.
		// If a hotkey control could capture AppsKey, PrintScreen, Ctrl-Break (VK_CANCEL), which it can't, this
		// would also apply to them.
		// Fix for v1.1.26.02: Check sc2 != 0, not sc1 != sc2, otherwise the fix described above doesn't work.
		sc_type sc2 = vk_to_sc(vk, true); // Secondary scan code.
		if (sc2) // Non-zero means this key has two scan codes.
		{
			sc_type sc1 = vk_to_sc(vk); // Primary scan code for this virtual key.
			sc_type sc = (sc2 & 0x100) ? sc2 : sc1;
			if (sc & 0x100)
			{
				SCtoKeyName(sc, cp, 100);
				return aBuf;
			}
		}
	}
	// Since above didn't return, use a simple lookup on VK, since it gives preference to non-extended keys.
	return VKtoKeyName(vk, cp, 100);
}