add(child)

Adds a new widget to this application.

The new widget will be a part of the children widgets of this application. The new widget is added to the end of the list of widgets currently in the application.

Parameters

Return

UiInstance — the application itself, useful for chaining.

close()

Close the app.

This will only work if the app is being shown as a dialog, such as in a Google Spreadsheet. It will have no effect when called on an app that is published as a standalone service.

Return

UiInstance — the application itself, useful for chaining.

createAbsolutePanel()

Creates a new AbsolutePanel.

Return

AbsolutePanel — the new AbsolutePanel.

createAnchor(text, asHtml, href)

Creates a new Anchor.

This is essentially a hyperlink and represents an <a> element. This widget is based on GWT's anchor class.

Parameters

Return

Anchor — the new Anchor.

createAnchor(text, href)

Creates a new Anchor.

This is essentially a hyperlink and represents an <a> element. This widget is based on GWT's anchor class.

Parameters

Return

Anchor — the new Anchor.

createButton()

Creates a new Button.

Return

Button — the new Button.

createButton(html)

Creates a new Button.

Parameters

Return

Button — the new Button.

createButton(html, clickHandler)

Creates a new Button.

Parameters

Return

Button — the new Button.

createCaptionPanel()

Creates a new CaptionPanel.

Return

CaptionPanel — the new CaptionPanel.

createCaptionPanel(caption)

Creates a new CaptionPanel.

Parameters

Return

CaptionPanel — the new CaptionPanel.

createCaptionPanel(caption, asHtml)

Creates a new CaptionPanel.

Parameters

Return

CaptionPanel — the new CaptionPanel.

createCheckBox()

Creates a new CheckBox.

Return

CheckBox — the new CheckBox.

createCheckBox(label)

Creates a new CheckBox.

Parameters

Return

CheckBox — the new CheckBox.

createCheckBox(label, asHtml)

Creates a new CheckBox.

Parameters

Return

CheckBox — the new CheckBox.

createClientHandler()

Creates a new ClientHandler.

A ClientHandler can be used anywhere a ServerHandler can be. See the documentation of ClientHandler and the User Guide to understand how to specify what a ClientHandler will do in response to an event.

Return

ClientHandler — the new ClientHandler.

createDateBox()

Creates a new DateBox.

Return

DateBox — the new DateBox.

createDatePicker()

Creates a new DatePicker.

Return

DatePicker — the new DatePicker.

createDecoratedStackPanel()

Creates a new DecoratedStackPanel.

Return

DecoratedStackPanel — the new DecoratedStackPanel.

createDecoratedTabBar()

Creates a new DecoratedTabBar.

Return

DecoratedTabBar — the new DecoratedTabBar.

createDecoratedTabPanel()

Creates a new DecoratedTabPanel.

Return

DecoratedTabPanel — the new DecoratedTabPanel.

createDecoratorPanel()

Creates a new DecoratorPanel.

Return

DecoratorPanel — the new DecoratorPanel.

createDialogBox()

Creates a new DialogBox.

The dialog will not auto-hide and is not modal.

Return

DialogBox — the new DialogBox.

createDialogBox(autoHide)

Creates a new DialogBox.

The dialog is not modal.

Parameters

Return

DialogBox — the new DialogBox.

createDialogBox(autoHide, modal)

Creates a new DialogBox.

Parameters

Return

DialogBox — the new DialogBox.

createDocsListDialog()

Create a new DocsListDialog.

Return

DocsListDialog — the new DocsListDialog.

createFileUpload()

Creates a new FileUpload.

Return

FileUpload — the new FileUpload.

createFlexTable()

Creates a new FlexTable.

Return

FlexTable — the new FlexTable.

createFlowPanel()

Creates a new FlowPanel.

Return

FlowPanel — the new FlowPanel.

createFocusPanel()

Creates a new FocusPanel.

Return

FocusPanel — the new FocusPanel.

createFocusPanel(child)

Creates a new FocusPanel with a specified child Widget.

Parameters

Return

FocusPanel — the new FocusPanel.

createFormPanel()

Creates a new FormPanel.

Return

FormPanel — the new FormPanel.

createGrid()

Creates a new Grid.

Until the Grid is explicitly resized, no widgets can't be added to it.

Return

Grid — the new Grid.

createGrid(rows, columns)

Creates a new Grid with a specified size.

Parameters

Return

Grid — the new Grid.

createHTML()

Creates a new HTML with no text.

Return

HTML — the new HTML.

createHTML(html)

Creates a new HTML with the specified text.

Parameters

Return

HTML — the new HTML.

createHTML(html, wordWrap)

Creates a new HTML with the specified text.

Parameters

Return

HTML — the new HTML.

createHidden()

Creates a new Hidden.

Return

Hidden — the new Hidden.

createHidden(name)

Creates a new Hidden with a specified name.

Parameters

Return

Hidden — the new Hidden.

createHidden(name, value)

Creates a new Hidden with a specified name and value.

Parameters

