Added part of docs

docs/pl/reference/MOUSE.md

@@ -0,0 +1,208 @@
+# MOUSE
+
+Wbudowany obiekt reprezentujący stan myszy. Dostępny pod globalną nazwą `MOUSE` z dowolnego kontekstu (zobacz [Obiekty wbudowane](../engine/globals.md#obiekty-wbudowane)). Obsługuje pozycję kursora, stan przycisków oraz reaktywne zdarzenia kliknięcia, ruchu i podwójnego kliknięcia.
+
+## Pola
+
+### RAW
+
+```
+BOOL RAW
+```
+
+Określa, czy obiekt odczytuje surowe dane myszy (z pominięciem przyspieszenia i kalibracji systemowej).
+
+## Metody
+
+### DISABLE
+
+```
+void DISABLE()
+```
+
+Wyłącza odbieranie zdarzeń myszy — kursor przestaje aktualizować pozycję, a sygnały nie są emitowane.
+
+**Przykłady**
+
+```
+MOUSE^DISABLE();
+```
+
+### DISABLESIGNAL
+
+```
+void DISABLESIGNAL()
+```
+
+Wyłącza emisję sygnałów myszy. W przeciwieństwie do [`DISABLE`](#disable) pozycja kursora nadal jest śledzona, ale obsługa sygnałów ([`ONMOVE`](#onmove), [`ONCLICK`](#onclick) itd.) nie jest wywoływana.
+
+**Przykłady**
+
+```
+MOUSE^DISABLESIGNAL();
+```
+
+### ENABLE
+
+```
+void ENABLE()
+```
+
+Włącza odbieranie zdarzeń myszy.
+
+**Przykłady**
+
+```
+MOUSE^ENABLE();
+```
+
+### ENABLESIGNAL
+
+```
+void ENABLESIGNAL()
+```
+
+Włącza emisję sygnałów myszy.
+
+**Przykłady**
+
+```
+MOUSE^ENABLESIGNAL();
+```
+
+### GETPOSX
+
+```
+INTEGER GETPOSX()
+```
+
+Zwraca aktualną pozycję kursora w osi X.
+
+**Zwraca**: współrzędna X kursora.
+
+**Przykłady**
+
+```
+MOUSE^GETPOSX();
+```
+
+### GETPOSY
+
+```
+INTEGER GETPOSY()
+```
+
+Zwraca aktualną pozycję kursora w osi Y.
+
+**Zwraca**: współrzędna Y kursora.
+
+**Przykłady**
+
+```
+MOUSE^GETPOSY();
+```
+
+### HIDE
+
+```
+void HIDE()
+```
+
+Ukrywa kursor myszy.
+
+**Przykłady**
+
+```
+MOUSE^HIDE();
+```
+
+### ISLBUTTONDOWN
+
+```
+BOOL ISLBUTTONDOWN()
+```
+
+Sprawdza, czy lewy przycisk myszy jest aktualnie wciśnięty.
+
+**Zwraca**: [`BOOL`](BOOL.md) — `TRUE`, jeżeli przycisk jest wciśnięty.
+
+**Przykłady**
+
+```
+MOUSE^ISLBUTTONDOWN();
+```
+
+### SET
+
+```
+void SET(STRING cursorStyle)
+```
+
+Ustawia styl kursora.
+
+**Parametry**
+
+- `cursorStyle` — nazwa stylu kursora (np. `"ACTIVE"`, `"ARROW"`).
+
+**Przykłady**
+
+```
+MOUSE^SET("ACTIVE");
+MOUSE^SET("ARROW");
+```
+
+### SETPOSITION
+
+```
+void SETPOSITION(INTEGER posX, INTEGER posY)
+```
+
+Ustawia pozycję kursora myszy na ekranie. Jeżeli pozycja faktycznie się zmieniła, dodatkowo emitowany jest sygnał [`ONMOVE`](#onmove).
+
+**Parametry**
+
+- `posX` — nowa współrzędna X kursora.
+- `posY` — nowa współrzędna Y kursora.
+
+**Przykłady**
+
+```
+MOUSE^SETPOSITION(400, 300);
+MOUSE^SETPOSITION(MOUSE^GETPOSX(), VARINT0);
+MOUSE^SETPOSITION(ANNMUCHA0^GETCENTERX(), ANNMUCHA0^GETCENTERY());
+```
+
+### SHOW
+
+```
+void SHOW()
+```
+
+Wyświetla kursor myszy.
+
+## Sygnały
+
+### ONCLICK
+
+Wywoływany po kliknięciu przycisku myszy. Sygnał jest [parametryzowany](../engine/events.md#sygnaly-parametryzowane) nazwą wciśniętego przycisku (`LEFT`, `RIGHT`), co pozwala podpiąć osobną obsługę dla każdego z nich:
+
+```
+NAZWA_OBIEKTU:ONCLICK^LEFT=BEHLEFTCLICK
+NAZWA_OBIEKTU:ONCLICK^RIGHT=BEHRIGHTCLICK
+```
+
+### ONDBLCLICK
+
+Wywoływany po dwukrotnym kliknięciu przycisku myszy.
+
+### ONINIT
+
+Wywoływany w momencie inicjalizacji obiektu.
+
+### ONMOVE
+
+Wywoływany po wykryciu ruchu myszy (zmiany pozycji kursora).
+
+### ONRELEASE
+
+Wywoływany po zwolnieniu przycisku myszy.