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

Messages TSD Script

Retour à la page principale


Présentation des événements et des messages

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.

Messages envoyés et reçus

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.

Messages reçus à partir d'instructions TSD

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.

Instruction TSD Script Messages reçus
DlgSelectField $MsgExitField, $MsgEnterField, $MsgSelect
DlgSetFieldValue $MsgSelect ou $MsgInitialize
DlgListBoxClear, DlgListBoxDelete $MsgSelect
DlgListBoxInsert, DlgListBoxUpdate $MsgSelect
DlgSQLSelect, DlgSetListBoxIndex $MsgSelect
DlgBox, DlgCreate $MsgCreate, $MsgInitialize
WinCreate $MsgSize, $MsgCreate
WinCreateHyperViewer $MsgCreate
WinCreateScrollWindow $MsgCreate
WinSetIconBar, WinSetMenuBar $MsgSize

Messages définis par l'utilisateur

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.


Messages recevables

La présente section traite des sujets suivants :

Récapitulatif des messages recevables

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 :

  1. Les éléments répertoriés dans la colonne $Event représentent les constantes de message.
  2. 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.
  3. Certains éléments répertoriés dans la colonne Source sont abrégés de la manière suivante :
  4. Les sections "Messages recevables des boîtes de dialogue," "Messages recevables des fenêtres," et "Messages recevables des serveurs DDE" incluent des descriptions complète des messages et de leurs paramètres.
  5. La colonne Paramètres répertorie les paramètres des événements définis pour la constante de message dans la colonne $Event. Les valeurs synonymes commencent par le caractère $.

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,
$MenuId, 2=chaîne

$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.

Paramètres et synonymes de message

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.

Messages recevables des boîtes de dialogue

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


Autres

$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


Barre d'outils

$MenuSelection (n*100 + m)


$MenuSelection (1-99)

$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

Synonymes des boîtes de dialogue

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.

Descriptions des messages recevables des boîtes de dialogue

Les messages recevables des boîtes de dialogue répertoriés dans le tableau des messages recevables sont décrits ici.

$MsgAccept

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 :
  • $FieldId contient l'ID de contrôle (entier)
  • $FieldName contient le nom du contrôle (chaîne)
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 :
  • lorsque l'utilisateur clique sur le bouton associé à l'action d'acceptation (il s'agit généralement du bouton OK) ;
  • si l'utilisateur travaille dans un éditeur multi-ligne, $MsgAccept est généré lorsque l'utilisateur insère une nouvelle ligne ;
  • si l'utilisateur travaille dans une boîte à liste, un événement d'acceptation peut se produire si l'utilisateur clique deux fois sur un élément ou sélectionne un élément et appuie sur la touche Entrée ;
  • un message peut également être généré lorsqu'un utilisateur appuie sur la touche Entrée dans une boîte de dialogue pour laquelle un bouton par défaut est défini.

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.
Sous Windows, si l'utilisateur appuie sur la touche Entrée, l'action associée au bouton par défaut est effectuée ou un message $MsgAccept est généré. Si l'action n'est pas annulée, la boîte de dialogue se ferme.

$MsgButton

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 :
  • Le premier paramètre d'événement (chaîne) contient le texte du bouton.
  • Le deuxième paramètre d'événement (entier) contient l'ID du bouton.

$MsgCancel

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 :
  • $FieldId contient l'ID de contrôle (entier).
  • $FieldName contient le nom du contrôle (chaîne).
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.

$MsgChar

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 :
  • $FieldId contient l'ID de contrôle (entier)
  • $FieldName contient le nom du contrôle (chaîne)
  • Le troisième paramètre d'événement (entier) transmet les caractères transmis au gestionnaire d'événements
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.

$MsgCreate

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 :
  • Le premier paramètre d'événement est inconnu dans le message $MsgCreate. Dans la plupart des autres messages de boîte de dialogue, il contient l'ID de contrôle ($FieldId).
  • Le deuxième paramètre d'événement, $FieldName, contient le nom (chaîne) du contrôle sélectionné, qui est généralement $Unknown car aucun contrôle n'a été sélectionné jusque là.
  • Le troisième paramètre d'événement ($FormFile) contient le nom (chaîne) du fichier de formulaire, comprenant le nom du formulaire entre crochets.
  • Le quatrième paramètre d'événement ($FormName) contient le nom (chaîne) du formulaire indiqué dans le fichier de la boîte de dialogue.
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 :
  • Le curseur est placé.
  • L'application a reçu une zone $MsgEnter pour le premier contrôle de la boîte de dialogue.
  • Tous les contrôles ont été créés et initialisés à la valeur par défaut indiquée dans le fichier de la boîte de dialogue et aux valeurs initiales transmises en tant que données d'initialisation.
  • Les données d'instance ont été créées et mises à jour afin de correspondre aux valeurs de contrôle par défaut.

