Class AbsolutePanel

AbsolutePanel

Deprecated. The UI service was deprecated on December 11, 2014. To create user interfaces, use the HTML service instead.

An absolute panel positions all of its children absolutely, allowing them to overlap.

Here is an example of how to use this widget:

function doGet() {
  var app = UiApp.createApplication();
  var button = app.createButton("a button");
  var panel = app.createAbsolutePanel();
  // add a widget at position (10, 20)
  panel.add(button, 10, 20);
  app.add(panel);
  return app;
}

Internally, UiApp widgets are built on top of the Google Web Toolkit, and it can sometimes be helpful to look at the GWT documentation directly. You can find the AbsolutePanel documentation here.

Deprecated methods

Method	Return type	Brief description
add(widget)	AbsolutePanel	Add a widget to the AbsolutePanel.
add(widget, left, top)	AbsolutePanel	Add a widget to the AbsolutePanel.
addStyleDependentName(styleName)	AbsolutePanel	Sets the dependent style name of this AbsolutePanel.
addStyleName(styleName)	AbsolutePanel	Adds a style name to this AbsolutePanel.
clear()	AbsolutePanel	Remove all widgets from the AbsolutePanel.
getId()	String	Returns the id that has been assigned to this object.
getTag()	String	Gets the text tag of this AbsolutePanel.
getType()	String	Gets the type of this object.
remove(index)	AbsolutePanel	Remove the widget with the given index from the AbsolutePanel.
remove(widget)	AbsolutePanel	Remove the given widget from the AbsolutePanel.
setHeight(height)	AbsolutePanel	Sets the height of this AbsolutePanel.
setId(id)	AbsolutePanel	Sets the id of this AbsolutePanel.
setLayoutData(layout)	AbsolutePanel	Set the layout for this AbsolutePanel.
setPixelSize(width, height)	AbsolutePanel	Sets the size of this AbsolutePanel in pixels.
setSize(width, height)	AbsolutePanel	Sets the size of this AbsolutePanel.
setStyleAttribute(attribute, value)	AbsolutePanel	Sets one of this AbsolutePanel's style attributes to a new value.
setStyleAttributes(attributes)	AbsolutePanel	Sets this AbsolutePanel's style attributes.
setStyleName(styleName)	AbsolutePanel	Sets the style name of this AbsolutePanel.
setStylePrimaryName(styleName)	AbsolutePanel	Sets the primary style name of this AbsolutePanel.
setTag(tag)	AbsolutePanel	Sets the text tag of this AbsolutePanel.
setTitle(title)	AbsolutePanel	Sets the hover title of this AbsolutePanel.
setVisible(visible)	AbsolutePanel	Sets whether this AbsolutePanel is visible.
setWidgetPosition(widget, left, top)	AbsolutePanel	Set the position of a widget that is already a child of the AbsolutePanel.
setWidth(width)	AbsolutePanel	Sets the width of this AbsolutePanel.

Deprecated methods

add(widget)

Deprecated. This function is deprecated and should not be used in new scripts.

Add a widget to the AbsolutePanel.

Parameters

Name	Type	Description
widget	Widget	the widget to add.

Return

AbsolutePanel — the AbsolutePanel itself, useful for chaining.

---

add(widget, left, top)

Deprecated. This function is deprecated and should not be used in new scripts.

Add a widget to the AbsolutePanel.

Parameters

Name	Type	Description
widget	Widget	the widget to add.
left	Integer	the widget's left position in pixels.
top	Integer	the widget's top position in pixels.

Return

AbsolutePanel — the AbsolutePanel itself, useful for chaining.

---

addStyleDependentName(styleName)

Deprecated. This function is deprecated and should not be used in new scripts.

Sets the dependent style name of this AbsolutePanel.

This is useful for debugging but is otherwise of minimal use since there is no way to use custom stylesheets in UiApp.

Parameters

Name	Type	Description
styleName	String	the new style name.

Return

AbsolutePanel — the AbsolutePanel itself, useful for chaining.

---

addStyleName(styleName)

Deprecated. This function is deprecated and should not be used in new scripts.

Adds a style name to this AbsolutePanel.

This is useful for debugging but is otherwise of minimal use since there is no way to use custom stylesheets in UiApp.

Parameters

Name	Type	Description
styleName	String	the new style name.

Return

AbsolutePanel — the AbsolutePanel itself, useful for chaining.

---

clear()

Deprecated. This function is deprecated and should not be used in new scripts.

Remove all widgets from the AbsolutePanel.

Return

AbsolutePanel — the AbsolutePanel itself, useful for chaining.

---

getId()

Deprecated. This function is deprecated and should not be used in new scripts.

Returns the id that has been assigned to this object.

This can be used in conjunction with app.getElementById() to retrieve a reference to this object.

Return

String — the id that has been assigned to this object

---

getTag()

Deprecated. This function is deprecated and should not be used in new scripts.

Gets the text tag of this AbsolutePanel.

Return

String — the text tag.

---

getType()

Deprecated. This function is deprecated and should not be used in new scripts.

Gets the type of this object.

Return

String — the object type

---

remove(index)

Deprecated. This function is deprecated and should not be used in new scripts.

Remove the widget with the given index from the AbsolutePanel. Indexes begin from 0. This will fail if the index is greater than or equal to the number of elements in the AbsolutePanel.

Parameters

Name	Type	Description
index	Integer	the index of the widget to remove.

Return

AbsolutePanel — the AbsolutePanel itself, useful for chaining.

---

remove(widget)

Deprecated. This function is deprecated and should not be used in new scripts.

Remove the given widget from the AbsolutePanel. This will fail if the widget is not actually a child of the AbsolutePanel.

