Warning Older Docs! - You are viewing documentation for a previous released version of RhoMobile Suite.

NoSIP Preexisting JavaScript Object

The NoSIP Preexisting JavaScript Object contains methods which can be used to control the Soft Input Panel (on screen keyboard). If you have configured ‘PreloadLegacyNoSIP’ to be ‘1’ the JavaScript object ‘nosip’ will be inserted automatically into your page’s DOM by RhoElements. These methods should be used in conjunction with the SIP module to provide full control over the SIP

Syntax

NoSIP (Preexisting JavaScript Object) <META> Syntax

nosip.ShowSIP(true);

Methods

Name Parameters Returns
ShowSIP
Shows or Hides the SIP.
Name: bShowSIP, Values: Boolean
Description: Set to true to show the SIP, set to false to hide the SIP.

N/A

Remarks

Backwards Compatibility

The NoSIP Preexisting JavaScript Object provides backwards compatibility with code written for PocketBrowser and also supports the syntax below. Because RhoElements inserts the object ‘nosip’ on the page automatically when ‘PreloadLegacyNoSIP’ is configured to be ‘1’ you can not create your own objects by this name, see below:


<script>
  //  Old PocketBrowser syntax supported by NoSIP
  var myObj = new ActiveXObject("NoSIP.NSEdit"); 
  
  //  Note: var nosip = new ... will fail because the object already exists on the page.
  myObj.ShowSIP(true);
</script>

Backwards Compatibility with PocketBrowser NoSIP visual control

PocketBrowser provides the ability to create a ‘NoSIP’ control on the page, displayed as a text box which, when clicked, does not display the SIP. Full control over the SIP is provided in RhoElements; code which used the NoSIP visual control will need to be rewritten as a standard text input. The SIP can be disabled by following the instructions under the Configuration Setting SIP\EnableSIP.

Requirements

RhoElements Version 1.0.0 or above
Supported Devices All supported devices.
Minimum Requirements None.
Persistence Immediate - These methods are actioned immediately.

HTML/JavaScript Examples

The Following example will show or hide the SIP, depending on how the function is called:

<script>
function fnControlSIP(bShowSIP)
{
    nosip.ShowSIP(bShowSIP);
    if (bShowSIP)
        msg.innerHTML = "The SIP is Shown";
    else
        msg.innerHTML = "The SIP is Hidden";
}
</script>
Back to Top