`InputActionLabel` is een drag-and-drop `Class.GuiObject` die automatisch
de juiste toets of pictogram voor een `Class.InputAction` toont op basis van de
huidige invoerapparaat van de speler (toetsenbord/muis, gamepad, aanraking, VR). Wanneer de
speler van apparaat wisselt of de binding opnieuw wordt gebonden, wordt het label onmiddellijk
geüpdatet zonder scripting.

De weergave van de `InputActionLabel` is afhankelijk van de `Class.InputAction` (gelinkt
via `Class.InputActionLabel.InputAction`) en de child `Class.InputBinding|InputBindings` van die actie. Terwijl het label bepaalt wat te tonen, volgt het deze volgorde:

1. **Aangepaste Afbeeldingen** — Als child `Class.InputBinding|InputBindings` hun
   `Class.InputBinding.DisplayImage|DisplayImage` eigenschap hebben ingesteld, rendert het label
   die afbeeldingen direct, optioneel aangepast door
   `Class.InputActionLabel.ImageColor3|ImageColor3` en
   `Class.InputActionLabel.ImageTransparency|ImageTransparency`.

2. **Platform Toetsafbeeldingen** — Bij gebrek aan aangepaste afbeeldingen, rendert het label
   door het platform geleverde afbeeldingen voor child `Class.InputBinding|InputBindings`
   via `Class.UserInputService:GetImageForKeyCode()`, als dergelijke afbeeldingen beschikbaar zijn.
   Samengestelde bindingen met modifiers tonen meerdere pictogrammen met `+`
   scheidingstekens.

3. **Aangepaste Namen** — Bij gebrek aan beschikbare afbeeldingen, als child
   `Class.InputBinding|InputBindings` hun
   `Class.InputBinding.DisplayName|DisplayName` eigenschap hebben ingesteld, rendert het label
   die tekst in een stijl gedefinieerd door
   `Class.InputActionLabel.FontFace|FontFace`,
   `Class.InputActionLabel.TextColor3|TextColor3`,
   `Class.InputActionLabel.TextSize|TextSize`,
   `Class.InputActionLabel.TextTransparency|TextTransparency`,
   `Class.InputActionLabel.TextWrapped|TextWrapped`,
   `Class.InputActionLabel.TextXAlignment|TextXAlignment`, en
   `Class.InputActionLabel.TextYAlignment|TextYAlignment`.

4. **Platform Toetsstrings** — Bij gebrek aan al het bovenstaande, rendert het label
   door het platform geleverde strings via
   `Class.UserInputService:GetStringForKeyCode()`.

5. Als er geen `Class.InputAction` is toegewezen of er geen child `Class.InputBinding`
   bestaat, rendert het label een tijdelijke pictogram.


InputActionLabel

Deze eigenschap is vergelijkbaar met `Class.TextLabel.FontFace` en bepaalt de
lettertypefamilie, gewicht en stijl die worden gebruikt wanneer het label in een tekstmodus wordt weergegeven.


InputActionLabel.FontFace

Bepaalt het lettertype dat wordt gebruikt om tekst weer te geven.


Deze eigenschap bepaalt hoe labelafbeeldingen worden gekleurd. Wanneer ingesteld op
wit, vindt er geen kleuring plaats. Deze eigenschap is nuttig voor het hergebruiken van afbeeldings
assets; als de bronafbeeldingen volledig wit zijn met transparantie, kun je de hele labelkleur in één keer instellen met deze eigenschap.


InputActionLabel.ImageColor3

Bepaalt hoe weergegeven labelafbeeldingen worden gekleurd.


Deze eigenschap bepaalt de alpha van weergegeven labelafbeeldingen. Een waarde van
`0` is volledig ondoorzichtig en een waarde van `1` is volledig transparant
(onzichtbaar).


InputActionLabel.ImageTransparency

Bepaalt de transparantie van weergegeven labelafbeeldingen.


De `Class.InputAction` instantie waarvoor het label automatisch
de voorkeurbinding oplost en weergeeft. Wanneer de binding verandert (door
herbinding of wisselen van invoerapparaat), wordt het label automatisch geüpdatet.

Het instellen van dit op `nil` wist de weergave en toont de tijdelijke afbeelding.


InputActionLabel.InputAction

De `Class.InputAction` waarvan de voorkeurbinding dit label weergeeft.


Bevat de `Datatype.Content` van de eerste opgeloste afbeelding wanneer het label
weergeeft in een afbeeldingsmodus. Leeg wanneer in tekst- of tijdelijke modus. Dit is
een alleen-lezen eigenschap die door de engine wordt ingesteld wanneer de binding oplost.


InputActionLabel.ResolvedImageContent

