`Class.GuiButton` to abstrakcyjna klasa, która dziedziczy z `Class.GuiObject`.
Jest to klasa bazowa dla interaktywnych, klikanych obiektów `Class.ImageButton` oraz
`Class.TextButton`. Ta klasa definiuje również kilka właściwości dla
interaktywnego zachowania, mianowicie `Class.GuiButton.AutoButtonColor|AutoButtonColor`
i `Class.GuiButton.Modal|Modal`.

Najważniejszym zdarzeniem w `Class.GuiButton` jest
`Class.GuiButton.Activated|Activated`, **zdarzenie wieloplatformowe**, które wyzwala
kiedy przycisk jest aktywowany. Używając myszki, oznacza to kliknięcie przycisku
i zwolnienie przycisku, gdy kursor jest nadal nad obiektem UI. W przypadku dotyku
odbywa się to w ten sam sposób, ale z dotykiem zamiast naciśnięcia przycisku. W końcu, dla gamepadów,
`Class.GuiButton.Activated|Activated` wyzwala, gdy `Class.GuiButton` jest wybrany
kiedy wciśnięty i zwolniony jest przycisk **A**. Krótko mówiąc, to wydarzenie jest bardzo
przydatne do programowania interfejsu użytkownika w wariancie wieloplatformowym, ponieważ zapewnia ładne
generalne API dla pojedynczego wejścia użytkownika.

Zdarza się, gdy wykryto naciśnięcie i zwolnienie lewego przycisku myszki na komputerze, zwolnienie dotyku na urządzeniach mobilnych lub aktywacja **A**/krzyża w trybie nawigacji UI na konsoli.

Ponieważ to zdarzenie nie jest wywoływane na serwerze, powinno być używane tylko w `Class.LocalScript` lub w `Class.Script` z `Class.Script.RunContext|RunContext` równym `Enum.RunContext.Client`.

GuiButton.Activated

inputObject

clickCount

Wyzwala się, gdy przycisk jest aktywowany.

To wydarzenie wyzwala się, gdy mysz użytkownika całkowicie kliknie lewy przycisk na
`Class.GuiButton`.

Jeśli chodzi o klikanie, mysz musi znajdować się w obrębie
`Class.GuiButton`, a przycisk myszy musi być naciśnięty i zwolniony przed tym wydarzeniem. Jeśli mysz opuści obszar
`Class.GuiButton` i zostanie zwolniona, to wydarzenie się nie wyzwoli. Jeśli chcesz
uniknąć tego ograniczenia, możesz użyć
`Class.GuiButton.MouseButton1Down|MouseButton1Down` i
`Class.GuiButton.MouseButton1Up|MouseButton1Up`; te wydarzenia są podobne,
ale wyzwolą się, gdy użytkownik naciśnie lub zwolni lewy przycisk myszy.

GuiButton.MouseButton1Click

Wyzwala się, gdy mysz użytkownika całkowicie kliknie lewy przycisk na `Class.GuiButton`.

To wydarzenie wyzwala się, gdy użytkownik naciska lewy przycisk myszy na
`Class.GuiButton`.

Dla zdarzenia wymagającego, aby użytkownik wcisnął **i** zwolnił lewy przycisk
na `Class.GuiButton`, rozważ użycie
`Class.GuiButton.MouseButton1Click|MouseButton1Click`.

GuiButton.MouseButton1Down

Współrzędna ekranu **X** myszy w pikselach.

Współrzędna ekranu **Y** myszy w pikselach.

Wyzwala się, gdy użytkownik naciska lewy przycisk myszy na
`Class.GuiButton`.

To wydarzenie wyzwala się, gdy użytkownik zwalnia swój lewy przycisk myszy z
`Class.GuiButton`.

Dla zdarzenia wymagającego, aby użytkownik wcisnął **i** zwolnił lewy przycisk
na `Class.GuiButton`, rozważ użycie
`Class.GuiButton.MouseButton1Click|MouseButton1Click`.

GuiButton.MouseButton1Up

