`InputActionLabel` to obiekt `Class.GuiObject` typu drag-and-drop, który automatycznie
wyświetla odpowiedni klawisz lub ikonę dla `Class.InputAction` w zależności od
aktualnego urządzenia wejściowego gracza (klawiatura/mysz, gamepad, dotyk, VR). Gdy gracz
zmienia urządzenia lub przypisanie jest zmieniane, etykieta aktualizuje się natychmiastowo
bez potrzeby skryptowania.

Renderowanie `InputActionLabel` zależy od `Class.InputAction` (połączonego
przez `Class.InputActionLabel.InputAction`) oraz od dzieci tej akcji
`Class.InputBinding|InputBindings`. Gdy etykieta ustala, co wyświetlić, postępuje według tej kolejności:

1. **Obrazy niestandardowe** — Jeśli dzieci `Class.InputBinding|InputBindings` mają ustawioną
   właściwość `Class.InputBinding.DisplayImage|DisplayImage`, etykieta
   renderuje te obrazy bezpośrednio, opcjonalnie modyfikowane przez
   `Class.InputActionLabel.ImageColor3|ImageColor3` i
   `Class.InputActionLabel.ImageTransparency|ImageTransparency`.

2. **Obrazy klawiszy platformy** — Brakując niestandardowych obrazów, etykieta renderuje
   obrazy dostarczone przez platformę dla dzieci `Class.InputBinding|InputBindings`
   przez `Class.UserInputService:GetImageForKeyCode()`, jeśli takie obrazy są
   dostępne. Złożone przypisania z modyfikatorami pokazują wiele ikon z separatorami `+`.

3. **Nazwy niestandardowe** — Brakując dostępnych obrazów, jeśli dzieci
   `Class.InputBinding|InputBindings` mają ustawioną
   właściwość `Class.InputBinding.DisplayName|DisplayName`, etykieta
   renderuje ten tekst w stylu zdefiniowanym przez
   `Class.InputActionLabel.FontFace|FontFace`,
   `Class.InputActionLabel.TextColor3|TextColor3`,
   `Class.InputActionLabel.TextSize|TextSize`,
   `Class.InputActionLabel.TextTransparency|TextTransparency`,
   `Class.InputActionLabel.TextWrapped|TextWrapped`,
   `Class.InputActionLabel.TextXAlignment|TextXAlignment` oraz
   `Class.InputActionLabel.TextYAlignment|TextYAlignment`.

4. **Napisy klawiszy platformy** — Brakując wszystkich powyższych, etykieta renderuje
   napisy dostarczone przez platformę przez
   `Class.UserInputService:GetStringForKeyCode()`.

5. Jeśli nie przypisano `Class.InputAction` lub nie istnieje dziecko `Class.InputBinding`,
   etykieta renderuje ikonę zastępczą.


InputActionLabel

Ta właściwość jest podobna do `Class.TextLabel.FontFace` i określa
rodzinę czcionek, wagę i styl używany, gdy etykieta renderuje w trybie tekstowym.


InputActionLabel.FontFace

Określa czcionkę używaną do renderowania tekstu.


Ta właściwość określa, jak są kolorowane obrazy etykiety. Gdy jest ustawiona na
biały, nie zachodzi kolorowanie. Ta właściwość jest przydatna do ponownego używania zasobów
obrazów; jeśli źródłowe obrazy są całkowicie białe z przezroczystością, można ustawić
cały kolor etykiety jednocześnie za pomocą tej właściwości.


InputActionLabel.ImageColor3

Określa, jak będą kolorowane renderowane obrazy etykiety.


Ta właściwość określa alfa renderowanych obrazów etykiety. Wartość `0` jest całkowicie
nieprzezroczysta, a wartość `1` jest całkowicie przezroczysta (niewidoczna).


InputActionLabel.ImageTransparency

Określa przezroczystość renderowanych obrazów etykiety.


Instancja `Class.InputAction`, dla której etykieta automatycznie
rozwiązuje i wyświetla swoje preferowane przypisanie. Gdy przypisanie się zmienia (z powodu
zmiany przypisania lub przełączania urządzenia wejściowego), etykieta aktualizuje się automatycznie.

Ustawienie tego na `nil` czyści wyświetlanie i pokazuje ikonę zastępczą.


InputActionLabel.InputAction

Obiekt `Class.InputAction`, którego preferowane przypisanie ta etykieta wyświetla.


Zawiera `Datatype.Content` pierwszego rozwiązania obrazu, gdy etykieta
renderuje w trybie obrazu. Pusta, gdy w trybie tekstowym lub zastępczym. To jest
właściwość tylko do odczytu ustawiana przez silnik, gdy przypisanie się rozwiązuje.


InputActionLabel.ResolvedImageContent

Tylko do odczytu. Rozwiązana zawartość obrazu, która jest aktualnie wyświetlana.


Zawiera złożony ciąg nazwy klawisza, taki jak `Ctrl + Shift + Space`, gdy
etykieta renderuje w trybie tekstowym. Pusta, gdy etykieta renderuje w trybie obrazu lub
zastępczym. To jest właściwość tylko do odczytu ustawiana przez silnik, gdy
przypisanie się rozwiązuje.


InputActionLabel.ResolvedText

Rozwiązany ciąg nazwy klawisza, który jest aktualnie wyświetlany.