Alleen-lezen. De opgeloste afbeeldingsinhoud die momenteel wordt weergegeven.


Bevat de samengestelde toetsnaamstring zoals `Ctrl + Shift + Space` wanneer
the label in tekstmodus weergeeft. Leeg wanneer het label in afbeeldings- of
tijdelijke modus weergeeft. Dit is een alleen-lezen eigenschap die door de engine wordt ingesteld wanneer de
binding oplost.


InputActionLabel.ResolvedText

De opgeloste toetsnaamstring die momenteel wordt weergegeven.


Deze eigenschap bepaalt de kleur van alle tekst die door het label wordt weergegeven.


InputActionLabel.TextColor3

Beheert de lettergrootte in pixels voor tekstmodusweergave. Waarde is beperkt
tussen `1` en `200`.


InputActionLabel.TextSize

Bepaalt de regelhoogte van tekst in offsets.


Deze eigenschap bepaalt de transparantie van alle tekst die door het
label wordt weergegeven.


InputActionLabel.TextTransparency

Bepaalt de transparantie van weergegeven tekst.


Wanneer `true`, wordt tekst op meerdere regels weergegeven binnen de ruimte van het label zodat
`Class.InputActionLabel.TextSize|TextSize` regels nooit de
`Class.GuiBase2d.AbsoluteSize` van het object overschrijden. Dit wordt bereikt door
lange regels tekst in meerdere regels te splitsen.


InputActionLabel.TextWrapped

Bepaalt of tekst naar meerdere regels wordt gewikkeld binnen de ruimte van het label.


Deze eigenschap bepaalt de horizontale uitlijning van tekst die binnen
de ruimte van het label wordt weergegeven.


InputActionLabel.TextXAlignment

Bepaalt de horizontale uitlijning van weergegeven tekst.


Deze eigenschap bepaalt de verticale uitlijning van tekst die binnen
de ruimte van het label wordt weergegeven.


InputActionLabel.TextYAlignment

Bepaalt de verticale uitlijning van weergegeven tekst.


Een `Class.GuiObject` die automatisch de toetsbinding voor een actie weergeeft
als tekst of een afbeelding.


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


Deze eigenschap bepaalt de transparantie van de `Class.GuiObject`
achtergrond en rand. Het bepaalt echter niet de transparantie van
tekst als de GUI een `Class.TextBox`, `Class.TextButton`, of
`Class.TextLabel` is; de teksttransparantie wordt bepaald door
`Class.TextBox.TextTransparency`, `Class.TextButton.TextTransparency`, en
`Class.TextLabel.TextTransparency` respectievelijk.

Als deze eigenschap is ingesteld op `1`, wordt noch de achtergrond noch de rand weergegeven en is de GUI-achtergrond volledig transparant.


GuiObject.BackgroundTransparency

Bepaalt de transparantie van de achtergrond en rand van de `Class.GuiObject`.


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


GuiObject.BorderColor

Dit codevoorbeeld zorgt ervoor dat de rand van een ouder GuiObject oplicht wanneer de
gebruiker zijn muis boven het element beweegt.


Bepaalt de kleur van de rechthoekige rand van de `Class.GuiObject` (ook
bekend als de randkleur). Dit is gescheiden van de achtergrondkleur van het object
`Class.GuiObject.BackgroundColor3`. Je kunt de rand van het object niet zien als de eigenschap
`Class.GuiObject.BorderSizePixel` is ingesteld op `0`.

Let op dat de `Class.UIStroke` component meer geavanceerde randeffecten mogelijk maakt.


GuiObject.BorderColor3

Deze eigenschap bepaalt op welke manier de rand van de `Class.GuiObject` is
gerangschikt ten opzichte van zijn afmetingen met behulp van de enum van dezelfde naam,
`Enum.BorderMode`.

Let op dat `Class.UIStroke` deze eigenschap kan overschrijven en meer
geavanceerde randeffecten mogelijk maakt.


GuiObject.BorderMode

Bepaalt op welke manier de rand van de `Class.GuiObject` is gerangschikt
relatief aan zijn afmetingen.


Deze eigenschap bepaalt hoe breed de rand van de `Class.GuiObject` wordt weergegeven, in
pixels. Het instellen hiervan op 0 schakelt de rand volledig uit.

Let op dat `Class.UIStroke` deze eigenschap kan overschrijven en meer
geavanceerde randeffecten mogelijk maakt.


GuiObject.BorderSizePixel

Bepaalt de pixelbreedte van de rand van de `Class.GuiObject`.


Een abstracte klasse voor alle 2D gebruikersinterface-objecten.


/reference/engine/classes/InputActionLabel.yaml

Samenvatting