`Class.GuiButton` is een abstracte klasse die erft van `Class.GuiObject`.
Het is de basis klasse voor de interactieve, klikbare `Class.ImageButton` en
`Class.TextButton` objecten. Deze klasse definieert ook verschillende eigenschappen voor
interactief gedrag, namelijk `Class.GuiButton.AutoButtonColor|AutoButtonColor`
en `Class.GuiButton.Modal|Modal`.

Het belangrijkste evenement van een `Class.GuiButton` is
`Class.GuiButton.Activated|Activated`, een **multi-platform evenement** dat wordt geactiveerd
wanneer de knop wordt geactiveerd. Bij gebruik van een muis betekent dit het klikken op de
knop en het loslaten terwijl de cursor nog boven het UI-object is. Voor aanraking geldt hetzelfde,
maar met een aanraking in plaats van een knopdruk. Ten slotte, voor gamepads,
wordt `Class.GuiButton.Activated|Activated` geactiveerd als een `Class.GuiButton` is geselecteerd
wanneer de **A**-knop wordt ingedrukt en losgelaten. Kortom, dit evenement is zeer
nuttig voor multi-platform gebruikersinterface-programmering, omdat het een mooie
generieke interface biedt voor een enkele gebruikersinvoer.


Wordt geactiveerd wanneer een linkse klik indruk-en-los wordt gedetecteerd op desktop, een aanraking
wordt gedetecteerd op mobiel, of **A**/kruis wordt geactiveerd in UI-navigatiemodus op console. De eerste keer dat deze methode wordt aangeroepen,
zal `clickCount` beginnen bij `0`.

Aangezien dit evenement niet op de server wordt geactiveerd, mag het alleen worden gebruikt in een
`Class.LocalScript`, of in een `Class.Script` met
`Class.Script.RunContext|RunContext` van `Enum.RunContext.Client`.


GuiButton.Activated

inputObject

Een `Class.InputObject` dat de gebruikersinvoer vertegenwoordigt die de knop heeft geactiveerd.


clickCount

Het aantal opeenvolgende snelle activaties, beginnend bij 0 voor de
eerste activatie en toenemend met elke daaropvolgende activatie
binnen snelle opvolging van de vorige.


Wordt geactiveerd wanneer de knop wordt ingeschakeld.


Dit evenement wordt geactiveerd wanneer de muis van de gebruiker volledig op de
`Class.GuiButton` klikt.

Wat betreft klikken, de muis moet binnen de grenzen van de
`Class.GuiButton` zijn en de muisknop moet naar beneden worden gedrukt en weer omhoog
voordat dit evenement wordt geactiveerd. Als de muis de grenzen van de
`Class.GuiButton` verlaat en wordt losgelaten, wordt het evenement niet geactiveerd. Als je deze beperking wilt vermijden,
kun je `Class.GuiButton.MouseButton1Down|MouseButton1Down` en
`Class.GuiButton.MouseButton1Up|MouseButton1Up` gebruiken; deze evenementen zijn vergelijkbaar
maar worden geactiveerd telkens wanneer de gebruiker hun linkermuisknop indrukt of
oplaat, respectievelijk.


GuiButton.MouseButton1Click

Wordt geactiveerd wanneer de muis van de gebruiker volledig op de `Class.GuiButton` klikt.


Dit evenement wordt geactiveerd wanneer de gebruiker hun linkermuisknop op de
`Class.GuiButton` indrukt.

Voor een evenement dat vereist dat de gebruiker **en** hun linkermuisknop
op een `Class.GuiButton` indrukt en loslaat om het evenement te activeren, overweeg dan om
`Class.GuiButton.MouseButton1Click|MouseButton1Click` te gebruiken.


GuiButton.MouseButton1Down

De **X** schermcoördinaat van de muis in pixels.


De **Y** schermcoördinaat van de muis in pixels.


Wordt geactiveerd wanneer de gebruiker hun linkermuisknop op de
`Class.GuiButton` indrukt.


Dit evenement wordt geactiveerd wanneer de gebruiker hun linkermuisknop loslaat van de
`Class.GuiButton`.

Voor een evenement dat vereist dat de gebruiker **en** hun linkermuisknop
op een `Class.GuiButton` indrukt en loslaat om het evenement te activeren, overweeg dan om
`Class.GuiButton.MouseButton1Click|MouseButton1Click` te gebruiken.


GuiButton.MouseButton1Up

Wordt geactiveerd wanneer de gebruiker hun linkermuisknop loslaat van de
`Class.GuiButton`.


Dit evenement wordt geactiveerd wanneer de muis van de gebruiker volledig met de rechtermuisknop op de
`Class.GuiButton` klikt.

Wat betreft klikken, de muis moet binnen de grenzen van de
`Class.GuiButton` zijn en de muisknop moet naar beneden worden gedrukt en weer omhoog
voordat dit evenement wordt geactiveerd. Als de muis de grenzen van de
`Class.GuiButton` verlaat en wordt losgelaten, wordt het evenement niet geactiveerd. Als je deze beperking wilt vermijden,
kun je `Class.GuiButton.MouseButton2Down|MouseButton2Down` en
`Class.GuiButton.MouseButton2Up|MouseButton2Up` gebruiken; deze evenementen zijn vergelijkbaar
maar worden geactiveerd telkens wanneer de gebruiker hun rechtermuisknop indrukt of
oplaat, respectievelijk.


GuiButton.MouseButton2Click

Wordt geactiveerd wanneer de muis van de gebruiker volledig met de rechtermuisknop op de `Class.GuiButton` klikt.


Dit evenement wordt geactiveerd wanneer de gebruiker hun rechtermuisknop op de
`Class.GuiButton` indrukt.

Voor een evenement dat vereist dat de gebruiker **en** hun rechtermuisknop
op een `Class.GuiButton` indrukt en loslaat om het evenement te activeren, overweeg dan om
`Class.GuiButton.MouseButton2Click|MouseButton2Click` te gebruiken.


