Fichiers HTML

Un Assistant peut contenir une interface utilisateur, c'est une interface HTML. En plus du fichier Default.htm, un Assistant peut contenir un certain nombre de fichiers .htm, ce nombre pouvant être indiqué dans la zone Nombre de pages de l'Assistant personnalisé. Chaque fichier .htm représente une page HTML de votre Assistant, et cette page HTML est accessible par les boutons Next et Précédent, onglets ou autre mise en forme spécifiée dans la conception de l'Assistant.

Le code HTML contient :

  • la balise SYMBOL, qui identifie la valeur par défaut des options définies par l'utilisateur. Les symboles sont écrits dans la table de symboles quand l'utilisateur clique sur Terminer, par exemple :
   <SYMBOL NAME='HEADER_FILE' VALUE='MyHeader.h' TYPE=text></SYMBOL>

Dans l'interface utilisateur de l'Assistant (UI), la zone de texte identifiée dans la table de symboles par « HEADER_FILE » contient le texte par défaut « MyHeader.h ». Vous pouvez modifier cette valeur dans l'interface utilisateur de l'Assistant, la valeur résultante est écrite dans la table de symboles du projet quand vous cliquez sur Terminer, par exemple :

   <SYMBOL NAME='CHECKBOX1' TYPE=checkbox VALUE=false></SYMBOL>

Dans l'interface utilisateur de l'Assistant, la case à cocher identifiée dans la table de symboles par « CHECKBOX1 » est désactivée par défaut. Vous pouvez la sélectionner dans l'interface utilisateur HTML, la valeur résultante est écrite dans la table de symboles quand vous cliquez sur Terminer.

Chaque fichier .htm enregistre les sélections de l'utilisateur dans la table de symboles :

  • une inclusion de Common.js, qui contient des fonctions JScript utiles et couramment utilisées, ainsi que Default.js ;

  • des références aux images du projet à afficher dans le code HTML ;

  • du texte HTML et des mises en forme personnalisant l'apparence de l'interface utilisateur de l'Assistant ;

  • des fonctions JScript accédant au modèle objet d'Assistant Visual C++ pour un comportement personnalisé dans l'Assistant. Ces fonctions figurent dans la section de la page HTML intitulée <SCRIPT LANGUAGE='JSCRIPT'>, comme le montre l'exemple suivant.

    Notes

    Pour accéder à l'Assistant et aux modèles objet d'environnement depuis HTML, ajoutez "window.external." à l'élément du modèle objet.

    function InitDocument(document)
    {
       setDirection();
    
       if (window.external.FindSymbol('DOCUMENT_FIRST_LOAD'))
       {
          // This function sets the default symbols based 
          // on the values specified in the SYMBOL tags above
          //
          window.external.SetDefaults(document);
       }
    
       // Load the document and initialize the controls 
       // with the appropriate symbol values
       //
       window.external.Load(document);
    }
    

Voici un exemple d'Assistant Application console :

<SYMBOL NAME='WIZARD_DIALOG_TITLE' TYPE=text VALUE='Console Application Wizard'></SYMBOL>

<SYMBOL NAME='EMPTY_PROJECT' TYPE=checkbox VALUE=false></SYMBOL>
<SYMBOL NAME='SUPPORT_ATL' TYPE=checkbox VALUE=false></SYMBOL>
<SYMBOL NAME='SUPPORT_MFC' TYPE=checkbox VALUE=false></SYMBOL>

Voir aussi

Tâches

Création d'un Assistant personnalisé

Référence

Assistant personnalisé

Concepts

Fichiers créés pour votre Assistant

Conception d'un Assistant