# aanwijzerLosgelaten

[Ingebouwde functies](LEESMIJ.md)

Canonieke ID: `events.pointerReleased`. English: `pointerReleased`.

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 uit bij echt primair loslaten door dezelfde aanwijzer die binnen het beeld werd geclaimd. Loslaten mag buiten het beeld liggen: coördinaten zijn naar beneden afgeronde logische posities als 32-bits getallen met teken, zonder randbegrenzing. Annuleren of verloren capture verzint geen loslaat. Binnen het beeld komt deze gebeurtenis vóór een klik. Alleen deze handler registreren is voldoende; de andere aanwijzerhandlers zijn optioneel. De host moet de vereiste blijvende aanwijzerstroom ondersteunen.

## Aanroepvorm

```text
wanneer aanwijzerLosgelaten("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 aanwijzerLosgelaten("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)