Wyzwala się, gdy użytkownik zwalnia swój lewy przycisk myszy z
`Class.GuiButton`.

To wydarzenie wyzwala się, gdy mysz użytkownika całkowicie kliknie prawy przycisk na
`Class.GuiButton`.

Jeśli chodzi o klikanie, mysz musi znajdować się w obrębie
`Class.GuiButton`, a przycisk myszy musi być naciśnięty i zwolniony przed tym wydarzeniem. Jeśli mysz opuści obszar
`Class.GuiButton` i zostanie zwolniona, to wydarzenie się nie wyzwoli. Jeśli chcesz
uniknąć tego ograniczenia, możesz użyć
`Class.GuiButton.MouseButton2Down|MouseButton2Down` i
`Class.GuiButton.MouseButton2Up|MouseButton2Up`; te wydarzenia są podobne,
al wyzwolą się, gdy użytkownik naciśnie lub zwolni prawy przycisk myszy.

GuiButton.MouseButton2Click

Wyzwala się, gdy mysz użytkownika całkowicie kliknie prawy przycisk na `Class.GuiButton`.

To wydarzenie wyzwala się, gdy użytkownik naciska prawy przycisk myszy na
`Class.GuiButton`.

Dla zdarzenia wymagającego, aby użytkownik wcisnął **i** zwolnił prawy przycisk
na `Class.GuiButton`, rozważ użycie
`Class.GuiButton.MouseButton2Click|MouseButton2Click`.

GuiButton.MouseButton2Down

Wyzwala się, gdy użytkownik naciska prawy przycisk myszy na
`Class.GuiButton`.

To wydarzenie wyzwala się, gdy użytkownik zwalnia swój prawy przycisk myszy z
`Class.GuiButton`.

Dla zdarzenia wymagającego, aby użytkownik wcisnął **i** zwolnił prawy przycisk
na `Class.GuiButton`, rozważ użycie
`Class.GuiButton.MouseButton2Click|MouseButton2Click`.

GuiButton.MouseButton2Up

Wyzwala się, gdy użytkownik zwalnia swój prawy przycisk myszy z
`Class.GuiButton`.

Wyzwanie zostaje wywołane, gdy zarejestrowano naciśnięcie i zwolnienie prawym przyciskiem myszy, długie naciśnięcie na wejściu dotykowym, wykrycie `R3` z kontrolera gier, lub
<kbd>Alt</kbd><kbd>Enter</kbd> w trybie nawigacji interfejsu użytkownika przy użyciu
klawiatury.


GuiButton.SecondaryActivated

Obiekt wejściowy reprezentujący alternatywną akcję aktywacji.

Wysyła zdarzenie, gdy aktywowana jest "drugorzędna" akcja przycisku.

GuiButton

Ta właściwość określa, czy przycisk automatycznie zmienia kolor,
gdy wskaźnik `Class.Mouse` użytkownika najeżdża na niego lub klika na nim. Jeśli `true`, to
przycisk automatycznie zmieni kolor, gdy mysz najeżdża na niego lub
klika na nim. Jeśli `false`, przycisk nie zmieni koloru.

Jeśli chcesz dostosować, jak przycisk zmienia się, gdy mysz
najeżdża na niego lub klika na nim, rozważ użycie `Class.ImageButton` i
zmiany `Class.ImageButton.HoverImage|HoverImage` oraz
`Class.ImageButton.PressedImage|PressedImage` tego elementu.

Proszę pamiętać, że ta właściwość nie wpłynie na `Class.ImageButton`, jeśli jego
właściwość `Class.ImageButton.Image|Image` jest ustawiona
na obrazek. Dodatkowo, ta właściwość nie wpłynie na `Class.ImageButton` przy najeżdżaniu myszką,
gdy jego `Class.ImageButton.HoverImage|HoverImage` nie jest `nil`, ani przy kliknięciu myszką,
jeśli jego `Class.ImageButton.PressedImage|PressedImage` nie jest `nil`.

GuiButton.AutoButtonColor

