Poniższy kod demonstruje, jak obiekt PluginMouse można uzyskać i
używać w wtyczce. Aby użyć tego kodu, wklej go do `Skryptu`, zapisz ten skrypt
w lokalnym folderze Wtyczek, używając kliknięcia prawym przyciskiem, zapisz do pliku. Folder
wtyczek można znaleźć na karcie Wtyczki w pasku narzędzi Roblox Studio.

Obiekt PluginMouse daje `Class.Plugin|Plugins` dostęp do myszy. Działa jak obiekt `Class.Mouse` i można go uzyskać używając metody pluginu `Class.Plugin:GetMouse()`.

Zauważ, że PluginMouse może być używany tylko wtedy, gdy plugin został aktywowany za pomocą `Class.Plugin:Activate()`.

Oprócz funkcji z obiektu `Class.Mouse`, PluginMouse zawiera funkcję `Class.PluginMouse.DragEnter`, która śledzi elementy wybierane podczas przeciągania myszy.

Aby uzyskać więcej informacji na temat korzystania z obiektów myszy, zobacz stronę `Class.Mouse`.


Wywoływane, gdy elementy są wybierane podczas przeciągania myszy.


PluginMouse.DragEnter

instances

PluginMouse

Obiekt PluginMouse daje `Class.Plugin|Plugins` dostęp do myszy. Działa jak obiekt `Class.Mouse` i można go uzyskać używając metody pluginu `Class.Plugin:GetMouse()`.


**Mysz** została zastąpiona przez `Class.UserInputService` i
`Class.ContextActionService`, które obejmują szerszy zakres, są bardziej funkcjonalne
oraz lepiej wspierają wzorce **wieloplatformowe**. Nadal jest wspierana
ze względu na jej powszechne użycie, ale powinieneś mocno rozważyć korzystanie z tych
alternatyw.

Obiekt **Mysz** zawiera różne API dla wskaźników, głównie dla przycisków
oraz rzutowania promieni. Można go uzyskać przez `Class.Player:GetMouse()` zwracane przez
`Class.Players.LocalPlayer` w `Class.LocalScript`. Jest również przekazywane przez
to wydarzenie `Class.Tool.Equipped`.

- Najbardziej znana jest z właściwości `Class.Mouse.Icon|Icon`, która zmienia
  wygląd kursora.
- Nieustannie rzutuje pozycję myszy na ekranie w świat 3D za pomocą
  właściwości `Class.Mouse.TargetFilter|TargetFilter`, przechowując wyniki rzutowania
  w właściwościach `Class.Mouse.Hit|Hit`, `Class.Mouse.Target|Target` i
  `Class.Mouse.TargetSurface|TargetSurface`. Mogą być one przydatne
  w prostych przypadkach, ale w bardziej skomplikowanych
  scenariuszach [rzutowania](/workspace/raycasting) należy używać `Class.WorldRoot:Raycast()`.
- `Class.Plugin|Plugins` mogą używać `Class.Plugin:GetMouse()` do uzyskania
  `Class.PluginMouse`, które zachowują się podobnie.

```lua
-- Z LocalScript:
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local mouse = player:GetMouse()
-- Ustawianie ikony myszy
mouse.Icon = "rbxasset://SystemCursors/Wait"
```
Uwaga:

- Obiekt ten nie kontroluje/ogranicza ruchu wskaźnika. W tym celu zobacz
  `Class.UserInputService.MouseBehavior` i
  `Class.UserInputService.MouseDeltaSensitivity`.
- Jeśli dwie funkcje są podłączone do tego samego zdarzenia wejścia, takiego jak
  `Class.Mouse.Button1Down|Button1Down`, **obie** funkcje zostaną uruchomione, gdy
  wydarzenie zostanie wyzwolone. Nie ma pojęcia zatapiania/przekazywania wejścia,
  ponieważ zdarzenia nie wspierają tego zachowania. Jednak `Class.ContextActionService` ma
  takie zachowanie za pomocą `Class.ContextActionService:BindAction()|BindAction`.
- Chociaż mysz może nie być dostępna na wszystkich platformach, Mysz
  będzie funkcjonować na platformach mobilnych (dotyk) i konsolach (gamepad), które
  zazwyczaj nie mają myszy ani sprzętu wskaźnika. Dla wyraźnych mikrostosunków
  użyj `Class.UserInputService` i `Class.ContextActionService`.

Zobacz [Wejście i kamera](/input) po więcej informacji o
personalizacji wejść w twoim doświadczeniu.

To wydarzenie wyzwalane jest, gdy gracz naciska lewy przycisk myszy. Uwaga,
że można do niego uzyskać dostęp z `Class.Tool`; na przykład, gdy umieszczono w
`Class.LocalScript`, poniższy kod drukuje `Button1Down`, gdy tylko lewy
przycisk myszy jest naciśnięty.

```lua
local tool = script.Parent  -- Upewnij się, że to jest obiekt Tool

tool.Equipped:Connect(function(mouse)
	mouse.Button1Down:Connect(function()
		print("Button1Down")
	end)
end)
```
Możesz dowiedzieć się o pozycji myszy w przestrzeni świata i czy wskazuje na jakąkolwiek
`Class.BasePart` używając właściwości `Class.Mouse.Hit|Hit` i
`Class.Mouse.Target|Target`.

Mouse.Button1Down

Wyzwalane, gdy lewy przycisk myszy jest naciśnięty.

To wydarzenie wyzwalane jest, gdy gracz puszcza lewy przycisk myszy. Uwaga,
że można do niego uzyskać dostęp z `Class.Tool`; na przykład, gdy umieszczono w
`Class.LocalScript`, poniższy kod drukuje `Button1Up`, gdy tylko lewy
przycisk myszy jest puszczany.

```lua
local tool = script.Parent  -- Upewnij się, że to jest obiekt Tool

tool.Equipped:Connect(function(mouse)
	mouse.Button1Up:Connect(function()
		print("Button1Up")
	end)
end)
```
Możesz dowiedzieć się o pozycji myszy w przestrzeni świata i czy wskazuje na jakąkolwiek
`Class.BasePart` używając właściwości `Class.Mouse.Hit|Hit` i
`Class.Mouse.Target|Target`.

Mouse.Button1Up

Wyzwalane, gdy lewy przycisk myszy jest puszczany.

To wydarzenie wyzwalane jest, gdy gracz naciska prawy przycisk myszy. Uwaga,
że można do niego uzyskać dostęp z `Class.Tool`; na przykład, gdy umieszczono w
`Class.LocalScript`, poniższy kod drukuje `Button2Down`, gdy tylko prawy
przycisk myszy jest naciśnięty.

```lua
local tool = script.Parent  -- Upewnij się, że to jest obiekt Tool

tool.Equipped:Connect(function(mouse)
	mouse.Button2Down:Connect(function()
		print("Button2Down")
	end)
end)
```
Możesz dowiedzieć się o pozycji myszy w przestrzeni świata i czy wskazuje na jakąkolwiek
`Class.BasePart` używając właściwości `Class.Mouse.Hit|Hit` i
`Class.Mouse.Target|Target`.

Mouse.Button2Down

Wyzwalane, gdy prawy przycisk myszy jest naciśnięty.

To wydarzenie wyzwalane jest, gdy gracz puszcza prawy przycisk myszy. Uwaga,
że można do niego uzyskać dostęp z `Class.Tool`; na przykład, gdy umieszczono w
`Class.LocalScript`, poniższy kod drukuje `Button2Up`, gdy tylko prawy
przycisk myszy jest puszczany.

```lua
local tool = script.Parent  -- Upewnij się, że to jest obiekt Tool

tool.Equipped:Connect(function(mouse)
	mouse.Button2Up:Connect(function()
		print("Button2Up")
	end)
end)
```
Możesz dowiedzieć się o pozycji myszy w przestrzeni świata i czy wskazuje na jakąkolwiek
`Class.BasePart` używając właściwości `Class.Mouse.Hit|Hit` i
`Class.Mouse.Target|Target`.

