Application Meta Tag

PocketBrowser 3.x API

The Application Meta Tag is an action tag used to adjust the running state of PocketBrowser applications.


Application (META Tag) Syntax
<META HTTP-Equiv="Application" content="[method]">

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

Name Description
Default Value
Quit Quits PocketBrowser N/A
Minimize Minimizes PocketBrowser N/A
Restore Restores PocketBrowser to full screen N/A
Copy methods template to clipboard: Copy META Tag template to clipboard META Tags Copy Javascript template to clipboard Javascript

Modules return information back to their web pages via retrieval tags, for example the scanner has a retrieval tag called 'DecodeEvent' which is called whenever it decodes a barcode. To register to receive a retrieval tag call the module as follows:

<META HTTP-Equiv="[Module]" content="[RetrievalTag]:url('[URI]')">
So to register to retrieve the Scanner's DecodeEvent the following syntax would be used:
<META HTTP-Equiv="Scanner" content="DecodeEvent:url('Javascript:doScan('%6', '%s', %3, '%2');')">

Retrieval tags return information by replacing the text in place holders, defined as '%s' or '%<number>'. Each place holder represents 1 return value with '%s' being populated sequentially or '%<number>' providing direct acces to the desired value.

If the content for the Scanner's DecodeEvent is:

"url('Javascript:doScan('%6', '%s', %3, '%2');')"

The function would be called as follows:
"Javascript:doScan('Decode', '5449000053879', 0x35, 'SCN:EAN13');"


ApplicationEvent
The ApplicationEvent is triggered when a PocketBrowser application is minimized or restored.

ID Name Description
1 Application State "Minimized" or "Restored"
Copy this return value template to clipboard: Copy META Tag template to clipboard META Tags Copy Javascript template to clipboard Javascript



The following example causes PocketBrowser to exit when the page is loaded

<META HTTP-Equiv="Application" Content="Quit">
Copy example to clipboard Copy example to clipboard

The following example minimizes PocketBrowser when the enter key is pressed and reports its state in a message box

<META HTTP-EQUIV="OnKey0x0d" content="javascript:doTest();">
<META HTTP-EQUIV="Application" content="ApplicationEvent:url('Javascript:receivedEvent('%s');')">

<SCRIPT>
var objGeneric = new ActiveXObject("PocketBrowser.Generic");
function doTest()
{
objGeneric.InvokeMETAFunction('Application', 'Minimize');
}
function doEvent(currentState)
{
alert('PocketBrowser has been ' + currentState);
}
</SCRIPT>
Copy example to clipboard Copy example to clipboard
Minimize
When PocketBrowser is minimized it will not be visible as a task on the taskbar. To maximize PocketBrowser, launch it from the icon or shortcut.

Supported Platforms Windows CE, Windows Mobile
Persistence This tag is actioned immediately
Min. Requirements None.