Pour plus d'informations, reportez-vous au message $MsgInitialize.

$MsgDestroy

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.

$MsgEnterField

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 :
  • $FieldId contient l'ID de contrôle (entier)
  • $FieldName contient le nom du contrôle (chaîne)
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.

$MsgExitField

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 :
  • $FieldId contient l'ID de contrôle (entier)
  • $FieldName contient le nom du contrôle (chaîne)
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.

$MsgFocus

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.

$MsgHelp

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 :
  • $FieldId contient l'ID de contrôle (entier)
  • $FieldName contient le nom du contrôle (chaîne)

$MsgInitialize

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 :
  • $FieldId contient l'ID (entier) du contrôle dont la valeur a été modifiée
  • $FieldName contient le nom (chaîne) du contrôle dont la valeur a été modifiée
  • Le troisième paramètre d'événement (chaîne) contient l'ancienne valeur des données d'instance
  • Le quatrième paramètre d'événement (chaîne) contient la nouvelle valeur du contrôle

$MsgLabel

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 :
  • Le premier paramètre d'événement (chaîne) contient le texte du bouton
  • Le deuxième paramètre d'événement (chaîne) contient le libellé du bouton

$MsgListboxAccept

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 :
  • $FieldId contient l'ID (entier) du contrôle de la boîte à liste
  • $FieldName contient le nom (chaîne) du contrôle de la boîte à liste
  • Le troisième paramètre d'événement (chaîne) contient la boîte à liste et un entier pour la table
Réponse Lorsque vous quittez ce message, le message $MsgAccept n'apparaît pas.

$MsgMandField

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 :
  • $FieldId contient l'ID (entier) du contrôle sur lequel le curseur était sur le point de se placer
  • $FieldName contient le nom (chaîne) du contrôle sélectionné dont la valeur a été modifiée.
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.

$MsgMenu

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

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.

$MsgPaintStatus

La position du texte actif pour la barre d'état est redéfinie à 1,1 à chaque génération d'un message $MsgPaintStatus.

$MsgPageChange

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 :
  • Le premier paramètre d'événement indique le nom de la page active avant le changement de page
  • Le deuxième paramètre d'événement indique le nom de la page qui est maintenant active (la nouvelle page)
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.

$MsgPageChangeRequest

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 :
  • Le premier paramètre d'événement indique le nom de la page active avant le changement de page
  • Le deuxième paramètre d'événement indique le nom de la page actuellement active (la nouvelle page)

$MsgSelect

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 :
  • $FieldId contient l'ID (entier) du contrôle dont la valeur a été modifiée.
  • $FieldName contient le nom (chaîne) du contrôle dont la valeur a été modifiée.
  • Le troisième paramètre d'événement (OldValue) contient l'ancienne valeur (chaîne) des données d'instance. Cette règle ne s'applique pas aux boutons. Pour plus d'informations, reportez-vous à la section Remarques relative à ce message.
  • Le quatrième paramètre d'événement (NewValue) contient la nouvelle valeur du contrôle. Cette règle ne s'applique pas aux boutons. Pour plus d'informations, reportez-vous à la section Remarques relative à ce message.
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 :
  • Les boutons d'option, cases à cocher, boutons, boîtes à liste, contrôles de table et les curseurs génèrent $MsgSelect à chaque modification de leur valeur par l'utilisateur ou par une opération de définition.
  • Les zones de texte génèrent l'instruction $MsgSelect lorsque l'utilisateur quitte le contrôle, sous réserve que la valeur de ce contrôle ait été modifiée.
  • Les boîtes de dialogue mixtes génèrent l'instruction $MsgSelect de la même manière qu'une boîte à liste ou une zone de texte, suivant la partie du contrôle sur laquelle l'utilisateur interagit. La génération de $MsgSelect par les boîtes de dialogue mixtes a lieu lors de la première modification de la valeur, puis de nouveau lorsque le curseur disparaît du contrôle, et à condition que la portion éditée du contrôle ait subi des modifications.
  • Les boutons génèrent $MsgSelect chaque fois que l'utilisateur les sélectionne. Il n'existe toutefois aucune valeur caractérisant les paramètres d'événement trois et quatre.

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.
Le type de données relatif à la valeur contenue dans le paramètre d'événement 4 dépend du type de contrôle. S'il s'agit par exemple d'un bouton d'option, la valeur est un nombre entier. Si c'est une zone de texte, la valeur est une chaîne.