GuiButton.MouseButton2Down

Wordt geactiveerd wanneer de gebruiker hun rechtermuisknop op de
`Class.GuiButton` indrukt.


Dit evenement wordt geactiveerd wanneer de gebruiker hun rechtermuisknop loslaat van de
`Class.GuiButton`.

Voor een evenement dat vereist dat de gebruiker **en** hun rechtermuisknop
op een `Class.GuiButton` indrukt en loslaat om het evenement te activeren, overweeg dan om
`Class.GuiButton.MouseButton2Click|MouseButton2Click` te gebruiken.


GuiButton.MouseButton2Up

Wordt geactiveerd wanneer de gebruiker hun rechtermuisknop loslaat van de
`Class.GuiButton`.


Wordt geactiveerd wanneer een rechtermuisklik indruk-en-los wordt gedetecteerd van een muis, een lange
druk wordt gedetecteerd op een aanraakinvoer, `R3` wordt gedetecteerd van een gamepad, of
<kbd>Alt</kbd><kbd>Enter</kbd> wordt gedetecteerd in UI-navigatiemodus met behulp van
het toetsenbord.


GuiButton.SecondaryActivated

Het invoerobject dat de alternatieve activeringsactie vertegenwoordigt.


Wordt geactiveerd wanneer de "secundaire" invoer van de knop wordt geactiveerd.


GuiButton

Deze eigenschap bepaalt of de knop automatisch van kleur verandert
wanneer de `Class.Mouse` van de gebruiker eroverheen beweegt of erop klikt. Als `true`, de
knop verandert automatisch van kleur wanneer de muis eroverheen beweegt of
erop klikt. Als `false`, verandert de knop niet.

Als je wilt aanpassen hoe een knop verandert wanneer de muis van de gebruiker
eroverheen beweegt of erop klikt, overweeg dan om een `Class.ImageButton` te gebruiken en
verander de elementen `Class.ImageButton.HoverImage|HoverImage` en
`Class.ImageButton.PressedImage|PressedImage`.

Houd er rekening mee dat deze eigenschap geen effect heeft op een
`Class.ImageButton` als de `Class.ImageButton.Image|Image` eigenschap is ingesteld
op een afbeelding. Bovendien heeft deze eigenschap geen effect op een
`Class.ImageButton` bij muishover wanneer de
`Class.ImageButton.HoverImage|HoverImage` niet `nil` is, noch bij muisklik
als de `Class.ImageButton.PressedImage|PressedImage` niet `nil` is.


GuiButton.AutoButtonColor

Bepaalt of de knop automatisch van kleur verandert wanneer de muis
eroverheen beweegt of erop klikt.


Een `Class.HapticEffect` die de engine afspeelt de eerste keer dat de pointer
over de knop beweegt, wanneer de knop overgaat van zijn inactieve staat naar
zijn hoverstaat. Wijs een `Class.HapticEffect` toe om hoverfeedback te geven (bijvoorbeeld,
een lichteffect op gamepad of mobiel); laat het niet ingesteld voor geen hover
haptics.

Het effect wordt afgespeeld via de standaard `Class.HapticService` mixer, dus
of de speler daadwerkelijk vibratie voelt, hangt af van hun apparaat en
haptische instellingen. Deze eigenschap heeft standaard de waarde `nil` (geen effect).


GuiButton.HoverHapticEffect

Een `Class.HapticEffect` instantie die wordt afgespeeld wanneer de `Class.GuiButton`
wordt gehoverd.


Als `true` terwijl het GUI-element zichtbaar is, zal de muis niet worden vergrendeld
tenzij de rechtermuisknop is ingedrukt.


GuiButton.Modal

Een `Class.HapticEffect` die de engine afspeelt wanneer de knop in zijn
ingedrukte staat komt. Wijs een `Class.HapticEffect` toe om druk- of klikfeedback te geven;
laat het niet ingesteld voor geen druk haptics.

Het effect wordt afgespeeld via de standaard `Class.HapticService` mixer, dus
of de speler daadwerkelijk vibratie voelt, hangt af van hun apparaat en
haptische instellingen. Deze eigenschap heeft standaard de waarde `nil` (geen effect).


GuiButton.PressHapticEffect

Een `Class.HapticEffect` instantie die wordt afgespeeld wanneer de `Class.GuiButton`
wordt ingedrukt.


Wanneer ingesteld op `true`, wordt de knop weergegeven in een gemarkeerde "geselecteerde" staat
in plaats van zijn normale inactieve uiterlijk. Deze eigenschap heeft standaard de waarde `false`,
en de engine verandert het nooit automatisch; stel het zelf in om een
knop als geselecteerd te markeren.

`Selected` heeft alleen een visueel effect op de legacy `Enum.ButtonStyle`
presets (de `Roblox*` stijlen) met
`Class.GuiButton.AutoButtonColor|AutoButtonColor` ingeschakeld, waar het de
uitgelichte afbeelding van de knop verwisselt. Het heeft geen effect onder de standaard
`Class.GuiButton.Style|Style` van `Custom`. Het is niet gerelateerd aan gamepad en
controller UI-navigatie; het momenteel gefocuste element wordt apart bijgehouden
door `Class.GuiService.SelectedObject|SelectedObject`.


GuiButton.Selected

Een boolean eigenschap die aangeeft of het object is geselecteerd.


Stelt het algemene uiterlijk van de knop in vanuit een vaste set van
`Enum.ButtonStyle` presets. De standaardwaarde is `Custom`, wat geen ingebouwde styling toepast
en je volledige controle geeft over het uiterlijk van de knop via eigenschappen zoals
`Class.GuiObject.BackgroundColor3|BackgroundColor3` en, voor een
`Class.ImageButton`, zijn afbeeldingen.