Mouse.Button2Up

Wyzwalane, gdy prawy przycisk myszy jest puszczany.

Ten przykład ilustruje, jak zdarzenia myszy są przekazywane w każdej klatce

Wyzwalane w każdej klatce, gdy mysz nie jest przekazywana do innego
wydarzenia myszy.

Uwaga, to wydarzenie nie powinno być używane do określenia, kiedy mysz
jest nieruchoma. Ponieważ wyzwala się przy każdym bicie, będziesz
go wyzwalać między wydarzeniami `Class.Mouse.Move`.

Aby uzyskać więcej informacji o tym, jak uzyskać obiekt `Class.Mouse`, zobacz
stronę `Class.Mouse`.

Deweloperzy mogą dowiedzieć się o pozycji myszy w świecie i czy
wskazuje na jakąkolwiek `Class.BasePart` używając właściwości `Class.Mouse.Hit`
i `Class.Mouse.Target`.

Uwaga, deweloperzy są zachęcani do używania `Class.UserInputService`
zamiast obiektu `Class.Mouse` w nowej pracy.

Mouse.Idle

Wyzwalane w każdej klatce, gdy mysz nie jest przekazywana do innego
wydarzenia myszy.

Poniższy przykład, zakładając, że 'mouse' zostało zdefiniowane, wydrukuje klawisz, który
został naciśnięty (np. "q") wraz z wartością ascii dla tego klawisza (np. 113).


To wydarzenie wyzwalane jest, gdy klawisz jest naciśnięty, a przekazanym argumentem jest
naciśnięty klawisz.

Uwaga:

- Nie wszystkie klawisze generują to wydarzenie. Możesz jednak
  obejść to dla niektórych klawiszy, takich jak "/", używając zdarzenia
  `Class.Mouse.KeyUp`.
- Niektóre klawisze generują ten sam ciąg co inne klawisze.
- Możliwe jest, że ciąg będzie pusty (prawdopodobnie z powodu kodu klawisza "\\0").

Mouse.KeyDown

Wyzwalane, gdy klawisz jest naciśnięty.

Mouse.keyDown

Poniższy przykład, zakładając, że 'mouse' został zdefiniowany, wydrukuje klawisz, który
został zwolniony (np. "q") wraz z wartością ASCII dla tego klawisza (np. 113).


To zdarzenie jest wywoływane, gdy klawisz zostaje zwolniony, z przekazanym
argumentem będącym klawiszem, który został zwolniony.

Uwaga:

- Nie wszystkie klawisze generują to zdarzenie. Możesz jednak wprowadzić
  to w związku z niektórymi klawiszami, np. "/", używając
  [[API:Class/Mouse/KeyUp|KeyUp]] zdarzenia.
- Niektóre klawisze generują ten sam ciąg znaków co inne klawisze.
- Możliwe jest, że ciąg może być pusty (prawdopodobnie z powodu "\\0" kodu
  klawisza).


Mouse.KeyUp

Wywoływane, gdy klawisz zostaje zwolniony.


Poniższy przykład pozwala `Class.Players.LocalPlayer|lokalnemu graczowi` na przesuwanie
części za pomocą ich myszy.

Gdy gracz naciśnie lewy przycisk myszy nad częścią, ta część staje się
`Class.Mouse.Target|celem myszy` i staje się _punktem_. Dopóki gracz
nie puści lewego przycisku myszy, ta część będzie przemieszczać się do
światowej pozycji myszy, kiedy gracz przesuwa swoją mysz.

Należy zauważyć, że właściwość `Class.Mouse.TargetFilter` pozwala kodowi na
ignorowanie części, która jest przesuwana, podczas określania światowej pozycji myszy.

Kod powinien działać zgodnie z oczekiwaniami, gdy zostanie umieszczony w `LocalScript`.

Wywoływane, gdy mysz jest przesuwana.

Uwaga, to zdarzenie jest wywoływane, gdy pozycja myszy jest aktualizowana,
zmiana więc będzie wywoływana wielokrotnie podczas ruchu.

Aby uzyskać informacje na temat uzyskiwania obiektu `Class.Mouse`, zobacz
stronę `Class.Mouse`.

Programiści mogą sprawdzić pozycję myszy w przestrzeni świata oraz
to, czy wskazuje na jakikolwiek `Class.BasePart`, używając właściwości
`Class.Mouse.Hit` i `Class.Mouse.Target`.

```
mouse.Move:Connect(function()
	local position = mouse.Hit.p
	local target = mouse.Target
	print(target, position)
end)
```
Uwaga, programiści są zalecani do używania `Class.UserInputService`
zamiast obiektu `Class.Mouse` w nowej pracy.


Mouse.Move

Poniższy przykład zakłada, że już uzyskałeś myszkę gracza (i
ustawiłeś ją jako zmienną o nazwie 'mouse'), czy to za pomocą `Class.Tool`,
`Class.HopperBin` czy metody `Class.Player:GetMouse()`. Wydrukuje
"Kółko poszło wstecz!" gdy gracz przewinie wstecz.

Zdarzenie WheelBackward wywoływane jest, gdy kółko myszy jest
przewijane do tyłu. Możliwe zastosowania tego zdarzenia obejmują
przełączanie celownika broni w grze pierwszoosobowej (FPS) lub
głębsze powiększenie kamery gracza.

Można go używać razem ze zdarzeniem przewijania do przodu,
`Class.Mouse.WheelForward`.

Aby uzyskać informacje na temat uzyskiwania obiektu `Class.Mouse`, zobacz
stronę `Class.Mouse`.

Uwaga, programiści są zalecani do używania `Class.UserInputService`
zamiast obiektu `Class.Mouse` w nowej pracy.


Mouse.WheelBackward

Wywoływane, gdy kółko myszy jest przewijane do tyłu.


Poniższy przykład zakłada, że już otrzymałeś mysz gracza (i
ustawiłeś ją jako zmienną o nazwie 'mouse'), czy to za pomocą `Narzędzia`, `HopperBin`
czy metody `Class.Player:GetMouse()`. Wydrukuje "Koło poszło do przodu!"
 kiedy gracz przewija do przodu.

Zdarzenie WheelForward wywoływane jest, gdy kółko myszy jest
przewijane do przodu. Możliwe zastosowania tego zdarzenia obejmują
przełączanie celownika broni w grze pierwszoosobowej (FPS) lub
głębsze powiększenie kamery gracza.

Można go używać razem ze zdarzeniem przewijania do tyłu,
`Class.Mouse.WheelBackward`.

Aby uzyskać informacje na temat uzyskiwania obiektu `Class.Mouse`, zobacz
stronę `Class.Mouse`.

Uwaga, programiści są zalecani do używania `Class.UserInputService`
zamiast obiektu `Class.Mouse` w nowej pracy.


Mouse.WheelForward

Wywoływane, gdy kółko myszy jest przewijane do przodu.


Mouse

Kod w tym przykładzie, umieszczony w `LocalScript` wewnątrz
`StarterPlayerScripts`, narysuje czerwony promień lasera pomiędzy głową postaci
 a `Class.Mouse.Hit` przez cały czas.

Uwaga, ten promień przechodzi bezpośrednio przez przeszkody w widoku trzeciej osoby, ponieważ
rzutowanie promienia `Mouse` jest realizowane z `Class.Workspace.CurrentCamera`, a nie z
głowy.

Kod poniżej wizualizuje różnicę między `Class.Mouse.Hit` a
`Class.Mouse.Origin`. Aby to zrobić, kod korzysta z
pozycji `Datatype.Vector3` trafienia i pochodzenia wartości `Datatype.CFrame`
za pomocą `.p`.

Różnica polega na tym, że pochodzenie to "skąd pochodzi mysz" (jego pochodzenie)
a trafienie to pozycja, w której mysz trafia (to jest moment, gdy gracz naciska
swoją mysz).