Określa, czy przycisk automatycznie zmienia kolor, gdy mysz
najeżdża na niego lub kliknie go.

Instancja `Class.HapticEffect`, która będzie odtwarzana, gdy `Class.GuiButton`
jest najeżdżany.

GuiButton.HoverHapticEffect

Jeśli `true`, gdy element GUI jest widoczny, mysz nie będzie zablokowana,
chyba że wciśnięty jest prawy przycisk myszy.

GuiButton.Modal

Instancja `Class.HapticEffect`, która będzie odtwarzana, gdy `Class.GuiButton`
jest naciskany.

GuiButton.PressHapticEffect

Właściwość typu boolean, która wskazuje, czy obiekt został wybrany.

GuiButton.Selected

Ustawia styl `Class.GuiButton` na podstawie listy z góry określonych
stylów.

GuiButton.Style

Abstrakcyjna klasa dla interaktywnych elementów interfejsu użytkownika 2D.

`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) takiego jak
`Class.GuiObject.Size|Size` i `Class.GuiObject.Position|Position`. Posiada również kilka
przydatnych właściwości tylko do odczytu, takich 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 takiej jak [list/flex](/ui/list-flex-layouts) lub
[grid](/ui/grid-table-layouts), a także możesz je stylizować
poza ich właściwościami rdzeniowymi poprzez
[modulatory wyglądu](/ui/appearance-modifiers).

Chociaż możliwe jest wykrywanie zdarzeń przycisku myszy na każdym
obiecie 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ęcie/naciśnięcie.

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łuje się, gdy gracz zaczyna przeciągać obiekt.

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

GuiObject.DragBegin

initialPosition

Wartość `Datatype.UDim2` pozycji `Class.GuiObject`
przed rozpoczęciem dowolnej operacji przeciągania.

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

Poniższy przykład zakłada, że znajduje się wewnątrz GuiObject, takiego jak `TextButton`, i
że właściwość `Class.GuiObject.Draggable` jest ustawiona na true. Wydrukuje
y X i Y, w których gracz zatrzymał przeciąganie GUI. Na przykład, jeśli gracz
zatrzymałby przeciąganie obiektu na 189, 180, poniżej zostanie wydrukowane: Gracz
zatrzymał przeciąganie GuiObject na (189, 180)

To zdarzenie wywołuje się, gdy gracz przestaje przeciągać obiekt.

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

GuiObject.DragStopped

Położenie myszy **X** na ekranie w pikselach, w odniesieniu do górnego lewego
rogu ekranu.

Położenie myszy **Y** na ekranie w pikselach, w odniesieniu do górnego lewego
rogu ekranu.

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

Poniższy przykład demonstruje jeden z wielu sposobów obsługi wprowadzania 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łuje się, gdy użytkownik zaczyna interagować z `Class.GuiObject`
za pomocą urządzenia interfejsu człowiek-komputer (przycisk myszy w dół, dotyk zaczyna,
przycisk klawiatury w dół itd).

`Class.UserInputService` ma wydarzenie o podobnej nazwie, które nie jest
ograniczone do konkretnego elementu UI: `Class.UserInputService.InputBegan`.

To zdarzenie zawsze się wywoła 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 zapytań o dane wejściowe użytkownika
jak `Enum.UserInputType|typ wejścia`,
`Enum.UserInputState|stan wejścia`, oraz
`Class.InputObject.Position|współrzędne ekranu wejścia`.

Wywołane, gdy użytkownik zaczyna interakcję za pomocą urządzenia interfejsu
człowiek-komputer (przycisk myszy w dół, dotyk zaczyna, 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łuje się, gdy użytkownik zmienia sposób, w jaki wchodzi w interakcję za pomocą
urządzenia interfejsu człowiek-komputer (przycisk myszy w dół, dotyk zaczyna, przycisk klawiatury
w dół itd).

`Class.UserInputService` ma wydarzenie o podobnej nazwie, które nie jest
ograniczone do konkretnego elementu UI:
`Class.UserInputService.InputChanged`.

To zdarzenie zawsze się wywoła niezależnie od stanu gry.

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

GuiObject.InputChanged

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

Poniższy przykład demonstruje jeden z wielu przykładów użycia obsługi wejścia od 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łuje się, gdy użytkownik przestaje interakcję
za pomocą urządzenia interfejsu człowiek-komputer (przycisk myszy w dół,
dotyk zaczyna, przycisk klawiatury w dół itd).

`Class.UserInputService` ma wydarzenie o podobnej nazwie, które nie jest
ograniczone do konkretnego elementu UI: `Class.UserInputService.InputEnded`.

To zdarzenie zawsze się wywoła 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 zapytań o dane wejściowe użytkownika
jak `Enum.UserInputType`, `Enum.UserInputState`, oraz
`Class.InputObject.Position`.

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

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

Zdarzenie MouseEnter wywołuje się, gdy użytkownik przesuwa mysz do
elementu `Class.GuiObject`.

Proszę nie polegać na argumentach `x` i `y` przekazanych przez to zdarzenie, jako
niezawodny sposób stwierdzenia, gdzie mysz użytkownika znajduje się, gdy wchodzi w GUI.
Te współrzędne mogą się różnić nawet, gdy mysz wchodzi w GUI przez tę samą
krawędź - szczególnie, gdy mysz wchodzi w element szybko. Dzieje się tak,
ponieważ współrzędne wskazują pozycję myszy, gdy zdarzenie się wywołuje,
niz tysiącna chwila w၊   t będą one raczej dostarczały szczegół informacji.

Zdarzenie to się wywołuje, nawet 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ędne ekranu **X** myszy w pikselach, w odniesieniu do górnego
lewego rogu ekranu.

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

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

Zdarzenie MouseLeave wywołuje się, gdy użytkownik przesuwa mysz z
elementu `Class.GuiObject`.

Proszę nie polegać na argumentach `x` i `y` przekazanych przez to zdarzenie, jako
niezawodny sposób stwierdzenia, gdzie mysz użytkownika znajduje się, 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,
niz tysiącna chwila w je kontrastowej podstawił. 

To zdarzenie wywołuje się nawet, 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łane, gdy użytkownik przesuwa mysz z elementu GUI.

Fires whenever a user moves their mouse while it is inside a
`Class.GuiObject` element. It is similar to `Class.Mouse.Move`, which
fires regardless whether the user's mouse is over a GUI element.

Note, this event fires when the mouse's position is updated, therefore it
will fire repeatedly while being moved.

The `x` and `y` arguments indicate the updated screen coordinates of the
user's mouse in pixels. These can be useful to determine the mouse's
location on the GUI, screen, and delta since the mouse's previous position
if it is being tracked in a global variable.

The code below demonstrates how to determine the `Datatype.Vector2` offset
of the user's mouse relative to a GUI element:

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

Note that this event may not fire exactly when the user's mouse enters or
exits a GUI element. Therefore, the `x` and `y` arguments may not match up
perfectly to the coordinates of the GUI's edges.

##### See Also

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


GuiObject.MouseMoved

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

Zdarzenie WheelBackward wywołuje się, gdy użytkownik przewraca mysz do tyłu,
kiedy mysz znajduje się nad elementem `Class.GuiObject`. Jest to podobne do
`Class.Mouse.WheelBackward`, które wywołuje się niezależnie od tego, czy mysz
grasujemy nad elementem GUI.

To zdarzenie wywołuje się jedynie jako wskaźnik ruchu kółka do tyłu.
To oznacza, ż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.MouseWheelForward`