Een legacy methode om een vaste set van Roblox-thema knopstijlen toe te passen.
De resterende presets (`RobloxButton`, `RobloxButtonDefault`,
`RobloxRoundButton`, `RobloxRoundDefaultButton`, en
`RobloxRoundDropdownButton`) renderen Roblox-thema knopkunst. Nieuwe
interfaces zouden `Custom` moeten behouden en de knop direct stylen. Deze
eigenschap heeft standaard de waarde `Enum.ButtonStyle.Custom`.


GuiButton.Style

Stelt de stijl van de `Class.GuiButton` in op basis van een lijst van vooraf bepaalde
stijlen.


Een abstracte klasse voor interactieve 2D-gebruikersinterface-elementen.


`Class.GuiObject` is een abstracte klasse (net als `Class.BasePart`) voor een 2D
gebruikersinterface-object. Het definieert alle eigenschappen die verband houden met de weergave
van een grafisch gebruikersinterface (GUI) object zoals `Class.GuiObject.Size|Size`
en `Class.GuiObject.Position|Position`. Het heeft ook enkele nuttige alleen-lezen
eigenschappen zoals `Class.GuiObject.AbsolutePosition|AbsolutePosition`,
`Class.GuiObject.AbsoluteSize|AbsoluteSize`, en
`Class.GuiObject.AbsoluteRotation|AbsoluteRotation`.

Om de lay-out van GUI-objecten op speciale manieren te manipuleren, kun je een lay-out
structuur gebruiken zoals [list/flex](/ui/list-flex-layouts) of
[grid](/ui/grid-table-layouts), en je kunt ze stylen buiten hun
kern eigenschappen via
[appearance modifiers](/ui/appearance-modifiers).

Hoewel het mogelijk is om muisklikgebeurtenissen op elk GUI-object te detecteren met
`Class.GuiObject.InputBegan|InputBegan` en
`Class.GuiObject.InputEnded|InputEnded`, hebben alleen `Class.ImageButton` en
`Class.TextButton` handige speciale gebeurtenissen zoals
`Class.TextButton.Activated|Activated` om klikken/drukken te detecteren.


Het onderstaande voorbeeld gaat ervan uit dat het binnen een GuiObject zoals een `TextButton` is, en
dat de `Class.GuiObject.Draggable` eigenschap is ingesteld op true. Het zal de UDim2 afdrukken van waar de speler begon met het slepen van het object.


Deze gebeurtenis wordt geactiveerd wanneer een speler begint met het verslepen van het object.

Zie ook `Class.GuiObject.DragStopped`.


GuiObject.DragBegin

initialPosition

Een `Datatype.UDim2` waarde van de positie van de `Class.GuiObject`
voordat enige sleepbewerking begon.


Wordt geactiveerd wanneer een speler begint met het verslepen van het object.


Het onderstaande voorbeeld gaat ervan uit dat het binnen een GuiObject zoals een `TextButton` is, en
dat de `Class.GuiObject.Draggable` eigenschap is ingesteld op true. Het zal de X en Y printen van waar de speler stopte met het slepen van de GUI. Bijvoorbeeld, als de
speler zou stoppen met het slepen van het object op 189, 180, zou het onderstaande printen: De
speler stopte met het slepen van de GuiObject op (189, 180)


Deze gebeurtenis wordt geactiveerd wanneer een speler stopt met het verslepen van het object.

Zie ook `Class.GuiObject.DragBegin`.


GuiObject.DragStopped

De muis **X** schermlocatie in pixels, relatief aan de linkerbovenhoek
van het scherm.


De muis **Y** schermlocatie in pixels, relatief aan de linkerbovenhoek
van het scherm.


Wordt geactiveerd wanneer een speler stopt met het verslepen van het object.


Het volgende voorbeeld demonstreert een van de vele gebruiksvoorbeelden van het omgaan met gebruikersinvoer
van InputBegan, afhankelijk van het type.

Om ervoor te zorgen dat dit werkt zoals verwacht, moet het worden geplaatst in een `LocalScript`
en een kind zijn van _gui_.


Deze gebeurtenis wordt geactiveerd wanneer een gebruiker begint met interactie met de `Class.GuiObject`
via een Human-Computer Interface-apparaat (Muisklik, aanraken,
toetsenbordtoets, enz.).

De `Class.UserInputService` heeft een vergelijkbare gebeurtenis die niet
beperkt is tot een specifiek UI-element: `Class.UserInputService.InputBegan`.

Deze gebeurtenis wordt altijd geactiveerd ongeacht de spelstatus.

Zie ook `Class.GuiObject.InputEnded` en `Class.GuiObject.InputChanged`.


GuiObject.InputBegan

input

Een `Class.InputObject`, dat nuttige gegevens bevat voor het opvragen van gebruikersinvoer
zoals het `Enum.UserInputType|type invoer`,
`Enum.UserInputState|status van invoer`, en
`Class.InputObject.Position|schermcoördinaten van de invoer`.


Wordt geactiveerd wanneer een gebruiker begint met interactie via een Human-Computer Interface-apparaat
(Muisklik, aanraken, toetsenbordtoets, enz.).


Het volgende voorbeeld demonstreert een van de vele gebruiksvoorbeelden van het omgaan met gebruikersinvoer
van InputChanged, afhankelijk van het type.

Om ervoor te zorgen dat dit naar verwachting werkt, moet het worden geplaatst in een `LocalScript`
en een kind zijn van _gui_.


Deze gebeurtenis wordt geactiveerd wanneer een gebruiker verandert hoe ze interactie hebben via een
Human-Computer Interface-apparaat (Muisklik, aanraken, toetsenbordtoets, enz.).

De `Class.UserInputService` heeft een vergelijkbare gebeurtenis die niet
beperkt is tot een specifiek UI-element:
`Class.UserInputService.InputChanged`.

Deze gebeurtenis wordt altijd geactiveerd ongeacht de spelstatus.

Zie ook `Class.GuiObject.InputBegan` en `Class.GuiObject.InputEnded`.


GuiObject.InputChanged