Return

Hidden — the new Hidden.

createHorizontalPanel()

Creates a new HorizontalPanel.

Return

HorizontalPanel — the new HorizontalPanel.

createImage()

Creates a new Image.

Return

Image — the new Image.

createImage(url)

Creates a new Image with the specified URL.

Parameters

Return

Image — the new Image.

createImage(url, left, top, width, height)

Creates a new Image with the specified URL and clipping rectangle.

Parameters

Return

Image — the new Image.

createInlineLabel()

Creates a new InlineLabel with no text.

Return

InlineLabel — the new InlineLabel.

createInlineLabel(text)

Creates a new InlineLabel with the specified text.

Parameters

Return

InlineLabel — the new InlineLabel.

createLabel()

Creates a new Label with no text.

Return

Label — the new Label.

createLabel(text)

Creates a new Label with the specified text.

Parameters

Return

Label — the new Label.

createLabel(text, wordWrap)

Creates a new Label with the specified text.

Parameters

Return

Label — the new Label.

createListBox()

Creates a new ListBox.

The ListBox will not allow multiple selections.

Return

ListBox — the new ListBox.

createListBox(isMultipleSelect)

Creates a new ListBox.

Parameters

Return

ListBox — the new ListBox.

createMenuBar()

Creates a new MenuBar.

The MenuBar will display itself horizontally.

Return

MenuBar — the new MenuBar.

createMenuBar(vertical)

Creates a new MenuBar.

Parameters

Return

MenuBar — the new MenuBar.

createMenuItem(text, asHtml, command)

Creates a new MenuItem.

Parameters

Return

MenuItem — the new MenuItem.

createMenuItem(text, command)

Creates a new MenuItem.

Parameters

Return

MenuItem — the new MenuItem.

createMenuItemSeparator()

Creates a new MenuItemSeparator.

Return

MenuItemSeparator — the new MenuItemSeparator.

createPasswordTextBox()

Creates a new PasswordTextBox.

Return

PasswordTextBox — the new PasswordTextBox.

createPopupPanel()

Creates a new PopupPanel.

The panel will not auto-hide and is not modal.

Return

PopupPanel — the new PopupPanel.

createPopupPanel(autoHide)

Creates a new PopupPanel.

The panel is not modal.

Parameters

Return

PopupPanel — the new PopupPanel.

createPopupPanel(autoHide, modal)

Creates a new PopupPanel.

Parameters

Return

PopupPanel — the new PopupPanel.

createPushButton()

Creates a new PushButton.

Return

PushButton — the new PushButton.

createPushButton(upText)

Creates a new PushButton.

Parameters

Return

PushButton — the new PushButton.

createPushButton(upText, clickHandler)

Creates a new PushButton.

Parameters

Return

PushButton — the new PushButton.

createPushButton(upText, downText)

Creates a new PushButton.

Parameters

Return

PushButton — the new PushButton.

createPushButton(upText, downText, clickHandler)

Creates a new PushButton.

Parameters

Return

PushButton — the new PushButton.

createRadioButton(name)

Creates a new RadioButton.

Parameters

Return

RadioButton — the new RadioButton.

createRadioButton(name, label)

Creates a new RadioButton.

Parameters

Return

RadioButton — the new RadioButton.

createRadioButton(name, label, asHtml)

Creates a new RadioButton.

Parameters

Return

RadioButton — the new RadioButton.

createResetButton()

Creates a new ResetButton.

Return

ResetButton — the new ResetButton.

createResetButton(html)

Creates a new ResetButton.

Parameters

Return

ResetButton — the new ResetButton.

createResetButton(html, clickHandler)

Creates a new ResetButton.

Parameters

Return

ResetButton — the new ResetButton.

createScrollPanel()

Creates a new ScrollPanel.

Return

ScrollPanel — the new ScrollPanel.

createScrollPanel(child)

Creates a new ScrollPanel with a specified child Widget.

Parameters

Return

ScrollPanel — the new ScrollPanel.

createServerHandler()

Creates a new ServerHandler.

Server handlers are used by scripts to launch script functions in response to events in the application. For example, a server handler can be added to a Button with the addClickHandler method so that the handler will be invoked when the button is clicked.

Return

ServerHandler — a new ServerHandler object.

createServerHandler(functionName)

Creates a new ServerHandler.

Server handlers are used by scripts to launch script functions in response to events in the application. For example, a server handler can be added to a Button with the addClickHandler method so that the handler will be invoked when the button is clicked.

Parameters

Return

ServerHandler — a new ServerHandler object.

createSimpleCheckBox()

Creates a new SimpleCheckBox.

Return

SimpleCheckBox — the new SimpleCheckBox.

createSimplePanel()

Creates a new SimplePanel.

Return

SimplePanel — the new SimplePanel.

createSimpleRadioButton(name)

Creates a new SimpleRadioButton.

Parameters

Return

SimpleRadioButton — the new SimpleRadioButton.

createSplitLayoutPanel()

