Tivoli Service Desk 6.0 Developer's Toolkit Script - Manuel de référence du langage TSD Script
Retour à la page principale
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.
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. |
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. |
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. |
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. |
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. .
Indicateur de style | Description |
$WinOpaque | Le texte est opaque. (Cette option n'est pas disponible sous OS/2.) |
$WinTransparent | Le texte est transparent. |
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 |
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);
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.
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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. |
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 |
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. |
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. |
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. |
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. |
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. |
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. |
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.
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. |
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. |
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. |
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 |
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. |
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.
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). |
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). |
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.
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). |
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). |
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). |
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.
Constante | Description |
$FmtIntDecimal | Affiche les entiers sous forme décimale (en base 10). |
$FmtIntHexadecimal | Affiche les entiers sous forme hexadécimale (en base 16). |
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). |
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. |
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.
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. |
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). |
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). |
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). |
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é. |
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. |
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 :
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