SIP Meta Tag

PocketBrowser 3.x API

The SIP Meta Tag is used to control attributes of the soft input panel (SIP), also known as the software keyboard. Settings apply to text boxes on the current page as well as the address bar.

SIP (META Tag) Syntax
<META HTTP-Equiv="SIP" content="[method / parameter>

Items listed in this section indicate methods or, in some cases, indicate parameters which will be retrieved.

Name Description
Default Value
Manual When shown by the SIP Button, will show and hide when text boxes have focus (See Remarks) Device Specific
Automatic Shows and hides when text boxes have focus (See Remarks). Applying SIP control Automatic will prevent SIP control Manual being applied in the same application. To return to Manual SIP control you can press a hardware key. Device Specific
Copy methods template to clipboard: Copy META Tag template to clipboard META Tags Copy Javascript template to clipboard Javascript

Items listed in this section indicate parameters, or attributes which can be set.

Name Possible Values Description
Default Value
Left:[Value] Horizontal position, in pixels Sets the horizontal position of the SIP in pixels Center of the screen
Top:[Value] Vertical position, in pixels Sets the vertical position of the SIP in pixels Bottom of the screen
Copy parameters template to clipboard: Copy META Tag template to clipboard META Tags Copy Javascript template to clipboard Javascript

The following example moves the SIP to sit at the bottom of a 1/4 VGA screen:

<META HTTP-Equiv="SIP" Content="Left:0;Top:240">
Copy example to clipboard Copy example to clipboard

To completely disable the use fo the SIP it can be positioned off the visible area of the screen.

<META HTTP-Equiv="SIP" Content="Left:640;Top:0">
Copy example to clipboard Copy example to clipboard

The following example sets the SIP to manual:

<META HTTP-Equiv="SIP" Content="Manual">
Copy example to clipboard Copy example to clipboard
Applicable Platforms
Manual and Automatic methods applies to both Windows Mobile and Windows CE platform.

Disabling the SIP
If you want to completely disable to the use of the SIP, set it to appear off the visible area of the screen (see example above).

Interaction with Hardware Keyboard
The SIP used is the standard keyboard input panel supplied with Windows. Certain incompatibilities exist when using the software keyboard on a device which also has a hardware keyboard though this will have no impact on the average user. For example moving the SIP will reset the alpha or function key (orange or blue key) lock and using the orange or blue keys may reset the position of the SIP on certain devices. Also note that if you press a hardware key the SIP will disappear and you will need to press the SIP button again to get it to appear (or invoke the SIP control Automatic state again)


Supported Platforms Windows CE, Windows Mobile.
Persistence This tag is persistent. Moving the SIP may also persist after PocketBrowser has been shut down, depedant on Operating System.
Min. Requirements None.