Smartphone France Application Smartphone France pour Windows
Bienvenue sur Smartphone France Windows Edition
Actuellement, 130 visiteurs en ligne
Vous utilisez un bloqueur de publicités ? Félicitations :)
Smartphone France

Article original rédigé par Benjamin ...

Voici une petite (si on veut) traduction (si on veut aussi ^^) faites par mes soins des Appendix A et B de la page de Microsoft afin de mieux comprendre le fonctionnement du XML et des plug-ins pour le "home screen" de nos smartphones.

Cette traduction n'est certainement pas parfaite (ça c'est certain :D ) mais elle pourrait peut être vous aider.

Si vous avez des améliorations ou si vous voulez juste m' envoyer un message, n' hésitez pas à me contacter à l' adresse suivante : beap chez orange.fr (mettez @ à la place de chez ;o) )

Liens rapide :
Appendix A
| home | plugin | background | text | format | default | scheme |
Appendix B
| Icon Bar | Carrier/SIM | Call Progress | Clock | Missed Calls | Profile | Cell Broadcast/SIM | Text Label | Calendar |
| All-Day Event | Messaging Counts | Owner Info | MRU |

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 :

Attributs Description
File localisation de la dll avec le plug-in
clsid L' identifiant unique du plug-in
height Hauteur du plug-in en pixels

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 :

Attribut Description [valeur par défaut]
Bgcolor Couleur de l' arrière plan [transparent]
bgimage

Image d' arrière plan pour le plug-in. Se met au dessus de la couleur d' arrière plan. [FOREGROUND_COLOR] (couleur de premier plan du système)

Halign Alignement horizontal de l' image d' arrière plan dans la région éditable du plug-in [left]
Valign Alignement vertical de l' image d' arrière plan dans la région éditable du plug-in [top]
l-border-width
t-border-width
r-border-width
b-border-width

Donne une largeur de bordure en pixelsà gauche/haut/droite/bas ( left/top/right/bottom) [ il n'y a pas de bordure]

l-border-color
t-border-color
r-border-color
b-border-color

Donne une couleur aux bordures précédemment citées. [noire]

gradient

Spécifie quel genre de dégradé utiliser pour l' arrière plan. Les valeurs possibles sont "title" et "app". [ ne pas utiliser de dégradé ]. Si le plug-in peut être sélectionné et que l' arrière plan a la valeur "app", l' arrière plan sera affiché avec les couleurs de dégradé automatiquement. Ceci peut être chevauché en utilisant L' élément<format state="selected"/> dans le plug-in.

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 :

Attribut Description
Lang

Valeur Hexadécimale pour les langues.
Les valeurs sont :

0x0409: Anglais (U.S.)
0x040c: Français
0x0809: Anglais (U.K.)
0x0407: Allemand
0x0410: Italien
0x0816: Portuguais (Portugal)
0x040a: Espagnol

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

Attribut Description [Attribut par défaut]
state

Les valeurs supportées sont 'selected' et 'unselected'. Elles définiront la mise en forme suivant l'état du plug-in. [unselected].

bgcolor

La couleur d' arrière plan de L' élément L' image d' arrière plan passe par dessus la couleur d' arrière plan. [couleur d' arrière plan du système] (note : ne s' applique pas à l' arrière plan du texte)

bgtext

Couleur d' arrière plan pour le texte. [transparent]

font-face Police de caractères utilisée pour le texte [police du système].
font-size Taille en pixels de la taille de la police [taille de la police du système]
font-style Choix d' une police en italique ou normale - italics / normal - [normal]
font-weight

Contrôle la largeur de la police. Les valeurs standards se situent entre 100 et 900. Les valeurs bold (= 700) et normal (=400) sont aussi acceptées. [400]

fgcolor La couleur du premier plan d' unélément. [la couleur du premier plan du système]
halign

Alignement horizontal de L' élément ( habituellement du texte). Les valeurs standard sont : 'left', 'center' et 'right'. [left]

valign

Alignement vertical d' unélément ( habituellement du texte ). Les valeurs standards sont 'top', 'center' et 'bottom'. [top]
Note : s' applique seulement pour une seule ligne de texte (quand indiqué, le texte ne s' étendra pas et des retours chariot seront convertis en espaces).

X Donne la position de départ sur l' axe horizontal d' unélément graphique. [0]
Y Donne la position de départ sur l' axe vertical d' unélément graphique. [0]
W

Spécifies la largeur de L' élément graphique. Si il est omis, la largeur sera celle de la région du plug-in.

H

Spécifie la hauteur de L' élément graphique. Si il est omis, la hauteur sera celle de la région du plug-in.

padding-left

Précise la distance entre le texte et le bord gauche du plug-in. Distance en pixels. [0]

padding-right Précise la distance entre le texte et le bord droit du plug-in. Distance en pixels. [0]
padding-top Précise la distance entre le texte et le bord haut du plug-in. Distance en pixels. [0]
padding-bottom Précise la distance entre le texte et le bord bas du plug-in. Distance en pixels. [0]

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

Nom Zone correspondante
COLOR_WINDOW

Couleur d' arrière plan pour toutes les fenêtres d' applications et de contrôles, comprenant la partie transparente des barres de la barre de défilement.

COLOR_WINDOWTEXT Couleur du texte des listes, contrôles et label. Ne prend pas en compte la couleur du texte des menus, des boutons et des soft key
COLOR_STATIC

Couleur d' arrière plan pour les contrôles statique, comme les labels. Configure aussi la couleur d' arrière plan des boites à message.

