getYPosition

Since the UI elements in your app are not static but can be moved, your app may need to know where a UI element currently is placed on the screen. All UI elements (button(), textInput(), textLabel(), dropdown(), checkbox(), radioButton(), image()), can be queried for their current position.

Examples

// add the Code.org logo at a random position on the screen and display it's position.
image("logo", "http://code.org/images/logo.png");
setPosition("logo", randomNumber(0,320), randomNumber(0,450));
write(getYPosition("logo"));

Am I off the screen?

Check whether the logo has been displayed too close to the bottom edge.

// Check whether the logo has been displayed too close to the bottom edge.
image("logo", "http://code.org/images/logo.png");
setPosition("logo", randomNumber(0,320), randomNumber(0,450));
if (isCloseToEdge()){
  write("Too Close to Edge");
}
function isCloseToEdge(){
  if (getYPosition("logo")>=400) {
    return true;
  } else{
    return false;
  }
}

Syntax

getYPosition(id);

Returns

Returns a number representing the current y coordinate in pixels of the UI element within the app display.

Tips

• The screen default size is 320 pixels wide and 450 pixels high, but you can move a UI element off the screen by exceeding those dimensions.
• A UI element can be moved off the screen so getYPosition() can return a negative number if the element is off the screen to the top and getYPosition() can return a number greater than 320 if the element is off the screen to the bottom.

Found a bug in the documentation? Let us know at documentation@code.org