Creates a new SplitLayoutPanel.

Return

SplitLayoutPanel — the new SplitLayoutPanel.

createStackPanel()

Creates a new StackPanel.

Return

StackPanel — the new StackPanel.

createSubmitButton()

Creates a new SubmitButton.

Return

SubmitButton — the new SubmitButton.

createSubmitButton(html)

Creates a new SubmitButton.

Parameters

Return

SubmitButton — the new SubmitButton.

createTabBar()

Creates a new TabBar.

Return

TabBar — the new TabBar.

createTabPanel()

Creates a new TabPanel.

Return

TabPanel — the new TabPanel.

createTextArea()

Creates a new TextArea.

Return

TextArea — the new TextArea.

createTextBox()

Creates a new TextBox.

Return

TextBox — the new TextBox.

createToggleButton()

Creates a new ToggleButton.

Return

ToggleButton — the new ToggleButton.

createToggleButton(upText)

Creates a new ToggleButton.

Parameters

Return

ToggleButton — the new ToggleButton.

createToggleButton(upText, clickHandler)

Creates a new ToggleButton.

Parameters

Return

ToggleButton — the new ToggleButton.

createToggleButton(upText, downText)

Creates a new ToggleButton.

Parameters

Return

ToggleButton — the new ToggleButton.

createTree()

Creates a new Tree.

Return

Tree — the new Tree.

createTreeItem()

Creates a new TreeItem.

Return

TreeItem — the new TreeItem.

createTreeItem(text)

Creates a new TreeItem with the given text.

Parameters

Return

TreeItem — the new TreeItem.

createTreeItem(child)

Creates a new TreeItem with the given widget.

Parameters

Return

TreeItem — the new TreeItem.

createVerticalPanel()

Creates a new VerticalPanel.

Return

VerticalPanel — the new VerticalPanel.

getElementById(id)

Retrieves a generic reference to an element stored in the application, by its id.

The reference is not 'aware' of whether any such widget actually exists. If there is no widget with the given id, or if there is such a widget but the method you call on it does not exist for that widget type, this will cause an error on the client when the UiInstance is returned.

This can be used to get existing widgets in the application when writing event handling code. To set a widget's id, use the method setId of the target widget. For Example:

 
function doGet() {
   var app = UiApp.createApplication();

   // create a label and set its id to 'labelId'
   var label = app.createLabel("Hello").setId('labelId');

   var button = app.createButton("OK", app.createServerHandler('onClick'));
   app.add(label).add(button);
   return app;
 }

 function onClick(event) {
   var app = UiApp.getActiveApplication();

   // retrieve the label from the application by id
   var label = app.getElementById('labelId');
   label.setText("World!");
   return app;
 }
 

Parameters

Return

Component — a reference to a widget with that id

getId()

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

isStandardsMode()

Gets whether the UiApp displays in HTML 'standards' mode or in 'quirks' mode.

Return

Boolean — whether the UiApp displays in HTML 'standards' mode or in 'quirks' mode

loadComponent(componentName)

Load a GUI Builder component into UiApp, by name.

Parameters

Return

Component — the component, which can be added to an app

loadComponent(componentName, optAdvancedArgs)

Load a GUI Builder component into UiApp, by name.

Parameters

Return

Component — the component, which can be added to an app

remove(index)

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

Parameters

Return

UiInstance — the application itself, useful for chaining.

remove(widget)

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

Parameters

Return

UiInstance — the application itself, useful for chaining.

setHeight(height)

Sets the application's height.

This affects the height of the application when run as a service or the height of a dialog when an application is shown inside a spreadsheet.

Parameters

Return

UiInstance — the application itself, useful for chaining.

setStandardsMode(standardsMode)

Set whether the UiApp displays in HTML 'standards' mode or in 'quirks' mode.

By default UiApp uses 'quirks' mode unless you use a GUI Builder component with loadComponent, in which case it defaults to 'standards'.

Parameters

Return

UiInstance — this UiInstance, useful for chaining

setStyleAttribute(attribute, value)

Sets one of the application's style attributes to a new value.

Possible attributes are the same as those available in CSS style sheets. Since some CSS code may be malicious, attributes are whitelisted explicitly and therefore some CSS attributes may not be available.

The following example shows an application which background and text color is changed:

 
function doGet() {
   var app = UiApp.createApplication();

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

   // create a label
   var label = app.createLabel("Hello World!");

   app.add(label)
   return app;
 }
 

Parameters

Return

UiInstance — the application itself, useful for chaining.

setTitle(title)

Sets the title of the application.

If this application will be run as a service, this will be used as the title of the page. If this application will be run as a dialog (for example inside a spreadsheet) it will be the title of the dialog's window.

Parameters

Return

UiInstance — the application itself, useful for chaining.

setWidth(width)

Sets the application's width.

This affects the width of the application when run as a service or the width of a dialog when an application is shown inside a spreadsheet.

Parameters

Return

UiInstance — the application itself, useful for chaining.