# aanwijzerGeklikt

[Ingebouwde functies](LEESMIJ.md)

Canonieke ID: `events.pointerClicked`. English: `pointerClicked`.

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 alleen uit na geaccepteerd primair indrukken en echt loslaten binnen het beeld door dezelfde aanwijzer. De opname bevat de begrensde loslaatpositie, niet de oorspronkelijke drukpositie. Buiten loslaten kan een loslaatgebeurtenis geven, maar nooit een klik. Een geannuleerd gebaar geeft geen klik. Alleen deze handler registreren is voldoende; de andere aanwijzerhandlers zijn optioneel. De host moet de vereiste blijvende aanwijzerstroom ondersteunen.

## Aanroepvorm

```text
wanneer aanwijzerGeklikt("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 aanwijzerGeklikt("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) · [aanwijzerGedrukt](aanwijzerGedrukt.md) · [Programmeergidsen](../gidsen/gebeurtenissen.md) · [Hostondersteuning](../gidsen/uitvoeromgevingen.md) · [Aanroepen en argumenten](../syntaxis/aanroepen.md)