GuiObject.MouseWheelBackward

Wywołane, gdy użytkownik przeważa mysz w dół, kiedy mysz jest nad elementem GUI.

Zdarzenie WheelForward wywołuje się, gdy użytkownik przesuwa mysz do przodu,
kiedy mysz znajduje się nad elementem `Class.GuiObject`. Jest to podobne do
`Class.Mouse.WheelForward`, które wywołuje się niezależnie od tego, czy mysz
grasujemy nad elementem GUI.

To zdarzenie wywołuje się jedynie jako wskaźnik ruchu kółka do przodu.
To oznacza, ż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łane, gdy użytkownik przesuwa mysz 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łuje się, gdy wskaźnik gamepada zaczyna koncentrować się na
`Class.GuiObject`.

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

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

GuiObject.SelectionGained

Wywołane, gdy obiekt GuiObject jest skupiony na wskaźniku 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łuje się, gdy selekcja gamepada przestaje koncentrować się na
`Class.GuiObject`.

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

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

GuiObject.SelectionLost

Wywołane, gdy selekcja gamepada przestaje koncentrować się na obiekcie GuiObject.

Ten przykład kodu pozwala graczowi manipulować położeniem na ekranie niektórego
elementu UI, takiego jak `Frame`, przytrzymując go przez krótki
moment. Następnie gracz przesuwa palec i puszcza. Podczas gestu
ramka ma niebieski kolor z białym konturem.