Wordt geactiveerd wanneer een gebruiker verandert hoe ze interactie hebben via een Human-Computer
Interface-apparaat (Muisklik, aanraken, toetsenbordtoets, enz.).


Het volgende voorbeeld demonstreert een van de vele gebruiksvoorbeelden van het omgaan met gebruikersinvoer
van InputEnded, afhankelijk van het type.

Om ervoor te zorgen dat dit werkt zoals verwacht, moet het worden geplaatst in een `LocalScript`
en een kind zijn van _gui_.


De InputEnded gebeurtenis wordt geactiveerd wanneer een gebruiker stopt met interactie via een
Human-Computer Interface-apparaat (Muisklik, aanraken, toetsenbordtoets, enz.).

De `Class.UserInputService` heeft een vergelijkbare gebeurtenis die niet
beperkt is tot een specifiek UI-element: `Class.UserInputService.InputEnded`.

Deze gebeurtenis wordt altijd geactiveerd ongeacht de spelstatus.

Zie ook `Class.GuiObject.InputBegan` en `Class.GuiObject.InputChanged`.


GuiObject.InputEnded

Een `Class.InputObject`, dat nuttige gegevens bevat voor het opvragen van gebruikersinvoer
zoals het `Enum.UserInputType`, `Enum.UserInputState`, en
`Class.InputObject.Position`.


Wordt geactiveerd wanneer een gebruiker stopt met interactie via een Human-Computer Interface-apparaat
(Muisklik, aanraken, toetsenbordtoets, enz.).


Het volgende voorbeeld drukt de muislocatie af, in pixels, wanneer deze het GUI-element binnenkomt.


De MouseEnter gebeurtenis wordt geactiveerd wanneer een gebruiker zijn muis in een
`Class.GuiObject` element beweegt.

Vertrouw alsjeblieft niet op de `x` en `y` argumenten die door deze gebeurtenis worden doorgegeven als een
waterdichte manier om te bepalen waar de muis van de gebruiker is wanneer deze een GUI binnenkomt. Deze
coördinaten kunnen variëren, zelfs wanneer de muis de GUI via dezelfde rand binnenkomt - vooral wanneer de muis snel het element binnenkomt. Dit
is te wijten aan het feit dat de coördinaten de positie van de muis aangeven wanneer
de gebeurtenis wordt geactiveerd in plaats van het exacte moment waarop de muis de GUI binnenkomt.

Deze gebeurtenis wordt geactiveerd, zelfs wanneer het GUI-element onder een ander
element wordt weergegeven.

Als je wilt bijhouden wanneer de muis van een gebruiker een GUI-element verlaat, kun je de `Class.GuiObject.MouseLeave` gebeurtenis gebruiken.

##### Zie Ook

- `Class.GuiObject.MouseLeave`
- `Class.GuiObject.MouseMoved`
- `Class.GuiObject.MouseWheelForward`
- `Class.GuiObject.MouseWheelBackward`


GuiObject.MouseEnter

De muis **X** schermcoördinaat in pixels, relatief aan de linkerbovenhoek
van het scherm.


De muis **Y** schermcoördinaat in pixels, relatief aan de linkerbovenhoek
van het scherm.


Wordt geactiveerd wanneer een gebruiker zijn muis in een GUI-element beweegt.


De MouseLeave gebeurtenis wordt geactiveerd wanneer een gebruiker zijn muis uit een
`Class.GuiObject` element beweegt.

Vertrouw alsjeblieft niet op de `x` en `y` argumenten die door deze gebeurtenis worden doorgegeven als een
waterdichte manier om te bepalen waar de muis van de gebruiker is wanneer deze een GUI verlaat. Deze
coördinaten kunnen variëren, zelfs wanneer de muis de GUI via dezelfde rand verlaat - vooral wanneer de muis snel het element verlaat. Dit
is te wijten aan het feit dat de coördinaten de positie van de muis aangeven wanneer
de gebeurtenis wordt geactiveerd in plaats van het exacte moment waarop de muis de GUI verlaat.

Deze gebeurtenis wordt geactiveerd, zelfs wanneer het GUI-element onder een ander
element wordt weergegeven.

##### Zie Ook

- `Class.GuiObject.MouseEnter`
- `Class.GuiObject.MouseMoved`
- `Class.GuiObject.MouseWheelForward`
- `Class.GuiObject.MouseWheelBackward`


GuiObject.MouseLeave

Wordt geactiveerd wanneer een gebruiker zijn muis uit een GUI-element beweegt.


Wordt geactiveerd telkens wanneer een gebruiker zijn muis beweegt terwijl deze zich binnen een
`Class.GuiObject` element bevindt. Het is vergelijkbaar met `Class.Mouse.Move`, dat
wordt geactiveerd ongeacht of de muis van de gebruiker zich boven een GUI-element bevindt.

Let op, deze gebeurtenis wordt geactiveerd wanneer de positie van de muis wordt bijgewerkt, daarom zal het
herhaaldelijk worden geactiveerd terwijl het wordt verplaatst.

De `x` en `y` argumenten geven de bijgewerkte schermcoördinaten van de
muur in pixels aan. Deze kunnen nuttig zijn om de locatie van de muis op de GUI, het scherm en de delta sinds de vorige positie van de muis te bepalen
als deze wordt bijgehouden in een globale variabele.

De onderstaande code demonstreert hoe je de `Datatype.Vector2` offset
van de muis van de gebruiker ten opzichte van een GUI-element kunt bepalen.
`Class.GuiObject.AbsolutePosition|AbsolutePosition` wordt gemeten binnen de
GUI-inzet van het scherm, terwijl de `x` en `y` argumenten van deze gebeurtenis
schermcoördinaten zijn die het omvatten, dus de voorbeeldaanroepen
`Class.GuiService:GetGuiInset()|GetGuiInset()` om de twee ruimtes te verzoenen
in plaats van aan te nemen dat er een vaste inzetgrootte is.