Ten przykład wizualizuje również, że pochodzenie myszy jest bardzo podobne do
pozycji `CurrentCamera`, drukując wielkość (odległość) między
obydwoma pozycjami.

Ta właściwość wskazuje `Datatype.CFrame` pozycji myszy w 3D
przestrzeni. Zauważ, że `Class.Mouse.TargetFilter` i jego potomcy będą
ignorowane.

Deweloperzy mogą uzyskać pozycję Hit w następujący sposób:

```
local position = mouse.Hit.Position
```
Hit jest często używane przez `Class.Tool|Tools` do wystrzelenia broni w kierunku myszy
w widoku trzeciej osoby.

Deweloperzy, którzy szukają `Class.BasePart`, na który wskazuje mysz,
powinni używać `Class.Mouse.Target`.

#### Jak obliczana jest Mouse.Hit?

Pozycja CFrame Hit jest obliczana jako punkt przecięcia
pomiędzy wewnętrzną `Datatype.Ray` myszy (rozszerzoną wersją
`Class.Mouse.UnitRay`) a obiektem w przestrzeni 3D (takim jak część).

Orientacja CFrame Hit odpowiada kierunkowi
`Class.Mouse.UnitRay`.

```
local unitRayDirection = mouse.UnitRay.Direction
local mouseHitDirection = mouse.Hit.lookVector
-- unitRayDirection ≈ mouseHitDirection
-- wektory są w przybliżeniu równe
```
Zauważ, że kąt widzenia `Class.Workspace.CurrentCamera` nie jest używany
przy obliczaniu orientacji CFrame Hit.

Wewnętrzny promień myszy rozciąga się na 1000 studów. Jeśli mysz nie jest
wskazywana na obiekt w przestrzeni 3D (na przykład, gdy celuje w niebo),
właściwość ta będzie wynosić 1000 studów od
`Class.Workspace.CurrentCamera`.

Mouse.Hit

`Datatype.CFrame` pozycji myszy w przestrzeni 3D.

Mouse.hit

Ten przykład zmienia ikonę myszy `Class.Players.LocalPlayer`, aby przypominała obrazek
dragon.


**Ikona** to właściwość, która określa obraz używany jako wskaźnik. Jeśli
jest pusta, używana jest domyślna strzałka. Gdy kursor znajduje się nad
`Class.GuiButton`, ta właściwość jest tymczasowo ignorowana. Ta właściwość
obsługuje tylko URI zasobów.

Aby całkowicie ukryć kursor, **nie** używaj przezroczystego obrazu –
 zamiast tego ustaw `Class.UserInputService.MouseIconEnabled` na fałsz.

Aby uzyskać/ustawić ikonę myszy w doświadczeniach, powinieneś używać
`Class.UserInputService.MouseIcon`. `Class.Mouse.Icon` zostanie przestarzałe
po wydaniu nowego API dla wtyczek do ustawienia kursora myszy.

##### Projektowanie kursora

Poniższe wytyczne mogą okazać się przydatne przy tworzeniu własnych
kursorów myszy:

- Wymiary używanego obrazu określają rozmiar kursora.
- Wymiary obrazu nie powinny przekraczać 256 pikseli na żadnej osi.
- **Środek** obrazu to miejsce, w którym wydawane są wejścia myszy.
- Domyślny obraz myszy ma 64x64 piksele, przy czym sama mysz zajmuje 17x24
  pikseli.

##### Kursory systemowe

Podczas korzystania z `Class.PluginMouse` uzyskanego z `Class.Plugin:GetMouse()`,
mogą być używane następujące ikony w podobny sposób do domyślnych kursów
systemu, takich jak ręce, strzałki, belki I itp. Można je używać z wydarzeniami GUI
jak `Class.GuiObject.MouseEnter|MouseEnter`,
`Class.GuiObject.MouseLeave|MouseLeave`, i
`Class.GuiButton.MouseButton1Down|MouseButton1Down`, aby zapewnić
jednolite doświadczenie Studio podczas interakcji z niektórymi rodzajami komponentów GUI.
Należy pamiętać, że działają one tylko dla wtyczek Studio; nie będą działać dla
innych obiektów `Class.Mouse`.

<table>
    <thead>
        <tr>
            <th>Wygląd*</th>
            <th>Aset</th>
            <th>Zalecane użycie</th>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-Pointer.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/Arrow</code></td>
            <td>Domyślne klikanie i wybór.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-PointingHand.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/PointingHand</code></td>
            <td>Unoszenie nad aktywnym linkiem/przyciskem.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-OpenHand.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/OpenHand</code></td>
            <td>Unoszenie nad przeciągalnym elementem.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-GrabbingHand.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/ClosedHand</code></td>
            <td>Przeciąganie elementu.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-IBeam.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/IBeam</code></td>
            <td>Unoszenie nad polem tekstowym.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-ResizeNS.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/SizeNS</code></td>
            <td>Unoszenie nad pionowym uchwytem zmiany rozmiaru.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-ResizeEW.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/SizeEW</code></td>
            <td>Unoszenie nad poziomym uchwytem zmiany rozmiaru.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-ResizeNESW.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/SizeNESW</code></td>
            <td>Unoszenie nad uchwytem zmiany rozmiaru w rogu.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-ResizeNWSE.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/SizeNWSE</code></td>
            <td>Unoszenie nad uchwytem zmiany rozmiaru w rogu.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-ResizeAll.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/SizeAll</code></td>
            <td>Unoszenie nad uchwytem zmiany rozmiaru w wielu kierunkach.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-ResizeSplitV.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/SplitNS</code></td>
            <td>Unoszenie nad pionowym uchwytem "podziału".</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-ResizeSplitH.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/SplitEW</code></td>
            <td>Unoszenie nad poziomym uchwytem "podziału".</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-Forbidden.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/Forbidden</code></td>
            <td>Unoszenie nad zablokowanym/zabronionym elementem.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-Wait.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/Wait</code></td>
            <td>Wskazywanie, że akcja jest w toku.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-Busy.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/Busy</code></td>
            <td>Wskazywanie, że system jest zajęty.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-Crosshair.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/Cross</code></td>
            <td>Unoszenie nad obszarem punktowego wyboru.</td>
        </tr>
    </tbody>
</table>

<figcaption>* Te wyglądy są przybliżeniami – rzeczywisty wygląd zależy od twojego systemu operacyjnego.</figcaption>

Mouse.Icon

ID zawartości obrazu używanego jako ikona `Class.Mouse`.


Właściwość Origin `Class.Mouse` to `Datatype.CFrame` wskazująca, gdzie
tak naprawdę znajduje się mysz. Jest umiejscowiona w `Class.Workspace.CurrentCamera` i
ukierunkowana w stronę pozycji 3D myszy.

`Class.Mouse.UnitRay` rozpoczyna się z tej samej pozycji co Origin i rozciąga
się na 1 studa w tym samym kierunku.

```lua
local unitRay = mouse.UnitRay
local origin = mouse.Origin
-- unitRay.Direction = origin.p
-- unitRay.Direction ≈ origin.lookVector
```
Aby uzyskać pozycję `Class.Mouse` w przestrzeni 3D, zobacz `Class.Mouse.Hit`.

Mouse.IconContent

Zawartość obrazu używanego jako ikona `Class.Mouse`. Obsługuje tylko
URI zasobów.


Początkowa właściwość `Class.Mouse` to `Datatype.CFrame`, która wskazuje,
dokąd skierowana jest mysz. Jest umiejscowiona w
`Class.Workspace.CurrentCamera` i ukierunkowana w stronę 3D
pozycji myszy.

`Class.Mouse.UnitRay` zaczyna się w tej samej pozycji co Origin i przedłuża
się o stud w tym samym kierunku.