Parameters

Name	Type	Description
widget	Widget	the widget to remove.

Return

AbsolutePanel — the AbsolutePanel itself, useful for chaining.

---

setHeight(height)

Deprecated. This function is deprecated and should not be used in new scripts.

Sets the height of this AbsolutePanel.

Parameters

Name	Type	Description
height	String	the new height in any CSS unit such as "10px" or "50%".

Return

AbsolutePanel — the AbsolutePanel itself, useful for chaining.

---

setId(id)

Deprecated. This function is deprecated and should not be used in new scripts.

Sets the id of this AbsolutePanel.

Parameters

Name	Type	Description
id	String	the new id, which can be used to retrieve the AbsolutePanel from app.getElementById(id).

Return

AbsolutePanel — the AbsolutePanel itself, useful for chaining.

---

setLayoutData(layout)

Deprecated. This function is deprecated and should not be used in new scripts.

Set the layout for this AbsolutePanel.

This is not currently functional.

Parameters

Name	Type	Description
layout	Object

Return

AbsolutePanel — the AbsolutePanel itself, useful for chaining.

---

setPixelSize(width, height)

Deprecated. This function is deprecated and should not be used in new scripts.

Sets the size of this AbsolutePanel in pixels.

Parameters

Name	Type	Description
width	Integer	the new width in pixels.
height	Integer	the new height in pixels.

Return

AbsolutePanel — the AbsolutePanel itself, useful for chaining.

---

setSize(width, height)

Deprecated. This function is deprecated and should not be used in new scripts.

Sets the size of this AbsolutePanel.

Parameters

Name	Type	Description
width	String	the new width in any CSS unit such as "10px" or "50%".
height	String	the new height in any CSS unit such as "10px" or "50%".

Return

AbsolutePanel — the AbsolutePanel itself, useful for chaining.

---

setStyleAttribute(attribute, value)

Deprecated. This function is deprecated and should not be used in new scripts.

Sets one of this AbsolutePanel's style attributes to a new value. Valid attributes are listed here; the values for each attribute are the same as those available in CSS style sheets.

// Change the widget's background to black and text color to green.
widget.setStyleAttribute("background", "black")
    .setStyleAttribute("color", "green");

Parameters

Name	Type	Description
attribute	String	the CSS attribute, in camel-case ("fontSize", not "font-size"), as listed here
value	String	the CSS value

Return

AbsolutePanel — the AbsolutePanel itself, useful for chaining.

---

setStyleAttributes(attributes)

Deprecated. This function is deprecated and should not be used in new scripts.

Sets this AbsolutePanel's style attributes. This is a convenience method that is equivalent to calling setStyleAttribute with every key/value pair in the attributes object. Valid attributes are listed here; the values for each attribute are the same as those available in CSS style sheets.

// Change the widget's background to black and text color to green.
widget.setStyleAttributes({background: "black", color: "green"});

Parameters

Name	Type	Description
attributes	Object	an object of key/value pairs for the CSS attributes and values to set; valid attributes are listed here

Return

AbsolutePanel — the AbsolutePanel itself, useful for chaining.

---

setStyleName(styleName)

Deprecated. This function is deprecated and should not be used in new scripts.

Sets the style name of this AbsolutePanel.

This is useful for debugging but is otherwise of minimal use since there is no way to use custom stylesheets in UiApp.

Parameters

Name	Type	Description
styleName	String	the new style name.

Return

AbsolutePanel — the AbsolutePanel itself, useful for chaining.

---

setStylePrimaryName(styleName)

Deprecated. This function is deprecated and should not be used in new scripts.

Sets the primary style name of this AbsolutePanel.

This is useful for debugging but is otherwise of minimal use since there is no way to use custom stylesheets in UiApp.

Parameters

Name	Type	Description
styleName	String	the new style name.

Return

AbsolutePanel — the AbsolutePanel itself, useful for chaining.

---

setTag(tag)

Deprecated. This function is deprecated and should not be used in new scripts.

Sets the text tag of this AbsolutePanel.

Parameters

Name	Type	Description
tag	String	the new text tag, which can be anything you wish to store with the widget.

Return

AbsolutePanel — the AbsolutePanel itself, useful for chaining.

---

setTitle(title)

Deprecated. This function is deprecated and should not be used in new scripts.

Sets the hover title of this AbsolutePanel.

Not all browsers will show this.

Parameters

Name	Type	Description
title	String	the hover title.

Return

AbsolutePanel — the AbsolutePanel itself, useful for chaining.

---

setVisible(visible)

Deprecated. This function is deprecated and should not be used in new scripts.

Sets whether this AbsolutePanel is visible.

Parameters

Name	Type	Description
visible	Boolean	whether this AbsolutePanel should be visible or not.

Return

AbsolutePanel — the AbsolutePanel itself, useful for chaining.

---

setWidgetPosition(widget, left, top)

Deprecated. This function is deprecated and should not be used in new scripts.

Set the position of a widget that is already a child of the AbsolutePanel. This will cause an error if the widget is not currently in the panel.

Parameters

Name	Type	Description
widget	Widget	the widget to position.
left	Integer	the widget's left position in pixels.
top	Integer	the widget's top position in pixels.

Return

AbsolutePanel — the AbsolutePanel itself, useful for chaining.

---

setWidth(width)

Deprecated. This function is deprecated and should not be used in new scripts.

Sets the width of this AbsolutePanel.

Parameters

Name	Type	Description
width	String	the new width in any CSS unit such as "10px" or "50%".

Return

AbsolutePanel — the AbsolutePanel itself, useful for chaining.