$MsgTimer

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.

MsgUser+n

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+nn est un nombre que vous choisissez afin de l'attribuer à la nouvelle constante de message.

Messages recevables des fenêtres

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

Synonymes de fenêtre

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".

Descriptions des messages recevables de fenêtre

$MsgActivate

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 :
  • Si la fenêtre est activée, ce paramètre prend la valeur 1
  • Si la fenêtre est désactivée, ce paramètre prend la valeur 0
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.

$MsgButton

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 :
  • Le premier paramètre d'événement (chaîne) contient le texte du bouton.
  • Le deuxième paramètre d'événement (entier) contient l'ID du bouton. Si aucun ID n'est attribué, par défaut la valeur O lui est attribuée.
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.

$MsgChar

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.)

$MsgCreate

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.

$MsgDestroy

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.

$MsgImage

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.

$MsgLabel

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 :
  • Le premier paramètre d'événement (chaîne) contient le texte du bouton
  • Le deuxième paramètre d'événement (chaîne) contient le libellé du bouton

$MsgMenu

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

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.
Pour plus d'informations, reportez-vous aux rubriques WinSetMenuBar.

$MsgMouse

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 :
  • Le premier paramètre d'événement (entier) contient l'ID transmis à WinCreateMouseRect
  • Le deuxième paramètre d'événement (entier) contient le type d'activité de la souris (reportez-vous aux listes d'activité de la souris ci-dessous).
  • Le troisième paramètre d'événement (entier) contient l'emplacement X de la souris.
  • Le quatrième paramètre d'événement de la souris (entier) contient l'emplacement Y de la souris.
Remarques WinSetMousePointer doit être appelé à chaque traitement de $MsgMouse.

Les activité de la souris définies comprennent :

  • $MouseNone
  • $MouseLeftClick
  • $MouseRightClick
  • $MouseLeftDouble
  • $MouseRightDouble
  • $MouseLeftStartDrag
  • $MouseLeftEndDrag.

Pour plus d'informations, reportez-vous à la rubrique WinCreateMouseRect.

$MsgPaint

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.

$MsgScroll

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 :
  • Le premier paramètre d'événement (entier) contient la barre de défilement qui génère le message. Il s'agit soit de $WinHScroll (horizontal) soit de $WinVScroll (vertical).
  • Le deuxième paramètre d'événement (entier) contient l'emplacement de la barre de défilement. Cette valeur est exprimée en unités indiqués par l'application dans l'instruction WinSetScroll.

$MsgSize

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.

$MsgTimer

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.

$MsgUser+n

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

n correspond à un nombre que vous avez chois pour attribuer à la nouvelle constante de message.

Messages recevables des serveurs DDE

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).

Synonymes DDE

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.

Définitions DDE

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.

Descriptions des messages recevables DDE

$MsgDDEAcknowledge

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 :
  • DDEAdvise
  • DDEData
  • DDEExecute
  • DDEPoke
  • DDERequest
  • DDEUnAdvise
Paramètres d'événement
(Windows)
Les paramètres d'événement sont utilisés avec l'instruction DDEExecute dans Windows.
  • $DDETopic - rubrique traitée dans la conversation DDE en cours ou $Unknown en tant que réponse générique.
  • $DDEData - commande exécutée.
  • $DDEStatus - Pour connaître la liste des codes de statut, reportez-vous à la section "Synonymes DDE".

Les paramètres d'événement suivants sont utilisés avec tous les autres messages DDE dans Windows.

  • $DDETopic - Rubrique ou élément
  • $DDEData - $Unknown
  • $DDEStatus - Pour connaître la liste des codes de statut admis, reportez-vous à la section "Synonymes de DDE".
Paramètres d'événement (OS/2) Les paramètres d'événement sont utilisés avec $DDEExecute dans OS/2.
  • $DDETopic - $Unknown
  • $DDEData - Chaîne de longueur nulle
  • $DDEStatus - Pour connaître la liste des codes de statut admis, reportez-vous à la section "Synonymes de DDE".

