# toetsGedrukt

[Ingebouwde functies](LEESMIJ.md)

Canonieke ID: `events.keyPressed`. English: `keyPressed`.

Voert uit bij de overgang van los naar ingedrukt. Toetsherhaling van het besturingssysteem maakt geen extra aanroep vóór loslaten. De host moet toetsgebeurtenissen aanbieden; het programma blijft actief zolang deze scripts zijn geregistreerd. Toetsstatus opvragen geeft juist de huidige toestand: gebruik toetsIngedrukt voor voortdurende beweging en deze gebeurtenis voor losse acties.

## Aanroepvorm

```text
wanneer toetsGedrukt("toets"):
```

## Argumenten

| Parameter | Type | Vereiste |
|---|---|---|
| `toets` | Text literal | Directe niet-lege toetsnaam, bijvoorbeeld "space", "left" of "a". |

## Terugkeerwaarde

Gebeurtenisbeschrijving.

## Voorbeeld

```pliro
# taal: nl
wanneer gestart():
    wisScherm("white")
wanneer toetsGedrukt("space"):
    cirkel(320, 180, 30, "blue")
wanneer toetsGedrukt("escape"):
    sluitApp()
```

Gebruik een grafische [IDE](../begrippen/ontwikkelomgeving.md)/browser/native host. Spatie tekent een cirkel; Escape sluit af als de host die toets aanbiedt.

## Aandachtspunten en veelgemaakte fouten

Gebruik de functienaam van je brontaal. De [canonieke ID](../begrippen/canonieke-identiteit.md) is een gezamenlijk documentatielabel; die ID typ je niet als aanroep. Een eigen variabele of functie met dezelfde naam kan de ingebouwde functie verbergen. Geef de beschreven [argumenten](../begrippen/parameters-en-argumenten.md) en waardesoorten mee. Pliro meldt verschillen wanneer controle ze kan vinden, of wanneer de aanroep draait.

Een **gebeurtenisbeschrijving** kiest de gebeurtenis in een `wanneer`-kop op programmaniveau, buiten andere blokken (`E3201`–`E3203`). Een **uitleesfunctie** is een gewone functie die een waarde teruggeeft, zoals `aanwijzerX`; ook `zendBericht` is een gewone aanroep. Een **handler** is het blok dat reageert. Toets- en aanwijzerhandlers houden een uitvoering gereed voor volgende invoer en vereisen [hostondersteuning](../gidsen/uitvoeromgevingen.md) (`E4019`). Aanwijzeruitleesfuncties hebben de huidige aanwijzergebeurtenis nodig (`E4020`). De hele uitvoering deelt één [grens voor gebeurteniswerk](../gidsen/uitvoergrenzen.md) (`E4018`). De gewone voorbereiding moet klaar zijn vóór handlers beurten krijgen. Zie [gebeurtenisregels](../gidsen/gebeurtenissen.md) en [aanwijzerposities](../gidsen/aanwijsapparaten.md).

## Gerelateerde lemma’s

[gestart](gestart.md) · [na](na.md) · [berichtOntvangen](berichtOntvangen.md) · [aanwijzerGedrukt](aanwijzerGedrukt.md) · [aanwijzerLosgelaten](aanwijzerLosgelaten.md) · [Programmeergidsen](../gidsen/gebeurtenissen.md) · [Hostondersteuning](../gidsen/uitvoeromgevingen.md) · [Aanroepen en argumenten](../syntaxis/aanroepen.md)