```lua
local Players = game:GetService("Players")
local GuiService = game:GetService("GuiService")

local CustomScrollingFrame = script.Parent
local SubFrame = CustomScrollingFrame:FindFirstChild("SubFrame")

local mouse = Players.LocalPlayer:GetMouse()

local function getPosition(X, Y)
	local topLeftInset = GuiService:GetGuiInset()

	local gui_X = CustomScrollingFrame.AbsolutePosition.X
	local gui_Y = CustomScrollingFrame.AbsolutePosition.Y

	local pos = Vector2.new(math.abs(X - gui_X), math.abs(Y - gui_Y - topLeftInset.Y))
	print(pos)
end

CustomScrollingFrame.MouseMoved:Connect(getPosition)
```
Let op dat deze gebeurtenis mogelijk niet precies wordt geactiveerd wanneer de muis van de gebruiker een GUI-element binnenkomt of verlaat. Daarom kunnen de `x` en `y` argumenten mogelijk niet perfect overeenkomen met de coördinaten van de randen van de GUI.

##### Zie Ook

- `Class.GuiObject.MouseEnter`
- `Class.GuiObject.MouseLeave`
- `Class.GuiObject.MouseWheelForward`
- `Class.GuiObject.MouseWheelBackward`


GuiObject.MouseMoved

Wordt geactiveerd telkens wanneer een gebruiker zijn muis beweegt terwijl deze zich binnen een GUI-element bevindt.


De WheelBackward gebeurtenis wordt geactiveerd wanneer een gebruiker zijn muiswiel naar achteren scrollt
wanneer de muis zich boven een `Class.GuiObject` element bevindt. Het is vergelijkbaar met
`Class.Mouse.WheelBackward`, dat wordt geactiveerd ongeacht of de muis van de gebruiker zich boven een GUI-element bevindt.

Deze gebeurtenis wordt alleen geactiveerd als een indicator van de achterwaartse beweging van het wiel.
Dit betekent dat de `x` en `y` muiscoördinaatargumenten niet veranderen als gevolg van deze gebeurtenis. Deze coördinaten veranderen alleen wanneer de muis
beweegt, wat kan worden bijgehouden door de `Class.GuiObject.MouseMoved` gebeurtenis.

##### Zie Ook

- `Class.GuiObject.MouseEnter`
- `Class.GuiObject.MouseLeave`
- `Class.GuiObject.MouseMoved`
- `Class.GuiObject.MouseWheelForward`


GuiObject.MouseWheelBackward

Wordt geactiveerd wanneer een gebruiker zijn muiswiel naar achteren scrollt wanneer de muis zich boven een
GUI-element bevindt.


De WheelForward gebeurtenis wordt geactiveerd wanneer een gebruiker zijn muiswiel naar voren scrollt
wanneer de muis zich boven een `Class.GuiObject` element bevindt. Het is vergelijkbaar met
`Class.Mouse.WheelForward`, dat wordt geactiveerd ongeacht of de muis van de gebruiker zich boven een GUI-element bevindt.

Deze gebeurtenis wordt alleen geactiveerd als een indicator van de voorwaartse beweging van het wiel.
Dit betekent dat de **X** en **Y** muiscoördinaatargumenten niet veranderen als gevolg van deze gebeurtenis. Deze coördinaten veranderen alleen wanneer de
muis beweegt, wat kan worden bijgehouden door de `Class.GuiObject.MouseMoved`
gebeurtenis.

##### Zie Ook

- `Class.GuiObject.MouseEnter`
- `Class.GuiObject.MouseLeave`
- `Class.GuiObject.MouseMoved`
- `Class.GuiObject.MouseWheelBackward`


GuiObject.MouseWheelForward

De **Y** coördinaat van de muis van de gebruiker.


Wordt geactiveerd wanneer een gebruiker zijn muiswiel naar voren scrollt wanneer de muis zich boven
 een GUI-element bevindt.


Het volgende voorbeeld print een bericht wanneer de gebruiker het object selecteert met een
gamepad.

Om ervoor te zorgen dat dit werkt zoals verwacht, moet het worden geplaatst in een `LocalScript`
en een kind zijn van _gui_.


Deze gebeurtenis wordt geactiveerd wanneer de Gamepad-selector begint met focussen op de
`Class.GuiObject`.

Als je wilt controleren wanneer de Gamepad-selectie stopt met focussen op het GUI-element, kun je de `Class.GuiObject.SelectionLost` gebeurtenis gebruiken.

Wanneer een GUI selectie-focus krijgt, verandert de waarde van de
`Class.GuiService.SelectedObject|SelectedObject` eigenschap ook naar
datgene dat selectie krijgt. Om te bepalen welke GUI selectie heeft gekregen, controleer je de waarde van deze eigenschap.


GuiObject.SelectionGained

Wordt geactiveerd wanneer de GuiObject wordt gefocust met de Gamepad-selector.


Het volgende voorbeeld print een bericht wanneer het element zijn focus verliest op
een gamepad.

Om ervoor te zorgen dat dit werkt zoals verwacht, moet het worden geplaatst in een `LocalScript`
en een kind zijn van _gui_.


Deze gebeurtenis wordt geactiveerd wanneer de Gamepad-selector stopt met focussen op de
`Class.GuiObject`.

Als je wilt controleren wanneer de Gamepad-selectie begint met focussen op het GUI-element, kun je de `Class.GuiObject.SelectionGained` gebeurtenis gebruiken.

Wanneer een GUI de selectie-focus verliest, verandert de waarde van de
`Class.GuiService.SelectionObject|SelectionObject` eigenschap ofwel
in `nil` of naar het GUI-element dat de selectie-focus krijgt. Om te bepalen
welk GUI selectie heeft gekregen, of als er geen GUI is geselecteerd, controleer je de waarde van
deze eigenschap.


GuiObject.SelectionLost

Wordt geactiveerd wanneer de Gamepad-selector stopt met focussen op de GuiObject.