Les paramètres d'événement sont utilisés avec tous les autres messages DDE dans OS/2.

  • $DDETopic - Rubrique ou élément
  • $DDEData - Chaîne de longueur nulle
  • $DDEStatus - Pour connaître la liste des codes de statut admis, reportez-vous à la section "Synonymes de DDE".
Remarques Si $DDEData est le message reçu, il peut être envoyé à la place des données du message en cours.

$MsgDDEAdvise

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.
  • $DDETopic - Rubrique ou élément nécessitant des conseils
  • $DDEData - $Unknown
  • $DDEStatus - Pour connaître la liste des codes de statut admis, reportez-vous à la section "Synonymes de DDE".
Paramètres d'événement (OS/2) Les paramètres d'événement suivants sont utilisés avec OS/2.
  • $DDETopic - Rubrique ou élément
  • $DDEData - $Unknown
  • $DDEStatus - Pour connaître la liste des codes de statut admis, reportez-vous à la section "Synonymes de DDE".
Réponse L'application doit exécuter un message DDEData à chaque changement des données.

$MsgDDEData

Reçu par Tout client DDE.
Description Ce message est envoyé dans deux cas :
  • En réponse à un message DDERequest
  • Lorsque les données d'une rubrique ou d'un élément pour laquelle le client a demandé des conseils sont modifiées.
Paramètres d'événement Il existe plusieurs paramètres d'événement possibles :
  • $DDETopic contient la rubrique ou les éléments
  • $DDEData contient la valeur des données
  • OS/2 uniquement : $DDEStatus
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.

$MsgDDEExecute

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.
  • $DDETopic - $Unknown
  • $DDEData - Commande d'exécution
Paramètres d'événement (OS/2) Les paramètres d'événement suivants sont utilisés avec OS/2.
  • $DDETopic - Rubrique ou élément
  • $DDEData - Chaîne de commande d'exécution
  • $DDEStatus - Pour connaître la liste des codes de statut admis, reportez-vous à la section "Synonymes de DDE".
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.

$MsgDDEInitAcknowledge

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 :
  • son descripteur de fenêtre DDE ($DDEWindow),
  • la paire application/rubrique correspondante ($DDEData),
  • la rubrique de la conversation ($DDETopic).
Paramètres d'événement Il existe deux paramètres d'événement :
  • $DDETopic contient la rubrique demandée
  • $DDEData contient l'application répondant à une demande
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.

$MsgDDEInitiate

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 :
  • $DDETopic contient la rubrique. S'il s'agit de $Unknown ou d'une chaîne vide (''), le client demande une réponse si vous pouvez parler de la rubrique.
  • $DDEData contient l'application avec laquelle le client demande une conversation. S'il s'agit de $Unknown ou d'une chaîne vide (''), le client demande une réponse si vous pouvez parler de la rubrique.
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.

$MsgDDEPoke

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 :
  • $DDETopic contient la rubrique ou l'élément inscrit en mémoire vive
  • $DDEData contient la valeur des données
  • OS/2 uniquement : $DDEStatus
Réponse L'application destinataire doit envoyer un accusé de réception ($DDEAck) si les données sont utilisées ou traitées.

$MsgDDERequest

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 :
  • $DDETopic contient la rubrique ou l'élément demandé
  • $DDEData contient $Unknown
Réponse Appelle DDEData. Transmet les informations demandées.
Valeur de sortie Sort avec $DDEAck si les données sont renvoyées.

$MsgDDETerminate

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é.

$MsgDDEUnAdvise

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 :
  • $DDETopic - Rubrique pour laquelle les conseils ne sont plus nécessaires
  • $DDEData - $Unknown
Paramètres d'événement (OS/2) Les paramètres d'événement suivants sont utilisés avec OS/2 :
  • $DDETopic - Rubrique pour laquelle les conseils ne sont plus nécessaires
  • $DDEData - Chaîne de longueur nulle
Remarques Si la chaîne de la rubrique est vide, tous les conseils pour le client doivent être annulés.

Messages transmis

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

Transmission de messages : Poster et envoyer

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).

Messages envoyés

Les messages suivants peuvent être envoyés aux descripteurs de fenêtres via l'instruction SendMessage.

$MsgActivate

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