```lua
local unitRay = mouse.UnitRay
local origin = mouse.Origin
-- unitRay.Direction = origin.p
-- unitRay.Direction ≈ origin.lookVector
```
Aby poznać pozycję `Class.Mouse` w 3D, zobacz `Class.Mouse.Hit`.


Mouse.Origin

Część `Datatype.CFrame` umiejscowiona w `Class.Workspace.CurrentCamera` i
ukierunkowana w stronę 3D pozycji myszy.


Gdy znajduje się w `LocalScript` w `StarterPlayerScripts`, poniższy kod
zmienia `Class.BasePart.BrickColor` każdego `BasePart`, na który gracz kliknie,
na przykład lokalizację spawnu lub podstawę.


Obiekt w przestrzeni 3D, na który wskazuje `Class.Mouse|mouse`.

Uwaga:

- Jeśli `Class.Mouse.TargetFilter` został ustawiony, filtr docelowy i jego
  potomstwo będą ignorowane.
- Gdy mysz nie wskazuje na `Class.BasePart`, na przykład gdy
  wskazuje na niebo, Target będzie `nil`.
- Programiści szukający pozycji myszy w przestrzeni 3D powinni używać
  `Class.Mouse.Hit`.


Mouse.Target

Obiekt w przestrzeni 3D, na który wskazuje `Class.Mouse|mouse`.


Mouse.target

Ta właściwość określa obiekt, który ma być ignorowany przez mysz przy
obliczaniu `Class.Mouse.Hit` i `Class.Mouse.Target`. Potomstwo
obiektu jest również ignorowane, więc możliwe jest zignorowanie wielu
obiektów, o ile są one potomkami obiektu, do którego ta właściwość jest
ustawiona. Ta właściwość jest przydatna przy filtrowaniu modeli zawierających
specjalne efekty lub dekoracje, które nie powinny wpływać na `Class.Mouse.Hit` lub
`Class.Mouse.Target`.

Ta właściwość może być ustawiona na dowolny `Class.Instance` lub `nil`, na
przykład:

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

local player = Players.LocalPlayer
local mouse = player:GetMouse()
mouse.TargetFilter = Workspace.Model
```
Należy pamiętać, że `Class.Player.Character|Character` lokalnego
`Class.Players.LocalPlayer` jest automatycznie ignorowane przez mysz.


Mouse.TargetFilter

Określa obiekt (i jego potomstwo), który powinien być ignorowany podczas
określania `Class.Mouse.Hit` i `Class.Mouse.Target`.


Kod w tym przykładzie, gdy umieszczony w `LocalScript` wewnątrz
`StarterPlayerScripts`, ustawi powieżchnię dowolnego `BasePart`, na który klikniesz,
na losową powieżchnię.

Ta właściwość wskazuje na `Enum.NormalId` powierzchni `Class.BasePart`,
na którą wskazuje mysz. Ta właściwość jest pochodną
pozycji świata myszy (`Class.Mouse.Hit`) i części, w którą
wskazuje mysz (`Class.Mouse.Target`).

Ta właściwość nie ma sensu, gdy mysz nie wskazuje na część,
np. gdy mysz wskazuje na niebo. W tym momencie, ta
właściwość jest ustawiona na 'Right' w takich okolicznościach. Przed użyciem
tej właściwości upewnij się, że cel myszy nie jest `nil`.

```lua
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local mouse = player:GetMouse()
-- Sprawdź, czy istnieje część, na którą wskazuje mysz
if mouse.Target then
	print("Mysz wskazuje na " .. mouse.TargetSurface.Name .. " stronę " .. mouse.Target.Name)
else
	print("Mysz nie wskazuje na nic.")
end
```


Mouse.TargetSurface

Wskazuje na `Enum.NormalId` powierzchni `Class.BasePart`, na którą
wskazuje mysz.


Właściwość UnitRay to `Datatype.Ray` skierowany w stronę pozycji myszy
w przestrzeni 3D (opisaną przez `Class.Mouse.Hit`). Pochodzi z
`Class.Camera.CFrame|CFrame` `Class.Workspace.CurrentCamera`.
Jak wszystkie promienie jednostkowe, ma odległość 1.

```lua
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local mouse = player:GetMouse()
print(mouse.UnitRay.Direction.Magnitude) -- Zawsze 1
```


Mouse.UnitRay

`Datatype.Ray` ukierunkowany na światową pozycję myszy, pochodzący
z pozycji świata `Class.Workspace.CurrentCamera`.


Ten przykład kodu pokazuje, jak można stworzyć `Datatype.Vector2` reprezentujący
pozycję obiektu `Mouse` na ekranie (`Class.Mouse.X|X()` oraz
`Class.Mouse.Y|Y()`) oraz rozmiar samego ekranu
(`Class.Mouse.ViewSizeX|ViewSizeX()` oraz `Class.Mouse.ViewSizeY|ViewSizeY()`).
Korzystając z tych informacji, można znormalizować pozycję kursora na ekranie tak, że
lewy górny róg tuż pod paskiem narzędzi odpowiada (0, 0), a prawy dolny róg odpowiada
(1, 1). Ta znormalizowana pozycja jest obliczana i drukowana podczas ruchu kursora
za pomocą zdarzenia `Class.Mouse.Move|Move()`.

Właściwość ViewSizeX opisuje poziomą składową rozmiaru okna gry w
pikselach.


Mouse.ViewSizeX

Opisuje szerokość okna gry w pikselach.


Właściwość ViewSizeY opisuje pionową składową rozmiaru okna gry w
pikselach. Ta długość obejmuje przestrzeń zajmowaną przez
pasek narzędzi.


Mouse.ViewSizeY

Opisuje wysokość okna gry w pikselach.


W przypadku wykrywania zmian w pozycji myszy na ekranie,
zaleca się użycie `Class.ContextActionService:BindAction()` z
`Enum.UserInputType.MouseMovement` lub
`Class.UserInputService.InputChanged`, które opisują pozycję myszy
przy użyciu `Class.InputObject.Position|Position` (a
`Datatype.Vector3`) obiektu `Class.InputObject`, zamiast używać tej i
pokrewnych właściwości.

Właściwość X opisuje poziomą składową pozycji myszy
na ekranie. Pozycja jest mierzona w pikselach w stosunku do lewego górnego
rogu, pod paskiem narzędzi. Ta właściwość może być używana w połączeniu z
`Class.Mouse.Y`, aby uzyskać `Datatype.Vector2` reprezentujący pozycję myszy:

```lua
local position = Vector2.new(mouse.X, mouse.Y)
```
Ta właściwość nie uruchamia `Class.Object.Changed|Changed` ani sygnału
zwróconego z
`Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal`. Użyj
eventu `Class.Mouse.Move` zamiast tego.


Mouse.X

Opisuje komponent X (poziomy) pozycji myszy na ekranie.


W przypadku wykrywania zmian w pozycji myszy na ekranie,
zaleca się użycie `Class.ContextActionService:BindAction()` z
`Enum.UserInputType.MouseMovement` lub
`Class.UserInputService.InputChanged`, które opisują pozycję myszy
przy użyciu `Class.InputObject.Position|Position` (a
`Datatype.Vector3`) obiektu `Class.InputObject`, zamiast używać tej i
pokrewnych właściwości.

Właściwość Y opisuje pionową składową pozycji myszy na
ekranie. Pozycja jest mierzona w pikselach w stosunku do lewego górnego
rogu, pod paskiem narzędzi. Ta właściwość może być używana w połączeniu z
`Class.Mouse.X`, aby uzyskać `Datatype.Vector2` reprezentujący pozycję myszy:

```lua
local position = Vector2.new(mouse.X, mouse.Y)
```
Ta właściwość nie uruchamia `Class.Object.Changed|Changed` ani sygnału
zwróconego z
`Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal`. Użyj
eventu `Class.Mouse.Move` zamiast tego.


Mouse.Y

Opisuje komponent Y (pionowy) pozycji myszy na ekranie.


Obiekt przestarzały, który zawiera członków przydatnych do wejścia za pomocą wskaźnika.

`Instance` jest klasą bazową dla wszystkich klas w hierarchii klas Roblox,
które mogą być częścią drzewa `Class.DataModel`.

Nie jest możliwe bezpośrednie tworzenie obiektów `Instance` jako korzenia, ale specjalny
konstruktor `Datatype.Instance.new()` tworzy obiekty za pomocą kodu, biorąc
nazwę klasy jako parametr i zwracając stworzony obiekt.

Demonstruje wykrywanie zmian w przodkach instancji przez podłączenie do
`Class.Instance.AncestryChanged` event.

Rodzic ChangingPart jest ustawiany na różne wartości w czasie. Rodzicem
tej części jest przodek części, więc event `Class.Instance.AncestryChanged`
wyzwoli się za każdym razem, gdy się zmieni.


Wyzwala się, gdy ta instancja zmienia rodzica lub gdy zmienia się
rodzic jakiegokolwiek z jej przodków.

Możesz użyć tego zdarzenia, aby śledzić usunięcie instancji w Studio,
najlepiej ręczne usunięcie w Eksploratorze lub przez wtyczkę. Jeśli musisz
wykrywać, kiedy instancja zostaje zniszczona za pomocą `Class.Instance:Destroy()`,
zamiast tego użyj zdarzenia `Class.Instance.Destroying`.

Instance.AncestryChanged

child

Instancja, której zmieniła się właściwość `Class.Instance.Parent|Parent`,
która może być tą instancją lub dalszym przodkiem, **nie**koniecznie
dowolna instancja, do której jest podłączony handler.

parent

Wyzwala się, gdy zmienia się właściwość `Class.Instance.Parent` tego obiektu
lub jednego z jego przodków.

To zdarzenie wyzwala się, gdy jakikolwiek atrybut na instancji zostaje
zmieniony, w tym kiedy atrybut jest ustawiany na `nil`. Nazwa zmienionego
atrybutu jest przekazywana do podłączonej funkcji.

Na przykład poniższy fragment kodu łączy funkcję `attributeChanged()`
, aby uruchomić ją, gdy zmienia się jeden z atrybutów części:

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

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "zmieniono")
end

part.AttributeChanged:Connect(attributeChanged)
```
Zobacz także `Class.Instance:GetAttributeChangedSignal()`, które zwraca
zdarzenie, które wyzwala się, gdy zmienia się określony atrybut.

