Appendix A : Éléments de Référence ..:Menu::.

<home></home>..:Menu::.

Le tag <home> encapsule entièrement la disposition du "home screen". Il n' pas d' attributs. { le "home screen" ou la skin ou la page d' accueil )

Exemple:

<home>
    contenu
</home>

<plugin></plug-in>..:Menu::.

Le tag <plugin> est utilisé pour insérer un plug-in dans le "home screen".

Table 5. Attributs requis :

L' élément du plug-in peut contenir plusieurs sous-éléments qui compléterons la mise en forme du plug-in.

Exemple:

<plugin file="sysplug.dll" clsid="{E09043DF-510E-4841-B652-388316977A7A}" height="20">
    Â?
</plug-in>

<background></background>..:Menu::.

Ce tag optionnel désigne le fond d' écran du "home screen" ainsi que ceux des plug-ins, individuellement.

Table 6. Attributs optionnels :

Note : Les bordures et les couleurs des bordures sont seulement admisent sur l' arrière plan des plug-ins et non pas sur la totalité de l' arrière plan.

L' élément d' arrière plan peut aussi prendre un sous élément <format/> standard pour chevaucher la mise en forme de l'arrière plan pour un état spécifique du plug-in (comme quand on le sélectionne). Seul les attributs du tableau ci dessus sont utilisé dans le tag <format/>. Tout les autres attributs (comme x ou y) sont ignorés.

Exemple:

<plugin file="sysplug.dll" clsid="{44FA0F8C-082F-42b4-BE49-82559F23D5D4}">
    <background bgcolor="#FFFFFF"/>
   
    <time bgcolor="#0000FF" fgcolor="#FFFF00" mode="24"/>
    <date bgcolor="#0000FF" fgcolor="#FF00FF" mode="long"/>
</plug-in>

<text></text>..:Menu::.

Ce tag sert à écrire du texte dans un plug-in. Grâceà plusieurs attributs, il permet de faire fonctionner une skin en plusieurs langues.

Table 7. Attributs requis :

Note : Si le langage requis par le système n' est pas trouvé, le texte pour l' anglais sera pris en considération. Si le texte en anglais n' est pas trouvé, la première langue valable sera utilisée.

Exemple:

<label bgtext="#FFFFFF">
	<text lang="0x0409">Hello</text>
   <text lang="0x040c">Bonjour</text>
</label>

<format/>..:Menu::.

Cette balise est utilisée pour changer l' apparence par défaut du texte dans le plug-in.

Table 8. Optional attributes

Les couleurs sont spécifié au format Hexadécimale. Comme en HTML/CSS. (#RRVVBB)

L' attribut state est utilisé pour donner un état spécifique au plug-in qui change toute les valeurs déjà spécifiées de l' élément parent. Si des attributs du tag <format/> ne sont pas indiqués, ils seront hérités de l' élément parent, le tag <default>, et les valeurs par défauts spécifiés dans le tableau ci-dessus (dans cet ordre).

Exemple:

<plugin file="sysplug.dll" clsid="{5419F376-6520-4407-B8B8-740F5B353EDA}">
    <label bgtext="#FFFFFF" fgcolor="#000000">
       <format state="selected" bgtext="#0000FF"/>
       <text>Hello</text>
       </label>
</plug-in>
      

<default></default>..:Menu::.

Ce tag permet de formater le texte par défaut de tout les plug-ins dans l' ensemble. Il accepte les attributs standard de <format/>. Il peut aussi contenir les sous-éléments de <format/>.

Exemple:

<default bgtext="#FFFFFF" fgcolor="#FFFFFF">
   <format state="selected" bgtext="#0000FF">
</default>
      

<scheme></scheme>..:Menu::.

La balise <scheme> contient toutes les couleurs ainsi que les dégradés pour le téléphone. Celui ci permet au développeur de faire coïncider le graphisme du 'home screen' avec le téléphone tout entier.

Un élément est accepté avec la balise <scheme> Le tag à besoin d' un nom et d' une valeur d' attribut, et sera utilisé pour configurer les couleurs du téléphone, telle que la couleur de fond de fenêtre. La couleur 'transparent' n' est pas prise en comptes dans <scheme>.

Le tableau suivant fait la liste des attributs de couleur supportés par Smartphone 2002.

Table 9. Attributs de couleurs pour Smartphone 2002

Appendix B: Référence des plug-ins..:Menu::.

Icon Bar Plug-In (plug-in barre-d' icônes)..:Menu::.

Description: Montre le status du téléphone avec des icônes (batterie, en charge, GPRS, ...)

Adaptation du texte si nécessaire: Pas applicable.

Peut être sélectionné : Non.

Caché si le téléphone est verrouillé : Non.

Class ID: {837FC251-FE69-43ad-84E0-EBCEDEBA0884}

Ces groupes d'icones sont utilisés dans icon bar:

Group 1: Nouveau message vocal, Nouveau SMS, Nouveau E-mail, Nouveau Fax, Notification IM SIM pleine, vide.

Group 2: Erreur de synchronisation, couverture GPRS.

Group 3: Son coupé, vide.

Group 4: Roaming, vide.

Group 5: Call forward, blank

Group 6: Appel manqué, vide.

Group 7: Ligne sélectionné, vide.

Group 8: Batterie en chargement, Batterie faible, Batterie forte.

Group 9: Appel en ligne, Appel voix actif, Appel data actif, radio coupé, Pas de carte SIM, pas de service, force du signal.

L' ordre de chaque icône dans un groupe indique l' ordre de priorité du plus haut au plus bas. Par exemple, si vous avez un nouveau message vocal et un nouvel e-mail, l' icône du message vocal sera prioritaire.

Les groupes sont positionnés comme ceci sur un écran de 160 x 240 :

Figure 3.Position des groupes d'icones sur un écran de 160 x 240.

Sur des largeurs d' écrans supérieure à 160 x 240, le groupe 1 est ancré sur le côté gauche de l' icon-bar. Les icônes restantes sont justifiées à droite, avec un espace vide entre le groupe 1 et 2 comme voulu.

Le plug-in icon bar peut être configuré en utilisant L' élément<iconbar/>. Les attributs optionnels suivant seront supportés :

Table 10. Attributs optionnel de <iconbar/>

Pour contrôler l' arrière plan de l'icon bar, utilisez le tag <background/>. L' exemple ci dessous montre comment faire pour le plug-in :

<plugin file="sysplug.dll" clsid="{837FC251-FE69-43ad-84E0-EBCEDEBA0884}">
	<iconbar fgcolor="#FFFF00"/>
	<background bgcolor="#0000FF"/>
</plugin>
      

Carrier/SIM Plug-In..:Menu::.

Description: Displays current PLMN and SIM status errors.

Adaptation du texte si nécessaire: Oui.

Peut être sélectionné : Non.

Caché si le téléphone est verrouillé : Non.

Class ID: {E09043DF-510E-4841-B652-388316977A7A}

Le tag <carrier/> est la seule variable supporté. Cette balise nous montre ce qui suit dans le tableau suivant :

Table 11. Status courant du Carrier

En addition du tag <label/>, le carrier/SIM plug-in peut introduire la date l' heure et l'élement horloge <date/> <time/> et <clock>. Ces éléments ont les mêmes fonctions que les éléments <date/> et <time/> du plug-in clock.

Ce bout de code XML vous montres un petit exemple :

<plugin file="sysplug.dll" clsid="{E09043DF-510E-4841-B652-
  388316977A7A}" height="40">
    <label>
       <text><carrier/></text>
    </label>
    <clock>
       <time y="17"/>
    </clock>
</plugin>
      

Note : Référez-vous aux informations du plug-in clock pour plus d' information. Pour contrôlez l' arrière plan du plug-in, utilisez, le tag <background/>.

Call Progress Plug-in (plug-in Appel en action ^^ )..:Menu::.

Description: Montre le statut d' appels téléphoniques, de renvoi d' appel, et d' appel actifs excepté.

Adaptation du texte si nécessaire : Oui.

Peut être sélectionné : Oui, quand vous devez répondre à un appel. Lance le programme d' appel en cour. Non quand l' appel n' est pas en cour.

Caché si le téléphone est verrouillé : Non.

Class ID: {37391041-C324-4725-BEE1-3232ED3539CA}

L' élément<progress/> est la seule variable supporté. Ce tag indique l' état de l' appel en cour suivant le tableau suivant :

Table 12. Valeur pour l' état de l' appel en cour

L' information d' identification de l' appelant est une information , dans l' ordre des propriétés de la plus haute à la plus basse : Number Blocked, Number unavailable, Nom de l' appelant (si il est accessible via les contacts ou par le réseau), numéro de l' appelant

En plus de règlement<label>, la balise <format/> peut spécifier au niveau supérieur du plug-in de cacher celui-ci entièrement quand il n'y a pas d' appel Pour ce comportement, le XML est comme suit :

<format state="nocall" visible="false"/>
      

Si ce tag est omis, le plug-in est vu quand il n'y a pas d' appel en cour. Pour ajouter un arrière-plan à ce plug-in, nous pouvons utiliser la balise <background/>.

L' exemple XML suivant nous montres un exemple d' exécution pour ce plug-in:

<plugin file="sysplug.dll" clsid="{37391041-C324-4725-BEE1-3232ED3539CA}" height="41">
    <background>
       <format state="selected" bgcolor="#2A2CC5"/>
    </background>
    <format state="nocall" visible="false"/>
    <label>
       <text lang="0x0409">Call in progress:</text>
       <text lang="0x0809">Call in progress:</text>
       <text lang="0x040c">Appel en cours:</text>
       <text lang="0x0407">Anruf in AusfÃ?¼hrung:</text>
       <text lang="0x0410">Chiamata in corso:</text>
       <text lang="0x0816">Chamada em curso:</text>
       <text lang="0x040a">Llamada en curso:</text>
    </label>
    <label y="17">
       <text><progress/></text>
    </label>
</plugin>
      

Clock Plug-In (plug-in de l' heure)..:Menu::.

Description: Affiche la date ou le temps système.

Adaptation du texte si nécessaire : Oui.

Peut être sélectionné : Non.

Caché si le téléphone est verrouillé : Non.

Class ID: {44FA0F8C-082F-42b4-BE49-82559F23D5D4}

Ce plug-in se compose des éléments <date/> et <time/>. Si ces éléments sont omis, rien ne sera affiché. En plus des attributs de format standard, <date/> et <time/> acceptent L' attribut du tableau suivant :

Table 13. Attributs optionnels

Le code XML ci dessous nous montres un exemple:

<plugin file="sysplug.dll" clsid="{44FA0F8C-082F-42b4-BE49-82559F23D5D4}">
    <time bgtext="#0000FF" fgcolor="#FFFF00" mode="24"/>
    <date bgtext="#0000FF" fgcolor="#FF00FF" mode="long"/>
</plugin>
      

Missed Calls Plug-In (plug-in appels manqués)..:Menu::.

Description:Affiche le nombre d' appels manqués.

Adaptation du texte si nécessaire : Oui.

Peut être sélectionné : Oui, lance l' historique des appels si on clique.

Caché si le téléphone est verrouillé : Non.

Class ID: {0BA8ABB8-1F1D-417f-88C6-DA8530E2E7A6}

L' élément<calls/> est la seule variable supporté. Pour contrôler l' arrière plan du plug-in, utilisez le tag <background/>. Pour cacher le plug-in quand il n'y a pas d' appels manqués, utilisez L' attribut state="nocall" du tag<format/>

Le code XML suivant montre un exemple pour ce plug-in :

<plugin clsid="{0BA8ABB8-1F1D-417f-88C6-DA8530E2E7A6}" name="missedcalls" height="20">
    <background>
       <format state="selected" bgcolor="COLOR_HOMEHIGHLIGHT"/>
    </background>
       <format state="nocall" visible="false"/>
    <label h="16">
       <text lang="0x0409">Missed calls: <calls/></text>
    </label>
</plugin>
      

Profile Plug-In (plug-in du profil)..:Menu::.

Description: Affiche le profil actif.

Adaptation du texte si nécessaire : Oui.

Peut être sélectionné : Oui, lance le programme pour changer de profil si on clique.

Caché si le téléphone est verrouillé : Non.

Class ID: {95976968-45D5-40c9-9779-2B859B1C2FEC}

L' élément<profile/> est la seule variable acceptée. Pour contrôler l' arrière plan du plug-in, utilisez le tag <background/>.

Voici un exemple XML:

 
<plugin file="sysplug.dll" clsid="{95976968-45D5-40c9-9779-2B859B1C2FEC}"
    height="20">
   <background b-border-width="0">
      <format state="selected" bgcolor="#2A2CC5"/>
   </background>
   <label>
      <text lang="0x0409">Profile: <profile/></text>
      <text lang="0x0809">Profile:<profile/></text>
      <text lang="0x040c">Profil: <profile/></text>
      <text lang="0x0407">Profil: <profile/></text>
      <text lang="0x0410">Profilo: <profile/></text>
      <text lang="0x0816">Perfil: <profile/></text>
      <text lang="0x040a">Perfil: <profile/></text>
   </label>
</plugin>
      

Cell Broadcast/SIM Toolkit Plug-In..:Menu::.

Description: .Émission de cellules d' affichages et messages Toolkit-connexes de SIM (???). Displays cell broadcast- and SIM Toolkit-related messages

Adaptation du texte si nécessaire : Non (Le texte défile horizontalement quand le plug-in a le focus).

Peut être sélectionné : Oui.

Caché si le téléphone est verrouillé : Non.

Class ID: {4e822425-a00f-497c-80ff-1c554665a369}

Le texte utilise L' élément<scrolltext> et ses attributs source de texte. Pour contrôler l' arrière plan, <background/>.

Le tableau suivant nous montres les attributs de <scrolltext>

Table 14. Supported <scrolltext> attributes

Le plug-in est seulement visible si L' attribut spécifié dans <scrolltext>à un texte à afficher. (if the SIM Toolkit application has specified an idle text message, or an immediate cell broadcast message has been received, for example).

Le XML ci dessous nous montre L' exemple

<plugin clsid="{4e822425-a00f-497c-80ff-1c554665a369}" name="cooltext" height="20">
    <scrolltext textsource="cellbroadcast"/>
    <background>
       <format state="selected" bgcolor="COLOR_HOMEHIGHLIGHT"/>
    </background>
</plugin>

Text Label Plug-In (plug-in du texte statique)..:Menu::.

Description: Affiche du texte statique.

Adaptation du texte si nécessaire : Oui.

Peut être sélectionné : Non.

Caché si le téléphone est verrouillé : Non.

Class ID: {5419F376-6520-4407-B8B8-740F5B353EDA}

Le texte est écrit entre les balises <label>.Pour contrôlez l' arrière plan <background/>.

Example XML :

<plugin file="sysplug.dll" clsid="{5419F376-6520-4407-B8B8-740F5B353EDA}">
    <label bgtext="#FFFFFF">
       <text lang="0x0409">Hello</text>
       <text lang="0x040c">Bonjour</text>
    </label>
</plugin>
      

Calendar Plug-In (plug-in Calendrier)..:Menu::.

Description:Montre le prochain rendez-vous de l' agenda de l' utilisateur.

Adaptation du texte si nécessaire : Oui.

Peut être sélectionné : Oui, l' action lance le calendrier.

Caché si le téléphone est verrouillé : Non.

Class ID: {865A354A-4A96-4687-B001-C155DC0DBE76}

Les variables suivantes sont supportées : <subject/>, <location/>, et <time/>. Cela affichera le sujet du rendez-vous, l' endroit et le temps tu rendez-vous.

Si le rendez-vous se tiens le jour courant, seulement le temps de début est montré par la variable <time/>. Si le rdv se tiens demain (1 jour dans le futur), les deux paramètres date et time seront montrés. La date et l' heure sont formater en utilisant la date et l' heure courante dans le paramètrage régional.

Un icône de conflit de rendez-vous peut être positionné en utilisant la balise <conflict>. Si le rdv qui doit être affiché est en conflict avec un autre, un icône apparaîtà l' endroit spécifié par la balise <format/> utilisant les attributs x et y. A part ces deux attributs, tout les autres sont ignoré dans la balise <format/> pour l' icône de conflict.

Quand il y a un conflict, afin de pouvoir affichez un rendez vous, il y a une commande de priorité : Busy, tentive, free

La priorité du rendez-vous n' est pas considérée. Si plus d' un rendez-vous a la même priorité, l' ordre des rendez-vous dans la base de données détermine celui qui sera affiché. Les rendez-vous pris sur le dispositif n'auront pas une priorité à synchroniser avec le dessus de bureau.

Pour contrôler l' arrière plan : <background/>.

Exemple XML :

<plugin file="sysplug.dll" clsid="{865A354A-4A96-4687-B001-C155DC0DBE76}" height="40">
    <background>
       <format state="selected" bgcolor="#2A2CC5"/>
    </background>
    <label h="16">
       <text><subject/></text>
    </label>
    <label y="17">
       <text><time/></text>
    </label>
</plugin>
      

All-Day Event Plug-In (plug in événements de tout les jours :o) )..:Menu::.

Description: Affiche LE rendez vous du jour des rendez-vous de tous les jours dans l' agenda de l'utilisateur...Displays one of today's all-day appointments on the user's schedule.

Adaptation du texte si nécessaire : Oui.

Peut être sélectionné :Oui, l' action lance le calendrier.

Caché si le téléphone est verrouillé : Non.

Class ID: {2FFD93B3-0FF0-4228-A6D6-D2DF177D7D92}

La seule variable supporté est la variable <subject/> qui affiche le rdv du jour de tout les jours !.

En l'ajoutant à L' élément<label>, une balise <format/> peut spécifier au plus haut niveau des plug-in de cacher entièrement si il n' existe pas déversement pour la date courante.

Le XML pour se comportement est le suivant :

<format state="noevent" visible="false"/>

Si ce code est omis, le plug-in sera toujours visible bien qu' il n'y ai pas de rdv.

L' ordre de sélection d' un rdv pour être affiché est le suivant : Busy, Tentavi, Free.

Pour contrôler l' arrière plan : <background/>.

Le fichier XML :

<plugin file="sysplug.dll" clsid="{2FFD93B3-0FF0-4228-A6D6-D2DF177D7D92}" height="20">
    <background>
       <format state="selected" bgcolor="#2A2CC5"/>
    </background>
<format state="noevent" visible="false"/>
    <label h="16">
       <text><subject/></text>
    </label>
</plugin>

Messaging Counts Plug-In (Plug-in compteur de message)..:Menu::.

Description: Affiche le nombre de message non lus.

Adaptation du texte si nécessaire : Oui.

Peut être sélectionné : Oui, l' action lance la boite de réception.

Caché si le téléphone est verrouillé : Non.

Class ID: {2F930BF0-6FE9-4a53-9E17-88E9247BAB48}

Les variables suivantes sont supportées : <unreadEmail/>, <unreadSMS/>,<unreadMMS/> et <unreadVMail/>.
Ils montrent le nombre de mail, sms, ... messages non lus. Le compte de voice mail est fonction du réseau.

Pour contrôler l' arrière plan : <background/>.

Le code XML

<plugin file="sysplug.dll" clsid="{2F930BF0-6FE9-4a53-9E17-88E9247BAB48}" height="20">
    <background>
       <format state="selected" bgcolor="#2A2CC5"/>
    </background>
    <label>
       <text lang="0x0409">E-mail (<unreadEmail/>), SMS (<unreadSMS/>)</text>
       <text lang="0x0809">E-mail (<unreadEmail/>), SMS (<unreadSMS/>)</text>
       <text lang="0x040c">email (<unreadEmail/>), SMS  (<unreadSMS/>)</text>
       <text lang="0x0407">E-Mails (<unreadEmail/>), SMS (<unreadSMS/>)</text>
       <text lang="0x0410">E-mail (<unreadEmail/>), SMS (<unreadSMS/>)</text>
       <text lang="0x0816">Correio (<unreadEmail/>), SMS (<unreadSMS/>)</text>
       <text lang="0x040a">Correo (<unreadEmail/>), SMS (<unreadSMS/>)</text>
    </label>
</plugin>

Owner Info Plug-In (plug-in des infos de l'utilisateur)..:Menu::.

Description: Affiche les informations du propriétaire à partir du panneau de contrôle

Adaptation du texte si nécessaire : Oui.

Peut être sélectionné : Non.

Caché si le téléphone est verrouillé : Non

Class ID: {4824B576-EFFE-45cf-BAE9-649B930CD244}

Les variables suivantes sont supportées : <name/>, <phone/>, <email/>, et<notes/>. Elles montrent respectivement le nom du propriétaire, le numéro de téléphone, l' adresse e-mail et les notes du propriétaires.

Pour contrôler l' arrière plan du plug-in, utilisez le tag <background/>.

Exemple XML pour ce plug-in :

<plugin file="sysplug.dll" clsid="{4824B576-EFFE-45cf-BAE9-
  649B930CD244}" height="20">
    <background>
       <format state="selected" bgcolor="#2A2CC5"/>
    </background>
    <label>
       <text><name/></text>
    </label>
</plugin>

MRU Plug-In (plug-in des applications dernièrement utilisées)..:Menu::.

Description: Affiche les icônes des applications que vous avez utilisées.

Adaptation du texte si nécessaire : Oui.

Peut être sélectionné : Oui

Caché si le téléphone est verrouillé : Non

Class ID: {79EFB752-CB70-446d-B317-499723482B3D}

Les icônes du plug-in MRU sont positionnées en utilisant L' élément<mru/>. Le tableau suivant liste les attributs supportés par cet éléments.

Table 15. Tableau des attributs supportés par L' élément<mru/>.

Si button-image n' est pas spécifié, l' espace entre les icônes sur la ligne est défini comme suit pour des icônes de 32x32 :

Figure 4. Espace entre les icônes de 32x32.

Pour les icônes de 16x16, c' est comme ceci :

Figure 5. Espace entre les icônes de 16x16.

Quand vous allumez l' appareil, le plug-in affiche toujours ces 5 premiers icônes dans cet ordre :

1. Inbox
2. Contacts
3. Calendar
4. Internet Explorer
5. Solitaire

Le nom des applications sélectionnées peut être affiché en utilisant L' élément<appname/>.Cet élément supporte les attributs standards
L' arrière plan du plug-in peut être contrôlé par L' élément<background/>.

Voici un exemple XML du plug-in :

<plugin file="sysplug.dll" clsid="{79EFB752-CB70-446d-
   B317-499723482B3D}">
     <mru x="4" y="4" button-image="\windows\mrubtn.bmp"/>
     <appname bgtext="#0000FF" fgcolor="#FFFF00"/>
</plugin>