209 lines
3.2 KiB
Markdown
209 lines
3.2 KiB
Markdown
# 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.
|