Klasa `Class.TextLabel` renderuje prostokąt, podobnie jak `Class.Frame`, z stylizowanym
tekstem. Prostokąt może być używany do definiowania granic tekstu, skalowania
(`Class.TextLabel.TextScaled|TextScaled`), zawijania
(`Class.TextLabel.TextWrapped|TextWrapped`) i wyrównania
(`Class.TextLabel.TextXAlignment|TextXAlignment` i/lub
`Class.TextLabel.TextYAlignment|TextYAlignment`).

Ta klasa zawiera właściwości, które kontrolują wyświetlanie tekstu, takie jak
`Class.TextLabel.Font|Font` i `Class.TextLabel.TextColor3|TextColor3`. Aby
wyświetlać tylko tekst i ukrywać tło prostokąta, ustaw
`Class.TextLabel.BackgroundTransparency|BackgroundTransparency` na `1`.

Obiekt `Class.UITextSizeConstraint` może być użyty do ograniczenia rozmiaru
tekstu z włączonym `Class.TextLabel.TextScaled|TextScaled`. Zaleca się,
aby rozmiar tekstu nie był mniejszy niż `9`, w przeciwnym razie może nie być
widoczny dla wielu użytkowników.


TextLabel

Ta właściwość dostarcza kopię `Class.TextLabel.Text|Text`, która zawiera
dokładnie to, co jest renderowane przez `Class.TextLabel`. Jest to użyteczne
w celu eliminacji tagów stylów używanych do [tekstów bogatych](/ui/rich-text)
markup; na przykład, gdy `Class.TextLabel.RichText|RichText` jest włączone,
właściwość `Class.TextLabel.ContentText|ContentText` pokazuje tekst taki,
jak pojawia się użytkownikowi.

<table>
    <thead>
        <tr>
            <th>RichText</th>
            <th>Tekst</th>
            <th>ContentText</th>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td><code>false</code></td>
            <td>&lt;b&gt;Cześć,&lt;br/&gt; świecie!&lt;/b&gt;</td>
            <td>&lt;b&gt;Cześć,&lt;br/&gt; świecie!&lt;/b&gt;</td>
        </tr>
        <tr>
            <td><code>true</code></td>
            <td>&lt;b&gt;Cześć,&lt;br/&gt; świecie!&lt;/b&gt;</td>
            <td>Cześć,<br/> świecie!</td>
        </tr>
    </tbody>
  </table>


TextLabel.ContentText

Kopia `Class.TextLabel.Text`, która zawiera dokładnie to, co jest
renderowane przez `Class.TextLabel`.


Ten przykładowy kod renderuje listę wszystkich dostępnych czcionek.

Ta właściwość wybiera jedną z kilku zdefiniowanych czcionek, z którymi
`Class.TextLabel` renderuje swój tekst. Niektóre czcionki mają warianty pogrubione,
kursywne i/lub lekkie.

Z wyjątkiem czcionki `Enum.Font.Legacy`, każda czcionka renderuje
tekst z wysokością linii równą właściwości `Class.TextLabel.TextSize|TextSize`.

Czcionka `Enum.Font.Code` jest jedyną czcionką monospace. Ma jedyną
cechę, że każdy znak ma dokładnie ten sam stosunek szerokości i wysokości
wynoszący 1:2, gdzie szerokość każdego znaku wynosi około połowy
właściwości `Class.TextLabel.TextSize|TextSize`.

Ta właściwość jest synchronizowana z właściwością `Class.TextLabel.FontFace|FontFace`.


TextLabel.Font

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


Ta właściwość jest podobna do właściwości `Class.TextLabel.Font|Font`, ale
pozwala na ustawienie czcionek, które nie istnieją w `Enum.Font`.

Ta właściwość jest synchronizowana z właściwością `Class.TextLabel.Font|Font`
w taki sposób, że przy ustawianiu `Class.TextLabel.FontFace|FontFace`, czcionka jest
ustawiana na odpowiadającą wartość `Enum.Font` lub na
`Enum.Font.Unknown`, jeśli nie ma żadnych dopasowań.


TextLabel.FontFace

Ta właściwość określa rozmiar czcionki, który ma być używany.


TextLabel.FontSize

Określa rozmiar czcionki, który ma być używany.


