GameShield System Feature Guide > IronWrapping > User Interface

IronWrap User Interface


Your IronWrapped application may display various user interface elements before control is passed to the entry point of your host (protected application).  These user interface elements may display anything from simple splash screens, to dynamically generated HTML reminder screens to error messages, to input dialogs that require user input.

You have the ability to:

  • Show or suppress any one of these messages or reminders.

  • Embed as many different languages as you wish.

  • Each language may show a completely different message (at least translation) for each of these messages or reminders.

Show or Suppress Messages or Reminders

Messages and reminders vary depending on the License Model selected.  Once you choose the License Model you are going to use, the list of messages and reminders for that model is populated in the License Manager. If you do not change any settings, every message will be shown when deemed necessary by the logic of the License Model.  If you choose to suppress a message or reminder, it will never be shown.  The show or suppress setting for each reminder or message in your license project applies to every language you embed.  In other words, if you choose to suppress message "HTML Splash" then that message is never shown, regardless of what language is used at run time.

Embedded Languages

There is a special language provided (called "Fall_Back") which must always be included and must always be the last language in the load order list. You do not have to explicitly choose any other embedded languages other than Fall_Back if you only intend on having a single language in your distribution. For example, if you only intend on having an English version of your messages and reminders, simply modify the Fall_Back set of messages and reminders to be English (this is the default).

 

However, if you choose to embed more than a single language in your IronWrapped product, you also must arrange the Language Load Order in descending order from most desired to least desired in the embedded language list box.  (see: IronWrap User Interface Tab)  This language load order list is used in part to determine which language to use at run time.

 

The language that is used for messages and reminders in an IronWrapped product is determined by:

 

  1. Getting from the operating system the locale of the thread (the host application itself).
     

  2. Checking if the desired language load order list in the IronWrapped product contains an exact match of the primary and sub-language identifiers that corresponds to the locale of the thread. If an exact match is found, it uses that language. The check is performed from most desired to least desired (top to bottom).
     

  3. If no exact match can be found, the check is repeated (again the check is performed from most desired to least desired) comparing only the primary language ID portion of the corresponding Language ID  (from the threads locale). The first language found, if any, in the load order list that has a matching primary language identifier is used.
     

  4. If no match is found so far, the OS is queried for the supported (installed) languages. The first load order language found that is supported (installed) on the users system is used.
     

  5. If still no match is found - the Fall_Back language is used - no matter what.  

 

Editing Messages and Reminders

Each of the messages and reminders may easily be edited and previewed in the License Manager (for each individual language).

More Information

For more information on actually manipulating the User Interface settings for your IronWrapped products (languages, messages and reminders), see: IronWrap User Interface Tab

More information about Locales and Language ID's can be found at:
http://msdn2.microsoft.com/en-us/library/ms776264.aspx

Related Topics