View source for TitleBar

[[file:TitleBar1.jpg]]

[[file:TitleBar2.jpg]]

== 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 and methods|properties]] are supported, plus:
{| 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. 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|events]], TitleBar has a modified version of onclick.
{| class="wikitable"
|-
| onclick(''choice'') || The Name of the button that was clicked is passed to onclick() as a parameter.
|}

== Example ==

<pre>
Function TitleBar1_onclick(choice)
  MsgBox "choice is " & choice
End Function
</pre>



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]]

[[Category:Language Reference]]

[[Category:Controls]]

[[Category:iWebKit]]