Kontroluje wysokość linii jako wielokrotność rozmiaru kwadratu `em`
czcionki, skalując odstęp między liniami tekstu w `Class.TextLabel`.
Dopuszczalne wartości wahają się od `1.0` do `3.0`, z domyślną wartością
`1.0`.


TextLabel.LineHeight

Skaluje odstęp między liniami tekstu w `Class.TextLabel`.


Ta właściwość ustawia, czy `Class.TextLabel` powinien uwzględniać
`Class.GuiBase2d.Localize`, czy nie.


TextLabel.LocalizedText

Ustawia, czy `Class.TextLabel` powinien być `Class.GuiBase2d.Localize`, czy
nie.


Ta właściwość kontroluje maksymalną liczbę graphemów (lub jednostek tekstu)
, które są wyświetlane na `Class.TextLabel`. Jest to głównie
zapewnione jako prosta metoda stworzenia
[efektu maszyny do pisania](/ui/animation#typewriter-effect), gdzie
znaki pojawiają się jeden po drugim.

Zmiana tej właściwości nie zmienia pozycji ani rozmiaru widocznych
graphemów; układ będzie obliczony tak, jakby wszystkie graphemy były widoczne.

Ustawienie właściwości na `-1` wyłącza limit i pokazuje cały tekst
`Class.TextLabel.Text|Text`.


TextLabel.MaxVisibleGraphemes

Maksymalna liczba graphemów, które `Class.TextLabel` może pokazać.


TextLabel.OpenTypeFeatures

TextLabel.OpenTypeFeaturesError

Ta właściwość określa, czy `Class.TextLabel` renderuje swój tekst
z użyciem [tekstów bogatych](/ui/rich-text) markup do stylizacji
odcinków ciągu w pogrubieniu, kursywie, w określonych kolorach i więcej.

Aby użyć tekstów bogatych, wystarczy uwzględnić tagi formatowania
tekstów bogatych w ciągu `Class.TextLabel.Text|Text`.


TextLabel.RichText

Określa, czy `Class.TextLabel` renderuje swój tekst z użyciem formatowania
tekstów bogatych.


Ten przykład kodu tworzy zanikający baner dla TextLabel. Znika tekst,
wybiera losowy ciąg (unikając powtórzeń) i ponownie się pojawia.

Ten przykład kodu demonstruje renderowanie emoji za pomocą właściwości Text.

Ta właściwość określa treść tekstu renderowanego przez
`Class.TextLabel`. Właściwości wizualne ciągu renderowanego na
ekranie są określane przez `Class.TextLabel.TextColor3|TextColor3`,
`Class.TextLabel.TextTransparency|TextTransparency`,
`Class.TextLabel.TextSize|TextSize`, `Class.TextLabel.Font|Font`,
`Class.TextLabel.TextScaled|TextScaled`,
`Class.TextLabel.TextWrapped|TextWrapped`,
`Class.TextLabel.TextXAlignment|TextXAlignment` oraz
`Class.TextLabel.TextYAlignment|TextYAlignment`.

Możliwe jest renderowanie emoji takich jak 🔒 oraz innych symboli, które
nie są dotknięte przez właściwość `Class.TextLabel.TextColor3|TextColor3`. Te
mogą być wklejane do obiektów `Class.Script` i `Class.LocalScript`, a także
w pola w oknie [Właściwości](/studio/properties).

Ta właściwość może zawierać znaki nowej linii. Podobnie, ta właściwość może
zawierać znak tabulatora, ale zostanie renderowany jako spacja.


TextLabel.Text

Określa ciąg renderowany przez `Class.TextLabel`.


Ta właściwość tylko do odczytu odzwierciedla absolutny rozmiar renderowanego
tekstu w przesunięciach, co oznacza, że jeśli spróbujesz zmieścić tekst w
prostokącie, ta właściwość odzwierciedli minimalne wymiary prostokąta, którego
potrzebujesz, aby zmieścić tekst.

Używając `Class.TextService:GetTextSize()`, możesz przewidzieć, co
`Class.TextLabel.TextBounds|TextBounds` otrzyma dla ciągu,
`Class.TextLabel.Font|Font`, `Class.TextLabel.TextSize|TextSize` oraz
rozmiaru ramki.


TextLabel.TextBounds

Właściwość tylko do odczytu, która odzwierciedla absolutny rozmiar renderowanego
tekstu w przesunięciach.


Ta właściwość określa kolor tekstu.


TextLabel.TextColor

Ten przykład kodu sprawia, że TextLabel lub TextButton odlicza w dół od 10,
ustawiając kolor tekstu w trakcie.

Ta właściwość określa kolor całego tekstu renderowanego przez
element `Class.TextLabel`.


TextLabel.TextColor3

`Enum.TextDirection`, w którym tekst jest renderowany.


TextLabel.TextDirection

Kierunek, w którym tekst jest renderowany.


Boleanowy reprezentacja, czy tekst etykiety mieści się w jej rozmiarze.


TextLabel.TextFits

Ta właściwość określa, czy tekst jest skalowany, aby wypełnił
całą przestrzeń etykiety. Gdy jest włączone, `Class.TextLabel.TextSize|TextSize`
jest ignorowane, a `Class.TextLabel.TextWrapped|TextWrapped` jest automatycznie
włączone. Ta właściwość jest użyteczna do renderowania elementów tekstowych w
`Class.BillboardGui|BillboardGuis`. Kiedy ta właściwość jest używana dla
[UI na ekranie](/ui/on-screen-containers), może być pomocne
użyć `Class.UITextSizeConstraint`, aby ograniczyć zakres możliwych rozmiarów
czcionek.

##### Automatyczne dopasowanie

Zaleca się unikanie używania
`Class.TextLabel.TextScaled|TextScaled` i dostosowywanie UI, aby
wykorzystać właściwość `Class.GuiObject.AutomaticSize|AutomaticSize` zamiast tego. Oto
kluczowe różnice między tymi dwiema właściwościami:

- `Class.TextLabel.TextScaled|TextScaled` skaluje zawartość (tekst), aby
  dostosować się do UI. Bez starannego rozważenia niektóre teksty mogą stać
  się nieczytelne, jeśli zostaną zeskalowane za mało.

- `Class.GuiObject.AutomaticSize|AutomaticSize` zmienia rozmiar UI, aby
  dostosować się do zawartości, jednocześnie utrzymując stały rozmiar czcionki. Dla
  większych informacji, zobacz [tutaj](/ui/size-modifiers#automatic-sizing).

Dodatkowo, zaleca się unikanie stosowania obu
`Class.GuiObject.AutomaticSize|AutomaticSize` oraz
`Class.TextLabel.TextScaled|TextScaled` do tej samej `Class.TextLabel`.
`Class.GuiObject.AutomaticSize|AutomaticSize` określa maksymalną
ilość dostępnej przestrzeni, którą `Class.GuiObject` może używać (w tym
przypadku tekst), podczas gdy `Class.TextLabel.TextScaled|TextScaled`
wykorzystuje dostępne miejsce określone przez `Class.GuiObject.AutomaticSize|AutomaticSize`
, aby skalować
rozmiar czcionki do maksymalnego rozmiaru czcionki (100), jeśli nie ma żadnych
ograniczeń rozmiaru.


TextLabel.TextScaled

Zmienia, czy tekst jest dostosowywany do rozmiaru wewnątrz `Class.TextLabel`.


Ta właściwość określa wysokość jednej linii renderowanego tekstu. Jednostka
jest w przesunięciach, a nie punktach (które są używane w większości programów
edycyjnych dokumentów). Czcionka `Enum.Font.Legacy` nie posiada tej właściwości.


TextLabel.TextSize

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


Ta właściwość ustawia kolor konturu, czyli obramowania, renderowanego tekstu.
Wraz z
`Class.TextLabel.TextStrokeTransparency|TextStrokeTransparency`, określa
ostateczny wygląd wizualny konturu tekstu.

Jako potężna alternatywa, która obsługuje gradienty kolorów, zobacz
`Class.UIStroke`.


TextLabel.TextStrokeColor3

Określa kolor konturu tekstu (obramowania).


Ta właściwość ustawia przezroczystość konturu, czyli obramowania, renderowanego
tekstu. Wraz z `Class.TextLabel.TextStrokeColor3|TextStrokeColor3`, określa
ostateczny wygląd wizualny konturu tekstu.

Należy pamiętać, że kontur tekstu to wiele renderowań tej samej przezroczystości, więc
ta właściwość jest zasadniczo mnożona sama w sobie cztery razy.
W związku z tym, zaleca się ustawienie
`Class.TextLabel.TextStrokeTransparency|TextStrokeTransparency` na wartość
w przedziale `0.75` do `1` dla bardziej subtelnego efektu.

Jako potężna alternatywa, która obsługuje gradienty kolorów, zobacz
`Class.UIStroke`.


TextLabel.TextStrokeTransparency

Określa przezroczystość konturu tekstu (obramowania).


Ta właściwość określa przezroczystość całego tekstu renderowanego przez
`Class.TextLabel`.


TextLabel.TextTransparency

Określa przezroczystość renderowanego tekstu.


Kontroluje przycinanie tekstu wyświetlanego w `Class.TextLabel`.


TextLabel.TextTruncate

Ta właściwość określa, czy tekst powinien zawijać się na krawędziach
przestrzeni elementu `Class.TextLabel`.


TextLabel.TextWrap

Określa, czy tekst powinien zawijać się na krawędziach
przestrzeni elementu `Class.TextLabel`.


Gdy jest włączona, ta właściwość renderuje tekst w wielu liniach w
przestrzeni elementu `Class.TextLabel`, aby
`Class.TextLabel.TextBounds|TextBounds` nigdy nie przekroczyło
`Class.GuiBase2d.AbsoluteSize` elementu. Osiąga się to poprzez
łamanie długich linii tekstu na wiele linii.

Łamanie linii preferuje białe znaki; jeśli długie, niełamane słowo
przekroczy szerokość elementu, to słowo zostanie złamane na kilka
linii.

Jeśli dalsze łamanie linii spowoduje, że wysokość pionowa tekstu (komponent
**Y** `Class.TextLabel.TextBounds|TextBounds`) przekroczy wysokość pionową
elementu (komponent **Y**
`Class.GuiBase2d.AbsoluteSize`), to ta linia nie będzie renderowana.


TextLabel.TextWrapped

Określa, czy tekst zawija się w wiele linii w przestrzeni elementu `Class.TextLabel`,
przycinając dodatkowy tekst.


Ta właściwość określa poziome wyrównanie tekstu renderowanego w
przestrzeni obiektu. Jest używana wspólnie z
`Class.TextLabel.TextYAlignment|TextYAlignment`, aby w pełni określić
ywyrównanie tekstu na obu osiach.

Należy pamiętać, że ta właściwość nie wpłynie na właściwości tylko do odczytu
`Class.TextLabel.TextBounds|TextBounds` i `Class.TextLabel.TextFits|TextFits`.


TextLabel.TextXAlignment

Określa poziome wyrównanie renderowanego tekstu.


Ta właściwość określa pionowe wyrównanie tekstu renderowanego w
przestrzeni obiektu. Jest używana wspólnie z
`Class.TextLabel.TextXAlignment|TextXAlignment`, aby w pełni określić
ywyrównanie tekstu na obu osiach.

Należy pamiętać, że ta właściwość nie wpłynie na właściwości tylko do odczytu
`Class.TextLabel.TextBounds|TextBounds` i `Class.TextLabel.TextFits|TextFits`.


TextLabel.TextYAlignment

Określa pionowe wyrównanie renderowanego tekstu.


Element interfejsu użytkownika 2D, który wyświetla tekst nieinteraktywny.


GuiLabel to abstrakcyjna klasa, która dziedziczy po `Class.GuiObject`. Jest to
klasa bazowa dla `Class.ImageLabel` i `Class.TextLabel`. W przeciwieństwie do
`Class.GuiButton`, obiekty tego typu nie rejestrują zdarzeń kliknięć, ale
służą jako nieinteraktywne etykiety. Nie implementuje żadnych dalszych
właściwości, zdarzeń ani metod.


GuiLabel

Abstrakcyjna klasa dla nieinteraktywnych 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), takie jak `Class.GuiObject.Size|Size` oraz `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` i `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 stylizować je poza ich właściwościami podstawowymi dzięki [modifikatorom wyglądu](/ui/appearance-modifiers).

Chociaż możliwe jest wykrywanie zdarzeń przyciśnięcia przycisku myszy na dowolnym obiekcie GUI za pomocą `Class.GuiObject.InputBegan|InputBegan` oraz `Class.GuiObject.InputEnded|InputEnded`, tylko `Class.ImageButton` i `Class.TextButton` mają wygodne, dedykowane zdarzenia, takie jak `Class.TextButton.Activated|Activated`, które wykrywają 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 wyzwalane jest, gdy gracz zaczyna przeciągać obiekt.

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


GuiObject.DragBegin

initialPosition

Wartość `Datatype.UDim2` określająca położenie `Class.GuiObject` przed rozpoczęciem operacji przeciągania.


Wyzwalane, 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 wyzwalane 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.


Wyzwalane, 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 wyzwalane jest, gdy użytkownik zaczyna interagować z `Class.GuiObject` za pomocą urządzenia interfejsu człowiek-komputer (naciśnięcie przycisku myszy, rozpoczęcie dotyku, naciśnięcie przycisku na klawiaturze itp).

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

To zdarzenie zawsze będzie wyzwalane niezależnie od stanu gry.

Zobacz także `Class.GuiObject.InputEnded` oraz `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`.


Wyzwalane, gdy użytkownik zaczyna interagować za pomocą urządzenia interfejsu człowiek-komputer (naciśnięcie przycisku myszy, rozpoczęcie dotyku, naciśnięcie przycisku na klawiaturze itp).


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 wyzwalane jest, gdy użytkownik zmienia sposób interakcji za pomocą urządzenia interfejsu człowiek-komputer (naciśnięcie przycisku myszy, rozpoczęcie dotyku, naciśnięcie przycisku na klawiaturze itp).

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

To zdarzenie zawsze będzie wyzwalane niezależnie od stanu gry.

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


GuiObject.InputChanged

Wyzwalane, gdy użytkownik zmienia sposób interakcji za pomocą urządzenia interfejsu człowiek-komputer (naciśnięcie przycisku myszy, rozpoczęcie dotyku, naciśnięcie przycisku na klawiaturze itp).


Poniższy przykład demonstruje jeden z wielu przykładów użycia obsługi wejścia od użytkownika
input 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 wyzwala się, gdy użytkownik przestaje interagować za pomocą urządzenia interfejsu człowiek-komputer (naciśnięcie przycisku myszy, rozpoczęcie dotyku, naciśnięcie przycisku na klawiaturze itp).

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

To zdarzenie zawsze będzie wyzwalane niezależnie od stanu gry.

Zobacz także `Class.GuiObject.InputBegan` oraz `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`.


Wyzwalane, gdy użytkownik przestaje interagować za pomocą urządzenia interfejsu człowiek-komputer (naciśnięcie przycisku myszy, rozpoczęcie dotyku, naciśnięcie przycisku na klawiaturze itp).


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

Zdarzenie MouseEnter uruchamia się, gdy użytkownik przesuwa myszkę w elemencie
`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 w
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 dlatego,
że współrzędne wskazują pozycję myszy w momencie wywołania zdarzenia, a nie w
dokładnym momencie, gdy mysz wchodzi do GUI.

To zdarzenie uruchamia się 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
grodu ekranu.


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


Wyzwalane, gdy użytkownik przesuwa mysz w element GUI.


Zdarzenie MouseLeave uruchamia się, gdy użytkownik przesuwa myszkę z
`Class.GuiObject` elementu.

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 dlatego,
że współrzędne wskazują pozycję myszy w momencie wywołania zdarzenia, a nie w
dokładnym momencie, gdy mysz opuszcza GUI.

To zdarzenie uruchamia się 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

Uruchamia się, gdy użytkownik przesuwa myszkę z elementu GUI.


Uruchamia się, gdy użytkownik przesuwa myszkę, gdy znajduje się wewnątrz
`Class.GuiObject` elementu. Jest podobne do `Class.Mouse.Move`, które uruchamia
się niezależnie od tego, czy mysz użytkownika jest nad elementem GUI.

Uwaga, to zdarzenie uruchamia się, gdy pozycja myszy jest aktualizowana, dlatego
będzie uruchamiać się wielokrotnie podczas ruchu.

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

Poniższy kod ilustruje, jak określić przesunięcie `Datatype.Vector2`
myszy użytkownika względem 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)
```
Uwaga, że to zdarzenie może nie uruchamiać się dokładnie wtedy, 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

Uruchamia się, gdy użytkownik przesuwa myszkę, gdy znajduje się wewnątrz elementu GUI.


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

To zdarzenie uruchamia się jedynie jako wskaźnik ruchu wstecznego kółka.
To oznacza, że argumenty współrzędnych myszy `x` i `y` nie zmieniają się
w wyniku tego zdarzenia. Te współrzędne zmieniają się jedynie, gdy mysz
się porusza, co może być śledzone przez zdarzenie `Class.GuiObject.MouseMoved`.

##### Zobacz także

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


GuiObject.MouseWheelBackward

Uruchamia się, gdy użytkownik przewija kółko myszy wstecz, gdy mysz jest nad
elementem GUI.


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

To zdarzenie uruchamia się jedynie jako wskaźnik ruchu do przodu kółka.
To oznacza, że argumenty współrzędnych myszy **X** i **Y** nie zmieniają się
w wyniku tego zdarzenia. Te współrzędne zmieniają się jedynie, gdy mysz
się porusza, co może być śledzone przez zdarzenie `Class.GuiObject.MouseMoved`.

##### Zobacz także

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


GuiObject.MouseWheelForward

Współrzędna **Y** myszy użytkownika.


Uruchamia się, 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 uruchamia się, gdy selektor Gamepad zaczyna koncentrować się na
`Class.GuiObject`.

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

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


GuiObject.SelectionGained

Uruchamia się, gdy GuiObject jest włączony przy użyciu selektora Gamepad.


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 uruchamia się, gdy selektor Gamepad przestaje koncentrować się na
`Class.GuiObject`.

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

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


GuiObject.SelectionLost

Uruchamia się, gdy selektor Gamepad przestaje koncentrować się na 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 na urządzeniu dotykowym. Uruchamia się z tabelą
`Datatype.Vector2`, która opisuje względne pozycje ekranu palców
zaangażowanych w gest. Ponadto uruchamia się wielokrotnie:
`Enum.UserInputState.Begin` po krótkim opóźnieniu,
`Enum.UserInputState.Change`, jeśli gracz porusza palcem podczas gestu,
 i w końcu `Enum.UserInputState.End`. Opóźnienie zależy od platformy;
w Studio jest nieco dłuższe niż sekundę.

Ponieważ to zdarzenie wymaga tylko jednego palca, można je zasymulować w
Studio, używając emulatora i myszki.


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 uruchamia się raz na początku gestu (po krótkim
  opóźnieniu)
- Change uruchamia się, jeśli gracz porusza palcem, trzymając go
- End uruchamia się raz na końcu gestu, gdy zwolni palec.


Uruchamia się, 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 przesuwa palcem po elemencie UI
używając urządzenia dotykowego. Uruchamia się tuż przed
`Class.GuiObject.TouchSwipe`, a nie uruchamia się z
`Class.GuiObject.TouchTap`. To zdarzenie jest przydatne, aby pozwolić
graczowi na manipulowanie 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. Ponadto uruchamia się
wielokrotnie: `Enum.UserInputState.Begin` po krótkim opóźnieniu,
`Enum.UserInputState.Change`, gdy gracz porusza palcem podczas gestu,
i w końcu z `Enum.UserInputState.End`.

To zdarzenie nie może być symulowane w Studio przy użyciu emulatora i
myszki; musisz mieć prawdziwe urządzenie dotykowe, aby je uruchomić.


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 przesunięcia przesunął się od punktu startowego.


velocity

Wskazuje, jak szybko wykonuje się gest w każdym
dimension.


Uruchamia się, gdy gracz przesuwa palcem po elemencie 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
gest ściskania lub ciągnięcia na elemencie UI używając urządzenia dotykowego. **Ściskanie**
ma miejsce, gdy dwa lub więcej palców przesuwają się bliżej siebie, a **ciągnięcie**
dzieje się, gdy się oddalają. To zdarzenie uruchamia się w połączeniu z
`Class.GuiObject.TouchPan`. To zdarzenie jest przydatne, aby pozwolić graczowi
na manipulowanie skalą (rozmiarem) elementów UI na ekranie i najczęściej
jest używane do powiększeń.

To zdarzenie uruchamia się z tabelą `Datatype.Vector2`, która opisuje
względne pozycje ekranu palców zaangażowanych w gest. Ponadto uruchamia się
wielokrotnie: `Enum.UserInputState.Begin` po krótkim opóźnieniu,
`Enum.UserInputState.Change`, gdy gracz porusza palcem
podczas gestu, i w końcu z `Enum.UserInputState.End`. Należy
zauważyć, że skala powinna być używana **multiplikatywnie**.

Ponieważ to zdarzenie wymaga przynajmniej dwóch palców, nie można
jego symulować w Studio przy użyciu emulatora i myszki; musisz mieć prawdziwe
dotykowe urządzenie.


GuiObject.TouchPinch

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


scale

Float wskazujący różnicę od początku gestu ściskania.


Float wskazujący, jak szybko zachodzi gest ściskania.


Uruchamia się, gdy gracz wykonuje gest ściskania lub ciągnięcia używając dwóch
gestów na elemencie UI.


Ten przykład kodu jest przeznaczony dla `LocalScript` w wewnętrznym `Frame`, który znajduje się w zewnętrznym `Frame` lub innym `GuiObject`. Umożliwia to 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
gest rotacji na elemencie UI używając urządzenia dotykowego. Rotacja występuje,
gdy kąt linii między dwoma palcami zmienia się. To zdarzenie uruchamia
się w połączeniu z `Class.GuiObject.TouchPan`. To zdarzenie jest przydatne,
aby pozwolić graczowi manipulować rotacją elementów UI na ekranie.

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

Ponieważ to zdarzenie wymaga przynajmniej dwóch palców, nie można być
symulowane w Studio przy użyciu emulatora i myszki; musisz mieć prawdziwe
dotykowe urządzenie.


GuiObject.TouchRotate

rotation

Float wskazujący, jak bardzo rotacja przesunęła się od początku
gestu.


Float wskazujący, jak szybko gest jest wykonywany.


Uruchamia się, gdy gracz wykonuje gest rotacji używając dwóch palców 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 uruchamia się, gdy gracz wykonuje gest przesunięcia na elemencie
UI używając urządzenia dotykowego. Uruchamia się z kierunkiem gestu
(W górę, W dół, W lewo lub W prawo) oraz liczbą punktów dotykowych
zaangażowanych w gest. Gesty przesunięcia są często używane do zmiany
tabów w mobilnych interfejsach użytkownika.

Ponieważ to zdarzenie wymaga tylko jednego palca, można je zasymulować w
Studio, używając emulatora i myszki.


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


Uruchamia 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 uruchamia się, gdy gracz wykonuje gest stukania na elemencie
UI używając urządzenia dotykowego. Stukanie to szybki, pojedynczy dotyk bez
jakiegokolwiek ruchu (dłuższe naciśnięcie uruchomiłoby
`Class.GuiObject.TouchLongPress`, a ruch podczas dotyku uruchomiłby
`Class.GuiObject.TouchPan` i/lub `Class.GuiObject.TouchSwipe`). Uruchamia
się z tabelą obiektów `Datatype.Vector2`, które opisują względne
pozycje zaangażowanych w gest palców.

Ponieważ to zdarzenie wymaga tylko jednego palca, można je zasymulować w
Studio, używając emulatora i myszki.


GuiObject.TouchTap

Uruchamia 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/odwołuje, definiując funkcję zwrotną. Również
drukuje, czy tween będzie odtwarzany.

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

Funkcja ta zwróci, czy tween zostanie odtworzony. Nie odtworzy się, jeśli inny tween działa na `Class.GuiObject`, a parametr nadpisania wynosi `false`.

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


GuiObject:TweenPosition

endPosition

easingDirection

Kierunek, w którym należy wyhamować GUI do _endPosition_.


easingStyle

Styl, w jaki należy wyhamować GUI do _endPosition_.


time

Jak długo, w sekundach, powinien zająć tween do ukończenia.


override

callback

Funkcja zwrotna, do wykonania, gdy tween się zakończy.


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` oraz `Enum.EasingStyle`.

Funkcja ta zwróci, czy tween zostanie odtworzony. Zwykle zawsze zwróci `true`, ale zwróci `false`, jeśli inny tween jest aktywny, a nadpisanie jest ustawione na `false`.

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


GuiObject:TweenSize

endSize

Rozmiar, na jaki GUI powinno zmienić rozmiar.


Kierunek, w którym należy wyhamować GUI do _endSize_.


Styl, w jaki należy wyhamować 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 przesuwa GUI do nowego rozmiaru oraz pozycji `Datatype.UDim2` w określonym czasie, używając określonego `Enum.EasingDirection` oraz `Enum.EasingStyle`.

Funkcja ta zwróci, czy tween zostanie odtworzony. Zwykle zawsze zwróci `true`, ale zwróci `false`, jeśli inny tween jest aktywny, a nadpisanie jest ustawione na `false`.

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


GuiObject:TweenSizeAndPosition

Płynnie przesuwa i zmienia rozmiar GUI do nowego rozmiaru oraz pozycji.


GuiObject

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