To zdarzenie uruchamia się po krótkiej chwili, gdy gracz trzyma palec
na elemencie UI, korzystając z urządzenia z obsługą dotyku. Uruchamia się z tabelą
`Datatype.Vector2`, która opisuje względne pozycje ekranu palców zaangażowanych w
gest. Dodatkowo uruchamia się wiele razy:
`Enum.UserInputState.Begin` po krótkim opóźnieniu,
`Enum.UserInputState.Change`, jeśli gracz poruszy palcem podczas
gestu, i na końcu `Enum.UserInputState.End`. Opóźnienie jest zależne od platformy;
 w Studio trwa nieco dłużej niż 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 porusza palcem podczas naciśnięcia
- End wyzwala się raz na końcu gestu, gdy zwalniają swój
  palec.

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

Ten przykład kodu jest przeznaczony do umieszczenia 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 uruchamia się, gdy gracz porusza palcem po elemencie UI,
korzystając z urządzenia z obsługą dotyku. Uruchamia się tuż przed tym,
jak `Class.GuiObject.TouchSwipe` by się uruchomiło, i nie uruchamia się z
`Class.GuiObject.TouchTap`. To zdarzenie jest przydatne do umożliwienia graczowi
manipulacji pozycją elementów UI na ekranie.

To zdarzenie uruchamia się z tabelą `Datatype.Vector2`, która opisuje
względne pozycje ekranu palców zaangażowanych w gest. Dodatkowo uruchamia się
wielokrotnie: `Enum.UserInputState.Begin` po krótkim opóźnieniu,
`Enum.UserInputState.Change` gdy gracz porusza palcem podczas gestu, i na końcu
z `Enum.UserInputState.End`.

GuiObject.TouchPan

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

totalTranslation

Wskazuje, jak daleko gest przesunięcia dotarł od swojego punktu startowego.

velocity

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

Wyzwala się, gdy gracz porusza palcem po elemencie interfejsu UI.

Ten przykładowy kod jest przeznaczony do `LocalScript` wewnątrz `Frame`, który
znajduje się w zewnętrznym `Frame` lub innym `GuiObject`. Pozwala graczowi na skalowanie
wewnętrznego frame'u, wykonując gest `Class.GuiObject.TouchPinch` na
zewnętrznym frame'ie.

To zdarzenie uruchamia się, gdy gracz używa dwóch palców, aby wykonać gest
ściśnięcia lub rozciągania na elemencie UI, korzystając z urządzenia z obsługą dotyku. **Ściśnięcie**
zdarza się, gdy dwa lub więcej palców zbliża się do siebie, a **rozciąganie**
zdarza się, gdy się oddalają. To zdarzenie uruchamia się w połączeniu z
`Class.GuiObject.TouchPan`. To zdarzenie jest przydatne, aby umożliwić graczowi
manipulację skalą (rozmiar) elementów UI na ekranie i najczęściej stosuje się je do
funkcji zoom.

