|
|
| Line 1: |
Line 1: |
| __NOTOC__
| |
| {{Client function}}
| |
| Ta funkcja umożliwia pobranie pozycji elementu DGS względem jego rodzica.
| |
|
| |
|
| ==Składnia==
| |
| <syntaxhighlight lang="lua">
| |
| float, float dgsGetPosition ( element dgsElement, bool relative [, bool includeParent = false ] )
| |
| </syntaxhighlight>
| |
|
| |
| ===Wymagane argumenty===
| |
| *'''dgsElement:''' Element DGS, którego pozycję chcesz pobrać.
| |
| *'''relative:''' Określa, w jakiej formie ma być pobrana pozycja. Ustawienie na ''true'' zwróci wyniki w przedziale od 0 do 1.
| |
| ===Opcjonalne argumenty===
| |
| *'''includeParent''' Określa, czy pobierana pozycja ma być względem ekranu, czy rodzica. Ustawienie na ''true'' zwróci wyniki względem ekranu.
| |
|
| |
| ===Wynik===
| |
| Zwraca liczby zmiennoprzecinkowe reprezentujące pozycję ''x'' oraz ''y'' elementu DGS, albo ''false'' jeśli pobieranie pozycji nie powiodło się.
| |
|
| |
| ==Przykład==
| |
| Ten przykład sprawdza, w którym rogu znajduje się element DGS.
| |
| <syntaxhighlight lang="lua">
| |
| DGS = exports.dgs
| |
|
| |
| function positionCheck ( dgsElement )
| |
| local x,y = DGS:dgsGetPosition ( dgsElement, true ) -- pobranie pozycji elementu DGS
| |
| local position -- utworzenie zmiennej "position"
| |
| if ( x == 0.5 ) and ( y == 0.5 ) then -- jeśli element jest na środku
| |
| position = "middle" -- ustawienie zmiennej "position" wartości "middle"
| |
| elseif ( x > 0.5 ) and ( y > 0.5 ) then -- jeśli element jest w prawym dolnym rogu
| |
| position = "right-bottom"
| |
| elseif ( x < 0.5 ) and ( y < 0.5 ) then -- jeśli element jest w lewym górnym rogu
| |
| position = "left-top"
| |
| elseif ( x < 0.5 ) and ( y > 0.5 ) then -- jeśli element jest w lewym dolnym rogu
| |
| position = "left-bottom"
| |
| elseif ( x > 0.5 ) and ( y < 0.5 ) then -- jeśli element jest w prawym górnym rogu
| |
| position = "right-top"
| |
| else
| |
| position = "unknown"
| |
| end
| |
| -- wyświetlenie wyniku na chacie
| |
| outputChatBox ( "Pozycja elementu DGS to: "..position.."!" )
| |
| end
| |
| </syntaxhighlight>
| |
|
| |
| ==Zobacz również==
| |
| {{DGSFUNCTIONS}}
| |