aanwijzerGedrukt

Canonieke ID: events.pointerPressed. English: pointerPressed.

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 eenmaal uit wanneer een primaire druk binnen het logische beeld een aanwijzer claimt. Coördinaten verwijzen naar de begrensde drukpositie. Latere annulering neemt de geaccepteerde druk niet terug. Extra of dubbele drukken en niet-primaire knoppen maken geen nieuwe druk. Alleen deze handler registreren is voldoende; de andere aanwijzerhandlers zijn optioneel. De host moet de vereiste blijvende aanwijzerstroom ondersteunen.

Aanroepvorm

wanneer aanwijzerGedrukt("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 aanwijzerGedrukt("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 · aanwijzerLosgelaten · Programmeergidsen · Hostondersteuning · Aanroepen en argumenten