$MsgClockSet

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

$MsgClose

Envoyé à Peut être envoyé à toute fenêtre
Description Supprime la fenêtre

$MsgDisplayImage

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 :
  • $HyperScrollImage - Fenêtre d'afficheur hypertexte comportant une barre de défilement verticale.
  • $HyperScaleImage - L'échelle de l'image est modifiée pour que cette dernière ait les mêmes dimensions que la fenêtre d'afficheur d'hypertexte.
  • $HyperNoWordWrap - Le texte de la fenêtre d'afficheur hypertexte n'est pas renvoyé à la ligne.

$MsgEnable

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.
  • TRUE indique que la fenêtre est activée
  • FALSE indique que la fenêtre est désactivée

$MsgMaximize

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

$MsgMenu

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

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.

$MsgMinimize

Envoyé à Peut être envoyé à toute fenêtre comportant un cadre
Description Réduit en icône la fenêtre recevant les messages

$MsgMove

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 :
  • Le premier paramètre contient l'emplacement de l'abscisse (entier) de la fenêtre.
  • Le deuxième paramètre d'événement contient l'emplacement de l'ordonnée (entier) de la fenêtre.

$MsgOpenFile

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 :
  • Le premier paramètre d'événement contient le nom de fichier (entier) du fichier à ouvrir.
  • Le troisième paramètre d'événement contient le titre (chaîne) qui apparaît dans l'afficheur de fichier.
  • Le troisième paramètre est constitué d'une combinaison des styles suivants et de l'instruction BitOr :
    • $HyperScrollImage - Fenêtre d'afficheur hypertexte comportant une barre de défilement vertical.
    • $HyperScaleImage - L'échelle de l'image est modifiée pour que cette dernière ait les mêmes dimensions que la fenêtre d'afficheur d'hypertexte.
    • $HyperNoWordWrap - Le texte de la fenêtre d'afficheur hypertexte n'est pas renvoyé à la ligne.

$MsgPlaySound

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 :
  • Le premier paramètre contient le nom du fichier (entier) du fichier audio à exécuter.
  • Le deuxième paramètre d'événement contient le titre (chaîne) contient le titre (chaîne) qui apparaît dans la fenêtre de l'afficheur hypertexte.
  • Le troisième paramètre d'événement contient le style de l'afficheur hypertexte (utilisez la valeur 0).

$MsgReadOnly

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.
  • TRUE indique que la boîte de dialogue est en lecture seule.
  • FALSE indique que la boîte de dialogue est en lecture/écriture.
Remarques Pour plus d'informations, reportez-vous à la rubrique DlgBox.

$MsgRestore

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)

$MsgSearch

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.

$MsgSetIcon

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)

$MsgSetImage

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.

$MsgSetSize

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 :
  • Le premier paramètre d'événement contient la largeur (entier) de la fenêtre.
  • Le deuxième paramètre contient la hauteur (entier) de la fenêtre.

$MsgSetTitle

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

$MsgShow

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)

$MsgSize

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 :
  • Le premier paramètre d'événement contient la largeur (entier) de la fenêtre.
  • Le deuxième paramètre contient la hauteur (entier) de la fenêtre.

$MsgStartTimer

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 :
  • Le premier paramètre d'événement contient l'ID (entier) de l'horloge.
  • Le deuxième paramètre d'événement contient l'intervalle (entier) des messages $MsgTimer. L'intervalle est exprimé en millisecondes. Pour Windows et OS/2, cet intervalle ne peut pas dépasser 65535.
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.

$MsgStopTimer

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)

$MsgTimer

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)

$MsgUser + n

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.

Messages postés

Les messages suivants peuvent être envoyés à des descripteurs de fenêtre avec l'instruction PostMessage.

$MsgMenu

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

$MsgMove

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 :
  • Le premier paramètre d'événement contient l'emplacement de l'abscisse (entier) de la fenêtre.
  • Le deuxième paramètre d'événement contient l'emplacement de l'ordonnée (entier) de la fenêtre.

$MsgPaint

Posté à Peut être posté à toute fenêtre
Description Demande à la fenêtre de se redessiner

$MsgPaintStatus

Posté à Peut être posté à toute fenêtre comportant une barre d'état
Description Demande à la fenêtre de retracer sa barre d'état

$MsgUser+n

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.

Messages pouvant être transmis DDE

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

Retour à la page principale

Copyright