Tivoli Service Desk 6.0 Developer's Toolkit - Manuel de référence du langage TSD Script
Retour à la page principale
Dans une application TSD Script en fenêtres, les événements sont les éléments fonctionnels principaux de l'application. Chaque événement représente une action pouvant déclencher une réaction. Ces événements peuvent être générés à partir de plusieurs sources, notamment :
Pour gérer les événements, vous créez des gestionnaires d'événements. Un gestionnaire d'événements est une routine qui définit les types d'événements pouvant se produire dans une zone spécifique de l'application, et les réactions appropriées à ces événements. Le gestionnaire d'événements accède à $Event, qui est une variable contenant une constante de message. Cette constant de message représente le type exact d'activité se produisant. Cette page offre des informations détaillées sur ces constantes de message ou messages comme elles sont appelées dans le présent document.
Les fenêtres et les boîtes de dialogue reçoivent des instructions de l'utilisateur final et transmettent ces informations à l'application TSD Script. Cette activité est appelée transmission de messages.
Vous devez prendre en compte les messages que vous envoyez et que vous recevez lorsque vous définissez les gestionnaires d'événements.
Cette page regroupe les messages selon les catégories suivantes :
Certains appels aux fonctions TSD Script (tels ceux concernant les contrôles de l'interface utilisateur) peuvent transmettre des messages à un gestionnaire d'événements. Par exemple, l'appel de DlgSetFieldValue pour un contrôle de boîte de dialogue envoie $MsgSelect au gestionnaire d'événements de la boîte de dialogue.
Comme il est décrit au début de cette page, les événements (et leurs messages) peuvent provenir de différentes sources. Il existe plusieurs instructions TSD Script pouvant envoyer des messages directement à votre application.
Ces instructions TSD Script et les messages pouvant être reçus par
votre application sont répertoriés dans le tableau ci-après.
Chaque constante de message représente un nombre interprété par une application TSD Script. La constante de message $MsgUser, contient la valeur la plus élevée dans la gamme de nombres réservés par Tivoli Systems Inc. pour les valeurs de constantes de message.
Pour créer un message personnalisé pour votre application, utilisez $MsgUser+n, où n correspond au nombre que vous avez attribué à la nouvelle constante de message. En tant que constante de message, $MsgUser+n est disponible à la fois sous forme de message transmissible et de message reçu. Vous trouverez plus d'informations sur $MsgUser+n dans cette page.
La présente section traite des sujets suivants :
Les messages recevables sont des messages reçus par un événement. Le tableau des messages recevables récapitule tous les messages reçus dans TSD Script.
Voici quelques conseils permettant d'interpréter plus facilement le tableau des messages reçus :
Tableau des messages recevables
$Event | Source | Paramètres |
$MsgAccept | Boîte de dialogue | $FieldId, $FieldName |
$MsgButton | Fenêtre hypertexte, boîte de dialogue | 1=texte du bouton, 2=ID du bouton |
$MsgCancel | Boîte de dialogue | $FieldId, $FieldName |
$MsgChar | Boîte de dialogue Autres |
$FieldId, $FieldName, 3=Code touche $KeyCode |
$MsgCreate | Boîte de dialogue Autres |
$FormFile, $FormName Aucun |
$MsgDDEAcknowledge | Quelconque | $DDEWindow, $DDEStatus (voir synonymes DDE) |
$MsgDDEAdvise | Quelconque | $DDEWindow, $DDETopic |
$MsgDDEData | Quelconque | $DDEWindow, $DDETopic, $DDEData |
$MsgDDEExecute | Quelconque | $DDEWindow, $DDETopic, $DDEData |
$MsgDDEInitAcknowledge | Quelconque | $DDEWindow, $DDETopic, $DDEData |
$MsgDDEInitiate | Quelconque | $DDEWindow, $DDETopic, $DDEData |
$MsgDDEPoke | Quelconque | $DDEWindow, $DDETopic, $DDEData |
$MsgDDERequest | Quelconque | $DDEWindow, $DDETopic |
$MsgDDETerminate | Quelconque | $DDEWindow |
$MsgDDEUnAdvise | Quelconque | $DDEWindow, $DDETopic |
$MsgDestroy | Quelconque | Aucun élément de fenêtre |
$MsgEnterField | Boîte de dialogue | $FieldId, $FieldName |
$MsgExitField | Boîte de dialogue | $FieldId, $FieldName |
$MsgFocus | Quelconque | $EventParm (1, booléen) |
$MsgHelp | Boîte de dialogue | $FieldId, $FieldName |
$MsgImage | Parent de la fenêtre image | 1=ID image |
$MsgInitialize | Boîte de dialogue | $FieldId, $FieldName, 3=ancienne valeur, 4=nouvelle valeur |
$MsgLabel | Fenêtre hypertexte, boîte de dialogue | 1=texte du bouton, 2=libellé du bouton |
$MsgMandField | Boîte de dialogue | $FieldId, $FieldName |
$MsgMouse | Zone souris | 1=ID, 2=activité de la souris, 3=X, 4=Y |
$MsgMenu | Barre de menus Barre d'outils |
$MenuSelection (n*100 + m) ou valeur définie par l'utilisateur, $MenuId, 2=chaîne $MenuSelection (1-99) ou valeur définie par l'utilisateur, |
$MsgPaint | Générique | Aucun |
$MsgPaintStatus | Toute boîte de dialogue ou fenêtre contenant une barre d'état. |
Aucun |
$MsgPageChange | Toute boîte de dialogue contenant un bloc-notes | 1 = nom de la page active avant le changement de page
2 = nom de la page active (la nouvelle page) |
$MsgPageChangeRequest | Toute boîte de dialogue contenant un bloc-notes | 1 = nom de la page active avant le changement de page
2 = nom de la page active (la nouvelle page) |
$MsgScroll | Fenêtre générique | 1=$WinHScroll/$WinVScroll, 2=emplacement de la représentation miniature |
$MsgSelect | Boîte de dialogue | $FieldId, $FieldName, 3=ancienne valeur, 4=nouvelle valeur |
$MsgSize | Générique, fenêtre dotée d'une barre de défilement | 1=largeur de la fenêtre, 2=hauteur de la fenêtre |
$MsgTimer | Quelconque | 1=ID minuterie |
$MsgUser+n | Quelconque | Les détails appartiennent à l'expéditeur et au destinataire. |
Chaque constante de message est un paramètre de l'instruction $Event. Cependant, la définition de la constante de message inclut des informations supplémentaires ou des paramètres d'événement. Par exemple, si un utilisateur clique sur un bouton dans une boîte de dialogue, votre application reçoit une constante de message $MsgButton. Les paramètres de l'événement défini pour cette constante de message sont les noms de zone et les ID de zone du bouton choisi.
Lorsque vous recevez le message $MsgButton, vous pouvez obtenir les valeurs du paramètre de l'événement en utilisant les synonymes des messages. Les synonymes offrent un raccourci pour l'obtention des valeurs. Par exemple, pour obtenir la valeur du nom de zone, vous pouvez utiliser le synonyme, $FieldName. Par exemple :
Nom de zone : = $FieldName;
S'il n'existe aucun paramètre défini pour un paramètre d'événement, vous pouvez utiliser $EventParm pour obtenir la valeur. Pour utiliser $EventParm, vous devez indiquer le nombre de paramètres d'événement et le type de données de la valeur. Par exemple, pour tous les messages recevables des boîtes de dialogue, le nom de zone est contenu dans le paramètre d'événement. Pour obtenir la valeur du paramètre d'événement de nom de zone, vous pouvez utiliser la notation ci-après.
$EventParm (2, string);
Voici un exemple :
EVENT ExampleEvent (REF rec : MyRecord) IS
VARIABLES
width, height : INTEGER;
ACTIONS
WHEN $Event IS $MsgSize THEN
width := $EventParm(1, INTEGER);
height := $EventParm (2, INTEGER);
ELSWHEN...
END;
END;
Lorsque cela est possible, vous devez utiliser des synonymes pour obtenir les valeurs des paramètres d'événement. Le tableau des messages recevables répertorie les paramètres d'événement et les synonymes des messages recevables.
Conseil : Tous les messages des boîtes de
dialogue ont des synonymes définis pour les premiers et les deuxièmes
paramètres d'événement identiques :
$FieldId (premier paramètre d'événement) contient l'ID de zone et $FieldName (deuxième paramètre d'événement) contient le nom de zone.
Lorsque vous transmettez un message, l'ordre des paramètres
d'événement est important. Pour plus d'informations, reportez-vous à la section
"Transmission
de messages : Poster et envoyer". Reportez-vous également aux instructions
PostMessage et
SendMessage.
La présente section traite des messages provenant d'une boîte de dialogue pouvant être reçus par un gestionnaire d'événements.
Conseil : Les messages recevables provenant
d'une boîte de dialogue impliqués dans une conversation DDE sont
répertoriés dans la section "Messages recevables des DDE" de la présente rubrique.
Le tableau ci-après répertorie uniquement les messages provenant
d'une boîte de dialogue et pouvant être reçus par un gestionnaire
d'événements.
Tableau des messages
recevables (Messages de boîtes de dialogue uniquement)
$Event | Source | Paramètres |
$MsgAccept | Boîte de dialogue | $FieldId, $FieldName |
$MsgButton | Boîte de dialogue | 1=texte du bouton, 2=Id bouton |
$MsgCancel | Boîte de dialogue | $FieldId, $FieldName |
$MsgChar | Boîte de dialogue
|
$FieldId, $FieldName, 3=Code touche $KeyCode |
$MsgCreate | Boîte de dialogue | $FormFile, $FormName |
$MsgDestroy | Quelconque | Aucun |
MsgDisplayImage | Boîte de dialogue | $ButtonText, $FieldId, $FieldName, $FileName,
$ImageFile, $ProgramArguments, $SearchText, $SoundFile, 1=entier, 2=chaîne, 3=chaîne, 4=chaîne |
$MsgEnterField | Boîte de dialogue | $FieldId, $FieldName |
$MsgExitField | Boîte de dialogue | $FieldId, $FieldName |
$MsgHelp | Boîte de dialogue | $FieldId, $FieldName |
$MsgImage | Parent de l'image | 1=ID de l'image |
$MsgInitialize | Boîte de dialogue | $FieldId, $FieldName, 3=ancienne valeur, 4=nouvelle valeur |
$MsgLabel | Boîte de dialogue | 1=texte du bouton, 2=libellé du bouton |
$MsgListboxAccept | Boîte de dialogue | $FieldId, $FieldName, 3=chaîne pour les listes, entier pour le tableau |
$MsgMandField | Boîte de dialogue | $FieldId, $FieldName |
$MsgMouse | Zone souris | 1=ID, 2=activité de la souris, 3=X, 4=Y |
$MsgMenu | Barre de menus
|
$MenuSelection (n*100 + m)
|
$MsgOpenFile | Boîte de dialogue | $ButtonText, $FieldId, $FieldName, $FileName,
$ImageFile, $ProgramArguments, $SearchText, $SoundFile, 1=entier, 2=chaîne, 3=chaîne, 4=chaîne |
$MsgPlaySound | Boîte de dialogue | $ButtonText, $FieldId, $FieldName, $FileName,
$ImageFile, $ProgramArguments, $SearchText, $SoundFile, 1=entier, 2=chaîne, 3=chaîne, 4=chaîne |
$MsgRunProgram | Boîte de dialogue | $ButtonText, $FieldId, $FieldName, $FileName,
$ImageFile, $ProgramArguments, $SearchText, $SoundFile, 1=entier, 2=chaîne, 3=chaîne, 4=chaîne |
$MsgSearch | Boîte de dialogue | $ButtonText, $FieldId, $FieldName, $FileName,
$ImageFile, $ProgramArguments, $SearchText, $SoundFile, 1=entier, 2=chaîne, 3=chaîne, 4=chaîne |
$MsgSelect | Boîte de dialogue | $FieldId, $FieldName, 3=ancienne valeur, 4=nouvelle valeur |
$MsgTimer | Quelconque | 1=ID minuterie |
$MsgUser+n | Quelconque | Les détails appartiennent à l'expéditeur et au destinataire |
Il existe plusieurs synonymes utilisés avec les messages recevables des boîtes de dialogue. Les synonymes les plus fréquemment utilisés sont $FieldId et $FieldName.
Les autres synonymes apparaissant dans le tableau des messages recevables sont décrits ainsi que les messages associés. Pour des informations générales sur l'utilisation des synonymes, reportez-vous à la section "Paramètres et synonymes de message" de cette page.
Les messages recevables des boîtes de dialogue répertoriés dans le tableau des messages recevables sont décrits ici.
Reçu par | Toute boîte de dialogue contenant le contrôle. |
Description | $MsgAccept est reçu lorsqu'un événement d'acceptation est généré dans la boîte de dialogue. |
Paramètres d'événement | Il existe deux paramètres d'événement :
|
Réponse | L'action d'acceptation peut être annulée en cas de retour de la valeur 0 par le groupe d'événements. |
Remarques | L'événement d'acceptation se déclenche :
Sous OS/2, si aucun bouton n'est défini en tant que bouton
par défaut et si le curseur ne se trouve pas dans une zone qui
interprète la touche Entrée, un événement d'acceptation est généré
lorsque l'utilisateur appuie sur la touche Entrée. |
Reçu par | Toute fenêtre d'afficheur hypertexte. |
Description | $MsgButton est reçu lorsqu'un bouton de
type ID (type par défaut) est sélectionné dans une fenêtre
d'afficheur hypertexte. Remarque : Un bouton dans un afficheur hypertexte représente un lien vers une autre entité (telle qu'un autre fichier, un autre endroit dans le fichier existant, une image, un fichier son ou un fichier exécutable). |
Paramètres d'événement | Il existe deux paramètres d'événement :
|
Reçu par | La boîte de dialogue contenant le contrôle. |
Description | $MsgCancel est reçu lorsque la boîte de dialogue génère un événement d'annulation. Un événement d'annulation est généré lorsque l'utilisateur clique sur le bouton Annuler ou appuie sur la touche Echap. |
Paramètres d'événement | Il existe deux paramètres d'événement :
|
Réponse | L'action d'annulation peut être interrompue lorsque le groupe d'événements renvoie la valeur zéro. Si l'action n'est pas refusée, la boîte de dialogue se ferme. |
Reçu par | Toute boîte de dialogue. |
Description | $MsgChar est reçu dans une boîte de dialogue lorsque l'utilisateur entre un caractère dans un contrôle et que ce caractère ne peut être traité par le contrôle. Les caractères exacts transmis au gestionnaire d'événements varient en fonction des zones. Généralement, les touches Control et Alt ainsi que les touches de fonction sont reconnues. |
Paramètres d'événement | Il existe trois paramètres d'événement :
|
Réponse | Le paramètre $KeyCode ne peut pas être utilisé avec des boîtes de dialogue. Le caractère est transmis dans le troisième paramètre d'événement (entier). |
Remarques | La valeur de la touche F1 n'est pas transmise à la boîte de dialogue. La touche F1 génère alors un message $MsgHelp ou affiche le texte d'aide correspondant. |
Reçu par | Toute boîte de dialogue en cours de création. |
Description | $MsgCreate est un des premiers messages reçu par une boîte de dialogue à sa création. |
Paramètres d'événement | Il existe quatre types de paramètres
d'événement :
|
Réponse | La valeur zéro renvoyée par le groupe d'événements interrompt la création de la boîte de dialogue. Les instructions DlgCreate et DlgBox renvoient une erreur de non création. |
Remarques | Lorsque $MsgCreate est reçu, la boîte de
dialogue n'est pas encore affichée. Cependant, les événements
suivants ont déjà eu lieu :
Pour plus d'informations, reportez-vous au message $MsgInitialize. |
Reçu par | Toute boîte de dialogue. |
Description | Ce message est généré lorsqu'un
message $MsgClose est envoyé à la boîte de dialogue. Le
message $MsgClose est généré lorsque l'utilisateur
accepte ou ferme la boîte de dialogue. Lorsque la boîte de dialogue reçoit le message $MsgDestroy, le descripteur de fenêtre reste actif jusqu'à la fin du processus de destruction. La boîte de dialogue continue de recevoir des messages jusqu'à l'apparition du message $MsgDestroy. |
Réponse | Toute réponse est ignorée. |
Remarques | Ce message doit être reçu par la boîte de dialogue après destruction des contrôles et des fenêtres enfant. |
Reçu par | Toute boîte de dialogue. |
Description | $MsgEnterField est généré lorsqu'un
utilisateur entre un contrôle (soit en appuyant sur la touche Tab
soit en cliquant sur un contrôle différent). La réception s'effectue lorsque le curseur se déplace sur un autre contrôle. Le contrôle actif reçoit le message $MsgExitField. |
Paramètres d'événement | Il existe deux paramètres d'événement :
|
Réponse | Pour empêcher le curseur de se placer sur un autre contrôle, renvoyez la valeur zéro du groupe d'événements lors du traitement du message. |
Remarques | Si l'accès au nouveau contrôle est refusé, le
curseur retourne dans la zone que l'utilisateur vient de quitter. Un
autre message $MsgEnterField est alors généré lorsque le
curseur change. Si le retour dans ce contrôle est alors refusé, l'événement est annulé et aucun contrôle n'a le curseur. |
Reçu par | Toute boîte de dialogue. |
Description | $MsgExitField est généré lors de la sortie d'un contrôle (soit en appuyant sur la touche Tab ou en cliquant sur un contrôle différent). Ce message est reçu avant la sortie du contrôle par le curseur. |
Paramètres d'événement | Il existe deux paramètres d'événement :
|
Réponse | Pour empêcher le curseur de se déplacer, renvoyez la valeur zéro par le groupe d'événements lors du traitement du message. |
Reçu par | Toute boîte de dialogue. |
Description | $MsgFocus est généré lorsqu'une boîte de dialogue n'est plus active. |
Paramètres d'événement | $EventParm (1, booléen) indique si la boîte de dialogue n'est plus active. |
Reçu par | Toute boîte de dialogue. |
Description | $MsgHelp est généré lorsque l'utilisateur clique sur un bouton Aide mais que le système ne peut trouver d'aide correspondant à la boîte de dialogue ou au contrôle. |
Paramètres d'événement | Il existe deux paramètres d'événement :
|
Reçu par | Toute boîte de dialogue. |
Description | $MsgInitialize est une version spéciale
de $MsgSelect qui se déclenche uniquement lors de la phase
de création d'une boîte de dialogue. $MsgInitialize permet un traitement spécial des valeurs des contrôles de boîte de dialogue lors de la création. Après la création, tous les événements d'un contrôle de boîte de dialogue sont reçus en tant que messages $MsgSelect. |
Paramètres d'événement | Le message $MsgInitialize comporte
quatre paramètres d'événement, de la même manière que
$MsgSelect :
|
Reçu par | Toute boîte de dialogue. |
Description | $MsgLabel est généré lorsque l'utilisateur sélectionne un bouton de type LABEL dans une fenêtre d'afficheur hypertexte. |
Paramètres d'événement | Le message $MsgLabel a deux types de
paramètres d'événement :
|
Reçu par | Toute boîte de dialogue |
Description | $MsgListboxAccept répertorie l'élément sur lequel vous avez cliqué deux fois dans une boîte à liste. |
Paramètres d'événement | Il existe trois paramètres d'événement :
|
Réponse | Lorsque vous quittez ce message, le message $MsgAccept n'apparaît pas. |
Reçu par | Toute boîte de dialogue |
Description | $MsgMandField est reçu lors de la réception d'une action d'acceptation par une boîte de dialogue et lorsqu'une zone obligatoire n'est pas renseignée. |
Paramètres d'événement | Il existe deux paramètres d'événement :
|
Réponse | Si la valeur FALSE est renvoyée, le système ne
peut pas traiter le message. Si le message n'est pas traité ou si le groupe d'événements renvoie la valeur par défaut (1), le système affiche une boîte de message informant l'utilisateur qu'une valeur obligatoire manque et que l'action d'acceptation a été annulée. Lorsque l'utilisateur ferme la boîte de dialogue, le curseur est placé sur le premier contrôle obligatoire vide de la boîte de dialogue. Les messages $MsgExitField, $MsgSelect et $MsgEnterField peuvent être générés par le déplacement. L'action d'acceptation est interrompue. Si le groupe d'événements renvoie une valeur différente de 1, aucune action n'est entreprise par le système. L'application doit placer le curseur et refuser le message $MsgAccept. |
Reçu par | Toute boîte de dialogue. |
Description | $MsgMenu est reçu lorsque l'utilisateur effectue une sélection dans une barre de menus ou dans une barre d'outils de la boîte de dialogue. |
Paramètres d'événement | Le pseudo-paramètre, $MenuSelection, comporte l'index
de l'option de menu sélectionnée.
Une sélection dans la barre d'outils génère une valeur entre 1 et
99, en fonction de l'emplacement de l'icône. Une sélection dans la
barre de menus génère une valeur en fonction de la formule : n x 100 + m où n correspond à l'emplacement de la sélection active dans la barre de menus principale et m correspond à l'emplacement de la sélection dans le sous-menu. |
Remarques | Il n'existe aucun nom ou ID du contrôle actif avec ce message. De plus, dans les versions précédentes, il était possible de simuler une sélection de menu. Cette fonction n'est plus prise en charge. |
La position du texte actif pour la barre d'état est redéfinie à 1,1 à chaque génération d'un message $MsgPaintStatus.
Reçu par | Toute boîte de dialogue contenant un bloc-notes. |
Description | Le message $MsgPageChange est reçu par le gestionnaire d'événements du bloc-notes lors de la création du bloc-notes (définition de la page initiale) et lors d'une modification de la page active. Les paramètres de l'événement définissent l'ancienne et la nouvelle page. |
Paramètres d'événement | Il existe deux paramètres d'événement :
|
Remarques | Ce message est également reçu lorsque ce message s'affiche pour la première fois (après $MsgCreate). Dans ce cas, la valeur $Unknown est attribuée au premier paramètre et le deuxième paramètre correspond au nom de la page initiale. |
Reçu par | Toute boîte de dialogue contenant un bloc-notes. |
Description | Le message $MsgPageChangeRequest apparaît avant le changement de page. (Si vous quittez en utilisant la valeur zéro, le changement de page ne s'effectue pas.) Les paramètres de l'événement définissent l'ancienne et la nouvelle page. |
Paramètres d'événement | Il existe deux paramètres d'événement :
|
Reçu par | Toute boîte de dialogue. |
Description | $MsgSelect est reçu à chaque
fois que la valeur d'un contrôle est modifiée. Lors de la réception de ce message, les données d'instance sont mises à jour en vue de refléter la nouvelle valeur du contrôle. Durant le traitement de $MsgSelect, il est impossible de déterminer la valeur réelle du contrôle. Cette restriction est due au fait que sous Windows, les données d'instance sont mises à jour en insérant la valeur réelle du champ avant que l'appel de $MsgSelect n'ait lieu. Cette restriction est due au fait que sous Windows, les données d'instance sont mises à jour en insérant la valeur réelle du champ après l'appel de $MsgSelect. |
Paramètres d'événement | Le message $MsgSelect
comporte quatre paramètres d'événement :
|
Réponse | Renvoie la valeur 1 afin de permettre le maintien de la nouvelle valeur. Les messages résultants sont $MsgExitField et $MsgEnterField. |
Remarques | Un message $MsgSelect peut être généré de plusieurs façons :
Le type de données relatif à la valeur contenue dans le
paramètre d'événement 3 dépend des données d'instance auxquelles
renvoient les données d'instance. Si aucun identifiant ne
correspond, les données sont $Unknown. |
Reçu par | Toute boîte de dialogue. |
Description | $MsgTimer est reçu en réponse à un événement de minuterie. |
Paramètres d'événement | Le paramètre d'événement (entier) contient l'ID de minuterie tel qu'il a été transmis via $MsgStartTimer. |
Remarques | Une fenêtre doit comporter une fenêtre définie afin de recevoir un message $MsgTimer. |
Reçu par | Toute boîte de dialogue comportant un gestionnaire d'événements. |
Description | Constante de message définie par l'utilisateur. |
Paramètres d'événement | Tout paramètre d'événement pouvant être
transmis à un message défini par l'utilisateur. Si des
paramètres supplémentaires sont attribués dans l'instruction
SendMessage, ils peuvent être attribués dans le
gestionnaire d'événements. La fenêtre recevant les informations doit savoir quels sont les paramètres valides pour le message. |
Remarques | Tous les message définis par l'utilisateur doivent comporter une valeur de $MsgUser+n où n est un nombre que vous choisissez afin de l'attribuer à la nouvelle constante de message. |
La présente section traite des messages recevables des fenêtres.
Dans le tableau des messages recevables, les éléments répertoriés dans la colonne $Event représentent les constantes de message.
Les éléments répertoriés dans la colonne Source représentent le type de composant de l'application (boîte de dialogue ou fenêtre) qui envoie le message.
L'entrée de cette colonne détermine la classification du message. Par exemple, le message $MsgCreate comporte la source, boîte de dialogue, et est donc un message recevable de boîte de dialogue. Pour plus d'informations sur ce message, reportez-vous à la rubrique "Messages recevables de boîte de dialogue".
Certains éléments répertoriés dans la colonne Source sont abrégés. Par exemple :
La colonne Paramètres répertorie les paramètres d'événement définis pour la constante de message. Les valeurs synonymes commencent par le caractère $ (pour plus d'informations, reportez-vous à "Synonymes de fenêtres".)
Tableau des messages recevables (messages fenêtre uniquement)
$Event | Source | Paramètres |
$MsgActivate | Fenêtre générique, fenêtre de défilement | 1=statut d'activation |
$MsgButton | Fenêtre hypertexte, boîte de dialogue | 1=texte du bouton, 2=ID du bouton |
$MsgChar | Toute fenêtre | $KeyCode |
$MsgCreate | Toute fenêtre | S'applique aux boîtes de dialogue uniquement |
$MsgDestroy | Toute fenêtre | Aucun |
$MsgImage | Parent de l'image | 1=ID image |
$MsgLabel | Fenêtre hypertexte, boîte de dialogue | 1=texte du bouton, 2=libellé du bouton |
$MsgMouse | Zone souris | 1=ID, 2=activité de la souris, 3=X, 4=Y |
$MsgMenu | Barre de menus Barre d'outils |
$MenuSelection (n*100 + m) $MenuSelection (1-99) |
$MsgPaint | Générique | Aucun |
$MsgPaintStatus | Toute fenêtre ou boîte de dialogue contenant une barre d'état | Aucun |
$MsgScroll | Fenêtre générique | 2=emplacement de l'image miniature, 1=$WinHScroll / $WinVScroll |
$MsgSize | Générique, fenêtre dotée d'une barre de défilement | 1=largeur de la fenêtre, 2=hauteur de la fenêtre |
$MsgTimer | Quelconque | 1=ID minuterie |
$MsgUser+n | Quelconque | Les détails appartiennent à l'expéditeur et au destinataire |
Les synonymes apparaissant dans le tableau des messages recevables (messages fenêtre uniquement) sont décrits ainsi que les messages associés. Pour des informations générales sur l'utilisation des synonymes, reportez-vous à la section "Paramètres et synonymes de message".
Reçu par | Fenêtre ou fenêtre de défilement. |
Description | $MsgActivate est reçu lorsqu'une fenêtre ou fenêtre de défilement est activée ou désactivée. |
Paramètres d'événement | Il existe un paramètre d'événement :
|
Réponse | Si la fenêtre est activée, le point d'entrée se
trouve dans cette fenêtre. Si elle est désactivée, le point d'entrée se déplace vers la fenêtre qui devient active. La couleur de la fenêtre peut changer pour refléter l'activation ou la désactivation, en fonction de la configuration du système. |
Reçu par | Fenêtre d'afficheur hypertexte. |
Description | $MsgButton est reçu lorsqu'un bouton de
type ID (type par défaut) est sélectionné dans une fenêtre
d'afficheur hypertexte. Remarque : un bouton dans un afficheur hypertexte représente un lien vers une autre entité (tel qu'un autre fichier, un autre endroit du fichier existant, un fichier son ou un fichier exécutable). |
Paramètres d'événement | Il existe deux paramètres d'événement :
|
Réponse | Si l'ID du bouton est 0 et que le gestionnaire d'événements renvoie la valeur 0, la fenêtre d'afficheur d'hypertexte modifie le texte du bouton et recherche une correspondance dans le fichier actif. Si une correspondance est trouvée, le fichier est parcouru de manière à ce que la ligne correspondante soit placée au début de l'afficheur. |
Reçu par | Toute boîte de dialogue. |
Description | $MsgChar est reçu lorsque l'utilisateur entre à partir du clavier un caractère et que la fenêtre active ne le traite pas. |
Paramètres d'événement | Le paramètre $KeyCode peut être utilisé pour accéder au caractère. Le caractère peut être un caractère imprimable ou une des définitions $Key standard. Pour une liste complète des codes touche disponibles, reportez-vous à la section $KeyCode.) |
Reçu par | Toute fenêtre ou boîte de dialogue. |
Description | Ce message est reçu après l'initialisation des contrôles dans une fenêtre ou une boîte de dialogue. Lorsque ce message est reçu, la fenêtre ou la boîte de dialogue est tracée. |
Reçu par | Toute fenêtre. |
Description | $MsgDestroy est le dernier message reçu par une fenêtre avant sa destruction (sauf si la destruction de la fenêtre fait partie de l'arrêt d'une application). |
Remarques | Lorsque le message $MsgDestroy est reçu, toutes les fenêtres enfant subsistent sauf si elles ont été explicitement détruites. |
Reçu par | Toute fenêtre image. |
Description | $MsgImage est envoyé par une fenêtre image pour indiquer au parent que l'utilisateur a cliqué sur l'image. |
Paramètres d'événement | Le paramètre d'événement (entier) comporte l'ID de l'image sélectionnée. |
Reçu par | Fenêtre d'afficheur hypertexte. |
Description | $MsgLabel est reçu lorsqu'un bouton de type LABEL est sélectionné dans une fenêtre d'afficheur hypertexte. |
Paramètres d'événement | Il existe deux paramètres d'événement :
|
Reçu par | Toute boîte de dialogue comportant une barre de menus ou une barre d'outils. |
Description | $MsgMenu est reçu lorsque l'utilisateur effectue une sélection dans une barre de menus ou une barre d'outils. |
Paramètres d'événement | $MenuSelection contient l'ID de l'option de menu sélectionnée. |
Remarques | L'ID de l'option de menu sélectionnée peut être
envoyé à toute fenêtre comportant une barre de menus. Il simule
l'action d'un utilisateur qui sélectionne un élément de menu
comportant l'index contenu dans le paramètre MenuSelection. Une sélection dans la barre d'outils génère une valeur entre 1 et 99, en fonction de l'emplacement de l'icône sur la barre d'outils. Une sélection dans la barre de menus génère une valeur en appliquant cette formule : n x 100 + m où n correspond à l'emplacement de la sélection active
dans la barre de menus principale et m correspond à
l'emplacement de la sélection dans le sous-menu. |
Reçu par | Toute fenêtre. |
Description | $MsgMouse est reçu lorsqu'il y a une
action dans une zone souris définie par l'instruction WinCreateMouseRect. |
Paramètres d'événement | $MsgMouse comporte les paramètres
d'événement suivants :
|
Remarques | WinSetMousePointer doit être appelé à
chaque traitement de $MsgMouse. Les activité de la souris définies comprennent :
Pour plus d'informations, reportez-vous à la rubrique WinCreateMouseRect. |
Reçu par | Toute fenêtre générique. |
Description | $MsgPaint est reçu lorsque la fenêtre dans son intégralité ou une partie de la fenêtre doit être retracée. |
Reçu par | Toute fenêtre. |
Description | $MsgScroll est reçu lorsque l'utilisateur déplace la zone de défilement sur la barre de défilement horizontal ou vertical. |
Paramètres d'événement | Il existe deux paramètres d'événement :
|
Reçu par | Toute fenêtre générique ou fenêtre comportant une barre de défilement. |
Description | Permet de définir la taille de la fenêtre. |
Reçu par | Toute fenêtre. |
Description | $MsgTimer est reçu en réponse à un événement de minuterie. |
Paramètres d'événement | Le paramètre d'événement (entier) contient l'ID de l'horloge tel qu'il est transmis dans $MsgStartTimer. |
Remarques | Une fenêtre doit comporter une horloge définie afin de recevoir un message $MsgTimer. |
Reçu par | Toute fenêtre comportant une fonction d'événement. |
Description | Constante de message définie par l'utilisateur. |
Paramètres d'événement | Tout paramètre d'événement pouvant être transmis à un message défini par l'utilisateur. Si des paramètres supplémentaires peuvent être attribués dans l'instruction SendMessage, ils peuvent également être attribués dans la fonction d'événement. |
Remarques | Tous les messages définis par l'utilisateur
doivent comporter une valeur de $MsgUser+n où n correspond à un nombre que vous avez chois pour attribuer à la nouvelle constante de message. |
La présente section aborde les messages pouvant être reçus par un gestionnaire d'événements défini pour une boîte de dialogue ou une application exécutée dans une application DDE.
Les éléments répertoriés dans la colonne $Event représentent les constantes de message.
Les éléments répertoriés dans la colonne Source représentent le type de composant de l'application (boîte de dialogue ou fenêtre) qui envoie le message.
L'entrée de cette colonne détermine la classification du message. Par exemple, le message $MsgCreate comporte la source, la boîte de dialogue et est donc un message recevable de boîte de dialogue. Pour plus d'informations sur ce message, reportez-vous à la rubrique "Messages recevables de boîte de dialogue".
Dans la colonne Source, le terme Tous représente toute boîte de dialogue ou tout élément de menu d'une application en cours d'exécution.
La colonne Paramètres répertorie les paramètres d'événement définis pour la constante de message. Les valeurs synonymes commencent par le caractère $. Pour plus d'informations, reportez-vous à la rubrique "Synonymes DDE".
Le tableau suivant répertorie les messages pouvant être reçu par un gestionnaire d'événements défini pour une boîte de dialogue ou une application exécutée dans une application DDE.
Tableau des messages recevables (messages DDE uniquement)
$Event | Source | Paramètres |
$MsgDDEAcknowledge | Quelconque | $DDEWindow, $DDEStatus |
$MsgDDEAdvise | Quelconque | $DDEWindow, $DDETopic |
$MsgDDEData | Quelconque | $DDEWindow, $DDETopic, $DDEData |
$MsgDDEExecute | Quelconque | $DDEWindow, $DDETopic, $DDEData |
$MsgDDEInitAcknowledge | Quelconque | $DDEWindow, $DDETopic, $DDEData |
$MsgDDEInitiate | Quelconque | $DDEWindow, $DDETopic, $DDEData |
$MsgDDEPoke | Quelconque | $DDEWindow, $DDETopic, $DDEData |
$MsgDDERequest | Quelconque | $DDEWindow, $DDETopic |
$MsgDDETerminate | Quelconque | $DDEWindow |
$MsgDDEUnAdvise | Quelconque | $DDEWindow, $DDETopic |
Conseil : Lorsqu'un message DDE
est reçu, un message $MsgDDEAcknowledge doit être renvoyé.
S'il n'est pas possible de renvoyer un message
$MsgDDEAcknowledge, une perte de mémoire se produit.
Conseil : Si vous voulez envoyer un accusé de
réception positif lors de la réception d'un message $MsgDDExxx, il vous suffit de taper EXIT ($DDEAck). Si vous voulez envoyer un accusé de réception négatif, tapez EXIT(0).
Il existe un groupes de synonymes disponibles spécialement pour les messages DDE. Ces synonymes sont :
Lorsque vous utilisez ces indicateurs, analysez-les avec l'instruction BitAnd. Pour plus d'informations, reportez-vous à la rubrique BitAnd.
Le tableau suivant affiche les termes utilisés pour la description
des messages transmis entre les applications DDE.
Terme | Définition |
Conversation | Echange d'informations entre deux applications dans une session DDE. |
Partenaire | Membre d'une conversation DDE. |
Client | Partenaire demandant des informations à partir d'une autre application dans la conversation. |
Serveur | Partenaire fournissant les informations demandées au partenaire DDE client. |
Paire Application/Rubrique | Si vous êtes un client DDE, élément que vous
transmettez au serveur DDE afin d'établir une liaison de
communication. Si vous êtres un serveur DDE, combinaison d'applications et de rubrique(s) que vous pouvez gérer. |
Reçu par | Un des partenaires DDE (client ou serveur). |
Description | Ce message informe le partenaire DDE du
succès ou de l'échec d'une action demandée. $MsgDDEAcknowledge
doit être envoyé en réponse à un des messages suivants :
|
Paramètres d'événement (Windows) |
Les paramètres d'événement sont utilisés avec
l'instruction DDEExecute dans Windows.
Les paramètres d'événement suivants sont utilisés avec tous les autres messages DDE dans Windows.
|
Paramètres d'événement (OS/2) | Les paramètres d'événement sont utilisés avec
$DDEExecute dans OS/2.
Les paramètres d'événement sont utilisés avec tous les autres messages DDE dans OS/2.
|
Remarques | Si $DDEData est le message reçu, il peut être envoyé à la place des données du message en cours. |
Reçu par | Tout serveur DDE. |
Description | Demande des mises à jour continues de la rubrique contenue dans $DDETopic. Il s'agit d'un message textuel uniquement. |
Paramètres d'événement (Windows) | Les paramètres d'événement suivants sont
utilisés avec Windows.
|
Paramètres d'événement (OS/2) | Les paramètres d'événement suivants sont
utilisés avec OS/2.
|
Réponse | L'application doit exécuter un message DDEData à chaque changement des données. |
Reçu par | Tout client DDE. |
Description | Ce message est envoyé dans deux cas :
|
Paramètres d'événement | Il existe plusieurs paramètres d'événement possibles :
|
Valeur de sortie | $DDEAck est renvoyé en cas d'utilisation
des données.
Par exemple : EXIT ($DDEAck) |
Remarques | Si des données sont envoyées en réponse à un message DDEAdvise, l'indicateur $DDEStatus peut être défini à $DDENoData. Dans ce cas, l'application émet un message DDERequest pour extraire les données réelles. |
Reçu par | Tout serveur DDE. |
Description | Le message est envoyé pour indiquer au serveur d'entreprendre une action. |
Paramètres d'événement (Windows) | Les paramètres d'événements suivants sont
utilisés avec Windows.
|
Paramètres d'événement (OS/2) | Les paramètres d'événement suivants sont
utilisés avec OS/2.
|
Valeur de sortie | $DDEAck doit être envoyé à l'aboutissement d'une commande. |
Remarques | Les partenaires sont responsables de la définition des chaînes de commande. |
Reçu par | Tout serveur DDE. |
Description | $MsgDDEInitAcknowledge est
reçu en réponse à une fonction DDEInitiate. Chaque
application qui correspond à l'application ou à la paire de
rubriques et qui est transmise à DDEInitiate
envoie un message $MsgDDEInitAcknowledge comportant les
éléments suivants :
|
Paramètres d'événement | Il existe deux paramètres d'événement :
|
Remarques | Un message $MsgDDEInitAcknowledge est envoyé pour chaque application correspondante ou paire de rubriques. Par exemple, si des indications stipulent que la chaîne de la rubrique doit être vide, le serveur envoie un message $MsgDDEInitAcknowledge pour chaque rubrique prise en charge. |
Reçu par | Toute application serveur DDE potentielle. |
Description | $MsgDDEInitiate est reçu lorsqu'une
application demande que l'application qui reçoit soit un serveur DDE. L'application
qui reçoit doit vérifier le nom de l'application dans $DDEData
afin de déterminer s'il s'agit du destinataire souhaité. Si l'application est le destinataire souhaité, elle doit vérifier la valeur de $DDETopic pour déterminer si la demande peut être satisfaite. Les chaînes de longueur zéro de $DDEData et $DDETopic sont acceptées en tant que correspondances d'une application ou d'une rubrique. |
Paramètres d'événement | Il existe deux paramètres d'événement :
|
Réponse | Appelle DDERespond. Transmet chaque rubrique et application en fonction des besoins. |
Remarques | N'utilisez pas DlgBox,
WinMessageBox ou WinWait lors du traitement d'un
message $MsgDDEInitiate. $MsgDDEInitiate diffuse un message aux applications et verrouille la file d'attente des messages jusqu'à ce qu'une réponse soit renvoyée. Pendant ce temps ces instructions lancent chacun un gestionnaire d'événements qui attend également une réponse de la file d'attente des messages. Ces instructions empêchent les autres applications d'envoyer des messages à la file d'attente. Ceci entraîne un blocage qui verrouille l'interface utilisateur. |
Reçu par | Tout serveur DDE. |
Description | Contient des données inattendues (données qui ne sont pas envoyées en réponse à un conseil ou à un message de demande). |
Paramètres d'événement | Il existe plusieurs paramètres d'événement :
|
Réponse | L'application destinataire doit envoyer un accusé de réception ($DDEAck) si les données sont utilisées ou traitées. |
Reçu par | Tout serveur DDE. |
Description | Demande de données d'une rubrique. |
Paramètres d'événement | Il existe deux paramètres d'événement :
|
Réponse | Appelle DDEData. Transmet les informations demandées. |
Valeur de sortie | Sort avec $DDEAck si les données sont renvoyées. |
Reçu par | Un des partenaires DDE (client ou serveur). |
Description | Termine la conversation. N'importe quel partenaire peut envoyer $MsgDDETerminate à tout moment. |
Paramètres d'événement | Pour obtenir une liste des indicateurs de statut valides, reportez-vous à la rubrique "Synonymes DDE". |
Réponse | Si vous avez appelé DDETerminate, vous ne devez pas envoyer de réponse. Si vous n'avez pas appelé DDETerminate, il doit être appelé. |
Reçu par | Tout serveur DDE. |
Description | Annule une demande de conseil pour un client donné ou une paire de rubriques. Il s'agit d'un message textuel uniquement. |
Paramètres d'événement (Windows) | Les paramètres d'événement suivants sont
utilisés dans Windows :
|
Paramètres d'événement (OS/2) | Les paramètres d'événement suivants sont
utilisés avec OS/2 :
|
Remarques | Si la chaîne de la rubrique est vide, tous les conseils pour le client doivent être annulés. |
La présente section traite des sujets suivants :
Les programmes TSD Script peuvent transmettre des messages à d'autres parties de l'application ou à la fenêtre système. Toute fenêtre ou boîte de dialogue peut envoyer ou poster, selon les besoins, un des messages pouvant être transmis.
Le tableau des messages pouvant être transmis répertorie les messages d'événement pouvant être envoyés ou postés aux descripteurs de fenêtre.
Les éléments répertoriés dans la colonne $Event représentent les constantes de message.
Les éléments répertoriés dans la colonne Receiver représentent le type de composant d'application (boîte de dialogue ou fenêtre) qui reçoit le message.
Certains éléments répertoriés dans la colonne Receiver sont abrégés. Par exemple :
La colonne Poster/Envoyer indique si le message est envoyé avec l'instruction PostMessage ou avec l'instruction SendMessage ou avec les deux. Si un élément est envoyé, il est décrit de manière plus complète à la rubrique "Messages envoyés". Si le message est posté, il est décrit de manière plus complète à la rubrique "Message envoyé".
La colonne Paramètres contient les paramètres des messages.
Conseil : L'ordre des paramètres est important
car les paramètres doivent être utilisés dans l'ordre dans lequel ils sont répertoriés.
Le tableau suivant répertorie les messages d'événement pouvant être envoyés (avec une instruction SendMessage) ou postés (avec une instruction PostMessage) aux descripteurs de fenêtre.
Tableau des messages pouvant être transmis
$Event | Destinataire | Poster/Envoyer | Paramètres |
$MsgActivate | Toute fenêtre dans un cadre | S, P | aucun |
$MsgChar | Toute boîte de dialogue | S, P | 1=ID de champ, 2=nom de champ, 3=code touche |
$MsgClockSet | Fenêtre Horloge | S | Heure |
$MsgClose | Quelconque | S | Aucun |
$MsgDisplayImage | Fenêtre d'afficheur hypertexte | S, P | 1=nom de fichier, 2=titre, 3=style |
$MsgEnable | Quelconque | S, P | enableState |
$MsgMaximize | Toute boîte de dialogue ou fenêtre contenant un cadre | S | aucun |
$MsgMenu | Toute fenêtre ou boîte de dialogue comportant une barre de menus | S, P | sélection de menu, 2=chaîne |
$MsgMinimize | Toute fenêtre ou boîte de dialogue contenant un cadre | S | aucun |
$MsgMove | Toute fenêtre ou boîte de dialogue contenant un cadre | S | 1=x, 2=y |
$MsgOpenFile | Fenêtre d'afficheur hypertexte | S, P | 1=nom de fichier, 2=titre, 3=style |
$MsgPaint | Quelconque | S, P | aucun |
$MsgPaintStatus | Toute fenêtre ou boîte de dialogue contenant une barre d'état | P | aucun |
$MsgPlaySound | Fenêtre d'afficheur hypertexte | S, P | 1=nom de fichier, 2=titre, 3=style |
$MsgReadOnly | Boîte de dialogue | S | writeState |
$MsgRestore | Toute fenêtre ou boîte de dialogue contenant un cadre | S | aucun |
$MsgSearch | Fenêtre d'afficheur hypertexte | S, P | searchText |
$MsgSetIcon | Fenêtre | S | iconFile |
$MsgSetImage | Fenêtre image Boîte de dialogue, fenêtre dotée d'une barre de défilement |
S S |
Fichier image ID de fenêtre |
$MsgSetSize | Toute fenêtre ou boîte de dialogue contenant un cadre | S | 1=largeur, 2=hauteur |
$MsgSetTitle | Toute fenêtre ou boîte de dialogue contenant un cadre | S | titre |
$MsgShow | Quelconque | S | visibilityState |
$MsgSize | Générique, fenêtre dotée d'une barre de défilement | S | 1=largeur, 2=hauteur |
$MsgStartTimer | Toute fenêtre ou boîte de dialogue comportant un gestionnaire d'événements | S | 1=ID horloge, 2=intervalle Important : l'intervalle ne peut pas dépasser 65535. |
$MsgStopTimer | Toute fenêtre ou boîte de dialogue comportant un gestionnaire d'événements | S | ID horloge |
$MsgTimer | Toute boîte de dialogue | S, P | ID horloge |
$MsgUpdate | Fenêtre d'afficheur hypertexte | S, P | aucun |
$MsgUser+n | Quelconque | S, P | Les détails appartiennent à l'expéditeur et au destinataire |
Le tableau suivant répertorie les mêmes messages d'événement pouvant être transmis et décrit l'incidence de chaque message.
Définitions des messages pouvant être transmis
Evénement | Description |
$MsgActivate | Active la fenêtre qui reçoit les messages |
$MsgClockSet | Attribue une nouvelle heure à l'horloge |
$MsgClose | Supprime la fenêtre |
$MsgDisplayImage | Crée un afficheur d'image dans un fenêtre d'afficheur hypertexte |
$MsgEnable | Définit l'état activé de la fenêtre |
$MsgMaximize | Agrandit la fenêtre cible |
$MsgMenu | Simule une sélection utilisateur d'un élément de menu |
$MsgMinimize | Réduit la fenêtre cible en une icône sur le bureau |
$MsgMove | Déplace le coin supérieur gauche de la fenêtre cible |
$MsgOpenFile | Crée une fenêtre d'afficheur hypertexte afin d'afficher un fichier |
$MsgPaint | Fait en sorte que la fenêtre cible se retrace elle-même |
$MsgPaintStatus | Fait en sorte que la fenêtre cible retrace sa barre d'état |
$MsgPlaySound | Crée une fenêtre d'afficheur hypertexte pour exécuter un fichier son |
$MsgReadOnly | Indique à une boîte de dialogue d'attribuer le paramètre lecture-seule à certains contrôles |
$MsgRestore | Fait en sorte qu'une fenêtre cible soit restauré à sa taille. |
$MsgSearch | Indique à la fenêtre d'afficheur hypertexte pour rechercher une ligne et la placer au haut d'une fenêtre d'afficheur hypertexte |
$MsgSetIcon | Définit l'icône de la fenêtre lorsqu'elle est réduite |
$MsgSetImage | Définit l'image à afficher dans les fenêtres image |
$MsgSetSize | Définit la taille générale de la fenêtre |
$MsgSetTitle | Définit le contenu de la barre d'état pour une fenêtre |
$MsgShow | Définit l'attribut de visibilité pour la fenêtre |
$MsgSize | Définit la taille de la zone de travail de la fenêtre |
$MsgStartTimer | Lance l'horloge pour la fenêtre |
$MsgStopTimer | Arrête l'horloge |
$MsgTimer | Simule un envoi de message d'horloge à la fenêtre |
$MsgUpdate | Indique à la boîte de dialogue de mettre à
jour les valeurs affichées dans les contrôles à partir des
données de l'enregistrement d'instance. Ce message ne peut être envoyé ou posté qu'à une boîte de dialogue. Ce message fait en sorte que la boîte de dialogue mette à jour les valeurs affichées dans les contrôles à partir des données des enregistrements d'instance. Ce message est un mécanisme utile permettant de changer les zones d'une boîte de dialogue via une seule commande (opposé aux appels de fonction DlgSetFieldValue multiples). Vous mettez à jour la valeur dans l'enregistrement et envoyez ce message à la boîte de dialogue. |
$MsgUser+n | Communique un message défini par l'utilisateur à une fenêtre |
TSD Script propose deux routines intégrées afin de transmettre les messages et les données : SendMessage et PostMessage. La différence principale entre envoyer et poster un message est que SendMessage attend que le gestionnaire des événements appelés finisse le traitement du message. PostMessage place les informations dans une file d'attente d'événements, qui permet à la routine de se poursuivre sans attendre l'aboutissement du messages.
Certains types de messages ne peuvent pas être postés à certains types de fenêtre.
Lorsque vous transmettez un message, vous utilisez soit l'instruction SendMessage soit l'instruction PostMessage. La syntaxe de ces instructions est à peu près la même :
SendMessage (VAL whdl: WINDOW,
VAL message: INTEGER,
[VAL or REF messageParm: ANY...]):
INTEGER;
Pour plus d'informations, reportez-vous aux rubriques SendMessage ou PostMessage.
Les rubriques qui suivent dans le tableau des messages pouvant être transmis sont classées en fonction des messages pouvant être envoyés (transmis via SendMessage) et ceux pouvant être postés (transmis via PostMessage).
Les messages suivants peuvent être envoyés aux descripteurs de fenêtres via l'instruction SendMessage.
Envoyé à | Peut être envoyé à toute fenêtre comportant un cadre |
Description | Fait en sorte que la fenêtre recevant les messages devienne la fenêtre active |
Envoyé à | Peut être envoyé à toute fenêtre comportant une horloge |
Description | Attribue une nouvelle heure à l'horloge |
Paramètres d'événement | Le paramètre d'événement (heure) contient la nouvelle heure de l'horloge |
Remarques | Reportez-vous à la rubrique WinCreateClock |
Envoyé à | Peut être envoyé à toute fenêtre |
Description | Supprime la fenêtre |
Envoyé à | Peut être envoyé à une fenêtre d'afficheur hypertexte |
Description | Crée un afficheur d'image et affiche le fichier indiqué |
Paramètres d'événement | Il existe trois paramètres d'événement : Le premier paramètre d'événement contient le nom du fichier (chaîne) qui apparaît dans la fenêtre d'afficheur hypertexte Le deuxième paramètre d'événement contient le titre (chaîne) qui apparaît dans la barre de titre Le troisième paramètre d'événement contient le style constitué d'une combinaison des styles suivant et de l'instruction BitOr :
|
Envoyé à | Peut être envoyé à toute fenêtre. |
Description | Définit l'état activé de la fenêtre. |
Paramètres d'événement | Le paramètre d'événement contient TRUE ou FALSE, représentant l'état activé de la fenêtre.
|
Envoyé à | Peut être envoyé à toute fenêtre comportant un cadre |
Description | Agrandit la taille de la fenêtre qui reçoit les messages afin qu'elle remplisse complètement l'écran |
Envoyé à | Peut être envoyé à toute fenêtre comportant une barre de menus |
Description | Simulate la sélection par l'utilisateur d'une option de menu indiquée |
Paramètres d'événement | Le paramètre d'événement contient la valeur de
l'élément de menu sélectionné (entier). La valeur est calculée en
utilisant la formule n x 100 + m où n correspond à l'emplacement de la sélection active dans la barre de menus principale et m correspond à l'emplacement de la sélection dans le sous-menu. |
Remarques | Pour plus d'informations, reportez-vous à la rubrique WinSetMenuBar. |
Envoyé à | Peut être envoyé à toute fenêtre comportant un cadre |
Description | Réduit en icône la fenêtre recevant les messages |
Envoyé à | Peut être envoyé à toute fenêtre |
Description | Déplace le coin supérieur gauche du cadre de la fenêtre en fonction de l'emplacement indiqué |
Paramètres d'événement | Il existe deux paramètres d'événement :
|
Envoyé à | Peut être envoyé à une fenêtre d'afficheur hypertexte |
Description | Crée un afficheur de fichier et affiche le fichier indiqué |
Paramètres d'événement | Il existe trois paramètres d'événement :
|
Envoyé à | Peut être envoyé à une fenêtre d'afficheur hypertexte. |
Description | Crée un lecteur audio et exécute le fichier indiqué. |
Paramètres d'événement | Il existe trois paramètres d'événement :
|
Envoyé à | Peut être envoyé à une boîte de dialogue TSD Script |
Description | Définit ou annule l'indicateur de lecture seule d'une boîte de dialogue |
Paramètres d'événement | Le paramètre d'événement contient TRUE ou FALSE.
|
Remarques | Pour plus d'informations, reportez-vous à la rubrique DlgBox. |
Envoyé à | Peut être envoyé à toute fenêtre comportant un cadre |
Description | Restaure la fenêtre qui reçoit les messages à sa taille initiale (réduite ou agrandie) |
Envoyé à | Peut être envoyé à une fenêtre d'afficheur hypertexte. |
Description | Recherche la sous-fenêtre d'afficheur hypertexte pour le texte indiqué. Si une occurrence est trouvée, la ligne contenant la concordance est placée au début de l'afficheur. |
Paramètres d'événement | Le paramètre d'événement contient la chaîne à rechercher dans la fenêtre d'afficheur hypertexte. |
Remarques | La sous-fenêtre d'afficheur hypertexte est
censée être un afficheur de texte.
C'est toujours le cas lorsque le message de recherche est envoyé
en réponse à un message bouton.
Les messages définis par l'utilisateur peuvent être
envoyés à une fenêtre comportant une fonction d'événement. Tous les messages définis par l'utilisateur doivent comporter une valeur $MsgUser ou une valeur supérieure. Tous les messages supplémentaires peuvent être transmis avec un message défini par l'utilisateur. Il en va de la responsabilité de la fenêtre recevant les messages de savoir quels sont les paramètres valides pour le message. Si des messages supplémentaires peuvent être attribués dans l'instruction SendMessage, ils peuvent être attribués dans la fonction d'événement. |
Envoyé à | Peut être envoyé à une fenêtre générique, une fenêtre de défilement, une fenêtre d'afficheur hypertexte ou une boîte de dialogue |
Description | Définit l'icône qui s'affiche lors de la réduction de la fenêtre |
Paramètres d'événement | Le paramètre d'événement contient le nom du fichier icône à afficher (chaîne) |
Envoyé à | Peut être envoyé à une fenêtre image. |
Description | Définit l'image. |
Paramètres d'événement | Le paramètre d'événement contient le nom du fichier image à afficher (chaîne). Il peut s'agir d'un fichier bitmap OS/2 ou Windows, ou d'un fichier d'image .PCX. |
Remarques | Pour plus d'informations, reportez-vous à la rubrique WinCreateImage. |
Envoyé à | Peut être envoyé à toute fenêtre |
Description | Définit la taille de la fenêtre (comprenant le cadre, la barre de titre et d'autres éléments) |
Paramètres d'événement | Il existe deux paramètres d'événement :
|
Envoyé à | Peut être envoyé à toute fenêtre comportant une barre de titre |
Description | Définit le texte de la barre de titre en fonction du texte indiqué |
Paramètres d'événement | Le paramètre d'événement contient le texte (chaîne) à afficher dans la barre de titre |
Envoyé à | Peut être envoyé à toute fenêtre |
Description | Définit la visibilité de la fenêtre |
Paramètres d'événement | Le paramètre d'événement contient TRUE ou FALSE, indiquant si la fenêtre est visible (TRUE) ou invisible (FALSE) |
Envoyé à | Peut être envoyé à une fenêtre générique ou à une fenêtre de défilement |
Description | Définit la taille de la zone utilisateur de la fenêtre en fonction de la hauteur et de la largeur indiquées. Adapte la taille du cadre de la fenêtre en fonction. |
Paramètres d'événement | Il existe deux paramètres d'événement :
|
Envoyé à | Peut être envoyé à une fenêtre générique ou à une fenêtre de défilement |
Description | Lance une horloge système pour la fenêtre. L'horloge envoie un message $MsgTimer à la fenêtre à des intervalles définis. |
Paramètres d'événement | Il existe deux paramètres d'événement :
|
Remarques | Le système d'exploitation ne garantit pas
l'exactitude de l'intervalle auquel le message $MsgTimer
est envoyé à la fenêtre. Il existe un nombre limité d'horloges disponibles. Arrêtez toujours une horloge quand vous n'en avez plus besoin. |
Envoyé à | Peut être envoyé à une fenêtre générique ou à une fenêtre de défilement |
Description | Arrête l'horloge lancée avec $timerId |
Paramètres d'événement | Le paramètre d'événement contient l'ID de l'horloge (entier) |
Envoyé à | Peut être envoyé à une fenêtre générique ou à une fenêtre de défilement |
Description | Simule un message d'horloge envoyé à une fenêtre |
Paramètres d'événement | Le paramètre d'événement contient l'ID de l'horloge (entier) |
Envoyé à | Toute fenêtre ou boîte de dialogue (définition de l'utilisateur) |
Description | Constante de message définie par l'utilisateur. |
Paramètres d'événement | Tous les paramètres pouvant être transmis à un message défini par l'utilisateur
Si des paramètres supplémentaires peuvent être attribués dans
l'instruction SendMessage, ils peuvent également être
attribués dans la fonction d'événement. La fenêtre recevant les informations doit savoir quels sont les paramètres valides pour le message. |
Remarques | Tous les message définis par l'utilisateur doivent comporter une valeur de $MsgUser+n où n est un nombre que vous choisissez afin de l'attribuer à la nouvelle constante de message. |
Les messages suivants peuvent être envoyés à des descripteurs de fenêtre avec l'instruction PostMessage.
Posté à | Peut être posté à toute fenêtre comportant une barre de menus |
Description | Simule une sélection utilisateur d'un élément de menu comportant l'ID indiqué dans l'argument menuSelection. |
Paramètres d'événement | menuSelection (entier) |
Remarques | Pour plus d'informations, reportez-vous à la rubrique WinSetMenuBar |
Posté à | Peut être posté à toute fenêtre |
Description | Déplace le coin supérieur gauche du cadre de la fenêtre en fonction de l'emplacement indiqué |
Paramètres d'événement | Il existe deux paramètres d'événement :
|
Posté à | Peut être posté à toute fenêtre |
Description | Demande à la fenêtre de se redessiner |
Posté à | Peut être posté à toute fenêtre comportant une barre d'état |
Description | Demande à la fenêtre de retracer sa barre d'état |
Posté à | Les messages définis par l'utilisateur peuvent être postés à toute fenêtre comportant une fonction d'événement. |
Description | Tous les messages définis par l'utilisateur doivent comporter une valeur $MsgUser ou une valeur supérieure. |
Paramètres d'événement | Tous les paramètres d'événement peuvent être transmis à un message défini par l'utilisateur. Il en va de la responsabilité de la fenêtre recevant les messages de savoir quels sont les paramètres valides pour le message. Les paramètres sont toujours transmis par valeur. |
Toutes les communications sortantes de l'application DDE doivent être gérées via les instructions TSD Script. Reportez-vous aux instructions ci-après.
Conseil : Chaque fois qu'un message DDE est reçu, un message $MsgDDEAcknowledge doit être renvoyé. S'il n'est pas possible de renvoyer un message $MsgDDEAcknowledge, une perte de mémoire se produit.
Conseil : Si vous voulez envoyer un accusé de réception positif lors de la réception d'un message $MsgDDExxx, il vous suffit de taper EXIT ($DDEAck). Si vous voulez envoyer un accusé de réception négatif, tapez EXIT(0).
Tivoli Service Desk 6.0 Developer's Toolkit - Manuel de référence du langage TSD Script