Bomb Bloke: Created page with "{{lowercase}} {{Function |name=window.getPosition |returns={{type|number}} xPosition, {{type|number}} yPosition |api=term |addon=ComputerCraft |desc=A function available to wi..."

2014-04-07T11:20:02Z

Created page with "{{lowercase}} {{Function |name=window.getPosition |returns={{type|number}} xPosition, {{type|number}} yPosition |api=term |addon=ComputerCraft |desc=A function available to wi..."

New page

{{lowercase}}
{{Function
|name=window.getPosition
|returns={{type|number}} xPosition, {{type|number}} yPosition
|api=term
|addon=ComputerCraft
|desc=A function available to window-based [[term (API)|terminal objects]] created via the [[window (API)|window API]], which returns the x/y co-ordinates of the window's top-left point (within its ''parent'' terminal object).<br><br>

See also: [[term.getSize|term.getSize()]], [[window.reposition|window.reposition()]]
|examples=
{{Example
|desc=Defines a child window in a parent window, and notes its location within that parent. [[window.reposition|Moves]] the parent and notes the location again, before moving the child window and making a final note.
|code= term.clear()
term.setCursorPos(1,1)
local lastX, lastY

local parentWindow = window.create(term.current(), 5, 5, 10, 10)
local childWindow = window.create(parentWindow, 2, 2, 1, 1)
childWindow.write("!")

term.setCursorPos(1,1)
local xPos, yPos = childWindow.getPosition()
print("Child window is initially at "..xPos.."x"..yPos..".")
lastX, lastY = term.getCursorPos()

parentWindow.reposition(10,10)

term.setCursorPos(lastX,lastY)
xPos, yPos = childWindow.getPosition()
print("After moving the parent window, child window still registers as being at "..xPos.."x"..yPos..".")
lastX, lastY = term.getCursorPos()

childWindow.reposition(7,7)

term.setCursorPos(lastX,lastY)
xPos, yPos = childWindow.getPosition()
print("After moving the child window, it now registers as being at "..xPos.."x"..yPos..".")
|output=Notes that:
Child window is initially at 2x2.
After moving the parent window, child window still registers as being at 2x2.
After moving the child window, it now registers as being at 7x7.
... and also displays the exclamation mark rendered within the child window (drawn at three different positions).
}}
}}

[[Category:API_Functions]]

Window.getPosition - Revision history

Bomb Bloke: Created page with "{{lowercase}} {{Function |name=window.getPosition |returns={{type|number}} xPosition, {{type|number}} yPosition |api=term |addon=ComputerCraft |desc=A function available to wi..."