Instance.AttributeChanged

attribute

Nazwa atrybutu, który został zmieniony.

Wyzwala się, gdy jakikolwiek atrybut zostaje zmieniony w `Class.Instance`.

Ten fragment kodu wypisuje nazwy obiektów, które są dodawane do Workspace:

Wyzwala się po dodaniu obiektu jako dziecka do tego `Class.Instance`.

Uwaga, przy używaniu tej metody na kliencie w celu wykrycia obiektów
tworzonych przez serwer, konieczne jest użycie `Class.Instance:WaitForChild()`
przy indeksowaniu potomków tych obiektów. Dzieje się tak, ponieważ obiekt i jego
potomstwo nie są gwarantowane do replikacji z serwera do klienta
jednocześnie. Na przykład:

```
local Workspace = game:GetService("Workspace")

Workspace.ChildAdded:Connect(function(child)
	-- Użyj WaitForChild(), ponieważ potomkowie mogą jeszcze nie zostać
	local head = child:WaitForChild("Head")
end)
```
Uwaga, to zdarzenie działa tylko dla bezpośrednich dzieci
`Class.Instance`. Aby zdarzenie, które obejmuje wszystkie potomków,
 używasz `Class.Instance.DescendantAdded`.

Zobacz także `Class.Instance.ChildRemoved`.

Instance.ChildAdded

Wyzwala się po dodaniu obiektu jako dziecka do tego `Class.Instance`.

Instance.childAdded

Ten fragment kodu drukuje nazwy obiektów, gdy są one usuwane z
Workspace:

Wyzwala się po usunięciu dziecka z tego `Class.Instance`.

Usunięcie odnosi się do sytuacji, gdy rodzic obiektu zmienia się z
tego `Class.Instance` na coś innego niż ten `Class.Instance`. Uwaga, to
zdarzenie również wyzwoli się, gdy dziecko zostanie zniszczone (przy użyciu
`Class.Instance:Destroy()`), ponieważ funkcja niszcząca ustawia rodzica
obiektu na `nil`.

To zdarzenie działa tylko dla bezpośrednich dzieci `Class.Instance`.
W przypadku zdarzenia, które obejmuje wszystkich potomków,
 używasz `Class.Instance.DescendantRemoving`.

Zobacz także `Class.Instance.ChildAdded`.

Instance.ChildRemoved

Wyzwala się po usunięciu dziecka z tego `Class.Instance`.

Ten przykład wydrukuje nazwę obiektu, który zostanie dodany do
Workspace:


To zdarzenie wyzwala się po dodaniu potomka do `Class.Instance`.

Ponieważ wyzwala się dla każdego potomka, zamieszczenie obiektu jako dziecka w `Class.Instance`
wyzwoli wydarzenie dla tego obiektu i wszystkich jego potomków indywidualnie.

Jeśli interesują cię tylko **bezpośrednie dzieci** `Class.Instance`,
  użyj `Class.Instance.ChildAdded` zamiast tego.

Zobacz także `Class.Instance.DescendantRemoving`.

Instance.DescendantAdded

descendant

Wyzwala się po dodaniu potomka do `Class.Instance`.

Poniższy przykład wypisuje nazwę każdego potomka w momencie, gdy jest usuwany
z Workspace:

To zdarzenie wyzwala się **natychmiast przed** zmianą rodzica `Class.Instance`
w taki sposób, że instancja **potomka** nie będzie już potomkiem. `Class.Instance:Destroy()|Destroy()`
zmienia rodzica instancji na `nil`, dlatego wywołanie tej metody na
potomku rodzica spowoduje wyzwolenie tego zdarzenia.

Ponieważ to zdarzenie wyzwala się **przed** usunięciem potomka,
rodzic potomka pozostanie niezmieniony w czasie wyzwalania tego zdarzenia. Jeśli
potomek jest również **bezpośrednim dzieckiem** rodzica, to zdarzenie wyzwoli
się przed `Class.Instance.ChildRemoved`.

Jeśli potomek ma dzieci, to zdarzenie wyzwala się najpierw dla potomka,
a potem dla jego dzieci.

#### Ostrzeżenie

To zdarzenie wyzwala się z obiektem potomka, który jest usuwany.
Próba ustawienia `Class.Instance.Parent|Parent` potomka na coś
innego zakończy się niepowodzeniem. Poniżej znajduje się przykład, który
demonstracyjnie to pokazuje:

```
local Workspace = game:GetService("Workspace")

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Nie manipuluj rodzicem potomka w tej funkcji!
	-- To zdarzenie wyzwala się Z POWODU manipulacji rodzicem i zmiana jeszcze
	-- się nie zdarzyła, więc zmiana rodzica w ten sposób jest problematyczna:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```
Zobacz także `Class.Instance.DescendantAdded|DescendantAdded`.

Instance.DescendantRemoving

Wyzwala się natychmiast przed usunięciem potomka `Class.Instance`.

Ten przykład pokazuje, jak w przypadku używania zachowania sygnału natychmiastowego, obiekt
instancji, który jest niszczony, pozostaje w miejscu, aż połączona funkcja zrealizuje.


Ten przykład demonstruje, jak podczas używania zachowania sygnału opóźnionego, instancja
zostaje zniszczona przed wywołaniem sygnału.


`Class.Instance` nigdy nie zostanie usunięty z pamięci, gdy podłączona
funkcja wciąż go używa. Jednak jeśli funkcja w jakimkolwiek momencie
zablokuje działanie, `Class.Instance` i jego potomstwo zostaną
przypisane do `nil`.

