# aanwijzerGedrukt

[Ingebouwde functies](LEESMIJ.md)

Canonieke ID: `events.pointerPressed`. English: `pointerPressed`.

Een **aanwijzer** kan een muis, aanraking of pen zijn in een geschikte host. **Primair** kiest de hoofdaanwijzeractie; een muis gebruikt gewoonlijk zijn hoofdknop. Een **handler** is het blok onder `wanneer`. De host **claimt** een aanwijzer door die ene aanwijzer tijdens drukken en loslaten te volgen. [De aanwijzergids](../gidsen/aanwijsapparaten.md) legt momentopnamen, capture, coördinaten met teken, afronden en begrenzen uit met voorbeelden.

Voert eenmaal uit wanneer een primaire druk binnen het logische beeld een aanwijzer claimt. Coördinaten verwijzen naar de begrensde drukpositie. Latere annulering neemt de geaccepteerde druk niet terug. Extra of dubbele drukken en niet-primaire knoppen maken geen nieuwe druk. Alleen deze handler registreren is voldoende; de andere aanwijzerhandlers zijn optioneel. De host moet de vereiste blijvende aanwijzerstroom ondersteunen.

## Aanroepvorm

```text
wanneer aanwijzerGedrukt("primary"):
```

## Argumenten

| Parameter | Type | Vereiste |
|---|---|---|
| `knop` | Text literal | Exact de directe literal "primary"; geen variabele of vertaald woord. |

## Terugkeerwaarde

Gebeurtenisbeschrijving.

## Voorbeeld

```pliro
# taal: nl
wanneer gestart():
    wisScherm("white")
wanneer aanwijzerGedrukt("primary"):
    zeg aanwijzerX(), aanwijzerY()
```

Gebruik een grafische host en voer het beschreven gebaar uit; het programma toont de gebeurteniscoördinaten. Stop beëindigt het blijvende programma.

## 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) · [toetsGedrukt](toetsGedrukt.md) · [aanwijzerLosgelaten](aanwijzerLosgelaten.md) · [Programmeergidsen](../gidsen/gebeurtenissen.md) · [Hostondersteuning](../gidsen/uitvoeromgevingen.md) · [Aanroepen en argumenten](../syntaxis/aanroepen.md)