Ta właściwość określa kolor całego tekstu renderowanego przez etykietę.


InputActionLabel.TextColor3

Kontroluje rozmiar czcionki w pikselach dla renderowania w trybie tekstowym. Wartość jest ograniczona
między `1` a `200`.


InputActionLabel.TextSize

Określa wysokość linii tekstu w przesunięciach.


Ta właściwość określa przezroczystość całego tekstu renderowanego przez
etykietę.


InputActionLabel.TextTransparency

Określa przezroczystość renderowanego tekstu.


Gdy `true`, tekst renderuje się na wielu liniach w obrębie przestrzeni etykiety, aby
linie `Class.InputActionLabel.TextSize|TextSize` nigdy nie przekraczały
`Class.GuiBase2d.AbsoluteSize` obiektu. Osiąga się to przez łamanie
długich linii tekstu na wiele linii.


InputActionLabel.TextWrapped

Określa, czy tekst zawija się na wiele linii w obrębie przestrzeni etykiety.


Ta właściwość określa poziome wyrównanie tekstu renderowanego w obrębie
przestrzeni etykiety.


InputActionLabel.TextXAlignment

Określa poziome wyrównanie renderowanego tekstu.


Ta właściwość określa pionowe wyrównanie tekstu renderowanego w obrębie
przestrzeni etykiety.


InputActionLabel.TextYAlignment

Określa pionowe wyrównanie renderowanego tekstu.


Obiekt `Class.GuiObject`, który automatycznie wyświetla przypisanie klawisza dla akcji
jako tekst lub obraz.


`Class.GuiObject` to klasa abstrakcyjna (podobnie jak `Class.BasePart`) dla obiektu
interfejsu użytkownika 2D. Definiuje wszystkie właściwości związane z wyświetlaniem
obiektu graficznego interfejsu użytkownika (GUI), takie jak `Class.GuiObject.Size|Size`
i `Class.GuiObject.Position|Position`. Posiada również kilka przydatnych właściwości tylko do odczytu,
jak `Class.GuiObject.AbsolutePosition|AbsolutePosition`,
`Class.GuiObject.AbsoluteSize|AbsoluteSize` oraz
`Class.GuiObject.AbsoluteRotation|AbsoluteRotation`.

Aby manipulować układem obiektów GUI w specjalny sposób, możesz użyć struktury układu
jak [list/flex](/ui/list-flex-layouts) lub
[grid](/ui/grid-table-layouts), a także możesz stylizować je poza ich
podstawowymi właściwościami za pomocą
[modyfikatorów wyglądu](/ui/appearance-modifiers).

Chociaż możliwe jest wykrywanie zdarzeń przycisków myszy na dowolnym obiekcie GUI za pomocą
`Class.GuiObject.InputBegan|InputBegan` i
`Class.GuiObject.InputEnded|InputEnded`, tylko `Class.ImageButton` i
`Class.TextButton` mają wygodne dedykowane zdarzenia, takie jak
`Class.TextButton.Activated|Activated`, aby wykrywać kliknięcia/naciśnięcia.

Poniższy przykład zakłada, że znajduje się w obiekcie GuiObject, takim jak `TextButton`, i
że właściwość `Class.GuiObject.Draggable` jest ustawiona na true. Wydrukuje
the UDim2, z którego gracz rozpoczął przeciąganie obiektu.

To zdarzenie wywoływane jest, gdy gracz zaczyna przeciągać obiekt.

Zobacz także `Class.GuiObject.DragStopped`.

GuiObject.DragBegin

initialPosition

Wartość `Datatype.UDim2` pozycji `Class.GuiObject`
before any drag operation began.

Wywoływane, gdy gracz zaczyna przeciągać obiekt.

Poniższy przykład zakłada, że znajduje się w obiekcie GuiObject, takim jak `TextButton`, oraz
że właściwość `Class.GuiObject.Draggable` jest ustawiona na true. Wydrukuje
the X i Y, gdzie gracz przestał przeciągać GUI. Na przykład, jeśli gracz
zatrzymałby przeciąganie obiektu w punkcie 189, 180, poniżej wydrukuje: Gracz
zatrzymał przeciąganie GuiObject w punkcie (189, 180)


To zdarzenie wywoływane jest, gdy gracz przestaje przeciągać obiekt.

Zobacz także `Class.GuiObject.DragBegin`.

GuiObject.DragStopped

Lokalizacja ekranu myszy **X** w pikselach, w odniesieniu do lewego górnego
rogu ekranu.

Lokalizacja ekranu myszy **Y** w pikselach, w odniesieniu do lewego górnego
rogu ekranu.

Wywoływane, gdy gracz przestaje przeciągać obiekt.

Poniższy przykład demonstruje jeden z wielu przykładów użycia obsługi wejścia użytkownika
z InputBegan w zależności od jego typu.

Aby to działało zgodnie z oczekiwaniami, musi być umieszczone w `LocalScript`
i być dzieckiem _gui_.


To zdarzenie wywoływane jest, gdy użytkownik zaczyna interakcję z `Class.GuiObject`
za pomocą urządzenia interfejsu człowiek-komputer (przycisk myszy w dół, dotyk,
przycisk klawiatury w dół, itd).

