OpenTTD Source  20241108-master-g80f628063a
hotkeys.cpp File Reference

Implementation of hotkey related functions. More...

#include "stdafx.h"
#include "openttd.h"
#include "hotkeys.h"
#include "ini_type.h"
#include "string_func.h"
#include "window_gui.h"
#include "safeguards.h"

Go to the source code of this file.

Data Structures

struct  KeycodeNames
 String representation of a keycode. More...
 

Functions

static uint16_t ParseCode (const char *start, const char *end)
 Try to parse a single part of a keycode. More...
 
static uint16_t ParseKeycode (const char *start, const char *end)
 Parse a string representation of a keycode. More...
 
static void ParseHotkeys (Hotkey &hotkey, const char *value)
 Parse a string to the keycodes it represents. More...
 
static std::string KeycodeToString (uint16_t keycode)
 Convert a hotkey to it's string representation so it can be written to the config file. More...
 
std::string SaveKeycodes (const Hotkey &hotkey)
 Convert all keycodes attached to a hotkey to a single string. More...
 
static void SaveLoadHotkeys (bool save)
 
void LoadHotkeysFromConfig ()
 Load the hotkeys from the config file.
 
void SaveHotkeysToConfig ()
 Save the hotkeys to the config file.
 
void HandleGlobalHotkeys ([[maybe_unused]] char32_t key, uint16_t keycode)
 

Variables

std::string _hotkeys_file
 
static std::vector< HotkeyList * > * _hotkey_lists = nullptr
 List of all HotkeyLists. More...
 
static const std::initializer_list< KeycodeNames_keycode_to_name
 Array of non-standard keycodes that can be used in the hotkeys config file.
 

Detailed Description

Implementation of hotkey related functions.

Definition in file hotkeys.cpp.

Function Documentation

◆ KeycodeToString()

static std::string KeycodeToString ( uint16_t  keycode)
static

Convert a hotkey to it's string representation so it can be written to the config file.

Separate parts of the keycode (like "CTRL" and "F1" are split by a '+'.

Parameters
keycodeThe keycode to convert to a string.
Returns
A string representation of this keycode.

Definition at line 171 of file hotkeys.cpp.

Referenced by SaveKeycodes().

◆ ParseCode()

static uint16_t ParseCode ( const char *  start,
const char *  end 
)
static

Try to parse a single part of a keycode.

Parameters
startStart of the string to parse.
endEnd of the string to parse.
Returns
A keycode if a match is found or 0.

Definition at line 97 of file hotkeys.cpp.

◆ ParseHotkeys()

static void ParseHotkeys ( Hotkey hotkey,
const char *  value 
)
static

Parse a string to the keycodes it represents.

Parameters
hotkeyThe hotkey object to add the keycodes to
valueThe string to parse

Definition at line 152 of file hotkeys.cpp.

Referenced by HotkeyList::Load().

◆ ParseKeycode()

static uint16_t ParseKeycode ( const char *  start,
const char *  end 
)
static

Parse a string representation of a keycode.

Parameters
startStart of the input.
endEnd of the input.
Returns
A valid keycode or 0.

Definition at line 122 of file hotkeys.cpp.

◆ SaveKeycodes()

std::string SaveKeycodes ( const Hotkey hotkey)

Convert all keycodes attached to a hotkey to a single string.

If multiple keycodes are attached to the hotkey they are split by a comma.

Parameters
hotkeyThe keycodes of this hotkey need to be converted to a string.
Returns
A string representation of all keycodes.

Definition at line 213 of file hotkeys.cpp.

References KeycodeToString().

Referenced by HotkeyList::Save().

Variable Documentation

◆ _hotkey_lists

std::vector<HotkeyList*>* _hotkey_lists = nullptr
static

List of all HotkeyLists.

This is a pointer to ensure initialisation order with the various static HotkeyList instances.

Definition at line 25 of file hotkeys.cpp.