Tivoli Service Desk 6.0 Developer's Toolkit Script - Manuel de référence du langage TSD Script

Constantes de TSD Script

Retour à la page principale


Styles de fenêtre

Les indicateurs de style indiqués ci-après sont utilisés avec les instructions WinCreate, WinCreateScrollWindow et WinEditField, sauf indication contraire. Ils déterminent les éléments qui seront ajoutés aux fenêtres que vous créez. Ces éléments peuvent être combinés à l'aide de l'opérateur BitOr.

Conseil : Pour plus de détailes, reportez-vous à la page Messages de TSD Script.

Taille et position

Indicateur de style Description
$WinAutoPos Le système d'exploitation détermine la position idéale pour la fenêtre, sans tenir compte des paramètres xLoc et yLoc indiqués dans les instructions WinCreate ou WinCreateScroll Window.
$WinAutoSize Le système d'exploitation détermine les dimensions idéales pour la fenêtre, sans tenir compte des paramètres xLen et yLen indiqués dans les instructions WinCreate ou WinCreateScroll Window.
$WinMinimized Crée la fenêtre au format icône.

Styles de bordure

Indicateur de style Description
$WinBorder La fenêtre créée présente une bordure similaire à celle d'une boîte de dialogue. Plusieurs styles requièrent une bordure. Ce style et le style $WinField s'excluent mutuellement.
$WinField La fenêtre créée présente une bordure d'une épaisseur de 1 pixel (comme les boîtes de texte dans les boîtes de dialogue). Ce style et le style $WinBorder s'excluent mutuellement.
$WinResize La fenêtre créée présente une bordure redimensionnable. Ce style ne peut être choisi que si $WinBorder a également été spécifié. S'il est combiné à $WinTitle, un bouton d'agrandissement est automatiquement ajouté à la fenêtre.

Eléments de fenêtre

Indicateur de style Description
$WinHScroll La fenêtre créée présente une barre de défilement horizontal. Pour que cette barre fonctionne, la fenêtre doit être capable de traiter les messages de barre de défilement. Ce style ne peut pas être utilisé avec l'instruction WinEditField.
$WinIconBar La fenêtre créée présente une barre d'outils. Cette barre, qui ne s'affiche que lorsqu'elle contient des éléments, se situe sous la barre de titre et la barre de menus, lorsqu'elles existent. Le style $WinIconBar ne peut pas être utilisé avec l'instruction WinEditField.

Cette barre d'outils peut être chargée avec l'instruction WinSetIconBar. Le style $WinBorder est requis.

$WinMenu La fenêtre créée présente une barre de menus. Ce style ne peut pas être utilisé avec l'instruction WinEditField. La barre de menus ne s'affiche que si elle contient des options, qui peuvent être définies à l'aide de l'instruction $WinSetMenuBar. $WinBorder est requis.
$WinMinMax Des boutons de réduction et d'agrandissement sont ajoutés dans l'angle supérieur droit de la fenêtre. Une icône par défaut est créée pour la fenêtre, et peut être modifiée à l'aide du message $MsgSetIcon. Le style $WinBorder est requis. Ce style ne peut pas être utilisé avec l'instruction WinEditField.

Sous Windows, si vous ne spécifiez pas $WinMinMax, la barre de titre ne comporte pas de bouton de réduction ou d'agrandissement.

Sous OS/2, si vous ne spécifiez pas cet indicateur, ces boutons sont remplacés dans la barre de titre par une zone grisée.

$WinStatus La fenêtre créée présente une barre d'état. L'application affiche le contenu de la barre d'état en réponse au message $MsgPaintStatus. Ce style ne peut pas être utilisé avec l'instruction WinEditField.
$WinSysMenu La fenêtre créée présente un menu système. $WinBorder est requis. Ce style ne peut pas être utilisé avec l'instruction WinEditField.
$WinTitle La fenêtre créée présente une barre de titre. Si ce style n'est pas défini, aucune barre de titre ne s'affiche, même si un titre est défini comme paramètre. La barre de titre permet de déplacer la fenêtre.
$WinVScroll La fenêtre créée présente une barre de défilement vertical. Pour que cette barre fonctionne, la fenêtre doit être capable de traiter les messages de barre de défilement. Ce style ne peut pas être utilisé avec l'instruction WinEditField.

Autres éléments de fenêtre

Indicateur de style Description
$WinAutoScroll Déroule la fenêtre verticalement, de sorte que la dernière ligne soit toujours visible. Si vous utilisez cet indicateur pour créer une fenêtre de défilement et que vous appelez à plusieurs reprises WinWriteLN pour consigner des informations dans la fenêtre, cette dernière se déroule automatiquement pour que les données écrites sous la zone de travail s'affichent toujours sur la dernière ligne de l'écran.

Remarque : Cet indicateur peut être utilisé avec $WinCreateScrollWindow mais pas avec $WinCreate.

$WinDefaultStyle La fenêtre est créée avec le style par défaut, c'est-à-dire la combinaison de $WinBorder, $WinResize, $WinTitle et $WinSysMenu.
$WinInvisible La fenêtre créée est cachée. Pour qu'elle s'affiche, l'indicateur $MsgShow doit être spécifié.
$WinModal La fenêtre créée avec l'instruction WinEditField est activée lors de sa création. Cependant, la fenêtre mère et toutes les autres fenêtres filles de cette dernière sont désactivées.