Dit codevoorbeeld stelt de speler in staat om de schermpositie van een
UI-element, zoals een `Frame`, te manipuleren door het UI-element een korte
moment vast te houden. Vervolgens beweegt de speler zijn vinger en laat los. Tijdens de gebaar
is het Frame blauw gekleurd met een witte rand.


Deze gebeurtenis wordt geactiveerd na een korte tijd wanneer de speler zijn vinger
op het UI-element houdt met een aanraakgevoelig apparaat. Het wordt geactiveerd met een tabel van
`Datatype.Vector2` die de relatieve schermposities van de vingers beschrijft die betrokken zijn bij de gebaar. Daarnaast wordt het meerdere keren geactiveerd:
`Enum.UserInputState.Begin` na een korte vertraging,
`Enum.UserInputState.Change` als de speler zijn vinger verplaatst tijdens de
gebaar, en tenslotte `Enum.UserInputState.End`. De vertraging is afhankelijk van het platform; in Studio is het iets langer dan een seconde.


GuiObject.TouchLongPress

touchPositions

Een array van `Datatype.Vector2` die de **relatieve**
posities van de vingers beschrijft die betrokken zijn bij de gebaar.


state

Een `Enum.UserInputState` die de status van de gebaar beschrijft:

- Begin wordt eenmaal geactiveerd aan het begin van de gebaar (na de korte
  vertraging)
- Verandering wordt geactiveerd als de speler zijn vinger verplaatst terwijl hij indrukken
- Eind wordt eenmaal geactiveerd aan het einde van de gebaar wanneer ze hun
  vinger loslaten.


Wordt geactiveerd wanneer de speler begint, doorgaat en stopt met het lang indrukken van het UI-element.


Dit codevoorbeeld is bedoeld om geplaatst te worden in een `LocalScript` binnen een interne
`Frame` die zich binnen een externe `Frame`, of andere `GuiObject`, bevindt. Het stelt de
speler in staat om de positie van de interne frame te manipuleren door hun vinger te bewegen op
de externe frame.


Deze gebeurtenis wordt geactiveerd wanneer de speler zijn vinger op het UI-element verplaatst
met een aanraakgevoelig apparaat. Het wordt kort voor
`Class.GuiObject.TouchSwipe` geactiveerd en wordt niet geactiveerd met
`Class.GuiObject.TouchTap`. Deze gebeurtenis is nuttig om de speler in staat te stellen
om de positie van UI-elementen op het scherm te manipuleren.

Deze gebeurtenis wordt geactiveerd met een tabel van `Datatype.Vector2` die de
relatieve schermposities van de vingers beschrijft die betrokken zijn bij de gebaar. Daarnaast wordt het meerdere keren geactiveerd: `Enum.UserInputState.Begin` na een
korte vertraging, `Enum.UserInputState.Change` wanneer de speler zijn
vinger verplaatst tijdens de gebaar, en tenslotte met `Enum.UserInputState.End`.


GuiObject.TouchPan

Een Luau-array van `Datatype.Vector2` objecten, elk die de
positie van alle vingers beschrijft die betrokken zijn bij de gebaar.


totalTranslation

Geeft aan hoe ver de panbeweging is gegaan vanaf het startpunt.


velocity

Geeft aan hoe snel de gebaar in elke dimensie wordt uitgevoerd.


Geeft de `Enum.UserInputState` van het gebaar aan.


Wordt geactiveerd wanneer de speler zijn vinger op het UI-element verplaatst.


Dit codevoorbeeld is bedoeld voor een `LocalScript` binnen een interne `Frame` die
binnen een externe `Frame`, of andere `GuiObject`, zit. Het stelt de speler in staat om de
interne frame te schalen door een `Class.GuiObject.TouchPinch` gebaar uit te voeren op de
externe frame.


Dit evenement wordt geactiveerd wanneer de speler met twee vingers een knijp- of trekgebaar
maakt op het UI-element met een aanraakgevoelig apparaat. Een **knijp**
vindt plaats wanneer twee of meer vingers dichter bij elkaar bewegen, en een **trek**
vindt plaats wanneer ze uit elkaar bewegen. Dit evenement wordt geactiveerd in combinatie met
`Class.GuiObject.TouchPan`. Dit evenement is nuttig om de speler in staat te stellen
de schaal (grootte) van UI-elementen op het scherm te manipuleren, en wordt het meest
vaak gebruikt voor zoomfuncties.

Dit evenement wordt geactiveerd met een tabel van `Datatype.Vector2` die de
relatieve schermposities van de vingers die betrokken zijn bij het gebaar beschrijft. In
aanvulling daarop wordt het meerdere keren geactiveerd: `Enum.UserInputState.Begin` na een
korte vertraging, `Enum.UserInputState.Change` wanneer de speler een vinger verplaatst
tijdens het gebaar, en tenslotte met `Enum.UserInputState.End`. Het moet
worden opgemerkt dat de schaal **multiplicatief** moet worden gebruikt.


GuiObject.TouchPinch

Een Luau-array van `Datatype.Vector2`-objecten, elk die de
positie van alle vingers die betrokken zijn bij het knijpgebaar aangeeft.


scale

Een float die het verschil aangeeft vanaf het begin van het knijpgebaar.


Een float die aangeeft hoe snel het knijpgebaar plaatsvindt.


Wordt geactiveerd wanneer de speler een knijp- of trekgebaar maakt met twee vingers
op het UI-element.


Dit codevoorbeeld is bedoeld voor een `LocalScript` binnen een interne `Frame` die
binnen een externe `Frame`, of andere `GuiObject`, zit. Het stelt de speler in staat om de
interne frame te roteren door een `Class.GuiObject.TouchRotate` gebaar uit te voeren op de
externe frame.


Dit evenement wordt geactiveerd wanneer de speler met twee vingers een knijp- of trekgebaar
maakt op het UI-element met een aanraakgevoelig apparaat. Rotatie vindt plaats
wanneer de hoek van de lijn tussen twee vingers verandert. Dit evenement wordt geactiveerd
in combinatie met `Class.GuiObject.TouchPan`. Dit evenement is nuttig om
de speler in staat te stellen de rotatie van UI-elementen op het
scherm te manipuleren.