To zdarzenie uruchamia się z tabelą `Datatype.Vector2`, która opisuje
względne pozycje ekranu palców zaangażowanych w gest. Dodatkowo uruchamia się
wielokrotnie: `Enum.UserInputState.Begin` po krótkim opóźnieniu,
`Enum.UserInputState.Change` gdy gracz porusza palcem podczas gestu, i na końcu
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 na
pozycję wszystkich palców zaangażowanych w gest ściskania.

scale

Float, który wskazuje różnicę od początku gestu ściskania.

Float wskazujący, jak szybko gest ściskania jest wykonywany.

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

Ten przykład kodu jest przeznaczony dla `LocalScript` w ramach wewnętrznego `Frame`, który znajduje się wewnątrz zewnętrznego `Frame` lub innego `GuiObject`. Umożliwia graczowi obracanie wewnętrznego ramki, wykonując gest `Class.GuiObject.TouchRotate` na zewnętrznej ramce.


To zdarzenie uruchamia się, gdy gracz używa dwóch palców, aby wykonać gest
ściśnięcia lub rozciągania na elemencie UI, korzystając z urządzenia z obsługą dotyku. Do obrotu dochodzi,
 gdy kąt lini pomiędzy dwoma palcami się zmienia. To zdarzenie uruchamia się
w połączeniu z `Class.GuiObject.TouchPan`. To zdarzenie jest przydatne do
umożliwienia graczowi manipulacji obrotem elementów UI na ekranie.

To zdarzenie uruchamia się z tabelą `Datatype.Vector2`, która opisuje
względne pozycje ekranu palców zaangażowanych w gest. Dodatkowo uruchamia się
wielokrotnie: `Enum.UserInputState.Begin` po krótkim opóźnieniu,
`Enum.UserInputState.Change` gdy gracz porusza palcem podczas gestu, i na końcu
z `Enum.UserInputState.End`.

GuiObject.TouchRotate

rotation

Float wskazujący, jak daleko rotacja przebiegła od początku
gestu.

Float, który wskazuje, jak szybko gest jest wykonywany.

Wyzwala się, gdy gracz wykonuje gest rotacji dwoma palcami na elemencie
interfejsu 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 uruchamia się, gdy gracz wykonuje gest przesunięcia na elemencie UI,
korzystając z urządzenia z obsługą dotyku. Uruchamia się z kierunkiem gestu
(Góra, Dół, Lewo lub Prawo) oraz liczbą punktów dotyku zaangażowanych w gest. Gesty przesunięcia
dobrze sprawdzają się przy zmianie zakładek w mobilnych interfejsach użytkownika.

GuiObject.TouchSwipe

swipeDirection

`Enum.SwipeDirection` wskazujący kierunek gestu przesunięcia
(w górę, w dół, w lewo lub w prawo).

numberOfTouches

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

Wyzwala się, gdy gracz wykonuje gest przesunięcia po elemencie interfejsu 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 uruchamia się, gdy gracz wykonuje gest dotyku na elemencie UI,
korzystając z urządzenia z obsługą dotyku. Dotyk to szybkie pojedyncze dotknięcie
bez żadnego ruchu (dłuższe naciśnięcie uruchomi
`Class.GuiObject.TouchLongPress`, a poruszanie się podczas dotyku uruchomi
`Class.GuiObject.TouchPan` i/lub `Class.GuiObject.TouchSwipe`). Uruchamia 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 dotknięcia na elemencie interfejsu UI.

Ten przykład kodu demonstruje bardziej zaawansowane użycie TweenPosition poprzez
detekcję, kiedy tween się kończy/anuluje, definiując funkcję callback. Również
drukuje, czy tween zostanie odtworzony.


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

Ta funkcja zwróci, czy tween będzie odtwarzany. Nie odtworzy, 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 wygładzić GUI do _endPosition_.

easingStyle

Styl, w którym należy wygładzić GUI do _endPosition_.

time

Jak długo, w sekundach, tween powinien zająć czas na zakończenie.

override

Czy tween nadpisze w trakcie działania tween.

callback

Funkcja zwrotna do wykonania po zakończeniu tweena.