Ce style n'est utilisé qu'avec l'instruction WinEditField.

$WinNone La fenêtre est créée sans aucun des attributs de la liste.
$WinTaskList Le titre de la fenêtre s'affiche dans la liste des tâches système, d'où l'utilisateur peut activer la fenêtre correspondante. Réservez plutôt ce style à la fenêtre principale de l'application.

Sous Windows, il est ignoré et toute fenêtre créée sur le bureau apparaît dans la liste des tâches.

Couleur et transparence du texte

Ces constantes sont utilisées avec l'instruction WinSetColor pour définir la couleur du texte de la fenêtre.
Les constantes $WinOpaque et $WinTransparent peuvent être combinées avec l'une des autres constantes de couleur à l'aide de l'opérateur BitOr.

Conseil :Si vous n'indiquez aucune couleur et aucun style, les constantes $WinDefaultColor et $WinDefaultStyle sont utilisées. .

Transparence du texte

Indicateur de style Description
$WinOpaque Le texte est opaque. (Cette option n'est pas disponible sous OS/2.)
$WinTransparent Le texte est transparent.

Couleur du texte

Indicateur de style Description
$WinDefaultColor La couleur du texte est la couleur par défaut du système d'exploitation.
Si vous définissez $WinDefaultColor pour le premier plan, la couleur spécifiée dans l'instruction $SysClrWindowText est utilisée.

Si vous définissez $WinDefaultColor pour l'arrière-plan, la couleur spécifiée dans l'instruction $SysClrWindow est utilisée.

$WinBlack Texte en noir
$WinBlue Texte en bleu
$WinBrown Texte en marron
$WinCyan Texte en cyan
$WinDarkGray Texte en gris foncé
$WinGreen Texte en vert
$WinLightBlue Texte en bleu clair
$WinLightCyan Texte en cyan clair
$WinLightGray Texte en gris clair
$WinLightGreen Texte en vert clair
$WinLightMagenta Texte en magenta clair
$WinLightRed Texte en rouge clair
$WinMagenta Texte en magenta
$WinRed Texte en rouge
$WinWhite Texte en blanc
$WinYellow Texte en jaune

Couleurs de fenêtre définies pour le système

Ces constantes représentent les couleurs définies par les utilisateurs pour le système d'exploitation. Elles ne peuvent pas être combinées (si tel est le cas, une valeur incorrecte est renvoyée).

Indicateur de style Description
$SysClrActiveBorder Couleur de la bordure de la fenêtre active
$SysClrActiveTitle Couleur de la barre de titre de la fenêtre active
$SysClrActiveTitleText Couleur du texte de la barre de titre de la fenêtre active
$SysClrActiveTitleTextBgnd Couleur de l'arrière-plan du texte sur la barre de titre de la fenêtre active
$SysClrAppWorkspace Couleur de la zone de travail
$SysClrBackground Couleur de l'arrière-plan de la fenêtre
$SysClrButtonDark Mise en évidence sombre des boutons en trois dimensions
$SysClrButtonDefault Couleur par défaut des boutons, telle qu'elle est définie dans le système d'exploitation
$SysClrButtonLight Mise en évidence claire des boutons en trois dimensions
$SysClrButtonMiddle Couleur de l'arrière-plan des boutons, telle qu'elle est définie dans le système d'exploitation
$SysClrDialogBackground Couleur de l'arrière-plan des boîtes de dialogue
$SysClrEntryField Couleur des zones de saisie
$SysClrFieldBackground Couleur de l'arrière-plan des boîtes de texte
$SysClrHelpBackground Couleur de l'arrière-plan du texte d'aide
$SysClrHelpHilite Couleur de la mise en évidence dans l'aide (liens ou zones sensibles)
$SysClrHelpText Couleur du texte d'aide
$SysClrHiliteBackground Couleur de l'arrière-plan des éléments mis en évidence dans l'aide (liens ou zones sensibles)
$SysClrHiliteForeground Couleur du premier plan des éléments mis en évidence dans l'aide (liens ou zones sensibles)
$SysClrIconText Couleur du texte des icônes
$SysClrInactiveBorder Couleur de la bordure de la fenêtre inactive
$SysClrInactiveTitle Couleur de la barre de titre de la fenêtre inactive
$SysClrInactiveTitleText Couleur du texte de la barre de titre de la fenêtre inactive
$SysClrInactiveTitleTextBgnd Couleur de l'arrière-plan du texte sur la barre de titre de la fenêtre inactive
$SysClrMenu Couleur de la barre de menus
$SysClrMenuDisabledText Couleur du texte désactivé
$SysClrMenuHilite Couleur des éléments de menu sélectionnés
$SysClrMenuHiliteBgnd Couleur de l'arrière-plan des éléments de menu sélectionnés
$SysClrMenuText Couleur du texte des menus
$SysClrOutputText Couleur du texte en sortie
$SysClrPageBackground Couleur de l'arrière-plan de la page
$SysClrScrollBar Couleur de la barre de défilement
$SysClrShadow Couleur de l'ombre. (option non disponible sous Windows)
$SysClrShadowHiliteBgnd Couleur de l'arrière-plan de l'ombre en trois dimensions (non disponible sous Windows).
$SysClrShadowHiliteFgnd Couleur du premier plan de l'ombre en trois dimensions (non disponible sous Windows).
$SysClrShadowText Couleur du texte ombré
$SysClrTitleBottom Couleur du bouton du menu système
$SysClrTitleText Couleur du texte de la barre de titre
$SysClrWindow Couleur de l'arrière-plan de la fenêtre
$SysClrWindowFrame Couleur du cadre de la fenêtre
$SysClrWindowStaticText Couleur du texte statique de la fenêtre
$SysClrWindowText Couleur du texte de la fenêtre

Elément Fermeture du menu système

Vous pouvez activer ou désactiver l'élément Fermeture du menu système d'une fenêtre. Pour cela, spécifiez la constante $SysMenuCloseItem dans l'instruction WinMenuEnableItem :

(*Ceci active l'élément Fermeture *)
WinMenuEnableItem(mafenêtre,
$SysMenuCloseItem, TRUE);
(*Ceci désactive l'élément Fermeture *)
WinMenuEnableItem(mafenêtre,
$SysMenuCloseItem, FALSE);

Codes de touche

Ces constantes représentent les valeurs transmises au système lorsque l'utilisateur appuie sur la touche indiquée. Elles ne peuvent pas être combinées (si tel est le cas, une valeur incorrecte est renvoyée).

Le tableau ci-après présente la correspondance entre les paramètres $MsgChar et la combinaison de touches Alt + lettre activée par l'utilisateur.

Codes de touches Alt + lettre

Le tableau ci-après présente la correspondance entre les paramètres $MsgChar et la combinaison de touches Alt + lettre activée par l'utilisateur.

Ce paramètre $MsgChar est transmis à un gestionnaire d'événements ... lorsque l'utilisateur appuie simultanément sur la touche Alt et sur la ...
$KeyAltA Touche A
$KeyAltB Touche B
$KeyAltBS Touche Retour arrière
$KeyAltC Touche C
$KeyAltD Touche D
$KeyAltE Touche E
$KeyAltF Touche F
$KeyAltG Touche G
$KeyAltH Touche H
$KeyAltI Touche I
$KeyAltJ Touche J
$KeyAltK Touche K
$KeyAltL Touche L
$KeyAltM Touche M
$KeyAltN Touche N
$KeyAltO Touche O
$KeyAltP Touche P
$KeyAltQ Touche Q
$KeyAltR Touche R
$KeyAltS Touche S
$KeyAltT Touche T
$KeyAltU Touche U
$KeyAltV Touche V
$KeyAltW Touche W
$KeyAltX Touche X
$KeyAltY Touche Y
$KeyAltZ Touche Z

Codes de touches Alt + touche de fonction

Le tableau ci-après présente la correspondance entre les paramètres $MsgChar et la combinaison de touches Alt + touche de fonction activée par l'utilisateur.

Ce paramètre $MsgChar est transmis à un gestionnaire d'événements ... lorsque l'utilisateur appuie simultanément sur la touche Alt et sur la ...
$KeyAltFn1 Touche F1
$KeyAltFn2 Touche F2
$KeyAltFn3 Touche F3
$KeyAltFn4 Touche F4
$KeyAltFn5 Touche F5
$KeyAltFn6 Touche F6
$KeyAltFn7 Touche F7
$KeyAltFn8 Touche F8
$KeyAltFn9 Touche F9
$KeyAltFn10 Touche F10

Codes de touches Alt + flèche

Le tableau ci-après présente la correspondance entre les paramètres $MsgChar et la combinaison de touches Alt + flèche activée par l'utilisateur.

Ce paramètre $MsgChar est transmis à un gestionnaire d'événements ... lorsque l'utilisateur appuie simultanément sur la touche Alt et sur la ...
$KeyAltLeftArrow Touche Flèche vers la gauche
$KeyAltRightArrow Touche Flèche vers la droite

Codes de touches Ctrl + touche

Le tableau ci-après présente la correspondance entre les paramètres $MsgChar et la combinaison de touches Ctrl + touche activée par l'utilisateur.

Ce paramètre $MsgChar est transmis à un gestionnaire d'événements ... lorsque l'utilisateur appuie simultanément sur la touche Ctrl et sur la ...
$KeyControlDelete Touche Suppr
$KeyControlDownArrow Touche Flèche vers le bas
$KeyControlEnd Touche Fin
$KeyControlFn1 Touche F1
$KeyControlFn2 Touche F2
$KeyControlFn3 Touche F3
$KeyControlFn4 Touche F4
$KeyControlFn5 Touche F5
$KeyControlFn6 Touche F6
$KeyControlFn7 Touche F7
$KeyControlFn8 Touche F8
$KeyControlFn9 Touche F9
$KeyControlFn10 Touche F10
$KeyControlFn11 Touche F11
$KeyControlFn12 Touche F12
$KeyControlHome Touche Pos 1
$KeyControlInsert Touche Inser
$KeyControlPageDown Touche Pg AV
$KeyControlPageUp Touche Page AR
$KeyControlRightArrow Touche Flèche vers la droite
$KeyControlLeftArrow Touche Flèche vers la gauche
$KeyControlUpArrow Touche Flèche vers le haut

Codes de touches de fonction

Le tableau ci-après présente la correspondance entre les paramètres $MsgChar et les touches de fonction activées par l'utilisateur.

Ce paramètre $MsgChar est transmis à un gestionnaire d'événements ... lorsque l'utilisateur appuie sur la ...
$KeyFn1 Touche F1
$KeyFn2 Touche F2
$KeyFn3 Touche F3
$KeyFn4 Touche F4
$KeyFn5 Touche F5
$KeyFn6 Touche F6
$KeyFn7 Touche F7
$KeyFn8 Touche F8
$KeyFn9 Touche F9
$KeyFn10 Touche F10
$KeyFn11 Touche F11
$KeyFn12 Touche F12

Codes de touches Maj + touche

Le tableau ci-après présente la correspondance entre les paramètres $MsgChar et la combinaison de touches Maj + touche activée par l'utilisateur.

Ce paramètre $MsgChar est transmis à un gestionnaire d'événements ... lorsque l'utilisateur appuie simultanément sur la touche Maj et sur la ...
$KeyShiftDelete Touche Suppr
$KeyShiftDownArrow Touche Flèche vers le bas
$KeyShiftEnd Touche Fin
$KeyShiftHome Touche Pos 1
$KeyShiftInsert Touche Inser
$KeyShiftLeftArrow Touche Flèche vers la gauche
$KeyShiftPageDown Touche Pg AV
$KeyShiftPageUp Touche Page AR
$KeyShiftTab Touche Tabulation
$KeyShiftRightArrow Touche Flèche vers la droite
$KeyShiftUpArrow Touche Flèche vers le haut

Codes de touches Maj + touche de fonction

Le tableau ci-après présente la correspondance entre les paramètres $MsgChar et la combinaison de touches Maj + touche de fonction activée par l'utilisateur.

Ce paramètre $MsgChar est transmis à un gestionnaire d'événements ... lorsque l'utilisateur appuie simultanément sur la touche Maj et sur la ...
$KeyShiftFn1 Touche F1
$KeyShiftFn2 Touche F2
$KeyShiftFn3 Touche F3
$KeyShiftFn4 Touche F4
$KeyShiftFn5 Touche F5
$KeyShiftFn6 Touche F6
$KeyShiftFn7 Touche F7
$KeyShiftFn8 Touche F8
$KeyShiftFn9 Touche F9
$KeyShiftFn10 Touche F10
$KeyShiftFn11 Touche F11
$KeyShiftFn12 Touche F12

Codes de touche pour barres de défilement

Le tableau suivant présente la correspondance entre les paramètres $MsgChar et la partie de la barre de défilement sur laquelle l'utilisateur a cliqué à l'aide de la souris.

Ce paramètre $MsgChar est transmis à un gestionnaire d'événements ... lorsque l'utilisateur clique, à l'aide de la souris, sur ...
$KeyScrollPageUp la partie vide d'une barre de défilement vertical, au-dessus du curseur de défilement.
$KeyScrollPageDown la partie vide d'une barre de défilement vertical, au-dessous du curseur de défilement.
$KeyScrollPageLeft la partie vide d'une barre de défilement vertical, à gauche du curseur de défilement.
$KeyScrollPageRight la partie vide d'une barre de défilement vertical, à droite du curseur de défilement.
$KeyScrollLineUp la flèche vers le haut d'une barre de défilement vertical.
$KeyScrollLineDown la flèche vers le bas d'une barre de défilement vertical.
$KeyScrollLineLeft la flèche vers la gauche d'une barre de défilement horizontal.
$KeyScrollLineRight la flèche vers la droite d'une barre de défilement horizontal.

Codes de touche divers

Le tableau ci-après présente la correspondance entre les paramètres $MsgChar et les touches diverses activées par l'utilisateur.

Ce paramètre $MsgChar est transmis à un gestionnaire d'événements ... lorsque l'utilisateur appuie sur la ...
$KeyBackSpace Touche Retour arrière
$KeyHome Touche Pos 1
$KeyInsert Touche Inser
$KeyLeftArrow Touche Flèche vers la gauche
$KeyPageDown Touche Pg AV
$KeyPageUp Touche Page AR
$KeyReturn Touche Entrée
$KeyRightArrow Touche Flèche vers la droite
$KeyUpArrow Touche Flèche vers le haut
$KeyDownArrow Touche Flèche vers le bas
$KeyCRCarriage Touche Entrée
$KeyDelete Touche Suppr
$KeyEndkey Touche Fin
$KeyEscape Touche Echap

Styles d'image

Les constantes définissent des styles d'image qui peuvent être combinés à l'aide de l'instruction BitOr. Vous pouvez par exemple combiner des styles pour obtenir une barre de titre, une barre de défilement et une image découpée. Les styles d'image sont utilisés avec l'instruction WinCreateImage. Sous Windows, la valeur par défaut est $ImgScale et sous OS/2, $ImgBorder.

Le tableau ci-après présente, pour chaque constante, le style d'image obtenu.

Constante Style d'image
$ImgBorder Insère une bordure autour de l'image.
$ImgClip Découpe l'image pour l'ajuster aux dimensions de la fenêtre, sans changer l'échelle.
$ImgScale Change l'échelle de l'image pour amener ses dimensions à celles de la fenêtre.
$ImgScroll Déroule l'image, sans changer l'échelle pour amener ses dimensions à celles de la fenêtre.
$ImgTitle Insère une barre de titre dans la fenêtre contenant l'image.

Pointeurs de la souris

Le tableau ci-après présente les différents pointeurs de souris disponibles. Ces constantes de pointeurs sont définies avec l'instruction WinSetPointer. La constante par défaut est $MouseDefaultPtr. Les instructions BitOr ne peuvent pas être utilisées avec les pointeurs de la souris.

Ce pointeur de la souris ... affiche ...
$MouseMaxPointer le pointeur d'agrandissement.
$MouseCrossPtr le pointeur en croix.
$MouseDefaultPtr le pointeur par défaut.
$MouseDLArrowPtr le pointeur en forme de flèche dirigée en bas à gauche.
$MouseDLResizePtr le pointeur de redimensionnement dirigé en bas à gauche.
$MouseDnResizePtr le pointeur de redimensionnement vers le bas.
$MouseDRArrowPtr le pointeur en forme de flèche dirigée en bas à droite.
$MouseDRResizePtr le pointeur de redimensionnement dirigé en bas à droite.
$MouseHandPtr le pointeur en forme de main.
$MouseHourglassPtr le pointeur sablier.
$MouseIBeamPtr le pointeur en I.
$MouseLTResizePtr le pointeur de redimensionnement vers la gauche.
$MouseRTResizePtr le pointeur de redimensionnement vers la droite.
$MouseULArrowPtr le pointeur en forme de flèche dirigée en haut à gauche.
$MouseULResizePtr le pointeur de redimensionnement dirigé en haut à gauche.
$MouseUPResizePtr le pointeur de redimensionnement vers le haut.
$MouseURArrowPtr le pointeur en forme de flèche dirigée en haut à droite.
$MouseURResizePtr le pointeur de redimensionnement dirigé en haut à droite.

Messages de la souris

Ces messages peuvent être envoyés en réponse à un message $MsgMouse et avec ce type de message. Ils ne peuvent pas être combinés.

Ce message ... indique que l'utilisateur ...
$MouseLeftClick a cliqué une fois sur le bouton gauche de la souris.
$MouseLeftDouble a cliqué deux fois sur le bouton gauche de la souris.
$MouseLeftEndDrag a appuyé sur le bouton gauche de la souris, a déplacé la souris puis a relâché le bouton.
$MouseLeftStartDrag a cliqué sur le bouton gauche de la souris et a déplacé la souris.
$MouseNone n'a pas déplacé la souris.
$MouseRightClick a cliqué une fois sur le bouton droit de la souris.
$MouseRightDouble a cliqué deux fois sur le bouton droit de la souris.

Constantes de boîte de dialogue

Les constantes de boîte de dialogue définissent le style d'une boîte de dialogue. Elles sont utilisées avec l'instruction WinFileDialog. La constante par défaut est $FileDlgOpen. La constante $FileDlgCenter peut être combinée avec la constante $FileDlgOpen ou avec la constante $FileDlgSaveAs.
Le tableau ci-après présente les constantes de boîte de dialogue et leurs effets sur le style d'une boîte de dialogue.

Constante de boîte de dialogue Résultat
$FileDlgCenter Place la boîte de dialogue au milieu de la fenêtre.
$FileDlgOpen Crée une boîte de dialogue d'ouverture.
$FileDlgSaveAs Crée une boîte de dialogue d'enregistrement sous un autre nom.

Styles de fenêtre de l'afficheur d'hypertexte

Le tableau ci-après présente la correspondance entre les constantes et les messages d'événement associés d'une part, et les styles qu'ils définissent pour les fenêtres d'afficheur d'hypertexte d'autre part.

Cette constante ... utilisée avec ce message d'événement ... produit cet effet sur la fenêtre d'afficheur d'hypertexte ...
$HyperNoWordWrap $MsgOpenFile Pas de renvoi à la ligne dans l'afficheur d'hypertexte. La fenêtre contient une barre de défilement horizontal.
$HyperScaleImage $MsgDisplayImage L'échelle de l'image est modifiée pour que cette dernière ait les mêmes dimensions que l'afficheur d'hypertexte.
$HyperScrollImage $MsgDisplayImage L'échelle de l'image n'est pas modifiée. Il est cependant possible de faire dérouler l'image.

Styles d'horloge

Les styles d'horloge sont utilisés avec l'instruction WinCreateClock. Ils peuvent être combinés à l'aide de l'instruction BitOr.

Sous Windows, les valeurs par défaut sont $ClkBorderIn et $Clk12Hour.

Sous OS/2, les valeurs par défaut sont $ClkBorder et $Clk12Hour. Le tableau ci-après présente la correspondance entre les constantes pouvant être utilisées avec l'instruction WinCreateClock et les styles d'horloge obtenus.

Avec cette constante ... l'horloge ...
$Clk12Hour est au format 12 heures.
$Clk24Hour est au format 24 heures.
$ClkBorder
(Valeur par défaut sous OS/2)
présente une bordure.
$ClkBorderIn
(Valeur par défaut sous Windows)
apparaît en creux (3 dimensions).
$ClkBorderNone ne présente pas de bordure.
$ClkBorderOut apparaît en relief (3 dimensions).
$ClkHidden est cachée.

Styles de boîte de message

Les constantes suivantes, utilisées avec l'instruction WinMessageBox, permettent la création de boîtes de message. Les constantes par défaut sont $MBOK et $MBAPPMODAL. Les styles obtenus peuvent être combinés à l'aide de l'instruction BitOr. Par exemple, vous pouvez créer une boîte de dialogue modale d'application avec une icône Erreur et un bouton OK.

Styles de bouton

Le tableau ci-après présente la correspondance entre les constantes pouvant être utilisées avec l'instruction WinMessageBox et les styles de bouton obtenus.

Avec cette constante ... la boîte de message ...
$MBAbortRetryIgnore Comporte trois boutons : Abandonner, Relancer et Ignorer.
$MBCancel Sous OS/2, comporte un bouton Annuler.
Sous Windows, ne comporte qu'un bouton, le bouton Cancel (même effet que $MBOK).
$MBDefButton1 Comporte un bouton défini par l'utilisateur (no. 1).
$MBDefButton2 Comporte un bouton défini par l'utilisateur (no. 2).
$MBDefButton3 Comporte un bouton défini par l'utilisateur (no. 3).
$MBEnter Sous OS/2, comporte un bouton Entrée.
Sous Windows, ne comporte qu'un bouton, le bouton OK (même effet que $MBOK).
$MBEnterCancel Sous OS/2, comporte deux boutons  Entrée et Annuler.
Sous Windows, comporte deux boutons, les boutons OK et Annuler (même effet que $MBOKCancel).
$MBOK Comporte un bouton OK.
$MBOKCancel Comporte deux boutons : OK et Annuler.
$MBRetryCancel Comporte deux boutons : Relancer et Annuler.
$MBYesNo Comporte deux boutons : Oui et Non.
$MBYesNoCancel Comporte trois boutons : Oui, Non et Annuler.

Styles d'icône

Le tableau ci-après présente la correspondance entre les constantes pouvant être utilisées avec l'instruction WinMessageBox et les styles d'icône obtenus.

Avec cette constante ... la boîte de message comporte ...
$MBIconError Une icône Erreur.
$MBIconInformation Une icône Information.
$MBIconQuery Une icône Requête.
$MBIconWarning Une icône Avertissement.
$MBNoIcon Ne comporte pas d'icône.

Styles divers

Le tableau ci-après présente la correspondance entre les constantes pouvant être utilisées avec l'instruction WinMessageBox et les styles divers obtenus.

Avec cette constante ... la boîte de message est ...
$MBAppModal Une boîte de dialogue modale d'application.
$MBSysModal Une boîte de dialogue modale système.
$MBMoveable Une boîte de dialogue pouvant être déplacée. Cette constante vous permet de configurer des boîtes de message déplaçables de part et d'autre de l'écran.

Styles de résultat (Codes)

Le tableau suivant présente le format de retour des entiers de WinMessageBox, qui est égal à l'une de ces constantes.

Ce code retour ... indique que l'utilisateur a cliqué sur ...
$MBResultAbort Abandonner
$MBResultCancel Annuler
$MBResultEnter Entrée
$MBResultError Erreur
$MBResultIgnore Ignorer
$MBResultNo Non
$MBResultOK OK
$MBResultRetry Relancer
$MBResultYes Oui

Indicateurs de création de session

Le tableau ci-après présente les indicateurs de création pouvant être utilisés avec SysCreateSession. Ces styles ne peuvent pas être combinés, et il n'existe pas de style de session par défaut.

Indicateur de création Résultat
$SessionAutoPosition Le système d'exploitation détermine l'emplacement de la fenêtre de session.
$SessionBackground Crée une session qui s'exécute en arrière-plan.
$SessionInvisible Crée une session avec une fenêtre invisible.

Indicateurs de format de types de données

Les constantes sont utilisées pour formater des données de différents types et peuvent être utilisées avec des opérateurs de formatage. Chacune des instructions suivantes permet d'accéder à une variable :

Si vous indiquez une valeur pour l'une de ces instructions, vous modifiez la valeur de cette variable. La constante $FmtDefault peut être utilisée pour choisir le format par défaut des types de données indiquées ci-dessus. (Le format choisi dépend du type de données que vous utilisez.)

Conseil : Pour toutes les catégories de styles de format suivantes, le style de format par défaut est indiqué en caractères gras. Lorsque plusieurs styles peuvent être combinés (c'est-à-dire lorsqu'ils ne s'excluent pas mutuellement), il existe plusieurs valeurs par défaut.

Indicateurs de format booléen

Les constantes suivantes convertissent une valeur booléenne en une chaîne sous l'un des formats indiqués ci-après. La valeur par défaut est $FmtBoolTrueFalse.

Cette constante ... convertit une valeur booléenne en une chaîne au format ...
$FmtBoolTrueFalse true (vrai) ou false (faux).
$FmtBoolBinary 0 ou 1.
$FmtBoolYesNo yes (oui) ou no (non).

Indicateurs de format de date

Les constantes suivantes convertissent une valeur de date en une chaîne sous l'un des formats indiqués ci-après. Ces formats de date peuvent être combinés. Par exemple, vous pouvez combiner un format incluant majuscules et minuscules, un format européen et un format de date abrégée.

Conseil : Pour toutes les catégories d'indicateurs de format suivantes, l'indicateur par défaut pour les Etats-Unis est indiqué en italique.

Type de caractères de la date

Constante Description
$FmtDateMixedCaseNames Le nom du mois contient des majuscules et des minuscules (par exemple, Février).
Remarque : Cette valeur est la valeur par défaut pour tous les environnements locaux.
$FmtDateISOFormat La date est au format ISO international (jjjjmmaa). Ce format est recommandé si une application ou une base de données unique est partagée par des utilisateurs provenant de différents environnements locaux internationaux.
$FmtDateAllCapsNames Le nom du mois est en majuscules (par exemple, FEVRIER).

Ordre de la date

Constante Description
$FmtDateDayMonthYear Présente les sous-zones de la date sous la forme jour, mois, puis année (par exemple, 31/1/1999).
$FmtDateMonthDayYear Présente les sous-zones de la date sous la forme mois, jour, puis année (par exemple, 1/31/1999).
$FmtDateYearMonthDay Présente les sous-zones de la date sous la forme année, mois, puis jour (par exemple, 1999/1/31).

Format de l'année

Constante Description
$FmtDateFullYear L'année est représentée par quatre chiffres (par exemple, 31/1/1999).
$FmtDateTruncateCentury Seuls les deux premiers chiffres de l'année s'affichent (par exemple, 22/4/99).


Remarque : Aucune valeur par défaut n'est indiquée pour le format de l'année car ce format dépend de l'environnement local du poste de travail. L'environnement local décrit le contexte culturel du poste de travail. Par "contexte culturel", on entend plus que le pays (par exemple, le contexte canadien est différent du contexte canadien francophone) et plus que la langue (le français du Canada diffère du français parlé en Suisse).

Sous OS/2, l'année n'est représentée qu'avec deux chiffres. Pour obtenir les quatre chiffres, utilisez la commande DateFormat.

Format du mois

Constante Description
$FmtDateNumericMonth Le mois s'affiche sous forme numérique (par exemple, 14/2/1999).
$FmtDateNamedMonth Le mois s'affiche dans la langue du pays sélectionné (par exemple, 11 février 1999).

Longueur du nom du mois

Constante Description
$FmtDateLongNames Le nom du mois s'affiche en entier (par exemple, février).
$FmtDateShortNames Le nom du mois s'affiche sous forme abrégée (par exemple, fév).

Format de séparateur

Constante Description
$FmtDateDotSeparators Lour, le mois et l'année sont séparés par des points (par exemple, 13.2.1999).
$FmtDateSlashSeparators Le jour, le mois et l'année sont séparés par des barres obliques (par exemple, 13/2/1999).
$FmtDateDashSeparators Le jour, le mois et l'année sont séparés par des tirets (par exemple, 13-2-1999).

Caractères de remplissage

Constante Description
$FmtZeroPad Aligne les dates en présentant le jour et le mois sous la forme de deux chiffres (par exemple, 07/02/1999).

Conseil : Vous pouvez indiquer le format de date par défaut pour l'environnement local sélectionné à l'aide de l'indicateur de format spécial $FmtDateNLSDefault.

Indicateurs de format d'entier

Les constantes suivantes convertissent un entier en une chaîne sous l'un des formats indiqués ci-après.
Conseil : Pour toutes les catégories de format suivantes, l'indicateur par défaut pour les Etats-Unis est indiqué en italique.

Format d'entier

Constante Description
$FmtIntDecimal Affiche les entiers sous forme décimale (en base 10).
$FmtIntHexadecimal Affiche les entiers sous forme hexadécimale (en base 16).

Format de groupement d'entiers

Constante Description
$FmtIntUngrouped Affiche les entiers sans séparateur de milliers (par exemple, 1234567).
$FmtIntGroupedWithBlank Les milliers sont séparés par des espaces (par exemple, 1 234 567).
$FmtIntGroupedWithComma Les milliers sont séparés par des virgules (par exemple, 1,234,567).
$FmtIntGroupedWithDot Les milliers sont séparés par des points (par exemple, 1.234.567).

Format avec signe plus ou moins

Constante Description
$FmtIntSignNegOnly Place un signe moins devant les valeurs négatives. Les valeurs positives ne sont pas précédées d'un signe plus.
$FmtIntSigned Place un signe plus ou moins devant tous les entiers.

Caractères de remplissage

Constante Description
$FmtZeroPad Place un zéro devant les entiers à un chiffre (par exemple, 09) et comble tous les chiffres vides d'une chaîne par des caractères de remplissage.

Indicateurs de format de chaîne

Les constantes suivantes convertissent une chaîne en l'un des formats indiqués ci-après.
Conseil : Les indicateurs de style par défaut pour les Etats-Unis sont en italique.

Cette constante ... convertit la chaîne au format suivant ...
$FmtLeftJustify Justifié à gauche à l'intérieur de la zone de sortie.
$FmtRightJustify Justifié à droite à l'intérieur de la zone de sortie.
$FmtBlankPad Amené à un emplacement à l'aide d'espaces à l'intérieur de la zone de sortie. (Même effet que $FmtNoPad.)
$FmtNoPad Amené à un emplacement à l'aide d'espaces à l'intérieur de la zone de sortie. (Même effet que $FmtBlankPad.)
$FmtZeroPad Amené à une position remplie par des zéros à l'intérieur de la zone de sortie.

Format des nombres réels

Les constantes suivantes convertissent un nombre réel en une chaîne sous l'un des formats indiqués ci-après.
Conseil : Les indicateurs de style par défaut pour les Etats-Unis sont en italique.

Format avec signe plus ou moins

Constante Description
$FmtRealSignNegOnly Supprime le signe plus devant les nombres réels positifs. (Seuls les nombres réels négatifs sont précédés d'un signe moins.)
$FmtRealSigned Place un signe plus ou moins devant toutes les valeurs réelles.

Format décimal

Constante Description
$FmtRealDecimalDot Affiche un point comme séparateur décimal dans les nombres réels (par exemple, 3.14159).
$FmtRealDecimalComma Affiche une virgule comme séparateur décimal dans les nombres réels (par exemple, 3,14159).

Format de groupement de nombres réels

Constante Description
$FmtRealGroupedWithBlank Les milliers sont séparés par des espaces (par exemple, 1 234 567.00).
$FmtRealGroupedWithComma Les milliers sont séparés par des virgules (par exemple, 1,234,567,000).
$FmtRealGroupedWithDot Les milliers sont séparés par des points (par exemple, 1.234.567.000).
$FmtRealUngrouped Affiche les nombres réels sans séparateur de milliers (par exemple, 1234567.00).

Caractères de remplissage

Constante Description
$FmtZeroPad Place un zéro devant les entiers à un chiffre (par exemple, 09) et comble tous les chiffres vides d'une chaîne par des caractères de remplissage.


Conseil : L'indicateur de format pour les nombres réels peut également coder le nombre de chiffres figurant à droite du séparateur décimal, par exemple :

 WinWrite ($Handle, r:10: BitOr (2,$FmtLeftJustify));

justifie la sortie à gauche et affiche deux chiffres à droite de la position décimale. Par défaut, pour les nombres réels, six chiffres sont affichés à droite de la position décimale.

Conseil : Vous pouvez combiner une constante $FmtRealGroupedWithDot et une constante $FmtRealDecimalComma pour obtenir le résultat 1.234,567.

Indicateurs de format d'heure

Les constantes suivantes convertissent une valeur d'heure en une chaîne sous l'un des formats indiqués ci-après.
Conseil : Les indicateurs de style par défaut pour les Etats-Unis sont en italique.

Cette constante ... convertit une valeur d'heure en une chaîne qui ...
$FmtTimeAMPM Affiche l'heure sur 12 heures, accompagnée de la mention AM ou PM (par exemple, 6:45 PM).
$FmtTimeColonSeparators Sépare les heures, les minutes et les secondes par des signes deux-points. Ce format est utilisé pour convertir une heure en chaîne (par exemple, 12:35:06).
$FmtTimeDotSeparators Sépare les heures, les minutes et les secondes par des points.
$FmtTimeMilitary Affiche l'heure sur 24 heures (par exemple, 18:35:17).
$FmtTimeWithoutSeconds N'affiche pas les secondes.
$FmtTimeWithSeconds Affiche les secondes.
$FmtZeroPad Aligne l'heure en présentant chaque partie de l'heure sous la forme de deux chiffres (par exemple, 02:09:37).

Indicateurs de style de police

Ces indicateurs de style de police sont utilisés avec WinCreateScrollWindow et WinSetFont. Les styles peuvent être combinés.

Cet indicateur de style ... génère le style de police ...
$FontBold gras.
$FontItalic italique.
$FontPlain normal.
$FontStrikeout barré.
$FontUnderscore souligné.

Indicateurs de statut DDE

Un indicateur de statut DDE communique le résultat des actions demandées par le client au serveur. Le tableau ci-après présente les indicateurs de statut DDE pour OS/2 (certains n'ont pas d'équivalent exact sous Windows).

Cet indicateur de statut ... entraîne le résultat suivant sous OS/2 ...
DDEAck La demande est acceptée.
Remarque : Cet indicateur est identique sous Windows.
DDEAcknowledgeReq Un accusé de réception est demandé.
DDEAppStatus Il s'agit d'un masque de contrôle des données qui vous informe sur la partie application du statut, lorsque l'opérateur booléen AND est utilisé avec le mot Status.
DDEBusy L'application est occupée.
DDENoData Il n'existe aucune donnée pour la rubrique demandée.
DDENotProcessed Le message n'est pas compris.
DDEResponse Les données sont envoyées en réponse à une demande DDERequest.

Recherche de fichiers à l'aide de SAIPATH

Lorsque TSD Script recherche des objets tels que les fichiers .kbc (analyseur), .dfc (système de boîtes de dialogue) ou .ico (contrôle hypermédia), il utilise la stratégie et la séquence de recherche suivantes :

  1. Si un répertoire explicite est indiqué pour le fichier, la recherche se limite à ce répertoire.
  2. La recherche porte sur les répertoires explicitement spécifiés sur la ligne de commande.
  3. La recherche porte sur le répertoire de travail en cours.
  4. La recherche porte sur le répertoire à partir duquel le fichier kml.exe a été chargé, xx correspondant aux deux derniers chiffres du numéro de version de Tivoli Developer's Toolkit.
  5. La recherche porte sur les répertoires indiqués dans la variable d'environnement SAIPATH.
  6. (OS/2 uniquement) La recherche porte sur les répertoires indiqués dans la variable d'environnement DPATH.
  7. La recherche porte sur les répertoires indiqués dans la variable d'environnement PATH.

Si cette stratégie ne permet pas de trouver le fichier, l'outil renvoie un message d'erreur indiquant que le fichier est introuvable.


Tivoli Service Desk 6.0 Developer's Toolkit - Manuel de référence du langage TSD Script

Retour à la page principale

Copyright