Dit evenement wordt geactiveerd met een tabel van `Datatype.Vector2` die de
relatieve schermposities van de vingers die betrokken zijn bij het gebaar beschrijft. In
aanvulling daarop wordt het meerdere keren geactiveerd: `Enum.UserInputState.Begin` na een
korte vertraging, `Enum.UserInputState.Change` wanneer de speler een vinger verplaatst
tijdens het gebaar, en tenslotte met `Enum.UserInputState.End`.


GuiObject.TouchRotate

Een Luau-array van `Datatype.Vector2`-objecten, elk die de
positie van alle vingers die betrokken zijn bij het gebaar aangeeft.


rotation

Een float die aangeeft hoeveel de rotatie is gegaan vanaf het begin van
toegbaar.


Een float die aangeeft hoe snel het gebaar wordt uitgevoerd.


Wordt geactiveerd wanneer de speler een rotatiegebaar maakt met twee vingers op het
UI-element.


Dit codevoorbeeld zorgt ervoor dat een `Frame` (of andere `GuiObject`) stuitert wanneer er een
veeggebaar wordt uitgevoerd op een aanraakgevoelig apparaat (of de emulator van Studio).
Horizontale veegbewegingen zullen de tint van de
`Class.GuiObject.BackgroundColor3` veranderen, terwijl verticale veegbewegingen de
verzadiging zullen veranderen.


Dit evenement wordt geactiveerd wanneer de speler een veeggebaar maakt op het UI
element met een aanraakgevoelig apparaat. Het wordt geactiveerd met de richting van het
gebaar (Omhoog, Omlaag, Links of Rechts) en het aantal aanraakpunten dat betrokken is
bij het gebaar. Veeggebaren worden vaak gebruikt om tabbladen in mobiele
UI's te veranderen.


GuiObject.TouchSwipe

swipeDirection

Een `Enum.SwipeDirection` die de richting van het veeggebaar aangeeft
(Omhoog, Omlaag, Links of Rechts).


numberOfTouches

Het aantal aanraakpunten dat betrokken is bij het gebaar (meestal 1).


Wordt geactiveerd wanneer de speler een veeggebaar maakt op het UI-element.


Dit codevoorbeeld schakelt de `Class.GuiObject.BackgroundTransparency` van een
UI-element, zoals een `Frame`, wanneer erop getikt wordt op een apparaat met aanraakscherm.


Dit evenement wordt geactiveerd wanneer de speler een tikgebaar maakt op het UI-element
met een aanraakgevoelig apparaat. Een tik is een snelle enkele aanraking zonder enige
beweging (een langere druk zou
`Class.GuiObject.TouchLongPress` activeren, en bewegen tijdens de aanraking zou
`Class.GuiObject.TouchPan` en/of `Class.GuiObject.TouchSwipe` activeren). Het wordt geactiveerd
met een tabel van `Datatype.Vector2`-objecten die de relatieve
posities van de vingers die betrokken zijn bij het gebaar beschrijven.


GuiObject.TouchTap

Een array van `Datatype.Vector2` die de **relatieve**
posities van de vingers die betrokken zijn bij het gebaar beschrijft.


Wordt geactiveerd wanneer de speler een tikgebaar maakt op het UI-element.


Dit codevoorbeeld demonstreert een meer betrokken gebruik van TweenPosition door
de te detecteren wanneer de tween voltooid/geannuleerd is door een callbackfunctie te definiëren. Het
print ook of de tween zal afspelen.


Verplaatst een GUI soepel naar een nieuwe `Datatype.UDim2` positie in de opgegeven
tijd met behulp van de opgegeven `Enum.EasingDirection` en `Enum.EasingStyle`.
Deze methode genereert een fout als `easingStyle` is `Enum.EasingStyle.Bezier`
of `Enum.EasingStyle.Spring`.

Deze functie retourneert of de tween zal afspelen. Het zal niet afspelen als
een andere tween actief is op de `Class.GuiObject` en de override
parameter is `false`.

Zie ook `Class.GuiObject:TweenSize()` en
`Class.GuiObject:TweenSizeAndPosition()`.


GuiObject:TweenPosition

endPosition

easingDirection

De richting waarin de GUI naar de _endPosition_ moet worden verplaatst.


easingStyle

De stijl waarin de GUI naar de _endPosition_ moet worden verplaatst.


time

Hoe lang, in seconden, de tween moet duren om te voltooien.


override

Of de tween een in-progress tween zal overschrijven.


callback

Een callbackfunctie die moet worden uitgevoerd wanneer de tween is voltooid.


Verplaatst een GUI soepel naar een nieuwe `Datatype.UDim2`.


Dit codevoorbeeld demonstreert het gebruik van de `Class.GuiObject:TweenSize()`
funtie. Het start een animatie op de `Class.GuiObject.Size`
property van de ouder naar `UDim2.new(0.5, 0, 0.5, 0)`, wat de helft is van de grootte van de `GuiObject`
vader op beide assen.

Daarnaast demonstreert het hoe de callback-parameter kan worden gebruikt om te detecteren
wanneer de tween stopt (of het nu is geannuleerd door een andere tween of voltooid).

Verandert de grootte van een `Class.GuiObject` soepel naar een nieuwe `Datatype.UDim2` in de
opgegeven tijd met behulp van de opgegeven `Enum.EasingDirection` en
`Enum.EasingStyle`. Deze methode genereert een fout als `easingStyle` is
`Enum.EasingStyle.Bezier` of `Enum.EasingStyle.Spring`.

Deze functie retourneert of de tween zal afspelen. Normaal gesproken zal dit
altijd `true` retourneren, maar het zal `false` retourneren als een andere tween actief is
en override is ingesteld op `false`.