`Class.UserInputService` ma podobnie nazwane zdarzenie, które nie jest
ograniczone do konkretnego elementu UI: `Class.UserInputService.InputBegan`.

To zdarzenie zawsze będzie wywoływane niezależnie od stanu gry.

Zobacz także `Class.GuiObject.InputEnded` i `Class.GuiObject.InputChanged`.

GuiObject.InputBegan

input

Obiekt `Class.InputObject`, który zawiera przydatne dane do zapytania o wejście
użytkownika, takie jak `Enum.UserInputType|typ wejścia`,
`Enum.UserInputState|stan wejścia` oraz
`Class.InputObject.Position|współrzędne ekranu wejścia`.

Wywoływane, gdy użytkownik zaczyna interakcję za pomocą urządzenia interfejsu
człowiek-komputer (przycisk myszy w dół, dotyk, przycisk klawiatury w dół, itd).

Poniższy przykład demonstruje jeden z wielu przykładów użycia obsługi wejścia użytkownika
z InputChanged w zależności od jego typu.

Aby to działało zgodnie z oczekiwaniami, musi być umieszczone w `LocalScript`
i być dzieckiem _gui_.

To zdarzenie wywoływane jest, gdy użytkownik zmienia sposób, w jaki wchodzi w interakcję za pomocą
urządzenia interfejsu człowiek-komputer (przycisk myszy w dół, dotyk, przycisk
klawiatury w dół, itd).

`Class.UserInputService` ma podobnie nazwane zdarzenie, które nie jest
ograniczone do konkretnego elementu UI:
`Class.UserInputService.InputChanged`.

To zdarzenie zawsze będzie wywoływane niezależnie od stanu gry.

Zobacz także `Class.GuiObject.InputBegan` i `Class.GuiObject.InputEnded`.

GuiObject.InputChanged

Wywoływane, gdy użytkownik zmienia sposób, w jaki wchodzi w interakcję za pomocą
urządzenia interfejsu człowiek-komputer (przycisk myszy w dół, dotyk, przycisk klawiatury w dół,
etc).

Poniższy przykład demonstruje jeden z wielu przykładów użycia obsługi wejścia użytkownika
z InputEnded w zależności od jego typu.

Aby to działało zgodnie z oczekiwaniami, musi być umieszczone w `LocalScript`
i być dzieckiem _gui_.


Zdarzenie InputEnded wywoływane jest, gdy użytkownik przestaje wchodzić w interakcję za pomocą
urządzenia interfejsu człowiek-komputer (przycisk myszy w dół, dotyk, przycisk
klawiatury w dół, itd).

`Class.UserInputService` ma podobnie nazwane zdarzenie, które nie jest
ograniczone do konkretnego elementu UI: `Class.UserInputService.InputEnded`.

To zdarzenie zawsze będzie wywoływane niezależnie od stanu gry.

Zobacz także `Class.GuiObject.InputBegan` i `Class.GuiObject.InputChanged`.

GuiObject.InputEnded

Obiekt `Class.InputObject`, który zawiera przydatne dane do zapytania o wejście
użytkownika, takie jak `Enum.UserInputType`, `Enum.UserInputState` oraz
`Class.InputObject.Position`.

Wywoływane, gdy użytkownik przestaje wchodzić w interakcję za pomocą urządzenia interfejsu
człowiek-komputer (przycisk myszy w dół, dotyk, przycisk klawiatury w dół, itd).

Poniższy przykład drukuje lokalizację myszy, w pikselach, gdy wchodzi do elementu GUI.


Zdarzenie MouseEnter wywoływane jest, gdy użytkownik przesuwa mysz do
elementu `Class.GuiObject`.

Proszę nie polegać na argumentach `x` i `y` przekazywanych przez to zdarzenie jako
niezawodny sposób określenia, gdzie znajduje się mysz użytkownika, gdy wchodzi do
GUI. Te współrzędne mogą się różnić, nawet gdy mysz wchodzi do GUI przez tę
samą krawędź - szczególnie gdy mysz wchodzi do elementu szybko. Dzieje się tak,
ponieważ współrzędne wskazują pozycję myszy, gdy zdarzenie się wywołuje, a nie
w dokładnym momencie, gdy mysz wchodzi do GUI.

To zdarzenie wywoływane jest nawet wtedy, gdy element GUI renderuje się pod innym
elementem.

Jeśli chcesz śledzić, kiedy mysz użytkownika opuszcza element GUI, możesz
użyć zdarzenia `Class.GuiObject.MouseLeave`.

##### Zobacz także

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

GuiObject.MouseEnter

Współrzędna ekranu myszy **X** w pikselach, w odniesieniu do lewego
górnego rogu ekranu.

Współrzędna ekranu myszy **Y** w pikselach, w odniesieniu do lewego
górnego rogu ekranu.

Wywoływane, gdy użytkownik przesuwa mysz do elementu GUI.

Zdarzenie MouseLeave wywoływane jest, gdy użytkownik przesuwa mysz z
elementu `Class.GuiObject`.

Proszę nie polegać na argumentach `x` i `y` przekazywanych przez to zdarzenie jako
niezawodny sposób określenia, gdzie znajduje się mysz użytkownika, gdy opuszcza
GUI. Te współrzędne mogą się różnić, nawet gdy mysz opuszcza GUI przez tę
samą krawędź - szczególnie gdy mysz opuszcza element szybko. Dzieje się tak,
ponieważ współrzędne wskazują pozycję myszy, gdy zdarzenie się wywołuje, a nie
w dokładnym momencie, gdy mysz opuszcza GUI.