Płynnie przemieszcza 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
time, używając określonego `Enum.EasingDirection` i
`Enum.EasingStyle`.

Ta funkcja zwróci, czy tween będzie odtwarzany. Normalnie zwróci
`true`, ale 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, na który GUI powinien być zmieniany.

Kierunek, w którym należy wygładzić GUI do _endSize_.

Styl, w którym należy wygładzić 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
oraz zmienia jego rozmiar na 0.

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

Ta funkcja zwróci, czy tween będzie odtwarzany. Normalnie zwróci
`true`, ale 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 wygładzić GUI do _endSize_ i
_endPosition_.

Styl, w którym należy wygładzić GUI do _endSize_ i _endPosition_.

Płynnie przemieszcza 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` wciąga wejście do
przestrzeni 3D, takiej jak leżące modele 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` nadal będzie działać również 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

Determines whether this UI element sinks input.


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


Ta właściwość określa punkt początkowy `Class.GuiObject`, w odniesieniu
do jego absolutnej wielkości. Punkt początkowy określa, z którego miejsca element
jest pozycjonowany (przez `Class.GuiObject.Position`) oraz z którego
renderowany `Class.GuiObject.Size` się rozciąga.

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

GuiObject.AnchorPoint

Określa punkt początkowy `Class.GuiObject`, w odniesieniu do jego
absolutnej wielkości.

Poniższy skrypt tworzy automatycznie dostosowującą się ramkę rodzica z
a `UIListLayout`, a następnie wstawia kilka automatycznie dostosowujących się obiektów `TextLabel`.
Zauważ, jak rodzic `UIListLayout` automatycznie zmienia rozmiar, aby dopasować się do
swojej zawartości podrzędnej, a etykiety automatycznie zmieniają rozmiar, aby pasowały do swojej zawartości tekstowej.
Ten skrypt można powiązać z `ScreenGui`.

Ta właściwość jest używana do automatycznego ustalania rozmiaru obiektów UI rodzica
na podstawie rozmiaru jego potomków. Możesz użyć tej właściwości, aby dynamicznie dodać tekst
oraz inne treści do obiektu UI w czasie edycji lub uruchamiania, a rozmiar dostosuje się
aby pomieścić tę treść.

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

Aby uzyskać więcej informacji na temat korzystania z tej właściwości i jej działania, proszę
zobaczyć [tutaj](/ui/size-modifiers#automatic-sizing).

GuiObject.AutomaticSize

Określa, czy zmiana rozmiaru odbywa się na podstawie zawartości dzieci.

GuiObject.BackgroundColor

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

Ta właściwość określa kolor tła obiektu `Class.GuiObject` (kolor
wypełnienia). Jeśli Twój element zawiera tekst, taki jak `Class.TextBox`,
`Class.TextButton` lub `Class.TextLabel`, upewnij się, że kolor 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 to jest ustawione na `1`,
ani 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` oraz
`Class.TextLabel.TextTransparency`.

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 i obramowania `Class.GuiObject`.

Określa kolor obramowania `Class.GuiObject`.

GuiObject.BorderColor

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

Określa kolor prostokątnego obramowania `Class.GuiObject` (znany również
jako kolor konturu). To jest oddzielne od `Class.GuiObject.BackgroundColor3`.
Nie będziesz w stanie zobaczyć obramowania obiektu, jeśli jego
daję `Class.GuiObject.BorderSizePixel` jest ustawione na `0`.

Zauważ, że komponent `Class.UIStroke` umożliwia bardziej zaawansowane efekty obramowania.

GuiObject.BorderColor3

Ta właściwość określa w jaki sposób obramowanie `Class.GuiObject` jest
układane w odniesieniu do jego wymiarów przy użyciu enumeracji tej samej nazwy,
`Enum.BorderMode`.

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

GuiObject.BorderMode

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

Ta właściwość określa jak szerokie jest obramowanie `Class.GuiObject`, w
pikselach. Ustawienie tej wartości na 0 całkowicie dezaktywuje obramowanie.

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

GuiObject.BorderSizePixel

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

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