Zie ook `Class.GuiObject:TweenSize()` en
`Class.GuiObject:TweenSizeAndPosition()`.


GuiObject:TweenSize

endSize

De grootte waarnaar de GUI moet worden aangepast.


De richting waarin de GUI naar de _endSize_ moet worden verplaatst.


De stijl waarin de GUI naar de _endSize_ moet worden verplaatst.


Verandert de grootte van een `Class.GuiObject` soepel naar een nieuwe `Datatype.UDim2`.


Het onderstaande voorbeeld zou een `Class.Frame` naar de bovenkant links van de ouder
grootte tweenen en het verkleinen tot 0.


Verandert de grootte en verplaatst een GUI soepel naar een nieuwe `Datatype.UDim2` grootte en
positie in de opgegeven tijd met behulp van de opgegeven `Enum.EasingDirection`
en `Enum.EasingStyle`. Deze methode genereert een fout als `easingStyle` is
`Enum.EasingStyle.Bezier` of `Enum.EasingStyle.Spring`.

Deze functie retourneert of de tween zal afspelen. Normaal gesproken zal dit
altijd `true` retourneren, maar het zal `false` retourneren als een andere tween actief is
en override is ingesteld op `false`.

Zie ook `Class.GuiObject:TweenSize()` en
`Class.GuiObject:TweenSizeAndPosition()`.


GuiObject:TweenSizeAndPosition

De richting waarin de GUI naar de _endSize_ en
_endPosition_ moet worden verplaatst.


De stijl waarin de GUI naar de _endSize_ en _endPosition_ moet worden verplaatst.


Verplaatst een GUI soepel naar een nieuwe grootte en positie.


GuiObject

Dit codevoorbeeld demonstreert het gebruik van de Active-eigenschap als een debounce
voor het Activated-evenement.


Deze eigenschap bepaalt of de `Class.GuiObject` invoer naar
3D-ruimte zal onderdrukken, zoals onderliggende modellen met een `Class.ClickDetector` klasse
zoals `Class.DragDetector`.

Voor `Class.GuiButton` objecten (`Class.ImageButton` en
`Class.TextButton`), bepaalt deze eigenschap of
`Class.GuiButton.Activated|Activated` wordt geactiveerd
(`Class.GuiButton.AutoButtonColor|AutoButtonColor` werkt ook voor
hen). De gebeurtenissen `Class.GuiObject.InputBegan|InputBegan`,
`Class.GuiObject.InputChanged|InputChanged`, en
`Class.GuiObject.InputEnded|InputEnded` werken normaal ongeacht de waarde
van deze eigenschap.


GuiObject.Active

Bepaalt of dit UI-element invoer onderdrukt.


Dit codevoorbeeld verplaatst een UI-element naar verschillende zijden van het bovenliggende element.
Het begint linksboven en eindigt rechtsonder. Plak het in een
LocalScript in een Frame, binnen een ScreenGui.


Deze eigenschap bepaalt het oorsprongspunt van een `Class.GuiObject`, relatief
aan zijn absolute grootte. Het oorsprongspunt bepaalt vanaf waar het element
is gepositioneerd (via `Class.GuiObject.Position`) en van waaruit de
weergegeven `Class.GuiObject.Size` uitbreidt.

Zie [hier](/ui/position-and-size#anchorpoint) voor geïllustreerde
diagrammen en details.


GuiObject.AnchorPoint

Bepaalt het oorsprongspunt van een `Class.GuiObject`, relatief aan zijn
absolute grootte.


Het volgende script maakt een automatisch vergrootbaar ouderframe met
een `UIListLayout`, en voegt vervolgens verschillende automatisch vergrootbare `TextLabel`
objecten toe. Let op hoe de ouder `UIListLayout` automatisch wordt vergroot om zijn
kindinhoud te passen en de labels automatisch worden vergroot om hun tekstinhoud te passen.
Dit script kan aan een `ScreenGui` worden toegevoegd.


Deze eigenschap wordt gebruikt om automatisch de grootte van bovenliggende UI-objecten aan te passen op basis van de
grootte van zijn afstammelingen. Je kunt deze eigenschap gebruiken om dynamisch tekst
en andere inhoud aan een UI-object toe te voegen tijdens het bewerken of uitvoeren, en de grootte zal
worden aangepast om die inhoud te passen.

Wanneer `Class.GuiObject.AutomaticSize|AutomaticSize` is ingesteld op een
`Enum.AutomaticSize` waarde die iets anders is dan
`Enum.AutomaticSize|None`, kan dit UI-object worden vergroot afhankelijk van zijn
kind-inhoud.

Voor meer informatie over hoe je deze eigenschap kunt gebruiken en hoe het werkt, zie
[hier](/ui/size-modifiers#automatic-sizing).


GuiObject.AutomaticSize

Bepaalt of het formaat wordt aangepast op basis van de inhoud van kinderen.


Bepaalt de kleur van de achtergrond van de `Class.GuiObject`.


GuiObject.BackgroundColor

Dit codevoorbeeld laat een ouder Frame door alle kleuren van de
regenboog lopen met behulp van Color3.fromHSV.


Deze eigenschap bepaalt de kleur van een `Class.GuiObject` achtergrond (de
vulkleur). Als je element tekst bevat, zoals een `Class.TextBox`,
`Class.TextButton`, of `Class.TextLabel`, zorg er dan voor dat de kleur van je
achtergrond contrasteert met de kleur van de tekst.

Een andere eigenschap die de visuele eigenschappen van de achtergrond bepaalt,
is `Class.GuiObject.BackgroundTransparency`; als deze is ingesteld op `1`,
wordt noch de achtergrond noch de rand weergegeven.

Zie ook `Class.GuiObject.BorderColor3|BorderColor3`.


GuiObject.BackgroundColor3

Bepaalt de achtergrondkleur van de `Class.GuiObject`.


Een abstracte klasse voor alle 2D gebruikersinterface-objecten.


Samenvatting