Deprecated. The UI service was deprecated on December 11, 2014. To create user interfaces, use the HTML service instead.
A panel that lays all of its widgets out in a single horizontal column.
Here is an example of how to use this widget:
function doGet() { var app = UiApp.createApplication(); var panel = app.createHorizontalPanel(); panel.add(app.createButton("button 1")); panel.add(app.createButton("button 2")); 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 HorizontalPanel documentation here.
Deprecated methods
Deprecated methods
add(widget)
add(widget)
Deprecated. This function is deprecated and should not be used in new scripts.
Add a widget to the
.HorizontalPanel
Parameters
Name | Type | Description |
---|---|---|
widget |
| the widget to add. |
Return
— the HorizontalPanel
itself, useful for chaining.HorizontalPanel
addStyleDependentName(styleName)
addStyleDependentName(styleName)
Deprecated. This function is deprecated and should not be used in new scripts.
Sets the dependent style name of this
.
HorizontalPanel
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
— the HorizontalPanel
itself, useful for chaining.HorizontalPanel
addStyleName(styleName)
addStyleName(styleName)
Deprecated. This function is deprecated and should not be used in new scripts.
Adds a style name to this
.
HorizontalPanel
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
— the HorizontalPanel
itself, useful for chaining.HorizontalPanel
clear()
clear()
Deprecated. This function is deprecated and should not be used in new scripts.
Remove all widgets from the
.HorizontalPanel
Return
— the HorizontalPanel
itself, useful for chaining.HorizontalPanel
getId()
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()
getTag()
Deprecated. This function is deprecated and should not be used in new scripts.
Gets the text tag of this
.HorizontalPanel
Return
String
— the text tag.
getType()
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)
remove(index)
Deprecated. This function is deprecated and should not be used in new scripts.
Remove the widget with the given index from the
. Indexes begin from 0.
This will fail if the index is greater than or equal to the number of elements in the HorizontalPanel
.HorizontalPanel
Parameters
Name | Type | Description |
---|---|---|
index | Integer | the index of the widget to remove. |
Return
— the HorizontalPanel
itself, useful for chaining.HorizontalPanel
remove(widget)
remove(widget)
Deprecated. This function is deprecated and should not be used in new scripts.
Remove the given widget from the
. This will fail if the widget is not
actually a child of the HorizontalPanel
.HorizontalPanel
Parameters
Name | Type | Description |
---|---|---|
widget |
| the widget to remove. |
Return
— the HorizontalPanel
itself, useful for chaining.HorizontalPanel
setBorderWidth(width)
setBorderWidth(width)
Deprecated. This function is deprecated and should not be used in new scripts.
Sets the width of the border to be applied to all cells in this panel.
This is particularly useful when debugging layouts, in that it allows you to see explicitly the cells that contain this panel's children.
Parameters
Name | Type | Description |
---|---|---|
width | Integer | the new border width, in pixels. |
Return
— the HorizontalPanel
itself, useful for chaining.HorizontalPanel
setCellHeight(widget, height)
setCellHeight(widget, height)
Deprecated. This function is deprecated and should not be used in new scripts.
Sets the height of the cell associated with the given widget, related to the panel as a whole.
This will cause an error if used with a widget that is not currently a child of the panel.
Parameters
Name | Type | Description |
---|---|---|
widget |
| the widget to use in identifying the cell. |
height | String | the height in any valid CSS unit, such as "10px" or "15cm". |
Return
— the HorizontalPanel
itself, useful for chaining.HorizontalPanel
setCellHorizontalAlignment(widget, horizontalAlignment)
setCellHorizontalAlignment(widget, horizontalAlignment)
Deprecated. This function is deprecated and should not be used in new scripts.
Sets the horizontal alignment of the given widget within its cell.
This will cause an error if used with a widget that is not currently a child of the panel.
Parameters
Name | Type | Description |
---|---|---|
widget |
| the widget to align. |
horizontalAlignment |
| the desired alignment, such as UiApp.HorizontalAlignment.CENTER. |
Return
— the HorizontalPanel
itself, useful for chaining.HorizontalPanel
setCellVerticalAlignment(widget, verticalAlignment)
setCellVerticalAlignment(widget, verticalAlignment)
Deprecated. This function is deprecated and should not be used in new scripts.
Sets the vertical alignment of the given widget within its cell.
This will cause an error if used with a widget that is not currently a child of the panel.
Parameters
Name | Type | Description |
---|---|---|
widget |
| the widget to align. |
verticalAlignment |
| the desired alignment, such as UiApp.VerticalAlignment.MIDDLE. |
Return
— the HorizontalPanel
itself, useful for chaining.HorizontalPanel
setCellWidth(widget, width)
setCellWidth(widget, width)
Deprecated. This function is deprecated and should not be used in new scripts.
Sets the width of the cell associated with the given widget, related to the panel as a whole.
This will cause an error if used with a widget that is not currently a child of the panel.
Parameters
Name | Type | Description |
---|---|---|
widget |
| the widget to use in identifying the cell. |
width | String | the width in any valid CSS unit, such as "10px" or "15cm". |
Return
— the HorizontalPanel
itself, useful for chaining.HorizontalPanel
setHeight(height)
setHeight(height)
Deprecated. This function is deprecated and should not be used in new scripts.
Sets the height of this
.HorizontalPanel
Parameters
Name | Type | Description |
---|---|---|
height | String | the new height in any CSS unit such as "10px" or "50%". |
Return
— the HorizontalPanel
itself, useful for chaining.HorizontalPanel
setHorizontalAlignment(horizontalAlignment)
setHorizontalAlignment(horizontalAlignment)
Deprecated. This function is deprecated and should not be used in new scripts.
Set the horizontal alignment of widgets added to this
.HorizontalPanel
Parameters
Name | Type | Description |
---|---|---|
horizontalAlignment |
| the desired alignment, such as UiApp.HorizontalAlignment.CENTER. |
Return
— the HorizontalPanel
itself, useful for chaining.HorizontalPanel
setId(id)
setId(id)
Deprecated. This function is deprecated and should not be used in new scripts.
Sets the id of this
.HorizontalPanel
Parameters
Name | Type | Description |
---|---|---|
id | String | the new id, which can be used to retrieve the from
app.getElementById(id). |
Return
— the HorizontalPanel
itself, useful for chaining.HorizontalPanel
setLayoutData(layout)
setLayoutData(layout)
Deprecated. This function is deprecated and should not be used in new scripts.
Set the layout for this
.
HorizontalPanel
This is not currently functional.
Parameters
Name | Type | Description |
---|---|---|
layout | Object |
Return
— the HorizontalPanel
itself, useful for chaining.HorizontalPanel
setPixelSize(width, height)
setPixelSize(width, height)
Deprecated. This function is deprecated and should not be used in new scripts.
Sets the size of this
in pixels.HorizontalPanel
Parameters
Name | Type | Description |
---|---|---|
width | Integer | the new width in pixels. |
height | Integer | the new height in pixels. |
Return
— the HorizontalPanel
itself, useful for chaining.HorizontalPanel
setSize(width, height)
setSize(width, height)
Deprecated. This function is deprecated and should not be used in new scripts.
Sets the size of this
.HorizontalPanel
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
— the HorizontalPanel
itself, useful for chaining.HorizontalPanel
setSpacing(spacing)
setSpacing(spacing)
Deprecated. This function is deprecated and should not be used in new scripts.
Sets the amount of spacing between this panel's cells.
Parameters
Name | Type | Description |
---|---|---|
spacing | Integer | the spacing, in pixels. |
Return
— the HorizontalPanel
itself, useful for chaining.HorizontalPanel
setStyleAttribute(attribute, value)
setStyleAttribute(attribute, value)
Deprecated. This function is deprecated and should not be used in new scripts.
Sets one of this
'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.
HorizontalPanel
// 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
— the HorizontalPanel
itself, useful for chaining.HorizontalPanel
setStyleAttributes(attributes)
setStyleAttributes(attributes)
Deprecated. This function is deprecated and should not be used in new scripts.
Sets this
'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.
HorizontalPanel
// 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
— the HorizontalPanel
itself, useful for chaining.HorizontalPanel
setStyleName(styleName)
setStyleName(styleName)
Deprecated. This function is deprecated and should not be used in new scripts.
Sets the style name of this
.
HorizontalPanel
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
— the HorizontalPanel
itself, useful for chaining.HorizontalPanel
setStylePrimaryName(styleName)
setStylePrimaryName(styleName)
Deprecated. This function is deprecated and should not be used in new scripts.
Sets the primary style name of this
.
HorizontalPanel
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
— the HorizontalPanel
itself, useful for chaining.HorizontalPanel
setTag(tag)
setTag(tag)
Deprecated. This function is deprecated and should not be used in new scripts.
Sets the text tag of this
.HorizontalPanel
Parameters
Name | Type | Description |
---|---|---|
tag | String | the new text tag, which can be anything you wish to store with the widget. |
Return
— the HorizontalPanel
itself, useful for chaining.HorizontalPanel
setTitle(title)
setTitle(title)
Deprecated. This function is deprecated and should not be used in new scripts.
Sets the hover title of this
.
HorizontalPanel
Not all browsers will show this.
Parameters
Name | Type | Description |
---|---|---|
title | String | the hover title. |
Return
— the HorizontalPanel
itself, useful for chaining.HorizontalPanel
setVerticalAlignment(verticalAlignment)
setVerticalAlignment(verticalAlignment)
Deprecated. This function is deprecated and should not be used in new scripts.
Set the vertical alignment of widgets added to this
.HorizontalPanel
Parameters
Name | Type | Description |
---|---|---|
verticalAlignment |
| the desired alignment, such as UiApp.VerticalAlignment.MIDDLE. |
Return
— the HorizontalPanel
itself, useful for chaining.HorizontalPanel
setVisible(visible)
setVisible(visible)
Deprecated. This function is deprecated and should not be used in new scripts.
Sets whether this
is visible.HorizontalPanel
Parameters
Name | Type | Description |
---|---|---|
visible | Boolean | whether this should be visible or not. |
Return
— the HorizontalPanel
itself, useful for chaining.HorizontalPanel
setWidth(width)
setWidth(width)
Deprecated. This function is deprecated and should not be used in new scripts.
Sets the width of this
.HorizontalPanel
Parameters
Name | Type | Description |
---|---|---|
width | String | the new width in any CSS unit such as "10px" or "50%". |
Return
— the HorizontalPanel
itself, useful for chaining.HorizontalPanel