home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Club Amiga de Montreal - CAM
/
CAM_CD_1.iso
/
files
/
445.lha
/
ADoc_v3.10
/
Amiga.doc.pp
/
Amiga.doc
Wrap
Text File
|
1990-12-06
|
50KB
|
1,437 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
Dos.library, fonctions et structures principales
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".
Le gadget n'est pas affiché, il faut pour cela appeler la
fonction RefreshGadgets.
Voir aussi : Gadget, RefreshGadgets, RemoveGadget.
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 : Comme la fonction AllocMem, 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 à la 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. Avant le premier appel
la zone pointée par clé doit être mise à NULL.
Voir aussi : AllocMem, FreeRemember.
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>.
La réponse est TRUE si on clique sur le gadget contenant
txt_pos ou si arrive un message qui correspond à IDCMP_pos.
La réponse est FALSE si on clique sur le gadget contenant
txt_nsg ou si arrive un message qui correspond à IDCMP_neg.
Voir aussi : BuildSysRequest, IDCMP, IntuiText.
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 sur le même écran que celui de la fenêtre
indiquée, 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 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.
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.
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 indiqué, et 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,
et une clé sur l'ancien répertoire courant est retournée dans
clé1 (é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 minuit, 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.
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.
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. Si indic vaut
RECOVERY_ALERT, 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.
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.
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 : Crée une clé de lecture désignant le même objet que clé2.
Cette opération n'est possible que si clé2 est une clé de
lecture.
Voir aussi : Lock.
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.
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>.
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 correspondantes à l'entrée
suivante du répertoire indiqué, dans une structure
FileInfoBlock.
La fonction Examine ou ExNext doit avoir été appelée
auparavant, 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.
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é par la fonction AllocRemember. Si
indic vaut TRUE la mémoire et les chainages sont libérés alors
que si indic vaut FALSE, seuls les chainages sont libérés.
Voir aussi : AllocRemember.
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.
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, suivant GADGIMAGE
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.
La valeur de retour est une copie du paramêtre <tampon>, ou
NULL en cas de problème.
Voir aussi : GetPrefs.
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.
La valeur de retour est une copie du paramêtre <tampon>, ou
NULL en cas de problème.
Voir aussi : GetDefPrefs.
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 la 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.
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.
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 (tient compte de la taille de la
police).
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.
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).
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.
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, et retourne
un pointeur sur la liste des segments occupés (ou 0 en cas
d'erreur).
Voir aussi : CreateProc, UnLoadSeg.
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 correspondant 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.
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é.
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.
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.
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. 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. 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) et retourne un pointeur sur une structure
FileHandle, ou 0 en cas d'échec.
Voir aussi : Close.
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,
et retourne un pointeur vers la structure Screen correspondant
(NULL 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,
et retourne un pointeur vers la structure Window correspondant
(NULL 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, et 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é. Cette clé peut être nulle
(elle désigne alors la racine du volume d'amorçage).
Voir aussi : CurrentDir, Lock.
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.
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.
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.
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.
Le gadget n'est pas effacé de l'affichage, il faut pour cela
appeler la fonction RefreshGadgets.
Voir aussi : AddGadget, RefreshGadgets.
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.
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.
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.
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.
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)
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 -1 l'ancien titre de la fenêtre est conservé,
0 l'ancien titre est effacé, sinon l'ancien titre est remplacé
par la chaine indiquée.
Si titre_e vaut -1 l'ancien titre de l'écran est conservé,
0 l'ancien titre est effacé, 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.
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 : GadgetActivation, Gadget.
UnLoadSeg (fonction Dos)
Synopsis : UnLoadSeg( segment )
Entrées : segment (d1) pointeur sur une liste de segments
Description : Libère une liste de segments.
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.
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.
WBenchToBack (fonction Intuition)
Synopsis : résultat = WBenchToBack()
Sorties : résultat (d0) booléen
Description : Ouvre l'écran WorkBench et le place en arrière plan.
Retourne TRUE si tout va bien, FALSE si l'écran WorkBench
n'a pas pu être ouvert.
WBenchToFront (fonction Intuition)
Synopsis : résultat = WBenchToFront()
Sorties : résultat (d0) booléen
Description : Ouvre l'écran WorkBench et le place au premier plan.
Retourne TRUE si tout va bien, FALSE si l'écran WorkBench
n'a pas pu être 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é 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 le
tampon vers le fichier.
Retourne le nombre d'octets écrits, ou -1 en cas d'erreur.
Voir aussi : Open.