COLOR_STATICTEXT

Couleur d' arrière plan pour les contrôles statique, comme les labels.

COLOR_HIGHLIGHT

Couleur de sélection dans les listes, contrôles, menus et soft key boutons.

COLOR_HIGHLIGHTTEXT

Couleur du texte sélectionné (liste, contrôle, soft keys)

COLOR_MENU Couleur d' arrière plan pour les menus.
COLOR_MENUTEXT Couleur du texte pour les menus.
COLOR_GRAYTEXT Couleur pour le texte grisé des menus (inaccessible mais marqué dans les menus)
COLOR_GRADLEFT Couleur pour le début du dégradé !
COLOR_GRADRIGHT Couleur pour la fin du dégradé !
COLOR_INTGRADLEFT Couleur pour le début du dégradé secondaire d' arrière plan
COLOR_INTGRADRIGHT Couleur pour la fin du dégradé secondaire d' arrière plan
COLOR_HIGHGRADLEFT

le surlignage en dégradé n' est pas supporté ! COLOR_HIGHGRADLEFT et COLOR_HIGHGRADRIGHT doivent avoir la même valeur.

COLOR_HIGHGRADRIGHT le surlignage en dégradé n' est pas supporté ! COLOR_HIGHGRADLEFT et COLOR_HIGHGRADRIGHT doivent avoir la même valeur.
COLOR_TRAYGRADLEFT Couleur de début de dégradé pour la barre des titres.
COLOR_TRAYGRADRIGHT Couleur de fin de dégradé pour la barre des titres.
COLOR_TRAYTEXT Couleur du texte pour la barre des titres.
COLOR_WINDOWFRAME

Couleur des lignes entre la fenêtre principale et les boutons soft-key (du bas de la page) + le petit rectangle de la scroll bar (celui qui se déplace)

COLOR_BTNFACE

Couleur d' arrière plan non-selectionné des boutons soft-keys

COLOR_BTNTEXT

Couleur du texte non-selectionné des boutons soft-keys.

COLOR_SCROLLBAR

Couleur des bandes de la barre de défilement.

COLOR_ALERTTITLE

Couleur du texte du titre dans une alerte.

COLOR_ALERTWINDOW

Couleur d' arrière plan pour une alerte.

COLOR_ALERTRULE

Couleur des lignes séparatrices sur la page d'accueuil (home screen)

COLOR_HOMERULE

Couleur du texte non-sélectionné sur la page d' accueil

COLOR_HOMEHIGHLIGHTTEXT

Couleur du texte sélectionné sur la page d'accueuil

COLOR_HOMEHIGHLIGHT

Couleur de d' arrière plan d' un plug-in sélectionné dans la page d' accueil

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/>

Attribut Description
Fgcolor Donne une couleur aux icônes

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

Status Item Status Text
PLMN courant

Texte retourné pas le module radio

SIM Invalide Invalid SIM
SIM Bloqué SIM Blocked
Radio Off Radio Off
SIM registration fails SIM Registration Failed
Looking for a carrier SearchingÂ?

 

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

Etat Texte affiché à l' écran.
No calls Nothing, display is blank
No calls, call forwarding unconditional Â?Call Forwarding'
No calls, call barring enabled Â?Call Barring'
Dialing, not connected Â?Dialing <number/name>'
Single voice call connected Caller ID information
Single voice call on hold Caller ID information, Icon
Conference voice call Â?Conference'
Multiple voice calls Â?Multiple Calls'
Incoming voice call Caller ID information
Single data call connected Â?Data Call'
Ringer off Â?Ringer off'
Call on hold Â?Hold: <number/name>'

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

Attribut Description
mode

Pour <time/>, utilisez "12" (h:mm:tt) ou "24" (H:mm).
Pour <date/>, utilisez "short" ou "long", qui donne une date courte ou longue. Si aucun de ces attributs n' est mis, c' est le format de réglage régional courant pour la date courte qui est employé.

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

Attribut Text envoyé
simtkitidletext SIM Toolkit idle message
cellbroadcast Most recently received immediate cell broadcast message

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.

La priorité d' un rdv n' est pas considéré. Si plus d' un rdv ont les mêmes préférence, l' ordre sera déterminé par la base de données.

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/>.

Attribut Description [valeur par défaut]
icon-size

Les valeurs acceptées sont "16" et "32". Elles représente la taille des icônes, soit 16x16 ou 32x32. [32]

highlight

Indique la couleur qui surlignera l'icone sélectionée. [si non-utilisé : COLOR_HOMEHIGHLIGHT]

max-buttons Nombre maximun d'icones affichés dans le plug-in. [Le maximum que peut contenir le plug-in]
button-image

Si cet attribut est spécifié, il pointera sur une image bitmap qui servira à indiquer l'icone sélectionné. Cette option annule la couleur de surlignage(highlight). L' image bitmap sera divisée horizontalement en quatre parties égale.
1ère partie : Etat de l'icone sélectionné (surligné) en ayant le focus sur le plug-in.
2nde partie : Etat de l'icone non sélectionné en ayant le focus sur le plug-in.
3ème partie : Etat de l'icone sélectionné en n' ayant pas le focus sur le plug-in.
4ème partie : Etat de l'icone non sélectionné en n' ayant pas le focus sur le plug-in.

button-transparent-color La couleur qui définit la transparence de l' image bitmap. [Pas transparent]
x Position de départ de la liste des icônes sur l' axe des x.
y Position de départ de la liste des icônes sur l' axe des y.

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>
Benjamin APARICIO - cont@ct -