KeyboardAPI

#include <VirtualC64.h>

class KeyboardAPI

Defined in VirtualC64.h:827

Keyboard Public API

Public Methods

Return	Name	Description
bool	isPressed const	Checks if a key is currently pressed.
void	press	Presses a key.
void	toggle	Toggles a key.
void	release	Releases a key.
void	releaseAll	Releases all currently pressed keys.
bool	isLocked const	Checks if a key is currently pressed.
void	lock	Locks a key.
void	unlock	Unlocks a key.
void	unlockAll	Unlocks all keys.
void	autoType	Uses the auto-typing daemon to type a string.
void	abortTyping	Aborts any active auto-typing activity.

---

isPressed

const

bool isPressed(C64Key key) const

Defined in VirtualC64.h:838

Checks if a key is currently pressed.

Parameters

Parameter	Type	Description
key	C64Key	The key to check.

---

press

void press(C64Key key, double delay = 0.0, double duration = 0.0)

Defined in VirtualC64.h:855

Presses a key.

If no delay is specified, the function will immediately modify the C64's keyboard matrix. Otherwise, it will ask the event scheduler to modify the matrix with the specified delay.

NOTE

If you wish to press multiple keys, make sure to let some time pass between two key presses. You need to give the C64 time to scan the keyboard matrix before another key can be pressed.

Parameters

Parameter	Type	Description
key	C64Key	The key to press.
delay	double	An optional delay in seconds.
duration	double	An optional time in seconds after which the key is released again. If 0, the key stays pressed until it is released explicitly.

---

toggle

void toggle(C64Key key, double delay = 0.0, double duration = 0.0)

Defined in VirtualC64.h:867

Toggles a key.

If no delay is specified, the function will immediately modify the C64's keyboard matrix. Otherwise, it will ask the event scheduler to modify the matrix with the specified delay.

Parameters

Parameter	Type	Description
key	C64Key	The key to press or release.
delay	double	An optional delay in seconds.
duration	double	An optional time in seconds after which the key is toggled back. If 0, the key is toggled only once.

---

release

void release(C64Key key, double delay = 0.0)

Defined in VirtualC64.h:877

Releases a key.

If no delay is specified, the function will immediately modify the C64's keyboard matrix. Otherwise, it will ask the event scheduler to modify the matrix with the specified delay.

Parameters

Parameter	Type	Description
key	C64Key	The key to release.
delay	double	An optional delay in seconds.

---

releaseAll

void releaseAll(double delay = 0.0)

Defined in VirtualC64.h:881

Releases all currently pressed keys.

---

isLocked

const

bool isLocked(C64Key key) const

Defined in VirtualC64.h:886

Checks if a key is currently pressed.

Parameters

Parameter	Type	Description
key	C64Key	The key to check.

---

lock

void lock(C64Key key, double delay = 0.0)

Defined in VirtualC64.h:897

Locks a key.

When a key is marked as locked, it won't be released when release() or releaseAll() is called.

Parameters

Parameter	Type	Description
key	C64Key	The key to lock.
delay	double	An optional delay in seconds.

---

unlock

void unlock(C64Key key, double delay = 0.0)

Defined in VirtualC64.h:907

Unlocks a key.

Removes the lock, putting the key back into it's normal state.

Parameters

Parameter	Type	Description
key	C64Key	The key to unlock.
delay	double	An optional delay in seconds.

---

unlockAll

void unlockAll(double delay = 0.0)

Defined in VirtualC64.h:915

Unlocks all keys.

Removes the lock for all keys, putting them back into their normal state.

Parameters

Parameter	Type	Description
delay	double	An optional delay in seconds.

---

autoType

void autoType(const string & text)

Defined in VirtualC64.h:920

Uses the auto-typing daemon to type a string.

Parameters

Parameter	Type	Description
text	const string &	The text to type.

---

abortTyping

void abortTyping()

Defined in VirtualC64.h:924

Aborts any active auto-typing activity.