# toetsIngedrukt

[Ingebouwde functies](LEESMIJ.md)

Canonieke ID: `input.keyDown`. English: `keyDown`.

Vraagt of een toets **op dit moment** wordt vastgehouden en geeft een Boolean: `waar` of `onwaar`. De actuele toestand steeds opnieuw opvragen heet **polling**. Het wacht niet op een nieuwe druk en maakt geen handler die naar volgende drukken luistert. Gebruik [toetsGedrukt](toetsGedrukt.md) voor een blok dat begint op het moment dat de toets wordt ingedrukt.

De host, de app die het programma uitvoert, levert de toetsstatus. De overdraagbare spelnamen zijn `"left"`, `"right"`, `"up"`, `"down"` en `"space"`. Native grafische hosts ondersteunen ook gebruikelijke bedieningstoetsen en gewone Latijnse letters en cijfers (ASCII). Een toets die de host niet aanbiedt, geldt als niet ingedrukt. Toetsnamen zijn tekstgegevens en blijven gelijk wanneer je de bronsyntaxis vertaalt.

## Aanroepvorm

```text
toetsIngedrukt(toets)
```

## Argumenten

| Parameter | Type | Vereiste |
|---|---|---|
| `toets` | Text | Niet-lege hosttoetsnaam; gegevenswaarden worden niet vertaald. |

## Terugkeerwaarde

`Boolean`.

## Voorbeeld

```pliro
# taal: nl
wanneer gestart():
    laat x = 320
    voor frame in herhaalLijst(50, geen):
        als toetsIngedrukt("left"):
            zet x = x - 2
        wisScherm("white")
        cirkel(x, 180, 15, "blue")
        wacht(0.04)
```

Ongeveer twee seconden lang beweegt de cirkel naar links wanneer Links wordt vastgehouden in een grafische host.

## 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.

De gekozen host bemiddelt invoer. Programma-antwoorden zijn maximaal 64 KiB geldige [UTF-8](../begrippen/utf-8.md); onbeschikbare invoer geeft E4010. Toetsnamen en optieteksten zijn gegevens en veranderen niet bij syntaxisconversie. Voltooide vragen zijn coöperatieve controlepunten.

## Gerelateerde lemma’s

[vraag](vraag.md) · [vraagGetal](vraagGetal.md) · [vraagJaNee](vraagJaNee.md) · [kies](kies.md) · [Programmeergidsen](../gidsen/invoer.md) · [Hostondersteuning](../gidsen/uitvoeromgevingen.md) · [Aanroepen en argumenten](../syntaxis/aanroepen.md)