# aanwijzerX

[Ingebouwde functies](LEESMIJ.md)

Canonieke ID: `events.pointerX`. English: `pointerX`.

Geeft de **horizontale x-coördinaat**, een positie in de eigen eenheden van de scène, opgeslagen toen de huidige aanwijzergebeurtenis plaatsvond. Dit is een **momentopname**, niet de actuele aanwijzerpositie. De aanwijzer daarna bewegen verandert deze waarde niet.

Hetzelfde gebeurtenisblok kan deze positie nog lezen na wachten of een functieaanroep. Een afzonderlijk klaargezet blok, zoals een berichthandler, erft haar niet. Buiten een aanwijzergebeurtenisblok of zijn functieaanroepen krijg je `E4020`. Zie [druk-, loslaat- en klikposities](../gidsen/aanwijsapparaten.md) om te begrijpen waarom een loslaatpositie negatief kan zijn.

## Aanroepvorm

```text
aanwijzerX()
```

## Argumenten

Deze aanroep heeft geen argumenten. Schrijf altijd de haakjes.

## Terugkeerwaarde

`Number`.

## Voorbeeld

```pliro
# taal: nl
wanneer aanwijzerGeklikt("primary"):
    laat position = aanwijzerX()
    wacht(0.01)
    zeg position == aanwijzerX()
```

Iedere geaccepteerde klik toont `true`, ook als de aanwijzer tijdens het wachten beweegt.

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