Dialog HelperNN s.o. IE 6 (Win) DOM s.o.

L´objet Dialog Helper est un contrôle ActiveX fourni avec IE 6 pour Windows et qui apporte des informations brèves et variées sur le système et les documents pouvant être utiles; la méthode affiche aussi une boîte de dialogue de sélection de couleurs, à partir de laquelle vos scripts peuvent obtenir une sélection des couleurs utilisateur. Généralement, cet objet serait utilisé lors de la définition par script du mode d´édition de Microsoft Internet Explorer, là où les utilisateurs ont besoin de faire des sélections de couleurs, polices et éléments. Cependant, les propriétés et méthodes de cet objet peuvent vous être utiles dans les paramètres de documents de navigateurs traditionnels.

Pour charger l´objet dans la page, il faut la balise <object> suivante:

<object id="dlgHelper" classid="clsid:3050f819-98b5-11cf-bb82-00aa00bdce0b" 
        width="0px" height="0px>
</object> "
 

Comme cet objet n´est pas affiché, vous pouvez placer sa balise dans la partie en-tête de votre document. Vous pouvez aussi affecter votre choix d´identificateur à l´attribut id. Une fois l´objet chargé, référencez-le comme objet global dans la fenêtre.

 
Equivalent HTML

Aucune.

 
Référence de modèle d'objet
 
[window.]document.getElementById("elementID")
 
Propriétés spécifiques à l´objet
 
blockFormatsfonts
 
Méthodes spécifiques à l´objet
 
ChooseColorDlg()getCharset()
 
Propriétés de gestionnaire d´événements spécifiques à l´objet

Aucune.

blockFormatsNN s.o. IE 6 DOM s.o.

Lecture seule

Renvoie une collection de noms en anglais d´éléments de niveau bloc pris en charge par le navigateur. Contrairement aux autres collections IE, pour lire le nombre d´éléments, vous devez accéder à sa propriété Count, au lieu de sa propriété length. Les noms des éléments renvoyés sont des chaînes, telles que « Heading 1 » et « Numbered List » (correspondant aux éléments h1 et ol, respectivement). Accédez à chaque élément de la collection avec la méthode item() de la collection.

 
Exemple
 
var blockList = dlgHelper.blockFormats;
var blockNames = new Array();
for (var i = 0; i < blockList.Count; i++) {
    blockNames[blockNames.length]= blockList.item(i);
}
 
Valeur

Tableau de chaînes

 
Par défaut

Dépend de l´implémentation.

fontsNN s.o. IE 6 DOM s.o.

Lecture seule

Renvoie une collection de noms de polices système en anglais. Contrairement aux autres collections IE, pour lire le nombre d´éléments, vous devez accéder à sa propriété Count, au lieu de sa propriété length. Les noms des éléments envoyés sont des chaînes, telles que « MS Sans Serif » et « Verdana ». Accédez à chaque élément de la collection avec la méthode item() de la collection.

 
Exemple
 
var fontList = dlgHelper.fonts;
var fontNames = new Array();
for (var i = 0; i < fontList.Count; i++) {
    fontNames [fontNames .length]= fontList .item(i);
}
 
Valeur

Tableau de chaînes

 
Par défaut

Dépend de l´implémentation.

ChooseColorDlg()NN s.o. IE 6 DOM s.o.

ChooseColorDlg([initialHexColor])

Affiche une boîte de dialogue de sélection de couleurs et renvoie un nombre décimal correspondant à la couleur choisie par l´utilisateur. Pour appliquer la couleur au style ou aux paramètres de propriété de couleurs, vous devrez peut-être convertir la valeur décimale en triplet en hexadécimal du format #RRGGBB. Le fragment suivant illustre la séquence d´obtention de la couleur, de conversion de cette couleur à la base et au nombre de chiffres désirés et d´affectation de la valeur à une propriété de style:

var colorChoice = dlgHelper.ChooseColorDlg( );
var hexColor = colorChoice.toString(16);
while (hexColor.length< 6) {hexColor = "0" + hexColor;}
document.body.style.color = "#" + hexColor; 

Si l´utilisateur sélectionne une couleur personnalisée dans la boîte de dialogue et l´ajoute à une petite case de raccourci, la couleur ne réapparaît pas dans la case à l´affichage suivant de la boîte de dialogue. Mais, une couleur personnalisée peut toujours être présélectionnée en transmettant à la méthode sa valeur hexadécimale en tant que paramètre.

 
Paramètres
 
  • Nombre hexadécimal facultatif qui prédéfinit la couleur initialement sélectionnée dans la boîte de dialogue.
 
Valeur renvoyée

Entier décimal de la couleur sélectionnée (de 0 à autant de couleurs que les paramètres du client).

getCharset()NN s.o. IE 6 DOM s.o.

getCharset("fontName")

Renvoie un nombre entier correspondant à une constante associée à un jeu de caractères connu par le système d´exploitation. Parmi les valeurs courantes renvoyées pour les familles de polices installées sur les systèmes basés sur l´alphabet latin, on trouve 0 (pour le jeu de caractères ANSI de base) et 2 (pour un jeu de symboles). Le paramètre requis est le nom d´une police afin de permettre la recherche de son jeu de caractères. Vous pouvez récupérer ces noms dans la propriété de police de l´objet Dialog Helper:

var setID = dlgHelper.getCharset(dlgHelper.fonts.item(4));

Les jeux de caractères installés varient d´une version de Windows à l´autre.

 
Paramètres
 
  • Nom, sous forme de chaîne, de la police système installée.
 
Valeur renvoyée

Nombre entier.

dirNN 6 IE 5 DOM 1

Lecture/écriture

Indique la direction d'affichage des caractères pour le texte de l'élément dont les caractères ne sont pas régis par la direction inhérente à la norme Unicode et le système de langue du navigateur par défaut. L'affichage des caractères va de gauche à droite ou de droite à gauche.

 
Valeur

ltr | rtl (chaîne insensible à la casse).

 
Par défaut

ltr