To zdarzenie wywoływane jest nawet wtedy, gdy element GUI renderuje się pod innym
elementem.

##### Zobacz także

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

GuiObject.MouseLeave

Wywoływane, gdy użytkownik przesuwa mysz z elementu GUI.

Wywoływane, gdy użytkownik przesuwa mysz, gdy jest ona wewnątrz
elementu `Class.GuiObject`. Jest to podobne do `Class.Mouse.Move`, które
wywołuje się niezależnie od tego, czy mysz użytkownika jest nad elementem GUI.

Zauważ, że to zdarzenie wywoływane jest, gdy pozycja myszy jest aktualizowana,
więc będzie wywoływane wielokrotnie podczas ruchu.

Argumenty `x` i `y` wskazują zaktualizowane współrzędne ekranu myszy
użytkownika w pikselach. Mogą być przydatne do określenia lokalizacji myszy w GUI,
na ekranie oraz różnicy od poprzedniej pozycji myszy, jeśli jest ona śledzona w
zmiennej globalnej.

Poniższy kod demonstruje, jak określić przesunięcie `Datatype.Vector2`
myszy użytkownika w odniesieniu do elementu GUI:

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

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

local mouse = Players.LocalPlayer:GetMouse()

local function getPosition(X, Y)
	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 - 36))
	print(pos)
end

