TitleBar: Difference between revisions

From NSB App Studio
Jump to navigation Jump to search
Brendon (talk | contribs)
No edit summary
 
(7 intermediate revisions by 3 users not shown)
Line 3: Line 3:
[[file:TitleBar2.jpg]]
[[file:TitleBar2.jpg]]


'''Description'''
== Description ==
 
'''This control is part of iWebKit, which has been deprecated.'''


The Titlebar is used to display a title at the top of the screen.  
The Titlebar is used to display a title at the top of the screen.  
Line 11: Line 13:
To add a button to your app, choose the Titlebar icon in the Toolbar. It will automatically position at the top of the screen. Use the Property Editor to set the properties. Do not give any of your forms the same name as one of your buttons.
To add a button to your app, choose the Titlebar icon in the Toolbar. It will automatically position at the top of the screen. Use the Property Editor to set the properties. Do not give any of your forms the same name as one of your buttons.


'''Properties'''
== Properties ==


Standard [[properties and methods|properties]] are supported, plus:
Standard [[properties and methods|properties]] are supported, plus:
{| class = "wikitable"
{| class = "wikitable"
|-
|-
| leftButtonName || The title of a button on the left. If there is more than one, separate by commas. If the name is home, info, setup, plus, minus, back or forward, a graphic is substituted. (Design time)
| leftButtonName || The title of a button on the left. If there is more than one, separate by commas. If the name is home, info, setup, plus, minus, back or forward, a graphic is substituted. Do not use the same name as a form in your project. (Design time)
|-
|-
| leftButtonStyle || ''leftnav'' for a left arrow button,
| leftButtonStyle || ''leftnav'' for a left arrow button,
Line 31: Line 33:
|}
|}


'''Events'''
== Events ==


In addition to the standard [[events|events]], TitleBar has a modified version of onclick.
In addition to the standard [[events|events]], TitleBar has a modified version of onclick.
Line 39: Line 41:
|}
|}


'''Example'''
== Example ==


<pre>
<pre>
Line 47: Line 49:
</pre>
</pre>


'''Output'''
 
 
Changing the title at runtime
<pre>
TitleBar1.nextElementSibling.childNodes[3].innerHTML = "new title"
</pre>
The [3] is not a constant value. It may depend on number of buttons on the titlebar.
 
== Output==


[[file:TitleBarOutput.jpg]]
[[file:TitleBarOutput.jpg]]
[[Category:Language Reference]]
[[Category:Controls]]
[[Category:iWebKit]]

Latest revision as of 19:08, 15 February 2014

Description

This control is part of iWebKit, which has been deprecated.

The Titlebar is used to display a title at the top of the screen.

It has the option of having buttons on the left or right hand size. These buttons can be text or images, and can have multiple sections.

To add a button to your app, choose the Titlebar icon in the Toolbar. It will automatically position at the top of the screen. Use the Property Editor to set the properties. Do not give any of your forms the same name as one of your buttons.

Properties

Standard properties are supported, plus:

leftButtonName The title of a button on the left. If there is more than one, separate by commas. If the name is home, info, setup, plus, minus, back or forward, a graphic is substituted. Do not use the same name as a form in your project. (Design time)
leftButtonStyle leftnav for a left arrow button,

button for a plain button,

blueleftbutton for a plain blue button. Only leftnav can have multiple styles or names. (Design time)

rightButtonName Similar to leftButtonStyle. (Design time)
rightButtonStyle Similar to leftButtonStyle. (Design time)
title The text of the bar. (Design time)

Events

In addition to the standard events, TitleBar has a modified version of onclick.

onclick(choice) The Name of the button that was clicked is passed to onclick() as a parameter.

Example

Function TitleBar1_onclick(choice)
  MsgBox "choice is " & choice
End Function


Changing the title at runtime

TitleBar1.nextElementSibling.childNodes[3].innerHTML = "new title"

The [3] is not a constant value. It may depend on number of buttons on the titlebar.

Output