aanwijzerGeklikt

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

wanneer aanwijzerGeklikt("primary"):

Argumenten

Parameter	Type	Vereiste
`knop`	Text literal	Exact de directe literal “primary”; geen variabele of vertaald woord.

Terugkeerwaarde

Gebeurtenisbeschrijving.

Voorbeeld

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