> For the complete documentation index, see [llms.txt](https://cmonkeys.gitbook.io/cinput-reference-manual/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cmonkeys.gitbook.io/cinput-reference-manual/script-reference/methods/getkeydown.md).

# GetKeyDown

*bool* **GetKeyDown**(*string* **description**)\
*bool* **GetKeyDown**(*int* **descriptionHash**)

## Parameters

**description**: The name of the key, as defined in [`SetKey()`](/cinput-reference-manual/script-reference/methods/setkey.md).\
**descriptionHash**: The hashcode of the name of the key, as defined in [`SetKey()`](/cinput-reference-manual/script-reference/methods/setkey.md).

## Returns

**bool**: Returns `true` only once each time the key is first pressed down.

## Description

Use this to determine if a key has been pressed during this frame. `GetKeyDown()` returns `true` *only once* when the key is first pressed down.

The use of [`GetKey()`](/cinput-reference-manual/script-reference/methods/getkey.md) is recommended if you want to trigger an event repeatedly while the key is being held down, e.g., for continuous movement.

## Example
