Club Amiga de Montreal

home *** CD-ROM | disk | FTP | other *** search

/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 622a.lha / ADoc_v7.04 / Amiga.doc.pp / Amiga.doc

Wrap

Text File | 1992-04-03 | 69.8 KB | 2,376 lines

Fichier de documentation pour ADoc - Créé par Denis GOUNELLE Toute utilisation commerciale ou vente de ce fichier est interdite. Contient : Intuition.library, fonctions et structures principales Exec.library, fonctions et structure principales Dos.library, fonctions et structures principales Graphics.library, quelques fonctions ActivateGadget (fonction Intuition) Synopsis : succès = ActivateGadget( gadget , fenêtre , requête ) Entrées : gadget (a0) pointeur vers une structure Gadget fenêtre (a1) pointeur vers une structure Window requête (a2) pointeur vers une structure Requester. Sorties : succès (d0) booléen. Description : Active le string gadget indiqué par "gadget" (c'est-à-dire que l'utilisateur n'aura pas à le sélectionner pour pouvoir entrer son texte). Le paramêtre "fenêtre" indique la fenêtre où est situé le gadget. Le paramêtre "requête" n'est nécessaire que si le gadget a l'indicateur REQGADGET positionné. Retourne TRUE si l'opération a réussi, FALSE si elle a échoué. Voir aussi : Gadget, StringGadget. ActivateWindow (fonction Intuition) Synopsis : ActivateWindow( fenêtre ) Entrées : fenêtre (a0) pointeur vers une structure Window Description : Active la fenêtre Intuition indiquée. Voir aussi : WindowFlags. AddGadget (fonction Intuition) Synopsis : position = AddGadget( fenêtre , gadget, position ) Entrées : fenêtre (a0) pointeur vers une structure Window gadget (a1) pointeur vers une structure Gadget position (d0) entier Sorties : position (d0) entier Description : Ajoute un gadget dans la liste des gadgets de la fenêtre indiquée à la position demandée, et retourne la position laquelle le gadget a effectivement été inséré. Une position de 0 signifie "en tête de liste", une position de n signifie "après le n-ième gadget". Note : Le gadget n'est pas affiché, il faut pour cela appeler la fonction RefreshGadgets. Voir aussi : AddGList, Gadget, RefreshGadgets, RemoveGadget. AddGList (fonction Intuition) Synopsis : position = AddGList( fenêtre , gadget , position , nombre , requête ) Entrées : fenêtre (a0) pointeur vers une structure Window gadget (a1) pointeur vers une structure Gadget position (d0) entier nombre (d1) entier requête (a2) Sorties : position (d0) entier Description : Ajoute une liste de "nombre" gadgets, commençant par le gadget "gadget" dans la liste des gadgets de la fenêtre. L'insertion commence à la position indiquée. Le paramêtre "requête" n'est nécessaire que si les gadgets à ajouter ont l'indicateur REQGADGET positionné. Si "nombre" vaut -1, ajoute tous les gadgets suivant le gadget de départ, jusqu'à trouver un champ NextGadget à NULL. Retourne la position à laquelle la liste a réellement été insérée. Voir aussi : AddGadget, RemoveGList. AddHead (fonction Exec) Synopsis : AddHead( liste , noeud ) Entrées : liste (a0) pointeur vers une structure List noeud (a1) pointeur vers une structure Node Description : Ajoute le noeud "noeud" en tête de la liste indiquée. Voir aussi : Insert, List, Node, RemHead. AddPort (fonction Exec) Synopsis : AddPort( port ) Entrées : port (a1) pointeur vers une structure MsgPort Description : Ajoute un nouveau port message. Voir aussi : MsgPort, RemPort. AddTail (fonction Exec) Synopsis : AddTail( liste , noeud ) Entrées : liste (a0) pointeur vers une structure List noeud (a1) pointeur vers une structure Node Description : Ajoute le noeud "noeud" à la fin de la liste indiquée. Voir aussi : Insert, List, Node, RemTail. AddTask (fonction Exec) Synopsis : AddTask( tâche , départ , fin ) Entrées : tâche (a0) pointeur vers une structure Task départ (a1) adresse d'une fonction fin (a2) adresse d'une fonction Description : Ajoute une nouvelle tâche, à partir des informations de la structure Task indiquée. L'exécution de la tâche commence à l'adresse indiquée par "départ". Quand la tâche se termine, la fonction indiquée par "fin" est exécutée. Si "fin" vaut NULL, c'est la fonction standard de terminaison qui sera appelée. Voir aussi : Task, RemTask. AllocAbs (fonction Exec) Synopsis : zone = AllocAbs( taille , adr ) Entrées : taille (d0) entier adr (a1) pointeur vers un long mot Sorties : zone (d0) pointeur vers un long mot Description : Essaye d'allouer une zone mémoire de "taille" octets à partir de l'adresse "adr". Retourne NULL en cas d'échec. Voir aussi : AllocMem, FreeMem. AllocMem (fonction Exec) Synopsis : zone = AllocMem( taille , type ) Entrées : taille (d0) entier type (d1) entier Sorties : zone (d0) pointeur vers un long mot Description : Alloue une zone de mémoire de "taille" octets, et de type indiqué. Retourne un pointeur vers cette zone, ou NULL en cas d'échec. Voir aussi : FreeMem, TypesDeMemoire. AllocRemember (fonction Intuition) Synopsis : pointeur = AllocRemember( clé , taille , type ) Entrées : clé (a0) adresse d'un pointeur vers une structure Remember taille (d0) entier type (d1) entier Sorties : pointeur (d0) pointeur vers un long mot Description : Alloue une zone mémoire de "taille" octets de type "type", et retourne un pointeur sur cette zone, ou NULL si l'allocation est impossible. De plus, grâce à "clé", les zones allouées sont chainées entre elles et peuvent ainsi être désallouées en une seule fois par la fonction FreeRemember. Note : Avant le premier appel, la zone pointée par "clé" doit être mise à NULL. Voir aussi : FreeRemember. AllocSignal (fonction Exec) Synopsis : signal = AllocSignal( nsig ) Entrées : nsig (d0) entier Sorties : signal (d0) entier Description : Alloue le signal "nsig" de la tâche courante. Si "nsig" vaut -1, le premier signal libre est alloué. Retourne le numéro du signal alloué (0 à 31), ou -1 en cas de problème. Voir aussi : FreeSignal, SetSignal, Wait. AllocTrap (fonction Exec) Synopsis : trappe = AllocTrap( ntrap ) Entrées : ntrap (d0) entier Sorties : trappe (d0) entier Description : Indique au système que la trappe "ntrap" sera reconnue par la tâche courante. Si "nsig" vaut -1, la première trappe libre sera allouée. Retourne le numéro de trappe allouée (0 à 15), ou -1 en cas d'erreur. Note : L'adresse de la fonction à exécuter doit être placée dans le champ "tc_TrapCode" de la tâche. Voir aussi : FreeTrap. AutoRequest (fonction Intuition) Synopsis : réponse = AutoRequest( fenêtre, message, txt_pos, txt_neg, IDCMP_pos, IDCMP_neg, largeur, hauteur ) Entrées : fenêtre (a0) pointeur vers une structure Window message (a1) pointeur vers une structure IntuiText txt_pos (a2) pointeur vers une structure IntuiText txt_neg (a3) pointeur vers une structure IntuiText IDCMP_pos (d0) indicateurs IDCMP IDCMP_neg (d1) indicateurs IDCMP largeur (d2) entier hauteur (d3) entier Sorties : réponse (d0) booléen Description : Affiche une boite de requête avec le message indiqué et deux gadgets contenant les messages "txt_pos" et "txt_neg". La taille de la boite est fixée par "largeur" et "hauteur". Si "fenêtre" vaut NULL, la boite est affichée sur l'écran WorkBench, sinon sur le même écran que la fenêtre indiquée. La réponse est TRUE si on clique sur le gadget contenant "txt_pos" ou si arrive un message correspondant à "IDCMP_pos". La réponse est FALSE si on clique sur le gadget contenant "txt_neg" ou si arrive un message correspondant à "IDCMP_neg". Voir aussi : BuildSysRequest, IDCMP, IntuiText. AvailMem (fonction Exec) Synopsis : taille = AvailMem( type ) Entrées : type (d1) entier Sorties : taille (d0) entier Description : Retourne la quantité de mémoire libre du type indiqué. Voir aussi : AllocMem, TypesDeMemoire. BeginRefresh (fonction Intuition) Synopsis : BeginRefresh( fenêtre ) Entrées : fenêtre (a0) pointeur vers une structure Window Description : Prépare la fenêtre indiquée pour que son rafraichissement soit plus rapide. Voir aussi : EndRefresh. BuildSysRequest (fonction Intuition) Synopsis : réponse = BuildSysRequest( fenêtre , message , texte_pos , texte_neg , IDCMP , largeur , hauteur ) Entrées : fenêtre (a0) pointeur vers une structure Window message (a1) pointeur vers une structure IntuiText texte_pos (a2) pointeur vers une structure IntuiText texte_neg (a3) pointeur vers une structure IntuiText IDCMP (d0) indicateurs IDCMP largeur (d1) entier hauteur (d2) entier Sorties : réponse (d0) booléen ou pointeur sur une structure Window Description : Ouvre une fenêtre, y affiche le texte "message" et deux gadgets contenant les messages "texte_pos" et "texte_neg". La taille de la fenêtre est fixée par "largeur" et "hauteur", et son champ IDCMPFlags à la valeur de "IDCMP". Si "fenêtre" vaut NULL, la boite est affichée sur l'écran WorkBench, sinon sur le même écran que fenêtre indiquée. Si tout se passe bien, la valeur retournée est un pointeur sur une structure Window, sinon la fonction DisplayAlert est appelée, et la valeur de retour est TRUE ou FALSE. Voir aussi : AutoRequest, DisplayAlert, IDCMP, IntuiText. Border (structure Intuition) struct Border { SHORT LeftEdge , TopEdge ; /* x,y du point de départ */ UBYTE FrontPen , BackPen ; /* couleur du tracé, inutilisé */ UBYTE DrawMode ; /* JAM1 ou XOR */ BYTE Count ; /* nombre de coordonnées dans XY */ SHORT *XY ; /* adresse tableau de coordonnées */ struct Border *NextBorder ; /* structure suivante */ } ; Voir aussi : DrawBorder, Gadget. CheckIO (fonction Exec) Synopsis : indic = CheckIO( rbloc ) Entrées : rbloc (a1) pointeur vers une structure IORequest ou IOStdReq Sorties : indic (d0) entier Description : Retourne 0 si l'opération d'E/S indiquée par "rbloc" n'est pas terminée. Voir aussi : IORequest, IOStdReq, SendIO, WaitIO. ClearDMRequest (fonction Intuition) Synopsis : réponse = ClearDMRequest( fenêtre ) Entrées : fenêtre (a0) pointeur vers une structure Window Sorties : réponse (d0) booléen Description : Essaye d'enlever le DMRequester associé à la fenêtre indiquée. Retourne TRUE si tout c'est bien passé, et FALSE sinon. Voir aussi : SetDMRequest. ClearMenuStrip (fonction Intuition) Synopsis : ClearMenuStrip( fenêtre ) Entrées : fenêtre (a0) pointeur vers une structure Window Description : Enlève la barre de menu de la fenêtre indiquée. Voir aussi : SetMenuStrip. ClearPointer (fonction Intuition) Synopsis : ClearPointer( fenêtre ) Entrées : fenêtre (a0) pointeur vers une structure Window Description : Reprend la définition du pointeur souris par défaut pour la fenêtre indiquée. Voir aussi : SetPointer. Close (fonction Dos) Synopsis : Close( fichier ) Entrées : fichier (d1) pointeur sur une structure FileHandle Description : Ferme le fichier indiqué. Voir aussi : Open. CloseLibrary (fonction Exec) Synopsis : CloseLibrary( lib ) Entrées : lib (a1) pointeur vers une structure Library Description : Ferme la librarie indiquée. Voir aussi : OpenLibrary. CloseScreen (fonction Intuition) Synopsis : CloseScreen( écran ) Entrées : écran (a0) pointeur vers une structure Screen Description : Ferme l'écran indiqué. Voir aussi : OpenScreen. CloseWindow (fonction Intuition) Synopsis : CloseWindow( fenêtre ) Entrées : fenêtre (a0) pointeur vers une structure Window Description : Ferme la fenêtre indiquée. Voir aussi : OpenWindow. CloseWorkBench (fonction Intuition) Synopsis : résultat = CloseWorkBench() Sorties : résultat (d0) booléen Description : Essaye de fermer l'écran WorkBench. Retourne TRUE si tout c'est bien passé, FALSE sinon. Voir aussi : OpenWorkBench. CreateDir (fonction Dos) Synopsis : clé = CreateDir( nom ) Entrées : nom (d1) pointeur sur une chaine de caractères Sorties : clé (d0) pointeur sur une structure FileLock Description : Crée un répertoire de nom "nom". Retourne une clé de lecture pour ce répertoire, ou 0 en cas d'erreur. Voir aussi : Lock. CreateProc (fonction Dos) Synopsis : proc = CreateProc( nom , pri , segment , taille ) Entrées : nom (d1) pointeur sur une chaine de caractères pri (d2) entier segment (d3) pointeur sur une liste de segments taille (d4) entier Sorties : proc (d0) identificateur de processus Description : Crée un processus de nom "nom" et de priorité "pri" à partir de la liste de segments indiquée, avec une pile de "taille" octets. Retourne un identificateur de processus, ou 0 en cas d'erreur. Voir aussi : LoadSeg. CurrentDir (fonction Dos) Synopsis : clé1 = CurrentDir( clé2 ) Entrées : clé2 (d1) pointeur sur une structure FileLock Sorties : clé1 (d0) pointeur sur une structure FileLock Description : Le répertoire désigné par "clé2" devient le répertoire courant. Retourne une clé de lecture sur l'ancien répertoire courant (éventuellement nulle, elle désigne alors la racine du volume d'amorçage). Voir aussi : Lock. CurrentTime (fonction Intuition) Synopsis : CurrentTime( secondes, micros ) Entrées : secondes (a0) - pointeur vers un ULONG micros (a1) - pointeur vers un ULONG Description : Copie l'heure courante aux emplacements indiqués. Voir aussi : DateStamp. DateStamp (fonction Dos) Synopsis : DateStamp( date ) Entrées : date (d1) pointeur sur trois mots longs consécutifs Description : Retourne l'heure courante à l'emplacement indiqué, sous forme de trois longs mots. Le premier indique le nombre de jours depuis le 1er Janvier 1978, le second le nombre de minutes depuis 0h, et le troisième le nombre de 50-ièmes de secondes dans la minute présente. Voir aussi : CurrentTime. Delay (fonction Dos) Synopsis : Delay( délai ) Entrées : délai (d1) entier Description : Arrête le processus courant pendant "délai" 50-ièmes de secondes. DeleteFile (fonction Dos) Synopsis : résultat = DeleteFile( nom ) Entrées : nom (d1) pointeur sur une chaine de caractères Sorties : résultat (d0) booléen Description : Efface le fichier ou le répertoire indiqué. Retourne 0 en cas d'échec, -1 en cas de succès. DeviceProc (fonction Dos) Synopsis : proc = DeviceProc( nom ) Entrées : nom (d1) pointeur sur une chaine de caractères Sorties : proc (d0) identificateur de processus Description : Cherche le processus gérant le périphérique indiqué. Retourne un identificateur de processus, ou 0 en cas d'échec. Si "nom" se rapporte à un volume, la fonction IoErr permet d'obtenir une clé de lecture sur la racine de ce volume. Voir aussi : IoErr. Disable (fonction Exec) Synopsis : Disable() Description : Interdit la prise en compte des interruptions. Note : Il est dangereux d'interdire les interruptions pendant plus de 250 micro-secondes. Voir aussi : Enable. DisplayAlert (fonction Intuition) Synopsis : résultat = DisplayAlert( indic , message , hauteur ) Entrées : indic (d0) - entier (RECOVERY_ALERT ou DEADEND_ALERT) message (a0) - pointeur vers le texte de l'alerte hauteur (d1) - entier Sorties : résultat (d0) TRUE ou FALSE Description : Affiche une alerte. La taille du cadre est donnée par "hauteur", et le texte doit être au format suivant : - deux octets pour la coordonnée x - un octet pour la coordonnée y - chaine terminée par un octet nul - un octet de continuation (si différent de zéro, un autre texte suit) Retourne FALSE si "indic" vaut DEADEND_ALERT, sinon retourne TRUE si on a cliqué sur le bouton gauche, et FALSE si on a cliqué sur le bouton droit. DisplayBeep (fonction Intuition) Synopsis : DisplayBeep( écran ) Entrées : écran (a0) pointeur vers une structure Screen Description : Fait "flasher" la couleur de fond de l'écran indiqué. Si écran vaut NULL, fait "flasher" tous les écrans. DoIO (fonction Exec) Synopsis : DoIO( rbloc ) Entrées : rbloc (a1) pointeur vers une structure IORequest ou IOStdReq Description : Lance l'opération d'E/S indiquée par "rbloc". La tâche courante est bloquée jusqu'à ce que l'opération soit terminée. Voir aussi : IORequest, IOStdReq, SendIO. DoubleClick (fonction Intuition) Synopsis : résultat = DoubleClick( sec1, mic1, sec2, mic2 ) Entrées : sec1 (d0) - secondes du premier clic mic1 (d1) - microsecondes du premier clic sec2 (d2) - secondes du second clic mic2 (d3) - microsecondes du second clic Sorties : résultat (d0) - booléen Description : Retourne FALSE si l'intervalle de temps entre les deux clics est supérieur à l'intervalle fixé pour un double-clic, retourne TRUE sinon. Voir aussi : CurrentTime. Draw (fonction Graphics) Synopsis : Draw( rast_port , x , y ) Entrées : rast_port (a1) pointeur vers une structure RasterPort x (d0) entier y (d1) entier Description : Trace une ligne entre la position du curseur graphique et le point en "x","y" sur le port Raster indiqué, en utilisant la couleur de tracé, la couleur de fond et le mode de dessin fixés pour ce port. La nouvelle position du curseur est "x","y". Voir aussi : Move, SetAPen, SetBPen, SetDrMd. DrawBorder (fonction Intuition) Synopsis : DrawBorder( raster_port , bord , x , y ) Entrées : raster_port (a0) pointeur vers une structure RastPort bord (a1) pointeur vers une structure Border x (d0) entier y (d1) entier Description : Trace les bords spécifiés par "bord" dans le port Raster indiqué, en ajoutant les déplacements en x et en y à chaque coordonnée. Voir aussi : Border. DrawImage (fonction Intuition) Synopsis : DrawImage( raster_port , image , x , y ) Entrées : raster_port (a0) pointeur vers une structure RastPort image (a1) pointeur vers une structure Image x (d0) entier y (d1) entier Description : Trace l'image spécifiée par "image" dans le port Raster indiqué, en ajoutant les déplacements en x et en y à chaque coordonnée. Voir aussi : Image. DupLock (fonction Dos) Synopsis : clé1 = DupLock( clé2 ) Entrées : clé2 (d1) pointeur sur une structure FileLock Sorties : clé1 (d0) pointeur sur une structure FileLock Description : Retourne une clé de lecture désignant le même objet que "clé2". Note : Cette opération n'est possible que si "clé2" est une clé de lecture. Voir aussi : Lock. Enable (fonction Exec) Synopsis : Enable() Description : Autorise la prise en compte des interruptions. Note : Les interruptions ne sont autorisées que s'il y a eu autant d'appel de la fonction Enable que de la fonction Disable. Voir aussi : Disable. EndRefresh (fonction Intuition) Synopsis : EndRefresh( fenêtre , indic ) Entrées : fenêtre (a0) pointeur vers une structure Window indic (d0) booléen Description : Indique une fin de rafraichissement sur la fenêtre indiquée. Si "indic" vaut TRUE, la fenêtre est remise dans l'état normal, sinon elle reste en état optimisé. Voir aussi : BeginRefresh. EndRequest (fonction Intuition) Synopsis : EndRequest( requête , fenêtre ) Entrées : requête (a0) pointeur vers une structure Requester fenêtre (a1) pointeur vers une structure Window. Description : Efface la boite de requête indiquée. Voir aussi : BuildSysRequest. Enqueure (fonction Exec) Synopsis : Enqueure( liste , noeud ) Entrées : liste (a0) pointeur vers une structure List noeud (a1) pointeur vers une structure Node Description : Ajoute le noeud "noeud" dans la liste indiquée en fonction de la valeur indiquée dans le champ "ln_Pri" du noeud, de telle sorte que la liste soit ordonnée par priorités décroissantes. S'il existe déjà un ou plusieurs noeuds ayant la même priorité le nouveau noeud est inséré après ceux-ci. Voir aussi : Insert, List, Node. Examine (fonction Dos) Synopsis : résultat = Examine( clé , bloc ) Entrées : clé (d1) pointeur sur une structure FileLock bloc (d2) pointeur sur une structure FileInfoBlock Sorties : résultat (d0) booléen Description : Copie certaines informations sur le fichier ou sur le répertoire indiqué, dans une structure FileInfoBlock. Retourne 0 en cas d'échec, -1 en cas de succès. Voir aussi : FileInfoBlock, Lock. Execute (fonction Dos) Synopsis : résultat = Execute( commande , entrée , sortie ) Entrées : commande (d1) pointeur sur une chaine de caractères entrée (d2) pointeur sur une structure FileHandle sortie (d3) pointeur sur une structure FileHandle Sorties : résultat (d0) booléen Description : Exécute la commande CLI indiquée avec "sortie" comme fichier de sortie standard. Si "sortie" vaut 0, la fenêtre courante est utilisée. L'entrée standard est indiquée par "entrée". Retourne 0 en cas d'échec, -1 en cas de succès. Exit (fonction Dos) Synopsis : Exit( code ) Entrées : code (d1) entier Description : Termine le processus courant, et retourne la valeur "code" au processus appelant. ExNext (fonction Dos) Synopsis : résultat = ExNext( clé , bloc ) Entrées : clé (d1) pointeur sur une structure FileLock bloc (d2) pointeur sur une structure FileInfoBlock Sorties : résultat (d0) booléen Description : Copie certaines informations correspondant à l'entrée suivante du répertoire indiqué, dans une structure FileInfoBlock. La fonction Examine ou ExNext doit avoir été appelée avant, et le bloc indiqué doit rester le même. Retourne 0 en cas d'échec, -1 en cas de succès. Voir aussi : Examine, FileInfoBlock, Lock. FileInfoBlock (structure Dos) struct FileInfoBlock { LONG fib_DiskKey ; /* Numéro de bloc disque */ LONG fib_DirEntryType ; /* Type d'objet */ char fib_FileName[108] ; /* Nom de l'objet */ LONG fib_Protection ; /* Bits de protection */ LONG fib_EntryType ; LONG fib_Size ; /* Taille en octets */ LONG fib_NumBlocks ; /* Nombre de blocs occupés */ struct DateStamp fib_Date ; /* Date de dernière modification */ char fib_Comment[80] ; /* Commentaire */ } ; fib_DirEntryType : positif pour un répertoire, négatif pour un fichier fib_Protection : voir la fonction SetProtection Voir aussi : Examine, ExNext. FindName (fonction Exec) Synopsis : noeud = FindName( liste , nom ) Entrées : liste (a0) pointeur vers une structure List nom (a1) pointeur vers une chaine de caractères Sorties : noeud (d0) pointeur vers une structure Node Description : Cherche dans la liste indiquée le premier noeud dont le champ "ln_Name" est égal au paramêtre "nom". Retourne un pointeur sur ce noeud, ou NULL si aucun noeud n'est trouvé. Note : Si plusieurs noeuds ont le même nom, plusieurs appels successifs à FindName permettront de trouver tous ces noeuds. Il faudra alors appeler la fonction avec le résultat précédent comme premier paramêtre. Voir aussi : List, Node. FindPort (fonction Exec) Synopsis : port = FindPort( nom ) Entrées : nom (a1) pointeur vers une chaine de caractères Sorties : port (d0) pointeur vers une structure MsgPort Description : Cherche le port message de nom "nom". Retourne un pointeur sur ce port, ou NULL si aucune port ne porte ce nom. Voir aussi : AddPort, MsgPort. FindTask (fonction Exec) Synopsis : tâche = FindTask( nom ) Entrées : nom (a1) pointeur vers une chaine de caractères Sorties : tâche (d0) pointeur vers une structure Task Description : Cherche s'il existe une tâche de nom indiqué. Retourne un pointeur sur cette tâche, ou NULL si aucune tâche ne porte ce nom. Voir aussi : Task. Forbid (fonction Exec) Synopsis : Forbid() Description : Interdit la commutation de tâches. Voir aussi : Permit. FreeMem (fonction Exec) Synopsis : FreeMem( zone , taille ) Entrées : zone (a1) pointeur vers un long mot taille (d0) entier Description : Libère la zone mémoire indiquée. La taille spécifiée doit être celle demandée à l'allocation. Voir aussi : AllocMem. FreeRemember (fonction Intuition) Synopsis : FreeRemember( clé , indic ) Entrées : clé (a0) adresse d'un pointeur vers une structure Remember indic (d0) booléen Description : Libère la mémoire allouée par la fonction AllocRemember. Si "indic" vaut TRUE la mémoire et les chainages sont libérés, et si "indic" vaut FALSE, seuls les chainages sont libérés. Voir aussi : AllocRemember. FreeSignal (fonction Exec) Synopsis : FreeSignal( signal ) Entrées : signal (d0) entier Description : Libère le signal indiqué. Voir aussi : AllocSignal, SetSignal, Wait. FreeSysRequest (fonction Intuition) Synopsis : FreeSysRequest( fenêtre ) Entrées : fenêtre (a0) pointeur vers une structure Window Description : Libère la mémoire allouée par la fonction BuildSysRequest. Voir aussi : BuildSysRequest. FreeTrap (fonction Exec) Synopsis : FreeTrap( trappe ) Entrées : trappe (d0) entier Description : Indique au système que la trappe indiquée n'est plus reconnue par la tâche courante. Voir aussi : AllocTrap. Gadget (structure Intuition) struct Gadget { struct Gadget *NextGadget ; /* structure suivante */ SHORT LeftEdge , TopEdge ; /* x,y du coin supérieur gauche */ SHORT Width , Height ; /* largeur, hauteur du gadget */ USHORT Flags ; /* voir GadgetFlags */ USHORT Activation ; /* voir GadgetActivation */ USHORT GadgetType ; /* voir ci-dessous */ APTR GadgetRender ; /* pointeur vers Image ou Border */ APTR SelectRender ; /* pointeur vers Image ou Border */ struct IntuiText *GadgetText ; /* texte associé */ LONG MutualExclude ; /* non utilisé pour l'instant */ APTR SpecialInfo ; /* pointeur PropInfo ou StringInfo */ USHORT GadgetID ; /* à disposition du programmeur */ APTR UserData ; /* à disposition du programmeur */ } ; GadgetType : BOOLGADGET, STRGADGET, PROPGADGET, GZZGADGET, REQGADGET Voir aussi : AddGadget, Border, GadgetActivation, GadgetFlags, Image, PropInfo, StringInfo. GadgetActivation (champ de la structure Gadget) RELVERIFY message seulement si bouton gauche laché au dessus du gadget GADGIMMEDIATE message dès que bouton droit appuyé au dessus du gadget ENDGADGET efface la boite de requête (GadgetType = REQGADGET) FOLLOWMOUSE dès que sélectionné envoi de messages MOUSEMOVE RIGHTBORDER position et largeur relatifs au bord droit du contenant LEFTBORDER position et largeur relatifs au bord gauche du contenant TOPBORDER hauteur et position relatifs au bord supérieur du contenant BOTTOMBORDER hauteur et position relatifs au bord inférieur du contenant TOGGLESELECT gadget "interrupteur" (allumé/éteind) STRINGCENTER chaine centrée (GadgetType = STRGADGET) STRINGRIGHT chaine cadrée à droite (GadgetType = STRGADGET) LONGINT saisie d'un entier (GadgetType = STRGADGET) ALTKEYMAP voir StringInfo Voir aussi : Gadget, IDCMP, StringInfo. GadgetFlags (champ de la structure Gadget) GADGHIGHBITS (action quand le gadget est sélectionné) GADGHCOMP complémente l'image actuelle GADGHBOX trace un cadre GADGHIMAGE trace une image ou une bordure GADGHNONE ne fait rien GADGIMAGE GadgetRender et SelectRender pointent sur une image GRELBOTTOM TopEdge relatif au bord inférieur du contenant GRELRIGHT LeftEdge relatif au bord droit du contenant GRELWIDTH Width est un incrément à la largeur du contenant GRELHEIGHT Heigth est un incrément à la hauteur du contenant SELECTED gadget sélectionné GADGDISABLED gadget activé Voir aussi : Gadget. GetDefPrefs (fonction Intuition) Synopsis : prefs = GetDefPrefs( tampon , taille ) Entrées : tampon (a0) pointeur vers une structure Preferences taille (d0) entier Sorties : prefs (d0) pointeur vers une structure Preferences Description : Copie les préférences par défaut (celles que Intuition utilise lorsqu'il démarre). Seuls les "taille" premiers octets sont copiés. Retourne NULL en cas de problème. Voir aussi : GetPrefs. GetMsg (fonction Exec) Synopsis : msg = GetMsg( port ) Entrées : port (a0) pointeur vers une structure MsgPort Sorties : msg (d0) pointeur vers une structure Message Description : Retourne un pointeur sur le prochain message en attente sur le port indiqué, ou NULL s'il n'y a aucun message. Voir aussi : Message, MsgPort, ReplyMsg. GetPrefs (fonction Intuition) Synopsis : prefs = GetPrefs( tampon , taille ) Entrées : tampon (a0) pointeur vers une structure Preferences taille (d0) entier Sorties : prefs (d0) pointeur vers une structure Preferences Description : Copie les préférences courantes. Seuls les "taille" premiers octets sont copiés. Retourne NULL en cas de problème. Voir aussi : GetDefPrefs. GetScreenData (fonction Intuition) Synopsis : succès = GetScreenData( tampon , taille , type , écran ) Entrées : tampon (a0) pointeur vers une structure Screen taille (d0) entier type (d1) entier écran (a1) pointeur vers une structure Screen Sorties : succès (d0) booléen Description : Copie dans le tampon indiqué le contenu d'une structure Screen. Au plus "taille" octets sont transférés. Si l'argument "type" vaut WBENCHSCREEN, l'écran WorkBench est ouvert si besoin, plus les données copiées. Si l'argument "type" vaut CUSTOMSCREEN, les données sont copiées depuis la structure pointée par "écran". Retourne TRUE en cas de succès, FALSE en cas d'échec. IDCMP (Port message Intuition, classes de messages) SIZEVERIFY préparer changement de taille NEWSIZE taille de la fenêtre changée REFRESHWINDOW fenêtre à rafraichir MOUSEBUTTONS bouton de souris (SELECTUP, SELECTDOWN, MENUUP, MENUDOWN) MOUSEMOVE la souris a bougé GADGETDOWN SELECTDOWN et GadgetActivation = GADGIMMEDIATE GADGETUP SELECTUP et GadgetActivation = RELVERIFY REQSET boite de requête ouverte MENUPICK sélection menu terminée CLOSEWINDOW gadget de fermeture sélectionné RAWKEY appui sur une touche (codes touches absolus) REQVERIFY préparer ouverture boite de requête REQCLEAR dernière boite de requête effacée MENUVERIFY préparer sélection menu NEWPREFS Preferences changées DISKINSERTED disquette insérée DISKREMOVED disquette retirée ACTIVEWINDOW fenêtre activée INACTIVEWINDOW fenêtre désactivée VANILLAKEY appui sur une touche (codes touches ASCII) INTUITICKS signal d'horloge (environ 10 par seconde) Voir aussi : AutoRequest, BuildSysRequest, NewWindow, ModifyIDCMP. Image (structure Intuition) struct Image { SHORT LeftEdge ; /* x coin supérieur gauche */ SHORT TopEdge ; /* y coin supérieur gauche */ SHORT Width ; /* largeur */ SHORT Height , Depth ; /* hauteur, nombre de plans */ USHORT *ImageData ; /* pointeur vers définition image */ UBYTE PlanePick , /* masque plans utilisés */ PlaneOnOff ; /* masque plans inutilisés */ struct Image *NextImage ; } ; Voir aussi : DrawImage, Gadget, NewWindow. Info (fonction Dos) Synopsis : résultat = Info( clé , bloc ) Entrées : clé (d1) pointeur sur une structure FileLock bloc (d2) pointeur sur une structure InfoData Sorties : résultat (d0) booléen Description : Copie certaines informations sur le volume où se trouve le fichier ou le répertoire désigné par "clé", dans une structure InfoData. Retourne 0 en cas d'échec, -1 en cas de succès. Voir aussi : InfoData, Lock. InfoData (structure Dos) struct InfoData { LONG id_NumSoftErrors ; /* Nombre d'erreurs sur le volume */ LONG id_UnitNumber ; /* Unité de disque où est le volume */ LONG id_DiskState ; /* Etat du volume */ LONG id_NumBlocks ; /* Nombre de blocs sur le volume */ LONG id_NumBlocksUsed ; /* Nombre de blocs occupés */ LONG id_BytesPerBlock ; /* Nombre d'octets par bloc */ LONG id_DiskType ; /* Type du volume */ BPTR id_VolumeNode ; LONG id_InUse ; } ; id_DiskState : ID_WRITE_PROTECTED, ID_VALIDATING, ID_VALIDATED id_DiskType : ID_NO_DISK_PRESENT, ID_UNREADABLE_DISK, ID_DOS_DISK, ID_NOT_REALLY_DOS, ID_KICKSTART_DISK Voir aussi : Info. InitRequester (fonction Intuition) Synopsis : InitRequester( requête ) Entrées : requête (a0) pointeur vers une structure Requester Description : Initialise correctement la structure Requester indiquée. Input (fonction Dos) Synopsis : fichier = Input() Sorties : fichier (d0) pointeur sur une structure FileHandle Description : Retourne le descripteur du fichier d'entrée courant. Voir aussi : Output. Insert (fonction Exec) Synopsis : Insert( liste , noeud , pred ) Entrées : liste (a0) pointeur vers une structure List noeud (a1) pointeur vers une structure Node pred (a2) pointeur vers une structure Node Description : Insère le noeud "noeud" après le noeud "pred" dans la liste indiquée par "list". Si "pred" vaut NULL, le noeud est inséré en tête de liste. Voir aussi : AddHead, AddTail, Enqueure, Node, List, Remove. Interrupt (structure Exec) struct Interrupt { struct Node is_Node ; /* pour chainage liste interrupt. */ APTR is_Data ; /* pointeur zone de travail */ VOID (*is_Code)() ; /* pointeur sur routine */ } ; Voir aussi : SetIntVector. IntuiText (structure Intuition) struct IntuiText { UBYTE FrontPen , BackPen ; /* couleur tracé, couleur fond */ UBYTE DrawMode ; /* JAM1, JAM2, XOR */ SHORT LeftEdge ; /* x premier caractère */ SHORT TopEdge ; /* y premier caractère */ struct TextAttr *ITextFont ; /* police à utiliser */ UBYTE *IText ; /* chaine à afficher */ struct IntuiText *NextText ; /* structure suivante */ } ; Voir aussi : AutoRequest, BuildSysRequest, Gadget, IntuiTextLength, PrintIText. IntuiTextLength (fonction Intuition) Synopsis : longueur = IntuiTextLength( texte ) Entrées : texte (a0) pointeur vers une structure IntuiText Sorties : longueur (d0) entier Description : Retourne la longueur, en nombre de pixels, de la chaine de la structure IntuiText indiquée, en tenant compte de la taille de la police de caractères utilisée). Voir aussi : IntuiText. IoErr (fonction Dos) Synopsis : erreur = IoErr() Sorties : erreur (d0) entier Description : Retourne le code de la dernière erreur survenue, ou un résultat secondaire. Voir aussi : DeviceProc. IORequest (structure Exec) struct IORequest { struct Message io_Message ; struct Device *io_Device ; /* device concerné */ struct Unit *io_Unit ; /* unité concernée */ UWORD io_Command ; /* commande à exécuter */ UBYTE io_Flags ; BYTE io_Error ; /* code d'erreur retourné */ } ; Commandes : CMD_RESET, CMD_READ, CMD_WRITE, CMD_UPDATE, CMD_CLEAR, CMD_STOP, CMD_START, CMD_FLUSH Voir aussi : CheckIO, DoIO, SendIO, WaitIO. IOStdReq (structure Exec) struct IOStdReq { struct Message io_Message ; struct Device *io_Device ; /* device concerné */ struct Unit *io_Unit ; /* unité concernée */ UWORD io_Command ; /* commande à exécuter */ UBYTE io_Flags ; BYTE io_Error ; /* code d'erreur retourné */ ULONG io_Actual ; /* nombre d'octets transférés */ ULONG io_Length ; /* nombre d'octets à transférer */ APTR io_Data ; /* adresse du tampon d'E/S */ ULONG io_Offset ; /* déplacement pour l'E/S */ } ; Voir aussi : CheckIO, DoIO, SendIO, WaitIO. IsInteractive (fonction Dos) Synopsis : résultat = IsInteractive( fichier ) Entrées : fichier (d1) pointeur sur une structure FileHandle Sorties : résultat (d0) booléen Description : Retourne -1 si le fichier indiqué correspond à un terminal virtuel, 0 si non. Voir aussi : Open. ItemAddress (fonction Intuition) Synopsis : adr = ItemAddress( menu , code ) Entrées : menu (a0) pointeur vers la première structure Menu d'une barre de menus code (d0) entier Sorties : adr (d0) pointeur vers une structure MenuItem Description : Retourne l'adresse de la structure MenuItem correspondant au code indiqué (le code est envoyé par Intuition dans un message de classe MENUPICK). List (structure Exec) struct List { struct Node *lh_Head ; /* pointe sur le premier noeud */ struct Node *lh_Tail ; /* toujours nul */ struct Node *lh_TailPred ; /* pointe sur le dernier noeud */ UBYTE lh_Type ; /* type des noeuds de la liste */ UBYTE lh_pad ; } ; Voir aussi : Node. Lock (fonction Dos) Synopsis : clé = Lock( nom , accès ) Entrées : nom (d1) pointeur sur une chaine de caractères accès (d2) entier (ACCESS_READ ou ACCESS_WRITE) Sorties : clé (d0) pointeur sur une structure FileLock Description : Retourne une clé de lecture ou d'écriture (suivant la valeur de "accès") sur le fichier ou sur le répertoire indiqué. La clé retournée est nulle en cas d'échec. Voir aussi : UnLock. LockIBase (fonction Intuition) Synopsis : verrou = LockIBase( type ) Entrées : type (d0) entier Sorties : verrou (d0) entier Description : Demande un verrou d'accès exclusif à la structure IntuitionBase. L'argument "type" doit être nul. Voir aussi : UnlockIBase. LoadSeg (fonction Dos) Synopsis : segment = LoadSeg( nom ) Entrées : nom (d1) pointeur sur une chaine de caractères Sorties : segment (d0) pointeur sur une liste de segments Description : Charge le fichier exécutable indiqué en mémoire. Retourne un pointeur sur la liste des segments alloués, ou 0 en cas d'erreur. Voir aussi : CreateProc, UnLoadSeg. Message (structure Exec) struct Message { struct Node mn_Node ; /* pour chainage liste messages */ struct MsgPort *mn_ReplyPort ; /* port où envoyer la réponse */ UWORD mn_Length ; /* longueur du message */ } ; Voir aussi : GetMsg, Node, PutMsg, ReplyMsg. ModifyIDCMP (fonction Intuition) Synopsis : ModifyIDCMP( fenêtre , IDCMP ) Entrées : fenêtre (a0) pointeur vers une structure Window IDCMP (d0) indicateurs IDCMP Description : Modifie les indicateurs IDCMP de la fenêtre indiquée. Voir aussi : IDCMP. ModifyProp (fonction Intuition) Synopsis : ModifyProp( gadget, fenêtre , requête , indics , horiz_pot, vert_pot, horiz_body, vert_body ) Entrées : gadget (a0) pointeur vers une structure Gadget fenêtre (a1) pointeur vers une structure Window ou une structure Screen requête (a2) pointeur vers une structure Requester indics (d0) entier horiz_pot (d1) entier vert_pot (d2) entier horiz_body (d3) entier vert_body (d4) entier Description : Modifie un gadget proportionel. Les paramêtres "indics", "horiz_pot", "vert_pot", "horiz_body" et "vert_body" sont copiés dans les champs "Flags", "HorizPot", "VertPot", "HorizBody" et "VertBody" de la structure PropInfo associée au gadget. Le paramêtre "fenêtre" indique la fenêtre ou l'écran contenant le gadget, et le paramêtre "requête" la boite de requête où est affichée le gadget (éventuellement NULL). Voir aussi : PropInfo. Move (fonction Graphics) Synopsis : Move( rast_port , x , y ) Entrées : rast_port (a1) pointeur vers une structure RasterPort x (d0) entier y (d1) entier Description : Place le curseur graphique du port Raster indiqué en "x","y". MoveScreen (fonction Intuition) Synopsis : MoveScreen( écran , x , y ) Entrées : écran (a0) pointeur vers une structure Screen x (d0) entier y (d1) entier Description : Déplace l'écran indiqué. Note : Dans la version courante d'Intuition, le paramêtre x est ignoré. MoveWindow (fonction Intuition) Synopsis : MoveWindow( fenêtre , x , y ) Entrées : fenêtre (a0) pointeur vers une structure Window x (d0) entier y (d1) entier Description : Déplace la fenêtre indiquée. MsgPort (structure Exec) struct MsgPort { struct Node mp_Node ; /* pour chainage liste ports */ UBYTE mp_Flags ; /* voir ci-dessous */ UBYTE mp_SigBit ; /* numéro de signal à envoyer */ struct Task *mp_SigTask ; /* tâche qui recevra le signal */ struct List mp_MsgList ; /* tête de la liste des messages */ } ; mp_Flags : action effectuée sur réception d'un message PA_SIGNAL (envoi un signal) PA_SOFTINT (génère une interruption) PA_IGNORE (ne fait rien) Voir aussi : AddPort, Node. NewScreen (structure Intuition) struct NewScreen { SHORT LeftEdge , TopEdge ; /* ignoré, ligne supérieure */ SHORT Width , Height ; /* largeur, hauteur */ SHORT Depth ; /* nombre de plans */ UBYTE DetailPen , BlockPen ; /* couleur détails, couleur blocs */ USHORT ViewModes ; /* HIRES,INTERLACE,SPRITES,DUALPF */ USHORT Type ; /* CUSTOMSCREEN,CUSTOMBITMAP */ struct TextAttr *Font ; /* police utilisée */ UBYTE *DefaultTitle ; /* titre de l'écran */ struct Gadget *Gadgets ; /* gadgets attachés à cet écran */ struct BitMap *CustomBitMap ; } ; Voir aussi : Gadget, OpenScreen. NewWindow (structure Intuition) struct NewWindow { SHORT LeftEdge , TopEdge ; /* x,y coin supérieur gauche */ SHORT Width , Height ; /* largeur, hauteur */ UBYTE DetailPen , BlockPen ; /* couleur détails, couleur blocs */ ULONG IDCMPFlags ; /* voir IDCMP */ ULONG Flags ; /* voir WindowFlags */ struct Gadget *FirstGadget ; /* gadgets attachés à cette fenêtre */ struct Image *CheckMark ; /* Image associée marque des menus */ UBYTE *Title ; /* titre de la fenêtre */ struct Screen *Screen ; /* écran où placer la fenêtre */ struct BitMap *BitMap ; SHORT MinWidth , MinHeight ; /* taille minimale */ USHORT MaxWidth , MaxHeight ; /* taille maximale */ USHORT Type ; /* WBENCHSCREEN, CUSTOMSCREEN */ } ; Voir aussi : Gadget, IDCMP, Image, OpenWindow, WindowFlags. Node (structure Exec) struct Node { struct Node *ln_Succ ; /* noeud suivant dans la liste */ struct Node *ln_Pred ; /* noeud précédent dans la liste */ UBYTE ln_Type ; /* type du noeud */ BYTE ln_Pri ; /* priorité du noeud */ char *ln_Name ; /* nom du noeud */ } ; OffGadget (fonction Intuition) Synopsis : OffGadget( gadget , fenêtre , requête ) Entrées : gadget (a0) pointeur vers une structure Gadget fenêtre (a1) pointeur vers une structure Window requête (a2) pointeur vers une structure Requester Description : Désactive le gadget indiqué. L'argument requête peut valoir NULL, dans le cas où le gadget n'est pas dans une boite de requête. Note : L'affichage du gadget n'est pas modifié, il faut pour cela appeler la fonction RefreshGadgets. Voir aussi : OnGadget, RefreshGadgets. OffMenu (fonction Intuition) Synopsis : OffMenu( fenêtre , code_menu ) Entrées : fenêtre (a0) pointeur vers une structure Window code_menu (d0) entier Description : Désactive un sous-menu, une option, ou un menu complet. Voir aussi : OnMenu. OnGadget (fonction Intuition) Synopsis : OnGadget( gadget , fenêtre , requête ) Entrées : gadget (a0) pointeur vers une structure Gadget fenêtre (a1) pointeur vers une structure Window requête (a2) pointeur vers une structure Requester Description : Active le gadget indiqué. L'argument requête peut valoir NULL, dans le cas où le gadget n'est pas dans une boite de requête. Note : L'affichage du gadget n'est pas modifié, il faut pour cela appeler la fonction RefreshGadgets. Voir aussi : OffGadget, RefreshGadgets. OnMenu (fonction Intuition) Synopsis : OnMenu( fenêtre , code_menu ) Entrées : fenêtre (a0) pointeur vers une structure Window code_menu (d0) entier Description : Active un sous-menu, une option, ou un menu complet. Voir aussi : OffMenu. Open (fonction Dos) Synopsis : fichier = Open( nom , accès ) Entrées : nom (d1) pointeur sur une chaine de caractères accès (d2) entier (MODE_OLDFILE ou MODE_NEWFILE) Sorties : fichier (d0) pointeur sur une structure FileHandle Description : Ouvre le fichier indiqué en lecture ou en écriture (suivant la valeur de accès). Retourne un pointeur sur une structure FileHandle, ou 0 en cas d'échec. Voir aussi : Close. OpenLibrary (fonction Exec) Synopsis : lib = OpenLibrary( nom , version ) Entrées : nom (a1) pointeur vers une chaine de caractères version (d0) entier Sorties : lib (d0) pointeur vers une structure Library Description : Ouvre une librarie, de version au moins égale à "version". Si la valeur de "version" est 0, aucun contrôle de version n'est fait. Retourne un pointeur vers la librarie, ou NULL en cas d'échec. Voir aussi : CloseLibrary. OpenScreen (fonction Intuition) Synopsis : écran = OpenScreen( nécran ) Entrées : nécran (a0) pointeur vers une structure NewScreen Sorties : écran (d0) pointeur vers une structure Screen Description : Ouvre un écran comme spécifié par la structure NewScreen. Retourne un pointeur vers la structure Screen correspondante, ou 0 en cas de problème. Voir aussi : CloseScreen, NewScreen. OpenWindow (fonction Intuition) Synopsis : fenêtre = OpenWindow( nfenêtre ) Entrées : nfenêtre (a0) pointeur vers une structure NewWindow Sorties : fenêtre (d0) pointeur vers une structure Window Description : Ouvre une fenêtre comme spécifié par la structure NewWindow. Retourne un pointeur vers la structure Window correspondante, ou 0 en cas de problème. Voir aussi : CloseWindow, NewWindow. OpenWorkBench (fonction Intuition) Synopsis : résultat = OpenWorkBench() Sorties : résultat (d0) booléen Description : Ouvre l'écran WorkBench. Retourne TRUE si tout c'est bien passé et FALSE sinon. Voir aussi : CloseWorkBench. Output (fonction Dos) Synopsis : fichier = Output() Sorties : fichier (d0) pointeur sur une structure FileHandle Description : Retourne le descripteur du fichier de sortie courant. Voir aussi : Input. ParentDir (fonction Dos) Synopsis : clé1 = ParentDir( clé2 ) Entrées : clé2 (d1) pointeur sur une structure FileLock Sorties : clé1 (d0) pointeur sur une structure FileLock Description : Retourne une clé de lecture correspondant au répertoire père du fichier ou du répertoire désigné par "clé2", ou NULL si cet objet est à la racine du volume. Voir aussi : CurrentDir, Lock. Permit (fonction Exec) Synopsis : Permit() Description : Autorise la commutation de tâches. Note : Le multi-tâche n'est relancé que s'il y a eu autant d'appels de la fonction Permit que de la fonction Forbid. Voir aussi : Forbid. PrintIText (fonction Intuition) Synopsis : PrintIText( raster_port, texte , x , y ) Entrées : raster_port (a0) pointeur vers une structure RastPort texte (a1) pointeur vers une structure IntuiText x (d0) entier y (d1) entier Description : Affiche le texte dans le port Raster indiqué, après avoir ajouté les déplacements x et y aux coordonnées. Voir aussi : IntuiText. PropInfo (structure Intuition) struct PropInfo { USHORT Flags ; /* voir ci-dessous */ USHORT HorizPot ; /* pourcentage horizontal */ USHORT VertPot ; /* poucentage vertical */ USHORT HorizBody ; /* incrément horizontal */ USHORT VertBody ; /* incrément vertical */ USHORT CWidth ; /* largeur du contenant */ USHORT CHeight ; /* hauteur du contenant */ USHORT HPotRes, VPotRes ; USHORT LeftBorder ; /* bord gauche du contenant */ USHORT TopBorder ; /* bord supérieur du contenant */ } ; Flags : AUTOKNOB, FREEHORIZ, FREEVERT, PROPBORDERLESS, KNOBHIT Voir aussi : Gadget, ModifyProp. PutMsg (fonction Exec) Synopsis : PutMsg( port , msg ) Entrées : port (a0) pointeur vers une structure MsgPort msg (a1) pointeur vers une structure Message Description : Envoit le message indiqué vers un port message. Voir aussi : AddPort, GetMsg, Message, MsgPort. Read (fonction Dos) Synopsis : résultat = Read( fichier , tampon , longueur ) Entrées : fichier (d1) pointeur sur une structure FileHandle tampon (d2) pointeur sur un tampon longueur (d3) entier Sorties : résultat (d0) entier Description : Lit le nombre d'octets de données indiquées depuis un fichier, et place des données à l'emplacement pointé par "tampon". Retourne le nombre d'octets lus, -1 en cas d'erreur, et 0 en fin de fichier. Voir aussi : Open. RectFill (fonction Graphics) Synopsis : RectFill( rast_port , x1 , y1 , x2 , y2 ) Entrées : rast_port (a1) pointeur vers une structure RasterPort x1 (d0) entier y1 (d1) entier x2 (d2) entier y2 (d3) entier Description : Trace un rectangle plein entre les points "x1","y1" et "x2,y2" sur le port Raster indiqué, en fonction de la couleur de tracé, de la couleur de fond, et du mode de dessin fixés pour ce port. Voir aussi : SetAPen, SetBPen, SetDrMd. RefreshGadgets (fonction Intuition) Synopsis : RefreshGadgets( gadget , fenêtre , requête ) Entrées : gadget (a0) pointeur vers une structure Gadget fenêtre (a1) pointeur vers une structure Window requête (a2) pointeur vers une structure Requester Description : Rafraichit l'affichage des gadgets d'une fenêtre à partir du gadget indiqué. L'argument requête peut valoir NULL, dans le cas où le gadget n'est pas dans une boite de requête. Voir aussi : RefreshGList. RefreshGList (fonction Intuition) Synopsis : RefreshGList( gadgets , fenêtre , requête , nombre ) Entrées : gadget (a0) pointeur vers une structure Gadget fenêtre (a1) pointeur vers une structure Window requête (a2) pointeur vers une structure Requester nombre (d1) entier Description : Rafraichit l'affichage des gadgets d'une fenêtre à partir du gadget indiqué. L'argument requête peut valoir NULL, dans le cas où le gadget n'est pas dans une boite de requête. "nombre" indique le nombre maximal de gadgets à rafraichir. Si cet argument vaut -1, tous les gadgets de la liste, à partir du gadget indiqué sont rafraichis. Voir aussi : RefreshGadget. RefreshWindowFrame (fonction Intuition) Synopsis : RefreshWindowFrame( fenêtre ) Entrées : fenêtre (a0) pointeur vers une structure Window Description : Rafraichit les bordures et les gadgets systèmes de la fenêtre indiquée. RemHead (fonction Exec) Synopsis : RemHead( liste ) Entrées : liste (a0) pointeur vers une structure List Description : Enleve le noeud de tête de la liste indiquée. Voir aussi : AddHead, List, Remove. Remove (fonction Exec) Synopsis : Remove( noeud ) Entrées : noeud (a1) pointeur vers une structure Node Description : Enleve le noeud indiqué de la liste où il se trouve. Voir aussi : Insert, Node, RemHead, RemTail. RemoveGadget (fonction Intuition) Synopsis : résultat = RemoveGadget( fenêtre , gadget ) Entrées : fenêtre (a0) pointeur vers une structure Window gadget (a1) pointeur vers une structure Gadget Sorties : résultat (d0) entier Description : Retire le gadget indiqué de la liste des gadgets de la fenêtre. Retourne l'ancienne position du gadget, ou -1 en cas de problème. Note : Le gadget n'est pas effacé de l'affichage, il faut pour cela appeler la fonction RefreshGadgets. Voir aussi : AddGadget, RefreshGadgets, RemoveGList. RemoveGList (fonction Intuition) Synopsis : position = RemoveGList( fenêtre , gadget , nombre ) Entrées : fenêtre (a0) pointeur vers une structure Window gadget (a1) pointeur vers une structure Gadget nombre (d0) entier Sorties : position (d0) entier Description : retire "nombre" gadgets de la liste des gadgets de la fenêtre indiquée, en commençant par le gadget pointé par l'argument "gadget". Si "nombre" vaut -1, tous les gadgets sont retirés jusqu'à en trouver un dont le champ NextGadget vaut NULL. Voir aussi : RemoveGadget, AddGList. RemPort (fonction Exec) Synopsis : RemPort( port ) Entrées : port (a1) pointeur vers une structure MsgPort Description : Enlève le port indiqué de la liste des ports. Voir aussi : AddPort, MsgPort. RemTail (fonction Exec) Synopsis : RemTail( liste ) Entrées : liste (a0) pointeur vers une structure List Description : Enleve le noeud de fin de la liste indiquée. Voir aussi : AddTail, List, Remove. RemTask (fonction Exec) Synopsis : RemTask( tâche ) Entrées : tâche (a1) pointeur vers une structure Task Description : Supprime la tâche indiquée. Si "tâche" vaut NULL, la tâche courante est supprimée. Voir aussi : AddTask, Task. Rename (fonction Dos) Synopsis : résultat = Rename( nom1 , nom2 ) Entrées : nom1 (d1) pointeur sur une chaine de caractères nom2 (d2) pointeur sur une chaine de caractères Sorties : résultat (d0) booléen Description : Renomme le fichier ou le répertoire désigné par "nom1", le nouveau nom étant "nom2". Retourne 0 en cas d'échec, -1 en cas de succès. ReplyMsg (fonction Exec) Synopsis : ReplyMsg( msg ) Entrées : msg (a1) pointeur vers une structure Message Description : Signale au port émetteur que le message indiqué a été reçu et traité. Voir aussi : GetMsg, Message. ReportMouse (fonction Intuition) Synopsis : ReportMouse( fenêtre , indic ) Entrées : fenêtre (a0) pointeur vers une structure Window indic (d0) booléen Description : Active ("indic" = TRUE) ou désactive ("indic" = FALSE) l'envoi de messages rapportant la position de la souris. Voir aussi : IDCMP. Request (fonction Intuition) Synopsis : résultat = Request( requête , fenêtre ) Entrées : requête (a0) pointeur vers une structure Requester fenêtre (a1) pointeur vers une structure Window Sorties : résultat (d0) booléen Description : Ouvre une boite de requête dans la fenêtre indiquée. Retourne TRUE si tout va bien, FALSE en cas de problème. ScreenToBack (fonction Intuition) Synopsis : ScreenToBack( écran ) Entrées : écran (a0) pointeur vers une structure Screen Description : Fait passer l'écran indiqué en arrière plan. Voir aussi : ScreenToFront. ScreenToFront (fonction Intuition) Synopsis : ScreenToFront( écran ) Entrées : écran (a0) pointeur vers une structure Screen Description : Fait passer l'écran indiqué au premier plan. Voir aussi : ScreenToBack. SendIO (fonction Exec) Synopsis : SendIO( rbloc ) Entrées : rbloc (a1) pointeur vers une structure IORequest ou IOStdReq Description : Lance l'opération d'E/S indiquée par "rbloc" sans bloquer la tâche courante. Voir aussi : DoIO, CheckIO, IORequest, IOStdReq, WaitIO. Seek (fonction Dos) Synopsis : résultat = Seek( fichier , position , mode ) Entrées : fichier (d1) pointeur sur une structure FileHandle position (d2) entier mode (d3) entier (OFFSET_BEGINNING,OFFSET_CURRENT,OFFSET_END) Sorties : résultat (d0) booléen Description : Place le pointeur de lecture/écriture du fichier indiqué à l'endroit désigné par "position" (relatif au début du fichier, à la position courante ou à la fin du fichier suivant la valeur de "mode"). Retourne l'ancienne position (relative au début du fichier) ou -1 en cas d'erreur. Voir aussi : Open. SetAPen (fonction Graphics) Synopsis : SetAPen( rast_port , couleur ) Entrées : rast_port (a1) pointeur vers une structure RasterPort couleur (d0) entier Description : Change la couleur de tracé du port Raster indiqué. Voir aussi : SetBPen, SetDrMd. SetBPen (fonction Graphics) Synopsis : SetBPen( rast_port , couleur ) Entrées : rast_port (a1) pointeur vers une structure RasterPort couleur (d0) entier Description : Change la couleur de fond du port Raster indiqué. Voir aussi : SetAPen, SetDrMd. SetDrMd (fonction Graphics) Synopsis : SetDrMd( rast_port , mode ) Entrées : rast_port (a1) pointeur vers une structure RasterPort mode (d0) entier (JAM1, JAM2, XOR) Description : Change le mode de dessin du port Raster indiqué, suivant la valeur de mode : JAM1 tracé dans la couleur fixée par SetAPen, fond inchangé JAM2 tracé dans la couleur fixée par SetAPen, fond dans la couleur fixée par SetBPen XOR tracé en complément du fond. Voir aussi : SetAPen, SetBPen. SetComment (fonction Dos) Synopsis : résultat = SetCommand( nom , commentaire ) Entrées : nom (d1) pointeur sur une chaine de caractères commentaire (d2) pointeur sur une chaine de caractères Sorties : résultat (d0) booléen Description : Associe un commentaire au fichier ou au répertoire indiqué. Retourne 0 en d'échec, -1 en cas de succès. SetDMRequest (fonction Intuition) Synopsis : résultat = SetDMRequest( fenêtre , requête ) Entrées : fenêtre (a0) pointeur vers une structure Window requête (a1) pointeur vers une structure Requester Sorties : résultat (d0) entier Description : Attache une boite de requête à la fenêtre indiquée. Cette boite de requête est activée quand on double-clique sur le bouton MENU de la souris. Retourne TRUE si tout va bien, FALSE en cas de problème. Voir aussi : ClearDMRequest. SetFunction (fonction Exec) Synopsis : SetFunction( lib , depl , adresse ) Entrées : lib (a1) pointeur vers une structure Library depl (a0) entier adresse (d0) pointeur vers une fonction Description : Modifie la table de saut de la librarie indiquée, pour que le vecteur "depl" pointe vers la fonction spécifiée. La somme de contrôle de la librarie est recalculée. Voir aussi : OpenLibrary. SetIntVector (fonction Exec) Synopsis : vect = SetIntVector( nint , interr ) Entrées : nint (d0) entier interr (a1) pointeur vers une structure Interrupt Sorties : vect (d0) pointeur vers une structure Interrrupt Description : Utilise la structure pointée par "interr" pour initialiser le traitement de l'interruption "nint". Retourne un pointeur vers la structure précédemment utilisée. Voir aussi : Interrupt. SetMenuStrip (fonction Intuition) Synopsis : SetMenuStrip( fenêtre , menu ) Entrées : fenêtre (a0) pointeur vers une structure Window menu (a1) pointeur vers une structure Menu Description : Ajoute une barre de menu de la fenêtre indiquée. Voir aussi : ClearMenuStrip. SetPointer (fonction Intuition) Synopsis : SetPointer( fenêtre , def , hauteur , largeur , x , y ) Entrées : fenêtre (a0) pointeur vers une structure Window def (a1) pointeur vers la définition du pointeur hauteur (d0) entier largeur (d1) entier x (d2) entier y (d3) entier Description : Change la définition du pointeur pour la fenêtre indiquée. La taille du pointeur est donnée par les paramêtres "hauteur" et "largeur" (doit être inférieur ou égal à 16). Les paramêtres "x" et "y" indiquent le déplacement du coin supérieur gauche de l'image du pointeur par rapport au point désigné par le pointeur. Voir aussi : ClearPointer. SetProtection (fonction Dos) Synopsis : résultat = SetProtection( nom , masque ) Entrées : nom (d1) pointeur sur une chaine de caractères masque (d2) entier Sorties : résultat (d0) booléen Description : Change les bits de protection du fichier indiqué à partir de "masque" : bit 0 : d (delete) bit 4 : a (archived) bit 1 : e (execute) bit 5 : p (pure) bit 2 : w (write) bit 6 : s (script) bit 3 : r (read) bit 7 : h (hidden) SetSignal (fonction Exec) Synopsis : sig = SetSignal( nsig , masque ) Entrées : nsig (d0) entier masque (d1) entier Sorties : sig (d0) entier Description : Change l'état des signaux de la tâche courante. Pour chaque signal, l'action dépend des bits correspondants dans "nsig" et "masque" : - si les deux bits sont à 1, le signal est alloué - si le bit de "nsig" est à 0 et celui de "masque" à 1, le signal est libéré Retourne l'état précédent des signaux (bit à 1 implique que le signal correspondant est alloué). Voir aussi : AllocSignal, FreeSignal, Wait. SetTaskPri (fonction Exec) Synopsis : pri = SetTaskPri( tâche , npri ) Entrées : tâche (a1) pointeur vers une structure Task npri (d0) entier Sorties : pri (d0) entier Description : Fixe la priorité de la tâche indiquée à "npri". Retourne la priorité précédente de cette tâche. Voir aussi : Task. SetWindowTitles (fonction Intuition) Synopsis : SetWindowTitles( fenêtre , titre_f , titre_e ) Entrées : fenêtre (a0) pointeur vers une structure Window titre_f (a1) pointeur vers une chaine de caractères titre_e (a2) pointeur vers une chaine de caractères Description : Change le titre de la fenêtre indiquée et/ou de l'écran où se trouve cette fenêtre. Si "titre_f" vaut 0 l'ancien titre de la fenêtre est effacé, s'il vaut -1 l'ancien titre est conservé, sinon l'ancien titre est remplacé par la chaine indiquée. Si "titre_e" vaut 0 l'ancien titre de l'écran est effacé, s'il vaut -1 l'ancien titre est conservé, sinon l'ancien titre est remplacé par la chaine indiquée. Voir aussi : ShowTitle. ShowTitle (fonction Intuition) Synopsis : ShowTitle( écran , indic ) Entrées : écran (a0) pointeur vers une structure Screen indic (d0) booléen Description : Ré-affiche ("indic" = TRUE) ou cache ("indic" = FALSE) le titre de l'écran indiqué. Voir aussi : SetWindowTitles. Signal (fonction Exec) Synopsis : Signal( tâche , nsig ) Entrées : tâche (a1) pointeur vers une structure Task nsig (d0) entier Description : Envoit le signal "nsig" à la tâche indiquée. Voir aussi : AllocSignal, Task, Wait. SizeWindow (fonction Intuition) Synopsis : SizeWindow( fenêtre , x , y ) Entrées : fenêtre (a0) pointeur vers une structure Window x (d0) entier y (d1) entier Description : Change la taille de la fenêtre indiquée, en ajoutant "x" à sa largeur et "y" à sa hauteur. StringInfo (structure Intuition) struct StringInfo { UBYTE *Buffer ; /* tampon pour la chaine */ UBYTE *UndoBuffer ; /* tampon d'édition */ SHORT BufferPos ; /* position dans le tampon */ SHORT MaxChars ; /* taille maximale de la chaine */ SHORT DispPos ; /* position du 1er caractère affiché */ SHORT UndoPos ; /* position dans le tampon d'édition */ SHORT NumChars ; /* nombre de caractères dans le tampon */ SHORT DispCount ; /* nombre de caractères visibles */ SHORT CLeft , CTop ; /* x,y du coin supérieur gauche */ struct Layer *LayerPtr ; LONG LongInt ; /* valeur correspondant à la chaine */ struct KeyMap *AltKeyMap ; /* table de traduction des caractères */ } ; LongInt n'est utilisé que si GadgetActivation = LONGINT AltKeyMap n'est utilisé que si GadgetActivation = ALTKEYMAP Voir aussi : ActivateGadget, GadgetActivation, Gadget. Task (structure Exec) struct Task { struct Node tc_Node ; /* pour chainage liste des tâches */ UBYTE tc_Flags ; UBYTE tc_State ; /* état de la tâche */ BYTE tc_IDNestCnt ; /* compteur Disable/Enable */ BYTE tc_TDNestCnt ; /* compteur Forbid/Permit */ ULONG tc_SigAlloc ; /* signaux alloués */ ULONG tc_SigWait ; /* signaux que la tâche attend */ ULONG tc_SigRecvd ; /* signaux reçus */ ULONG tc_SigExcept ; UWORD tc_TrapAlloc ; /* trappes reconnues */ UWORD tc_TrapAble ; /* trappes autorisées */ APTR tc_ExceptData ; /* adresse données d'exception */ APTR tc_ExceptCode ; /* adresse routine d'exception */ APTR tc_TrapData ; /* adresse données de trappe */ APTR tc_TrapCode ; /* adresse routine de trappe */ APTR tc_SPReg ; /* sauvegarde du pointeur de pile */ APTR tc_SPLower ; /* limite inférieure de la pile */ APTR tc_SPUpper ; /* limite supérieure de la pile */ VOID (*tc_Switch)() ;/* routine perte du processeur */ VOID (*tc_Launch)() ;/* routine obtention processeur */ struct List tc_MemEntry ; /* mémoire occupée */ APTR tc_UserData ; /* à disposition du programmeur */ } ; Voir aussi : AddTask, Disable, Enable, Forbid, Permit. Text (fonction Graphics) Synopsis : Text( rast_port , chaine , lg ) Entrées : rast_port (a1) pointeur vers une structure RasterPort chaine (a0) pointeur vers une chaine de caractères lg (d0) entier Description : Ecrit les "lg" premiers caractères de "chaine" dans un port Raster, en fonction de la position du curseur, de la couleur de tracé, de la couleur de fond, de la police et du mode de dessin fixés pour ce port. Voir aussi : Move, SetAPen, SetBPen, SetDrMd. TypesDeMemoire (notion Exec) MEMF_CHIP zone mémoire accessible par les co-processeurs MEMF_FAST zone mémoire inacessible par les co-processeurs MEMF_PUBLIC la zone mémoire ne doit pas être décalée MEMF_CLEAR la zone mémoire doit être mise à zéro MEMF_LARGEST la zone mémoire doit être le plus grand bloc libre disponible Voir aussi : AllocMem, AvailMem. UnLoadSeg (fonction Dos) Synopsis : UnLoadSeg( segment ) Entrées : segment (d1) pointeur sur une liste de segments Description : Libère la liste de segments indiquée. Voir aussi : LoadSeg. UnLock (fonction Dos) Synopsis : UnLock( clé ) Entrées : clé (d1) pointeur sur une structure FileLock Description : Libère une clé d'accès. Voir aussi : Lock. UnlockIBase (fonction Intuition) Synopsis : UnlockIBase( verrou ) Entrées : verrou (a0) entier Description : Rend le verrou d'accès indiqué, et permet donc à une autre tâche d'accéder à IntuitionBase. Voir aussi : LockIBase. Wait (fonction Exec) Synopsis : signal = Wait( masque ) Entrées : masque (d0) entier Sorties : signal (d0) entier Description : Place la tâche courante en état d'attente, jusqu'à réception d'un des signaux indiqués par "masque". Si un des signaux est déjà présent, Wait rend la main tout de suite. Retourne le masque des signaux reçus. Voir aussi : AllocSignal, Signal. WaitForChar (fonction Dos) Synopsis : résultat = WaitForChar( fichier , délai ) Entrées : fichier (d1) pointeur sur une structure FileHandle délai (d2) entier Sorties : résultat (d0) booléen Description : Attend pendant au plus "délai" micro-secondes des données en entrée sur le terminal correspondant au fichier indiqué. Retourne -1 si des données sont présentes, 0 si non. Voir aussi : Open, Read, IsInteractive. WaitIO (fonction Exec) Synopsis : WaitIO( rbloc ) Entrées : rbloc (a1) pointeur vers une structure IORequest ou IOStdReq Description : Arrête la tâche courante jusqu'à ce que l'opération d'E/S indiquée par "rbloc" soit terminée. Voir aussi : CheckIO, IORequest, IOStdReq, SendIO. WaitPort (fonction Exec) Synopsis : WaitPort( port ) Entrées : port (a0) pointeur vers une structure MsgPort Description : Attend la réception d'un message sur le port indiqué. S'il y a déjà des messages en attente, WaitPort rend la main tout de suite. Voir aussi : GetMsg, MsgPort. WBenchToBack (fonction Intuition) Synopsis : résultat = WBenchToBack() Sorties : résultat (d0) booléen Description : Place l'écran WorkBench en arrière plan. Retourne TRUE si tout va bien, FALSE si l'écran WorkBench n'est pas ouvert. WBenchToFront (fonction Intuition) Synopsis : résultat = WBenchToFront() Sorties : résultat (d0) booléen Description : Place l'écran WorkBench au premier plan. Retourne TRUE si tout va bien, FALSE si l'écran WorkBench n'est pas ouvert. WindowFlags (champ de la structure NewWindow) WINDOWSIZING ajoute gadget changement de taille WINDOWDRAG ajoute gadget déplacement WINDOWDEPTH ajoute gadget changement de plan WINDOWCLOSE ajoute gadget fermeture SMART_REFRESH rafraichissement assuré en partie par Intuition SIMPLE_REFRESH rafraichissement assuré par le programme NOCAREREFRESH pas de rafraichissement BACKDROP fenêtre bloquée en arrière plan REPORTMOUSE envoi des message MOUSEMOVE BORDERLESS ne trace pas le bord de la fenêtre RMBTRAP n'appelle pas les menu quand MENUDOWN Voir aussi : NewWindow. WindowLimits (fonction Intuition) Synopsis : résultat = WindowLimits( fenêtre, l_min, h_min, l_max, h_max ) Entrées : fenêtre (a0) pointeur vers une structure Window l_min (d0) entier h_min (d1) entier l_max (d2) entier h_max (d3) entier Sorties : résultat (d0) booléen Description : Change les tailles limites de la fenêtre indiquée, en copiant les valeurs "l_min", "h_min", "l_max" et "h_max" dans les champs "MinWidth", "MinHeight", "MaxWidth" et "MaxHeight" de la structure Window. Retourne TRUE si tout c'est bien passé, FALSE en cas de problème. WindowToBack (fonction Intuition) Synopsis : WindowToBack( fenêtre ) Entrées : fenêtre (a0) pointeur vers une structure Window Description : Place la fenêtre indiquée en arrière plan. Voir aussi : WindowToFront. WindowToFront (fonction Intuition) Synopsis : WindowToFront( fenêtre ) Entrées : fenêtre (a0) pointeur vers une structure Window Description : Place la fenêtre indiquée au premier plan. Voir aussi : WindowToBack. Write (fonction Dos) Synopsis : résultat = Write( fichier , tampon , longueur ) Entrées : fichier (d1) pointeur sur une structure FileHandle tampon (d2) pointeur sur un tampon longueur (d3) entier Sorties : résultat (d0) entier Description : Ecrit le nombre d'octets de données indiquées depuis "tampon" vers le fichier spécifié. Retourne le nombre d'octets écrits, ou -1 en cas d'erreur. Voir aussi : Open.