aanwijzerY

Canonieke ID: events.pointerY. English: pointerY.

Geeft de verticale y-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 om te begrijpen waarom een loslaatpositie negatief kan zijn.

Aanroepvorm

aanwijzerY()

Argumenten

Deze aanroep heeft geen argumenten. Schrijf altijd de haakjes.

Terugkeerwaarde

Number.

Voorbeeld

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

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 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 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 (E4019). Aanwijzeruitleesfuncties hebben de huidige aanwijzergebeurtenis nodig (E4020). De hele uitvoering deelt één grens voor gebeurteniswerk (E4018). De gewone voorbereiding moet klaar zijn vóór handlers beurten krijgen. Zie gebeurtenisregels en aanwijzerposities.

Gerelateerde lemma’s

gestart · na · berichtOntvangen · toetsGedrukt · aanwijzerGedrukt · Programmeergidsen · Hostondersteuning · Aanroepen en argumenten