Jeśli właściwość `Class.Workspace.SignalBehavior` jest ustawiona na
`Enum.SignalBehavior.Immediate`, to zdarzenie wyzwala się natychmiast przed tym,
jak `Class.Instance` lub którekolwiek z jego przodków zostaną
zniszczone za pomocą `Class.Instance:Destroy()`.

Jeśli właściwość `Class.Workspace.SignalBehavior` jest ustawiona na
`Enum.SignalBehavior.Deferred`, to zdarzenie wyzwala się w następnym punkcie
odnawiania, co będzie po tym, jak `Class.Instance` lub którekolwiek z jego
przodków zostaną zniszczone za pomocą `Class.Instance:Destroy()`.

Przy zachowaniu `Enum.SignalBehavior.Deferred|Deferred` połączenie skryptu
z własnym zdarzeniem `Class.Instance.Destroying` jest problematyczne,
ponieważ skrypt zostanie zniszczony przed wykonaniem wywołania zwrotnego
(co oznacza, że nie zostanie wykonane).

Podczas usuwania `Class.Instance` w Studio, np. ręcznie przez
Edycję w [Eksploratorze](/studio/explorer), `Class.Instance`
nigdy nie jest niszczony. Zamiast tego jego rodzic jest ustawiany na `nil`,
co można śledzić za pomocą `Class.Instance.AncestryChanged`.

Instance.Destroying

Wyzwala się natychmiast przed (lub jest opóźnione do po) zniszczenia instancji
dzięki `Class.Instance:Destroy()`. 

To zdarzenie wyzwala się, gdy jakakolwiek właściwość stylu jest zmieniana na instancji,
w tym kiedy właściwość jest ustawiana na `nil`.

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

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")
local meterBar = HUDContainer.MeterBar

local function stylePropertyChanged()
	print("Właściwości stylu zmienione")
end

meterBar:StyledPropertiesChanged():Connect(stylePropertyChanged)
```

Instance.StyledPropertiesChanged

Wyzwala się, gdy jakakolwiek właściwość stylu jest zmieniana na instancji,
 w tym kiedy właściwość jest ustawiana na `nil`.

Ta metoda przypisuje tag do instancji, bez efektu, jeśli tag
jest już przypisany. Pomyślne dodanie tagu spowoduje wywołanie sygnału stworzonego przez
`Class.CollectionService:GetInstanceAddedSignal()` dla danego tagu.

#### Ostrzeżenia

- Tag instancji, które zostały dodane po stronie klienta, zostanie usunięty,
  jeśli serwer później doda lub usunie tag dla tej instancji, ponieważ serwer
  replikuje wszystkie tagi razem i zastępuje poprzednie tagi.

- Podczas oznaczania instancji powszechne jest, że niektóre zasoby są używane do
  nadania tagowi jego funkcji, na przykład połączenia wydarzeń lub tabele.
  Aby zapobiec wyciekom pamięci, dobrze jest je oczyścić (rozłączyć,
  ustawić na `nil`, itp.) kiedy już nie są potrzebne dla tagu. Zrób to
  podczas wywoływania `Class.Instance:RemoveTag()`, wywołując
  `Class.Instance:Destroy()`, lub w funkcji podłączonej do sygnału
  zwróconego przez `Class.CollectionService:GetInstanceRemovedSignal()`.

Instance:AddTag

Funkcja dzieci zwraca tablicę dzieci obiektu.

Instance:children

Ta metoda usuwa wszystkich potomków instancji oraz ich potomków.

```
local part = Instance.new("Part")

-- Dodaj trochę iskier
for i = 1, 3 do
	local sparkles = Instance.new("Sparkles")
	sparkles.Parent = part

  local sc = Instance.new("Sparkles")
  sc.Parent = sparkles
end