CustomScrollingFrame.MouseMoved:Connect(getPosition)
```
Zauważ, że to zdarzenie może nie wywoływać się dokładnie, gdy mysz użytkownika wchodzi lub
opuszcza element GUI. Dlatego argumenty `x` i `y` mogą nie pasować idealnie
do współrzędnych krawędzi GUI.

##### Zobacz także

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

GuiObject.MouseMoved

Wywoływane, gdy użytkownik przesuwa mysz, gdy jest ona wewnątrz elementu GUI.

Zdarzenie WheelBackward wywoływane jest, gdy użytkownik przewija kółko myszy wstecz,
gdy mysz jest nad elementem `Class.GuiObject`. Jest to podobne do
`Class.Mouse.WheelBackward`, które wywołuje się niezależnie od tego, czy mysz użytkownika
jest nad elementem GUI.

To zdarzenie wywoływane jest jedynie jako wskaźnik ruchu kółka wstecz.
Oznacza to, że argumenty współrzędnych myszy `x` i `y` nie zmieniają się w
wyniku tego zdarzenia. Te współrzędne zmieniają się tylko, gdy mysz
się porusza, co można śledzić za pomocą zdarzenia `Class.GuiObject.MouseMoved`.

##### Zobacz także

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

GuiObject.MouseWheelBackward

Wywoływane, gdy użytkownik przewija kółko myszy wstecz, gdy mysz jest nad
elementem GUI.

Zdarzenie WheelForward wywoływane jest, gdy użytkownik przewija kółko myszy do przodu,
gdy mysz jest nad elementem `Class.GuiObject`. Jest to podobne do
`Class.Mouse.WheelForward`, które wywołuje się niezależnie od tego, czy mysz użytkownika
jest nad elementem GUI.

To zdarzenie wywoływane jest jedynie jako wskaźnik ruchu kółka do przodu.
Oznacza to, że współrzędne myszy **X** i **Y** nie zmieniają się w
wyniku tego zdarzenia. Te współrzędne zmieniają się tylko, gdy mysz
się porusza, co można śledzić za pomocą zdarzenia `Class.GuiObject.MouseMoved`.

##### Zobacz także

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

GuiObject.MouseWheelForward

Wywoływane, gdy użytkownik przewija kółko myszy do przodu, gdy mysz jest nad
elementem GUI.

Poniższy przykład wypisuje wiadomość, gdy użytkownik wybiera obiekt za pomocą
kontrolera.

Aby to zadziałało jak oczekiwano, musi być umieszczone w `LocalScript`
i być dzieckiem _gui_.

To zdarzenie wywoływane jest, gdy wskaźnik gamepada zaczyna skupiać się na
`Class.GuiObject`.

Jeśli chcesz sprawdzić, kiedy wskaźnik gamepada przestaje skupiać się na elemencie GUI,
możesz użyć zdarzenia `Class.GuiObject.SelectionLost`.

Gdy GUI zyskuje fokus wyboru, wartość właściwości
`Class.GuiService.SelectedObject|SelectedObject` również zmienia się na
obiekt, który zyskuje wybór. Aby określić, który GUI zyskał wybór, sprawdź
wartość tej właściwości.

GuiObject.SelectionGained

Wywoływane, gdy obiekt GuiObject jest skupiony przez wskaźnik gamepada.

Poniższy przykład wypisuje komunikat, gdy element traci fokus na
gamepadzie.

Aby to zadziałało zgodnie z oczekiwaniami, musi być umieszczone w `LocalScript`
i być dzieckiem _gui_.

To zdarzenie wywoływane jest, gdy wskaźnik gamepada przestaje skupiać się na
`Class.GuiObject`.

Jeśli chcesz sprawdzić, kiedy wskaźnik gamepada zaczyna skupiać się na elemencie GUI,
możesz użyć zdarzenia `Class.GuiObject.SelectionGained`.

Gdy GUI traci fokus wyboru, wartość właściwości
`Class.GuiService.SelectionObject|SelectionObject` zmienia się na `nil` lub na
element GUI, który zyskuje fokus wyboru. Aby określić, który GUI zyskał wybór,
lub czy żaden GUI nie jest wybrany, sprawdź wartość tej właściwości.

GuiObject.SelectionLost

Wywoływane, gdy wskaźnik gamepada przestaje skupiać się na GuiObject.

Ten przykład kodu pozwala graczowi na manipulowanie pozycją ekranu niektórego
elementu UI, takiego jak `Frame`, poprzez przytrzymanie elementu UI przez krótki
moment. Następnie gracz przesuwa palec i puszcza. Podczas gestu
Frame jest kolorowany na niebiesko z białą obwódką.


To zdarzenie wyzwala się po krótkiej chwili, gdy gracz trzyma palec
na elemencie UI za pomocą urządzenia z obsługą dotyku. Wyzwala się z tabelą
`Datatype.Vector2`, która opisuje względne pozycje na ekranie palców
zaangażowanych w gest. Dodatkowo wyzwala się wielokrotnie:
`Enum.UserInputState.Begin` po krótkim opóźnieniu,
`Enum.UserInputState.Change`, jeśli gracz przesunie palec podczas
gestu, a na koniec `Enum.UserInputState.End`. Opóźnienie jest zależne od platformy;
w Studio trwa nieco dłużej niż jedną sekundę.

GuiObject.TouchLongPress

touchPositions

Tablica `Datatype.Vector2`, która opisuje **względne**
pozycje palców zaangażowanych w gest.

state

`Enum.UserInputState`, który opisuje stan gestu:

- Begin wyzwala się raz na początku gestu (po krótkim
  opóźnieniu)
- Change wyzwala się, jeśli gracz przesunie palec podczas przytrzymywania
- End wyzwala się raz na końcu gestu, gdy zwolni palec.

Wywoływane, gdy gracz zaczyna, kontynuuje i przestaje długo naciskać element UI.

Ten przykład kodu ma być umieszczony w `LocalScript` wewnątrz
`Frame`, który znajduje się w zewnętrznym `Frame` lub innym `GuiObject`. Umożliwia to
graczowi manipulowanie pozycją wewnętrznego ramki poprzez przesuwanie palca po
zewnętrznej ramce.


To zdarzenie wyzwala się, gdy gracz przesuwa palec po elemencie UI
za pomocą urządzenia z obsługą dotyku. Wyzwala się krótko przed
`Class.GuiObject.TouchSwipe`, i nie wyzwala się z
`Class.GuiObject.TouchTap`. To zdarzenie jest przydatne, aby umożliwić graczowi
manipulację pozycją elementów UI na ekranie.

To zdarzenie wyzwala się z tabelą `Datatype.Vector2`, która opisuje
względne pozycje na ekranie palców zaangażowanych w gest. Dodatkowo,
wyzwala się wielokrotnie: `Enum.UserInputState.Begin` po krótkim
opóźnieniu, `Enum.UserInputState.Change`, gdy gracz przesuwa palec
during the gesture, a na koniec z `Enum.UserInputState.End`.

GuiObject.TouchPan

Tablica Luau obiektów `Datatype.Vector2`, z których każdy wskazuje
pozycję wszystkich palców zaangażowanych w gest.

totalTranslation

Wskazuje, jak daleko gest przesuwania przeszedł od punktu początkowego.

velocity

Wskazuje, jak szybko gest jest wykonywany w każdej
dimenzji.

Wyzwala się, gdy gracz przesuwa palec po elemencie UI.

Ten przykład kodu jest przeznaczony dla `LocalScript` wewnątrz wewnętrznego `Frame`, który znajduje się w zewnętrznym `Frame` lub innym `GuiObject`. Umożliwia graczowi skalowanie wewnętrznego ramki poprzez wykonanie gestu `Class.GuiObject.TouchPinch` na zewnętrznej ramce.


To zdarzenie wyzwala się, gdy gracz używa dwóch palców do wykonania gestu
szczypania lub ciągnięcia na elemencie UI za pomocą urządzenia z obsługą dotyku. **Szczypanie**
ma miejsce, gdy dwa lub więcej palców zbliża się do siebie, a **ciągnięcie**
ma miejsce, gdy się oddalają. To zdarzenie wyzwala się w połączeniu z
`Class.GuiObject.TouchPan`. To zdarzenie jest przydatne, aby umożliwić graczowi
manipulację skalą (rozmiarem) elementów UI na ekranie i najczęściej
jest używane do funkcji powiększania.

To zdarzenie wyzwala się z tabelą `Datatype.Vector2`, która opisuje
względne pozycje na ekranie palców zaangażowanych w gest. Dodatkowo,
wyzwala się wielokrotnie: `Enum.UserInputState.Begin` po krótkim
opóźnieniu, `Enum.UserInputState.Change`, gdy gracz przesuwa palec
during the gesture, a na koniec z `Enum.UserInputState.End`. Należy
zauważyć, że skala powinna być używana **mnożnikowo**.

GuiObject.TouchPinch

Tablica Luau obiektów `Datatype.Vector2`, z których każdy wskazuje
pozycję wszystkich palców zaangażowanych w gest szczypania.

scale

Liczba zmiennoprzecinkowa, która wskazuje różnicę od początku gestu
szczypania.

Liczba zmiennoprzecinkowa wskazująca, jak szybko gest szczypania się odbywa.

Wyzwala się, gdy gracz wykonuje gest szczypania lub ciągnięcia dwoma palcami
na elemencie UI.

Ten przykład kodu jest przeznaczony do `LocalScript` wewnątrz wewnętrznego `Frame`, który znajduje się w zewnętrznym `Frame` lub innym `GuiObject`. Umożliwia graczowi obracanie wewnętrznego ramki poprzez wykonanie gestu `Class.GuiObject.TouchRotate` na zewnętrznej ramce.


To zdarzenie wyzwala się, gdy gracz używa dwóch palców do wykonania gestu
rotacji na elemencie UI za pomocą urządzenia z obsługą dotyku. Rotacja ma miejsce,
 gdy kąt linii między dwoma palcami się zmienia. To zdarzenie wyzwala się
w połączeniu z `Class.GuiObject.TouchPan`. To zdarzenie jest przydatne dla
umożliwienia graczowi manipulacji rotacją elementów UI na ekranie.

To zdarzenie wyzwala się z tabelą `Datatype.Vector2`, która opisuje
względne pozycje na ekranie palców zaangażowanych w gest. Dodatkowo,
wyzwala się wielokrotnie: `Enum.UserInputState.Begin` po krótkim
opóźnieniu, `Enum.UserInputState.Change`, gdy gracz przesuwa palec
during the gesture, a na koniec z `Enum.UserInputState.End`.

GuiObject.TouchRotate

rotation

Liczba zmiennoprzecinkowa wskazująca, jak bardzo rotacja przeszła od początku
gestu.

Liczba zmiennoprzecinkowa, która wskazuje, jak szybko gest jest wykonywany.

Wyzwala się, gdy gracz wykonuje gest rotacji dwoma palcami na
elemencie UI.

Ten przykład kodu spowoduje, że `Frame` (lub inny `GuiObject`) będzie skakać, gdy
wykonany zostanie gest przesunięcia na urządzeniu z obsługą dotyku (lub emulatorem Studio).
Poziome przesunięcia zmienią odcień
`Class.GuiObject.BackgroundColor3`, podczas gdy pionowe przesunięcia zmienią
nasycenie.

To zdarzenie wyzwala się, gdy gracz wykonuje gest przesunięcia na elemencie UI
za pomocą urządzenia z obsługą dotyku. Wyzwala się z kierunkiem gestu
(Góra, Dół, Lewo lub Prawo) oraz liczbą punktów dotykowych zaangażowanych
w gest. Gesty przesunięcia są często używane do zmiany zakładek w mobilnych
interfejsach użytkownika.

GuiObject.TouchSwipe

swipeDirection

`Enum.SwipeDirection` wskazujący kierunek gestu przesunięcia
(Góra, Dół, Lewo lub Prawo).

numberOfTouches

Liczba punktów dotykowych zaangażowanych w gest (zwykle 1).

Wyzwala się, gdy gracz wykonuje gest przesunięcia na elemencie UI.

Ten przykład kodu przełącza `Class.GuiObject.BackgroundTransparency` obiektu UI, takiego jak `Frame`, gdy jest stukany na urządzeniu z obsługą dotykową.

To zdarzenie wyzwala się, gdy gracz wykonuje gest stukania na elemencie UI
za pomocą urządzenia z obsługą dotyku. Stukanie to szybki pojedynczy dotyk bez
jakiegokolwiek ruchu (dłuższe przytrzymanie wyzwoli
`Class.GuiObject.TouchLongPress`, a ruch podczas dotyku wyzwoli
`Class.GuiObject.TouchPan` i/lub `Class.GuiObject.TouchSwipe`). Wyzwala się
z tabelą obiektów `Datatype.Vector2`, które opisują względne
pozycje palców zaangażowanych w gest.

GuiObject.TouchTap

Wyzwala się, gdy gracz wykonuje gest stukania na elemencie UI.

Ten przykład kodu demonstruje bardziej zaawansowane użycie TweenPosition poprzez
detekcję, kiedy tween się kończy/anuluje, definiując funkcję zwrotną. Również
wyświetla, czy tween będzie odtwarzany.


Płynnie przesuwa GUI do nowej pozycji `Datatype.UDim2` w określonym
time, używając określonego `Enum.EasingDirection` i `Enum.EasingStyle`.

Funkcja ta zwróci, czy tween będzie odtwarzany. Nie będzie odtwarzany, jeśli
inny tween działa na `Class.GuiObject`, a parametr override jest `false`.

Zobacz także `Class.GuiObject:TweenSize()` i
`Class.GuiObject:TweenSizeAndPosition()`.

GuiObject:TweenPosition

endPosition

easingDirection

Kierunek, w którym należy ułatwić GUI do _endPosition_.

easingStyle

Styl, w jakim należy ułatwić GUI do _endPosition_.

time

Jak długo, w sekundach, tween powinien trwać do zakończenia.

override

callback

Funkcja zwrotna do wykonania po zakończeniu tweenu.

Płynnie przesuwa GUI do nowego `Datatype.UDim2`.

Ten przykład kodu demonstruje użycie funkcji `Class.GuiObject:TweenSize()`
. Inicjuje animację na właściwości `Class.GuiObject.Size` nadrzędnego obiektu
na `UDim2.new(0.5, 0, 0.5, 0)`, co stanowi połowę rozmiaru `GuiObject`'u
na obu osiach.

Dodatkowo pokazuje, jak parametr zwrotny może być użyty, aby wykryć,
kiedy tween się zatrzymuje (czy został anulowany przez inny tween, czy zakończony).

Płynnie zmienia rozmiar `Class.GuiObject` do nowego `Datatype.UDim2` w
określonym czasie, używając określonego `Enum.EasingDirection` i
`Enum.EasingStyle`.

Funkcja ta zwróci, czy tween będzie odtwarzany. Zwykle zawsze zwróci `true`,
ale jednak zwróci `false`, jeśli inny tween jest aktywny, a override jest ustawione na `false`.

Zobacz także `Class.GuiObject:TweenSize()` i
`Class.GuiObject:TweenSizeAndPosition()`.

GuiObject:TweenSize

endSize

Rozmiar, do którego GUI powinno zmienić rozmiar.

Kierunek, w którym należy ułatwić GUI do _endSize_.

Styl, w jakim należy ułatwić GUI do _endSize_.

Płynnie zmienia rozmiar `Class.GuiObject` do nowego `Datatype.UDim2`.

Poniższy przykład tweenuje `Class.Frame` do lewego górnego rogu rozmiaru rodzica
i zmienia jego rozmiar na 0.


Płynnie zmienia rozmiar i przesuwa GUI do nowego rozmiaru `Datatype.UDim2` i
pozycji w określonym czasie, używając określonego `Enum.EasingDirection`
i `Enum.EasingStyle`.

Funkcja ta zwróci, czy tween będzie odtwarzany. Zwykle zawsze zwróci `true`,
ale jednak zwróci `false`, jeśli inny tween jest aktywny, a override jest ustawione na `false`.

Zobacz także `Class.GuiObject:TweenSize()` i
`Class.GuiObject:TweenSizeAndPosition()`.

GuiObject:TweenSizeAndPosition

Kierunek, w którym należy ułatwić GUI do _endSize_ i
_endPosition_.

Styl, w jakim należy ułatwić GUI do _endSize_ i _endPosition_.

Płynnie przesuwa GUI do nowego rozmiaru i pozycji.

GuiObject

Ten przykład kodu demonstruje użycie właściwości Active jako debounce
dla zdarzenia Activated.

Ta właściwość określa, czy `Class.GuiObject` będzie przyjmować wejście do
przestrzeni 3D, takie jak modele znajdujące się poniżej z klasą `Class.ClickDetector`
jak `Class.DragDetector`.

Dla obiektów `Class.GuiButton` (`Class.ImageButton` i
`Class.TextButton`), ta właściwość określa, czy
`Class.GuiButton.Activated|Activated` zostanie wywołane
(`Class.GuiButton.AutoButtonColor|AutoButtonColor` również będzie działać dla
nich). Zdarzenia `Class.GuiObject.InputBegan|InputBegan`,
`Class.GuiObject.InputChanged|InputChanged` oraz
`Class.GuiObject.InputEnded|InputEnded` działają normalnie, niezależnie od wartości
tej właściwości.

GuiObject.Active

Określa, czy ten element UI przyjmuje wejście.

Ten przykład kodu przenosi element UI na różne strony elementu nadrzędnego.
Zaczyna w lewym górnym rogu i kończy w prawym dolnym rogu. Wklej do
LocalScript w Frame, w ScreenGui.


Ta właściwość określa punkt początkowy `Class.GuiObject`, w odniesieniu
do jego absolutnego rozmiaru. Punkt początkowy określa, skąd element
jest pozycjonowany (poprzez `Class.GuiObject.Position`) i z którego
rozmiar renderowanego `Class.GuiObject.Size` się rozwija.

Zobacz [tutaj](/ui/position-and-size#anchorpoint) dla ilustrowanych
diagramów i szczegółów.

GuiObject.AnchorPoint

Określa punkt początkowy `Class.GuiObject`, w odniesieniu do jego
absolutnego rozmiaru.

Poniższy skrypt tworzy automatycznie dopasowaną ramkę nadrzędną z
`UIListLayout`, a następnie wstawia kilka automatycznie dopasowanych obiektów `TextLabel`.
Zauważ, jak nadrzędny `UIListLayout` automatycznie zmienia rozmiar, aby dopasować się do
zawartości dzieci, a etykiety automatycznie zmieniają rozmiar, aby dopasować się do swojej zawartości tekstowej.
Ten skrypt można umieścić w `ScreenGui`.


Ta właściwość jest używana do automatycznego dostosowywania rozmiaru obiektów UI rodzica na podstawie
rozmiaru jego potomków. Możesz użyć tej właściwości do dynamicznego dodawania tekstu
i innej zawartości do obiektu UI w czasie edycji lub działania, a rozmiar
zostanie dostosowany do tej zawartości.

Gdy `Class.GuiObject.AutomaticSize|AutomaticSize` jest ustawione na wartość
`Enum.AutomaticSize` inną niż
`Enum.AutomaticSize|None`, ten obiekt UI może zmieniać rozmiar w zależności od jego
zawartości dzieci.

Aby uzyskać więcej informacji na temat tego, jak używać tej właściwości i jak działa,
zobacz [tutaj](/ui/size-modifiers#automatic-sizing).

GuiObject.AutomaticSize

Określa, czy zmiana rozmiaru następuje na podstawie zawartości dzieci.

GuiObject.BackgroundColor

Ten przykład kodu powoduje, że rodzicielska Ramka przechodzi przez wszystkie kolory tęczy, używając Color3.fromHSV.


Ta właściwość określa kolor tła `Class.GuiObject` (kolor wypełnienia). Jeśli twój element zawiera tekst,
jak `Class.TextBox`, `Class.TextButton` lub `Class.TextLabel`, upewnij się, że kolor twojego
tła kontrastuje z kolorem tekstu.

Inną właściwością, która określa właściwości wizualne tła,
jest `Class.GuiObject.BackgroundTransparency`; jeśli jest ustawiona na `1`,
nawet tło, ani obramowanie nie będą renderowane.

Zobacz także `Class.GuiObject.BorderColor3|BorderColor3`.

GuiObject.BackgroundColor3

Ta właściwość określa przezroczystość tła `Class.GuiObject`
i obramowania. Nie określa jednak przezroczystości
tekstu, jeśli GUI jest `Class.TextBox`, `Class.TextButton` lub
`Class.TextLabel`; przezroczystość tekstu jest określana przez
`Class.TextBox.TextTransparency`, `Class.TextButton.TextTransparency` i
`Class.TextLabel.TextTransparency` odpowiednio.

Jeśli ta właściwość jest ustawiona na `1`, ani tło, ani obramowanie nie będą
renderowane, a tło GUI będzie całkowicie przezroczyste.

GuiObject.BackgroundTransparency

Określa przezroczystość tła `Class.GuiObject` i
obramowania.

Określa kolor obramowania `Class.GuiObject`.

GuiObject.BorderColor

Ten przykład kodu powoduje, że krawędź obiektu GuiObject nadrzędnego jest podświetlana, gdy
użytkownik najeżdża myszą na element.


Określa kolor prostokątnego obramowania `Class.GuiObject` (znanego również jako kolor konturu). Jest to oddzielne od
`Class.GuiObject.BackgroundColor3`. Nie będziesz w stanie zobaczyć
obramowania obiektu, jeśli jego właściwość `Class.GuiObject.BorderSizePixel` jest ustawiona
na `0`.

Zauważ, że komponent `Class.UIStroke` pozwala na bardziej zaawansowane efekty obramowania.

GuiObject.BorderColor3

Ta właściwość określa sposób, w jaki obramowanie `Class.GuiObject` jest
rozmieszczone w odniesieniu do jego wymiarów, używając enum o tej samej nazwie,
`Enum.BorderMode`.

Zauważ, że `Class.UIStroke` może nadpisać tę właściwość i pozwolić na bardziej
zaawansowane efekty obramowania.

GuiObject.BorderMode

Określa sposób, w jaki obramowanie `Class.GuiObject` jest rozmieszczone
w odniesieniu do jego wymiarów.

Ta właściwość określa, jak szerokie jest obramowanie `Class.GuiObject`, w
pikselach. Ustawienie tego na 0 całkowicie wyłącza obramowanie.

Zauważ, że `Class.UIStroke` może nadpisać tę właściwość i pozwolić na bardziej
zaawansowane efekty obramowania.

GuiObject.BorderSizePixel

Określa szerokość obramowania `Class.GuiObject` w pikselach.

Ta właściwość określa, czy `Class.GuiObject` będzie przycinać (czynić
niewidocznymi) jakąkolwiek część potomnych elementów GUI, które w przeciwnym razie
renderowałyby się poza granicami prostokąta.

#### Zachowanie rotacji

Gdy `Class.StarterGui.ClipsDescendantsSupportsRotation` jest włączone,
przycinanie działa poprawnie dla obiektów obróconych. Jednak przycinanie **przez**
obrócone kształty (gdy rodzic przycinający sam jest obrócony) lub przez zaokrąglone
rogi (`Class.UICorner`) nie jest obsługiwane.

Gdy `Class.StarterGui.ClipsDescendantsSupportsRotation` **nie** jest
włączone, a ten `Class.GuiObject` lub jakikolwiek przodek `Class.GuiObject` ma
**niezerową** `Class.GuiObject.Rotation|Rotation`, ta właściwość jest
**ignorowana** i potomne elementy GUI będą renderowane niezależnie od wartości
tej właściwości.

GuiObject.ClipsDescendants

Określa, czy potomne `Class.GuiObject|GuiObjects` poza
zakresami elementu GUI rodzica powinny być renderowane.

To wskazuje, czy `Class.GuiObject` (i jego potomkowie) mogą być
przesuwane po ekranie.

GuiObject.Draggable

Określa, czy `Class.GuiObject` (i jego potomkowie) mogą być
przesuwane po ekranie.

Abstrakcyjna klasa dla wszystkich obiektów interfejsu użytkownika 2D.

/reference/engine/classes/InputActionLabel.yaml