print("Dzieci:", #part:GetChildren())  --> Dzieci: 3

part:ClearAllChildren()

print("Dzieci:", #part:GetChildren())  --> Dzieci: 0
```
Jeśli nie chcesz usunąć **wszystkich** dzieci i potomków, użyj albo
`Class.Instance:GetChildren()` albo `Class.Instance:GetDescendants()` by
przejść przez te dzieci/potomków i wybrać, co zniszczyć. Na przykład, poniższy
przykład kodu usunie wszystkie
`Class.BasePart|BaseParts` opadające z `Class.Model`:

```
local Workspace = game:GetService("Workspace")

local model = Workspace:FindFirstChild("TestModel")

for _, descendant in model:GetDescendants() do
	if descendant:IsA("BasePart") then
		descendant:Destroy()
	end
end
```

Instance:ClearAllChildren

Ta metoda usuwa wszystkich potomków instancji.

Demonstracja klonowania modelu za pomocą `Class.Instance:Clone()`.


`Clone()` tworzy kopię instancji oraz wszystkich jej potomków,
ignorując wszystkie instancje, które nie są `Class.Instance.Archivable|Archivable`. Kopia
instancji głównej jest zwracana przez tę metodę, a jej `Class.Instance.Parent|Parent`
jest ustawiane na `nil`. Zauważ, że jeśli sama instancja ma
`Class.Instance.Archivable|Archivable` ustawione na `false`, ta metoda
zwróci `nil`.

Jeśli właściwość referencyjna, taka jak `Class.ObjectValue.Value`, jest ustawiona w
sklonowanej instancji, wartość właściwości kopii zależy od wartości oryginału:

- Jeśli właściwość referencyjna odnosi się do instancji, która również została
  sklonowana, kopia odniesie się do kopii.
- Jeśli właściwość referencyjna odnosi się do instancji, która **nie** została
  sklonowana, ta sama wartość jest utrzymywana w kopii.

Instance:Clone

Tworzy kopię instancji oraz wszystkich jej potomków, ignorując instancje,
które nie są `Class.Instance.Archivable|Archivable`.

Instance:clone

Demonstruje niszczenie elementu za pomocą funkcji `Class.Instance:Destroy()`.

Ta funkcja jest prawidłowym sposobem na pozbycie się obiektów, które nie są już
potrzebne.


Ustawia właściwość `Class.Instance.Parent` na `nil`, blokuje
właściwość `Class.Instance.Parent`, rozłącza wszystkie połączenia i wywołuje
`Destroy()` na wszystkich dzieciach. Ta metoda jest właściwym sposobem
na pozbycie się obiektów, które nie są już potrzebne.

Pozbywanie się niepotrzebnych obiektów jest ważne, ponieważ niepotrzebne obiekty i
połączenia w miejscu zużywają pamięć, co może prowadzić do poważnych problemów z wydajnością
z upływem czasu.

Jako najlepsza praktyka po wywołaniu `Destroy()` na obiekcie, ustaw wszelkie
zmienne odwołujące się do obiektu (lub jego potomków) na `nil`. To
zapobiega dostępowi Twojego kodu do czegokolwiek związanego z obiektem.

```lua
local part = Instance.new("Part")
part.Name = "Witaj, świecie"
part:Destroy()
-- Nie rób tego:
print(part.Name)  --> "Witaj, świecie"
-- Zrób to, aby zapobiec działaniu powyższej linii:
part = nil
```
Po zniszczeniu instancji `Class.Instance` tą metodą, nie można jej
ponownie użyć, ponieważ właściwość `Class.Instance.Parent` jest zablokowana. Aby
**tymczasowo** usunąć obiekt zamiast go zniszczyć, ustaw `Class.Instance.Parent|Parent`
na `nil`. Na przykład:

```
local Workspace = game:GetService("Workspace")

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
Aby zniszczyć obiekt po określonym czasie, użyj
`Class.Debris:AddItem()`.

Instance:Destroy

Ustawia właściwość `Class.Instance.Parent` na `nil`, blokuje
właściwość `Class.Instance.Parent`, rozłącza wszystkie połączenia i wywołuje
`Destroy()` na wszystkich dzieciach.

Instance:destroy

Zwraca pierwszego przodka `Class.Instance`, którego
`Class.Instance.Name` jest równy podanej nazwie.

Ta metoda działa w górę, co oznacza, że zaczyna od natychmiastowego
`Class.Instance.Parent` instancji i pracuje w kierunku `Class.DataModel`. Jeśli nie
zostanie znaleziony dopasowany przodek, zwraca `nil`.

Poniższy fragment kodu znajdzie pierwszego przodka obiektu
nazywanego `Car`.

```
local car = object:FindFirstAncestor("Car")
```
Dla wariantów tej metody, które znajdują przodków określonej klasy,
zobacz `Class.Instance:FindFirstAncestorOfClass()` oraz
`Class.Instance:FindFirstAncestorWhichIsA()`.

Instance:FindFirstAncestor

name

Nazwa `Class.Instance.Name`, której należy szukać.

Zwraca pierwszego przodka `Class.Instance`, którego
`Class.Instance.Name` jest równy podanej nazwie.

Zwraca pierwszego przodka `Class.Instance`, którego
`Class.Object.ClassName` jest równy podanemu className.

Ta metoda działa w górę, co oznacza, że zaczyna od natychmiastowego
`Class.Instance.Parent` instancji i pracuje w kierunku `Class.DataModel`. Jeśli nie
zostanie znaleziony dopasowany przodek, zwraca `nil`.

Powszechnym użyciem tej metody jest znalezienie `Class.Model`, do
której należy `Class.BasePart`. Na przykład:

```
local model = part:FindFirstAncestorOfClass("Model")
```
Ta metoda jest wariantem `Class.Instance:FindFirstAncestor()`, która
sprawdza właściwość `Class.Object.ClassName`, a nie `Class.Instance.Name`. `Class.Instance:FindFirstAncestorWhichIsA()` również
istnieje, używając metody `Class.Object:IsA()` w celu respektowania dziedziczenia klas.

Instance:FindFirstAncestorOfClass

className

Nazwa `Class.Object.ClassName`, której należy szukać.

Zwraca pierwszego przodka `Class.Instance`, którego
`Class.Object.ClassName` jest równy podanemu className.

Zwraca pierwszego przodka `Class.Instance`, dla którego
`Class.Object:IsA()` zwraca prawdę dla podanego className.

Ta metoda działa w górę, co oznacza, że zaczyna od natychmiastowego
`Class.Instance.Parent` instancji i pracuje w kierunku `Class.DataModel`. Jeśli nie
zostanie znaleziony dopasowany przodek, zwraca `nil`.

W przeciwieństwie do `Class.Instance:FindFirstAncestorOfClass()`, ta metoda
używa `Class.Object:IsA()`, co szanuje dziedziczenie klas. Na przykład:

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
Z tego powodu, poniższy przykład kodu zwróci pierwszego
przodka `Class.BasePart`, niezależnie od tego, czy jest to `Class.WedgePart`,
`Class.MeshPart` czy `Class.Part`.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
Zobacz także `Class.Instance:FindFirstAncestor()`.

Instance:FindFirstAncestorWhichIsA

Zwraca pierwszego przodka `Class.Instance`, dla którego
`Class.Object:IsA()` zwraca prawdę dla podanego className.

Poniższy kod będzie szukał obiektu o nazwie "Brick" w Workspace. Jeśli go znajdzie,
zamieni nazwę obiektu na "Foo".

Zwraca pierwsze dziecko `Class.Instance` z podaną nazwą, lub
`nil`, jeśli takie dziecko nie istnieje. Jeśli opcjonalny argument
`recursive` jest `true`, ta metoda przeszukuje wszystkich potomków, a nie tylko natychmiastowe dzieci
`Class.Instance`.

#### Sprawdzanie istnienia obiektu

`FindFirstChild()` jest konieczny, jeśli musisz zweryfikować, czy obiekt istnieje
przed kontynuowaniem. Próba indeksowania dziecka po nazwie za pomocą operatora kropki
zgłasza błąd, jeśli dziecko nie istnieje.

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

-- Poniższa linia zgłasza błąd, jeśli część nie istnieje w workspace
Workspace.Part.Transparency = 0.5
```
Lepszym podejściem jest użycie `FindFirstChild()`, aby najpierw sprawdzić
`Part`, a następnie użyć instrukcji `if`, aby uruchomić kod, który go potrzebuje.

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

local part = Workspace:FindFirstChild("Part")
if part then
	part.Transparency = 0.5
end
```

#### Znalezienie dziecka, którego nazwa pasuje do właściwości

Czasami nazwa `Class.Instance.Name|Name` obiektu jest taka sama jak
właściwość jego `Class.Instance.Parent|Parent`. Podczas używania operatora kropki,
 właściwości mają pierwszeństwo przed dziećmi, jeśli mają tę samą nazwę.

W poniższym przykładzie, `Class.Folder` o nazwie `Color` jest dodawane do
`Class.Part`, który również ma właściwość `Class.Part.Color`. Zauważ, że
`part.Color` odnosi się do wartości właściwości `Datatype.Color3`, a nie do obiektu dziecka `Class.Folder`. Korzyścią z używania
`Class.Instance:FindFirstChild()|FindFirstChild()` jest to, że
wprowadzenie nowych właściwości nie stwarza ryzyka dla twojego kodu.

```lua
local part = Instance.new("Part")
local folder = Instance.new("Folder")
f.folder.Name = "Color"
f.folder.Parent = part
local c1 = part.Color  -- Właściwość
local c2 = part:FindFirstChild("Color")  -- Obiekt folderu
```

#### Uwagi dotyczące wydajności

`Class.Instance:FindFirstChild()|FindFirstChild()` zajmuje około 20% więcej czasu
niż użycie operatora kropki i prawie 8 razy więcej niż po prostu przechowywanie
dostępu do obiektu. Z tego powodu warto unikać wywoływania go w kodzie
zależnym od wydajności, takim jak w ciasnych pętlach lub funkcjach podłączonych
do `Class.RunService.Heartbeat` oraz `Class.RunService.PreRender`. Zamiast tego,
przechowuj wynik w zmiennej lub rozważ użycie
`Class.Instance.ChildAdded|ChildAdded` lub
`Class.Instance:WaitForChild()|WaitForChild()` aby wykryć, kiedy dziecko o
podanej nazwie stanie się dostępne.

Instance:FindFirstChild

recursive

Czy przeszukiwać rekurencyjnie, czy nie.

Zwraca pierwsze dziecko `Class.Instance` znalezione o podanej nazwie.

Instance:findFirstChild

Zwraca pierwsze dziecko `Class.Instance`, którego
`Class.Object.ClassName|ClassName` jest równe podanemu `className`.
W przeciwieństwie do `Class.Instance:FindFirstChildWhichIsA()`, ta metoda zwraca
tylko obiekty, których klasa pasuje do `className`, ignorując dziedziczenie klas. Jeśli nie
zostanie znalezione dopasowane dziecko, ta metoda zwraca `nil`.

Instance:FindFirstChildOfClass

Zwraca pierwsze dziecko `Class.Instance`, którego
`Class.Object.ClassName|ClassName` jest równe podanej nazwie klasy.

Zwraca pierwsze dziecko `Class.Instance`, dla którego
`Class.Object:IsA()` zwraca prawdę dla podanego className.

Jeśli nie zostanie znalezione dopasowane dziecko, ta metoda zwraca `nil`. Jeśli opcjonalny
argument rekurencyjny jest prawdziwy, ta metoda przeszukuje wszystkich potomków, a
nie tylko natychmiastowe dzieci `Class.Instance`.

W przeciwieństwie do `Class.Instance:FindFirstChildOfClass()`, ta metoda używa
`Class.Object:IsA()`, co respektuje dziedziczenie klas. Na przykład:

```lua
print(part:IsA("Part")) --> true
print(part:IsA("BasePart")) --> true
print(part:IsA("Instance")) --> true
```
Z tego powodu, poniższy przykład kodu zwróci pierwsze
dziecko `Class.BasePart`, niezależnie od tego, czy jest to `Class.WedgePart`,
`Class.MeshPart` czy `Class.Part`.

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
Deweloperzy szukający dziecka po nazwie, powinni używać
`Class.Instance:FindFirstChild()` zamiast tego.

Instance:FindFirstChildWhichIsA

Zwraca pierwsze dziecko `Class.Instance`, dla którego
`Class.Object:IsA()` zwraca prawdę dla podanego className.

Zwraca pierwszego potomka znalezionego z podanym `Class.Instance.Name`.

Ta metoda jest wyłączona i nie może być używana. Aby znaleźć pierwszego potomka
instancji, rozważ użycie argumentu `recursive` w
`Class.Instance:FindFirstChild()` zamiast tego.

Instance:FindFirstDescendant

Zwraca pierwszego potomka znalezionego z podanym `Class.Instance.Name`.

Jeśli `Class.Instance` jest `Class.Actor`, zwracana jest sama `Class.Actor`. W przeciwnym razie
zwracany jest najbliższy przodek `Class.Actor`. Jeśli żaden przodek nie jest `Class.Actor`,
rezultatem jest `nil`.

Instance:GetActor

Zwraca `Class.Actor` powiązany z instancją, jeśli taki istnieje.

Ta metoda zwraca wartość, która została przypisana do danej
nazwy atrybutu. Jeśli żaden atrybut nie został przypisany, zostanie zwrócone `nil`.

Na przykład, poniższy fragment kodu ustawia a następnie uzyskuje wartość
atrybutu `InitialPosition` instancji:

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

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local initialPosition = instance:GetAttribute("InitialPosition")
print(initialPosition)
```

#### Zobacz także

- `Class.Instance:SetAttribute()`, który ustawia atrybut o danej
  nazwie na daną wartość.
- `Class.Instance:GetAttributes()`, który zwraca słownik par klucz-wartość
  dla każdego z atrybutów instancji.

Instance:GetAttribute

Wartość przypisana do danej nazwy atrybutu. Jeśli żaden
atrybut nie został przypisany, zostanie zwrócone `nil`.

Zwraca wartość przypisaną do danego nazwy atrybutu.

Ta metoda zwraca zdarzenie działa dokładnie jak
`Class.Object.Changed|Changed`, z tą różnicą, że wywołuje się tylko wtedy,
 gdy zmienia się dany atrybut; w efekcie jest podobne do
`Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()`, ale
dla atrybutów.

Zazwyczaj dobrze jest używać tej metody zamiast łączenia z
`Class.Object.Changed|Changed` z funkcją, która sprawdza nazwę atrybutu. Kolejne wywołania tej metody na tym samym obiekcie z tą samą
nazwą atrybutu zwracają ten sam sygnał.

Poniższy przykład kodu zwraca sygnał, który wywołuje funkcję
`attributeChanged()` po tym, jak zmienia się atrybut `InitialPosition` obiektu:

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

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local function attributeChanged()
	print("Atrybut zmieniony")
end

part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
```
Zobacz także `Class.Instance.AttributeChanged`, które wywołuje się,
gdy jakikolwiek atrybut zmienia się na instancji.

Instance:GetAttributeChangedSignal

Nazwa określonego atrybutu, dla którego zwracany jest sygnał o zmianie.

Zdarzenie, które uruchamia się, gdy dany atrybut się zmienia.

Zwraca zdarzenie, które występuje, gdy dany atrybut się zmienia.

Ta metoda zwraca słownik par klucz-wartość dla każdego atrybutu,
gdzie klucz to nazwa atrybutu, a wartość to wartość nie-`nil`.

Na przykład, poniższy fragment kodu wyświetla atrybuty instancji
i ich wartości:

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

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)
part:SetAttribute("CanUse", true)

for name, value in part:GetAttributes() do
	print(name .. " = " .. value)
end
```
Zobacz także `Class.Instance:GetAttribute()`, która zwraca wartość, która
została przypisana do danej nazwy atrybutu.

Instance:GetAttributes

Słownik par typ `string → variant` dla każdego atrybutu, gdzie
ciąg to nazwa atrybutu, a wariant to wartość nie-`nil`.

Poniżej znajduje się kod, który wydrukuje nazwę wszystkich obiektów znajdujących się obecnie w Workspace, gdy zostanie wykonany.

Zwraca tablicę (numerowo indeksowaną tabelę), zawierającą wszystkie
bezpośrednie dzieci instancji, lub każdego `Class.Instance`, którego
`Class.Instance.Parent|Parent` jest równy obiektowi. Tablicę można
iterować zarówno za pomocą pętli numerycznej, jak i ogólnej:

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

-- Przykład pętli numerycznej
local children = Workspace:GetChildren()
for i = 1, #children do
	local child = children[i]
	print(child.Name .. " jest dzieckiem numer " .. i)
end
```

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

-- Przykład pętli ogólnej
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. " jest dzieckiem numer " .. i)
end
```
Zauważ, że zwrócona tablica **nie** jest posortowana w żadnej szczególnej kolejności,
specjalne sortowanie (na przykład przy użyciu `Library.table.sort()`) jest zalecane do
sortowania dzieci zwróconych przez tę metodę.

Zobacz także metodę `Class.Instance:GetDescendants()|GetDescendants()`.

Instance:GetChildren

Zwraca tablicę zawierającą wszystkie dzieci instancji.

Instance:getChildren

Zwraca zakodowany ciąg identyfikatora debugowania używanego wewnętrznie przez Roblox. Zauważ,
że:

- Ten element jest chroniony. Próba użycia go w `Class.Script` lub
  `Class.LocalScript` spowoduje błąd.
- Identyfikator debugowania jest identyfikatorem używanym w procesach debugowania. Umożliwia debuggerowi
  odczytanie każdej instrukcji przed przetworzeniem jej przez aplikację. Wszystkie obiekty w
  Roblox działają jak procesy, a każdy uruchamia instrukcje (lub 'kod'), które można
  debugować w razie potrzeby.
- Może to być pomocne dla wtyczek, które potrzebują odróżnić podobne
  obiekty od siebie nawzajem (takie jak obiekty, które dzielą tę samą nazwę).

Instance:GetDebugId

scopeLength

Zwraca zakodowany ciąg identyfikatora debugowania używanego wewnętrznie przez Roblox.

GetDescendants jest często używane, aby zrobić coś ze wszystkimi potomkami, które są
określonym rodzajem obiektu. Kod w tym przykładzie używa GetDescendants oraz
`Class.Instance:IsA()`, aby znaleźć wszystkie części w workspace i zmienia je
na zielone.

Ta metoda obiektu zwraca tablicę, która zawiera wszystkich potomków
tego obiektu. W przeciwieństwie do `Class.Instance:GetChildren()`, która zwraca tylko
bezpośrednie dzieci obiektu, ta metoda odnajduje każdego dziecka obiektu,
wielu dzieci tych dzieci itd.

Zauważ, że zwrócona tablica **nie** jest posortowana w żadnej szczególnej kolejności,
specjalne sortowanie (na przykład przy użyciu `Library.table.sort()`) jest zalecane do
sortowania potomków zwróconych przez tę metodę. Rozważ także
metodę `Class.Instance:QueryDescendants()|QueryDescendants()`, aby zapytać
otoczniki o potomków kombinowanych z selektorami i kombinatorami.

Instance:GetDescendants

Zwraca tablicę zawierającą wszystkie potomków instancji.

Instance

`Instance` jest klasą bazową dla wszystkich klas w hierarchii klas Roblox
które mogą być częścią drzewa `Class.DataModel`.

/reference/engine/classes/PluginMouse.yaml